Procedimentos de Atualização

Acessar a página de Downloads e Atualizações no Portal de Suporte TOTVS:

Em "Lista de Produto" selecionar "Protheus";

Em "Software", selecionar "Todos";

No campo de "pesquisa" digite extrator e clique em pesquisar:

Em "Arquivo", selecionar o Extrator Fiscal ( PACOTE DE CORREÇÃO ) de acordo com o release do seu ambiente:

Procedimentos de Configuração

• No Configurador (SIGACFG) acesse Ambiente/ Cadastros/ Parâmetros e verifique os parâmetros a seguir:

Atualmente esse parâmetro é utilizado apenas para geração do registro T013 (Documentos Fiscais).

Essa configuração só funciona para os bancos SQL, Oracle e DB2.

Com outro bancos o processamento sempre será realizado em Mono Thread, independente da configuração

realizada pelo usuário no parâmetro.

Esse parâmetro deve ser utilizado no modelo de integração utilizando arquivo texto, pois será utilizado para indicar o diretório de geração dos arquivos.

Exemplo de preenchimento: E:/TAF_Files/

Somente deve ser habilitado se o SIGATAF for um MÓDULO do ERP. Em ambientes segregados não tem efeito.

Caso o parâmetro MV_SUBTRIB não seja suficiente para detalhar todas as Inscrições Estaduais da empresa, deverão ser criados parâmetros com

nome MV_SUBTRI e final numérico sequencial para acrescentar as demais inscrições. Exemplo: MV_SUBTRI2, MV_SUBTRI3, etc.

Em uma nova perspectiva, criamos a tabela CLO, Cadastro de Inscrição Estadual.

Desta forma, quem não quiser utilizar o parâmetro, poderá utilizar o cadastro, para isso basta incluir as Inscrições e deixar o parâmetro em branco.

• No Configurador (SIGACFG) acesse Base de Dados/ Dicionário/ Base de Dados e verifique os campos a seguir:

Criação de Campos no arquivo SX3 – Campos: Tabela SFT - Itens do Livro Fiscal

Configurações necessárias para integração com o TOTVS Automação Fiscal

• Atualização do ambiente - Versão 12
• Wizard de Configuração
• Cadastre o complemento de empresa

Procedimentos de Utilização

O Extrator pode ser utilizado tanto na execução via Menu quanto pela execução via Schedule (Para Mais detalhes acesse Schedule Protheus ), por se tratar de uma funcionalidade que tem como objetivo extrair todos os movimentos fiscais sugerimos que o processamento seja sempre via Schedule( Sendo processado uma ou mais vezes por dia ), caso contrário é provável que o processamento se torne muito oneroso devido a grande quantidade de informações que o cliente possui na base de dados, por exemplo:

Vamos imaginar que um cliente possua uma movimentação de 1.000 Notas por dia, sendo assim, no final de um mês de 30 dias ele teria 30.000 notas fiscais na base de dados, caso esse cliente gere o Extrator Fiscal apenas no dia 30 processando o período do dia primeiro em diante o processamento será oneroso pois a massa de dados é muito grande. Porém, caso o cliente opte pela geração do extrator via Schedule, uma vez ao dia temos um cenário onde ao final do mês teríamos todas as informações integradas de forma rápida e prática.

Seguindo com este documento iremos demonstrar ambos formatos de configuração e geração do extrator.

Existem três modelos de integração disponíveis para a Extração das informações Fiscais do Protheus:

Em Livros Fiscais acesse Miscelanea / Arq.Magnéticos / Extrator Fiscal ( EXTFISXTAF ).

O extrator fiscal é a ferramenta necessária para integração com o TAF, seja execução via menu ou via Schedule. Nesse documento, iremos tratar da utilização da wizard via menu. Para mais informações pode acessar nosso vídeo How To clicando aqui.

Em ambos modelos de extração (TXT ou Banco a Banco) existem parametrizações que são informadas pelo usuário para a execução da rotina:

A wizard foi separada em 4 (quatro) etapas conforme ilustrado abaixo:

• Etapa 1 - Parâmetros

A etapa 1 é separada por abas. As abas superiores são separadas por Parametrização, indicada na figura pela letra A, e Configuração do Sistema, indicada por B.

Abaixo apresentaremos a segunda aba: Configuração do Sistema (B):

Essa aba é apenas informativa e é por este motivo que seus campos são somente para visualização.

O objetivo é demonstrar os parâmetros do sistema (SX6) utilizados na extração. Com isso, é possível, por exemplo, verificar se a integração on-line com o TAF (MV_INTTAF) está ativa ou não.

A seguir iremos descrever a primeira aba: Parametrização (A):

Na parte superior são apresentados 3 (três) campos: "Tipo de Saída" (1), "Diretório do Arquivo Destino" (2) e "Nome do Arquivo Destino" (3).

