Cadastro do Tomador, Emissão & Cancelamento

Cadastro do Tomador

Após o trabalhador aceitar a proposta de crédito no ambiente da Carteira de Trabalho Digital (CTPS Digital), ele deve informar dados complementares para que seja possível:

Verificar sua identidade (processo de KYC);
Realizar a emissão da Cédula de Crédito Bancário (CCB)

Esse fluxo pode ser conduzido de duas formas:

📝 1. Formulário Digital (Celcoin)

O tomador é redirecionado para um formulário digital fornecido pela Celcoin, onde informa os dados complementares.

Com essas informações, a plataforma realiza as validações de KYC (Know Your Customer) e, estando tudo certo, o processo segue para a emissão da CCB.

⚙️ 2. Formulário do Originador (Cliente)

Neste fluxo, o tomador permanece dentro do ambiente do próprio originador (cliente), que será responsável por:

Coletar os dados complementares do tomador;
Chamar a API para vincular a operação;
Chamar a API para criar o tomador na plataforma.

Vinculação da Operação:

POST: /banking/originator/workers-credit/apply/{{ id da proposta }}

JSON de Exemplo

{
  "borrower_id": "40035787-a73e-4d50-9c40-c96c25dc3d0f",
  "product_id": "8d6203bd-c228-4ef9-ac2b-c6d55a82d4ad",
  "entry_url": "https://example.com/test",
  "disbursement_date": "2025-06-12",
  "funding_id": "9773c5fb-cbd7-41fa-b6b1-e9c76295259f",
  "finance_fee": 0,
  "first_payment_date": "2025-10-01",
  "tac_amount": 0
}

