{"id":1893,"date":"2026-01-16T14:48:34","date_gmt":"2026-01-16T17:48:34","guid":{"rendered":"https:\/\/www.bancosemear.com.br\/docs\/?post_type=docs&#038;p=1893"},"modified":"2026-08-25T12:36:38","modified_gmt":"2026-08-25T15:36:38","slug":"webhook-de-status-da-proposta","status":"publish","type":"docs","link":"https:\/\/www.bancosemear.com.br\/docs\/?docs=webhook-de-status-da-proposta","title":{"rendered":"Webhook de Status da Proposta &#8211; Novo"},"content":{"rendered":"\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">1. Vis\u00e3o geral<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">O webhook-proposal-status \u00e9 um mecanismo de notifica\u00e7\u00e3o ass\u00edncrona respons\u00e1vel por enviar, via HTTP POST, atualiza\u00e7\u00f5es de status da proposta de<br>Empr\u00e9stimo Consignado (INSS) para um endpoint configurado por cliente (ClientId).<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">2. Contexto na esteira de aquisi\u00e7\u00e3o<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">O webhook de status \u00e9 acionado ao longo de toda a esteira de aquisi\u00e7\u00e3o, sempre que ocorre uma altera\u00e7\u00e3o no status da proposta. A cada evento, \u00e9 retornado o status da etapa executada, permitindo o acompanhamento cont\u00ednuo da evolu\u00e7\u00e3o da opera\u00e7\u00e3o.&nbsp;<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">O mecanismo contempla todas as etapas do processo, incluindo Valida\u00e7\u00e3o de Crivo, Averba\u00e7\u00e3o, Integra\u00e7\u00e3o Documental, Anu\u00eancia, Desembolso e Encarteiramento.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Al\u00e9m disso, \u00e9 poss\u00edvel configurar webhooks distintos para cada status ou etapa do fluxo, permitindo que diferentes sistemas consumidores sejam notificados de forma espec\u00edfica conforme a evolu\u00e7\u00e3o da proposta.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">3. Contrato do webhook enviado ao cliente (sa\u00edda HTTP)<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Para cada evento consumido, o Worker envia um HTTP POST para o endpoint configurado.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">4. M\u00e9todo e headers<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Item<\/th><th>Valor<\/th><\/tr><\/thead><tbody><tr><td>M\u00e9todo<\/td><td>POST<\/td><\/tr><tr><td>Content-Type<\/td><td>application\/json<\/td><\/tr><tr><td>Timeout<\/td><td>5 segundos<\/td><\/tr><tr><td>Headers de autentica\u00e7\u00e3o<\/td><td>Dependem de webhook_config.auth_type<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><span style=\"font-size: 2rem;\">5. Autentica\u00e7\u00e3o e autoriza\u00e7\u00e3o (envio do webhook)<\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">O Worker adiciona o header conforme o campo auth_type.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><td><strong>auth_type (webhook_config)<\/strong><\/td><td><strong>Comportamento<\/strong><\/td><td><strong>Exemplo de header enviado<\/strong><\/td><\/tr><tr><td>BEARER<\/td><td>Adiciona Authorization: Bearer {auth_config}<\/td><td>Authorization: Bearer eyJ\u2026<\/td><\/tr><tr><td>API_KEY<\/td><td>Adiciona x-api-key: {auth_config}<\/td><td>x-api-key: 7f9c\u2026<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><span style=\"font-size: 2rem;\">6. Respostas esperadas e tratamento de erros<\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">O endpoint do cliente deve retornar:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>HTTP 2xx<\/strong>: entrega considerada bem-sucedida (delivery_status = SENT).<\/li>\n\n\n\n<li><strong>HTTP 4xx<\/strong>: falha definitiva (delivery_status = FAILED) e evento segue para retentativa\/erro conforme RetryAmount.<\/li>\n\n\n\n<li><strong>HTTP 5xx<\/strong>: falha do servidor do cliente (delivery_status = FAILED) e evento segue para retentativa\/erro conforme RetryAmount.<\/li>\n\n\n\n<li><strong>Timeout\/Exce\u00e7\u00e3o HTTP<\/strong>: falha t\u00e9cnica (delivery_status = FAILED) e evento segue para retentativa\/erro conforme RetryAmount.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\"><span style=\"font-size: 2rem;\">7. Webhook por Evento<\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><span style=\"font-size: 2rem;\">7.1. Crivo<\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Sucesso<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n \"webhook_type\": \"worker_credit.eligibility\",\n \"success\": true,\n \"data\": {\n   \"id\": \"&lt;&lt;contract.id>>\"\n }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Falha<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n \"webhook_type\": \"worker_credit.eligibility\",\n \"success\": false,\n \"data\": {\n   \"id\": \"&lt;&lt;contract.id>>\",\n   \"message\": \"Descri\u00e7\u00e3o da falha\"\n }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><span style=\"font-size: 2rem;\">7.2. Averba\u00e7\u00e3o<\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Sucesso<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n \"webhook_type\": \"worker_credit.endorsement\",\n \"success\": true,\n \"data\": {\n   \"id\": \"&lt;&lt;contract.id>>\",\n   \"raw_dataprev_data\": {}\n }\n}\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Teimosinha<\/strong>:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n \"webhook_type\": \"worker_credit.endorsement\",\n \"success\": false,\n \"data\": {\n   \"id\": \"&lt;&lt;contract.id>>\",\n   \"code\": 422,\n   \"message\": \"&#91;C\u00f3digo de retorno Dataprev] - &#91;Descri\u00e7\u00e3o retorno Dataprev] - RETRY\"\n   \"raw_dataprev_data\": {}\n }\n}\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Falha<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n \"webhook_type\": \"worker_credit.endorsement\",\n \"success\": false,\n \"data\": {\n   \"id\": \"&lt;&lt;contract.id>>\",\n   \"code\": \"OV\",\n   \"message\": \"Descri\u00e7\u00e3o da falha\",\n   \"raw_dataprev_data\": {\n     \"message\": \"Json do retorno cru da dataprev\"\n   }\n }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><span style=\"font-size: 2rem;\">7.3. Integra\u00e7\u00e3o Documental<\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Sucesso<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n \"webhook_type\": \"worker_credit.document_integration\",\n \"success\": true,\n \"data\": {\n \"id\": \"&lt;&lt;contract.id>>\",\n   \"raw_documental_data\": {}\n }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Falha<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n \"webhook_type\": \"worker_credit.document_integration\",\n \"success\": false,\n \"data\": {\n   \"id\": \"&lt;&lt;contract.id>>\",\n   \"code\": \"OV\",\n   \"message\": \"Descri\u00e7\u00e3o da falha\",\n   \"raw_documental_data\": {\n     \"message\": \"Json do retorno cru da integra\u00e7\u00e3o documental\"\n   }\n }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><span style=\"font-size: 2rem;\">7.4. Confirma\u00e7\u00e3o de Anu\u00eancia<\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Sucesso<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{ \n  \"webhook_type\": \"worker_credit.consent\", \n  \"success\": true,\n  \"data\": {\n    \"id\": \"&lt;&lt;contract.id>>\",\n    \"raw_dataprev_data\": {}\n  }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Falha<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{ \n \"webhook_type\": \"worker_credit. consent \",\n \"success\": false,\n \"data\": {\n   \"id\": \"&lt;&lt;contract.id>>\",\n   \"code\": \"OV\",\n   \"message\": \"Descri\u00e7\u00e3o da falha\",\n   \"raw_dataprev_data\": {\n     \"message\": \"Json do retorno cru da dataprev\"\n   }\n }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><span style=\"font-size: 2rem;\">7.5. Aprova\u00e7\u00e3o de Pagamento (Paradinha Corban)<\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Sucesso<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n \"webhook_type\": \"worker_credit.awaiting_corban_action\",\n \"success\": true,\n \"data\": {\n   \"id\": \"&lt;&lt;contract.id>>\",\n   \"raw_corban_data\": {\n      \"message\": \"{\\\"eventId\\\":\\\"b9e1a4f2-3d67-4c90-8e25-1a45b7c2d3e5\\\",\\\"numeroContratoOriginal\\\":\\\"983354331\\\",\\\"numeroContratoInterno\\\":\\\"2026080600021\\\",\\\"cpf\\\":\\\"12345678909\\\",\\\"nomeCliente\\\":\\\"Maria Aparecida da Silva\\\",\\\"bancoOriginador\\\":\\\"Banco Teste.\\\",\\\"saldoPortado\\\":18450.75,\\\"quantidadeParcelasPortada\\\":84,\\\"quantidadeParcelasVencidas\\\":3,\\\"dataPrimeiroVencimento\\\":\\\"2026-08-05\\\",\\\"dataUltimoVencimento\\\":\\\"2033-07-05\\\"}\"\n  }\n }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Falha<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n \"webhook_type\": \"worker_credit.awaiting_corban_action\",\n \"success\": false,\n \"data\": {\n   \"id\": \"&lt;&lt;contract.id>>\",\n   \"code\": \"400\",\n   \"message\": \"Descri\u00e7\u00e3o da falha\"\n }\n}<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\"><span style=\"font-size: 2rem;\">7.6. Desembolso<\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Sucesso<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n \"webhook_type\": \"worker_credit.disbursement\",\n \"success\": true,\n \"data\": {\n   \"id\": \"&lt;&lt;contract.id>>\",\n   \"payment_datetime\": \"2025-05-02T10:10:10-03:00\"\n }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Falha<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n \"webhook_type\": \"worker_credit.disbursement\",\n \"success\": false,\n \"data\": {\n   \"id\": \"&lt;&lt;contract.id>>\",\n   \"code\": \"500\",\n   \"message\": \"Descri\u00e7\u00e3o da falha\"\n }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><span style=\"font-size: 2rem;\">7.7. Encarteiramento<\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Sucesso<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n \"webhook_type\": \"worker_credit.portfolio\",\n \"success\": true,\n \"data\": {\n   \"id\": \"&lt;&lt;contract.id>>\"\n }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Falha<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n \"webhook_type\": \"worker_credit.portfolio\",\n \"success\": false,\n \"data\": {\n   \"id\": \"&lt;&lt;contract.id>>\",\n   \"code\": \"500\",\n   \"message\": \"Descri\u00e7\u00e3o da falha\"\n }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><span style=\"font-size: 2rem;\">8. Observa\u00e7\u00f5es Importantes<\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Os exemplos acima representam payloads reais utilizados atualmente.<\/li>\n\n\n\n<li>O campo success = false indica falha de neg\u00f3cio\/processo, n\u00e3o falha no envio do webhook.<\/li>\n\n\n\n<li>O campo id retornado corresponde ao mesmo identificador enviado na cria\u00e7\u00e3o da proposta, no campo contract.id da requisi\u00e7\u00e3o de inclus\u00e3o de proposta.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n","protected":false},"excerpt":{"rendered":"<p>1. Vis\u00e3o geral O webhook-proposal-status \u00e9 um mecanismo de notifica\u00e7\u00e3o ass\u00edncrona respons\u00e1vel por enviar, via HTTP POST, atualiza\u00e7\u00f5es de status da proposta deEmpr\u00e9stimo Consignado (INSS) para um endpoint configurado por cliente (ClientId). 2. Contexto na esteira de aquisi\u00e7\u00e3o O webhook de status \u00e9 acionado ao longo de toda a esteira de aquisi\u00e7\u00e3o, sempre que ocorre &hellip;<\/p>\n<p class=\"read-more\"> <a class=\"\" href=\"https:\/\/www.bancosemear.com.br\/docs\/?docs=webhook-de-status-da-proposta\"> <span class=\"screen-reader-text\">Webhook de Status da Proposta &#8211; Novo<\/span> Leia mais &raquo;<\/a><\/p>\n","protected":false},"author":14,"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":[60],"doc_tag":[],"class_list":["post-1893","docs","type-docs","status-publish","hentry","doc_category-contrato-novo-margem-livre"],"_links":{"self":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/1893","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\/14"}],"replies":[{"embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1893"}],"version-history":[{"count":23,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/1893\/revisions"}],"predecessor-version":[{"id":2248,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/1893\/revisions\/2248"}],"wp:attachment":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1893"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_category&post=1893"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_tag&post=1893"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}