Histórico da Página

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

Características

Linha de Produto:

Microsiga

Protheus

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.

Todos
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. Estes O acesso aos arquivos de configuração CNAB serão através de Servidor REST, neste disponibilizaremos inicialmente os arquivos dos bancos Brasil, Santander, Caixa Econômica, Bradesco e Itaú. Os arquivos serão homologados pela Totvs TOTVS junto aos respectivos bancos através de pilotos da primeira implantação dos layouts.

Image Added

Informações

title	Importante

Apenas para

Funcionalidade disponível apenas para os Clientes com:

Microsiga Protheus,

versões superiores

versão igual ou superior ao release

V12

12.1.

20.Para acessar os servidores da Totvs e validação de permissão, o cliente deverá ser usuário do

23 de Fevereiro/2019, possuindo dicionário atualizado com as tabelas mencionadas.

Clientes usuários do HLCloud (HardLock Cloud)

e ter CNPJ valido

, com acesso aos servidores TOTVS e com CNPJ válido nos contratos da TOTVS. O CNPJ usado para validação será consultado na tabela SM0.

Após baixar os arquivos de configuração, antes de

disponibiliza

disponibilizá-los em ambiente de produção, o cliente deverá fazer teste de homologação junto ao seu banco.

Existindo

Ressaltamos a necessidade de fazer o backup dos arquivos de configuração CNAB

em uso pelo cliente, fazer backup desses arquivos.

já existentes antes de uma nova atualização.

Aviso

title	Atenção

O procedimento a seguir deve ser realizado pelo profissional

Administrador

administrador do sistema, uma vez que o acesso será através do modulo

de Configurador.Em Microsiga Protheus TOTVS Smart Client

Configurador.
Para elaboração dos arquivos de configuração do Cnab Cloud, foram utilizados os layouts padrões disponibilizados por cada banco. Porém não isenta a homologação do arquivo de remessa junto ao Banco correspondente antes da entrada em Ambiente Produção.

Dica

title	Para baixar os arquivos, siga o processo abaixo

Em Microsiga Protheus TOTVS SmartClient, acesse o módulo Configurador.
Em "Cadastro", "CNAB Cloud", clique em "Imp. Arq. Configuração".
Após a chamada da rotina

serão exibidas as telas Wizards.

será exibido o assistente de configuração, que compreende os seguintes passos:
1. Processo de validação de acesso;

Quais os

1. Cruzamento de bancos existentes na tabela padrão Protheus SA6

(Cadastro de

1. - Bancos

)

1. ;

Quais os arquivos estão

1. Arquivos disponíveis para baixa;
2. Escolha de

qual

1. carteiras (

is) módulos deseja (

1. Contas a Pagar ou Contas a Receber);
2. Escolha de

qual(is) tipos deseja

1. tipos de arquivo (Remessa ou Retorno);

As informações para a criação

1. Download dos arquivos de configuração CNAB, que serão gravados nas tabelas FOP, FOQ e FOZ;
2. Geração dos arquivos na pasta System (De acordo com a informação do arquivo Server INI).

Nome

1. O nome do arquivo que será gerado

,

1. de acordo com o exemplo abaixo:

XXXPAREM.2PE

XXX - Será o código do banco solicitado;
PA - Modulo Pagar, informação do modulo;
REM - Remessa.

1. 1. BBBCCTTT - Clique aqui para visualizar os nomes e extensões dos arquivos
    1. BBB

XXXPARET.2PRXXX

1. 1. 1. - Será o código do banco solicitado;

PA

1. 1. 1. CC -

Modulo Pagar, informação do modulo;

RET - Retorno.

XXXREREM.2RE

XXX - Será o código do banco solicitado;
RE - Modulo Receber, informação do modulo;
REM - Remessa.

XXXRERET.2RR

XXX - Será o código do banco solicitado;

RE - Modulo Receber, informação do modulo;

1. 1. 1. Carteira Pagar ou Receber,
    2. TTT - Remessa ou Retorno.

1. Tabelas

RET - Retorno.
Tabelas

criadas em Base de Dados.

O sistema irá criar as tabelas, para acessar as Para este processo, o release contemplará a estrutura das tabelas FOP, FOQ e FOZ. Para mais informações e características das tabelas, clique no link veja abaixo.:

2. Estrutura dos arquivos de configuração CNAB

.

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

Criação ou Alteração de Perguntas no arquivo SX1 – Cadastro de Perguntes:

Pergunte

(X1_PERGUNT)

Nome

Grupo

(X1_GRUPO)

