Cessão no Fluxo de Originação

Esta página descreve como configurar e operar os cenários de cessão no processo de CCB, com foco em esteira de status, gatilhos e momento de desembolso.

Objetivo

Permitir controle operacional entre assinatura da CCB, qualificação interna, formalização da cessão e desembolso.

Conceitos

• Step de aprovação (PENDING_QUALIFICATION): trava operacional após assinatura da CCB para aprovação final manual.
• Cessão pré-desembolso: a cessão ocorre antes do pagamento ao tomador.
• Cessão pós-desembolso: o desembolso ocorre primeiro; a cessão é feita depois em janela operacional.

Cenário 1: Fluxo com Aprovação (sem cessão pré)

Quando o tomador assina a CCB, a operação não desembolsa automaticamente. Ela fica aguardando aprovação final.

Esteira de status

AGREEMENT_RENDERING -> PENDING_KYC -> PENDING_SIGNATURE -> PENDING_QUALIFICATION -> PENDING_DISBURSEMENT -> ISSUED

Regra

• Entrada em PENDING_QUALIFICATION: assinatura concluída.
• Saída de PENDING_QUALIFICATION: ação de aprovação (endpoint de qualificação).

Cenário 2: Cessão Pré-Desembolso

Após assinatura, a operação fica travada para qualificação de cessão. Somente depois da formalização e assinatura do termo de cessão a operação segue para desembolso.

Esteira de status

AGREEMENT_RENDERING -> PENDING_KYC -> PENDING_SIGNATURE -> PENDING_CESSION_QUALIFICATION -> PENDING_CESSION -> PENDING_DISBURSEMENT -> ISSUED

Regra operacional

1. Operação assinada entra em PENDING_CESSION_QUALIFICATION.
2. Time operacional qualifica as operações pendentes de cessão.
3. Operações qualificadas seguem para PENDING_CESSION.
4. Em horário configurado, as operações qualificadas são agrupadas para formalização do termo de cessão.
5. Após assinatura do termo por todas as partes, as operações vão para PENDING_DISBURSEMENT.
6. Desembolso executado, operação evolui para ISSUED.

Como qualificar a pré-cessão via API

1. Listar operações pendentes de cessão (por produto e opcionalmente por aplicação):

GET {{api_host}}/banking/originator/products/{{product_id}}/qualification-requests?application_id={{application_id}}

Também é possível listar por produto sem filtrar application_id.

2. Aprovar a qualificação para tirar de PENDING_CESSION_QUALIFICATION e entrar em PENDING_CESSION:

curl --location --globoff --request PUT 'https://sandbox.platform.flowfinance.com.br/banking/originator/products/{{product_id}}/qualification-requests/{{qualification_id}}/qualify' \
--header 'Authorization: Bearer {{token_originator}}' \
--header 'Content-Type: application/json' \
--data '{
  "status": "QUALIFIED"
}'

Regra de transição:

• PENDING_CESSION_QUALIFICATION + status=QUALIFIED -> PENDING_CESSION

Cenário 3: Cessão Pós-Desembolso

A operação é desembolsada com recurso próprio/caixa do emissor (24x7). A cessão ocorre depois, desacoplada da esteira de desembolso.

Esteira de status (originação)

AGREEMENT_RENDERING -> PENDING_KYC -> PENDING_SIGNATURE -> PENDING_QUALIFICATION (opcional) -> PENDING_DISBURSEMENT -> ISSUED

Regra operacional

• A cessão não bloqueia o desembolso.
• O processo de cessão roda em lote em janela definida (ex.: horário diário).
• Acompanhamento de cessão ocorre por processo próprio (fora do gating de desembolso).

Diferença prática entre Pré e Pós

• Pré-desembolso: desembolso depende da formalização da cessão.
• Pós-desembolso: desembolso independe da cessão; cessão acontece depois.

Quando usar cada modelo

• Use pré-desembolso quando houver exigência de proteção de caixa antes de pagar o tomador.
• Use pós-desembolso quando a operação exigir velocidade de pagamento e houver capacidade de funding próprio.
• Use step de aprovação quando a mesa operacional precisar de checkpoint final após assinatura.

Ações técnicas necessárias

1. Configurar o produto com o step correto (PENDING_QUALIFICATION e/ou PENDING_CESSION_QUALIFICATION).
2. Definir janela operacional para formalização de cessão (quando pré-desembolso).
3. Monitorar webhooks de APPLICATION_STATUS_UPDATED para mudança de estado.