O capital de giro é uma linha de crédito concedida a pessoas jurídicas para gerar liquidez e auxiliar o fluxo de caixa da empresa. As modalidades incluem opções com ou sem garantias, como recebíveis de cartões, duplicatas, contratos de serviços, investimentos, cotas/ações, imóveis e veículos, oferecendo flexibilidade e segurança para a gestão financeira empresarial.

Abaixo segue o passo a passo para utilização do caso de uso:

Antes de utilizar este serviço, é necessário configurar a autenticação. Consulte as instruções de autenticação para orientações detalhadas.

​
1 - Simulações (Opcional)

Conheça abaixo nossos tipos de simulações:

​
2 - Onboarding

Fluxos de cadastros de cliente e endereço:

Nesta etapa será necessário escolher um único fluxo de cadastro

​
3 - Contratação

1

Inclusão de Proposta

Por meio deste endpoint, o parceiro pode incluir propostas de pessoa física ou jurídica de forma manual e simplificada, permitindo o envio dos campos da proposta sem alterações pelo motor de cálculo interno, por meio da integração com nossa API de Incluir Proposta.

curl --location 'https://api.bmpdigital.moneyp.dev.br/Proposta/IncluirManualSimplificado' \
--header 'Authorization: Bearer qXdZot13a6EbJkAbjpZ5ep_eTKH2F5ZHOwZrYZVN1lw' \
--header 'IdempotencyKey: GUID UNICO PARA CADA CHAMADA' \
--header 'Content-Type: application/json' \
--data '{
    "dto": {
        "documentoCliente": "string", // Documento do cliente
        "documentoParceiroCorrespondente": "string",  // Documento do Parceiro Correspondente
        "codigoOperacao": "string", // Obrigatório - Uso do Integrador. É o código da operação no sistema do parceiro. Esta informação é exclusiva e poderá ser utilizada para atualizar a proposta sem necessidade de guardar o código da proposta na BMP. Porém o código de proposta BMP é importante ser armazenado para uso de impressão de boletos/CCB/Nota promissória ou Protocolo.
        "codigoVersaoCCB": 0, // Código da versão da Cédula de Crédito Bancária – (CCB)
        "vlrSolicitado": 0, // Obrigatório - Valor solicitado na proposta
        "prazo": 0, // Obrigatório - Prazo solicitado. Será consistido conforme a parametrizado de integração.
        "percJurosNegociado": 0, // Obrigatório - Percentual de juros da proposta
        "vlrIOF": 0, // Obrigatório - Valor Total do Imposto sobre Operações Financeiras (IOF)
        "percIOF": 0, // Obrigatório - Percentual do Imposto sobre Operações Financeiras (IOF)
        "vlrParcela": 0, // Obrigatório - Valor da Parcela
        "vlrTAC": 0, // Obrigatório - Valor da Tarifa de Cadastro. Pode ser R$ 0,00 quando não houver.
        "dtPrimeiroVencto": "2024-02-21T17:48:40.110Z", // Obrigatório - Data estimada do primeiro vencimento.
        "tipoContrato": "string", // string(5) - Sigla indicando o tipo de contrato da proposta. Exémplo: CSG -> Capital de Giro; CCG -> Capital de Giro com Garantia
        "propostaContaPagamentoDTO": { 
            "tipoConta": 0, // Obrigatório - tipo de conta
            "agencia": "string", // string(10) Obrigatório - Agência bancária
            "agenciaDig": "string", // string(1)Obrigatório - Dígito da agência
            "conta": "string", // string(20) Obrigatório - Conta bancária
            "contaDig": "string", // string(1) Obrigatório - Dígito da conta
            "numeroBanco": "string" //string(5)  Obrigatório - Número da conta
        },
    },
}'

Para utilização de contrato com split de TED adicione o objeto abaixo na requisição anterior dentro do array dto:

Para utilização de contrato com split de BOLETO adicione o objeto abaixo na requisição anterior dentro do array dto:

​
4 - Representantes Legais (Opcional)

1

Incluir Avalistas

Por meio deste endpoint, o parceiro faz a inclusão dos dados dos avalistas para uma proposta, podendo ser pessoas físicas ou jurídicas; os campos não são obrigatórios e devem ser preenchidos conforme a necessidade, por meio da integração com nossa API de Incluir Avalistas.

curl --location 'https://api.bmpdigital.moneyp.dev.br/Proposta/incluirAvalistas' \
--header 'Authorization: Bearer qXdZot13a6EbJkAbjpZ5ep_eTKH2F5ZHOwZrYZVN1lw' \
--header 'Content-Type: application/json' \
--data-raw '{
  "avalistas": [
    {
      "nome": "Tamires Gomes",
      "documentoFederal": "90004202023",
      "cep": "18025540",
      "logradouro": "Rua Cuba",
      "nroLogradouro": "1",
      "bairro": "Vila Barcelona",
      "complemento": null,
      "cidade": "Sorocaba",
      "uf": "SP",
      "avalistaPF": {
        "dtNasc": "2000-04-17",
        "email": "tgomes@teste.com.br",
        "naturalDeCidade": "São Paulo",
        "naturalDeUF": "SP"
      }
    }
  ],
  "dto": {
    "codigoProposta": "b066ab79-a247-4db6-83fa-289343a139f7",
    "codigoOperacao": "6697b4aa9081d6384813a235"
  }
}'

​
5 - Garantias (Opcional)

1

Registro de Garantia