Ordem

(X1_ORDEM)

Tipo

(X1_TIPO)

Tamanho

(X1_TAMANHO)

2. Criação ou Alteração de tabela no arquivo SX2– Tabelas:

Chave

Nome

Modo

PYME

B04

(X2_CHAVE)

Dente/Região

(X2_NOME)

C

(X2_MODO)

N

(X2_PYME)

3. Criação ou Alteração de Tabelas Genéricas no arquivo SX5 – Tabelas Genéricas:

Chave

Ex.: AR

Descrição

Ex.: Tabela de IR de Aplicações Financeiras

4. Criação ou Alteração (mantenha somente a instrução correspondente) de Campos no arquivo SX3 – Campos:

Tabela BGD - Prod x Cob x Proc x Co-Part:

Campo

(X3_CAMPO)

Tipo

(X3_TIPO)

Tamanho

(X3_TAMANHO)

Decimal

(X3_DECIMAL)

Formato

(X3_PICTURE)

Título

(X3_TITULO)

Descrição

(X3_DESCRIC)

Nível

(X3_NÍVEL)

Usado

(X3_USADO) Informe Sim ou Não

Obrigatório

(X3_OBRIGAT) Informe Sim ou Não

Browse

(X3_BROWSE) Informe Sim ou Não

Opções

(X3_CBOX)

When

(X3_WHEN)

Relação

(X3_RELACAO)

Val. Sistema

(X3_VALID)

Help

Descreva o conteúdo informado para Help de Campo no ATUSX

Importante:

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.

5. Criação ou Alteração de Consulta Padrão no arquivo SXB – Consulta Padrão:

Pesquisa B05PLS:

Alias	(XB_ALIAS)
Tipo	(XB_TIPO)
Sequência	(XB_SEQ)
Coluna	(XB_COLUNA)
Descrição	(XB_DESCRI)
Contém	(XB_CONTEM)

6. Criação ou Alteração de Índices no arquivo SIX – Índices:

Índice	AA1
Ordem	6
Chave	AA1_FILIAL+AA1_CODVEN
Descrição	Cod. Vendedor
Proprietário	S

7. Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:

Nome da Variável	(X6_VAR)
Tipo	(X6_TIPO)
Descrição	(X6_DESCRIC + X6_DESC1 + X6_DESC2)
Valor Padrão	(X6_CONTEUD)

8. Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:

Tabela BD5 – Contas Médicas:

Campo	Informe o conteúdo do (X7_CAMPO)
Sequência	Informe o conteúdo do (X7_SEQUENC)
Campo Domínio	Informe o conteúdo do (X7_CDOMIN)
Tipo	Informe o conteúdo do (X7_TIPO)
Regra	Informe o conteúdo do (X7_REGRA)
Posiciona?	Informe o conteúdo do (X7_SEEK)
Chave	Informe o conteúdo do (X7_CHAVE)
Condição	Informe o conteúdo do (X7_CONDIC)
Proprietário	Informe o conteúdo do (X7_PROPRI)

Procedimento para Configuração

(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou rotinas no menu).

CONFIGURAÇÃO DE PARÂMETROS

No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
(É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)

Itens/Pastas

Descrição

Nome:

Tipo:

Informe o Tipo do parâmetro

Cont. Por.:

Informe o Conteúdo padrão

Descrição:

CONFIGURAÇÃO DE MENUS

2. No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:

Menu	Informe o Menu em que estará localizada a rotina
Submenu	Informe o Submenu em que estará localizada a rotina
Nome da Rotina	Informe o Título da rotina
Programa	Informe o Fonte da rotina
Módulo	Informe o Nome do(s) produto(s) a ser utilizado ou “Todos”
Tipo	Informe a Função

Procedimento para Utilização

Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações:
Localização da rotina no menu;
Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;
Caso seja necessário ter algum cadastro feito previamente, faça uma observação.

Exemplo:

1. No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).

O sistema apresenta a janela de produtos cadastrados.

2. Posicione o cursor em um produto e clique em Alterar.

3. Na pasta Cobertura/Carências selecione a subpasta Tipo de Prestador.