{
 "id": "bba3e04f-486a-45b7-b1f4-aa93c81d6c7f",
 "product": {
 "id": "8d6203bd-c228-4ef9-ac2b-c6d55a82d4ad"
 },
 "borrower": {
 "id": "40035787-a73e-4d50-9c40-c96c25dc3d0f"
 },
 "requested_amount": 1200,
 "interest_rate": 0.1,
 "interest_pre_type": "BASE_360",
 "annual_interest_rate": 2.138428,
 "tac_amount": 0.0,
 "finance_fee": 0.0,
 "num_payments": 10,
 "first_payment_date": "2025-10-01",
 "disbursement_date": "2025-06-12",
 "allow_disbursement_on_sign": null,
 "issue_date": "2025-06-10",
 "status": "AGREEMENT_RENDERING",
 "cession_status": "NOT_CEDED",
 "status_description": null,
 "loan_details": {
 "total_processing_cost": 27.14,
 "annual_interest_rate": 2.138428,
 "interest_rate": 0.100000,
 "annual_effective_interest_rate": 2.253635,
 "monthly_effective_interest_rate": 0.103310,
 "total_amount_owed": 2596.40,
 "disbursement_amount": 1200,
 "discount_amount": 0,
 "discount_rate": 0.0,
 "financed_amount": 1227.14,
 "iof_daily_rate": 0.000082,
 "iof_amount": 27.14,
 "iof_base_rate": 0.0038,
 "payment_amount": 259.64,
 "issue_date": "2025-06-10",
 "schedule": [
 {
 "payment": 259.64,
 "iof": 2.35,
 "balance": 1227.20,
 "interest": 77.16,
 "principal": 182.48,
 "additional_value": 0.00,
 "present_value": null,
 "status": null,
 "period": 1,
 "running_day": 111,
 "late_day": null,
 "paid_value": null,
 "payment_date": "2025-10-01"
 },
{
 "payment": 259.64,
 "iof": 2.56,
 "balance": 1044.72,
 "interest": 93.75,
 "principal": 165.89,
 "additional_value": 0.00,
 "present_value": null,
 "status": null,
 "period": 2,
 "running_day": 142,
 "late_day": null,
 "paid_value": null,
 "payment_date": "2025-11-01"
 },

{
 "payment": 259.64,
 "iof": 2.70,
 "balance": 878.83,
 "interest": 108.83,
 "principal": 150.81,
 "additional_value": 0.00,
 "present_value": null,
 "status": null,
 "period": 3,
 "running_day": 172,
 "late_day": null,
 "paid_value": null,
 "payment_date": "2025-12-01"
 },

{
 "payment": 259.64,
 "iof": 2.80,
 "balance": 728.02,
 "interest": 122.54,
 "principal": 137.10,
 "additional_value": 0.00,
 "present_value": null,
 "status": null,
 "period": 4,
 "running_day": 203,
 "late_day": null,
 "paid_value": null,
 "payment_date": "2026-01-01"
 },
{
 "payment": 259.64,
 "iof": 2.86,
 "balance": 590.92,
 "interest": 135.00,
 "principal": 124.64,
 "additional_value": 0.00,
 "present_value": null,
 "status": null,
 "period": 5,
 "running_day": 234,
 "late_day": null,
 "paid_value": null,
 "payment_date": "2026-02-01"
 },
{
 "payment": 259.64,
 "iof": 2.86,
 "balance": 466.28,
 "interest": 146.33,
 "principal": 113.31,
 "additional_value": 0.00,
 "present_value": null,
 "status": null,
 "period": 6,
 "running_day": 262,
 "late_day": null,
 "paid_value": null,
 "payment_date": "2026-03-01"
 },
{
 "payment": 259.64,
 "iof": 2.86,
 "balance": 352.97,
 "interest": 156.63,
 "principal": 103.01,
 "additional_value": 0.00,
 "present_value": null,
 "status": null,
 "period": 7,
 "running_day": 293,
 "late_day": null,
 "paid_value": null,
 "payment_date": "2026-04-01"
 },
{
 "payment": 259.64,
 "iof": 2.84,
 "balance": 249.96,
 "interest": 166.00,
 "principal": 93.64,
 "additional_value": 0.00,
 "present_value": null,
 "status": null,
 "period": 8,
 "running_day": 323,
 "late_day": null,
 "paid_value": null,
 "payment_date": "2026-05-01"
 },
 {
 "payment": 259.64,
 "iof": 2.79,
 "balance": 156.32,
 "interest": 174.51,
 "principal": 85.13,
 "additional_value": 0.00,
 "present_value": null,
 "status": null,
 "period": 9,
 "running_day": 354,
 "late_day": null,
 "paid_value": null,
 "payment_date": "2026-06-01"
 },
 {
 "payment": 259.64,
 "iof": 2.52,
 "balance": 71.19,
 "interest": 188.45,
 "principal": 71.19,
 "additional_value": 0.00,
 "present_value": null,
 "status": null,
 "period": 10,
 "running_day": 384,
 "late_day": null,
 "paid_value": null,
 "payment_date": "2026-07-01"
 }
 ],
 "last_payment_date": "2026-07-01",
 "reference_rate": null,
 "interest_pre_type": "BASE_360",
 "interest_rate_frequency": "MONTHLY",
 "amortization_type": "PRICE",
 "interest_type": "PRE",
 "grace_period_interest": 0,
 "grace_period_amortizations": [],
 "amortization_frequency": "MONTHLY"
 },
 "custom_variables": {},
 "canceled_at": null,
 "sequential_id": 1209,
 "funding": {
 "id": "9773c5fb-cbd7-41fa-b6b1-e9c76295259f",
 "legal_name": "developers funding",
 "alias": null,
 "metadata": {}
 },
"payment_method": "BOLETO",
 "backoffice_import_status": "NONE",
 "guarantors": [],
 "co_signers": [],
 "investors": [],
 "co_debtors": [],
 "collateral_providers": [],
 "representatives": [],
 "sureties": [],
 "signature_collect_method": "NONE",
 "signature_provider": "CELCOIN",
 "issuer_disbursement_type": "BENEFICIARY",
 "signature_collect_options": {
 "require_self_photo": false,
 "require_document_photo": false,
 "require_selfie_validation": false
 },
 "base_premium_amount": 14.73,
 "additional_premium_amount": 0,
 "loan": null,
 "borrower_employer": null,
 "disbursement": null,
 "beneficiary_account": {
 "registered_account_id": null,
 "holder": {
 "name": "John Fake Dooley",
 "taxpayer_id": "65923430282"
 },
 "external_bank_account": {
 "bank_code": "001",
 "bank_account": "0028979",
 "bank_account_digit": "2",
 "bank_branch": "0001",
 "bank_account_type": "CACC",
 "ispb_code": "00000000"
 },
 "pix": {
 "key": "4ca519ef-0ccc-4c41-b58b-c88f1f47d8ab",
 "key_type": "ALEATORY_KEY"
 },
 "baas": {
 "account_number": null
 }
 },
 "created_at": "2025-06-10T14:56:17.469038Z",
 "version": 0,
 "cession_value": 1241.87,
 "issue_value": 1241.87,
 "issuer_migrated": false,
 "custodian": null,
 "signature_authentication_options": {
 "mode": "NONE"
 },
"managed_account_for_issuer_disbursement": {
 "product_configuration": null,
 "baas": null
 },
 "disbursement_attempts": [],
 "payment_orders": [
 {
 "id": "f7ddad3a-caa6-42c4-b140-93ec89f66c94",
 "amount": 1200,
 "type": "PIX_OUT",
 "status": "READY_FOR_PROCESSING",
 "beneficiary_account": {
 "registered_account_id": null,
 "holder": {
 "name": "John Fake Dooley",
 "taxpayer_id": "65923430282"
 },
 "external_bank_account": {
 "bank_code": "001",
 "bank_account": "0028979",
 "bank_account_digit": "2",
 "bank_branch": "0001",
 "bank_account_type": "CACC",
 "ispb_code": "00000000"
 },
 "pix": {
 "key": "4ca519ef-0ccc-4c41-b58b-c88f1f47d8ab",
 "key_type": "ALEATORY_KEY"
 },
 "baas": {
 "account_number": null
 }
 },
 "beneficiary_type": "CONSIGNED",
 "billet_info": null,
 "allow_failure": null,
 "qrcode_info": null,
 "principal": null,
 "is_partial_disbursement": null
 }
 ],
 "ipoc_number": "4863275406661659234302821209",
 "additional_installment_fee": null,
 "additional_installment_description": null,
 "external_ccb_number": null,
 "split_beneficiary_account": null,
 "entry_payment_info": null
}

