> ## Documentation Index
> Fetch the complete documentation index at: https://bmpdocs.moneyp.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Home Equity

Personal loans are an affordable and flexible financial solution designed to meet a variety of individual needs without requiring them to justify the use of the loan.

To minimize the risk of default, different types of collateral can be offered, providing security for both the borrower and the financial institution.

Among the available options, collateral includes investments, card receivables, service contracts, company shares, vehicles, and real estate.

This case study explores the various types of personal loans, illustrating how each modality can be used to meet different profiles and financial needs.

Below is the step-by-step guide for using this use case:

<Warning>Before using this service, you must configure authentication. See the [authentication instructions](https://bmpdocs.moneyp.com.br/caas/primeiros-passos/autenticacao) for detailed instructions.</Warning>

## 1 - Simulations

The first step for contracting credit in the Working Capital modality is the simulation.

The simulation can be performed in two ways:

<Expandable title="Detailed Simulation">
  In the **Detailed Simulation**, the partner provides all the necessary data for the simulation and receives the available credit conditions.

  <br />

  <br />

  To request the Detailed Simulation, it is necessary to inform:

  * Credit amount requested by the customer;
  * Number of days added to the due date of the first installment;
  * Interest rate;
  * Type of person (individual or legal entity);
  * Term in months for payment (number of installments);
  * Deadline interval (irregular or regular flow).

  For more information about this endpoint, access the reference document [6 - Detailed Simulation](https://bmpdocs.moneyp.com.br/caas/api-reference/simulacoes/6-simulacao-detalhada).

  ```json theme={null}
  curl --location 'https://api.bmpdigital.moneyp.dev.br/Proposta/CalcularGridParcelasSimplificadoPrice' \
  --header 'accept: text/plain' \
  --header 'IdempotencyKey: UNIQUE GUID FOR EACH CALL' \
  --header 'Content-Type: application/json' \
  --data '{
    "dto": {
      "vlrSolicitado": 0, // Amount requested by your client | REQUIRED
      "nroDiasAcrescimo": 0, // This field adjusts the due date of the 1st installment, adding or subtracting days from the default date (always on the same day of the simulation, in the following month)
      "percJurosNegociado": 0, // Interest rate negotiated with your client | REQUIRED
      "tipoPessoa": 0, // Enter 1 for individual and 2 for company | REQUIRED
      "vlrTAC": 0, // If there's a TAC fee, fill this field. If not, it can be removed | OPTIONAL
      "prazo": 0, // Enter the number of installments
      "fluxoIrregular": false // Set to false for intervals of 30 days or true for other intervals
    }
  }'  
  ```
</Expandable>

<Expandable title="Multi-Installment Simulation">
  In the **Multi-Installment Simulation**, the partner only informs the requested amount and receives the available credit conditions for different terms.

  <br />

  <br />

  In the request for the Multi-Installment Simulation, it is necessary to inform:

  * Credit amount requested by the customer;
  * Number of days added to the due date of the first installment;
  * Interest rate;
  * Type of person (individual or legal entity).

  For more information about this endpoint, access the reference document [5 - Multi-Installment Simulation](https://bmpdocs.moneyp.com.br/caas/api-reference/simulacoes/5-simulacao-multiparcelamento).

  ```json theme={null}
  curl --location 'https://api.bmpdigital.moneyp.dev.br/Proposta/CalcularGridParcelasSimplificado' \
  --header 'accept: text/plain' \
  --header 'IdempotencyKey: UNIQUE GUID FOR EACH CALL' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer 2ec83da4-ddba-4b01-9c6a-5b5e718f5793' \
  --data '    {
      "dto": {
      "vlrSolicitado": 0, // Amount requested by your client | REQUIRED
      "nroDiasAcrescimo": 0, // This field adjusts the due date of the 1st installment by adding or subtracting days from the default date (always the same day of the simulation, in the next month)
      "percJurosNegociado": 0, // Interest rate negotiated with your client | REQUIRED
      "tipoPessoa": 0, // Enter 1 for individual and 2 for company | REQUIRED
      "vlrTAC": 0 // If there is a TAC fee, include this field. If not, it can be omitted | OPTIONAL
    }
  }'
  ```
</Expandable>

<Note>In both simulations, the `nroDiasAcrescimo` field defines how many days will be added or subtracted from the default due date of the first installment. By default, the due date occurs on the same day as the simulation, but in the following month. For example: if the simulation is on 27/05, the default due date will be 27/06. If you fill in "20", the due date will be 20 days after that default date (e.g.: 17/07). If the simulation is done on the 30th or 31st and the following month does not have those dates, the due date will be adjusted to the last day of the month (for example, a simulation on 31/01 will have a due date on 28/02).</Note>

## 2 - Onboarding

After simulation, it is necessary to register the customer's data and address. This step is called onboarding.

Onboarding is carried out in two stages:

<Expandable title="Customer Personal Information Registration">
  To register a customer's personal data, you must provide:

  * Customer name;
  * Federal ID (CPF or CNPJ);
  * Contact information (email and cell phone number);
  * If the Federal ID is a CPF, you must also provide the ID number, issuing agency, ID state, ID date of issue, date of birth, gender, nationality, hometown, and home state;
  * If the Federal ID is a CNPJ, you must provide the business name, state ID number, municipal ID number, company opening date, name of the company manager, CPF number of the company manager, and ID number of the company manager.

  For more information about this endpoint, access the reference document [10 - Customer Registration](https://bmpdocs.moneyp.com.br/caas/api-reference/onboarding/10-cadastro-do-cliente).

  ```json theme={null}
  curl --location 'https://api.bmpdigital.moneyp.dev.br/Pessoa/Salvar' \
  --header 'IdempotencyKey: UNIQUE GUID FOR EACH CALL' \
  --header 'Authorization: Bearer qXdZot13a6EbJkAbjpZ5ep_eTKH2F5ZHOwZrYZVN1lw' \
  --header 'Content-Type: application/json' \
  --data-raw '{
      "dto": {
          "Codigo": "1", // Code to identify the customer in your system | OPTIONAL
          "Nome": "CLIENTE TESTE", // Your customer's name | REQUIRED
          "DocumentoFederal": "75000000000", // Federal document (CPF: 11 digits | CNPJ: 14 digits | we have a validator, so it must be a valid document) | REQUIRED
          "PF": { // If your customer is an Individual, fill in this object; if not, remove this object
              "rg": "string",// Customer's RG | REQUIRED
              "rgOrgao": "string", // RG issuing agency | OPTIONAL
              "rguf": "string", // RG state (UF) | OPTIONAL
              "rgData": "2023-07-10T20:01:07.689Z", // RG issue date | OPTIONAL
              "dtNasc": "2023-07-10T20:01:07.689Z", // Customer's date of birth | REQUIRED
              "sexo": "string", // Customer's gender | OPTIONAL
              "nacionalidade": "string", // Customer's nationality | OPTIONAL
              "naturalDeCidade": "string", // Customer's city of birth | OPTIONAL
              "naturalDeUF": "string", // Customer's state of birth (UF) | OPTIONAL
              "estadoCivil": 0, // Enum type, see document sent by email | OPTIONAL
              "escolaridade": 0 // Enum type, see document sent by email | OPTIONAL
          },
          "PJ": { // If your customer is a Legal Entity, fill in this object; if not, remove this object
              "nomeFantasia": "string", // Company trade name | REQUIRED
              "documentoEstadual": "string", // State document of the company | OPTIONAL
              "documentoMunicipal": "string", // Municipal document of the company | OPTIONAL
              "dtAberturaEmpresa": "2024-06-06T19:49:59.553Z", // Company opening date in timestamp | OPTIONAL
              "nomeResponsavelEmpresa": "string", // Name of the company responsible | OPTIONAL
              "cpfResponsavelEmpresa": "string", // CPF of the company responsible | OPTIONAL
              "rgResponsavelEmpresa": "string" // RG of the company responsible | OPTIONAL
          },
          "PessoaDadosContato": {
              "Email": "teste@email.com.br", // Customer's email | REQUIRED
              "TelefoneCelular1": "11923456781" // Customer's mobile phone | REQUIRED
          }
      }
  }'
  ```
</Expandable>

<Expandable title="Address Registration">
  To register a customer's address, you must provide:

  * Customer's Federal ID (CPF or CNPJ);
  * Address ZIP code (required);
  * Other optional information.

  For more information about this endpoint, access the reference document [11 - Address Registration](https://bmpdocs.moneyp.com.br/caas/api-reference/onboarding/11-cadastro-do-endereco).

  ```json theme={null}
  curl --location 'https://api.bmpdigital.moneyp.dev.br/Pessoa/SalvarEndereco' \
  --header 'Authorization: Bearer qXdZot13a6EbJkAbjpZ5ep_eTKH2F5ZHOwZrYZVN1lw' \
  --header 'IdempotencyKey: UNIQUE GUID FOR EACH CALL' \
  --header 'Content-Type: application/json' \
  --data '{
    "dto": {
      "codigo": "string", // Code to identify the address in your system | OPTIONAL
      "cep": "string", // ZIP code of the address | REQUIRED
      "logradouro": "string", // Address street | OPTIONAL
      "nroLogradouro": "string", // Address number | OPTIONAL
      "bairro": "string", // Address neighborhood | OPTIONAL
      "complemento": "string", // Address complement | OPTIONAL
      "cidade": "string", // Address city | OPTIONAL
      "uf": "string", // Address state (UF) | OPTIONAL
      "tipoEndereco": 0, // Address type | OPTIONAL
      "tipoResidencia": 0, // Residence type | OPTIONAL
      "enderecoDesde": "2024-04-04T12:19:46.116Z", // Since when the address belongs to the customer | OPTIONAL
      "enderecoPrincipal": true, // Is this the customer's main address? | OPTIONAL
      "enderecoCorrespondencia": true // Is this the correspondence address? | OPTIONAL
    },
    "param": {
      "documentoCliente": "string" // Federal document (CPF: 11 digits | CNPJ: 14 digits | we have a validator, so it must be a valid document) | REQUIRED
    }
  }'
  ```
</Expandable>

## 3 - Uploading a Customer Document

After entering the customer's Federal Tax ID number, you must upload the document.

The document is sent as a Base94-encoded file and can be in JPG, PDF, PNG, or other formats.

<Expandable title="Include Document">
  To upload a customer document, you must enter:

  * Customer's Federal Tax ID number (CPF or CNPJ);
  * Code generated upon return of the customer registration request;
  * Document type;
  * File name;
  * File extension;
  * File expiration date;
  * Base64-encoded file.

  For more information about this endpoint, see the reference document [15 - Include Document](https://bmpdocs.moneyp.com.br/caas/api-reference/onboarding/15-incluir-documento).

  ```json theme={null}
  curl --location 'https://api.bmpdigital.moneyp.dev.br/Pessoa/IncluirDocumento' \
  --header 'IdempotencyKey: UNIQUE GUID FOR EACH CALL' \
  --header 'Content-Type: application/json' \
  --data '{
      "dto": {
          "documentoCliente": "string" // Federal document (CPF: 11 digits | CNPJ: 14 digits | we have a validator, so it must be a valid document) | REQUIRED
      },
      "documento": {
          "codigo": "3fa85f64-5717-4562-b3fc-2c963f66afa6", // Code generated in the response of the person creation in our system OR proposal code generated in the response of the proposal creation | REQUIRED
          "tipoDocumento": 0, // Document type of your customer (if you want to inform, check the API reference table for this endpoint) | REQUIRED
          "nomeArquivo": "string", // File name | REQUIRED
          "extensao": "string", // File extension (e.g.: jpg, pdf, png) | REQUIRED
          "dtValidade": "2023-05-23T20:57:08.922Z", // File expiration date | REQUIRED
          "arquivo": "string" // Desired file encoded in BASE64 | REQUIRED
      }
  }'
  ```
</Expandable>

## 4 - Hiring

After the simulation, onboarding, and uploading of the client's documents, it is necessary to submit a request for credit. We call this step **Inserting a Proposal**.

<Expandable title="Inserting a Proposal">
  To submit a proposal, you must provide:

  * Transaction code;
  * Amount requested in the proposal;
  * Requested term (in months);
  * Negotiated interest percentage;
  * Total amount of the Tax on Financial Transactions (IOF);
  * Percentage of the Tax on Financial Transactions (IOF);
  * Installment amount;
  * Registration Fee (TAC);
  * Estimated first due date;
  * Account type (checking, savings, etc.);
  * Bank branch;
  * Branch digit;
  * Bank account;
  * Account digit;
  * Bank number.

  For more information about this endpoint, please visit the reference document [23 - Inclusion with External Calculation](https://bmpdocs.moneyp.com.br/caas/api-reference/contratacao/23-inclusao-com-calculo-externo).

  ```json theme={null}
  curl --location 'https://api.bmpdigital.moneyp.dev.br/Proposta/IncluirManualSimplificado' \
  --header 'Authorization: Bearer qXdZot13a6EbJkAbjpZ5ep_eTKH2F5ZHOwZrYZVN1lw' \
  --header 'IdempotencyKey: UNIQUE GUID FOR EACH CALL' \
  --header 'Content-Type: application/json' \
  --data '{
      "dto": {
          "documentoCliente": "string", // Customer document
          "documentoParceiroCorrespondente": "string",  // Correspondent Partner document
          "codigoOperacao": "string", // Required - Used by the Integrator. It is the operation code in the partner's system. This information is exclusive and can be used to update the proposal without needing to store the BMP proposal code. However, the BMP proposal code is important to store for printing slips/CCB/Promissory Note or Protocol.
          "codigoVersaoCCB": 0, // Bank Credit Certificate (CCB) version code
          "vlrSolicitado": 0, // Required - Amount requested in the proposal
          "prazo": 0, // Required - Requested term. Will be validated according to integration parameters.
          "percJurosNegociado": 0, // Required - Interest rate of the proposal
          "vlrIOF": 0, // Required - Total amount of Tax on Financial Transactions (IOF)
          "percIOF": 0, // Required - Percentage of Tax on Financial Transactions (IOF)
          "vlrParcela": 0, // Required - Installment amount
          "vlrTAC": 0, // Required - Registration Fee amount. Can be R$ 0.00 when not applicable.
          "dtPrimeiroVencto": "2024-02-21T17:48:40.110Z", // Required - Estimated date of the first due date.
          "tipoContrato": "string", // string(5) - Acronym indicating the type of contract for the proposal. Example: CSG -> Working Capital; CCG -> Working Capital with Guarantee
          "propostaContaPagamentoDTO": { 
              "tipoConta": 0, // Required - Account type
              "agencia": "string", // string(10) Required - Bank branch
              "agenciaDig": "string", // string(1) Required - Branch digit
              "conta": "string", // string(20) Required - Bank account
              "contaDig": "string", // string(1) Required - Account digit
              "numeroBanco": "string" // string(5) Required - Bank number
          },
      },
  }'
  ```

  To use a contract with a **TED** split, add the object below to the previous request within the `dto` array:
</Expandable>

<Expandable title="TED Split">
  ```json theme={null}
  "propostaLancamentos": [ 
      {
                "campoID": "string", // Name of the field responsible for the split | REQUIRED
                "vlrTransacao": 0, // Transaction amount (must be less than or equal to the requested amount) | REQUIRED
                "tipoConta": 0, // 1 = Individual, 2 = Legal Entity | REQUIRED
                "agencia": "string", // Bank branch of the account | REQUIRED
                "agenciaDig": "string", // Account branch digit of the payer | REQUIRED
                "conta": "string", // Bank account of the payer | REQUIRED
                "contaDig": "string", // Bank account digit of the payer | REQUIRED
                "numeroBanco": "string", // Bank code according to BACEN table | REQUIRED
                "documentoFederal": "string", // Federal Document Number | REQUIRED
                "nomePagamento": "string" // Name for payment | REQUIRED 
      }
  ]
  ```
</Expandable>

To use a contract with a **Payment Split** split, add the object below to the previous request within the `dto` array:

<Expandable title="Payment Split">
  ```json theme={null}
   "propostaLancamentos": [ 
              {
              "campoID": "string", // Name of the field responsible for the split | REQUIRED 
              "vlrTransacao": 0, // Transaction amount (must be less than or equal to the requested amount) | REQUIRED 
              "dtPagamento": "2024-02-21T17:48:40.110Z", // Expected payment date of the proposal.
              "linhaDigitavel": "string", // string(60)  string containing payment slip information, such as bank data, recipient, etc.
              "documentoFederalCedente": "string", // string(20)   Federal document of the assignor
              "nomeCedente": "string", // string(60)   Name of the assignor
              "documentoFederal": "string", // Federal Document Number | REQUIRED
              "nomePagamento": "string" // Name for payment | REQUIRED
              }
          ]
  ```
</Expandable>

## 5 - Guarantees

To apply for Home Equity credit, you must add a client's property as collateral. Use this endpoint to include property information and register the collateral.

<Expandable title="Collateral Registration">
  To register the property collateral, you must enter:

  * Proposal code;
  * Property group;
  * Property subgroup;
  * Other property information.

  For more information about this endpoint, access the reference document [36 - Save Property Collateral Proposal](https://bmpdocs.moneyp.com.br/caas/api-reference/garantias/36-salvar-proposta-garantia-bem).

  ```json theme={null}
  curl --location 'https://api.bmpdigital.moneyp.dev.br/Proposta/SalvarPropostaGarantiaBem' \
  --header 'IdempotencyKey: UNIQUE GUID FOR EACH CALL' \
  --header 'Content-Type: application/json' \
  --data '{
      "dto": {
          "codigo": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "codigoProposta": "3fa85f64-5717-4562-b3fc-2c963f66afa6", // MANDATORY
          "codigoIdentificador": "string",
          "nomeProprietario": "string",
          "documentoFederalProprietario": "string",
          "grupo": 0, // MANDATORY
          "subgrupo": 0, // MANDATORY
          "descricaoSubgrupo": "string",
          "vlrTotal": 0,
          "descricao": "string",
          "propostaGarantiaBemImovel": {
              "codigo": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 
              "cep": "string",
              "logradouro": "string",
              "nroLogradouro": "string",
              "bairro": "string",
              "complemento": "string",
              "cidade": "string",
              "uf": "string",
              "possuiRegistroCartorio": true,
              "nomeCartorio": "string",
              "nroMatricula": "string",
              "nroCIBNirf": "string",
              "nroCEICNO": "string",
              "qtdArea": 0,
              "unidMedidaArea": "string"
          },
          "parametros": [
              {
                  "nome": "string",
                  "valor": "string"
              }
          ]
      }
  }'
  ```
</Expandable>

## 6 - Collecting Signatures

After entering the property details and registering the guarantee, you must collect signatures from all parties involved in the proposal.

To learn more about signature models, access the \[Signatures] document ([https://bmpdocs.moneyp.com.br/caas/assinaturas](https://bmpdocs.moneyp.com.br/caas/assinaturas)).

Signatures can be completed in three ways:

<Expandable title="Electronic Signature">
  To use the electronic signature, you must provide:

  * Name, email, document, description, cell phone number, and signature deadline of the signer;
  * Indicate whether the signer will receive the CCB by email, WhatsApp, or SMS;
  * Signature deadline.

  For more information about this endpoint, please visit the reference document [39 - CCB Signature Inclusion](https://bmpdocs.moneyp.com.br/caas/api-reference/assinaturas/39-inclusao-assinatura-ccb).

  ```json theme={null}
  curl --location 'https://api.bmpdigital.moneyp.dev.br/Proposta/IncluirAssinaturaCCB' \
  --header 'accept: text/plain' \
  --header 'Authorization: Bearer qXdZot13a6EbJkAbjpZ5ep_eTKH2F5ZHOwZrYZVN1lw' \
  --header 'IdempotencyKey: UNIQUE GUID FOR EACH CALL' \
  --header 'Content-Type: application/json' \
  --data '{
      "dto": { // Only one of the fields below must be provided
          "codigoProposta": "3fa85f64-5717-4562-b3fc-2c963f66afa6", // Enter the proposal GUID generated in the response of the proposal inclusion
          "codigoOperacao": "string" // Enter the operation code used in the proposal inclusion
      },
      "assinantes": [
          {
              "nome": "string", // Enter the subscriber's name | REQUIRED
              "email": "string", // Enter the subscriber's email | REQUIRED
              "documento": "string", // Enter the subscriber's federal document | REQUIRED
              "descricao": "string", // Enter the subscriber's role in the operation | REQUIRED
              "telefoneCelular": "string", // Enter the subscriber's mobile phone | REQUIRED
              "notificarPorEmail": true, // This field controls whether the customer will receive the CCB by email for signature | REQUIRED
              "notificarPorWhatsApp": true, // If the customer will receive the signature token via WhatsApp, set this field to true. If not, set to false | OPTIONAL
              "notificarPorSMS": true, // If the customer will receive the signature token via SMS, set this field to true. If not, set to false | OPTIONAL
              "codigoIdentificador": "string", // Subscriber identifier code within the proposal (if you want to make any changes to this subscriber, provide this code in another API call) | OPTIONAL
              "dtLimiteAssinatura": "2024-02-21T19:47:38.567Z" // Deadline for the subscriber to sign | REQUIRED
          }
      ]
  }'
  ```
</Expandable>

<Expandable title="Relogon Signature">
  To use the Relogon signature, it is necessary to follow the steps below:

  <Steps>
    <Step title="Coleta do Modelo de Assinatura">
      To collect the signature model, make a request to the [CCB Printing](https://bmpdocs.moneyp.com.br/caas/api-reference/impressao-documentos/37-impressao-ccb) endpoint, using the proposal code and integration code parameters.

      ```json theme={null}
      curl --location 'https://reports.moneyp.dev.br/imprimir?impressao=S&tipo=ccb&code=GUIDPROPOSTA&integracao=CODPARAMETRO&copias=1&versao=' \
      ```
    </Step>

    <Step title="Relogon Signature">
      Through this [endpoint](https://bmpdocs.moneyp.com.br/caas/api-reference/assinaturas/40-relogon), the partner can sign the proposal, allowing the inclusion of subscribers who have already signed in the integrator's backend; the proposal is only finalized after all registered subscribers have signed. This method does not send notification emails and requires authentication parameters, proposal location, and a list of subscribers who have already signed with date, time, and source IP address, through integration with our Relogon Signature API.

      ```json theme={null}
      curl --location 'https://api.bmpdigital.moneyp.dev.br/Proposta/IncluirAssinaturaCCBFinalizada' \
      --header 'IdempotencyKey: UNIQUE GUID FOR EACH CALL' \
      --header 'Content-Type: application/json' \
      --data '{
          "dto": { 
              "codigoProposta": "3fa85f64-5717-4562-b3fc-2c963f66afa6", // Sequential proposal number
              "codigoOperacao": "string" // string(50) Partner Operation Code
        },
        "assinantes": [
          {
            "nome": "string", // string(60)   Required - Subscriber's name
            "email": "string",  // string(60)   Required - Subscriber's email
            "documento": "string", // string(20)  Required – Subscriber's CPF (Individual Taxpayer Registry) or CNPJ (National Registry of Legal Entities) number
            "descricao": "string", // string(100)    Subscriber characterization
            "notificarPorEmail": true, // Required - The subscriber marked to receive the notification will have control over all signatures and can request pending signatures. The email will be sent by BMP.
            "dtAssinatura": "2024-01-15T14:21:57.250Z", // Required - Date and time the signature was performed in the integrator's backend
            "ipAssinatura": "string" // string(255) Required - IP number where the signature was collected
          }
        ]
      }'
      ```
    </Step>

    <Step title="Proposal finalization">
      Through this [endpoint](https://bmpdocs.moneyp.com.br/caas/api-reference/assinaturas/42-finalizacao-de-proposta), the partner can finalize the proposal after the signing procedure is completed. After sending the Relogon signature request, it will be necessary to finalize the proposal through integration with the Proposal Finalization endpoint.

      ```json theme={null}
      curl --location 'https://api.bmpdigital.moneyp.dev.br/Proposta/Finalizar' \
      --header 'IdempotencyKey: UNIQUE GUID FOR EACH CALL' \
      --header 'Content-Type: application/json' \
      --header 'Authorization: Bearer g3Lmb6cowHidKJwwu8J-5xAVAViSysAZAajzeeeTXq4' \
      --data '{
          "dto": { 
            "codigoProposta": "3fa85f64-5717-4562-b3fc-2c963f66afa6", // Sequential proposal number
            "codigoOperacao": "string" // string(50) Partner Operation Code
          },
          "parametros": [ 
              {
                  "Nome": "FINALIZACAO_VALIDARPARCELAS",
                  "Valor": "FALSE"
              },
              {
                  "Nome": "IP_ADDRESS",
                  "Valor": "00.000.000.00"
              }
          ]
      }'
      ```
    </Step>

    <Step title="Signed CCB Printing">
      This [endpoint](https://bmpdocs.moneyp.com.br/caas/api-reference/impressao-documentos/37-impressao-ccb) is used to request the printing of a Bank Credit Certificate (CCB), through the proposal code and integration code parameters. At this stage, it is necessary to query the CCB through integration with our CCB Printing URL for model validation before signing.

      ```json theme={null}
      curl --location 'https://reports.moneyp.dev.br/imprimir?impressao=S&tipo=ccb&code=GUIDPROPOSTA&integracao=CODPARAMETRO&copias=1&versao=' \
      ```
    </Step>
  </Steps>
</Expandable>

<Expandable title="Certification Signature">
  <Steps>
    <Step title="Signature Model Collection">
      This [endpoint](https://bmpdocs.moneyp.com.br/caas/api-reference/impressao-documentos/37-impressao-ccb) is used to request the printing of a Bank Credit Certificate (CCB), through the proposal code and integration code parameters. At this stage, it is necessary to query the CCB through integration with our CCB Printing URL for model validation before signing.

      ```json theme={null}
      curl --location 'https://reports.moneyp.dev.br/imprimir?impressao=S&tipo=ccb&code=GUIDPROPOSTA&integracao=CODPARAMETRO&copias=1&versao=' \
      ```
    </Step>

    <Step title="Sending to Certification Authority">
      At this stage, it will be necessary to send the CCB model to the certification authority for signing.
    </Step>

    <Step title="Certification Signature">
      Through this [endpoint](https://bmpdocs.moneyp.com.br/caas/api-reference/assinaturas/41-certificadora), the partner signs the proposal via a Certifier, such as Docusign, QCertifica, Clicksign, Finanblue, among others. The process begins with downloading the CCB (Contracting Agreement) without the MODELO watermark available on our portal, followed by signature by a certifying agency and subsequent attachment of the signed CCB to the proposal. After collecting the signatures, the signed CCB must be uploaded through integration with our Certifying Signature API.

      ```json theme={null}
      curl --location 'https://api.bmpdigital.moneyp.dev.br/Proposta/IncluirDocumento' \
      --header 'IdempotencyKey: UNIQUE GUID FOR EACH CALL' \
      --header 'Content-Type: application/json' \
      --header 'Authorization: Bearer token gerado no 1º passo' \
      --data '{
        "dto": { 
          "codigoProposta": "3fa85f64-5717-4562-b3fc-2c963f66afa6", // Sequential proposal number 
          "codigoOperacao": "string" // string(50)  Partner Operation Code
        },
        "documento": {
          "codigo": "3fa85f64-5717-4562-b3fc-2c963f66afa6", // Filled with the file code in the BMP database
          "tipoDocumento": 30, // Required - See document type table
          "nomeArquivo": "string", // string(500)   Required - File name
          "extensao": "string", // string(20)  Required - File extension
          "dtValidade": "2023-05-23T20:57:08.922Z", // File expiration date
          "arquivo": "string" // Required - Byte array containing the file
        }
      }'
      ```
    </Step>

    <Step title="Proposal Finalization">
      Through this [endpoint](https://bmpdocs.moneyp.com.br/caas/api-reference/assinaturas/42-finalizacao-de-proposta), the partner can finalize the proposal after the signing procedure is completed. After sending the Relogon signature request, it will be necessary to finalize the proposal through integration with the Proposal Finalization endpoint.

      ```json theme={null}
      curl --location 'https://api.bmpdigital.moneyp.dev.br/Proposta/Finalizar' \
      --header 'IdempotencyKey: UNIQUE GUID FOR EACH CALL' \
      --header 'Content-Type: application/json' \
      --header 'Authorization: Bearer g3Lmb6cowHidKJwwu8J-5xAVAViSysAZAajzeeeTXq4' \
      --data '{
          "dto": { 
              "codigoProposta": "3fa85f64-5717-4562-b3fc-2c963f66afa6", // Sequential proposal number
              "codigoOperacao": "string" // string(50)  Partner Operation Code
          },
          "parametros": [ 
              {
                  "Nome": "FINALIZACAO_VALIDARPARCELAS",
                  "Valor": "FALSE"
              },
              {
                  "Nome": "IP_ADDRESS",
                  "Valor": "00.000.000.00"
              }
          ]
      }'
      ```
    </Step>
  </Steps>
</Expandable>

## 7 - Proposal release

This is the final step in the credit hiring process for Working Capital.

The partner can release the proposal to the payment queue after receiving the "finalized" proposal status, with the disbursement process being the responsibility of BMP.

In this step, it is necessary to release the proposal through integration with our Proposal Release URL for payment to validate the model after signing.

To release the proposal, it is necessary to inform:

* Proposal code;
* Operation code;
* Proposal parameters (if necessary).

For more information about this endpoint, see the reference document [43 - Proposal Release](https://bmpdocs.moneyp.com.br/caas/api-reference/desembolso/43-liberacao-de-proposta).

<Expandable title="Request to Release Proposal">
  ```json theme={null}
  curl --location 'https://api.bmpdigital.moneyp.dev.br/Proposta/Liberar' \
  --header 'IdempotencyKey: UNIQUE GUID FOR EACH CALL' \
  --header 'Content-Type: application/json' \
  --data '{
      "dto": { // Only one of the fields below must be filled in
          "codigoProposta": "3fa85f64-5717-4562-b3fc-2c963f66afa6", // Sequential proposal number
          "codigoOperacao": "string" // string(50)  Partner Operation Code
      },
      "parametros": [
          {}
      ]
  }'
  ```
</Expandable>

## Endpoints e documentos auxiliares

For this journey, it is very important that the partner knows the [Technical Procedure for CaaS Callback](https://bmpdocs.moneyp.com.br/caas/procedimento-tecnico-de-callback/introducao).

The following endpoints may also be useful:

* [28 - Consult Contract](https://bmpdocs.moneyp.com.br/caas/api-reference/gestao-de-propostas/28-consultar): used to consult proposal data;
* [31 - Include Extra Field](https://bmpdocs.moneyp.com.br/caas/api-reference/gestao-de-propostas/31-incluir-campo-extra#): used to include extra fields in the proposal;
* [33 - Contract Cancellation](https://bmpdocs.moneyp.com.br/caas/api-reference/gestao-de-propostas/33-cancelamento-de-contrato#33-cancelamento-de-contrato): used to cancel the contract; \* [38 - View Payment Receipt](https://bmpdocs.moneyp.com.br/caas/api-reference/impressao-documentos/38-comprovante-de-pagamento): used to view the proposal's payment receipt;
* [44 - Bank Account Update](https://bmpdocs.moneyp.com.br/caas/api-reference/desembolso/44-atualizacao-de-conta-bancaria): used to update the payment account;
* [46 - Split Update](https://bmpdocs.moneyp.com.br/caas/api-reference/desembolso/46-atualizacao-de-split): used to update the payment split.
