Árvore de páginas

Versões comparadas

Chave

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

CNAB Cloud - Baixa de arquivos de configuração CNAB.

Características

Linha de Produto:

Microsiga Protheus

Segmento:

Financeiro

Módulo:

Financeiro.

Rotina:

Rotina

Nome Técnico

CFGX049B

Rotina responsável pelo Wizard de passo a passo para a baixa dos arquivos de configuração CNAB.

Rotina(s) envolvida(s)

Nome Técnico

CFGX049B01, CFGX049B02, CFGX049B03, CFGX049B05, CFGX049B06, CFGX049B08, CFGX049B97, CFGX049B98.

Rotinas responsaveis pela gravação de tabelas e criação de arquivo texto.

País(es):

Todos

Banco(s) de Dados:

MSSQL, Oracle, DB2.

Tabelas Utilizadas:

FOP, FOQ e FOZ.

Sistema(s) Operacional(is):

Windows.

Descrição

Esta funcionalidade permitirá que os arquivos de configuração CNAB padronizados sejam baixados para o ambiente Protheus do cliente. O acesso aos arquivos de configuração CNAB serão através de Servidor REST, neste servidor estarão disponibilizados arquivos dos bancos Brasil, Santander, Caixa Econômica, Bradesco e Itaú.  Estes arquivos serão homologados pela Totvs junto aos respectivos bancos.

Informações
titleImportante

Apenas para Microsiga Protheus, versões igual ou superiores ao release V12.1.20.

Para acessar os servidores da Totvs e validação de permissão, o cliente deverá ser usuário do HLCloud (HardLock Cloud) e ter CNPJ valido. O CNPJ usado para validação será consultado na tabela SM0. 

Após baixar os arquivos de configuração, antes de disponibiliza-los em ambiente de produção, o cliente deverá fazer teste de homologação junto ao seu banco. 

Existindo arquivos de configuração CNAB em uso pelo cliente, fazer backup desses arquivos.

Aviso
titleAtenção

O procedimento a seguir deve ser realizado pelo profissional Administrador do sistema, o acesso será através do modulo de Configurador.

Dica
titlePara baixar os arquivos, siga o processo abaixo
  1. Em Microsiga Protheus TOTVS Smart Client, acesse o módulo Configurador.
  2. Em "Cadastro", "CNAB Cloud", clique em Imp. Arq. Configuração.
  3. Após a chamada da rotina serão exibidas as telas Wizards.
    1. Processo de validação de acesso;
    2. Quais os bancos existentes na tabela padrão Protheus SA6 (Cadastro de Bancos);
    3. Quais os arquivos estão disponíveis para baixa;
    4. Escolha de qual(is) módulos deseja (Contas a Pagar ou Contas a Receber);
    5. Escolha de qual(is) tipos deseja (Remessa ou Retorno);
    6. As informações para a criação dos arquivos de configuração CNAB serão gravados nas tabelas FOP, FOQ e FOZ;
    7. Geração dos arquivos na pasta System (De acordo com a informação do arquivo Server INI). Nome do arquivo que será gerado, exemplo:
      1. BBBMMTTT - Clique aqui para visualizar os nomes e extensões dos arquivos
        1. BBB - Será o código do banco solicitado; 
        2. MM - Modulo Pagar ou Receber,
        3. TTT - Remessa ou Retorno.
Nota
titleTabelas criadas em Base de Dados

Tabelas criadas em Base de Dados.

O sistema irá criar as tabelas FOP, FOQ e FOZ, para acessar as informações e características das tabelas, clique no link abaixo.

Tabela FOP

Tabela FOQ

Tabela FOZ

Nota
titleEstrutura dos Arquivos de configuração CNAB

Estrutura dos arquivos de configuração CNAB.

Expandir
titleBanco do Brasil
Expandir
titleContas a Pagar
Expandir
titleRemessa
VersãoReleaseObservaçãoData da Liberação
12.1.1712.1.20Arquivo CNAB Padrão Inicial

Expandir
titleRetorno
VersãoReleaseObservaçãoData da Liberação
12.1.1712.1.20Arquivo CNAB Padrão Inicial

Expandir
titleContas a Receber
Expandir
titleRemessa
VersãoReleaseObservaçãoData da Liberação
12.1.1712.1.20Arquivo CNAB Padrão Inicial

Expandir
titleRetorno
VersãoReleaseObservaçãoData da Liberação
12.1.1712.1.20Arquivo CNAB Padrão Inicial

Expandir
titleBanco Santander
Expandir
titleContas a Pagar
Expandir
titleRemessa


