Incluir Proposta Consignado Trabalhador (CLT)

Descrição #

Esta operação recebe uma proposta de crédito consignado CLT já averbada e a registra no sistema de crédito do Banco Semear. Cada chamada representa um trabalhador cuja simulação foi aceita e que passa a aguardar o desembolso.

Endpoints #

Produção: https://api2.bancosemear.com.br/api/payroll-loan-credit-proposal/v1/public/proposals/clt

Homologação: https://hmlapi2.bancosemear.com.br/payroll-loan-clt-proposal-api/v1/public/proposals/clt

Requisição (POST) #

O campo de parâmetro idParametroProduto é “E541B103-6871-4A5D-969C-D2D8D17EAAC2”, pois o mesmo se refere ao produto designado. 

Segue exemplo de requisição:

postman request POST 'https://hmlapi2.bancosemear.com.br/api/payroll-loan-credit-proposal/v1/public/proposals/clt' \ 
  --header 'accept: application/json' \ 
  --header 'client_id: 719033b9-c453-4fe6-ab00-13d8de94daae' \ 
  --header 'access_token: f679ba6a-6154-4527-aa9e-6f7efbf99dd4' \ 
  --header 'Content-Type: application/json' \ 
--body '{ 
{ 
  "cliente": { 
    "nome": "Ricardo Matheus Benicio",
    "dataNascimento": "1988-04-17T00:00:00.000Z",
    "nomeMae": "Maria Aparecida Almeida",
    "documento": {
      "cpf": "03471199560",
      "rg": "458796321",
      "orgaoEmissor": "SSP",
      "uf": "SP"
    },
    "endereco": {
      "rua": "Avenida das Palmeiras",
      "tipoLogradouro": 2,
      "numero": "1250",
      "bairro": "Jardim Primavera",
      "complemento": "Apartamento 84",
      "cidade": "Sao Paulo",
      "estado": "SP",
      "cep": "02045010"
    },
    "contatos": {
      "fone": {
        "ddd": "11",
        "numero": "34567890"
      },
      "celular": {
        "ddd": "11",
        "numero": "998765432"
      },
      "email": "joao.almeida.teste@example.com"
    },
    "nacionalidade": "Brasileira",
    "genero": 1,
    "renda": 7500.00,
    "categoriaProfissional": "Analista de Sistemas",
    "estadoCivil": 1,
    "tipoRenda": "SALARIO",
    "tipoVinculo": "CLT",
    "nomeEmpregador": "Empresa Teste",
    "cnpjEmpregador": "11444777000161",
    "matricula": "ESOCIAL-000123",
    "dataAdmissao": "2021-03-01",
    "cargo": "Analista de Sistemas"
  },
  "dadosBancarios": {
    "agencia": "0019",
    "conta": "0110376589",
    "numeroBanco": "743",
    "tipoConta": 1,
    "titularidade": "PROPRIA",
    "principal": true
  },
  "idParametroProduto": "E541B103-6871-4A5D-969C-D2D8D17EAAC2",
  "chaveDesembolso": "01A11BCB-521B-7479-845F-D8F3DCC29D06",
  "subCorban": "123",
  "agenteCredito": "456",
  "cessionario": {
    "cnpj": "11.222.333/0001-81",
    "chave": "CES-001",
    "nome": "Aurora FIDC"
  },
  "garantia": {
    "cnpjEmpregador": "11444777000161",
    "matricula": "ESOCIAL-000123",
    "dataAdmissao": "2021-03-01",
    "dataAutorizacao": "2026-10-26",
    "margemDisponivel": 1000,
    "itens": [
      {
        "tipo": "SALDO_FGTS",
        "valor": 3109.87,
        "saldoTotalFgts": 31098.70,
        "percentual": 10,
        "chaveAutorizacaoFgts": "0199f3a0-11aa-7c3d-8e2f-5a6b7c8d9e0f"
      },
      {
        "tipo": "MULTA_FGTS",
        "valor": 1000,
        "percentual": 40
      },
      {
        "tipo": "VERBAS_RESCISORIAS",
        "percentual": 35
      }
    ]
  },
  "detalhesProposta": {
    "dataLiberacao": "2026-03-11T00:00:00.000Z",
    "dataVencimentoInicial": "2026-05-05T00:00:00.000Z",
    "dataVencimentoFinal": "2026-08-05T00:00:00.000Z",
    "numeroParcelas": 4,
    "totalAmortizacao": 2024.64,
    "totalTarifaBancaria": 0.00,
    "totalTarifaSeguro": 0.00,
    "totalJuros": 103.76,
    "totalValorParcelas": 2128.40,
    "valorBruto": 2024.64,
    "valorLiquido": 2000.00,
    "tipoSeguro": "PRESTAMISTA",
    "valorSeguro": 0.00,
    "valorRegistro": 0.00,
    "valorTarifaTransferencia": 0.00,
    "tipoIof": "FINANCIADO",
    "valorIof": 24.64,
    "taxaJurosAnual": 19.56,
    "taxaJurosMensal": 1.50,
    "taxaDiaria": 0.04912345,
    "cetMensal": 1.8722,
    "cetAnual": 24.92,
    "percentualJurosCet": 0.00,
    "percentualImpostoCet": 0.00,
    "percentualTarifaCet": 0.00,
    "percentualServicoCet": 0.00,
    "idCarteira": "C5",
    "contrato": "20260100003",
    "valorEntrada": 0.00,
    "nomeBem": "Credito Pessoal",
    "valorBem": 2024.64
  },
  "parcelas": [
    {
      "numeroDaParcela": 1,
      "dataDeVencimento": "2026-05-05T00:00:00.000Z",
      "valorDaAmortizacao": 517.77,
      "valorDoJuros": 14.33,
      "valorDaParcela": 532.10,
      "valorPresente": 0,
      "diasPrazo": 55,
      "diasAcumulados": 55,
      "saldoDevedor": 0,
      "iofDiario": 0,
      "iofAdicional": 0,
      "iofTotal": 0
    },
    {
      "numeroDaParcela": 2,
      "dataDeVencimento": "2026-06-05T00:00:00.000Z",
      "valorDaAmortizacao": 509.87,
      "valorDoJuros": 22.23,
      "valorDaParcela": 532.10,
      "valorPresente": 0,
      "diasPrazo": 31,
      "diasAcumulados": 86,
      "saldoDevedor": 0,
      "iofDiario": 0,
      "iofAdicional": 0,
      "iofTotal": 0
    },
    {
      "numeroDaParcela": 3,
      "dataDeVencimento": "2026-07-05T00:00:00.000Z",
      "valorDaAmortizacao": 502.33,
      "valorDoJuros": 29.77,
      "valorDaParcela": 532.10,
      "valorPresente": 0,
      "diasPrazo": 30,
      "diasAcumulados": 116,
      "saldoDevedor": 0,
      "iofDiario": 0,
      "iofAdicional": 0,
      "iofTotal": 0
    },
    {
      "numeroDaParcela": 4,
      "dataDeVencimento": "2026-08-05T00:00:00.000Z",
      "valorDaAmortizacao": 494.67,
      "valorDoJuros": 37.43,
      "valorDaParcela": 532.10,
      "valorPresente": 0,
      "diasPrazo": 31,
      "diasAcumulados": 147,
      "saldoDevedor": 0,
      "iofDiario": 0,
      "iofAdicional": 0,
      "iofTotal": 0
    }
  ]
}

