{"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-04-28T13:50:34","modified_gmt":"2026-04-28T16:50:34","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"},"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>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<p>&nbsp;<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">2. Contexto na esteira de aquisi\u00e7\u00e3o<\/h2>\n\n\n\n<p>O webhook de status \u00e9 acionado durante a esteira de aquisi\u00e7\u00e3o, principalmente nas etapas de STATUS (webhook), cobrindo est\u00e1gios como Valida\u00e7\u00e3o Crivo,<br>Averba\u00e7\u00e3o, Integra\u00e7\u00e3o Documental, Desembolso e Encarteiramento<\/p>\n\n\n\n<p>&nbsp;<\/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>Para cada evento consumido, o Worker envia um HTTP POST para o endpoint configurado.<\/p>\n\n\n\n<p>&nbsp;<\/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\">&nbsp;<\/h3>\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>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<p><\/p>\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>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\">&nbsp;<\/h3>\n\n\n\n<h3 class=\"wp-block-heading\"><span style=\"font-size: 2rem;\">7. Exemplos de Webhook por Evento<\/span><\/h3>\n\n\n\n<p><\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><span style=\"font-size: 2rem;\">7.1. Averba\u00e7\u00e3o<\/span><\/h3>\n\n\n\n<p><\/p>\n\n\n\n<p><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;uuid da proposta&gt;&gt;\",\n   \"raw_dataprev_data\": {}\n }\n}\n<\/code><\/pre>\n\n\n\n<p><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;uuid da proposta>>\",\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><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;uuid da proposta&gt;&gt;\",\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><\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><span style=\"font-size: 2rem;\">7.2. Desembolso<\/span><\/h3>\n\n\n\n<p><\/p>\n\n\n\n<p><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;uuid da proposta&gt;&gt;\",\n   \"payment_datetime\": \"2025-05-02T10:10:10-03:00\"\n }\n}<\/code><\/pre>\n\n\n\n<p><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;uuid da proposta&gt;&gt;\",\n   \"code\": \"DISBURSEMENT_ERROR\",\n   \"message\": \"Descri\u00e7\u00e3o da falha\"\n }\n}<\/code><\/pre>\n\n\n\n<p><\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><span style=\"font-size: 2rem;\">7.3. Crivo<\/span><\/h3>\n\n\n\n<p><\/p>\n\n\n\n<p><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;uuid da proposta&gt;&gt;\"\n }\n}<\/code><\/pre>\n\n\n\n<p><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;uuid da proposta&gt;&gt;\",\n   \"message\": \"Descri\u00e7\u00e3o da falha\"\n }\n}<\/code><\/pre>\n\n\n\n<p><\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><span style=\"font-size: 2rem;\">7.4. Integra\u00e7\u00e3o Documental<\/span><\/h3>\n\n\n\n<p><\/p>\n\n\n\n<p><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;uuid da proposta&gt;&gt;\",\n   \"raw_documental_data\": {}\n }\n}<\/code><\/pre>\n\n\n\n<p><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;uuid da proposta&gt;&gt;\",\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><\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><span style=\"font-size: 2rem;\">7.5. Encarteiramento<\/span><\/h3>\n\n\n\n<p><\/p>\n\n\n\n<p><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;uuid da proposta&gt;&gt;\"\n }\n}<\/code><\/pre>\n\n\n\n<p><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;uuid da proposta&gt;&gt;\",\n   \"code\": \"PORTFOLIO_ERROR\",\n   \"message\": \"Descri\u00e7\u00e3o da falha\"\n }\n}<\/code><\/pre>\n\n\n\n<p><\/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><\/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><\/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). &nbsp; 2. Contexto na esteira de aquisi\u00e7\u00e3o O webhook de status \u00e9 acionado durante a esteira de aquisi\u00e7\u00e3o, principalmente nas etapas de STATUS &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<\/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":[55],"doc_tag":[],"class_list":["post-1893","docs","type-docs","status-publish","hentry","doc_category-consignado_inss"],"_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":15,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/1893\/revisions"}],"predecessor-version":[{"id":2020,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/1893\/revisions\/2020"}],"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}]}}