Tempo aproximado para leitura: 00:05 min
Dúvida
Como preparar um título contas a receber para envio de Boleto Online - API Banco do Brasil (FINA713)
Ambiente
Cross Segmento - TOTVS Backoffice (Linha Protheus) - Financeiro - FINA713 - Todas as versões
Solução
Para a geração do Boleto Online - API Banco do Brasil, precisamos configurar alguns cadastros.
Cadastro de Cliente (MATA030)
Cadastrar um cliente baseado em um CNPJ fictício no site do banco do brasil
Segue um print de tela do site do banco do brasil
https://apoio.developers.bb.com.br/referency/post/5ffc477c3b02bd0012ecaa1a
Nome da Empresa | CNPJ
TECIDOS FARIA DUARTE | 74910037000193
LIVRARIA CUNHA DA CUNHA | 98959112000179
DOCERIA BARBOSA DE ALMEIDA | 92862701000158
DEPOSITO ALVES BRAGA | 94491202000127
PAPELARIA FILARDES GARRIDO | 97257206000133
Atualização de Banco (MATA070)
Agência (A6_AGÊNCIA) sem digito
Conta( A6_NUMCON) sem digito
Banco Oficial (A6_BCOOF ) = 001 (Banco do Brasil )
Campo Bloqueada (A6_BLOCKED) Precisa estar preenchido= 2
Atualiza Parâmetro de Bancos - CNAB (FINA130)
Aba Cadastrais
Cód. Empresa( EE_CODEMP ) Convênio da empresa, disponibilizado pelo Banco do Brasil no link
https://apoio.developers.bb.com.br/referency/post/5ffc477c3b02bd0012ecaa1a
Cod. Empresa(EE_CODEMP) = 3128557 (número fictício para teste.)
Extensão(EE_EXTEN)= TXT
Faixa Inicio (EE_FAXINI) = 000000000001
Faixa Fim (EE_FAXFIM) = 999999999999
Faixa Atual (EE_FAXATU ) = 00000000001
Tabela (EE_TABELA) = 17
Nro Byte (EE_NRBYTES) = 240
Aba Outros
Cód Carteira (EE_CODCART) = 17
Bco. Oficial (EE_CODOFI) = 001 ( Banco do Brasil )
Var. Carteira (EE_VARCART) = 035
-
Número Dias Limite Recebimento deve ser informado no campo Dias Recebim (EE_DIASREC)
- Quando este campo possui um valor > 0, internamente o Indicador Aceite Titulo Vencido passa a ser enviado com 'S'
- Quantidade Dias Protesto deve ser informado no campo Dias Prot (EE_DIASPRT)
- 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 caracteres. Recomendamos o uso de letras minúsculas, pois na impressão do boleto existe um espaço pré-definido para exibição da mensagem.
- Recebimento on-line deverá ser informado para pelo menos um convênio quando o retorno(FINA715 ou Webhook) estiver configurado (EE_RETAUT). Caso não esteja habilitado, o retorno não irá ser processado para esse convênio.
- SIGACFG na opção "Schedule" faça a criação dos agendamento
FINA713('01')
Onde o ('01') seria o grupo da empresa
E ao selecionar as filiais, marque somente 1 filial (Não selecione todas as filiais), pois o job já funciona por grupo de empresa.
Importante: Caso tiver mais de um ambiente com o job FINA713('01') configurado, ao executar poderá gerar falhar e não executar o job. Sugerimos que seja cadastrado o job FINA713('01') em um único ambiente.
Poderá consultar se existe mais de um ambiente com o job configurado ao efetuar um select no campo XX1
Acesse o FINA710 - Novo Painel Gestor e acesse "Comunicação Online" utilizando o menu
E clique em "Configuração de Contas"
Ao clicar em "Novo Layout"
Onde terá que selecionar o banco. E clique em "avançar"
Obtenha suas credencias acessando o site do banco
https://app.developers.bb.com.br/
Acesse "nova aplicação"
E crie uma nova, selecionando a opção "Cobranças"
E na opção do menu, acesse "Credenciais", onde terá acesso a suas chaves
Volte no Protheus e marque
Produção ou Homologação, pois o banco fornece credenciais diferente para cada ambiente.
Insira suas credenciais conforme o exemplo abaixo, e clique em "validar credenciais"
- Configure o seu layout
Opte em escolher os conteúdos dos campos que estiver usando nos seus cadastros
Exemplo:
Vou escolher a opção do conteúdo do campo A1_CEP ao invés de A1_CEPC, já que no meu ambiente o campo A1_CEPC está vazio. Se eu escolhesse A1_CEPC, no momento da transmissão poderá ocorrer falhar ou rejeição, por algum campo ir valor NULO.
Na rotina FINA060 - Colocar o titulo em Borderô, atentando-se aos campos
Banco-> Banco do Brasil ( SA6 )
Situação-> Não é possível com carteira 0
*Sub Conta -> Banco do Brasil ( SEE )
*Espécie -> 2 Duplicata mercantil
*Para que os campos (Sub Conta /Espécie ) estejam disponibilizados, o campo A6_CFGAPI (SA6) deve estar com conteúdo =1 ou 3 para cadastro do Banco do Brasil.
Exemplo:
Significado de cada status:
1=RECEBER REMESSA;
2=SEM CONFIG.;
3=RECEBER REMESSA E RETORNO
Obs: O campo A6_CFGAPI ficará com o conteúdo 1 automaticamente quando o layout for configurado, ou 3 se for configurado o retorno também.
Ao concluir a inclusão do Borderô, já estará disponível no "Monitor de boletos com Pendências" na aba À registrar e com status de À registrar
SIGACFG > Schedule > Agendamento > Monitor
Quando o job for executado, irá apresentar uma legenda verde que significa
Após o termino da execução do job, a legenda deverá ser alterada para "cinza"
O registro irá sair da opção "A Registrar" o boleto esta disponível para Download.
Possíveis erros para o Banco do Brasil
- Ao imprimir o boleto apresentar o erro:
412 - Sem acesso ao arquivo PDF
Erro
Não foi possível acessar o arquivo \spool\boletos\01\00174910037000193083816.pdf.
Geralmente esse erro ocorre por falta do arquivo printer.exe dentro do /appserver/printer.exe
Cross Segmento - TOTVS Backoffice Linha Protheus - ADVPL - Como atualizar o Totvs Printer
- Detalhes do Erro - 500 InternalServerError
Podemos observar que no console.log do appserver apresentou erro de credencial que deve ser verificado junto ao banco.
Neste exemplo eu forcei um erro, utilizei as minhas credenciais de base de homologação, em um ambiente de produção, e por isso do erro abaixo.
grant_type=client_credentials&scope=cobrancas.boletos-info cobrancas.boletos-requisicao
HTTP/1.1 500 Internal Server Error
Access-Control-Allow-Credentials: false
x-br-com-bb-oat-servidor: pxl1oat00080_oat-servidor-autorizacao-5
Response Body: Request failed.
Saiba mais
Boleto Online - FINA713 e Novo Gestor Financeiro (NGF ) - FINA710
Registro de boletos on-line - Banco do Brasil
How to | - SIGAFIN - NGF - Como Config. Envio de Boletos FINA710
Novo Gestor Financeiro - (FINA710 - SIGAFIN)
Comunicação bancária online - FINA710
API ITAU - Registro de boletos on-line - Itaú
API BRADESCO - Registro de boletos on-line - Bradesco
0 Comentários