VersãoReleaseObservaçãoData da Liberação
12.1.1712.1.20Arquivo CNAB Padrão Inicial

Expandir
titleRetorno
VersãoReleaseObservaçãoData da Liberação
12.1.1712.1.20Arquivo CNAB Padrão Inicial

Expandir
titleContas a Receber
Expandir
titleRemessa
VersãoReleaseObservaçãoData da Liberação
12.1.1712.1.20Arquivo CNAB Padrão Inicial

Expandir
titleRetorno
VersãoReleaseObservaçãoData da Liberação
12.1.1712.1.20Arquivo CNAB Padrão Inicial

Expandir
titleCaixa Econômica
Expandir
titleContas a Pagar
Expandir
titleRemessa
VersãoReleaseObservaçãoData da Liberação
12.1.1712.1.20Arquivo CNAB Padrão Inicial

Expandir
titleRetorno
VersãoReleaseObservaçãoData da Liberação
12.1.1712.1.20Arquivo CNAB Padrão Inicial

Expandir
titleContas a Receber
Expandir
titleRemessa
VersãoReleaseObservaçãoData da Liberação
12.1.1712.1.20Arquivo CNAB Padrão Inicial

Expandir
titleRetorno
VersãoReleaseObservaçãoData da Liberação
12.1.1712.1.20Arquivo CNAB Padrão Inicial

Expandir
titleBanco Bradesco
Expandir
titleContas a Pagar
Expandir
titleRemessa
VersãoReleaseObservaçãoData da Liberação
12.1.1712.1.20Arquivo CNAB Padrão Inicial

Expandir
titleRetorno
VersãoReleaseObservaçãoData da Liberação
12.1.1712.1.20Arquivo CNAB Padrão Inicial

Expandir
titleContas a Receber
Expandir
titleRemessa
VersãoReleaseObservaçãoData da Liberação
12.1.1712.1.20Arquivo CNAB Padrão Inicial

Expandir
titleRetorno
VersãoReleaseObservaçãoData da Liberação
12.1.1712.1.20Arquivo CNAB Padrão Inicial

Expandir
titleBanco Itaú
Expandir
titleContas a Pagar
Expandir
titleRemessa
VersãoReleaseObservaçãoData da Liberação
12.1.1712.1.20Arquivo CNAB Padrão Inicial

Expandir
titleRetorno
VersãoReleaseObservaçãoData da Liberação
12.1.1712.1.20Arquivo CNAB Padrão Inicial

Expandir
titleContas a Receber
Expandir
titleRemessa
VersãoReleaseObservaçãoData da Liberação
12.1.1712.1.20Arquivo CNAB Padrão Inicial

Expandir
titleRetorno
VersãoReleaseObservaçãoData da Liberação
12.1.1712.1.20Arquivo CNAB Padrão Inicial

Nota
titleEstrutura do nome do arquivo de configuração CNAB

Estrutura do nome do arquivo de configuração CNAB.

Para verificar a estrutura de nome dos arquivos de configuração CNAB. clique no link abaixo.

Consulta a estrutura de nome dos arquivos de configuração CNAB

Nota
titleDescrição e sequencia das telas Wizard

Descrição do processo das telas Wizard

Expandir
titleDescrição do processo telas Wizard
  1. Tela 01 - Informará os passos necessários para baixar / gerar arquivos CNAB.
  2. Tela 02 - Tela de validação de Release e versão Protheus e validação de acesso ao servidor de HLCloud (Hard Lock Cloud).
    1. O cliente não terá acesso aos arquivos de configuração CNAB se a Release for inferior a 12.1.20;
    2. O cliente não terá acesso aos arquivos de configuração CNAB se o CNPJ do cliente não tiver acesso aos serviços de hard lock da Totvs.
    Obs.: Se todas as validações acima forem confirmadas pela torina, o cliente poderá baixar os arquivos de configuração CNAB, siga os próximos passos.
  3. Tela 03 - Irá processar e pesquisar na base de dados do cliente quais são os bancos ativos (tabela SA6) e será mostrada tela MarkBrowse para escolha de qual(is) banco(s) deseja gerar o arquivo CNAB.
    1. Os bancos listados serão pesquisados na base de dados do cliente, tabela SA6. Somente os bancos que estiverem bloqueados para uso não serão exibidos.
    2. Tela MarkBrowse será apresentada, onde o cliente poderá escolher quais os bancos deseja verificar se existem arquivos de configuração CNAB disponíveis.
  4. Tela 04 - Nesta tela o cliente poderá escolher quais os arquivos deseja baixar:
    1. Poderá escolher entre os módulos Contas a Pagar e/ou Contas a Receber;
    2. Poderá escolher entre os tipos de arquivos Remessa e/ou Retorno.
  5. Tela 04 - Semáforo informando release de arquivo.
    1. Se o semáforo for da cor verde, arquivo disponivel para baixa;
    2. Se o semaforo for da cor vermelha, arquivo não disponível para baixa, pois o é somente para release superior, sendo o caso o ambiente do cliente deverá ser atualizado para a release especifica.
    Obs.: Para a atualização de release, siga as instruções disponíveis em: Atualizador de dicionário e base de dados - UPDDISTR
