Linha Microsiga Protheus

Árvore de páginas

Versões comparadas

Versão antiga 28

changes.mady.by.user Rogerio Nagy

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Renato Goes Ito

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Configurações necessárias para o registro de boletos por API do Itaú.

Informações
titleRede interna

Para a comunicação do Protheus com o banco é necessário configurar a segurança de rede, caso necessário, para aceitar a saída da faixa de IP referente ao DNS: 

https://sts.itau.com.br/

https://api.itau.com.br/


02. HABILITAR SERVIÇO - ITAÚ

...

Informações
titleVersões

Caso o ambiente esteja utilizando a primeira versão 1 da API (V1) liberada no NGF, que não utiliza certificado, você pode editar o seu layout e assim atualizar para a nova versão, depois de realizados os pontos acima.

Novas configurações de contas serão realizadas apenas para a nova versão liberada 2 (V2), com certificado.

03. CADASTRO DE BANCO - MATA070

...

Informações
titleImportante

É necessário o cadastro correto do dígito verificador da conta no campo Dv Conta (A6_DVCTA).

Caso o cadastro esteja incorreto na tabela de bancos (SA6), o ajuste deve ser realizado em sua subconta no Cadastro Parâmetros de bancos (tabela SEE) nos campos Age. Oficial (EE_AGEOFI), Cta. Oficial (EE_CTAOFI) e DV Cta.Ofic. (EE_DVCTOFI).

Exemplo de conta que precisa ser adequada : Conta 12345-6

No cadastro do banco, campo Nro Conta (A6_NUMCOM) = 123456 e DV Conta (A6_DVCTA) = vazio, o ajuste em sua sub conta deve ser Cta. Oficial (EE_CTAOFI) = 12345 e DV Cta.Ofic. (EE_DVCTOFI) = 6

...

  • Código da carteira deve ser informado no campo Cód. Carteira (EE_CODCART).
  • Nosso número deve ser parametrizadonos campos Faixa Inicio (EE_FAXINI) , Faixa Fim (EE_FAXFIM) e Faixa atual (EE_FAXATU).
  • Para utilizar as instruções de cobrança, deve ser preenchido o campo Banco Oficial (EE_CODOFI) com '341'.
  • Itaú VERSÃO 1 - Somente será possível enviar instruções de cobrança a partir do preenchimento dos campos na pasta Itaú: campos abaixo: 
    1. Banco Oficial
    2. Cod. Cob. 1 (EE_CODCOB1) → Instrução de cobrança para o boleto
    3. Cód. Cob. 2 (EE_CODCOB2) → Instrução de cobrança para o boleto
    4. Cód. Cob. 3 (EE_CODCOB3)→ Instrução de cobrança para o boleto
    5. Dias Protest (EE_ITAUPRT) → Quantidade de dias de protesto do boleto
    6. Dias Devolu. (EE_ITAUDEV) → Quantidade de dias para devolução do Boleto 
    7. Dias Não Rec (EE_ITAUNAO) → Quantidade de dias para não receber Boleto
    Itaú VERSÃO 2 - Somente será possível enviar instruções de cobrança a partir do preenchimento dos campos abaixo: 
    1. CODOFI) → Não preencher.
    2. Mensagem 1 (EE_FORMEN1) → Instrução de cobrança para o boleto (Formula)
    3. Mensagem 2 (EE_FORMEN2) → Instrução de cobrança para o boleto (Formula)
    4. Mens. Extra 1 (EE_FOREXT1)→ Instrução de cobrança para o boleto (Formula)
    5. Mens. Extra 2 (EE_FOREXT2)→ Não será usado para impressão da instrução. Itaú permite somente 03 mensagens
    6. Dias Protest (EE_DIASPRT) → Quantidade de dias de protesto do boleto
    7. Dias Recebim (EE_DIASREC) → Quantidade de dias para devolução do Boleto 

...

Aviso
titleATENÇÃO

Para funcionamento da comunicação bancária por API do Itaú o usuário deve configurar os parâmetros de banco

Os campos de fórmula EE_FORXXX devem conter expressões ADVPL válidas para evitar possíveis desconformidades ou interrupções inesperadas no processo.

05. LAYOUT - FINA710 - NOVO GESTOR FINANCEIRO

Ao iniciar a configuração de layout para uma nova conta do Itaú serão apresentados os passos:

01.

...

SELEÇÃO DA CONTA

Selecione a conta que deseja realizar a configuração

02.

...

INSERÇÃO DE CREDENCIAIS

Nesse passo serão inseridas as informações obtidas junto ao banco no processo de habilitar o serviço em sua conta.

...

Informe o nome do Arquivo chave do certificado (KEY) e Arquivo de certificado convertidos pelo Wizard de conversão de certificado - CFGX060(CRT).

03.

...

CONFIGURAÇÃO DE LAYOUT

Nesse passo, serão configuradas todas as informações que serão encaminhadas para o banco na transmissão do boleto.

04.

...

AMBIENTE DE HOMOLOGAÇÃO

Quando em ambiente de homologação, o banco não retorna as informações de linha digitável e código de barras.

