Originação com Multiplas Datas de Desembolso

A funcionalidade de Múltiplas Datas de Desembolso permite criar uma operação de Crédito do Trabalhador considerando diferentes possibilidades de data para realização do desembolso.

Com essa funcionalidade, é possível definir uma data máxima de desembolso para a operação. A Celcoin calcula as condições financeiras considerando as datas disponíveis dentro desse período, permitindo que sejam aplicadas as condições correspondentes à data em que o desembolso for realizado.

Como funciona

No fluxo tradicional, o cálculo da operação considera uma data específica para realização do desembolso.

Com Múltiplas Datas de Desembolso, é possível estabelecer uma data máxima para que o desembolso aconteça.

A partir dessa informação, a Celcoin calcula previamente as condições financeiras correspondentes às possíveis datas de desembolso.

Durante o processamento da operação, quando a data aplicável ao desembolso for definida, serão consideradas as condições financeiras correspondentes a essa data.

Fluxo resumido

1. Habilitação do produto
O produto é configurado para utilização de Múltiplas Datas de Desembolso.

2. Cálculo
São calculadas as condições financeiras considerando as possíveis datas de desembolso.

3. Criação da operação
A operação é criada informando a data máxima prevista para o desembolso.

4. Contratação e averbação
A operação segue o fluxo de contratação e averbação do Crédito do Trabalhador.

5. Definição da data aplicável
É definida a data aplicável ao desembolso da operação.

6. Atualização das condições financeiras
A operação passa a considerar as condições financeiras correspondentes à data definida.

7. Desembolso
A operação segue para a realização de um único desembolso.

Setup

Para utilizar Múltiplas Datas de Desembolso, o produto deve estar previamente habilitado para a funcionalidade.

Caso o seu produto ainda não esteja configurado, entre em contato com o CS responsável pela sua conta para solicitar a habilitação.

Criação da operação

Para criar uma operação utilizando Múltiplas Datas de Desembolso, informe em disbursement_date a data máxima prevista para realização do desembolso.

A operação deve utilizar um produto previamente habilitado para a funcionalidade.

Request

{
  "product": {
    "id": "7b7b3de4-35bb-402c-aae5-70a6caf679ad"
  },
  "funding": {
    "id": "b31aed64-da82-4c2e-b5e3-dfd1f808bb55"
  },
  "borrower": {
    "id": "806167fa-e2df-49da-b58a-3ca4e3e09e0a"
  },
  "balance_check_id": "1710afa8-8200-4538-97ea-5bb312eddf52",
  "requested_amount": 1000.00,
  "num_payments": 12,
  "interest_rate": 0.02,
  "interest_pre_type": "BASE_365",
  "tac_amount": 0,
  "finance_fee": 0,
  "disbursement_date": "2026-09-19",
  "first_payment_date": "2026-11-28",
  "signature_collect_method": "NONE",
  "external_id": "doc-ct-multiplas-datas"
}

Campos específicos

Os demais campos seguem as regras disponíveis na documentação de Criação de Operação do Crédito do Trabalhador.

Response

{
  "id": "0e255ac0-c350-4dd7-8376-da41e0dc9b1c",
  "status": "AGREEMENT_RENDERING",
  "sequential_id": 524061,
  "external_id": "doc-ct-multiplas-datas",
  "product": {
    "id": "7b7b3de4-35bb-402c-aae5-70a6caf679ad"
  },
  "borrower": {
    "id": "806167fa-e2df-49da-b58a-3ca4e3e09e0a"
  },
  "requested_amount": 1000.0,
  "num_payments": 12,
  "interest_rate": 0.02,
  "interest_pre_type": "BASE_365",
  "annual_interest_rate": 0.268242,
  "tac_amount": 0,
  "finance_fee": 0,
  "disbursement_date": "2026-09-19",
  "first_payment_date": "2026-11-28",
  "issue_date": "2026-09-11",
  "payment_method": "BOLETO",
  "signature_collect_method": "NONE",
  "insurance_amount": 0,
  "loan_details": {
    "total_processing_cost": 23.42,
    "annual_interest_rate": 0.268242,
    "interest_rate": 0.02,
    "annual_effective_interest_rate": 0.314285,
    "monthly_effective_interest_rate": 0.023036,
    "total_amount_owed": 1197.36,
    "disbursement_amount": 1000.0,
    "discount_amount": 0,
    "discount_rate": 0.0,
    "financed_amount": 1023.42,
    "iof_daily_rate": 0.000082,
    "iof_amount": 23.42,
    "iof_base_rate": 0.0038,
    "payment_amount": 99.78,
    "issue_date": "2026-09-11",
    "schedule": [
      {
        "payment": 99.78,
        "iof": 0.97,
        "balance": 1023.43,
        "interest": 4.94,
        "principal": 94.84,
        "additional_value": 0.0,
        "period": 1,
        "running_day": 78,
        "payment_date": "2026-11-28"
      },
      {
        "payment": 99.78,
        "iof": 1.17,
        "balance": 928.59,
        "interest": 6.77,
        "principal": 93.01,
        "additional_value": 0.0,
        "period": 2,
        "running_day": 108,
        "payment_date": "2026-12-28"
      }
    ]
  },
  "payment_orders": [
    {
      "id": "6fb4e47c-1012-4bb0-ab7e-7a5f5a6112a4",
      "amount": 1000.0,
      "type": "PIX_OUT",
      "status": "READY_FOR_PROCESSING",
      "beneficiary_type": "BORROWER"
    }
  ],
  "annotation_id": null,
  "cession_status": "NOT_CEDED"
}

Consulta do detalhamento por data de desembolso

O objeto multiple_disbursements_details, que contém o detalhamento do cálculo financeiro para cada possibilidade de data de desembolso, não é retornado inicialmente no response de criação da operação.

Caso seja necessário consultar essas informações, realize a consulta da operação informando o parâmetro multiple_disbursements_details=true.

Endpoint

GET {host}/banking/originator/applications/{id}?multiple_disbursements_details=true

Onde:

• {id} corresponde ao identificador da operação (application_id);
• multiple_disbursements_details=true indica que o detalhamento financeiro das possíveis datas de desembolso deve ser incluído no retorno.

Atualização das condições financeiras

No momento da criação da operação, os campos financeiros retornados consideram as condições calculadas para a data máxima de desembolso informada.

Após a averbação, quando a data aplicável ao desembolso for definida, a Celcoin atualizará automaticamente a operação para refletir as condições financeiras correspondentes a essa data.

Por esse motivo, ao consultar a operação após a averbação, alguns dados poderão apresentar valores diferentes dos retornados inicialmente na criação.

Exemplo

Considere que a operação tenha sido criada com: disbursement_date = 2026-09-19

Nesse momento, os dados financeiros retornados em loan_details consideram as condições correspondentes à data máxima informada.

Após a averbação, a data aplicável ao desembolso será 17/09/2026, a operação será atualizada automaticamente para considerar essa data e suas respectivas condições financeiras.

Assim, em uma consulta posterior à operação: disbursement_date irá retornar 2026-09-17;

e os dados financeiros relacionados à operação irá refletir as condições correspondentes a 17/09/2026.

Data da primeira parcela

A first_payment_date deve respeitar as regras do calendário vigente aplicável ao Crédito do Trabalhador.

No fluxo de Múltiplas Datas de Desembolso, a Celcoin considera a relação entre as possibilidades de desembolso e a data da primeira parcela para realizar as validações necessárias.