Cadastro do Tomador, Emissão & Cancelamento

Criação do Tomador

O próximo passo é a análise e criação do tomador no sistema.

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

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.
Envio do contrato para formalização do crédito.

Para emissão da CCB é necessario ter:

| Campo | Descrição |
|-------|-----------|
| Consentimento do tomador | Consentimento necessário do tomador |
| Balance Check ID | Balance_check_id retornado na consulta de margem |
| ID da simulação | ID da simulação feita anteriormente |
| ID do produto | ID do produto enviado pelo Onboarding Celcoin |
| ID do funding | ID do funding enviado pelo time de Onboarding Celcoin |

Endpoint: post {{api_host}}/banking/originator/applications

BODY:

{
    "borrower": {
        "id": "{{borrowerId}}"
    },
    "product": {
        "id": "{{productId}}"
    },
    "funding": {
        "id": "{{fundingId}}"
    },
    "balance_check_id": "{{balanceCheckId}}",
    "simulation_id": "{{id}}",
    "signature_collect_method": "EMAIL",
    "signature_provider": "UNICO",
    "signature_authentication_options": {
        "mode": "DOC_SIGN"
    }
}

Response: 201 created:

{
    "id": "b0e29bde-517f-4561-aded-3818e1b2d070",
    "product": {
        "id": "d417cfc5-afe1-471e-a2a8-5dbe0c802e3e"
    },
    "borrower": {
        "id": "b5241fc0-315b-4aef-ad9a-f668233ce3c5"
    },
    "requested_amount": 3925.99,
    "interest_rate": 0.04,
    "interest_pre_type": "BASE_360",
    "annual_interest_rate": 0.601032,
    "tac_amount": 0,
    "finance_fee": 0.10,
    "num_payments": 12,
    "first_payment_date": "2026-11-28",
    "disbursement_date": "2026-09-15",
    "allow_disbursement_on_sign": null,
    "issue_date": "2026-09-15",
    "status": "AGREEMENT_RENDERING",
    "cession_status": "NOT_CEDED",
    "status_description": null,
    "loan_details": {
        "total_processing_cost": 88.70,
        "annual_interest_rate": 0.601032,
        "interest_rate": 0.040000,
        "annual_effective_interest_rate": 0.659106,
        "monthly_effective_interest_rate": 0.043093,
        "total_amount_owed": 5448.00,
        "disbursement_amount": 3925.99,
        "discount_amount": 0,
        "discount_rate": 0.0,
        "financed_amount": 4014.69,
        "iof_daily_rate": 0.000082,
        "iof_amount": 88.50,
        "iof_base_rate": 0.0038,
        "payment_amount": 454.00,
        "issue_date": "2026-09-15",
        "schedule": [],
        "last_payment_date": "2027-10-28",
        "reference_rate": null,
        "interest_pre_type": "BASE_360",
        "interest_rate_frequency": "MONTHLY",
        "amortization_type": null,
        "amortization_version": "V1",
        "interest_type": null,
        "grace_period_interest": null,
        "grace_period_amortizations": null,
        "amortization_frequency": null,
        "insurance_amount": 0.10
    },
    "custom_variables": {},
    "canceled_at": null,
    "sequential_id": 525009,
    "funding": {
        "id": "e746ba58-8cfe-48e0-872a-a4109baba935",
        "legal_name": "O teste final do felps",
        "alias": null,
        "metadata": {
            "cod_backoffice": {
                "value": "",
                "sensitive": false
            }
        }
    },
    "payment_method": "BOLETO",
    "backoffice_import_status": "NONE",
    "guarantors": [],
    "co_signers": [],
    "investors": [],
    "co_debtors": [],
    "collateral_providers": [],
    "representatives": [],
    "sureties": [],
    "signature_collect_method": "EMAIL",
    "signature_provider": "UNICO",
    "issuer_disbursement_type": "BENEFICIARY",
    "signature_collect_options": {
        "require_self_photo": false,
        "require_document_photo": false,
        "require_selfie_validation": false
    },
    "base_premium_amount": 0,
    "additional_premium_amount": 0,
    "loan": null,
    "borrower_employer": null,
    "disbursement": null,
    "beneficiary_account": {
        "registered_account_id": null,
        "holder": {
            "name": "João Gabriel Cirino",
            "taxpayer_id": "29405671316"
        },
        "external_bank_account": null,
        "pix": {
            "key": "4ca519ef-0ccc-4c41-b58b-c88f1f47d8ab",
            "key_type": "ALEATORY_KEY"
        },
        "baas": {
            "account_number": null
        }
    },
    "created_at": "2026-09-15T23:49:36.218172Z",
    "version": 0,
    "cession_value": 4014.69,
    "issue_value": 4014.69,
    "issuer_migrated": true,
    "custodian": null,
    "signature_authentication_options": {
        "mode": "DOC_SIGN"
    },
    "managed_account_for_issuer_disbursement": {
        "product_configuration": null,
        "baas": null
    },
    "disbursement_attempts": [],
    "payment_orders": [
        {
            "id": "8eab2639-af3b-44af-8a87-c2edea55fdcd",
            "amount": 3925.99,
            "type": "PIX_OUT",
            "status": "READY_FOR_PROCESSING",
            "beneficiary_account": {
                "registered_account_id": null,
                "holder": {
                    "name": "João Gabriel Cirino",
                    "taxpayer_id": "29405671316"
                },
                "external_bank_account": null,
                "pix": {
                    "key": "4ca519ef-0ccc-4c41-b58b-c88f1f47d8ab",
                    "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": "486327540203129405671316525009",
    "additional_installment_fee": null,
    "additional_installment_description": null,
    "external_ccb_number": null,
    "external_id": null,
    "annotation_id": null,
    "split_beneficiary_account": null,
    "entry_payment_info": null,
    "consignment": null,
    "contracts_to_purchase": [],
    "bundle_item_name": null,
    "insurance_amount": 0.10,
    "if_code": null,
    "cccb_code": null,
    "employer_data": {
        "employer": {
            "code": "1",
            "document": "28637950000140",
            "name": "Almeida"
        },
        "employee": {
            "code": "6404970143",
            "document": "29405671316",
            "name": "João Gabriel Cirino"
        },
        "config": {
            "agency": "3a7e1beb-c64f-4936-8555-b9edb42c3328",
            "consignee": "3b9be0e7-3af9-4ca4-ad31-26233a58486a"
        },
        "products": [
            {
                "balance_check_id": "e6ebc93c-d6e6-4e4b-b8bf-753cfe44f6c3",
                "authorization": {
                    "details": [
                        {
                            "type_product": "LOAN",
                            "authorized": true
                        }
                    ]
                },
                "available_balance": 2100
            }
        ],
        "meta_data": {
            "nationality_country": {
                "description": "BRASIL",
                "code": "76"
            },
            "termination_reason_code": "0",
            "birth_date": "1997-01-01",
            "worker_category_code": "101",
            "gender": {
                "description": "Masculino",
                "code": 1
            },
            "job_code": {
                "description": "AGENTE DE VIAGEM",
                "code": "354815"
            },
            "economic_activity_code": {
                "description": "TRATAMENTO DE DADOS, PROVEDORES DE SERVICOS DE APLICACAO E SERVICOS DE HOSPEDAGEM NA INTERNET",
                "code": "6311900"
            },
            "politically_exposed_person": {
                "description": "Pessoa Não Exposta Politicamente",
                "code": 0
            },
            "base_margin_value": "2100",
            "amount_loans_assets_suspended": "0",
            "admission_date": "2023-06-12",
            "total_earnings": "9054",
            "employer_activity_start_date": "2020-06-02",
            "mother_name": "Catarina Inclusao Massa Extra",
            "has_disregarded_balance": false,
            "guarantee_info": {
                "available_rescission_allowance_percent": 35,
                "has_guarantees": true
            }
        },
        "balance_check_date": "2026-09-15T23:49:19.0042612+00:00"
    }
}

📘
Validação da Data da Primeira ParcelaO campo first_payment_date é obrigatório na simulação. O valor informado será validado com base no calendário vigente da Dataprev
Regras de validação:

Caso o campo não seja informado, será retornado HTTP 400 com a mensagem: first_payment_date is required.

Caso a data informada seja incompatível com o calendário permitido para averbação, será retornado HTTP 400 com a mensagem: Incompatibility between the first installment due date and registration date. Considering the disbursement date, the first installment due date should be from XXX onwards

Recomendamos que valide previamente a data de primeira parcela conforme o calendário aplicável antes de realizar a simulação.

📘
Validação da CET (Custo Efetivo Total)
Em conformidade com as regras operacionais vigentes do ecossistema Crédito do Trabalhador, será aplicada uma validação obrigatória da variação do CET em relação à taxa de juros nominal da operação.
O objetivo dessa validação é garantir que o custo efetivo mensal da operação permaneça dentro do limite permitido durante o processo de simulação e contratação.
Para essa validação, comparamos os campos:

monthly_effective_interest_rate → representa o CET mensal da operação

interest_rate → representa a taxa de juros nominal mensal da operação

Regra aplicada
O valor de monthly_effective_interest_rate não poderá exceder em mais de 1 ponto percentual o valor de interest_rate.
monthly_effective_interest_rate \leq interest_rate + 1%
Etapas onde a validação será aplicada
Essa validação será executada nas seguintes etapas da API:

Requisições de simulação

Requisições de criação de CCB

Exemplo

interest_rate monthly_effective_interest_rate Resultado
3.00% 3.80% Operação válida
3.00% 4.20% Operação rejeitada
Retorno de erro
Caso a operação ultrapasse o limite permitido, a requisição será rejeitada e a API retornará o seguinte erro:
{
  "message": "O CET mensal calculado excede o limite legal de 1 p.p. sobre a taxa de juros da operação."
}
Importante
Essa validação complementa as regras já existentes relacionadas ao cálculo da taxa de juros e do CET, passando a ser um critério obrigatório para aprovação das operações.

interest_rate	monthly_effective_interest_rate	Resultado
3.00%	3.80%	Operação válida
3.00%	4.20%	Operação rejeitada

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 15 days ago

Did this page help you?