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": "7860bb88-a4f0-4142-85c9-456b089ba9a5",
"product_id": "69dea3de-d6cb-4c46-b914-e4635b3b026e",
"entry_url": "https://example.com/test",
"disbursement_date": "2026-01-25",
"funding_id": "b31aed64-da82-4c2e-b5e3-dfd1f808bb55",
"finance_fee": 0,
"first_payment_date": "2026-01-25",
"tac_amount": 0
}{
"id": "d997953a-1c97-40cc-999d-61d38e2b59a1",
"product": {
"id": "69dea3de-d6cb-4c46-b914-e4635b3b026e"
},
"borrower": {
"id": "7860bb88-a4f0-4142-85c9-456b089ba9a5"
},
"requested_amount": 100,
"interest_rate": 0.1,
"interest_pre_type": "BASE_365",
"annual_interest_rate": 2.138428,
"tac_amount": 0,
"finance_fee": 0,
"num_payments": 10,
"first_payment_date": "2026-01-25",
"disbursement_date": "2026-01-25",
"allow_disbursement_on_sign": null,
"issue_date": "2026-01-23",
"status": "AGREEMENT_RENDERING",
"cession_status": "NOT_CEDED",
"status_description": null,
"loan_details": {
"total_processing_cost": 13.48,
"annual_interest_rate": 2.138428,
"interest_rate": 0.100000,
"annual_effective_interest_rate": 3.808010,
"monthly_effective_interest_rate": 0.139805,
"total_amount_owed": 167.50,
"disbursement_amount": 100.00,
"discount_amount": 0,
"discount_rate": 0.0,
"financed_amount": 113.48,
"iof_daily_rate": 0.000082,
"iof_amount": 1.48,
"iof_base_rate": 0.0038,
"payment_amount": 16.75,
"issue_date": "2026-01-23",
"schedule": [
{
"payment": 16.75,
"iof": 0.06,
"balance": 113.49,
"interest": 0.00,
"principal": 16.75,
"additional_value": 0.00,
"present_value": null,
"status": null,
"period": 1,
"running_day": 0,
"late_day": null,
"paid_value": null,
"payment_date": "2026-01-25"
},
{
"payment": 16.75,
"iof": 0.10,
"balance": 96.74,
"interest": 1.55,
"principal": 15.20,
"additional_value": 0.00,
"present_value": null,
"status": null,
"period": 2,
"running_day": 31,
"late_day": null,
"paid_value": null,
"payment_date": "2026-02-25"
},
{
"payment": 16.75,
"iof": 0.12,
"balance": 81.54,
"interest": 2.83,
"principal": 13.92,
"additional_value": 0.00,
"present_value": null,
"status": null,
"period": 3,
"running_day": 59,
"late_day": null,
"paid_value": null,
"payment_date": "2026-03-25"
},
{
"payment": 16.75,
"iof": 0.14,
"balance": 67.62,
"interest": 4.12,
"principal": 12.63,
"additional_value": 0.00,
"present_value": null,
"status": null,
"period": 4,
"running_day": 90,
"late_day": null,
"paid_value": null,
"payment_date": "2026-04-25"
},
{
"payment": 16.75,
"iof": 0.15,
"balance": 54.99,
"interest": 5.25,
"principal": 11.50,
"additional_value": 0.00,
"present_value": null,
"status": null,
"period": 5,
"running_day": 120,
"late_day": null,
"paid_value": null,
"payment_date": "2026-05-25"
},
{
"payment": 16.75,
"iof": 0.17,
"balance": 43.49,
"interest": 6.31,
"principal": 10.44,
"additional_value": 0.00,
"present_value": null,
"status": null,
"period": 6,
"running_day": 151,
"late_day": null,
"paid_value": null,
"payment_date": "2026-06-25"
},
{
"payment": 16.75,
"iof": 0.18,
"balance": 33.05,
"interest": 7.25,
"principal": 9.50,
"additional_value": 0.00,
"present_value": null,
"status": null,
"period": 7,
"running_day": 181,
"late_day": null,
"paid_value": null,
"payment_date": "2026-07-25"
},
{
"payment": 16.75,
"iof": 0.18,
"balance": 23.55,
"interest": 8.13,
"principal": 8.62,
"additional_value": 0.00,
"present_value": null,
"status": null,
"period": 8,
"running_day": 212,
"late_day": null,
"paid_value": null,
"payment_date": "2026-08-25"
},
{
"payment": 16.75,
"iof": 0.19,
"balance": 14.93,
"interest": 8.93,
"principal": 7.82,
"additional_value": 0.00,
"present_value": null,
"status": null,
"period": 9,
"running_day": 243,
"late_day": null,
"paid_value": null,
"payment_date": "2026-09-25"
},
{
"payment": 16.75,
"iof": 0.19,
"balance": 7.11,
"interest": 9.64,
"principal": 7.11,
"additional_value": 0.00,
"present_value": null,
"status": null,
"period": 10,
"running_day": 273,
"late_day": null,
"paid_value": null,
"payment_date": "2026-10-25"
}
],
"last_payment_date": "2026-10-25",
"reference_rate": null,
"interest_pre_type": "BASE_365",
"interest_rate_frequency": "MONTHLY",
"amortization_type": "PRICE",
"interest_type": "PRE",
"grace_period_interest": 0,
"grace_period_amortizations": [],
"amortization_frequency": "MONTHLY",
"insurance_amount": 12
},
"custom_variables": {},
"canceled_at": null,
"sequential_id": 191660,
"funding": {
"id": "b31aed64-da82-4c2e-b5e3-dfd1f808bb55",
"legal_name": "FRAM CAPITAL FUNDO DE INVESTIMENTO EM DIREITOS CREDITORIOS CONSIGNADO I",
"alias": null,
"metadata": {
"CASHWAY_COLLECTION_INTEGRATION_CASHWAY_CREDITOR": {
"value": "7800",
"sensitive": false
}
}
},
"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": 1.13,
"additional_premium_amount": 0,
"loan": null,
"borrower_employer": {
"id": "64ce2a50-4de9-49d8-a16f-ed433384aad3"
},
"disbursement": null,
"beneficiary_account": {
"registered_account_id": null,
"holder": {
"name": "Joao da Silva Tester",
"taxpayer_id": "13875546709"
},
"external_bank_account": null,
"pix": {
"key": "17894312-5710-4ed5-8a19-b98404da181c",
"key_type": "ALEATORY_KEY"
},
"baas": {
"account_number": null
}
},
"created_at": "2026-01-23T20:35:47.167049Z",
"version": 0,
"cession_value": 114.61,
"issue_value": 114.61,
"issuer_migrated": true,
"custodian": null,
"signature_authentication_options": {
"mode": "NONE"
},
"managed_account_for_issuer_disbursement": {
"product_configuration": null,
"baas": null
},
"disbursement_attempts": [],
"payment_orders": [
{
"id": "8233ee4b-666c-4fa6-8b8d-6f0f6a1f3e27",
"amount": 100.00,
"type": "PIX_OUT",
"status": "READY_FOR_PROCESSING",
"beneficiary_account": {
"registered_account_id": null,
"holder": {
"name": "Joao da Silva Tester",
"taxpayer_id": "13875546709"
},
"external_bank_account": null,
"pix": {
"key": "17894312-5710-4ed5-8a19-b98404da181c",
"key_type": "ALEATORY_KEY"
},
"baas": {
"account_number": null
}
},
"beneficiary_type": "BORROWER",
"billet_info": null,
"allow_failure": null,
"qrcode_info": null,
"principal": null,
"is_partial_disbursement": null,
"pay_application_id": null
}
],
"ipoc_number": "486327540666113875546709191660",
"additional_installment_fee": null,
"additional_installment_description": null,
"external_ccb_number": null,
"annotation_id": null,
"split_beneficiary_account": null,
"entry_payment_info": null,
"consignment": null,
"contracts_to_purchase": [],
"bundle_item_name": null,
"insurance_amount": 12,
"if_code": null,
"cccb_code": null,
"employer_data": 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 1 day ago