Por meio deste endpoint, o parceiro pode incluir mais de um bem do tipo móvel ou imóvel como garantia para o valor financiado, sendo necessário salvar a proposta de Garantia Bem Documento por meio da integração com nossa API de Registro de Garantia.

curl --location --request GET 'https://api.bmpdigital.moneyp.dev.br/Proposta/SalvarPropostaGarantiaBem' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer qXdZot13a6EbJkAbjpZ5ep_eTKH2F5ZHOwZrYZVN1lw' \
--data '{
  "dto": {
    "codigo": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "codigoProposta": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "codigoIdentificador": "string",
    "nomeProprietario": "string",
    "documentoFederalProprietario": "string",
    "grupo": 0,
    "subgrupo": 0,
    "descricaoSubgrupo": "string",
    "vlrTotal": 0,
    "descricao": "string",
    "propostaGarantiaBemFinan": {
      "codigo": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "numeroEC": "string",
      "seuNumero": "string",
      "dtPrimVencDuplic": "2024-07-22T19:13:06.582Z",
      "dtUltVencDuplic": "2024-07-22T19:13:06.582Z",
      "razaoSocial": "string",
      "cnpj": "string",
      "percCotasGarantia": 0,
      "vlrCapitalSocial": 0,
      "nomeFundo": "string",
      "cnpjFundo": "string",
      "qtdeCotasFundo": 0,
      "qtdeCotasGarantiaFundo": 0,
      "vlrCotasFundo": 0,
      "dtTravaCarencia": "2024-07-22T19:13:06.582Z",
      "nomeLocador": "string",
      "documentoFederalLocador": "string",
      "nomeLocatario": "string",
      "documentoFederalLocatario": "string",
      "dtInicioLocacao": "2024-07-22T19:13:06.582Z",
      "dtTerminoLocacao": "2024-07-22T19:13:06.582Z",
      "moedaVirtual": true,
      "nroBanco": "string",
      "tipoConta": 0,
      "agencia": "string",
      "agenciaDig": "string",
      "conta": "string",
      "contaDig": "string",
      "titularidade": "string",
      "propostaGarantiaBemFinanCartao": [
        {
          "codigo": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "credenciadora": "string",
          "subCredenciadora": "string",
          "arranjo": "string",
          "percArranjo": 0
        }
      ],
      "propostaGarantiaBemFinanSocio": [
        {
          "codigo": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "documentoFederal": "string",
          "nome": "string",
          "qtdeCotas": 0,
          "vlrCotas": 0,
          "percCotas": 0
        }
      ]
    },
    "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"
    },
    "propostaGarantiaBemMovel": {
      "codigo": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "nroRegistro": "string",
      "localizacaoPais": "string",
      "nroSerie": "string",
      "nroNotaFiscal": "string",
      "chaveNFe": "string",
      "marca": "string",
      "modelo": "string"
    },
    "propostaGarantiaBemVeiculo": {
      "codigo": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "placa": "string",
      "marca": "string",
      "modelo": "string",
      "versaoModelo": "string",
      "anoFab": 0,
      "anoMod": 0,
      "cor": "string",
      "chassi": "string",
      "renavam": "string",
      "financiado": true,
      "saldoFinanciamento": 0,
      "tipoPlaca": 0,
      "tipoVeiculo": 0,
      "ufPlaca": "string",
      "ufLicenciamento": "string",
      "vlrFipe": 0,
      "periodoFipe": "string",
      "zeroKM": true,
      "frota": true,
      "tipoChassi": 0,
      "tipoRestricaoGravame": 0,
      "dtRestricaoGravame": "2024-07-22T19:13:06.582Z",
      "codigoFipe": "string",
      "km": 0
    }
  },
  "parametros": [
    {
      "nome": "string",
      "valor": "string"
    }
  ]
}'

​
6 - Coleta de Assinaturas

Para conhecer mais sobre nossas assinaturas, suas particularidades e qual utilizar em seu projeto conheça nosso material explicativo sobre as assinaturas.

Com a assinatura definida durante o planejamento do escopo de projeto com o executivo comercial, selecione abaixo a opção que irá utilizar para prosseguir com o caso de uso:

​
7 - Liberação de proposta

1

Liberação de proposta

Por meio deste endpoint, o parceiro pode liberar a proposta para a fila de pagamento após receber o status de proposta “finalizada”, sendo o processo de desembolso de responsabilidade da BMP. Nesta etapa, é necessário realizar a liberação da proposta por meio da integração com nossa URL de Liberação da proposta para pagamento para validação do modelo após a assinatura.

curl --location 'https://api.bmpdigital.moneyp.dev.br/Proposta/Liberar' \
--header 'IdempotencyKey: GUID UNICO PARA CADA CHAMADA' \
--header 'Content-Type: application/json' \
--data '{
    "dto": { // Apenas um dos campos abaixo deve ser informado
        "codigoProposta": "3fa85f64-5717-4562-b3fc-2c963f66afa6", //Número sequencial da proposta 
    "codigoOperacao": "string" // string(50)  Código da Operação do Parceiro
    },
    "parametros": [
        {}
    ]
}'

​
8 - APIs Auxiliares

Atualização da Conta Bancária será utilizado nesta jornada para atualização da conta pagamento.

Procedimento Técnico Callback será utilizado nesta jornada para confirmação de assintura e confirmação de pagamento.

Consultar Contrato será utilizado nesta jornada para consultar os dados da proposta.

Consultar comprovante de Pagamento será utilizado nesta jornada para consultar o comprovante de pagamento da proposta.

Cancelamento de Contrato será utilizado nesta jornada para cancelamento de contrato.