06. CONFIGURAÇÃO DE LAYOUT

Para utilizar o registro online de boletos para o Itaú Versão 2, deve-se observar a seguinte regra:

  • Porc Juros Mensal: Neste campo, deve ser informado o percentual mensal de juros.

     Como padrão, disponibilizamos o campo E1_PORCJUR já multiplicado por 30, respeitando a seguinte regra: juros diário X 30 dias = juros mensal

                 Image Added

  • Número do documento: Neste campo deverá ser informado qual será o número do documento que será transmitido ao banco e posteriormente impresso no boleto.

      Onde poderá ser:

    1. Número do Título (E1_NUM)
    2. ID CNAB (E1_IDCNAB)
    3. Expressão definida pelo usuário.
      • O resultado da expressão será atribuído ao campo “Número do documento”. Para as macro-execuções a expressão a ser executada deverá ser válida. Para informar uma expressão clique na “Engrenagem” que está ao lado do campo.


Image Added

Image Added

                                                                                                                                                                                       


  • Aceite: Este campo indica o reconhecimento formal da divida (assinatura no documento) pelo pagador, deverá ser informado os valores:
    • Sim - Quando existe a necessidade do pagador reconhecer/aceitar a cobrança.
    • Não - Quando não existe a necessidade de reconhecimento da cobrança.

Image Added

  • Beneficiário Filial: Neste campo deverá ser informado qual filial que será utilizada para a transmissão e impressão do boleto. 

Image Added

Os dados cadastrados nessa filial serão utilizados na transmissão e na impressão:

Image Added


Aviso
titleAtenção

Caso este campo não esteja preenchido a Filial Atual (Filial Logado ou Filial configurada no agendamento) será utilizada no dados da transmissão e impressão do boleto.


  • Abatimento: Neste campo poderá ou não ser informado um valor de abatimento para o boleto.  

       Onde poderá ser:

    1. Vazio - Caso o valor original já esteja calculado com a dedução dos valores de abatimento ou não exista abatimento para o boleto.
    2. Valor Abatimento (SomaAbat()) - Calculo padrão do sistema conforme a expressão: "SomaAbat(SE1->E1_PREFIXO,SE1->E1_NUM,SE1->E1_PARCELA,"R",SE1->E1_MOEDA,dDataBase,SE1->E1_CLIENTE,SE1->E1_LOJA)" .
    3. Expressão definida pelo usuário.
      • O resultado da expressão será atribuído ao campo “Abatimento”. Para as macros-execuções a expressão a ser executada deverá ser válida. Para informar uma expressão clique na “Engrenagem” que está ao lado do campo.


Image Added


É possível informar o valor original já deduzindo o valor do abatimento. Basta clicar na engrenagem no campo "Valor Original" e informar uma expressão válida:

Exemplo:

    • "SE1->E1_SALDO - SomaAbat(SE1->E1_PREFIXO,SE1->E1_NUM,SE1->E1_PARCELA,"R",SE1->E1_MOEDA,dDataBase,SE1->E1_CLIENTE,SE1->E1_LOJA)"

Image Added

Aviso
titleImportante

Caso o valor original já esteja calculado com a dedução dos valores de abatimento, o campo "Abatimento" não deve ser preenchido para que não ocorra uma duplicidade no valor de abatimento.

Caso o campo "Abatimento" seja preenchido o campo "Valor Original" deverá conter o valor cheio (Sem a dedução do abatimento). Caso exista abatimento será exibida uma mensagem no corpo do boleto informando o valor do abatimento já calculado.

Aviso
titleImportante

Sempre que uma expressão for aplicada em um campo de VALOR, é essencial incluir uma proteção de arredondamento para garantir que o valor seja sempre retornado com duas casas decimais.

Exemplo: round(SE1->E1_SALDO * 0.10, 2)

07. PAGAMENTO COM VALORES DIVERGENTES

O Protheus não envia a informação se o boleto poderá ou não ser pago com valores divergentes pois essa configuração é efetuada na própria conta no Banco Itaú. Ou seja, o cliente que recebe o boleto poderá ou não pagar com valores divergentes de acordo com a configuração da conta que emitiu o boleto, não havendo nenhuma configuração para isso no Protheus. Portanto pedimos que entre em contato com seu gerente de contas e verifique se a sua conta está configurada de acordo com a necessidade.


08. CONFIGURAÇÃO DE BOLETO

Permite que o usuário configure como será a impressão do boleto.

  • Imprime abatimento
    • Como mensagem - O valor do abatimento será impresso nas mensagens do boleto
    • Campo desconto/abatimento - O valor do abatimento no titulo será impresso no (-) Desconto/Abatimento do boleto

Image Added


Aviso
titleImportante
  • Não é possível utilizar as opções "Como mensagem" e "Campo desconto/abatimento" em conjunto. 
  • Após a transmissão do boleto as alterações realizadas no campo Imprime abatimento não serão aplicadas aos boletos já transmitidos. As alterações serão aplicadas somente aos boletos transmitidos após a alteração.