Onboard a Fund

Description

When the Asset Manager adds your organization to the exclusivity list for a fund, a notification is produced to signal that the assignment has been made. Your org needs to:

1. Receive and parse the notification.

2. Update internal systems to reflect the assignment.

3. Accept (or reject) the assignment.

4. Add security correlation ID (optional).

5. Retrieve the fund details for use in internal systems.

Diagram

Endpoints

Task	How	Error Codes
Accept Fund Assignment	../exclusivity/accept	AC0013 AU0001 AU0002 AU0003 EX0001 GN0002 IS0003 IS0004 IS0009 IS0010 IS0013 IS0019 IS0102 IS0103 IS0119 OG0028 OG0038
Reject Fund Assignment	../exclusivity/reject	AU0001 AU0002 AU0003 EX0001 GN0002 IS0003 IS0004 IS0009 IS0010 IS0013 IS0019 IS0102 IS0103 IS0119
Add Security Correlation ID (optional)	../security-admin/correlation-id/add	AU0001 AU0002 GN0002 IS0009 IS0074 IS0119
Get Security Details	../securities	AU0001 AU0002 GN0002 GN0004 GN0005

Error Codes and Messages

Key Validations

Type	Code	Message
Exclusivity	EX0001	You neither have a pending exclusive assignment request nor accepted/rejected an exclusive assignment for security '{securityId}'

Other Business Rule Validations

Type	Code	Message
Account	AC0013	Account name is mandatory for new accounts
Exclusivity	EX0001	You neither have a pending exclusive assignment request nor accepted/rejected an exclusive assignment for security '{securityId}'
Issuance (Security)	IS0019	This action is reserved for securities with exclusivity type set to '{requiredType}'
	IS0119	Issuance '{securityId}' has an active full sync job

Technical Validations

Type	Code	Message
Auth (OAuth)	AU0001	The access token is invalid or missing. Please provide a valid access token issued by the OAuth server using the client credentials grant (default location is on the authorization header).
	AU0002	You do not have access to this scope: '{scope}'
	AU0003	The core access token is invalid for organization '{orgId}'.
Generic	GN0002	The payload you have supplied is invalid.
	GN0004	Page size must be an integer between 1 and {maxPageSize}
	GN0005	Offset must be an integer bigger or equal to 0
Issuance (Security)	IS0003	{shareClassSecurityId}' is not a share class of the security '{securityId}'
	IS0004	Security '{securityId}' does not have share classes
	IS0009	The security id '{securityId}' is invalid
	IS0010	This action is only allowed for parent securities but '{securityId}' is a share class
	IS0013	Security '{securityId}' is restricted
	IS0074	The offering correlation ids '{correlationIds}' are already in use
	IS0102	There is a background job running to synchronize the security '{securityId}' data. Please try again later
	IS0103	The data for security '{securityId}' was not synchronized correctly - job status is '{status}'
Organization	OG0028	Organization '{orgId}' is not in ACL
	OG0038	Channel {channelName} for chaincode {name} not found or org {orgId} not part of channel