Criação de um ativo a ser recomprado/vendido

Insere um ativo da carteira do fundo num lote em pending_assets_insertion. Faça uma requisição por ativo.

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/ASSIGNMENT_EXTERNAL_ID/asset

MÉTODO

POST

ASSIGNMENT_EXTERNAL_ID é o external_id do lote, informado na criação do lote. O external_id do corpo é o do ativo.

Request Body

{
    "external_id": "7c2d5a10-3f4e-4b8a-9d61-0e2f4a6b8c90",
    "sale_value": 1234.56
}

Body Params

Campo	Tipo	Descrição	Caracteres
external_id	string	Identificador do ativo, o mesmo com que ele foi encarteirado. Envie este ou contract_number.	Até 50
contract_number	string	Número do contrato do ativo, alternativa ao external_id. Aceito para ccb, structured_cci, duplicata_servicos, duplicata_mercantil e cte.	Até 50
borrower_document_number	string	Documento do devedor, para desambiguar a busca do ativo	11 a 18
sale_value	number	Valor pelo qual o ativo será baixado. Envie este ou calculation_method.	2 casas decimais
calculation_method	string	Calcula o valor de venda em vez de informá-lo. Único valor aceito: current_fair_value (valor justo contábil atual do ativo).	Até 255

Regras

• O ativo precisa estar ativo na carteira do fundo e ser do mesmo tipo de ativo da configuração do lote.
• Envie exatamente um entre external_id e contract_number, e exatamente um entre sale_value e calculation_method.
• Em lotes assignment_resolution, o sale_value precisa ser igual ao valor de aquisição do ativo (TRR000053).

Response

STATUS

201

Response Body

{
    "asset_key": "0b6f6c55-5d1b-4b6e-8f3a-6c1f0f7f2b10",
    "asset_resolve_key": "e4a1c9d2-7b3f-4e8a-a5c6-1d2e3f4a5b6c",
    "asset_status": "pending_wallet_sale"
}

asset_status	Quando
pending_wallet_sale	O preço de venda diverge até 5% do valor justo contábil do ativo. O ativo segue no fluxo.
pending_validation	O preço de venda diverge mais de 5% do valor justo contábil. O ativo fica retido até uma confirmação, que não está disponível na API: alinhe com integracao.dtvm@qitech.com.br.

Reenvio e duplicidade

Em caso de erro, reenvie a requisição. Duplicidade (TRR000042) significa que o ativo já está num lote não descartado: não o insira de novo. Veja Reenvio e duplicidade.

Erros

Status	Código	Quando acontece
400	QIT000001	Corpo fora do contrato: campo desconhecido ou formato inválido
400	TRR000050	Nem sale_value nem calculation_method foram enviados
400	TRR000051	sale_value e calculation_method enviados juntos
400	TRR000052	calculation_method diferente de current_fair_value
400	TRR000071	Nem external_id nem contract_number foram enviados
400	TRR000070	external_id e contract_number enviados juntos
400	TRR000072	O tipo de ativo do lote não aceita contract_number: use external_id
400	TRR000021	O lote não está em pending_assets_insertion (já foi encerrado ou descartado)
400	TRR000029	Mais de um ativo encontrado: informe borrower_document_number ou use external_id
400	TRR000053	Lote assignment_resolution com sale_value diferente do valor de aquisição
403	TRR000049	O agente não tem acesso a esse fundo ou a esse lote
404	TRR000006	Não existe fundo com essa fund_class_key
404	TRR000020	Lote não encontrado com esse external_id
404	TRR000028	Ativo não encontrado ativo na carteira do fundo com esse external_id
404	TRR000073	Ativo não encontrado com esse contract_number
409	TRR000042	O ativo já está num lote e não foi descartado

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