3. Tela 03 – Esta tela irá apresentar
  1. .
  2. Tela 05 - Tela de processamento da baixa.
    1. Esta tela será para visualização do processo de baixa dos arquivos de configuração CNAB. Neste momento o sistema irá gravar as informações dos arquivos nas tabelas FOP, FOQ e FOZ.
  3. Tela 05 - Tela de resultado do processamento.
    1. O sistema informará sobre o resultado do processamento e sobre a possibilidade da geração ou edição dos arquivos de configuração CNAB.
    2. Se o cliente optar pela finalização do processo e gerar os arquivos de configuração CNAB na pasta system, deverá clicar no botão Finalizar.
    3. Se o cliente optar pela edição dos arquivos de configuração CNAB, deverá clicar no botão Avançar.
  4. Tela 06 – Tela para edição de arquivos de configuração CNAB.
    1. irá apresentar os arquivos validação de contrato do cliente e versão de ambiente do cliente. Será mostrado também os arquivos que estão disponíveis para baixa.
    1. Neste momento haverá validação de contrato e versão de ambiente;
    2. Se contrato valido, próxima tela da configuração será apresentada, esta tela mostrará quais os arquivos possíveis de baixa e também quais os arquivos que não poderá ser baixado; (Imagem 04)
    3. Se contrato não valido, será encerrado o processamento e tela informativa será apresentada. (Imagem 03)
    4. Se versão do ambiente cliente for igual ou superior a versão onde foi desenvolvido os arquivos de configuração CNAB Protheus. Próxima tela de configuração será apresentada, esta tela mostrará quais os arquivos possíveis de baixa e também quais os arquivos que não poderá ser baixado; (Imagem 04)
    5. Se versão do ambiente do cliente não for compatível com a versão onde foi desenvolvido os arquivos de configuração CNAB Protheus, será encerrado o processamento e tela informativa será apresentado; (Imagem 03)
    6. Serão desenvolvidos arquivos somente para modelo 2 - 240 Posições.
    7. Deverá haver controle e validação de estrutura de tabelas dentro do versionamento homologado;
    8. Poderá haver casos em se faz necessário a criação de um novo campo, ou um novo parâmetro dentro da versão que o cliente já esta utilizando e o produto Protheus deverá verificar se essa nova estrutura esta atualizado no ambiente do cliente. Este controle será através de uma tabela de dados; (Imagem tabela 02)
    9. A verificação de versão e contratual do cliente ocorrerá em todas as execuções que o cliente fizer deste Wizard;
    10. Nesta tela existirá combobox com a opção “Sim ou Não” se o cliente deseja editar os arquivos padrão CNAB; (Imagem 04)
    11. Se o cliente optar pela não edição, o processo será finalizado. O cliente optando por baixar os arquivos padrão, os arquivos estarão aptos para uso; (Imagem 07)
    12. Se o cliente optar pela edição do arquivo, tela com os campos passiveis de edição serão apresentados. (Imagem 05)