• Tipo de Saída (1):

A extração fiscal possui duas opções de extração via wizard: 1 - Arquivo TXT e 2 - Banco de Dados.

• • Opção "1 - Arquivo TXT":

A opção "1 - Arquivo TXT" a wizard irá liberar os campos: "Diretório do Arquivo Destino" (2) e "Nome do Arquivo Destino" (3) para serem preenchidos pelo usuário. Esses campos tornam-se obrigatórios para avançar na wizard.

Caso esses campos não sejam preenchidos, uma mensagem de atenção será apresentada ao usuário informando que o preenchimento desses campos é obrigatório.

Abaixo iremos detalhar os campos descritos acima:

• • Diretório do Arquivo Destino (2):

Neste campo será informado o caminho no qual será gravado o arquivo TXT na conclusão da extração. É possível utilizar a consulta padrão (F3) para selecionar o caminho:

• • Nome do Arquivo Destino (3):

Neste campo será informado o nome do arquivo TXT que será gerado. Ao escrever o nome não é necessário informar a extenção .txt.

• • Opção "2 - Banco de Dados":

Ao selecionar a opção "2 - Banco de Dados", o sistema irá fazer a integração através das tabelas: TAFST1 ou TAFST2, caso a integração on-line com o TAF esteja ativa (MV_INTTAF = S).

Com isso, a wizard irá bloquear os campos: "Diretório do Arquivo Destino" (2) e "Nome do Arquivo Destino" (3).

Na parte inferior da aba Parametrização (A) a wizard é dividida em 7 (sete) abas, são elas: Geração (C), Movimento (D), Apuração/SPED (E), Inventário (F), Financeiro (G), Contribuinte (H) e Empresa Software (I).

• Aba "Geração" (C):

Na aba "Geração" (C) são apresentados os campos comuns a praticamente todos os layouts.

Abaixo os campos serão detalhados sobre o preenchimento.

• • Data de (4) e Data até (5):

Nestes campos serão informadas a data inicial e data final do período desejado para extração do Protheus.

Existem alguns layouts que são gerados apenas se informado o período fiscal de um mês, as apurações são um exemplo deste tipo de layout. Por isso, caso não seja informado um período fiscal de um mês, no momento que o usuário avançar para a próxima etapa na wizard, o sistema irá alertar o usuário com a mensagem abaixo:

Assim, no momento da seleção dos layouts (este procedimento será apresentado posteriormente) não será possível selecionar os layouts mensais.

• • Verifica Momento para os Layouts Cadastrais (6):

Este campo informa se, para os layouts cadastrais como, por exemplo, o layout T007 (Identificação do Item (Produto/Serviços)), deve extrair somente os cadastros que possuem movimentação no período informado ou se serão gerados todos os cadastros independente se houve ou não movimentações no período.

• • • Opção "1 - Não":

Ao selecionar esta opção, a mensagem abaixo será apresentada ao usuário. Esta mensagem alerta o usuário de que serão exportados todos os cadastros, independente de terem ou não movimentação no período, exceto cadastros bloqueados ou não ativos.

• • • Opção "2 - Sim":

Já ao selecionar a opção 2 o sistema apresenta a mensagem abaixo informando que serão considerados apenas os cadastros que possuem movimentação amarrada no período selecionado para extração. Neste caso cadastros bloqueados ou não ativos serão exportados.

Por exemplo, um produto será somente enviado caso o mesmo possua um documento fiscal (SFT) atrelado a ele nas regras cadastradas na aba "Movimentos" (D) e no período informado para geração.

• • Centralizar Apurações e Totalizadores em uma Única Filial (7):

Este campo informa se a extração das apurações e totalizadores será centralizada em uma única filial.

• Aba "Movimento" (D):

Na aba "Movimento" (D) serão apresentados os campos referentes aos movimentos.

Abaixo os campos serão detalhados sobre o preenchimento.

• • Tipo de Movimento (8):

Este campo identifica se serão considerados apenas movimentos de entrada (Opção 2) ou apenas movimentos de saída (Opção 3) ou ambos movimentos (Opção 1).

• • Nota Fiscal De (9) e Nota Fiscal Até (10):

Nestes campos deverão ser informadas as numerações iniciais e finais dos documentos fiscais (SFT) que serão consideradas durante a extração.

• • Série De (11) e Série Até (12):

Nestes campos deverão ser informadas as séries iniciais e finais referentes aos documentos fiscais (SFT). Estes campos possuem consulta padrão (F3) para facilitar o preenchimento, com isso a tela abaixo será apresentada:

• • Espécie do Documento (13):

Neste campo deverá ser informado as espécies que serão filtradas na extração. Caso este campo não seja preenchido, o extrator considerará todas as espécies.

Este campo também possui consulta padrão para facilitar o preenchimento, conforme abaixo:

• Aba "Apuração / SPED" (E):