Parâmetros de Requisição #

Cabeçalho

Cabeçalho	Descrição	Obrigatório
Content-Type	Indica o tipo do corpo da requisição. Sempre application/json	Sim
client_id	ID de cliente usado para controle de acesso do gateway de APIs	Sim
access_token	Token recebido após executar o método oAuth	Sim

Corpo (JSON) #

Campos não previstos no contrato são ignorados, não recusados. Isso permite ao parceiro evoluir o payload sem quebrar a integração.

Dados do Cliente #

Propriedade	Descrição	Tipo	Obrigatório
cliente	Objeto contendo os dados cadastrais do cliente.	object	Sim
cliente.nome	Nome completo do cliente.	string	Sim
cliente.dataNascimento	Data de nascimento do cliente.	DateTime	Sim
cliente.nomeMae	Nome completo da mãe do cliente.	string	Sim
cliente.documento	Objeto contendo os documentos de identificação do cliente.	object	Sim
cliente.documento.cpf	CPF do cliente, contendo 11 dígitos.	string	Sim
cliente.documento.rg	Número do RG do cliente.	string	Sim
cliente.documento.orgaoEmissor	Órgão responsável pela emissão do documento de identidade.	string	Sim
cliente.documento.uf	Unidade Federativa de emissão do documento.	string	Sim
cliente.endereco	Objeto contendo os dados de endereço do cliente.	object	Sim
cliente.endereco.rua	Nome do logradouro do endereço.	string	Sim
cliente.endereco.tipoLogradouro	Código que representa o tipo de logradouro conforme enumeração da aplicação.	int	Sim
cliente.endereco.numero	Número do imóvel.	string	Sim
cliente.endereco.bairro	Bairro do endereço do cliente.	string	Sim
cliente.endereco.complemento	Complemento do endereço, como apartamento, bloco ou casa.	string	Não
cliente.endereco.cidade	Cidade do endereço do cliente.	string	Sim
cliente.endereco.estado	Unidade Federativa do endereço.	string	Sim
cliente.endereco.cep	CEP do endereço, contendo 8 dígitos.	string	Sim
cliente.contatos	Objeto contendo os dados de contato do cliente.	object	Sim
cliente.contatos.fone	Objeto contendo os dados do telefone fixo.	object	Não
cliente.contatos.fone.ddd	Código DDD do telefone fixo.	string	Não
cliente.contatos.fone.numero	Número do telefone fixo, sem DDD.	string	Não
cliente.contatos.celular	Objeto contendo os dados do telefone celular.	object	Sim
cliente.contatos.celular.ddd	Código DDD do telefone celular.	string	Sim
cliente.contatos.celular.numero	Número do celular, sem DDD.	string	Sim
cliente.contatos.email	Endereço de e-mail do cliente.	string	Sim
cliente.nacionalidade	Nacionalidade do cliente.	string	Sim
cliente.genero	Código que representa o gênero conforme enumeração da aplicação.	int	Sim
cliente.renda	Renda mensal declarada pelo cliente.	decimal	Sim
cliente.categoriaProfissional	Profissão ou categoria profissional do cliente.	string	Sim
cliente.estadoCivil	Código que representa o estado civil conforme enumeração da aplicação.	int	Sim

