{"id":727,"date":"2023-11-01T09:16:51","date_gmt":"2023-11-01T12:16:51","guid":{"rendered":"https:\/\/www.bancosemear.com.br\/docs\/?post_type=docs&#038;p=727"},"modified":"2024-11-21T09:08:57","modified_gmt":"2024-11-21T12:08:57","slug":"cadastrar-agentes-de-saque","status":"publish","type":"docs","link":"https:\/\/www.bancosemear.com.br\/docs\/?docs=cadastrar-agentes-de-saque","title":{"rendered":"Cadastrar Agentes de Saque"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\" id=\"0-toc-title\">Descri\u00e7\u00e3o<\/h2>\n\n\n\n<p>Este passo tem por finalidade criar um agente de saque.<\/p>\n\n\n\n<p><strong>Nota: <\/strong>Ao efetuar um novo cadastro, as informa\u00e7\u00f5es ir\u00e3o passar por uma analise interna para validar alguns dados e posteriormente ser\u00e3o liberadas para consulta e disponibilizadas para o bacen.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"1-toc-title\">Endpoints<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Produ\u00e7\u00e3o:<\/strong>\u00a0<a href=\"https:\/\/hmlapi2.bancosemear.com.br\/paas-withdrawal-agents-api\/api\/v1\/public\/withdrawl\">https:\/\/api2.bancosemear.com.br\/paas-withdrawal-agents-api\/api\/v1\/public\/withdrawl<\/a><\/li>\n\n\n\n<li><strong>Homologa\u00e7\u00e3o:<\/strong>\u00a0<a href=\"https:\/\/hmlapi2.bancosemear.com.br\/paas-withdrawal-agents-api\/api\/v1\/public\/withdrawl\">https:\/\/hmlapi2.bancosemear.com.br\/paas-withdrawal-agents-api\/api\/v1\/public\/withdrawl<\/a><\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"2-toc-title\">Requisi\u00e7\u00e3o (POST)<\/h3>\n\n\n\n<p>Segue exemplo de requisi\u00e7\u00e3o:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>curl \"https:\/\/hmlapi2.bancosemear.com.br\/paas-withdrawal-agents-api\/api\/v1\/public\/withdrawl\" \\\n    --request POST \\\n    --header \"Content-Type: application\/json\" \\\n    --header \"client_id: &lt;CLIENT_ID>\" \\\n    --header \"access_token: &lt;ACCESS_TOKEN>\" \\\n    --data '\n{\n  \"documento\": \"xxxxxxxxxxx\",\n  \"registro\": {\n    \"nome_agente_saque\": \"Comercial PAY\",\n    \"cnpj_agente_saque\": \"37233282000187\",\n    \"pontos_atendimento\": &#91;\n        {\n            \"nome\": \"Mercado 4\",\n            \"nome_original\": \"super nosso LTDA\",\n            \"latitude\": \"40.7128\",\n            \"longitude\": \"-74.0060\",\n            \"logradouro\": \"Rua Tagipuru\",\n            \"bairro\": \"Barra Funda\",\n            \"cidade\": \"S\u00e3o Paulo\",\n            \"estado\": \"SP\",\n            \"cep\": \"01156000\",\n            \"produtos\": {\n                \"Pix-saque\": true,\n                \"Pix-troco\": false\n            },\n            \"horarios_funcionamento\": &#91;\n                {\n                    \"dia\": \"SEGUNDA_FEIRA\",\n                    \"horario\": {\n                        \"abertura_saque\": \"09:00:00\",\n                        \"fechamento_saque\": \"18:00:00\"\n                    },\n                    \"valor_maximo_disponivel\": \"1000.00\"\n                },\n                {\n                    \"dia\": \"TERCA_FEIRA\",\n                    \"horario\": {\n                        \"abertura_saque\": \"09:00:00\",\n                        \"fechamento_saque\": \"18:00:00\"\n                    },\n                    \"valor_maximo_disponivel\": \"1000.00\"\n                },\n                {\n                    \"dia\": \"QUARTA_FEIRA\",\n                    \"horario\": {\n                        \"abertura_saque\": \"09:00:00\",\n                        \"fechamento_saque\": \"18:00:00\"\n                    },\n                    \"valor_maximo_disponivel\": \"1000.00\"\n                },\n                {\n                    \"dia\": \"QUINTA_FEIRA\",\n                    \"horario\": {\n                        \"abertura_saque\": \"09:00:00\",\n                        \"fechamento_saque\": \"18:00:00\"\n                    },\n                    \"valor_maximo_disponivel\": \"1000.00\"\n                },\n                {\n                    \"dia\": \"SEXTA_FEIRA\",\n                    \"horario\": {\n                        \"abertura_saque\": \"09:00:00\",\n                        \"fechamento_saque\": \"18:00:00\"\n                    },\n                    \"valor_maximo_disponivel\": \"1000.00\"\n                },\n                {\n                    \"dia\": \"SABADO\",\n                    \"horario\": {\n                        \"abertura_saque\": \"09:00:00\",\n                        \"fechamento_saque\": \"18:00:00\"\n                    },\n                    \"valor_maximo_disponivel\": \"1000.00\"\n                },\n                {\n                    \"dia\": \"DOMINGO\",\n                    \"horario\": {\n                        \"abertura_saque\": \"09:00:00\",\n                        \"fechamento_saque\": \"18:00:00\"\n                    },\n                    \"valor_maximo_disponivel\": \"1000.00\"\n                }\n            ],\n            \"observacoes\": \"Campo livre\"\n        }\n    ]\n  }\n}'<\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"3-toc-title\">Par\u00e2metros de Requisi\u00e7\u00e3o<\/h4>\n\n\n\n<h5 class=\"wp-block-heading\" id=\"4-toc-title\">Cabe\u00e7alho<\/h5>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Content-Type:<\/strong>&nbsp;Informa ao servidor de que o corpo da requisi\u00e7\u00e3o possui o formato JSON<\/li>\n\n\n\n<li><strong>client_id:<\/strong>&nbsp;ID de cliente usado para encaminhar a requisi\u00e7\u00e3o ao gateway de APIs<\/li>\n\n\n\n<li><strong>access_token:<\/strong>&nbsp;Token recebido ap\u00f3s executar o m\u00e9todo&nbsp;<a href=\"https:\/\/www.bancosemear.com.br\/docs\/?docs=autenticacao-oauth\" target=\"_blank\" rel=\"noreferrer noopener\">oAuth (Access Token)<\/a><\/li>\n<\/ul>\n\n\n\n<h5 class=\"wp-block-heading\" id=\"5-toc-title\">Corpo (JSON)<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Propriedade<\/th><th>Descri\u00e7\u00e3o<\/th><th>Tipo<\/th><th>Obrigatoriedade<\/th><\/tr><\/thead><tbody><tr><td><strong>documento<\/strong><\/td><td>&nbsp;Cnpj do agente de saque ou do participante que, diretamente, facilite o servi\u00e7o de saque. Com 14 d\u00edgitos, sem m\u00e1scara.<\/td><td>&nbsp;String<\/td><td>&nbsp;Obrigat\u00f3rio<\/td><\/tr><tr><td><strong>registro<\/strong><\/td><td>Lista de informa\u00e7\u00f5es relativas aos pontos de atendimento dos agentes de saque ou do participante que, diretamente, preste o servi\u00e7o de saque.<\/td><td>List<\/td><td>Obrigat\u00f3rio<\/td><\/tr><tr><td><strong>registro.nome_agente_saque<\/strong><\/td><td>&nbsp;Nome do agente de saque ou do participante que, diretamente, facilite o servi\u00e7o de saque.<\/td><td>&nbsp;String<\/td><td>&nbsp;Obrigat\u00f3rio<\/td><\/tr><tr><td><strong>registro.cnpj_agente_saque<\/strong><\/td><td>&nbsp;Cnpj do agente de saque ou do participante que, diretamente, facilite o servi\u00e7o de saque. Com 14 d\u00edgitos, sem m\u00e1scara.<\/td><td>&nbsp;String&nbsp;<\/td><td>&nbsp;Obrigat\u00f3rio<\/td><\/tr><tr><td><strong>registro.pontos_atendimento<\/strong><\/td><td>Lista de todos os pontos de atendimento de um agente de saque ou do participante que, diretamente, facilite o servi\u00e7o de saque.<\/td><td>List<\/td><td>Obrigat\u00f3rio<\/td><\/tr><tr><td><strong>registro.pontos_atendimento.nome<\/strong><\/td><td>&nbsp;Nome do ponto de atendimento. Este nome tem como fun\u00e7\u00e3o detalhar cada ponto de atendimento de um agente de saque ou do participante que, diretamente, venha a facilitar o servi\u00e7o de saque.<br>Este ser\u00e1 considerado para aparecer na lista de pontos de saque ao cliente final (max. 50 caracteres)<\/td><td>&nbsp;String<\/td><td>&nbsp;Obrigat\u00f3rio<\/td><\/tr><tr><td><strong>&nbsp;registro.pontos_atendimento.nome_original<\/strong><\/td><td>&nbsp;&nbsp;Nome do ponto de atendimento. Este nome tem como fun\u00e7\u00e3o detalhar cada ponto de atendimento de um agente de saque ou do participante que, diretamente, venha a facilitar o servi\u00e7o de saque. (max. 100 caracteres)<\/td><td>&nbsp;String<\/td><td>&nbsp;Obrigat\u00f3rio<\/td><\/tr><tr><td><strong>&nbsp;registro.pontos_atendimento.latitude<\/strong><\/td><td>&nbsp;Latitude da posi\u00e7\u00e3o geogr\u00e1fica. A faixa de valores v\u00e1lida \u00e9 de -90 a 90, sendo que devem ser utilizadas pelo menos 5 casas decimais.<\/td><td>&nbsp;String<\/td><td>&nbsp;Obrigat\u00f3rio<\/td><\/tr><tr><td><strong>&nbsp;registro.pontos_atendimento.longetude<\/strong><\/td><td>&nbsp;Longitude da posi\u00e7\u00e3o geogr\u00e1fica. A faixa de valores v\u00e1lida \u00e9 de -180 a 180, sendo que devem ser utilizadas pelo menos 5 casas decimais.<\/td><td>&nbsp;String<\/td><td>&nbsp;Obrigat\u00f3rio<\/td><\/tr><tr><td><strong>registro.pontos_atendimento.logradouro<\/strong><\/td><td>Logradouro do ponto de atendimento. (max. 100 caracteres)<\/td><td>&nbsp;String<\/td><td>&nbsp;Obrigat\u00f3rio<\/td><\/tr><tr><td><strong>registro.pontos_atendimento.bairro<\/strong><\/td><td>Bairro do ponto de atendimento. (max. 40 caracteres)<\/td><td>&nbsp;String<\/td><td>&nbsp;Obrigat\u00f3rio<\/td><\/tr><tr><td><strong>registro.pontos_atendimento.cidade<\/strong><\/td><td>Cidade do ponto de atendimento. (max. 40 caracteres)<\/td><td>String<\/td><td>Obrigat\u00f3rio<\/td><\/tr><tr><td><strong>registro.pontos_atendimento.estado<\/strong><\/td><td>Estado do ponto de atendimento. (max. 2 caracteres, ex. &#8220;AC&#8221;)<\/td><td>String<\/td><td>Obrigat\u00f3rio<\/td><\/tr><tr><td><strong>registro.pontos_atendimento.cep<\/strong><\/td><td>CEP do ponto de atendimento. Devem ser informados apenas os 8 n\u00fameros sem qualquer m\u00e1scara.<\/td><td>String<\/td><td>Obrigat\u00f3rio<\/td><\/tr><tr><td><strong>registro.pontos_atendimento.produtos<\/strong><\/td><td>Indica\u00e7\u00e3o sobre quais produtos este ponto de atendimento disponibiliza.<\/td><td>String<\/td><td>Obrigat\u00f3rio<\/td><\/tr><tr><td><strong>registro.pontos_atendimento.produtos.Pix-saque<\/strong><\/td><td>Indica\u00e7\u00e3o se o ponto de atendimento disponibiliza Pix Saque.<\/td><td>Boolean<\/td><td>Obrigat\u00f3rio<\/td><\/tr><tr><td><strong>registro.pontos_atendimento.produtos.Pix-troco<\/strong><\/td><td>Indica\u00e7\u00e3o se o ponto de atendimento disponibiliza Pix Troco.<\/td><td>Boolean<\/td><td>Obrigat\u00f3rio<\/td><\/tr><tr><td><strong>registro.pontos_atendimento.horarios_funcionamento<\/strong><\/td><td>Lista com os hor\u00e1rios em que o Pix Saque ou Pix Troco estar\u00e1 dispon\u00edvel. Caso algum dia da semana n\u00e3o seja informado isto significa que os produtos n\u00e3o estar\u00e3o dispon\u00edveis naquele dia.<\/td><td>List<\/td><td>Obrigat\u00f3rio<\/td><\/tr><tr><td><strong>registro.pontos_atendimento.horarios_funcionamento.dia<\/strong><\/td><td>Dia da semana.<\/td><td>String<\/td><td>Obrigat\u00f3rio<\/td><\/tr><tr><td><strong>registro.pontos_atendimento.horarios_funcionamento.horario.abertura_saque<\/strong><\/td><td>Hora de abertura para disponibiliza\u00e7\u00e3o dos produtos no ponto de atendimento.<\/td><td>String<\/td><td>Obrigat\u00f3rio<\/td><\/tr><tr><td><strong>registro.pontos_atendimento.horarios_funcionamento.horario.fechamento_saque<\/strong><\/td><td>Hora de fechamento para disponibiliza\u00e7\u00e3o dos produtos no ponto de atendimento.<\/td><td>String<\/td><td>Obrigat\u00f3rio<\/td><\/tr><tr><td><strong>registro.pontos_atendimento.horarios_funcionamento.valor_maximo_disponivel<\/strong><\/td><td>Valor m\u00e1ximo dispon\u00edvel por saque\/troco<\/td><td>String<\/td><td>Obrigat\u00f3rio<\/td><\/tr><tr><td><strong>registro.pontos_atendimento.observacoes<\/strong><\/td><td>Observa\u00e7\u00f5es gerais sobre o ponto de atendimento. (max. 250 caracteres)<\/td><td>String<\/td><td>Opcional<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"6-toc-title\">Resposta<\/h3>\n\n\n\n<p>Segue exemplo de resposta:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"nome_agente_saque\": \"Comercial\",\n    \"cnpj_agente_saque\": \"37233282000187\",\n    \"pontos_atendimento\": &#91;\n        {\n            \"nome\": \"Mercado 4\",\n            \"nome_original\": \"super nosso LTDA\",\n            \"latitude\": \"40.7128\",\n            \"longitude\": \"-74.0060\",\n            \"logradouro\": \"Rua Tagipuru\",\n            \"bairro\": \"Barra Funda\",\n            \"cidade\": \"S\u00e3o Paulo\",\n            \"estado\": \"SP\",\n            \"cep\": \"01156000\",\n            \"produtos\": {\n                \"Pix-saque\": true,\n                \"Pix-Troco\": false\n            },\n            \"horarios_funcionamento\": &#91;\n                {\n                    \"dia\": \"SEGUNDA_FEIRA\",\n                    \"horario\": {\n                        \"abertura_saque\": \"09:00:00\",\n                        \"fechamento_saque\": \"18:00:00\"\n                    },\n                    \"valor_maximo_disponivel\": \"1000.00\"\n                },\n                {\n                    \"dia\": \"TERCA_FEIRA\",\n                    \"horario\": {\n                        \"abertura_saque\": \"09:00:00\",\n                        \"fechamento_saque\": \"18:00:00\"\n                    },\n                    \"valor_maximo_disponivel\": \"1000.00\"\n                },\n                {\n                    \"dia\": \"QUARTA_FEIRA\",\n                    \"horario\": {\n                        \"abertura_saque\": \"09:00:00\",\n                        \"fechamento_saque\": \"18:00:00\"\n                    },\n                    \"valor_maximo_disponivel\": \"1000.00\"\n                },\n                {\n                    \"dia\": \"QUINTA_FEIRA\",\n                    \"horario\": {\n                        \"abertura_saque\": \"09:00:00\",\n                        \"fechamento_saque\": \"18:00:00\"\n                    },\n                    \"valor_maximo_disponivel\": \"1000.00\"\n                },\n                {\n                    \"dia\": \"SEXTA_FEIRA\",\n                    \"horario\": {\n                        \"abertura_saque\": \"09:00:00\",\n                        \"fechamento_saque\": \"18:00:00\"\n                    },\n                    \"valor_maximo_disponivel\": \"1000.00\"\n                },\n                {\n                    \"dia\": \"SABADO\",\n                    \"horario\": {\n                        \"abertura_saque\": \"09:00:00\",\n                        \"fechamento_saque\": \"18:00:00\"\n                    },\n                    \"valor_maximo_disponivel\": \"1000.00\"\n                },\n                {\n                    \"dia\": \"DOMINGO\",\n                    \"horario\": {\n                        \"abertura_saque\": \"09:00:00\",\n                        \"fechamento_saque\": \"18:00:00\"\n                    },\n                    \"valor_maximo_disponivel\": \"1000.00\"\n                }\n            ],\n            \"observacoes\": \"Campo livre\"\n        }\n    ]\n}<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"<p>Descri\u00e7\u00e3o Este passo tem por finalidade criar um agente de saque. Nota: Ao efetuar um novo cadastro, as informa\u00e7\u00f5es ir\u00e3o passar por uma analise interna para validar alguns dados e posteriormente ser\u00e3o liberadas para consulta e disponibilizadas para o bacen. Endpoints Requisi\u00e7\u00e3o (POST) Segue exemplo de requisi\u00e7\u00e3o: Par\u00e2metros de Requisi\u00e7\u00e3o Cabe\u00e7alho Corpo (JSON) Propriedade Descri\u00e7\u00e3o &hellip;<\/p>\n<p class=\"read-more\"> <a class=\"\" href=\"https:\/\/www.bancosemear.com.br\/docs\/?docs=cadastrar-agentes-de-saque\"> <span class=\"screen-reader-text\">Cadastrar Agentes de Saque<\/span> Leia mais &raquo;<\/a><\/p>\n","protected":false},"author":8,"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":[2],"doc_tag":[],"class_list":["post-727","docs","type-docs","status-publish","hentry","doc_category-api-pix"],"_links":{"self":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/727","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\/8"}],"replies":[{"embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=727"}],"version-history":[{"count":7,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/727\/revisions"}],"predecessor-version":[{"id":1584,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/727\/revisions\/1584"}],"wp:attachment":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=727"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_category&post=727"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_tag&post=727"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}