Documentação: Criação do tomador
https://developers.celcoin.com.br/reference/post_banking-originator-persons

Em ambos os fluxos, é executado o processo de KYC, essencial para garantir segurança e conformidade
regulatória. Esse processo pode seguir dois caminhos:

Fluxo padrão da plataforma de crédito, com validações automatizadas e integradas;
Fluxo personalizado do cliente, quando houver configurações específicas previamente definidas.

Emissão da CCB

A emissão da CCB segue o fluxo padrão da plataforma, conforme já documentado.

Essa etapa inclui:

Geração do contrato com os dados validados;
Coleta das assinaturas digitais do tomador e, se aplicável, da instituição financeira;
Averbação junto ao órgão responsável pelo consignado privado.

Somente após a conclusão dessas etapas é que o processo segue para o desembolso do crédito e, se
previsto, a cessão da operação.

Documentação:
https://developers.celcoin.com.br/reference/post_banking-originator-applications

Averbação

A etapa de averbação consiste no bloqueio dos valores da margem contratada junto ao órgão, garantindo que o crédito seja reservado para a operação aprovada.
Durante esse processo, a operação permanecerá com o status “Pendente de averbação”.

✅ Sucesso na averbação

Quando a averbação é concluída com sucesso, o status da operação é automaticamente atualizada de “Pendente de averbação” para o próximo status, conforme a configuração definida no produto.

⚠️ Erro por instabilidade

Em caso de instabilidade na API do órgão, o sistema continuará tentando realizar a averbação até a data limite de desembolso. Se a averbação não for concluída até essa data, a operação será automaticamente cancelada.

❌ Erro na etapa de averbação

Quando ocorre um erro definitivo na averbação, a operação é cancelada automaticamente.
O webhook de status da operação é atualizado, permitindo consultar o motivo do cancelamento.

Códigos Erros da Dataprev

Código	Descrição
AO	Nome inválido
AP	Competência de início de desconto ou data de início ou fim de contrato inválida
AZ	Os valores informados para os campos numero Parcelas e valor Parcela são iguais aos valores atuais do empréstimo
BC	Requisição sem CBC ou CBC inválido
BL	Valor da parcela inválida
BQ	Valor liberado inválido
CA	Código do banco inválido
ES	Empregador Suspenso para averbações de empréstimo
EV	O(s) campo(s) possui(em) valor(es) inválido(s)
HT	Início do desconto informado já ultrapassado
HU	Vínculo inelegível para empréstimo pelo trabalhador
HV	Quantidade de parcelas inválida
HW	Margem consignável excedida
HX	Empréstimo já cadastrado
HY	Empréstimo inexistente
IO	O valor do IOF é inválido
ME	O motivo de exclusão do empréstimo é inválido
NC	A requisição está sem número de contrato
OH	O número do contrato está inválido
ON	Operação não permitida
OT	O tamanho do(s) campo(s) está(ão) incorreto(s)
OU	O valor da taxa de juros anual está inválida ou é menor que a taxa de juros mensal
OV	O valor do custo efetivo (anual ou mensal) está inválido
OZ	Operação suspensa
PI	O valor do empréstimo está inválido. É necessário que o valor seja maior que o valor de referência
SB	Identificador da Proposta inválido
SF	A requisição está sem o CPF ou CPF informado está com o DV inválido
SG	Código de Inscrição do Empregador deve ser informada
SH	Número de Inscrição do Empregador deve ser informada
SI	Matrícula do Trabalhador deve ser informada
SM	Proposta expirada
SN	Proposta já usada para averbação de empréstimo
TX	Valor da taxa de juros mensal está inválido
TO	O valor da taxa de juros mensal não pode ser maior do que o informado na proposta
TP	A data do primeiro desconto está inválida

Cancelamento da CCB

O crédito consignado pode ser cancelado (desaverbado) em casos específicos, conforme as regras e prazos estabelecidos pelo sistema. As situações que permitem o cancelamento incluem:

Desistência pelo tomador: Solicitação de cancelamento dentro do prazo permitido;
Cancelamento da CCB: Anulação formal do contrato, quando aplicável;

Documentação:
https://developers.celcoin.com.br/reference/post_banking-originator-applications-application-id-cancel

Updated 3 days ago