Consulta de Ativos do Lote
Endpoints para consultar os ativos inseridos em um lote de cessão. Existem dois modos de consulta: a listagem paginada de todos os ativos de um lote, e a consulta individual de um ativo específico.
Utilize estes endpoints para acompanhar o status dos ativos após a inserção, verificar quais foram aprovados ou reprovados na elegibilidade, e consultar os motivos de reprovação quando houver.
Listagem de ativos
Retorna a lista paginada de todos os ativos de um lote.
Request
Query params
| Parâmetro | Tipo | Obrigatoriedade | Descrição |
|---|---|---|---|
page | integer | opcional | Número da página (começa em 0). Padrão: 0. |
limit | integer | opcional | Quantidade de registros por página. Padrão: 10. |
GET /trade_receivables/fund_class/{fund_class_key}/assignment/{assignment_external_id}/assets?page=0&limit=10
Response
{
"data": [
{
"asset_key": "f4348106-01c4-4c59-a261-7c09db811c47",
"external_id": "e292656f-f7fb-44dc-96f3-667c36c88442",
"total_purchase_value": 1231.21,
"asset_type": "duplicata_mercantil",
"status": "denied",
"duration": 9177,
"denied_by": "document",
"denial_reason": "Invalid documents"
}
],
"limit": 10,
"page": 0,
"is_last_page": true
}
Atributos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
data | array | Lista de objetos de ativo. Veja tabela abaixo. |
page | integer | Número da página atual. |
limit | integer | Quantidade de registros por página. |
is_last_page | boolean | Indica se esta é a última página de resultados. |
Atributos de cada ativo (objetos dentro de data)
| Campo | Tipo | Descrição |
|---|---|---|
asset_key | string | Identificador único do ativo (UUID). |
external_id | string | Chave externa fornecida pelo parceiro na criação. |
total_purchase_value | number | Valor total de compra do ativo. |
asset_type | string | Tipo do ativo (ex: ccb, duplicata_mercantil, discounted_contract). |
status | string | Status atual do ativo. Consulte a tabela de status abaixo. |
duration | integer | Duração do ativo em dias. Pode não estar presente se ainda não foi calculada. |
denied_by | string | Indica o motivo da reprovação (ex: document, eligibility). Presente apenas quando o ativo foi reprovado. |
denial_reason | string | Descrição do motivo da reprovação. Presente apenas quando o ativo foi reprovado. |
Dependendo do tipo de ativo, a resposta incluirá o objeto credit_operation (para CCBs) ou discounted_credit_right (para duplicatas e contratos descontados) com todos os dados da operação de crédito.
Consulta de ativo específico
Retorna os dados completos de um ativo específico do lote.
Request
Path params
| Parâmetro | Tipo | Descrição |
|---|---|---|
asset_external_id | string | O external_id informado na criação do ativo. |
Response
{
"asset_key": "074f8786-447f-4524-9f4f-a5cf8a890bb4",
"external_id": "acfbc329-4e67-40ea-bd8d-5debdaebe144",
"total_purchase_value": 1231.21,
"asset_type": "duplicata_mercantil",
"status": "denied",
"duration": 9184,
"denied_by": "document",
"denial_reason": "Invalid documents"
}
Atributos da resposta
A resposta possui a mesma estrutura de cada objeto do array data retornado pela listagem de ativos, acrescida do objeto completo da operação de crédito (credit_operation ou discounted_credit_right, dependendo do tipo de ativo).
Enumeradores de status do ativo
| Status | Descrição |
|---|---|
pending_eligibility | Ativo inserido, aguardando análise de elegibilidade. |
pre_approved | Ativo pré-aprovado na elegibilidade individual. |
pending_documentation | Ativo aprovado na elegibilidade, aguardando envio de documentos. |
approved | Ativo aprovado e com documentação validada. |
denied | Ativo reprovado na elegibilidade ou na validação de documentos. |
discarded | Ativo descartado do lote. |