01. DADOS GERAIS

Produto:

TOTVS Varejo Supermercados

Linha de Produto:

Linha Consinco

Segmento:

Varejo

Módulo:Financeiro
Função:CONTA DE COBRANÇA - FICTACOBRANC / EMISSÃO DE DUPLICATAS/BOLETOS - FIEMIDUPLIC / OCORRÊNCIA BANCÁRIA - FIOCORBANC / SELECIONAR TÍTULOS PARA REGISTRO DE COBRANÇA - CAP00164 / IMPORTAÇÃO DO ARQUIVO DE RETORNO CNAB - FIIMPORTCNAB / MANUTENÇÃO DE TÍTULO - FIMANUTITULO
País:Brasil
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :

DSUPFIN-3333


02. SITUAÇÃO/REQUISITO

Foram implementados novos recursos e processos para que os títulos (boletos) possam ser registrados com a emissão da nota fiscal / boleto. Para isso foram realizadas alterações no módulo Vendas (Clique aqui para acessar a documentação). Esse processo permite que os boletos já saiam da empresa registrados em banco, dando mais segurança ao processo e eliminando esforço do Financeiro. Caso o processo tenha alguma intercorrência (API fora do ar, problemas de comunicação, etc) o usuário ainda terá a opção de registro da cobrança via Financeiro.

03. PRÉ-REQUISITOS E RESTRIÇÕES

Ter cadastro no Portal BB com aplicação ativa e API de cobrança vinculada a aplicação criada. Clique aqui para acessar.

Seguir a documentação disponibilizada no Portal, ou em caso de dificuldades para o cadastro, entre em contato com a gerência do Banco.

Caso já possua aplicação cadastrada, utilize a API de Cobrança disponibilizada. 

Grupo alvo

  • Convênio de cobrança ativo: 7 dígitos;
  • Tipos de convênio para registro: 4 (Cliente Numera, Emite e Expede)
  • Modalidades: 1- Simples;
  • Carteira: 17;
  • Nosso número: 20 dígitos (000 + número do convênio (7 dígitos) + número de controle (10 dígitos)).

04. SOLUÇÃO

