Pular para o conteúdo principal

Cessão de Direitos Creditórios

Esta seção documenta as APIs que viabilizam o processo de cessão de Direitos Creditórios para Fundos de Investimento administrados pela QI DTVM. O fluxo abrange desde a criação do lote de cessão até o encarteiramento dos ativos na carteira do fundo.

Manual completo

Para um entendimento aprofundado das regras de negócio e do produto, consulte o Manual de Cessão de Direitos Creditórios. Recomendamos a leitura em conjunto com as rotas aqui disponibilizadas.

Pré-requisitos
O fundo é parte do contrato?

Contrato de financiamento, confissão de dívida e outros contratos em que o fundo é parte não entram por esta esteira: eles têm documentos próprios, assinados pelas partes, e dupla validação. Veja Contratos Estruturados.

Como enviar a cessão​

Existem dois caminhos, com o mesmo resultado final. Escolha um por lote — não é possível misturar os dois no mesmo lote.

CaminhoComo funcionaOnde
Pela API, ativo a ativoCriação do lote, uma requisição por ativo e encerramento da inserção. É o fluxo detalhado nesta seçãoAPI de integração
Por arquivoUm único arquivo com todos os ativos do lote: CNAB 444 ou CSV para duplicatas, CT-e, cheques e notas promissórias; CSV para CCB e honorários advocatícios; CNAB 400 ou CSV para contratos parceladosPortal do gestor/consultor; API da gestora
Cessão por arquivo

O formato do arquivo depende do tipo de ativo da configuração. A tabela completa, com os layouts e os modelos para download, está em Cessão por Arquivo.

Fluxo de cessão​

O diagrama abaixo mostra o caminho principal, as bifurcações e o status resultante de cada etapa. Passe o mouse em um nó para ver o endpoint e clique para abrir a documentação.

IntegradorGestorQI Tech
1Criação do Lote
pending_assets_insertion
Integrador

Contêiner de todos os ativos que serão cedidos ao fundo, identificado por um external_id único.

POST/trade_receivables/fund_class/{fund_class_key}/assignment_configuration/{assignment_configuration_key}/assignment
Ver documentação →
2Inserção dos Ativos
ativo: pending_eligibility
Integrador

Uma requisição por ativo, com as informações de operação, parcelas e dados do sacado.

POST.../assignment/{assignment_external_id}/asset
Ver documentação →
3Envio do Lastro
Integrador

Documentos que comprovam cada ativo (CCB, contrato, nota fiscal). O ativo só prossegue depois que todos os exigidos pelo produto são enviados.

POST.../asset/{asset_external_id}/document
Ver documentação →
4Encerramento da Inserção
completed_assets_insertion
Integrador

Sinaliza que todos os ativos foram inseridos e libera o lote para a análise de elegibilidade.

PUT.../assignment/{assignment_external_id}
Ver documentação →
Elegibilidade dos ativos e do lote
QI Tech

Cada ativo é analisado individualmente e, em seguida, o lote como um todo. Ativos reprovados não seguem no lote.

Ver documentação →
Reprovado
denied
QI Tech

O ativo ou o lote não passou na elegibilidade, ou o gestor reprovou o lote. Fluxo encerrado.

5Aprovação do consultor e/ou gestor
Condicional
pending_manager_approval
Gestor

Etapa manual apenas se a configuração de cessão exigir. Caso contrário a aprovação é automática e nenhuma ação é necessária.

PUT.../assignment/{assignment_external_id}
Ver documentação →
Termo de Cessão gerado e assinado
pending_assignment_term_signature
QI Tech

Com o lote aprovado, a QI Tech gera o Termo de Cessão do lote e as partes o assinam.

Ver documentação →
Pagamento ao cedente
pending_payment
QI Tech

O valor da cessão é repassado ao cedente.

Ver documentação →
Ativos encarteirados no fundo
completed
QI Tech

Os ativos entram na carteira do fundo e o ciclo do lote se encerra.

Ver documentação →
Fluxo completo

Para todas as transições de status, os payloads dos webhooks e os caminhos de exceção, consulte o Fluxo de cessão.

Passo a passo​

1. Criação do Lote​

Crie um lote de cessão informando um identificador único (external_id). O lote será o contêiner para todos os ativos que serão cedidos ao fundo.

Acessar documentação da criação do lote

2. Inserção dos Ativos​

Adicione os ativos (CCBs, duplicatas, CT-e, cheques, notas promissórias, contratos parcelados etc.) ao lote criado. Cada ativo deve ser inserido individualmente com suas informações de operação, parcelas e dados do sacado.

Não sabe qual tipo enviar? Em Qual ativo enviar você encontra o tipo de cada recebível e o que muda entre eles depois da cessão, inclusive a diferença entre contrato descontado e contrato parcelado.

Acessar documentação da inserção de ativos

3. Envio do Lastro​

Para cada ativo inserido, envie o lastro exigido pelo produto: os documentos que comprovam o ativo (CCB, contrato, nota fiscal etc.). O ativo só prossegue na esteira após todos os documentos exigidos serem enviados. Não confunda com o Termo de Cessão, que é do lote e gerado pela QI Tech no passo 6.

Acessar documentação do envio do lastro

4. Encerramento da Inserção​

Sinalize que todos os ativos foram inseridos no lote. O sistema aguardará a análise individual de cada ativo antes de prosseguir com a elegibilidade do lote como um todo.

Acessar documentação do encerramento

5. Aprovação​

Após a elegibilidade do lote ser aprovada, o lote segue para aprovação. A depender da configuração de cessão, essa etapa é manual — o consultor e/ou o gestor do fundo analisam e aprovam ou reprovam o lote, e o lote fica em pending_consultant_approval / pending_manager_approval até a decisão — ou automática, sem nenhuma ação do integrador. Se aprovado, o Termo de Cessão será gerado automaticamente.

Acessar documentação da aprovação

6. Assinatura, Pagamento e Encarteiramento​

Os passos finais são automatizados: o Termo de Cessão é assinado pelas partes, o pagamento é realizado ao cedente e os ativos são encarteirados na carteira do fundo. Acompanhe o progresso através dos webhooks do lote. Para baixar o termo, original ou assinado, ou abrir o link de assinatura, veja Termo de Cessão do Lote.

Lotes de substituição​

O fluxo de substituição segue as mesmas etapas do fluxo de cessão, com um passo a mais: inserir, no mesmo lote, os ativos que serão recomprados pelo cedente — Inserção de Ativo para Recompra. Recompras e novos ativos podem entrar em qualquer ordem enquanto o lote estiver aberto; para encerrar a inserção, o lote precisa de ao menos um ativo de recompra, e o valor dos novos ativos não pode ser menor que o dos recomprados.