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 CTVM. O fluxo abrange desde a criação do lote de cessão até o encarteiramento dos ativos na carteira do fundo.
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.
- Para ter acesso a esses serviços, entre em contato com integracao.dtvm@qitech.com.br para liberação dos ambientes de Homologação (Sandbox) e Produção.
- Você precisará da
fund_class_key(chave do fundo) e daassignment_configuration_key(chave da configuração de cessão), obtidas na Homologação de Cedente. - Para consultar as configurações de cessão disponíveis, utilize o endpoint de Listagem de Configurações de Cessão.
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.
| Caminho | Como funciona | Onde |
|---|---|---|
| Pela API, ativo a ativo | Criação do lote, uma requisição por ativo e encerramento da inserção. É o fluxo detalhado nesta seção | API de integração |
| Por arquivo | Um único arquivo com todos os ativos do lote: CNAB 444 para duplicatas, contratos descontados e CT-e, ou CSV para CCB, honorários advocatícios e contratos parcelados | Portal do gestor/consultor |
Para duplicatas o formato é o CNAB 444; o CSV é aceito para operações de crédito (CCB), honorários advocatícios e contratos parcelados. Veja Cessão por Arquivo, o Layout CNAB 444 — Cessão e o Layout CSV — Contratos Parcelados, com exemplos prontos para download.
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.
Contêiner de todos os ativos que serão cedidos ao fundo, identificado por um external_id único.
/trade_receivables/fund_class/{fund_class_key}/assignment_configuration/{assignment_configuration_key}/assignmentUma requisição por ativo, com as informações de operação, parcelas e dados do sacado.
.../assignment/{assignment_external_id}/assetO ativo só prossegue na esteira depois que todos os documentos exigidos pelo produto são enviados.
.../asset/{asset_external_id}/documentSinaliza que todos os ativos foram inseridos e libera o lote para a análise de elegibilidade.
.../assignment/{assignment_external_id}Cada ativo é analisado individualmente e, em seguida, o lote como um todo. Ativos reprovados não seguem no lote.
Ver documentação →O ativo ou o lote não passou na elegibilidade, ou o gestor reprovou o lote. Fluxo encerrado.
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.
.../assignment/{assignment_external_id}Com o lote aprovado, o Termo de Cessão é gerado e assinado pelas partes.
Ver documentação →O valor da cessão é repassado ao cedente.
Ver documentação →Os ativos entram na carteira do fundo e o ciclo do lote se encerra.
Ver documentação →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, contratos parcelados, etc.) ao lote criado. Cada ativo deve ser inserido individualmente com suas informações de operação, parcelas e dados do sacado.
Acessar documentação da inserção de ativos
3. Envio dos Documentos
Para cada ativo inserido, envie os documentos exigidos pelo produto (contrato, nota fiscal, etc.). O ativo só prossegue na esteira após todos os documentos exigidos serem enviados.
Acessar documentação do envio de documentos
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 do Gestor
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.
Lotes de substituição
O fluxo de substituição segue as mesmas etapas do fluxo de cessão, com um passo adicional: antes de inserir os ativos que serão comprados, é necessário inserir os ativos que serão recomprados pelo cedente.
- Criação do lote
- Inserção dos ativos de recompra — Acessar documentação
- Inserção dos ativos que serão comprados
- Encerramento da inserção