{"id":2434,"date":"2022-04-25T16:08:33","date_gmt":"2022-04-25T19:08:33","guid":{"rendered":"http:\/\/www.l2maker.com.br\/documentacao\/?p=2434"},"modified":"2024-11-07T10:22:36","modified_gmt":"2024-11-07T13:22:36","slug":"trabalhando-com-o-pix-no-itau-341","status":"publish","type":"post","link":"https:\/\/www.l2maker.com.br\/documentacao\/2022\/04\/trabalhando-com-o-pix-no-itau-341\/","title":{"rendered":"Trabalhando com o PIX no Ita\u00fa (341)"},"content":{"rendered":"\n<p>IMPORTANTE: Os passos aqui descritos s\u00e3o mera complementa\u00e7\u00e3o e\/ou resumo da documenta\u00e7\u00e3o oficial do Ita\u00fa. Sigam sempre as instru\u00e7\u00e3o oficiais passadas pelo banco. Nem todas as informa\u00e7\u00f5es aqui contidas podem estar atualizadas (\u00faltima revis\u00e3o 25\/04\/2022).<\/p>\n\n\n\n<p>A inicializa\u00e7\u00e3o do PIX com o Ita\u00fa deve seguir os seguintes passos:<\/p>\n\n\n\n<p>Na inicializa\u00e7\u00e3o utilize a fun\u00e7\u00e3o &#8220;<strong>PIX &#8211; Inicializar<\/strong>&#8221; com os seguintes par\u00e2metros:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Produ\u00e7\u00e3o <\/strong>(L\u00f3gico) &#8211; Usar Falso para acessar o ambiente de homologa\u00e7\u00e3o.<\/li>\n\n\n\n<li><strong>Fornecedor <\/strong>(Letras): Colocar fixo &#8220;<strong>Itau<\/strong>&#8220;;<\/li>\n\n\n\n<li><strong>Par\u00e2metros <\/strong>de inicializa\u00e7\u00e3o (Variante) &#8211; Mapeamento com os seguintes itens (sem as aspas nos nomes):<\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li>&#8220;<strong>client_id<\/strong>&#8221; (Letras) &#8211; Fornecido pelo banco &#8211; Criar em a conta de testes em: <a rel=\"noreferrer noopener\" href=\"https:\/\/devportal.itau.com.br\/baas\/#\/\" target=\"_blank\">https:\/\/devportal.itau.com.br\/baas\/#\/<\/a>;<br>&#8220;<strong>client_secret<\/strong>&#8221; (Letras) &#8211; Fornecido pelo banco;<\/li>\n\n\n\n<li>&#8220;<strong>RECEBEDOR_NOME<\/strong>&#8221; (Letras) &#8211; Nome do recebedor;<\/li>\n\n\n\n<li>&#8220;<strong>RECEBEDOR_CIDADE&#8221; <\/strong>(Letras) &#8211; Nome da cidade do recebedor;<\/li>\n\n\n\n<li>&#8220;<strong>COM_VENCIMENTO<\/strong>&#8221; (L\u00f3gico) &#8211; Indica se o PIX vai ser gerado com data de vencimento futura (colocar true \/ Verdadeiro), ou se \u00e9 para pagamento imediato (falso \/ valor padr\u00e3o);<br><strong>PRODU\u00c7\u00c3O (Adicionar certificado):<\/strong><\/li>\n\n\n\n<li>&#8220;<strong>certificado_caminho<\/strong>&#8221; (Letras) &#8211; Caminho completo do PFX com o e-CNPJ (EX: &#8220;<strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-luminous-vivid-orange-color\">C:\\DADOS\\pasta-acessivel-pelo-webrun\\meu-certificado.pfx<\/mark><\/strong>&#8220;);<\/li>\n\n\n\n<li>&#8220;<strong>certificado_senha<\/strong>&#8221; (Letras) &#8211; Senha do PFX.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">BOLECODE (PIX + Boleto)<\/h3>\n\n\n\n<p>O Ita\u00fa permite a emiss\u00e3o de um boleto vinculado ao PIX, para emitir o PIX com boleto devem ser feitas as seguintes a\u00e7\u00f5es:<\/p>\n\n\n\n<p>No mapa com os dados do PIX deve ser adicionados os seguintes itens:<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">Dados da carteira<\/h5>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong><em>BENEFICIARIO_ID<\/em> <\/strong>(Letras): ID do Benefici\u00e1rio = Ag\u00eancia (4 d\u00edgitos) + Conta (7 d\u00edgitos) + DAC (1 d\u00edgito);<\/li>\n\n\n\n<li><strong><em>CODIGO_CARTEIRA<\/em> <\/strong>(Letras): 3 d\u00edgitos, EX: &#8220;109&#8221;.<\/li>\n<\/ul>\n\n\n\n<h5 class=\"wp-block-heading\">Dados do devedor\/pagador<\/h5>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>DEVEDOR_LOGRADOURO <\/strong>(Letras);<\/li>\n\n\n\n<li><strong><em>DEVEDOR_BAIRRO<\/em> <\/strong>(Letras);<\/li>\n\n\n\n<li><strong><em>DEVEDOR_CIDADE<\/em> <\/strong>(Letras);<\/li>\n\n\n\n<li><strong><em>DEVEDOR_UF<\/em> <\/strong>(Letras);<\/li>\n\n\n\n<li><strong><em>DEVEDOR_CEP<\/em> <\/strong>(Letras): 08 d\u00edgitos, somente n\u00fameros;<\/li>\n\n\n\n<li><strong><em>DEVEDOR_ENDERECO_COMPLEMENTO<\/em> <\/strong>(Letras);<\/li>\n\n\n\n<li><strong><em>DEVEDOR_ENDERECO_NUMERO<\/em> <\/strong>(Letras);<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Dados do boleto<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><em><strong>NOSSO_NUMERO<\/strong><\/em> (Letras) &#8211; Importante, incrementar a cada envio, n\u00e3o permite n\u00famero duplicado (C\u00f3digo: 422, Erro: &#8220;Cobranca Hibrida com id de boleto ou txid ja existente na base de dados.&#8221;);<\/li>\n\n\n\n<li><strong><em>DATA_EMISSAO<\/em> <\/strong>(Data);<\/li>\n\n\n\n<li><strong><em>TEXTO_USO_BENEFICIARIO<\/em> <\/strong>(Letras);<\/li>\n\n\n\n<li><strong><em>TEXTO_SEU_NUMERO<\/em> <\/strong>(Letras);<\/li>\n\n\n\n<li><strong><em>MENSAGEM_COBRANCA<\/em> <\/strong>(Letras);<\/li>\n\n\n\n<li><strong><em>CODIGO_ESPECIE<\/em> <\/strong>(Letras): Dois d\u00edgitos conforme tabela do banco:<br>01 &#8211; DM &#8211; Duplicata de Venda Mercantil 02 &#8211; NP &#8211; Nota Promiss\u00f3ria 03 &#8211; NS &#8211; Nota de Seguro 04 &#8211; ME &#8211; Mensalidade Escolar 05 &#8211; RC &#8211; Recibo 06 &#8211; CT &#8211; Contrato 08 &#8211; DS &#8211; Duplicata de Presta\u00e7\u00e3o de Servi\u00e7os Original 09 &#8211; LC &#8211; Letra de C\u00e2mbio 15 &#8211; DD &#8211; Documento de D\u00edvida 16 &#8211; EC &#8211; Encargos Condominais 17 &#8211; FS &#8211; Fatura de Servi\u00e7o 18 &#8211; BDP &#8211; Boleto Proposta 88 &#8211; CBI &#8211; C\u00e9dula de Cr\u00e9dito Banc\u00e1rio por Indica\u00e7\u00e3o 89 &#8211; CC &#8211; Contrato de C\u00e2mbio 90 &#8211; CCB &#8211; C\u00e9dula de Cr\u00e9dito Banc\u00e1rio 91 &#8211; CD &#8211; Confiss\u00e3o de D\u00edvida 92 &#8211; CH &#8211; Cheque 93 &#8211; CM &#8211; Contrato de M\u00fatuo 94 &#8211; CPS &#8211; Conta de Presta\u00e7\u00e3o de Servi\u00e7os 95 &#8211; DMI &#8211; Duplicata de Venda Mercantil por Indica\u00e7\u00e3o 96 &#8211; DSI &#8211; Duplicata de Presta\u00e7\u00e3o de Servi\u00e7os &#8211; Original Por Indica\u00e7\u00e3o 97 &#8211; RA &#8211; Recibo de Aluguel (PJ) 98 &#8211; TA &#8211; Termo de acordo 99 &#8211; DV &#8211; Diversos;<\/li>\n<\/ul>\n\n\n\n<h5 class=\"wp-block-heading\">Juros\/Multas\/Descontos<\/h5>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>DESCONTO_VALOR <\/strong>(Num\u00e9rico): Decimal com 2 casas;<\/li>\n\n\n\n<li><strong>DESCONTO_DATA<\/strong> (Data): Data limite para concess\u00e3o do desconto;<\/li>\n\n\n\n<li><strong>MULTA_VALOR <\/strong>(Num\u00e9rico): Valor com duas casas decimais informar somente valor (MULTA_VALOR) ou percentual (<em>MULTA_PERC<\/em> );<\/li>\n\n\n\n<li><strong><em>MULTA_PERC<\/em> <\/strong>(Num\u00e9rico): N\u00famero com duas casas decimais, para 7,35% informar 7,35;<\/li>\n\n\n\n<li><strong>JUROS_VALOR_DIARIO <\/strong>(Num\u00e9rico): Informa o valor di\u00e1rio de multa por atraso com um valor fixo;<\/li>\n\n\n\n<li><strong>JUROS_PERC_MENSAL <\/strong>(Num\u00e9rico): Informa o valor mensal de multa, calculado com percentual do valor do boleto (usar somente um dos dois &#8216;JUROS_VALOR_DIARIO&#8217; ou &#8216;JUROS_PERC_MENSAL&#8217;).<\/li>\n<\/ul>\n\n\n\n<h5 class=\"wp-block-heading\">Outros<\/h5>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong><em>SIMULACAO<\/em> <\/strong>(L\u00f3gico): Valor opcional, indica se a opera\u00e7\u00e3o deve ser feito apenas de forma simulada (sem gerar boleto \/ pix), por padr\u00e3o \u00e9 Falso, ou seja, gera o PIX e boleto se n\u00e3o for informado.<\/li>\n<\/ul>\n\n\n\n<p>Na chamada da fun\u00e7\u00e3o &#8220;<strong>PIX &#8211; Criar Cobran\u00e7a<\/strong>&#8221; deve ser informado a constante &#8220;<strong>BOLECODE<\/strong>&#8221; no txid (segundo par\u00e2metro). Se passado um mapeamento a fun\u00e7\u00e3o ir\u00e1 gerar o JSON internamente, caso seja passado o texto em JSON (Letras), o mesmo ser\u00e1 enviado, sem altera\u00e7\u00f5es.<\/p>\n\n\n\n<p>OBS: A op\u00e7\u00e3o de montar o JSON a partir do mapeamento \u00e9 limitada, JSON mais complexos, ou com regras menos usuais dever\u00e3o ser montados e convertidos em JSON fora da API (fun\u00e7\u00f5es nativas do Maker ou banco).<\/p>\n\n\n\n<p>No mapa retornado, al\u00e9m do JSON completo ser\u00e3o retornados os seguintes itens:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>BOLETO_CODIGO_BARRAS <\/strong>(Letras);<\/li>\n\n\n\n<li><strong>BOLETO_LINHA_DIGITAVEL <\/strong>(Letras);<\/li>\n\n\n\n<li><strong>BOLETO_DATA_VENCIMENTO <\/strong>(Data).<\/li>\n<\/ul>\n\n\n\n<p>OBS: Para gerar o PDF voc\u00ea pode usar a API de Boleto.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>IMPORTANTE: Os passos aqui descritos s\u00e3o mera complementa\u00e7\u00e3o e\/ou resumo da documenta\u00e7\u00e3o oficial do Ita\u00fa. Sigam sempre as instru\u00e7\u00e3o oficiais passadas pelo banco. Nem todas as informa\u00e7\u00f5es aqui contidas podem estar atualizadas (\u00faltima revis\u00e3o 25\/04\/2022). A inicializa\u00e7\u00e3o do PIX com o Ita\u00fa deve seguir os seguintes passos: Na inicializa\u00e7\u00e3o utilize a fun\u00e7\u00e3o &#8220;PIX &#8211; Inicializar&#8221; [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[246],"tags":[],"class_list":["post-2434","post","type-post","status-publish","format-standard","hentry","category-api-pix-maker-documentacao"],"_links":{"self":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/2434","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/comments?post=2434"}],"version-history":[{"count":34,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/2434\/revisions"}],"predecessor-version":[{"id":3752,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/2434\/revisions\/3752"}],"wp:attachment":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/media?parent=2434"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/categories?post=2434"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/tags?post=2434"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}