Na aba "Apuração / SPED" (E) serão apresentados os campos referentes às Apurações e aos EFD ICMS/IPI e Contribuições.

Abaixo os campos serão detalhados sobre o preenchimento.

• • Período da Apuração de IPI (14):

Informar neste campo o tipo do período de apuração de IPI: Mensal (Opção 0) ou Decendial (Opção N).

Para ilustrar as perguntas acima, a wizard apresentará o painel abaixo:

• Filtro para que o usuário indique qual o rangue de produtos que seja extrair do Protheus, informações aplicadas para extração de dados do inventário( Bloco H do Sped Fiscal ).
• Filtro para que o usuário indique qual o rangue de armazens que seja extrair do Protheus, informações aplicadas para extração de dados do inventário( Bloco H do Sped Fiscal ).
• Indica se considera saldo em poder de terceiros na extração,  informações aplicadas para extração de dados do inventário( Bloco H do Sped Fiscal ).
• Indica se considera saldo em processo,  informações aplicadas para extração de dados do inventário( Bloco H do Sped Fiscal ).
• Indica qual o motivo do Inventário,  informações aplicadas para extração de dados do inventário( Bloco H do Sped Fiscal ).
• Indica o nome do arquivo gerado na emissão do relatório P7 do Protheus para extração das informações de inventário:
• Indica a data de fechamento do estoque
• Indica o modelo de geração do Registro 0210 ( por movimento ou por estrutura? ) - utilizado na geração do Layout T045 do TAF ( que representa o Bloco K da EFD ICMS/IPI )

Para ilustrar as perguntas acima, a wizard apresentará o painel abaixo:

Indica os códigos de receita quando existirem:

Seleção de Filiais Quando solicitada:

Seleção de Layout Quando solicitado:

Extração automática

Ao realizar a configuração da extração via Schedule o usuário terá a opção de configurar os parâmetros de geração, as informações solicitadas são exatamente as mesmas que citadas acima em "Parâmeros de Geração do Extrator:"

• Para configuração do extrator via schedule é imprescindível que existam as perguntas abaixo no dicionário de dados. Para verificar acesse o Configurador (SIGACFG) em Base de Dados/ Dicionário/ Perguntas e verifique conforme a seguir:

Existem apenas dois campos que não existem na Wizard de geração pelo Menu pois são específicas configurações de Schedule, são eles:

• Período Job
• Data Job Mensal

O usuário tem a possibilidade de selecionar qual o período que será extraído da base de dados, quando selecionada a opção "Diário" o processamento irá realizar a extração das informações do dia em que está sendo executado, quando seleciona a opção "Mensal" o próximo parâmetro que irá indicar o período de geração.

Quando selecionada a opção "Diário" no parâmetro acima o usuário tem a possibilidade de definir qual o período que deseja considerar para a execução do extrator, sendo:

• Cons. Dt De/Até: Considera o processamento de acordo com as datas informadas nos parâmetros "Data De" e "Data Até"
• 1º Dia à Dt. dia: Considera o processamento do primeiro dia do mês corrente até a data corrente.
• Mês Anterior: Considera o mês anterior ao período de processamento indicado nos parâmetros "Data De" e "Data Até"

Para maiores detalhes de configuração do Schedule acesse Schedule Protheus

Sugestão de Configuração da Extração Fiscal

Conforme mencionamos no decorrer deste documento a Totvs sugere aos nossos clientes a seguinte parametrização de extração:

Configurar um Schedule de periodicidade diária, este processamento irá considerar apenas os cadastros e movimentos ocorridos na data de execução.

Configurar para que o Schedule seja executado três vezes ao dia, conforme abaixo:

Assim garantimos que todas as movimentações serão integradas diariamente.

Após o término do período fiscal (Mês) o usuário deve executar manualmente pelo Menu a extração das informações de todo o período selecionando apenas as apurações que desejar:

Executa a rotina do extrator pelo Menu e Indica que deseja selecionar os Layouts a serem processados, neste caso seleciona apenas os Layouts de Apuração:

Registros de Apuração:

• T020 - Apuração e/ou Sub-Apuração do ICMS
• T021 - Apuração de ICMS ST
• T022 - Apuração de IPI
• T045 - Apuração da Produção/Estoque ( Bloco K )
• T051 - Apuração da DIFAL/FECP
• T079 - Inventário
• T082 - Contribuição Previdenciária sobre Receita Bruta ( CPRB )

Realizando a configuração das extrações conforme citamos acima o usuário terá sempre uma integração rápida e manterá o ambiente do TAF  atualizado de acordo com as últimas alterações realizadas no Protheus.

Após realizar a configuração da extração dos dados do ERP Protheus os clientes devem realizar a configuração das integrações em TAF - Efetue uma integração.

Integração Online Protheus x TAF