Abaixo estão listados os bancos e arquivos homologados e disponíveis para download via assistente de configuração do CNAB:
Expandir
title Banco do Brasil
Expandir
title Contas a Pagar
Expandir
title Remessa
Versão Release Observação Data da Liberação
1.01 12.1.23 Arquivo CNAB Padrão Inicial
Liberado
Expandir
title Retorno
Versão Release Observação Data da Liberação
1.01 12.1.23 Arquivo CNAB Padrão Inicial
Liberado
Expandir
title Contas a Receber
Expandir
title Remessa
Versão Release Observação Data da Liberação
1.01 12.1.23 Arquivo CNAB Padrão Inicial
Liberado
Expandir
title Retorno
Versão Release Observação Data da Liberação
1.01 12.1.23 Arquivo CNAB Padrão Inicial
Liberado
Expandir
title Banco Santander
Expandir
title Contas a Pagar
Expandir
title Remessa
Versão Release Observação Data da Liberação
1.01 12.1.23 Arquivo CNAB Padrão Inicial
Liberado
Expandir
title Retorno
Versão Release Observação Data da Liberação
1.01 12.1.23 Arquivo CNAB Padrão Inicial
Liberado
Expandir
title Contas a Receber
Expandir
title Remessa
Versão Release Observação Data da Liberação
1.01 12.1.23 Arquivo CNAB Padrão Inicial
Liberado
Expandir
title Retorno
Versão Release Observação Data da Liberação
1.01 12.1.23 Arquivo CNAB Padrão Inicial
Liberado
Expandir
title Caixa Econômica
Expandir
title Contas a Pagar
Expandir
title Remessa
Versão Release Observação Data da Liberação
1.01 12.1.23 Arquivo CNAB Padrão Inicial
Liberado
Expandir
title Retorno
Versão Release Observação Data da Liberação
1.01 12.1.23 Arquivo CNAB Padrão Inicial
Liberado
Expandir
title Contas a Receber
Expandir
title Remessa
Versão Release Observação Data da Liberação
1.01 12.1.23 Arquivo CNAB Padrão Inicial
Liberado
Expandir
title Retorno
Versão Release Observação Data da Liberação
1.01 12.1.23 Arquivo CNAB Padrão Inicial
Liberado
Expandir
title Banco Bradesco
Expandir
title Contas a Pagar
Expandir
title Remessa
Versão Release Observação Data da Liberação
1.01 12.1.23 Arquivo CNAB Padrão Inicial
Liberado
Expandir
title Retorno
Versão Release Observação Data da Liberação
1.01 12.1.23 Arquivo CNAB Padrão Inicial
Liberado
Expandir
title Contas a Receber
Expandir
title Remessa
Versão Release Observação Data da Liberação
1.01 12.1.23 Arquivo CNAB Padrão Inicial
Liberado
Expandir
title Retorno
Versão Release Observação Data da Liberação
1.01 12.1.23 Arquivo CNAB Padrão Inicial
Liberado
Expandir
title Banco Itaú
Expandir
title Contas a Pagar
Expandir
title Remessa
Versão Release Observação Data da Liberação
1.01 12.1.23 Arquivo CNAB Padrão Inicial
Liberado
1.02 12.1.27 Arquivo CNAB com PIX Liberado
Expandir
title Retorno
Versão Release Observação Data da Liberação
1.01 12.1.23 Arquivo CNAB Padrão Inicial
Liberado
1.02 12.1.27 Arquivo CNAB com PIX Liberado
Expandir
title Contas a Receber
Expandir
title Remessa
Versão Release Observação Data da Liberação
1.01 12.1.23 Arquivo CNAB Padrão Inicial
Liberado
Expandir
title Retorno
Versão Release Observação Data da Liberação
1.01 12.1.23 Arquivo CNAB Padrão Inicial
Liberado
Expandir
title TCB - TOTVS Connect Bank (Em desenvolvimento)
Expandir
title Contas a Pagar
Expandir
title Remessa
Versão Release Observação Data da Liberação
1.01 12.1.23 Arquivo CNAB Padrão Inicial
Liberado
Expandir
title Retorno
Versão Release Observação Data da Liberação
1.01 12.1.23 Arquivo CNAB Padrão Inicial
Liberado

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

Para verificar a estrutura de nomenclatura dos arquivos de configuração CNAB, clique aqui .

4. Descrição do processo das telas Wizard

Deck of Cards

effectDuration	0.5
history	false
id	Wizard
effectType	fade

Card

default	true
id	1
label	Passo 1

Informe dos passos necessários para baixar / gerar arquivos CNAB.

Image Added

Card

id	2
label	Passo 2

Validação de Versão e Release Protheus e validação de acesso ao servidor de HLCloud (Hard Lock Cloud).

O cliente não terá acesso aos arquivos de configuração CNAB se a Release for inferior a 12.1.20 ou qualquer outro release futuro que for necessário incremento de dicionário publicado via release notes;
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 via Cloud ou que tenha qualquer restrição contratual que efetuar o bloqueio do mesmo.