Dados da renda e do vínculo empregatício #

Propriedade	Descrição	Tipo	Obrigatório
tipoRenda	Tipo de renda do cliente. Exemplo: SALARIO.	string	Não
tipoVinculo	Tipo de vínculo empregatício do cliente. Exemplo: CLT.	string	Não
nomeEmpregador	Nome da empresa ou do empregador do cliente.	string	Não
cnpjEmpregador	CNPJ do empregador, contendo os dados de identificação da empresa.	string	Não
matricula	Matrícula do trabalhador na empresa ou no sistema de registro.	string	Não
dataAdmissao	Data de admissão do trabalhador no empregador.	DateTime	Não
cargo	Cargo ou função exercida pelo cliente.	string	Não

Dados da operação #

Propriedade	Descrição	Tipo	Obrigatório
chavePix	Chave PIX utilizada para identificação ou crédito da operação.	string	Sim
idParametroProduto	Identificador único da parametrização do produto financeiro.	Guid	Sim
chaveDesembolso	Identificador utilizado para rastrear o desembolso da operação.	string	Sim
titularidade	Tipo de titularidade associada à operação. Exemplo: PROPRIA.	string	Não
principal	Indica se o registro está marcado como principal.	boolean	Não
subCorban	Identificador do subcorrespondente bancário associado à operação.	string	Não

Dados do cessionário #

Propriedade	Descrição	Tipo	Obrigatório
cessionario	Objeto contendo os dados de identificação do cessionário.	object	Não
cessionario.cnpj	CNPJ do cessionário.	string	Não
cessionario.chave	Chave de identificação do cessionário.	string	Não
cessionario.nome	Nome ou razão social do cessionário.	string	Não

Detalhes da proposta #

