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.
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 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.
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.
| 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 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 parcelados | Portal do gestor/consultor; API da gestora |
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.
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}/assetDocumentos que comprovam cada ativo (CCB, contrato, nota fiscal). O ativo só prossegue depois que todos os 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, a QI Tech gera o Termo de Cessão do lote e as partes o assinam.
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, 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.