Blog

Trabalhando com o PIX no Itaú (341)

IMPORTANTE: Os passos aqui descritos são mera complementanção e/ou resumo da documentação oficial do Itaú. Sigam sempre as instrução oficiais passadas pelo banco. Nem todas as informações aqui contidas podem estar atualizadas (última revisão 25/04/2022).

A inicialização do PIX com o Itaú deve seguir os seguintes passos:

Na inicialização utilize a função “PIX – Inicializar” com os seguintes parâmetros:

  1. Produção (Lógico) – Usar Falso para acessar o ambiente de homologação.
  2. Fornecedor (Letras): Colocar fixo “Itau“;
  3. Parâmetros de inicialização (Variante) – Mapeamento com os seguintes itens (sem as aspas nos nomes):
  • client_id” (Letras) – Fornecido pelo banco – Criar em a conta de testes em: https://devportal.itau.com.br/baas/#/;
    client_secret” (Letras) – Fornecido pelo banco;
  • RECEBEDOR_NOME” (Letras) – Nome do recebedor;
  • RECEBEDOR_CIDADE” (Letras) – Nome da cidade do recebedor;
  • COM_VENCIMENTO” (Lógico) – Indica se o PIX vai ser gerado com data de vencimento futura (colocar true / Verdadeiro), ou se é para pagamento imediato (falso / valor padrão).

BOLECODE (PIX + Boleto)

O Itaú permite a emissão de um boleto vinculado ao PIX, para emitir o PIX com boleto devem ser feitas as seguintes ações:

No mapa com os dados do PIX deve ser adicionados os seguintes itens:

Dados da carteira
  • BENEFICIARIO_ID (Letras): ID do Beneficiário = Agência (4 dígitos) + Conta (7 dígitos) + DAC (1 dígito);
  • CODIGO_CARTEIRA (Letras): 3 digitos, EX: “109”.
Dados do devedor/pagador
  • DEVEDOR_LOGRADOURO (Letras);
  • DEVEDOR_BAIRRO (Letras);
  • DEVEDOR_CIDADE (Letras);
  • DEVEDOR_UF (Letras);
  • DEVEDOR_CEP (Letras): 08 dígitos, somente números;
  • DEVEDOR_ENDERECO_COMPLEMENTO (Letras);
  • DEVEDOR_ENDERECO_NUMERO (Letras);

Dados do boleto

  • NOSSO_NUMERO (Letras);
  • DATA_EMISSAO (Data);
  • TEXTO_USO_BENEFICIARIO (Letras);
  • TEXTO_SEU_NUMERO (Letras);
  • MENSAGEM_COBRANCA (Letras);
  • CODIGO_ESPECIE (Letras): Dois dígitos conforme tabela do banco:
    01 – DM – Duplicata de Venda Mercantil 02 – NP – Nota Promissória 03 – NS – Nota de Seguro 04 – ME – Mensalidade Escolar 05 – RC – Recibo 06 – CT – Contrato 08 – DS – Duplicata de Prestação de Serviços Original 09 – LC – Letra de Câmbio 15 – DD – Documento de Dívida 16 – EC – Encargos Condominais 17 – FS – Fatura de Serviço 18 – BDP – Boleto Proposta 88 – CBI – Cédula de Crédito Bancário por Indicação 89 – CC – Contrato de Câmbio 90 – CCB – Cédula de Crédito Bancário 91 – CD – Confissão de Dívida 92 – CH – Cheque 93 – CM – Contrato de Mútuo 94 – CPS – Conta de Prestação de Serviços 95 – DMI – Duplicata de Venda Mercantil por Indicação 96 – DSI – Duplicata de Prestação de Serviços – Original Por Indicação 97 – RA – Recibo de Aluguel (PJ) 98 – TA – Termo de acordo 99 – DV – Diversos;
Juros/Multas/Descontos
  • DESCONTO_VALOR (Numérico): Decimal com 2 casas;
  • DESCONTO_DATA (Data): Data limite para concessão do desconto;
  • MULTA_VALOR (Numérico): Valor com duas casas decimais informar somente valor (MULTA_VALOR) ou percentual (MULTA_PERC );
  • MULTA_PERC (Numérico): Número com duas casas decimais, para 7,35% informar 7,35;
  • JUROS_VALOR_DIARIO (Numérico): Informa o valor diário de multa por atraso com um valor fixo;
  • JUROS_PERC_MENSAL (Numérico): Informa o valor mensal de multa, calculado com percentual do valor do boleto (usar somente um dos dois ‘JUROS_VALOR_DIARIO’ ou ‘JUROS_PERC_MENSAL’).
Outros
  • SIMULACAO (Lógico): Valor opcional, indica se a operação deve ser feito apenas de forma simulada (sem gerar boleto / pix), por padrão é Falso, ou seja, gera o PIX e boleto se não for informado.

Na chamada da função “PIX – Criar Cobrança” deve ser informado a constante “BOLECODE” no txid (segundo parâmetro). Se passado um mapeamento a função irá gerar o JSON internamente, caso seja passado o texto em JSON (Letras), o mesmo será enviado, sem alterações.

OBS: A opção de montar o JSON a partir do mapeamento é limitada, JSON mais complexos, ou com regras menos usuais deverão ser montados e convertidos em JSON fora da API (funções nativas do Maker ou banco).

No mapa retornado, além do JSON completo serão retornados os seguintes itens:

  • BOLETO_CODIGO_BARRAS (Letras);
  • BOLETO_LINHA_DIGITAVEL (Letras);
  • BOLETO_DATA_VENCIMENTO (Data).

PRODUÇÃO:

Se faz necessário adicionar o certificado.

  • certificado_caminho” (Letras) – Caminho completo do PFX com o e-CNPJ (EX: “C:\DADOS\pasta-acessivel-pelo-webrun\meu-certificado.pfx“);
  • certificado_senha” (Letras) – Senha do PFX.

Após homologar/testar em desenvolvimento você poderá pedir os dados de produção.