Informações

title	Observação

Se todas as validações acima forem confirmadas pela rotina, o cliente estará apto para prosseguir com o assistente.

Image Added

Image Added

Image Added

Card

id	3
label	Passo 3

Processa e pesquisa na base de dados do cliente quais são os bancos ativos (tabela SA6) e exibe tela de seleção para escolha de qual(is) banco(s) serão gerados o(s) arquivo(s) CNAB.

Os bancos listados serão pesquisados na base de dados do cliente através da tabela SA6. Os bancos que estiverem bloqueados para uso não serão exibidos nesta tela.
O cliente poderá escolher quais os bancos deseja procurar por atualizações de configuração CNAB disponíveis.

Image Added

Card

id	4
label	Passo 4

Exibe respectivos os arquivos dos bancos selecionados, marcados com as legendas de acordo com a disponibilidade de download:

Os arquivos disponibilizados são somente para modelo 2 - 240 Posições;
Somente os segmentos obrigatórios foram mapeados e as alterações, tanto de inclusão de outros segmentos como atualizações que forem incrementadas, serão listados em novas versões;
Serão listadas ambas as carteiras - Contas a Pagar e Contas a Receber, de acordo com a disponibilidade de cada banco;
Serão listados os tipos de arquivos tanto de Remessa como de Retorno, de acordo com a disponibilidade de cada banco.

Image Added

Legenda verde = arquivo disponível para baixa;
Legenda vermelha = arquivo não disponível para baixa devido à necessidade de atualização para release superior. (Para a atualização de release, siga as instruções disponíveis em: Atualizador de dicionário e base de dados - UPDDISTR).

Image Added

Card

id	5
label	Passo 5

Processamento do download.

Neste passo será iniciado o processo de download dos arquivos de configuração CNAB. O sistema gravará as informações dos arquivos de configuração nas tabelas FOP, FOQ e FOZ.

Image Added

Card

id	6
label	Passo 6

Resultado do processamento.

O sistema informará sobre o resultado do processamento e as opções de geração ou edição dos arquivos de configuração CNAB.
Se optar pela finalização do processo, o assistente gerará os arquivos de configuração CNAB na pasta system. Para esta ação, clique no botão Finalizar.
Se optar pela edição dos arquivos de configuração CNAB, clique no botão Avançar.

Image Added

Ao clicar em Finalizar, será mostrada a Lista de Arquivos Baixados:

Image Added

Card

id	7
label	Passo 7

Escolha de arquivos de configuração CNAB para edição.

Nesta tela de seleção, será possível escolher qual(is) o(s) arquivo(s) deseja editar.

Após a marcação dos arquivos, clique em Avançar e o sistema disponibilizará as telas de edição.

Image Added

Card

id	8
label	Passo 8

Edição de conteúdo padrão do arquivo CNAB.

Nas telas de edição, existe o campo NOVO VALOR. Este só será preenchido pela opção da tecla "F3";
Ao acionar a tecla F3 , serão listadas as opções válidas para edição;
O campo CONTEUDO PADRÃO, traz a expressão padrão que será usada no arquivo de configuração;
Após escolher qual a valor será editado, o sistema irá alterar o valor da expressão do campo CONTEUDO PADRÃO com o novo valor;
As informações possíveis de edição por banco serão:
- Contas a Pagar / Remessa:
  - Campos data dos arquivos poderão ser alterados pelos campos data tabela SE2;
1. 1. - E2_EMISSAO;
    - E2_VENCTO;
    - E2_VENCREA.
  - Campos valor dos arquivos poderão ser alterados pelos campos valor tabela SE2;
    - E2_VALOR;
    - E2_SALDO;
    - E2_VLCRUZ.
  - Campo Nome Cedente, poderá ser alterado por outros campos da tabela SA2;
    - A2_NOME
    - A2_NREDUZ
- Contas a Receber / Remessa:
  - Campos data dos arquivos poderão ser alterados pelos campos data tabela SE1;
  - E1_EMISSAO;
  - E1_VENCTO;
  - E1_VENCREA.
- Campos valor dos arquivos poderão ser alterados pelos campos valor tabela SE1;
  - E1_VALOR;
  - E1_SALDO;
  - E1_VLCRUZ.
- Campo Nome Cliente, poderá ser alterado por outros campos da tabela SA1;
  - A1_NOME
  - A1_NREDUZ