Propriedade	Descrição	Tipo	Obrigatório
detalhesProposta	Objeto contendo os dados financeiros e contratuais da proposta.	object	Sim
detalhesProposta.dataLiberacao	Data de liberação do crédito.	DateTime	Sim
detalhesProposta.dataVencimentoInicial	Data de vencimento da primeira parcela.	DateTime	Sim
detalhesProposta.dataVencimentoFinal	Data de vencimento da última parcela.	DateTime	Sim
detalhesProposta.numeroParcelas	Quantidade total de parcelas da operação.	int	Sim
detalhesProposta.totalAmortizacao	Valor total destinado à amortização do principal.	decimal	Sim
detalhesProposta.totalTarifaBancaria	Soma das tarifas bancárias da operação.	decimal	Sim
detalhesProposta.totalTarifaSeguro	Soma das tarifas relacionadas ao seguro.	decimal	Sim
detalhesProposta.totalJuros	Soma total dos juros da operação.	decimal	Sim
detalhesProposta.totalValorParcelas	Soma do valor total das parcelas.	decimal	Sim
detalhesProposta.valorBruto	Valor bruto da operação antes de descontos e encargos.	decimal	Sim
detalhesProposta.valorLiquido	Valor líquido efetivamente disponibilizado ao cliente.	decimal	Sim
detalhesProposta.tipoSeguro	Tipo ou modalidade de seguro associado à proposta.	string	Não
detalhesProposta.valorSeguro	Valor do seguro da operação.	decimal	Sim
detalhesProposta.valorRegistro	Valor referente ao registro da operação.	decimal	Sim
detalhesProposta.valorTarifaTransferencia	Valor da tarifa de transferência ou desembolso.	decimal	Sim
detalhesProposta.tipoIof	Tipo de tratamento do IOF na operação.	string	Sim
detalhesProposta.valorIof	Valor do IOF incidente sobre a operação.	decimal	Sim
detalhesProposta.taxaJurosAnual	Taxa de juros anual aplicada à operação.	decimal	Sim
detalhesProposta.taxaJurosMensal	Taxa de juros mensal aplicada à operação.	decimal	Sim
detalhesProposta.cetMensal	Custo Efetivo Total mensal da operação.	decimal	Sim
detalhesProposta.cetAnual	Custo Efetivo Total anual da operação.	decimal	Sim
detalhesProposta.percentualJurosCet	Percentual do CET correspondente aos juros.	decimal	Sim
detalhesProposta.percentualImpostoCet	Percentual do CET correspondente aos impostos.	decimal	Sim
detalhesProposta.percentualTarifaCet	Percentual do CET correspondente às tarifas.	decimal	Sim
detalhesProposta.percentualServicoCet	Percentual do CET correspondente aos serviços.	decimal	Sim
detalhesProposta.idCarteira	Identificador da carteira associada à proposta.	string	Sim
detalhesProposta.contrato	Identificador ou número do contrato relacionado à operação.	string	Sim
detalhesProposta.valorEntrada	Valor pago como entrada da operação.	decimal	Sim
detalhesProposta.nomeBem	Nome ou descrição do bem ou finalidade do crédito.	string	Sim
detalhesProposta.valorBem	Valor do bem ou objeto associado à operação.	decimal	Sim

Dados da garantia #

Propriedade	Descrição	Tipo	Obrigatório
garantia	Objeto contendo os dados da garantia associada à operação.	object	Não
garantia.cnpjEmpregador	CNPJ do empregador vinculado à garantia.	string	Não
garantia.matricula	Matrícula do trabalhador vinculada à garantia.	string	Não
garantia.dataAdmissao	Data de admissão do trabalhador no empregador.	DateTime	Não
garantia.dataAutorizacao	Data em que a garantia foi autorizada.	DateTime	Não
garantia.margemDisponivel	Valor da margem disponível para a operação.	decimal	Não
garantia.itens	Lista contendo os itens que compõem a garantia da operação.	array	Não
garantia.itens[].tipo	Tipo do item de garantia. Exemplos: SALDO_FGTS, MULTA_FGTS e VERBAS_RESCISORIAS.	string	Não
garantia.itens[].valor	Valor monetário associado ao item de garantia.	decimal	Não
garantia.itens[].saldoTotalFgts	Valor total do saldo do FGTS considerado para o item de garantia.	decimal	Não
garantia.itens[].percentual	Percentual aplicado ao item de garantia.	decimal	Não
garantia.itens[].chaveAutorizacaoFgts	Chave de identificação da autorização do FGTS.	string	Não

Parcelas #

Propriedade	Descrição	Tipo	Obrigatório
parcelas	Lista contendo as parcelas da operação.	array	Sim
parcelas[].numeroDaParcela	Número sequencial da parcela.	int	Sim
parcelas[].dataDeVencimento	Data de vencimento da parcela.	DateTime	Sim
parcelas[].valorDaAmortizacao	Valor da parcela destinado à amortização do principal.	decimal	Sim
parcelas[].valorDoJuros	Valor dos juros cobrados na parcela.	decimal	Sim
parcelas[].valorDaParcela	Valor total da parcela.	decimal	Sim

Resposta #

Segue exemplo de resposta (HTTP 201):

{
  "idProposta": "2ec434f7-daa3-4f6c-9a27-689ee04677f7",
  "linkPdfCcb": "string",
  "status": 0,
  "idUnico": "1e2a686d-6fd4-48c7-8926-d6e85772fd12",
  "urlUnico": "string",
  "mensagem": "string"
}

Códigos de Retorno #

HTTP	Situação	Corpo
201	Proposta recebida — nova ou reenvio	Objeto de resposta
400	Payload inválido	Array de erros
401	X-Parceiro-Id ausente	Objeto de erro
500	Falha interna	Objeto de erro