4.Tela 04 – Esta tela será para a edição do arquivo CNAB.

    1. As informações possíveis de edição por banco serão:
      1. Contas a Pagar / Remessa:
        1. Campos data dos arquivos poderão ser alterados pelos campos data tabela SE2;
          1. E2_EMISSAO;
          2. E2_VENCTO;
          3. E2_VENCREA.
        2. Campos valor dos arquivos poderão ser alterados pelos campos valor tabela SE2;
          1. E2_VALOR;
          2. E2_SALDO;
          3. E2_VLCRUZ.
        3. Campo Contrato;
          1. Editável para preenchimento.
        4. Campo endereço, poderá alterado pelos campos da tabela SM0;
          1. M0_ENDENT;
          2. M0_ENDCOB.
        5. Campo cidade, poderá ser alterado pelos campos da tabela SM0;
          1. M0_CIDENT;
          2. M0_CIDCOB.
        6. Campo CEP, poderá ser alterado pelos campos da tabela SM0;
          1. M0_CEPENT;
          2. M0_CEPCOB.
        7. Campo estado, poderá ser alterado pelos campos da tabela SM0;
          1. M0_ESTENT;
          2. M0_ESTCOB.
        8. Campo Código de barras, poderá ser alterado pelos campos da tabela SE2;
          1. Outro campo da tabela SE2.
        9. Campo Nome Cedente, poderá ser alterado por outros campos da tabela SA2;
          1. A2_NREDUZ
        10. Campo CNPJ / CPF, poderá ser alterado por outros campos da tabela SA2;
          1. Outro campo da tabela SA2.
        11. Campo Logradouro do Favorecido, poderá ser alterado por outros campos da tabela SA2;
          1. Outro campo da tabela SA2.
        12. Serão apresentadas quantas telas de configuração forem necessárias de acordo com a quantidade de arquivos CNAB escolhidos pelo cliente para a baixa.
      2.  Contas a Receber / Remessa:

        1. Campos data dos arquivos poderão ser alterados pelos campos data tabela SE1;
          1. E1_EMISSAO;
          2. E1_VENCTO;
          3. E1_VENCREA.
        2. Campos valor dos arquivos poderão ser alterados pelos campos valor tabela SE1;
          1. E1_VALOR;
          2. E1_SALDO;
          3. E1_VLCRUZ.
        3. Campo Inscrição Empresa;
          1. Editável para preenchimento.
        4. Campo Nome do cliente;
          1. Editável para preenchimento.
        5. Campo CNPJ / CPF;
          1. Editável para preenchimento.
        6. Campo Nome da Empresa;
          1. Editável para preenchimento.
        7. Serão apresentadas quantas telas de configuração forem necessárias de acordo com a quantidade de arquivos CNAB escolhidos pelo cliente para a baixa.

5.Tela 05 – Esta tela será a de finalização do processo, informando ao cliente se ocorreu com sucesso ou não. (Imagem 07)

Após a baixa do arquivo o cliente poderá editar qualquer campo (informação) do arquivo de configuração CNAB que ele ache necessário. Para esta edição ele deverá usar a rotina do padrão “CFGX049” (Imagem 08). Após o uso da ferramenta padrão será gravado em tabela (imagem tabela 02) campo “Versão em Uso” que o referido arquivo foi editado pelo cliente, este controle será através do código de versão.

O cliente optando pela edição ele não terá o controle e as eventuais manutenções sob a responsabilidade da TOTVS, esse será considerado um arquivo customizado;

Será desenvolvido tela em MVC para listar os arquivos CNAB para que o cliente faça as edições necessárias e ao clicar no botão editar a rotina do padrão CFGX049 será acionada e o cliente fará suas alterações com a ferramenta padrão.


Observações sobre Segmento/Modelo

  • Opções para os Segmentos de Remessa;
  1. Segmento A
  2. Segmento B
  3. Segmento J
  4. Segmento O
  5. Segmento N
  6. Segmento Z
  • Opções de Modelos por Segmento de Remessa Contas a Pagar;
  1. Segmento A e Segmento B;
    1. Pagamentos efetuados por transferências de Conta Corrente para Conta Corrente do mesmo banco;
      1. Modelo 01
    2. Pagamentos efetuados por transferências de Conta Corrente para Conta Poupança;
      1. Modelo 02.
    3. Pagamentos efetuados por DOC;
      1. Modelo 03.
    4. Pagamentos efetuados por TED para outro CNPJ/CPF;
      1. Modelo 41.
    5. Pagamentos efetuados por TED mesmo Titular;
      1. Modelo 42.
        1. Porem esta opção não é utilizado pelos clientes, quando necessário é efetuado transferência bancaria.
  2. Segmento J;
    1. Pagamentos efetuados por boletos de outros bancos;
      1. Modelo 30.
    2. Pagamentos efetuados por boleto do mesmo banco;
      1. Modelo 31. (Verificar particularidade Itaú)
  3. Segmento O;
    1. Pagamentos efetuados a concessionarias que tenham Código de Barras, como:
      1. Energia;
      2. Telefone;
      3. Agua;
      4. Outros.
    2. Pagamentos de Tributos que tenham Código de Barras, como;
      1. ISS;
      2. FGTS;
      3. Outros.
        Para este segmento será necessário criar tabela de dados informando os códigos dos tributos por banco. Ex.: Para o tributo ISS um banco poderá tratar esse por um código e outro banco tratar o mesmo por outro código. Esta tabela deverá ter informações do banco, imposto e código do imposto por banco.
  4. Segmento N;
    1. Pagamentos efetuados a todos os outros Tributos que não tenham código de barras, como:
      1. DARF Simples;
      2. Gare;
      3. GTS;
      4. Outros.
    2. Pagamentos efetuados a outros tributos, como:
      1. DPVAT;
      2. IPVA;
      3. Outros.
        Para estes tributos por via de regra os clientes não usam CNAB para pagamento, visto a grande necessidade de informações para preenchimento, não sendo viável pelo custo benefício.
        Incluir no Modelo?
  5. Segmento Z;
    1. Este segmento é usado para que o banco retorne ao cliente o código de autenticação do pagamento, esta informação é preenchida em espaço especifico do arquivo de retorno do banco. Este segmento é utilizado para que o cliente informe ao banco que ele deseja receber a informação do código de autenticação do pagamento.

