Árvore de páginas

Versões comparadas

Chave

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

...

Configurações necessárias para o registro de boletos online do banco Santander. Atenção → Existem dois serviços de comunicação com o banco Santander, abaixo iremos destacar algumas características de cada serviço e como utilizar:      1) Cobrança por XML -

Totvs custom tabs box
tabsCobrança por XML, Cobrança por API
ids01,02
Totvs custom tabs box items
defaultyes
referencia01

Serviço que utiliza comunicação no formato XML

...

Aviso
titleImportante

Esse serviço foi descontinuado pelo banco, portanto novas implementações serão feitas apenas pela Cobrança por API

Totvs custom tabs box items
defaultno
referencia02

Serviço que utiliza comunicação no formato JSON.

Esse novo serviço foi disponibilizado após o cobrança por XML, e possui diversas vantagens em relação ao serviço de cobrança por XML.

Caso o ambiente esteja utilizando o serviço Cobrança por XML, você pode editar o seu layout e assim atualizar para a nova versão, depois de habilitar o serviço na conta e obter suas credenciais

Aviso
titleFuncionalidade em desenvolvimento
A funcionalidade do

O serviço Cobrança por API está em fase de desenvolvimento e em breve entrará em testes com clientes piloto, portanto ainda não está liberada em nenhum release do Protheus!

Será liberado através de pacote de expedição acumulado do módulo financeiro em data ainda a ser informada.

Essa página poderá sofrer alterações até a data de liberação da funcionalidade!

          O serviço cobrança por API foi disponibilizado após o cobrança por XML, e possui diversas vantagens em relação ao serviço de cobrança por XML.

          Segundo recomendação do banco Santander, somente será possível novas configurações para o serviço Cobrança por API.

          Caso o ambiente esteja utilizando o serviço cobrança por XML liberado no NGF, você pode editar o seu layout e assim atualizar para a nova versão, depois de habilitar o serviço na conta e obter suas credenciais.

Informações
titleRede interna

Cobrança por API → 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://trust-open.api.santander.com.br

https://trust-sandbox.api.santander.com.br/


02. ITENS NECESSÁRIO (HABILITAR SERVIÇO NA CONTA)

...

  • O código do Beneficiário da cobrança é configurado na subconta (tabela SEE) pela rotina Parâmetros de Banco (FINA130) no campo Cód. Empresa (EE_CODEMP).
    • Preencher com o convênio completo ou com os 7 dígitos conforme o exemplo abaixo:
      • Convênio completo: 00332271001912345674 → preencher no campo EE_CODEMP o valor 1234567
  • Se o nosso número for gerado pelo sistema, esse deve ser configurado na subconta (tabela SEE) pela rotina Parâmetros de Banco (FINA130) nos campos Faixa Inicio (EE_FAXINI), Faixa Fim (EE_FAXFIM) e Faixa atual (EE_FAXATU).
  • O endereço do cliente deve ter o número separado por vírgula para que seja encaminhado corretamente ao sistema do banco.
  • A configuração para "PROTESTO" de boletos terá como base o campo EE_DIASPRT (Dias para protesto), se este campo estiver preenchido com valor maior que 0 (zero) o layout será configurado como "PROTESTAR" e o numero de dias será o valor do campo. Caso contrario será configurado com "DEVOLVER" em 02 dias.
  • Código da carteira deve ser informado no campo Cód. Carteira (EE_CODCART).
  • Mensagem para instrução de cobrança deve ser informada no campo Mensagem 1 (EE_FORMEN1), vale ressaltar que o banco aceita no máximo 165 100 caracteres, porém existe um espaço pré-definido para exibição da mensagem onde é utilizado aproximadamente 70 caracteres. Recomendamos o uso de letras minúsculas , pois na impressão do boleto existe um espaço pré-definido para exibição da mensagempara maior aproveitamento do espaço de impressão da mensagem.
  • Mensagem para instrução de cobrança (EE_FORMEN2) com o mesmo tamanho máximo da EE_FORMEN1. Disponível apenas para Cobrança por API (JSON).

05. CONFIGURAÇÃO DO LAYOUT

...

  • Boleto Híbrido (Boleto + Pix): Define se irá utilizar QR Code Pix para pagamento no boleto. Para utilizar essa funcionalidade é preciso configurar a chave pix para o banco no cadastro de banco(MATA070) → Outras Ações → Chaves pix. (boleto híbrido disponível apenas para cobrança por API).Cobrança por API).


06. WEBHOOK E FINA715 - RETORNO

           Webhook

           →  Url de Webhook do Santander deve ser configurado na Configuração de Contas do NGF conforme a seguir:

                https://seuendereco:suaporta/api/fin/v1/bb/santander/receivables/

                seuendereco:suaporta → Informar endereço e porta do serviço REST configurado no arquivo appserver.ini.

                /api/fin/v1/bb/santander/receivables/ → API disponível no serviço REST padrão do Protheus preparada para receber o payload de cobrança(boletos) do Santander.       

           A mesma url de Webhook recebe evento de pagameto de boletos pagos via código de barras e pagos via QR Code (Pix).

           O processamento é diferente quando o boleto é pago via código de barras e quando o boleto é pago via QR Code.

          → Pagamento via QR Code (Pix):

                - Boleto já é considerado liquidado e a baixa do título no Protheus é iniciada assim que o Protheus recebe a requisição do banco Santander.

          → Pagamento via Código de Barras:

                - Boleto ainda não pode ser considerado liquidado (Em alguns casos pode ser cancelado ou estornado ao longo do dia pelo banco).

                - A baixa do título não é realizada no momento que o Protheus recebe a comunicação via Webhook. A baixa será processada posteriormente via job FINA715. Para mais detalhes clique aqui.

           FINA715

           →  Banco Santander segue o processo de bancos que não possuem API de listagem. Para mais detalhes clique aqui.