Cadastro do tomador & emissão da CCB de portabilidade

Criação do Tomador

A próxima etapa é o cadastro do tomador de crédito no ambiente Celcoin.

Nesta etapa, é executado o fluxo de KYC (Know Your Customer), que pode seguir dois caminhos:

  • Fluxo padrão da plataforma de crédito, com validações automatizadas e integradas ao ambiente Celcoin;

  • Fluxo personalizado do cliente, quando houver configurações específicas previamente definidas.

Esse processo é essencial para validar a identidade e elegibilidade do tomador, garantindo segurança e conformidade regulatória.

O guia de implementação do cadastro de pessoas está contido e descrito no link a seguir:

Cadastro do tomador de crédito

Solicitação de emissão da CCB de portabilidade

Nesta etapa o originador já possui todas as informações necessárias para solicitar a emissão da CCB de portabilidade previamente cadastrada pela equipe de implantação. Neste momento, também, deverá ser assinado o termo de TERMO DE SOLICITAÇÃO DA PORTABILIDADE, onde o tomador de crédito declara o consentimento para a operação de portabilidade, este termo é enviado para a NUCLEA como parte do pacote probatório da operação.

Nesta etapa o originador informa a Celcoin os dados, coletados a partir do tomador de crédito, do contrato a ser portado para o ambiente Celcoin.

No objeto contracts_to_purchase o originador informa o número do contrato que irá ser portado.

Em custom_variables o originador deve informar, respectivamente:

  • O iSPB da instituição de origem do contrato;

  • O valor de face da parcela do contrato original;

  • A taxa de juros mensal do contrato original.

  • O número total de parcelas do contrato original.


📘

Importante

Caso a instituição financeira original não pertença ao arranjo de instituições financeiras homologadas pela NUCLEA para operar a portabilidade, a operação não poderá ser realizada.

POST: banking/originator/application-bundles

{
    "workflow_definition": {
        "id": "cdb299c7-a53f-4962-a9c3-b0f442db03ef"
    },
    "applications": [
        {
            "product": {
                "id": "d977b240-69f9-4a93-93e4-ffbd743e35cf"
            },
            "borrower": {
                "id": "d8ff0953-f652-46ac-9852-73cb0b18a6df"
            },
            "funding": {
                "id": "e746ba58-8cfe-48e0-872a-a4109baba935"
            },
            "provider_signature": "CLICKSIGN",
            "singnature_collect_method": "LINK",
            "simulation_id": "d4cb32d6-b07c-4f2a-a9e2-d4ec5ee2c87e",
            "bundle_item_name": "portabilidade",
            "custom_variables": {
                "values": {
                    "last_ISPB": "000000000000",
                    "last_due_balance": "500",
                    "last_monthly_interest_rate": "0.0132",
                    "last_number_of_installments": "10"
                }
            },
            "contracts_to_purchase": [
                "2365741"
            ],
            "balance_check_id": "e05e44af-8015-4acb-b4b8-90e4ab1ec0af"
        }
    ]
}

{
    "id": "4e1ec575-cd09-43db-bc4f-ae8c06380c90",
    "status": "PENDING",
    "status_description": null,
    "applications": [
        {
            "product": {
                "id": "d977b240-69f9-4a93-93e4-ffbd743e35cf"
            },
            "borrower": {
                "id": "d8ff0953-f652-46ac-9852-73cb0b18a6df"
            },
            "requested_amount": null,
            "interest_rate": null,
            "tac_amount": null,
            "tac_rate": null,
            "discount_rate": null,
            "finance_fee": null,
            "num_payments": null,
            "first_payment_date": null,
            "disbursement_date": null,
            "allow_disbursement_on_sign": null,
            "custom_variables": {
                "last_ISPB": "000000000000",
                "last_due_balance": "500",
                "last_monthly_interest_rate": "0.0132",
                "last_number_of_installments": "10"
            },
            "funding": {
                "id": "e746ba58-8cfe-48e0-872a-a4109baba935"
            },
            "payment_method": null,
            "guarantors": null,
            "co_signers": null,
            "investors": null,
            "co_debtors": null,
            "collateral_providers": null,
            "representatives": null,
            "sureties": null,
            "signature_collect_method": null,
            "signature_provider": null,
            "issuer_disbursement_type": null,
            "signature_collect_options": null,
            "funding_signature_required": false,
            "originator_signature_required": false,
            "additional_premium_amount": null,
            "beneficiary_account": null,
            "signature_authentication_options": null,
            "custodian": null,
            "billets_info": null,
            "qrcode_info": null,
            "additional_installment_fee": null,
            "additional_installment_description": null,
            "external_ccb_number": null,
            "external_id": null,
            "split_beneficiary_account": null,
            "financial_indicator_cobransaas": null,
            "entry_payment_info": null,
            "amortization_type": null,
            "amortization_frequency": null,
            "financed_iof": null,
            "grace_period_interest": 0,
            "grace_period_amortization": null,
            "interest_compounding_type": null,
            "schedule_type": null,
            "interest_pre_type": null,
            "interest_rate_frequency": null,
            "balance_check_id": "e05e44af-8015-4acb-b4b8-90e4ab1ec0af",
            "issuer_migrated": null,
            "custom_ccb_template_id": null,
            "loan_details": null,
            "simulation_id": "d4cb32d6-b07c-4f2a-a9e2-d4ec5ee2c87e",
            "consignment": null,
            "contracts_to_purchase": [
                "2365741"
            ],
            "bundle_item_name": "portabilidade",
            "billet_requests": null,
            "insurance_amount": null,
            "interest_type": "PRE"
        }
    ],
    "workflow_definition": {
        "id": "cdb299c7-a53f-4962-a9c3-b0f442db03ef"
    },
    "created_applications": [],
    "current_step": null,
    "signature": null,
    "created_at": "2026-03-24T13:15:13.415762Z",
    "version": 0
}