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.
A listagem aceita filtros — inclusive por status — o que permite consultar diretamente apenas os ativos reprovados, sem precisar paginar o lote inteiro. Veja Consultar apenas os ativos reprovados.
Listagem de ativos
Retorna a lista paginada dos ativos de um lote, com suporte a filtros.
Request
Query params
Todos os filtros são opcionais e podem ser combinados entre si. Quando nenhum filtro é informado, a rota devolve todos os ativos do lote.
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
page | integer | 0 | Número da página (começa em 0). |
limit | integer | 10 | Quantidade de registros por página. Máximo: 100. |
status | string | — | Filtra por um status de ativo. Aceita um único valor, que deve ser um dos enumeradores de status. Use denied para obter apenas os ativos reprovados. |
external_id | string | — | Filtra pelo external_id do ativo informado na criação. |
contract_number | string | — | Filtra pelo número do contrato da operação. |
borrower_document_number | string | — | Filtra pelo CPF/CNPJ do devedor (sacado ou tomador, conforme o tipo de ativo). |
purchase_value_min | number | — | Valor mínimo de compra do ativo (inclusive). |
purchase_value_max | number | — | Valor máximo de compra do ativo (inclusive). |
maturity_date_start | string (AAAA-MM-DD) | — | Data de vencimento inicial do intervalo. |
maturity_date_end | string (AAAA-MM-DD) | — | Data de vencimento final do intervalo. |
GET /trade_receivables/fund_class/{fund_class_key}/assignment/{assignment_external_id}/assets?page=0&limit=10
GET /trade_receivables/fund_class/{fund_class_key}/assignment/{assignment_external_id}/assets?status=denied&limit=100&maturity_date_start=2024-01-01&maturity_date_end=2024-12-31
Se o valor enviado em status não corresponder a nenhum enumerador válido, a requisição retorna erro. Consulte a tabela de enumeradores antes de montar o filtro.
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 | Origem da reprovação. Presente apenas quando o ativo foi reprovado. Consulte a tabela de origens. |
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.
Consultar apenas os ativos reprovados
Este é o uso mais comum da listagem: descobrir quais contratos do lote foram reprovados, para refletir a decisão da QI Tech no controle interno do parceiro e decidir se algum ativo precisa ser removido do lote.
Basta informar status=denied:
GET /trade_receivables/fund_class/{fund_class_key}/assignment/{assignment_external_id}/assets?status=denied&limit=100
A resposta traz somente os ativos reprovados, cada um com denied_by (a origem da reprovação) e denial_reason (a descrição):
{
"data": [
{
"asset_key": "f4348106-01c4-4c59-a261-7c09db811c47",
"external_id": "e292656f-f7fb-44dc-96f3-667c36c88442",
"total_purchase_value": 1231.21,
"asset_type": "ccb",
"status": "denied",
"duration": 9177,
"denied_by": "eligibility",
"denial_reason": "Prazo do contrato acima do permitido pela política do fundo"
}
],
"limit": 100,
"page": 0,
"is_last_page": true
}
- Use
limit=100(o máximo permitido) para reduzir o número de páginas e pagine atéis_last_pagesertrue. - Consulte após receber o webhook
pending_manager_approval— nesse momento a análise de elegibilidade de todos os ativos já foi concluída e a lista de reprovados está estável. - Para o inverso — os ativos aprovados na elegibilidade — use
status=pre_approved.
Origens de reprovação (denied_by)
| Valor | Significado |
|---|---|
eligibility | Reprovado na análise de elegibilidade. |
document | Reprovado na validação dos documentos enviados. |
inconsistency | Reprovado por inconsistência nos dados da operação identificada na validação. |
invalid_invoice | Reprovado na validação da nota fiscal. |
registry | Reprovado no processo de registro do ativo. |
term | Reprovado na etapa do Termo de Cessão. |
manager | Reprovado/removido por ação do gestor do fundo. |
consultant | Reprovado/removido por ação do consultor. |
assignor | Reprovado/removido por ação do cedente. |
accounting_close | Reprovado por fechamento contábil do fundo. |
denial_file | Reprovado por arquivo de reprovação processado em lote. |
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
Qualquer um dos valores abaixo pode ser usado no filtro status da listagem.
| Status | Descrição |
|---|---|
created | Ativo criado, ainda não submetido à análise. |
pending_eligibility | Ativo inserido, aguardando análise de elegibilidade. |
pending_documentation | Ativo aprovado na elegibilidade, aguardando envio de documentos. |
pending_invoice_validation | Aguardando validação da nota fiscal. |
pre_approved | Ativo pré-aprovado na elegibilidade individual. |
pending_registry | Aguardando início do registro do ativo. |
pending_external_registry | Aguardando registro em câmara externa. |
sending_to_registry | Em envio para a câmara de registro. |
waiting_registry | Registro submetido, aguardando retorno da câmara. |
pending_formalization | Ativo formalizado e apto a seguir no lote. |
registry_denied | Registro do ativo recusado pela câmara. |
sending_to_wallet | Em processo de encarteiramento na carteira do fundo. |
denied | Ativo reprovado. Consulte denied_by para a origem da reprovação. |
discarded | Ativo descartado do lote. |
completed | Ativo encarteirado na carteira do fundo. |