Após cumprir os pré-requisitos, para utilizar o novo recurso de Pix Cobrança, é necessário seguir o passo a passo para configurar a aplicação:

    Incluir Informações de API do Banco do Brasil para registro de boletos na Conta de Cobrança

    Cadastrar as informações de comunicação com a API do Banco do Brasil para registrar boletos emitidos.

    Acessar: Supervisor > Parâmetros > Cobrança > Conta de Cobrança para marcar o parâmetro Gera Cobrança por API que será habilitado quando o banco selecionado for 1 - Banco do Brasil.

    Ao marcar o parâmetro a aba API também será habilitada, permitindo cadastrar as informações para comunicação com o Banco do Brasil.

    Imagem 1 - Parâmetro Gera Cobrança por API Habilitado


    A aba API exibe a opção para a escolha do Ambiente e também os campos Application Key e Token Autenticação que receberão informações copiadas do portal developers do Banco do Brasil

    Imagem 2 - Aba API com campos para comunicação com Banco do Brasil.

    Clique aqui para consultar o processo completo do Passo 01.

    Dica

    Abra em uma nova aba ou janela.

    Gerar o Boleto Hibrido do Banco do Brasil para emissão

    Acessar: Operador Financeiro > Relatórios > Emissão Duplicatas/Boleto, realizar a pesquisa e marcação do boleto para ser emitido. Foi adicionada a coluna Registrado que informa o método de registro utilizado.

    Imagem 1 - Coluna Registrado

    Caso a integração via API tenha retornado algum erro, será possível clicar no campo ERRO para visualizar o log.

    Imagem 2 - Log integração


    Boleto modelo

    Na emissão dos boletos listados, pode ser emitido Qrcode PIX, após configurado Conta Cobrança.

    • C5Boleto3bol_pagina
    • c5boletobesc
    • C5BoletoEntrega
    • c5boletoentregacorrbanc
    • C5BoletoPadrao
    • c5boletopadraocorrbanc 

    Imagem 3 - Boleto com Pix QrCode

    Caso utilize arquivo QRP diferente do padrão para impressão do boleto, é necessário incluir as novas informações.
    Clique aqui para consultar o processo completo do Passo 02.

    Dica

    Abra em uma nova aba ou janela.

    Ocorrência Bancária

    Para ocorrer a geração de ocorrência de cobrança é necessário realizar a configuração no supervisor de ocorrência bancária 

    Acesse: Supervisor Financeiro > Parâmetros > Cobrança > Ocorrência Bancaria.

    Preencha os campos conforme o necessário e clique no botão Incluir ou Atualizar.

    Imagem 1- Ocorrência de Registro de títulos


    Imagem 2 - Alteração de data Vencimento


    Selecionar Títulos para Registro de Cobrança Online

    Acesse a nova tela de geração de cobrança online onde é registrada as ocorrências de alterações de data de vencimento de boleto e registro de boleto.

    Acesse: Operador Financeiro > Cobrança > Selecionar Títulos para Geração de cobrança online.

    Exemplo: Ocorrência de alteração de data de Vencimento de boleto.

    Informe os campos necessários e clique no botão Selecionar

    Serão exibidas as ocorrências agrupadas conforme os filtros informados. Marque a ocorrência desejada e clique no botão Enviar Ocorrência para Registro.

    Aparecerá uma mensagem para confirmação do envio e a quantidade das ocorrências selecionadas e registradas.

    Imagem 3 - Ocorrência de Alteração de data vencimento

    Caso ocorra inconsistência no registro a coluna situação exibira a mensagem de Erro.

    Clique na linha para exibir os detalhes do erro na parte inferior da aplicação.

    Imagem 4 - Erro

    Para exibir o Log de Registro Onilne, clique duas vezes na coluna situação no registro com erro.

    Imagem 5 - Registro de Log Online

    Clique aqui para consultar o processo completo do Passo 03.

    Dica

    Abra em uma nova aba ou janela.

    Protestar, Cancelar e Sustar Protesto

    Ao gerar as ocorrências Protestar(6), Não protestar(7) e Sustar Protesto(10) em título com cobrança registrada, deve integrar as instruções para o Banco do Brasil via API.

    Na aplicação Operador Financeiro > Cobrança > Selecionar Títulos para Geração de cobrança online, para exibir as ocorrências e gerar as informações solicitadas pelo banco.


    Sendo:

    • Protestar: a imagem abaixo ilustra a ação realizada na aplicação Operador Financeiro > Manutenções > Título de manutenção de título. A ação deve ser realizada quando deseja encaminhar ao cartório no dia seguinte. Por esse motivo é enviado o valor 1(dia) na propriedade quantidadeDiasProtesto.

    Imagem 1- Encaminhar ao cartório para protesto

    Gera informação "indicadorProtestar" exemplo:
    {"numeroConvenio":3128557,"indicadorProtestar":"S","protesto": {"quantidadeDiasProtesto":1}}


    • Não Protestar: a imagem abaixo ilustra a ação realizada na aplicação Operador Financeiro > Manutenções > Título de manutenção de título. Deve ser utilizada para cancelar uma instrução de protesto enviada ao Banco na mesma data ou que ainda não tenha sido processada pelo Banco.

    Imagem 2- Não encaminhar ao cartório para protesto

    Gera informação "indicadorCancelarProtesto" exemplo:
    {"numeroConvenio":3128557,"indicadorCancelarProtesto":"S"}


    • Sustar Protesto: a imagem abaixo ilustra a ação realizada na aplicação Operador Financeiro > Manutenções > Título de manutenção de título. Deve ser utilizada para sustar uma instrução de protesto já processada pelo Banco.

    Imagem 3- Sustar Protesto

    Gera informação "indicadorSustacaoProtesto" exemplo:
    {"numeroConvenio":3128557,"indicadorSustacaoProtesto":"S"}

    Nota

    Ao emitir um boleto hibrido o mesmo é registrado para realizar a impressão com o QRCode, possibilitando o pagamento via PIX. No momento da impressão não existe ainda o título para enviar a informação do SEQTITULO que hoje é utilizada no arquivo de retorno.

    Para a emissão correta, foi alterado o processo de registro online que envia a informação do SEQBOLETO como campo reservado para empresa. Na importação é identificado se o campo enviado foi o SEQTITULO ou SEQBOLETO para fazer o vínculo.


    05. DEMAIS INFORMAÇÕES

    Atualizar o sistema para a versão 22.07.001 ou versão superior.

    06. ASSUNTOS RELACIONADOS