{"id":2042,"date":"2026-05-07T08:22:06","date_gmt":"2026-05-07T11:22:06","guid":{"rendered":"https:\/\/www.bancosemear.com.br\/docs\/?post_type=docs&#038;p=2042"},"modified":"2026-05-07T08:22:06","modified_gmt":"2026-05-07T11:22:06","slug":"webhook-de-status-da-proposta-port-refin","status":"publish","type":"docs","link":"https:\/\/www.bancosemear.com.br\/docs\/?docs=webhook-de-status-da-proposta-port-refin","title":{"rendered":"Webhook de Status da Proposta \u2013 PORT + REFIN"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\" id=\"1-viso-geral\">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<h2 class=\"wp-block-heading\" id=\"2-contexto-na-esteira-de-aquisio\">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<h2 class=\"wp-block-heading\" id=\"3-contrato-do-webhook-enviado-ao-cliente-sada-http\">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<h2 class=\"wp-block-heading\" id=\"4-mtodo-e-headers\">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\" id=\"4-toc-title\">&nbsp;<\/h3>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"5-autenticao-e-autorizao-envio-do-webhook\">5. Autentica\u00e7\u00e3o e autoriza\u00e7\u00e3o (envio do webhook)<\/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<h3 class=\"wp-block-heading\" id=\"6-respostas-esperadas-e-tratamento-de-erros\">6. Respostas esperadas e tratamento de erros<\/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\" id=\"7-toc-title\">&nbsp;<\/h3>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"7-exemplos-de-webhook-por-evento\">7. Exemplos de Webhook por Evento<\/h3>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"71-averbao\">7.1. Averba\u00e7\u00e3o<\/h3>\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 \"operation_type\": portability or refinancing\n \"data\": {\n   \"id\": \"&lt;&lt;uuid da proposta>>\",\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 \"operation_type\": portability or refinancing\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 \"operation_type\": portability or refinancing\n \"data\": {\n   \"id\": \"&lt;&lt;uuid da proposta>>\",\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<h3 class=\"wp-block-heading\" id=\"72-desembolso\">7.2. Desembolso<\/h3>\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 \"operation_type\": portability or refinancing\n \"data\": {\n   \"id\": \"&lt;&lt;uuid da proposta>>\",\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 \"operation_type\": portability or refinancing\n \"data\": {\n   \"id\": \"&lt;&lt;uuid da proposta>>\",\n   \"code\": \"DISBURSEMENT_ERROR\",\n   \"message\": \"Descri\u00e7\u00e3o da falha\"\n }\n}<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"73-crivo\">7.3. Elegibilidade<\/h3>\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 \"operation_type\": portability or refinancing\n \"data\": {\n   \"id\": \"&lt;&lt;uuid da proposta>>\"\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.eligibility\",\n  \"success\": false,\n  \"retry\": true\n  \"operation_type\": portability or refinancing\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.eligibility\",\n \"success\": false,\n \"operation_type\": portability or refinancing\n \"data\": {\n   \"id\": \"&lt;&lt;uuid da proposta>>\",\n   \"message\": \"Descri\u00e7\u00e3o da falha\"\n }\n}<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"74-integrao-documental\">7.4. Integra\u00e7\u00e3o Documental<\/h3>\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 \"operation_type\": portability or refinancing\n \"data\": {\n \"id\": \"&lt;&lt;uuid da proposta>>\",\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 \"operation_type\": portability or refinancing\n \"data\": {\n   \"id\": \"&lt;&lt;uuid da proposta>>\",\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<h3 class=\"wp-block-heading\" id=\"75-encarteiramento\">7.5. Encarteiramento<\/h3>\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 \"operation_type\": portability or refinancing\n \"data\": {\n   \"id\": \"&lt;&lt;uuid da proposta>>\"\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 \"operation_type\": portability or refinancing\n \"data\": {\n   \"id\": \"&lt;&lt;uuid da proposta>>\",\n   \"code\": \"PORTFOLIO_ERROR\",\n   \"message\": \"Descri\u00e7\u00e3o da falha\"\n }\n}<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"76-confirmao-de-anuncia\">7.6. Confirma\u00e7\u00e3o de Anu\u00eancia<\/h3>\n\n\n\n<p><strong>Sucesso<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{ \n  \"webhook_type\": \"worker_credit.consent\", \n  \"success\": true,\n  \"operation_type\": refinancing\n  \"data\": {\n    \"id\": \"&lt;&lt;uuid da proposta>>\",\n    \"raw_dataprev_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. consent \",\n \"success\": false,\n \"operation_type\": refinancing\n \"data\": {\n   \"id\": \"&lt;&lt;uuid da proposta>>\",\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<h3 class=\"wp-block-heading\" id=\"8-observaes-importantes\">7.7. Solicita\u00e7\u00e3o de Portabilidade CTC<\/h3>\n\n\n\n<p><strong>Sucesso<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"webhook_type\": \"worker_credit.transfer\",\n  \"success\": true,\n  \"operation_type\": portability\n  \"data\": {\n    \"id\": \"&lt;&lt;uuid da proposta>>\"\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.transfer\",\n  \"success\": false,\n  \"operation_type\": portability\n  \"data\": {\n    \"id\": \"&lt;&lt;uuid da proposta>>\",\n    \"code\": \"TRANSFER_ERROR\",\n    \"message\": \"Descri\u00e7\u00e3o da falha\"\n  }\n<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"8-observaes-importantes\">8. Observa\u00e7\u00f5es Importantes<\/h3>\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","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 durante a esteira de aquisi\u00e7\u00e3o, principalmente nas etapas de STATUS (webhook), &hellip;<\/p>\n<p class=\"read-more\"> <a class=\"\" href=\"https:\/\/www.bancosemear.com.br\/docs\/?docs=webhook-de-status-da-proposta-port-refin\"> <span class=\"screen-reader-text\">Webhook de Status da Proposta \u2013 PORT + REFIN<\/span> Leia mais &raquo;<\/a><\/p>\n","protected":false},"author":26,"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-2042","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\/2042","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\/26"}],"replies":[{"embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=2042"}],"version-history":[{"count":1,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/2042\/revisions"}],"predecessor-version":[{"id":2043,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/2042\/revisions\/2043"}],"wp:attachment":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=2042"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_category&post=2042"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_tag&post=2042"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}