Sequencia das telas Wizard.

Expandir
titleSequencia de telas do wizard

Sequencia das telas Wizard

1 – Acessar modulo Configurador, Ambiente, CnabCloud, execute a rotina “Importar Arquivo Configuração”

2 – Tela de apresentação será mostrada.

 

3 – Após clicar em “Avançar”, tela validando a versão que esta em uso pelo cliente e validação de acesso ao Servidor Totvs de Hardlock (Cloud) consultando os serviços através de CNPJ cadastrado na tabela SM0.

3.1 – Tela validação de versão e acesso aos serviços de Hardlock. - Acesso Negado

3.2 – Acesso liberado aos serviços de Hardlock, para esse acesso é necessário que o cliente seja usuário do nosso serviço de Hardlock Cloud.

4 – Após a validação de acesso aos serviços de hardlock, clique no botão “Avançar”. O sistema mostrará tela relacionando os bancos cadastrados na tabela SA6 do cliente com os bancos disponíveis no servidor Totvs para baixa dos arquivos de configuração CNAB.

5 – Após marcar quais os bancos deseja baixar os arquivos, clique em “Avançar”. A próxima tela mostrará os arquivos possíveis para baixa, se esses arquivos serão do Contas a Pagar ou Contas a Receber e se serão de Remessa ou Retorno. Os arquivos que tem seu status em vermelho são os arquivos que somente estarão disponíveis para release superior ao release do cliente.

6 – Após marcar quais são os arquivos que o cliente deseja baixar, clicar no botão “Avançar”. Na próxima tela o sistema irá gravar as informações dos arquivos de configuração CNAB na tabela FOP.

7 – Após o sistema finalizar o processo de gravação da tabela FOP, tela informativa será mostrada. Se o cliente desejar finalizar o processo e criar os arquivos *.2PR, *.2PE, *.2RR e *.2RE na pasta system deverá clicar no botão “Finalizar”. Se o cliente desejar fazer a edição dos arquivos de configuração CNAB, clique no botão “Avançar”.

8 – A tela que será apresentada mostrará os arquivos possíveis para baixa, Receber ou Pagar, Remessa ou Retorno. Após marcar os arquivos desejados, clique em “Avançar” para a sequência de telas de edição dos arquivos CNAB.

9 – As telas que serão apresentadas, possibilitarão a edição dos arquivos de configuração CNAB. Esta edição será possível somente para as informações disponibilizadas pela Totvs. 

10 – Como exemplifica a imagem acima, será mostrada tela com dados para edição por banco (Bradesco) por modulo (Contas a Pagar) e por tipo (Remessa). Será mostrado qual o movimento se refere ao arquivo de configuração, posição inicial e posição final, conteúdo padrão com as informações de valores iniciais que terá no arquivo padrão e será esse o valor que o cliente poderá editar. O valor para edição será definido pela Totvs e o cliente terá tela consulta padrão (F3) para escolha do novo valor, segue imagem abaixo.

11 – Perceba que a informação em destaque é “E2_VENCTO”, ao clicar em F3 será apresentada tela com as possíveis informações de edição.

12 – Perceba que a nova informação será E2_VENCREA, clique em “Confirmar”.

13 – Visualize na imagem abaixo que o campo Conteúdo Padrão foi alterado pelo novo valor escolhido.

14 – E por último campo, é informado a descrição da linha, a mesma que faz parte do arquivo de configuração CNAB. Após a devida edição ou mesmo a não alteração dos valores de linhas especificas, clicar em “Avançar” para a rotina carregar a próxima tela com dados do próximo arquivo de configuração. Que terá as mesmas características das telas anteriores.

15 – Após a edição de todos os arquivos de configuração CNAB, será apresentado tela de encerramento do processo. Verifique que todos os arquivos foram criados na pasta system e verifique as suas estruturas.