- Contas a Pagar e Receber Retorno
  Para esses arquivos serão usadas as variáveis já disponíveis, são elas:
  - DATA;
  - DATACREDITO
  - VALOR;
  - DESPESAS;
  - DESCONTO;
  - JUROS;
  - ABATIMENTO;
  - MULTA;
  - IOF;
  - OUTROSCREDITOS;
  - OCORRENCIA;
  - RESERVADO;
  - SEGMENTO;
  - TITULO;
  - ESPECIE;
  - NOSSONUMERO;
  - AUTENTICACAO;
  - MOTIVO.

Image Added

Card

id	9
label	Passo 9

Finalização do processo.

Image Added

Ao clicar em "Avançar" para finalizar o processo, será mostrada a Lista de Arquivos Baixados:

Image Added

Aviso

title	Importante

Segmento/Modelo

Opções para os Segmentos de Remessa;

1. Segmento A e B
2. Segmento J
3. Segmento O
4. Segmento N
5. Segmento Z

Opções de Modelos por Segmento de Remessa Contas a Pagar;

1. Segmento A e Segmento B
  - Pagamentos efetuados por transferências de Conta Corrente para Conta Corrente do mesmo banco;
    - Modelo 01
  - Pagamentos efetuados por transferências de Conta Corrente para Conta Poupança;
    - Modelo 02.
  - Pagamentos efetuados por DOC;
    - Modelo 03.
  - Pagamentos efetuados por TED para outro CNPJ/CPF;
    - Modelo 41.
  - Pagamentos efetuados por TED mesmo Titular;
    - Modelo 42.
2. Segmento J
  - Pagamentos efetuados por boletos de outros bancos;
    - Modelo 30.
  - Pagamentos efetuados por boleto do mesmo banco;
    - Modelo 31. (Verificar particularidade Itaú)
3. Segmento O
  - Pagamentos efetuados a concessionárias que tenham Código de Barras, como:
    - Energia;
    - Telefone;
    - Agua;
    - Outros.
    - Pagamentos de tributos que tenham Código de Barras, como;
      - ISS;
      - FGTS;
      - Outros.
4. Segmento N
  - Pagamentos efetuados a todos os outros Tributos que não tenham código de barras, como:
    - DARF Simples;
    - Gare;
    - GTS;
    - Outros.
  - Pagamentos efetuados a outros tributos, como:
    - DPVAT;
    - IPVA;
    - Outros.
5. Segmento Z
  - 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.

5. Mais informações

4. Dê duplo clique no campo TP Prestador (BCW_TIPPRE).

O sistema apresenta a janela Tipo de Prestador – Coparticipação – Alterar.

5. Informe os dados conforme orientação do help de campo e observe o preenchimento do novo campo:

Som. p/Compra (BCW_SOMCOM): selecione Sim para indicar se a coparticipação cadastrada será válida somente para efeito de compra de procedimentos ou Não, caso contrário.

6. Confira os dados e confirme.

Vídeo

Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.

** Canal do youtube e software de vídeoem definição.

Título do Vídeo:	Disponibilizado pelo Marketing.
Introdução:	Disponibilizado pelo Marketing.
Passo a Passo:	Capturar diretamente do sistema.
Finalização:	Disponibilizado pelo Marketing.

Ponto de Entrada

Descrição:

Informe o Menu em que estará localizada a rotina

Localização:

Informe o Submenu em que estará localizada a rotina

Eventos:

Informe o Título da rotina

Programa Fonte:

Informe o Fonte da rotina

Função:

Informe o Nome do(s) produto(s) a ser utilizado ou “Todos”

Retorno:

Nome

Tipo

Descrição

Obrigatório

Exemplo:

#Include 'Protheus.ch'

User Function CN120ALT()

Local aCab:= PARAMIXB[1]

Local cTipo:= PARAMIXB[2]

If cTipo == '1'

aCab[4][2]:= 'NF' //Validações do usuário

EndIf

Return aCab

Árvore de páginas

Versões comparadas

Versão antiga 7

Nova versão Atual

Chave

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

Características

Linha de Produto:

Segmento:

Módulo:

Rotina:

Rotina

Nome Técnico

Rotina(s) envolvida(s)

Nome Técnico

País(es):

Banco(s) de Dados:

Tabelas Utilizadas:

Sistema(s) Operacional(is):

Descrição

1. Tabelas

criadas em Base de Dados.

2. Estrutura dos arquivos de configuração CNAB

Procedimento para Configuração

Procedimento para Utilização

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

4. Descrição do processo das telas Wizard

5. Mais informações

Vídeo

Ponto de Entrada