{"id":2322,"date":"2026-09-25T17:32:26","date_gmt":"2026-09-25T20:32:26","guid":{"rendered":"https:\/\/www.bancosemear.com.br\/docs\/?post_type=docs&#038;p=2322"},"modified":"2026-09-25T17:33:41","modified_gmt":"2026-09-25T20:33:41","slug":"incluir-proposta-consignado-trabalhador-clt","status":"publish","type":"docs","link":"https:\/\/www.bancosemear.com.br\/docs\/?docs=incluir-proposta-consignado-trabalhador-clt","title":{"rendered":"Incluir Proposta Consignado Trabalhador (CLT)"},"content":{"rendered":"\n<h3 class=\"wp-block-heading\">Descri\u00e7\u00e3o<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Esta opera\u00e7\u00e3o recebe uma proposta de cr\u00e9dito consignado CLT j\u00e1 averbada e a registra no sistema de cr\u00e9dito do Banco Semear. Cada chamada representa um trabalhador cuja simula\u00e7\u00e3o foi aceita e que passa a aguardar o desembolso.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Endpoints<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Homologa\u00e7\u00e3o: <a href=\"https:\/\/hmlapi2.bancosemear.com.br\/payroll-loan-clt-proposal-api\/v1\/propostas\/inclusao\" target=\"_blank\" rel=\"noopener\">https:\/\/hmlapi2.bancosemear.com.br\/payroll-loan-clt-proposal-api\/v1\/propostas\/inclusao<\/a><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Requisi\u00e7\u00e3o (POST)<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Segue exemplo de requisi\u00e7\u00e3o:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>curl --request POST \"https:\/\/hmlapi2.bancosemear.com.br\/payroll-loan-clt-proposal-api\/v1\/propostas\/inclusao\" \\\n--header \"Content-Type: application\/json\" \\\n--header \"client_id: &lt;CLIENT_ID>\" \\\n--header \"access_token: &lt;ACCESS_TOKEN>\" \\\n--header \"X-Parceiro-Id: &lt;IDENTIFICADOR_DO_PARCEIRO>\" \\\n--header \"X-Correlacao-Id: &lt;UUID_OPCIONAL>\" \\\n--header \"Idempotency-Key: &lt;CHAVE_OPCIONAL_DO_PARCEIRO>\" \\\n--data '{\n  \"idSimulacao\": \"07ea42ce-a2b9-4df7-89f0-87d4fa8ac297\",\n  \"chavePix\": \"fulano@example.com\",\n  \"cliente\": {\n    \"nome\": \"Fulano de Tal\",\n    \"dataNascimento\": \"1990-08-24\",\n    \"nomeMae\": \"Beltrana de Tal\",\n    \"nacionalidade\": \"Brasileira\",\n    \"genero\": 1,\n    \"renda\": 3500.00,\n    \"categoriaProfissional\": \"CLT\",\n    \"estadoCivil\": 1,\n    \"documento\": {\n      \"cpf\": \"529.982.247-25\",\n      \"rg\": \"MG1234567\",\n      \"orgaoEmissor\": \"SSP\",\n      \"uf\": \"MG\"\n    },\n    \"endereco\": {\n      \"rua\": \"Rua das Flores\",\n      \"tipoLogradouro\": 1,\n      \"numero\": \"100\",\n      \"bairro\": \"Centro\",\n      \"complemento\": \"Apto 201\",\n      \"cidade\": \"Belo Horizonte\",\n      \"estado\": \"MG\",\n      \"cep\": \"30110-000\"\n    },\n    \"contatos\": {\n      \"fone\": { \"ddd\": \"31\", \"numero\": \"3333-4444\" },\n      \"celular\": { \"ddd\": \"31\", \"numero\": \"99999-8888\" },\n      \"email\": \"fulano@example.com\"\n    }\n  }\n}'\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Par\u00e2metros de Requisi\u00e7\u00e3o<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Cabe\u00e7alho<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><td><strong>Cabe\u00e7alho<\/strong><\/td><td><strong>Descri\u00e7\u00e3o<\/strong><\/td><td><strong>Obrigat\u00f3rio<\/strong><\/td><\/tr><\/thead><tbody><tr><td>Content-Type<\/td><td>Indica o tipo do corpo da requisi\u00e7\u00e3o. Sempre application\/json<\/td><td>Sim<\/td><\/tr><tr><td>client_id<\/td><td>ID de cliente usado para controle de acesso do gateway de APIs<\/td><td>Sim<\/td><\/tr><tr><td>access_token<\/td><td>Token recebido ap\u00f3s executar o m\u00e9todo oAuth<\/td><td>Sim<\/td><\/tr><tr><td>X-Parceiro-Id<\/td><td>Identificador do parceiro. Usado para segregar os dados e registrar a trilha de auditoria<\/td><td>Sim<\/td><\/tr><tr><td>X-Correlacao-Id<\/td><td>Identificador de correla\u00e7\u00e3o para rastreio ponta a ponta. Deve ser um UUID. Se omitido ou inv\u00e1lido, a API gera um<\/td><td>N\u00e3o<\/td><\/tr><tr><td>Idempotency-Key<\/td><td>Chave do parceiro, registrada para rastreio. <strong>N\u00e3o decide duplicidade<\/strong> \u2014 quem decide \u00e9 o idSimulacao<\/td><td>N\u00e3o<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Corpo (JSON)<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><td><strong>Propriedade<\/strong><\/td><td><strong>Descri\u00e7\u00e3o<\/strong><\/td><td><strong>Tipo<\/strong><\/td><td><strong>Obrigat\u00f3rio<\/strong><\/td><\/tr><\/thead><tbody><tr><td>idSimulacao<\/td><td>Identificador da simula\u00e7\u00e3o aceita. <strong>\u00c9 a chave de idempot\u00eancia.<\/strong> Formato UUID<\/td><td>String<\/td><td>Sim<\/td><\/tr><tr><td>chavePix<\/td><td>Chave Pix de destino do desembolso. At\u00e9 200 caracteres<\/td><td>String<\/td><td>Sim<\/td><\/tr><tr><td>cliente<\/td><td>Dados do trabalhador<\/td><td>Object<\/td><td>Sim<\/td><\/tr><tr><td>cliente.nome<\/td><td>Nome do trabalhador. At\u00e9 255 caracteres<\/td><td>String<\/td><td>Sim<\/td><\/tr><tr><td>cliente.dataNascimento<\/td><td>Data de nascimento no formato yyyy-MM-dd. Tamb\u00e9m aceita instante ISO-8601 completo, do qual usa apenas a data<\/td><td>String<\/td><td>Sim<\/td><\/tr><tr><td>cliente.estadoCivil<\/td><td>C\u00f3digo do estado civil<\/td><td>int32<\/td><td>Sim<\/td><\/tr><tr><td>cliente.nomeMae<\/td><td>Nome da m\u00e3e. At\u00e9 255 caracteres<\/td><td>String<\/td><td>N\u00e3o<\/td><\/tr><tr><td>cliente.nacionalidade<\/td><td>Nacionalidade. At\u00e9 20 caracteres. Quando omitida, grava brasileira<\/td><td>String<\/td><td>N\u00e3o<\/td><\/tr><tr><td>cliente.genero<\/td><td>C\u00f3digo do g\u00eanero<\/td><td>int32<\/td><td>N\u00e3o<\/td><\/tr><tr><td>cliente.renda<\/td><td>Renda mensal. M\u00e1ximo de 2 casas decimais e n\u00e3o pode ser negativa<\/td><td>decimal<\/td><td>N\u00e3o<\/td><\/tr><tr><td>cliente.categoriaProfissional<\/td><td>Categoria profissional. At\u00e9 100 caracteres<\/td><td>String<\/td><td>N\u00e3o<\/td><\/tr><tr><td>cliente.documento<\/td><td>Documentos do trabalhador<\/td><td>Object<\/td><td>Sim<\/td><\/tr><tr><td>cliente.documento.cpf<\/td><td>CPF do trabalhador. Aceita com ou sem m\u00e1scara; \u00e9 gravado somente com d\u00edgitos. D\u00edgito verificador \u00e9 conferido<\/td><td>String<\/td><td>Sim<\/td><\/tr><tr><td>cliente.documento.rg<\/td><td>RG. At\u00e9 15 caracteres<\/td><td>String<\/td><td>N\u00e3o<\/td><\/tr><tr><td>cliente.documento.orgaoEmissor<\/td><td>\u00d3rg\u00e3o emissor do RG. At\u00e9 20 caracteres<\/td><td>String<\/td><td>N\u00e3o<\/td><\/tr><tr><td>cliente.documento.uf<\/td><td>UF do RG. Sigla com 2 letras<\/td><td>String<\/td><td>N\u00e3o<\/td><\/tr><tr><td>cliente.endereco<\/td><td>Endere\u00e7o do trabalhador<\/td><td>Object<\/td><td>Sim<\/td><\/tr><tr><td>cliente.endereco.rua<\/td><td>Logradouro. At\u00e9 120 caracteres<\/td><td>String<\/td><td>Sim<\/td><\/tr><tr><td>cliente.endereco.numero<\/td><td>N\u00famero. At\u00e9 10 caracteres<\/td><td>String<\/td><td>Sim<\/td><\/tr><tr><td>cliente.endereco.bairro<\/td><td>Bairro. At\u00e9 50 caracteres<\/td><td>String<\/td><td>Sim<\/td><\/tr><tr><td>cliente.endereco.cidade<\/td><td>Cidade. At\u00e9 50 caracteres<\/td><td>String<\/td><td>Sim<\/td><\/tr><tr><td>cliente.endereco.estado<\/td><td><strong>Sigla<\/strong> da UF, com exatamente 2 letras. Minas Gerais \u00e9 recusado; MG \u00e9 aceito<\/td><td>String<\/td><td>Sim<\/td><\/tr><tr><td>cliente.endereco.cep<\/td><td>CEP com 8 d\u00edgitos. Aceita com ou sem m\u00e1scara<\/td><td>String<\/td><td>Sim<\/td><\/tr><tr><td>cliente.endereco.complemento<\/td><td>Complemento. At\u00e9 20 caracteres<\/td><td>String<\/td><td>N\u00e3o<\/td><\/tr><tr><td>cliente.endereco.tipoLogradouro<\/td><td>C\u00f3digo do tipo de logradouro. <strong>Recebido e descartado<\/strong> \u2014 n\u00e3o h\u00e1 coluna de destino nesta vers\u00e3o<\/td><td>int32<\/td><td>N\u00e3o<\/td><\/tr><tr><td>cliente.contatos<\/td><td>Contatos do trabalhador<\/td><td>Object<\/td><td>Sim<\/td><\/tr><tr><td>cliente.contatos.email<\/td><td>E-mail. At\u00e9 100 caracteres, precisa conter @<\/td><td>String<\/td><td>Sim<\/td><\/tr><tr><td>cliente.contatos.celular<\/td><td>Celular. Pelo menos um entre celular e fone \u00e9 obrigat\u00f3rio<\/td><td>Object<\/td><td>Condicional<\/td><\/tr><tr><td>cliente.contatos.celular.ddd<\/td><td>DDD do celular<\/td><td>String<\/td><td>Condicional<\/td><\/tr><tr><td>cliente.contatos.celular.numero<\/td><td>N\u00famero do celular. ddd + numero somam no m\u00e1ximo 15 d\u00edgitos<\/td><td>String<\/td><td>Condicional<\/td><\/tr><tr><td>cliente.contatos.fone<\/td><td>Telefone fixo. Pelo menos um entre celular e fone \u00e9 obrigat\u00f3rio<\/td><td>Object<\/td><td>Condicional<\/td><\/tr><tr><td>cliente.contatos.fone.ddd<\/td><td>DDD do telefone<\/td><td>String<\/td><td>Condicional<\/td><\/tr><tr><td>cliente.contatos.fone.numero<\/td><td>N\u00famero do telefone. ddd + numero somam no m\u00e1ximo 15 d\u00edgitos<\/td><td>String<\/td><td>Condicional<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Campos n\u00e3o previstos no contrato s\u00e3o <strong>ignorados<\/strong>, n\u00e3o recusados. Isso permite ao parceiro evoluir o payload sem quebrar a integra\u00e7\u00e3o.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Resposta<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Segue exemplo de resposta (<strong>HTTP 201<\/strong>):<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"idProposta\": \"8eb9a311-9d4d-40f9-b8b7-285a73adba67\",\n  \"status\": 201,\n  \"mensagem\": \"Proposta recebida e persistida com sucesso\"\n}\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">C\u00f3digos de Retorno<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><td><strong>HTTP<\/strong><\/td><td><strong>Situa\u00e7\u00e3o<\/strong><\/td><td><strong>Corpo<\/strong><\/td><\/tr><\/thead><tbody><tr><td>201<\/td><td>Proposta recebida \u2014 nova ou reenvio<\/td><td>Objeto de resposta<\/td><\/tr><tr><td>400<\/td><td>Payload inv\u00e1lido<\/td><td><strong>Array<\/strong> de erros<\/td><\/tr><tr><td>401<\/td><td>X-Parceiro-Id ausente<\/td><td>Objeto de erro<\/td><\/tr><tr><td>500<\/td><td>Falha interna<\/td><td>Objeto de erro<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Descri\u00e7\u00e3o Esta opera\u00e7\u00e3o recebe uma proposta de cr\u00e9dito consignado CLT j\u00e1 averbada e a registra no sistema de cr\u00e9dito do Banco Semear. Cada chamada representa um trabalhador cuja simula\u00e7\u00e3o foi aceita e que passa a aguardar o desembolso. Endpoints Homologa\u00e7\u00e3o: https:\/\/hmlapi2.bancosemear.com.br\/payroll-loan-clt-proposal-api\/v1\/propostas\/inclusao Requisi\u00e7\u00e3o (POST) Segue exemplo de requisi\u00e7\u00e3o: Par\u00e2metros de Requisi\u00e7\u00e3o Cabe\u00e7alho Cabe\u00e7alho Descri\u00e7\u00e3o Obrigat\u00f3rio Content-Type &hellip;<\/p>\n<p class=\"read-more\"> <a class=\"\" href=\"https:\/\/www.bancosemear.com.br\/docs\/?docs=incluir-proposta-consignado-trabalhador-clt\"> <span class=\"screen-reader-text\">Incluir Proposta Consignado Trabalhador (CLT)<\/span> Leia mais &raquo;<\/a><\/p>\n","protected":false},"author":27,"featured_media":0,"parent":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"default","ast-global-header-display":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","footnotes":""},"doc_category":[64],"doc_tag":[],"class_list":["post-2322","docs","type-docs","status-publish","hentry","doc_category-64"],"_links":{"self":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/2322","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/users\/27"}],"replies":[{"embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=2322"}],"version-history":[{"count":3,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/2322\/revisions"}],"predecessor-version":[{"id":2325,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/2322\/revisions\/2325"}],"wp:attachment":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=2322"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_category&post=2322"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_tag&post=2322"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}