Fluxo de Cessão

Esta página oferece uma visão holística de todo o fluxo de cessão de direitos creditórios, desde a criação do lote até o encarteiramento dos ativos na carteira do fundo. Acompanhe a evolução dos status do lote, dos status dos ativos e dos webhooks recebidos em cada etapa.

Como usar este fluxograma

Passe o mouse sobre cada etapa para ver os detalhes do endpoint e acessar a documentação completa. As três trilhas coloridas mostram simultaneamente o que acontece com o lote, com os ativos e quais webhooks você receberá.

Legenda

Agente Integrador

QI Tech (automático)

Gestor do Fundo

Status do Lote

Status do Ativo

Webhook

Fluxograma

1

Criação do LoteAgente Integrador

Cria um lote de cessão com um identificador único (external_id).

Lote: pending_assets_insertion

POST /trade_receivables/fund_class/{fund_class_key}/assignment_configuration/{assignment_configuration_key}/assignment

O lote é criado em status pending_assets_insertion, pronto para receber ativos.

Ver documentação completa →

2

Inserção dos AtivosAgente Integrador

Insere os ativos no lote (CCB, duplicata ou contrato descontado). Repita para cada ativo.

Lote: pending_assets_insertionAtivo: pending_eligibilityWebhook: asset_creation

POST /trade_receivables/.../assignment/{assignment_external_id}/asset

Cada ativo é criado com status pending_eligibility. Você receberá um webhook trade_receivables.asset_creation confirmando a inserção.

CCB →   Duplicata →   Contrato Descontado →

3

Envio de DocumentosAgente Integrador

Envia os documentos exigidos para cada ativo (PDF em Base64). Duplicatas mercantis não exigem documentos.

Lote: pending_assets_insertionAtivo: pending_eligibility

POST /trade_receivables/.../asset/{asset_external_id}/document

Envie os documentos após receber o webhook pending_documentation para o ativo (etapa 5a).

Ver documentação completa →

4

Encerrar InserçãoAgente Integrador

Sinaliza que todos os ativos foram inseridos no lote. A análise de elegibilidade será iniciada automaticamente.

Lote: completed_assets_insertionAtivo: pending_eligibility

PUT /trade_receivables/.../assignment/{assignment_external_id}

Envie {"assignment_status": "completed_assets_insertion"}. Não é necessário aguardar os webhooks de elegibilidade individual dos ativos.

Ver documentação completa →

5a

Elegibilidade dos AtivosQI Tech

A QI Tech analisa cada ativo individualmente. Você recebe um webhook por ativo com o resultado.

Lote: completed_assets_insertionAtivo: pre_approved / deniedWebhook: asset_status_change

Ativo aprovado

pre_approved

O ativo foi pré-aprovado na elegibilidade.

Ativo reprovado

denied

O ativo não segue adiante no fluxo.

Webhook trade_receivables.asset_status_change — enviado para cada ativo com o resultado da elegibilidade.

Ver documentação de webhooks do ativo →

5b

Elegibilidade do LoteQI Tech

Quando todos os ativos forem analisados, a QI Tech avalia a elegibilidade do lote como um todo.

Lote: pending_manager_approval / deniedWebhook: assignment_status_change

Lote elegível

pending_manager_approval

O lote aguarda a aprovação do gestor do fundo (passo 6).

Lote reprovado

denied

O lote causa desenquadramento do fundo. Fluxo encerrado.

Webhook trade_receivables.assignment_status_change — informa se o lote foi aprovado ou reprovado na elegibilidade.

Ver documentação de webhooks do lote →

6

Aprovação do GestorGestor do Fundo

O gestor do fundo analisa e aprova ou reprova o lote (via API ou pelo Portal do Gestor). Se aprovado, o Termo de Cessão é gerado automaticamente.

Lote: pending_assignment_term_signatureWebhook: assignment_status_change

PUT /trade_receivables/.../assignment/{assignment_external_id}

Endpoint disponível somente para gestores. Envie {"assignment_status": "approved"} ou "denied". Após aprovação, você recebe o webhook com status pending_assignment_term_signature.

Ver documentação completa →

7

Assinatura do Termo de CessãoQI Tech

O Termo de Cessão é gerado e encaminhado para assinatura. Todas as partes relacionadas precisam assinar o termo para que o fluxo prossiga. O integrador pode consultar o documento a qualquer momento.

Lote: pending_paymentWebhook: assignment_status_change

GET /trade_receivables/.../assignment/{assignment_external_id}/assignment_term_link

Consulte o Termo de Cessão (original e assinado). Após todas as partes assinarem, você recebe o webhook com status pending_payment.

Ver documentação completa →

8

Pagamento ao CedenteQI Tech

O pagamento é realizado automaticamente ao cedente na conta configurada durante a homologação.

Lote: pending_assets_wallet_inclusionWebhook: assignment_status_change

O valor total é a soma dos total_purchase_value de todos os ativos não descartados. Após o pagamento, você recebe o webhook com status pending_assets_wallet_inclusion.

9

EncarteiramentoQI Tech

Os ativos são incluídos na carteira do fundo. A cessão está concluída.

Lote: completedAtivo: completedWebhook: assignment_status_change

Você recebe o webhook final com status completed. A partir desse momento, os ativos se encontram na carteira do fundo.

Ver documentação de webhooks →

---

Resumo de webhooks

A tabela abaixo consolida todos os webhooks que o integrador recebe ao longo do fluxo, na ordem cronológica:

#	Tipo do webhook	Status	Momento no fluxo	Ação esperada
1	asset_creation	pending_eligibility	Após inserção de cada ativo (passo 2)	Nenhuma — confirmação de recebimento.
2	asset_status_change	pre_approved	Ativo aprovado na elegibilidade (passo 5a)	Nenhuma — ativo pré-aprovado.
3	asset_status_change	denied	Ativo reprovado na elegibilidade (passo 5a)	Nenhuma — ativo não segue adiante.
4	assignment_status_change	pending_manager_approval	Lote aprovado na elegibilidade (passo 5b)	Aguardar aprovação do gestor.
5	assignment_status_change	denied	Lote reprovado na elegibilidade (passo 5b)	Nenhuma — fluxo encerrado.
6	assignment_status_change	pending_assignment_term_signature	Gestor aprovou o lote (passo 6)	Opcional: consultar Termo de Cessão.
7	assignment_status_change	pending_payment	Termo assinado por todas as partes (passo 7)	Nenhuma — pagamento em processamento.
8	assignment_status_change	pending_assets_wallet_inclusion	Pagamento realizado (passo 8)	Nenhuma — encarteiramento em processamento.
9	assignment_status_change	completed	Ativos encarteirados (passo 9)	Cessão concluída com sucesso.
—	assignment_status_change	discarded	Qualquer momento (reprovação/erro)	Nenhuma — lote descartado.

Prefixo dos webhooks

Todos os tipos de webhook possuem o prefixo trade_receivables.. Por exemplo: trade_receivables.asset_creation e trade_receivables.assignment_status_change. Para detalhes sobre a estrutura completa dos webhooks, consulte Webhooks do Ativo e Webhooks do Lote.