...
| Produto: | | Solucoes_totvs |
|---|
| Solucao | TOTVS Varejo Supermercados |
|---|
|
| Solucoes_totvs_parceirosexptotvs |
|---|
|
|
|---|
| Linha de Produto: | |
|---|
| Segmento: | |
|---|
| 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-33333488 |
|---|
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.
| Dica |
|---|
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.
| Aviso |
|---|
|
- 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)).
|
o cadastrado junto ao ambiente do Banco Bradesco e ter os dados de ClientID fornecidos pelo banco. Para mais detalhes veja a documentação Portal Developers Bradesco.
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:
...
| Informações |
|---|
|
| Deck of Cards |
|---|
| | Card |
|---|
| default | true |
|---|
| id | 01 |
|---|
| label | Passo 01 |
|---|
| title | Incluir Informações de API do Banco do Brasil para registro de boletos na Conta de Cobrança |
|---|
| | do Brasil Cadastrar as informações de comunicação com a API do Banco do Brasil Bradesco 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 237 - Banco do BrasilBradesco. Ao marcar o parâmetro a aba API também será habilitada, permitindo cadastrar as informações para comunicação com o Banco do BrasilBradesco. Image Modified
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 Client Key, Client Secret e Importação do certificado. As informações de Client Key e Client Secret são fornecidas pelo Bradesco ao criar o cadastro para acesso na API, e o certificado é o mesmo que foi enviado para o Bradesco para criação do cadastro. Ao abrir a aba API, os campos relativos ao Banco do Brasil estarão desabilitados. 
Imagem 2 - Aba API com campos para comunicação com Banco do Brasil. | Informações |
|---|
Clique aqui para consultar o processo completo do Passo 01. | Dica |
|---|
| Abra em uma nova aba ou janela. |
|
Image RemovedBradesco |
| Card |
|---|
| id | 02 |
|---|
| label | Passo 02 |
|---|
| title | Gerar o Boleto Hibrido do Banco do Brasil para emissão |
|---|
| Gerar o Boleto Hibrido do Banco do Brasil para emissãoAcessar: 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
| Informações |
|---|
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. |
|

|
| Card |
|---|
| id | 03 |
|---|
| label | Passo 03 |
|---|
| title | Ocorrência Bancária / Títulos para Registro de Cobrança Online |
|---|
| Ocorrência BancáriaPara 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 OnlineAcesse 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 | Informações |
|---|
Clique aqui para consultar o processo completo do Passo 03. | Dica |
|---|
| Abra em uma nova aba ou janela. |
|

|
| Card |
|---|
| id | 04 |
|---|
| label | Passo 04 |
|---|
| title | Protestar, Cancelar e Sustar Protesto |
|---|
| Protestar, Cancelar e Sustar ProtestoAo 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
| Bloco de código |
|---|
| language | js |
|---|
| title | 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
| Bloco de código |
|---|
| language | js |
|---|
| title | 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 | Bloco de código |
|---|
| language | js |
|---|
| title | Gera informação "indicadorSustacaoProtesto" exemplo: |
|---|
| {"numeroConvenio":3128557,"indicadorSustacaoProtesto":"S"} |

|
| Card |
|---|
| id | 05 |
|---|
| label | Info |
|---|
| title | Verificação do Arquivo de retorno |
|---|
| | 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. |
|
| Composition Setup |
|---|
deck.tab.inactive.background = #fcfcfc
deck.tab.active.background = #FF9900 |
|
|
...