13 - Certifier

cURL

cURL

curl --request POST \
  --url https://api.bmpdigital.moneyp.dev.br/Proposta/IncluirDocumento \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'IdempotencyKey: <idempotencykey>' \
  --data '
{
  "dto": {
    "codigoProposta": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "codigoOperacao": "<string>",
    "numeroProposta": 123
  }
}
'

import requests

url = "https://api.bmpdigital.moneyp.dev.br/Proposta/IncluirDocumento"

payload = { "dto": {
        "codigoProposta": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "codigoOperacao": "<string>",
        "numeroProposta": 123
    } }
headers = {
    "IdempotencyKey": "<idempotencykey>",
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    IdempotencyKey: '<idempotencykey>',
    Authorization: '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    dto: {
      codigoProposta: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
      codigoOperacao: '<string>',
      numeroProposta: 123
    }
  })
};

fetch('https://api.bmpdigital.moneyp.dev.br/Proposta/IncluirDocumento', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bmpdigital.moneyp.dev.br/Proposta/IncluirDocumento",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'dto' => [
        'codigoProposta' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        'codigoOperacao' => '<string>',
        'numeroProposta' => 123
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json",
    "IdempotencyKey: <idempotencykey>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bmpdigital.moneyp.dev.br/Proposta/IncluirDocumento"

	payload := strings.NewReader("{\n  \"dto\": {\n    \"codigoProposta\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n    \"codigoOperacao\": \"<string>\",\n    \"numeroProposta\": 123\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("IdempotencyKey", "<idempotencykey>")
	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.bmpdigital.moneyp.dev.br/Proposta/IncluirDocumento")
  .header("IdempotencyKey", "<idempotencykey>")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"dto\": {\n    \"codigoProposta\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n    \"codigoOperacao\": \"<string>\",\n    \"numeroProposta\": 123\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bmpdigital.moneyp.dev.br/Proposta/IncluirDocumento")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["IdempotencyKey"] = '<idempotencykey>'
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"dto\": {\n    \"codigoProposta\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n    \"codigoOperacao\": \"<string>\",\n    \"numeroProposta\": 123\n  }\n}"

response = http.request(request)
puts response.read_body

200

{
  "msg": "<string>",
  "hasError": true,
  "messages": [
    {
      "code": "<string>",
      "context": "<string>",
      "description": "<string>",
      "field": "<string>"
    }
  ],
  "codigo": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "tipoDocumento": 123,
  "nomeArquivo": "<string>",
  "extensao": "<string>",
  "dtValidade": "2023-11-07T05:31:56Z",
  "arquivo": "aSDinaTvuI8gbWludGxpZnk="
}

{
  "msg": "<string>",
  "hasError": true,
  "messages": [
    {
      "code": "<string>",
      "context": "<string>",
      "description": "<string>",
      "field": "<string>"
    }
  ]
}

Through this endpoint, the partner executes the signature of the proposal via a Certifier. Examples of Certifiers: Docusign, QCertifica, Clicksign, Finanblue, among others. The signature process begins when the partner downloads the CCB without the MODELO watermark found on our portal, then signs it via a Certifier and then attaches the CCB to the proposal again.

Messaging

Show Messaging

Categoria	Operação	Ação	Código	Código Detalhado	Mensagem
Proposta	UploadDocumentoProposta	IncluirDocumento	C0068	V0001	Informe o nome do arquivo
Proposta	UploadDocumentoProposta	IncluirDocumento	C0068	V0002	Falha ao enviar Documento
Proposta	UploadDocumentoProposta	IncluirDocumento	C0068	V0003	Documento não pode ser alterado pois está em processo de análise automática.
Proposta	UploadDocumentoProposta	IncluirDocumento	C0112	V0001	Proposta não encontrada
Proposta	UploadDocumentoProposta	IncluirDocumento	C0112	V0002	A Proposta não pertence à esta Integração
Proposta	UploadDocumentoProposta	IncluirDocumento	C0107	V0001	Extensão do arquivo é inválida. Permitido: [txt,bmp,jpg,jpeg,gif,png,pdf,doc,docx,xls,xlsx,zip]
Proposta	UploadDocumentoProposta	IncluirDocumento	C0107	V0002	Tipo de Documento inválido
Proposta	UploadDocumentoProposta	IncluirDocumento	C0107	V0003	Documento deve ser enviado
Proposta	UploadDocumentoProposta	IncluirDocumento	C0020	V0001	Extensão do arquivo é inválida. Permitido: []
Proposta	UploadDocumentoProposta	IncluirDocumento	T0665	D0001	Informe o Cliente
Proposta	UploadDocumentoProposta	IncluirDocumento	T0665	D0002	Documento do Cliente é inválido
Proposta	UploadDocumentoProposta	IncluirDocumento	T0665	D0016	EPCodigo não informado
Proposta	UploadDocumentoProposta	IncluirDocumento	T0665	D0017	Vendedor não encontrado
Proposta	UploadDocumentoProposta	IncluirDocumento	T0665	D0018	Promotor não encontrado
Proposta	UploadDocumentoProposta	IncluirDocumento	T0665	D0019	Informe o Tipo de Operação
Proposta	UploadDocumentoProposta	IncluirDocumento	T0665	D0020	Informe o Valor
Proposta	UploadDocumentoProposta	IncluirDocumento	T0665	D0021	Informe a Quantidade de Parcelas
Proposta	UploadDocumentoProposta	IncluirDocumento	T0665	D0022	Formato de cálculo inválido
Proposta	UploadDocumentoProposta	IncluirDocumento	T0665	D0023	Cliente deve ser pessoa física

Authorizations

Authorization · string · header · required

Informe o token

Headers

IdempotencyKey · string · required

Body

application/jsontext/jsonapplication/*+json

dto · object

Show child attributes

documento · object

Show child attributes

Response

200

text/plain

OK

msg · string | null

hasError · boolean

messages · object[] | null

Show child attributes

codigo · string<uuid> | null

tipoDocumento · integer<int32>

nomeArquivo · string | null

extensao · string | null

dtValidade · string<date-time> | null

arquivo · string<byte> | null