Visando atender ambientes que utilizam O TOTVS Automação Fiscal como módulo do Protheus, foram disponibilizadas funcionalidades para que todo cadastro e movimentação seja integrada de forma automática e transparente, garantindo a integridade de informações do ERP com o TAF e agilizando a entrega das obrigações acessórias.

Para habilitar esta funcionalidade é premissa que seja habilitado o parâmetro MV_INTTAF ( preenchido com o conteúdo "S" ) e o campo FT_TAFKEY deve existir na base de dados ( disponível a partir do release 12.1.14 ).

As rotinas que abrangem a integração online são:

Fluxo da Funcionalidade

1. Sempre que confirmar uma operação nas rotinas de cadastros do Protheus ( listagem acima ), o sistema fará a integração automática dos dados para a base oficial do TOTVS Automação Fiscal. Por exemplo:
   1. Acessa a rotina MATA010 - Cadastro de Produtos ( tabela SB1 );
   2. Realiza inclusão de novo produto e confirma;
   3. Caso parâmetro MV_INTTAF = S esse produto será enviado automaticamente para a base do TAF;
   4. Acessa a rotina TAFA057 - Cadastro de Itens/Serviços ( tabela C1L ) e verifica que o produto foi integrado com sucesso.
2. Sempre que confirmar uma operação nas rotinas de documentos fiscais do Protheus ( listagem acima ) , o sistema fará a integração automática dos dados para a tabela compartilhada TAFST2. Por exemplo:
   1. Acessa a rotina MATA103 - Documento Fiscal de Entrada;
   2. Realiza inclusão de novo documento fiscal e confirma;
   3. Caso exista na base de dados o campo FT_TAFKEY e o parâmetro MV_INTTAF = S, será startado novo processo ( thread ) onde o documento e todos os cadastros relacionados serão enviados para a tabela TAFST2;
      1. só serão enviados os cadastros que são realmente necessários, ou seja, que não existem no TAF ou que existem no TAF mas possuem alguma informação divergente;
      2. caso algum cadastro tenha sido alterado manualmente no TAF e essa alteração não tenha sido replicada no Protheus, neste momento o sistema entenderá que o registro precisa ser integrado novamente e a alteração realizada manualmente no TAF será perdida;
      3. orientamos que qualquer alteração de cadastros e movimentos deve ser realizada no sistema de origem, e enviado novamente para a base do TAF.
      4. Importante: para a emissão de documentos eletrônicos( Modelos 55 - Nota Fiscal Eletrônica, 57 - Conhecimento de Transporte Eletrônico e 65 - Cupom Eletrônico ) o envio ao TAF será realizado apenas quando o TSS retornar com o status de documento validado e assinado, ou seja, no mesmo instante em que o campo FT_CHVNFE for gravado no livro fiscal o sistema irá abrir uma thread para integração da nota ao TAF.
   4. Na sequência inicia-se a etapa 3 do fluxo.
3. Depois que a movimentação foi enviada para a tabela TAFST2 inicia-se, no mesmo processo ( thread ), a integração dos dados para a base Oficial do TAF. Dando sequencia ao exemplo da etapa 2:
   1. Os dados da tabela TAFST2 são integrados para a base oficial do TAF;
   2. Acesse as rotinas de documento fiscal ( TAFA062S para notas de saída e TAFA062E para notas de entrada ) e verifique que o documento foi integrado com sucesso;
   3. Acesse as rotinas dos cadastros que foram enviados do Protheus para o TAF e verifique que foram integrados com sucesso.

Informações Técnicas

Clique aqui para informações detalhadas sobre o Layout TOTVS.

Registro gerados pela rotina de extração do módulo Livros Fiscais:

Centralização de Filiais

Quando o Protheus possuir no cadastro de empresas dois ou mais registros com a mesma chave ( Código da Empresa + CNPJ + Inscrição Estadual + Código do Município + Inscrição Municipal ) a extração fiscal deve ser realizada utilizando o conceito de CENTRALIZAÇÃO.  

Para realizar o processamento CENTRALIZADO o usuário deve logar na filial responsável pelas apurações de impostos( ICMS, IPI, PIS, COFINS, ISS, etc ) e definir "Sim" para a pergunta abaixo na Wizard:

 Avançando será aberta a tela abaixo, o usuário deve selecionar as filiais à serem consideradas na extração, o sistema ira fazer uma análise do ambiente e sugerir na coluna "Sugestão de Extração" se a filial deve ou não ser CENTRALIZADA:

 Caso o usuário execute a extração em desacordo com a sugestão do sistema será exibida uma mensagem alertando-o sobre os possíveis problemas que podem ocorrer na geração das obrigações acessórias no TAF:

Lembrando que antes de realizar a integração das informações extraídas com o TAF o cliente deve configurar o cadastro de complemento de empresas seguindo a mesma regra adotada na extração !