Enviar Proposta Consignado Trabalhador (CLT)

Descrição #

Esta operação registra uma ou mais propostas de crédito para solicitações obtidas na consulta. Cada proposta é vinculada a uma solicitação pelo idSolicitacaoProposta e identificada, do lado do parceiro, pelo numeroProposta.

O envio é idempotente pelo numeroProposta: reenviar o mesmo número não gera proposta duplicada.

Endpoints #

Produção: https://api2.bancosemear.com.br/caas-credito-trabalhador-clt/v1/leiloes/propostas

Homologação: https://hmlapi2.bancosemear.com.br/caas-credito-trabalhador-clt/v1/leiloes/propostas

Requisição (POST) #

Segue exemplo de requisição:

curl --request POST "https://hmlapi2.bancosemear.com.br/<contexto>/v1/leiloes/propostas" \
--header "Content-Type: application/json" \
--header "client_id: <CLIENT_ID>" \
--header "access_token: <ACCESS_TOKEN>" \
--header "X-Parceiro-Id: <IDENTIFICADOR_DO_PARCEIRO>" \
--data '[
  {
    "numeroProposta": "PRP-2026-000123",
    "idSolicitacaoProposta": 32051605,
    "dataHoraValidadeProposta": "12092026235959",
    "numeroParcelas": 6,
    "valorParcela": 380.50,
    "valorLiberado": 2000.00,
    "valorEmprestimo": 2283.00,
    "valorIOF": 43.20,
    "valorTaxaAnual": 28.50,
    "valorTaxaMensal": 2.11,
    "valorCETAnual": 33.80,
    "valorCETMensal": 2.45,
    "temGarantias": false,
    "contatos": [
      {
        "tipo": 1,
        "contato": "contato@parceiro.com.br"
      }
    ]
  }
]'

Parâmetros de Requisição #

Cabeçalho #

Corpo (JSON) #

O corpo é uma lista. Cada item representa uma proposta.

Resposta #

Segue exemplo de resposta:

{
  "propostas": [
    {
      "codigo": "OK",
      "mensagem": "Proposta registrada.",
      "numeroProposta": "PRP-2026-000123",
      "idSolicitacaoProposta": 32051605,
      "dataHoraValidadeProposta": "12092026235959"
    }
  ],
  "parceiro": {
    "identificador": "PARCEIRO_EXEMPLO"
  },
  "correlacaoId": "9a5e6bc5579047b8b5a6f7bc578a3ff1"
}

Parâmetros de Resposta #

Corpo (JSON) #

Códigos de Retorno #

As duas operações compartilham o mesmo contrato de erro.

Corpo de erro #

Segue exemplo de resposta de erro:

{
  "codigo": "ENTRADA_INVALIDA",
  "mensagem": "Requisicao invalida.",
  "correlacaoId": "1ec3eef2ef6a490c8b72750a06c3de19",
  "detalhes": [
    {
      "campo": "dataHoraInicio",
      "motivo": "deve estar no formato ddMMyyyyHHmmss"
    }
  ]
}