CROSS SEGMENTOS - BACKOFFICE LINHA PROTHEUS - SIGAFIN - FINA710 - Configurações necessárias para teste de API de Pagamentos no Banco do Brasil. – Central de Atendimento TOTVS

Tempo aproximado para leitura: 00:10:00 min

Dúvida

Como configurar meu ambiente para teste de API de Pagamentos no Banco do Brasil?

Ambiente
Cross Segmentos - TOTVS Backoffice (Linha Protheus) - TOTVS Financeiro - a partir da versão 12.

Solução

Importante: Os passos abaixo são para configuração de um ambiente de testes.

1. Gere suas credenciais pessoais do Banco do Brasil:

Application Key - Chave da aplicação: Chave de acesso do aplicativo
Client ID - ID do Cliente: Código de identificação do cliente
Client Secret - Chave Secreta do Cliente: Chave secreta de validação do cliente.

Estas serão geradas após criação de uma aplicação no site Developers no Banco do Brasil, para criar sua aplicação e gerar suas credenciais, acesse o site: https://www.bb.com.br/site/developers/

Mais orientações no link: https://apoio.developers.bb.com.br/referency/post/5fc113f41be9aa0012bb77e5

Ao criar sua aplicação de pagamento deverá vincular a ela o serviço de APIs, Pagamentos em lote, conforme print abaixo:

2. Para cadastro de Banco, Parâmetros de Banco e de Fornecedor, será necessário utilizar dados fictícios, disponíveis no link abaixo:

https://apoio.developers.bb.com.br/referency/post/61ba126a2cf79d0012d8c657

3. Cadastro de Banco MATA070, dados para cadastro de banco, da conta pagadora do Banco do Brasil:

Observação: Para habilitar a configuração de um layout para o Banco do Brasil deve ser informado no campo A6_BCOOFI ( Banco oficial ) o código 001.

4. Parâmetros de banco FINA130

Número de convênio deve ser informado no campo Cod. Empresa (EE_CODEMP).
Exemplo dados fictícios do Banco do Brasil:

ID da transação deve ser informado o sequencial utilizado para transacionar os pagamentos (EE_IDTRANS).

*Código inserido neste campo, refere-se ao número de requisição, composto por 7 dígitos, é um número único, não sequencial, controlado pelo cliente, cujo valor vai de 1 a 9999999, contudo essa numeração é aberta ao público, portanto é possível que seu pagamento teste, retorne com erro: “Número da requisição já utilizado. Este número deve ser único” caso ocorra informe outra numeração aleatória.

Libera aut. deve ser informado se os pagamentos serão liberados automaticamente (EE_LIBEAUT).
Agência oficial deve ser informado o número da agencia oficial (EE_AGEOFI)
Conta oficial deve ser informado o número da conta oficial (EE_CTAOFI)
Digito da conta oficial deve ser informado o digito verificador da conta oficial (EE_DVCTOFI)

5. Cadastro de fornecedor PF e PJ, deverá utilizar dados fictícios de CPF/CNPJ e de conta, Banco 001, Agência e Conta, para obter esses dados acesse link: https://apoio.developers.bb.com.br/referency/post/61ba126a2cf79d0012d8c657

6. Alguns dos tipos de pagamentos para teste são:

- Transferência entre contas correntes Banco do Brasil.
*Ao gerar o título de pagamento, selecione fornecedor cadastrado com dados fictícios do Banco do Brasil.
- Pagamento de Guias com Código de Barras.
*Ao gerar título de pagamento, selecione fornecedor cadastrado com dados fictícios do Banco do Brasil, utilize o valor e os código de barras também dos dados fictícios.

7. Gerar Borderô de Pagamentos – FINA240 / FINA241.

É possível gerar um borderô de pagamentos com registro online, para isso bastar acessar a rotina Borderô de pagamentos (FINA240) ou Borderô de pagamento com impostos (FINA241), ao preencher informações do banco e subconta previamente cadastrados, será habilitado a opção Registro Online, ao marcar essa opção o borderô será marcado para registro online (EA_BORAPI = S).

Modelos de pagamentos (Tabela genérica 58 do SX5) homologados para transmissão:

30 - Transmissão de pagamento dos boletos gerados
31 - Transmissão de pagamento dos boletos gerados
01 - Transmissão de transferência entre contas
03 - Transmissão de transferência entre contas
41 - Transmissão de transferência entre contas
43 - Transmissão de transferência entre contas
13 - Transmissão de pagamentos de GUIA com código de barras
16 - Transmissão de pagamentos da DARF
18 - Transmissão de pagamentos da DARF
17 - Transmissão de pagamentos da GPS

8. Configurar Schedule FINA717 e FINA718

Job de transmissão dos pagamentos - FINA717
https://tdn.totvs.com/pages/releaseview.action?pageId=772810894

Job de retorno dos pagamentos - FINA718
https://tdn.totvs.com/display/public/PROT/Job+de+retorno+dos+pagamentos+-+FINA718

Observação:
Para a correta execução do job FINA718 é necessário que as tabelas F79 e F7A estejam com o mesmo compartilhamento.

9. Configurar Layout da Conta:

Acesse a rotina FINA710 – Novo Gestor Financeiro>Comunicação online>Configuração de contas>Novo Layout.

Caso tenha efetuado o cadastro da conta corrente fictícia para teste os dados a mesma irá aparecer para nova configuração:

Selecione a opção Homologação:

Insira suas credenciais de homologação geradas conforme orientação do 1º passo e clique em Validar Credenciais.

Configure dados de Pagador, Título, Valores e Transferência, conforme exemplos abaixo:

10. Após a configuração do layout da conta, gere os títulos a pagar pela rotina FINA050/FINA750 e insira os mesmos em Borderô FINA240/FINA241.

*Ao emitir o título informe o banco portador selecionando a conta corrente fictícia do BB, conforme exemplo abaixo:

*Gere os borderôs de pagamento, agrupando os títulos por modelo de pagamento, conforme os códigos informados no item 8.

11. Após gerar o borderô de pagamentos acompanhe pelo no monitor de pendencias da rotina FINA710 os estágios:

À registrar

Em processamento, verifique os detalhes do retorno, clicando (...) na linha do registro.
O status em processamento, significa que os dados estão sendo validados pelo banco, essas validações podem levar em média 15 minutos ou mais...

Retorno com erro, caso o botão “Transmitir Rejeitados” esteja habilitado é possível acioná-lo, essa funcionalidade visa flexibilizar o processo, permitindo que o usuário corrija o problema e de forma instantânea já retransmita aquele pagamento.

(Para que esse processo funcione corretamente, se faz necessário que o ambiente esteja atualizado com a expedição continua com data superior a 30/06/2023).

Observação: Para não visualizar borderôs com status “Retorno com Erro”, no Monitor de pagamentos com pendencias, deverá efetuar o cancelamento através da rotina FINA240/FINA241.

Agendado

Aguardando efetivação de pagamento, que poderá ser automático ou por autorização conforme configuração em parâmetros de banco, configurado pelo campo: Libera aut. (EE_LIBEAUT) deve ser informado se os pagamentos serão liberados automaticamente.