Criação de um lote de recompra

Cria o lote (assignment) que vai agrupar os ativos a serem recomprados ou vendidos. O lote nasce em pending_assets_insertion.

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Escrita
Consultoria	consultant-api	Liberada pelo time de integração
Cedente	assignor-api	Escrita

URL base de cada host: Ambientes (Hosts).

Request

ENDPOINT

/trade_resolve/fund_class/FUND_CLASS_KEY/assignment

MÉTODO

POST

Request Body

{
    "external_id": "931e9437-d025-41ab-bb53-6b94e10fd361",
    "assignment_date": "2024-04-01",
    "assignment_configuration_key": "d9308a2b-21fa-4724-9bbe-59ae65287b10",
    "source_account": {
        "document_number": "11.222.333/0001-81"
    }
}

Body Params

Campo	Tipo	Descrição	Caracteres
external_id *	string	Chave única de identificação deste lote no sistema do parceiro integrador.	Até 50
assignment_date *	string	Data da recompra. Precisa ser igual à data contábil atual do fundo.	YYYY-MM-DD
assignment_configuration_key	string	Chave da configuração de recompra, fornecida pela QI Tech. Envie esta ou assignment_type.	36
assignment_type	string	Tipo do lote, quando você usa a configuração padrão do fundo para esse tipo: assignment_repurchase, wallet_sale ou assignment_resolution. Envie este ou assignment_configuration_key.	Até 50
source_account *	objeto	Conta que fará o pagamento ao fundo	-

Configuração do lote

Envie exatamente um entre assignment_configuration_key e assignment_type. Sem nenhum dos dois a API devolve TRR000017; com os dois, TRR000016.

Objeto de source account

Campo	Tipo	Descrição	Caracteres
document_number *	string	CPF ou CNPJ, com máscara, de quem fará o pagamento ao fundo. Precisa ser um documento válido.	14 a 18

Response

STATUS

201

Response Body

{
    "assignment_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
    "assignment_status": "pending_assets_insertion"
}

Reenvio e duplicidade

Em caso de erro, reenvie a requisição. Duplicidade (TRR000015) significa que o recurso já existe: consulte-o em vez de recriar. Pela assignor-api, a consulta é GET /trade_resolve/fund_class/{fund_class_key}/assignment/{external_id}; a manager-api e a consultant-api não expõem essa consulta, então trate TRR000015 como lote já criado e siga para a inserção dos ativos. Veja Reenvio e duplicidade.

Erros

Status	Código	Quando acontece
400	QIT000001	Corpo fora do contrato: campo obrigatório ausente, campo desconhecido, formato inválido
400	TRR000014	assignment_date diferente da data contábil do fundo
400	TRR000002	source_account.document_number não é um CPF ou CNPJ válido
400	TRR000016	assignment_configuration_key e assignment_type enviados juntos
400	TRR000017	Nem assignment_configuration_key nem assignment_type foram enviados
400	TRR000019	A configuração de recompra não está ativa
403	TRR000049	O agente não tem acesso a esse fundo ou a essa configuração de recompra
404	TRR000006	Não existe fundo com essa fund_class_key
404	TRR000013	Configuração de recompra não encontrada para o fundo (ou o fundo não tem configuração padrão para o assignment_type)
404	TRR000018	assignment_type não existe
409	TRR000015	Já existe um lote com esse external_id no fundo

Erros de autenticação, permissão e host: veja Erros da API.