Árvore de páginas

Versões comparadas

Chave

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

Extrator Fiscal x TAF

Produto:

Microsiga Protheus

Versões:

11 e 12

Ocorrência:

Manual do Extrator Livros Fiscais x TAF

Índice

Passo a Passo

Neste Tópico iremos demonstrar aos clientes como realizar a geração do Extrator Fiscal do ERP Protheus para integração com o TAF, além de fornecer algumas informações importantes para garantir a melhor utilização da funcionalidade.

Através desta funcionalidade é possível extrair todas as informações fiscais do Protheus afim de posteriormente integrá-las ao TAF, para verificar quais as informações extraídas basta analisar o arquivo Layout Único Atual.

O Extrator Fiscal está disponível aos clientes que possuem o Protheus da versão 11.50 em diante e que possuem licença para utilização do módulo SIGAFIS ( Fiscal ).

 

Procedimentos de Configuração

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

Itens/Pastas

Descrição

NomeMV_ESTADO
TipoCaracter
DescriçãoSigla do estado da empresa usuário do sistema, para efeito de cálculo de ICMS
Valor Padrão 

Itens/Pastas

Descrição

NomeMV_EXTQTHR
TipoNumérico
DescriçãoIndica a quantidade de threads que será utilizada no Extrator.
Valor Padrão5

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

(aviso) Para banco de dados ORACLE, este parâmetro deve ser sempre preenchido com 0 ( zero ).

 

Itens/Pastas

Descrição

NomeMV_DIMPTAF
TipoCaracter
DescriçãoDiretório onde deverão ser gerados os arquivos de integração com o TAF.
Valor Padrão(vazio)

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/

 

Itens/Pastas

Descrição

NomeMV_INTTAF
TipoCaracter
Descrição

Habilita a integração online do Backoffice com o TAF.

Valor PadrãoS

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

 

Itens/Pastas

Descrição

NomeMV_SUBTRIB
TipoCaracter
DescriçãoEste parâmetro deve conter a Inscrição Estadual do contribuinte no Estado em que houver substituição tributária.
Valor Padrão 
Exemplo

SC123456789/RJ99999999/

As inscrições estaduais devem estar separadas por barras (/).

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_SUBTRI2MV_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

CampoFT_TAFKEY
TipoCaractere
Tamanho100
Decimal0
Formato@!
ContextoReal
PropriedadeVisualizar
TítuloTAFKEY ST1
 DescriçãoTAFKEY Integ Nativa TAF
Help    Flag de integração banco a banco com o TAF pelas tabelas ST1/ST2. O conteúdo deste campo é o mesmo dos campos TAFKEY das tabelas ST1 e ST2  do TAF.
UsadoSim
BrowseSim
ObrigatórioNão

 

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:

TXT

Neste modelo é gerado um arquivo texto no local indicado pelo usuário com as informações extraídas da base

de dados, com esse arquivo é possível realizar posteriormente a integração no TAF.

Banco a BancoNeste modelo as informações processadas pelo Extrator são geradas diretamente em uma tabela no Banco de Dados (TAFST1)




Extração Nativa

Este modelo de integração é complementar aos dois citados acima, pois realiza a gravação direta dos cadastros

inseridos/alterados no Protheus na base do TAF, porém somente alguns cadastros estão contemplados para este modelo.

Cadastros contemplados:

  • Unidade de Medida
  • Produto
  • Cliente
  • Fornecedor
  • Transportadora

Este modelo de integração apenas pode ser utilizado por clientes que utilizam o TAF como um módulo do ERP Protheus

com o parâmetro MV_INTTAF habilitado no Configurador( conteúdo "S" ), clientes que utilizam outros cenários devem

escolher entre os outros dois modelos citados acima.

Mais informações na seção "Integração Online Protheus x TAF".

Importante

As integrações não são exclusivas, ou seja, o usuário pode utilizar os três modelos de integração em seu ambiente de acordo com a sua necessidade ou optar pela utilização de apenas um único modelo.


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

 

Importante

Quando a extração está utilizando Schedule também existe esta mesma pergunta para que o usuário indique qual o tipo de extração que deseja realizar. A Totvs recomenda aos clientes a utilização do modelo Banco a Banco na extração das informações pois independe da geração de arquivo texto, o processo todo é executado sem a necessidade de interação do usuário, desde a extração até a inclusão no TAF.

 

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, sendo elas:

 

  • Diretório do arquivo a ser gerado e Local de Geração: (Quando Geração via TXT )
  • Data Inicial e Final do período que deseja extrair do Protheus:
  • Indica se o usuário deseja que sejam selecionadas as filiais de processamento
  • Indica a periodicidade de geração da apuração de IPI do cliente:
  • Indica qual o regime tributário utilizado pelo cliente:
  • Indica se o mês de extração é o mês de inicio da geração da escrituração Fiscal do CIAP:
  • Indica a seleção de Layouts. O usuário tem a possibilidade de gerar movimentos / cadastros específicos de acordo com sua necessidade, caso deseje gerar todas as informações fiscais do período selecione "Não", caso contrário será aberta uma tela após confirmar a Wizard para selecionar quais informações deseja gerar:
  • O usuário deve selecionar qual o modelo de integração que deseja executar ( TXT ou Banco a Banco )
  • Filtro para que o usuário indique qual o range de notas fiscais que deseja extrair do Protheus

 

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:

 

Importante

O usuário deve sempre se atentar ao período que está sendo gerado e a relação com os layouts solicitados para geração, quando solicitada a geração de apurações, por exemplo, o período solicitado na extração deve ser todo o período fiscal, nos casos de movimentos sugerimos que o usuário crie um Schedule para extração diária das informações.

 

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:"


 

 

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:

 

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.

 

Importante

Caso por qualquer necessidade o usuário precise reprocessar as movimentações referentes a um determinado dia que já foi processado pelo Schedule ele deve através do extrator (via menu) realizar a geração, se atentando para selecionar apenas os layouts desejados.

 

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 ( na versão 12 disponível a partir do release 12.1.14, na versão 11 deve ser criado com o update U_UPDSIGAFIS ).

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

MATA010 - Cadastro de Produtos
MATA020 - Cadastro de Fornecedores
MATA030 - Cadastro de Clientes
MATA050 - Cadastro de Transportadoras
QIEA030 - Cadastro de Unidade de Medida

MATA103 - Documento Fiscal de Entrada

MATA116 - Conhecimento de Frete 

MATA119 - Documento Fiscal de Importação

MATA461 - Documento Fiscal de Saída

MATA521 - Exclusão Documento Fiscal de Saída 

MATA910 - Nota Fiscal Manual de Entrada

MATA920 - Nota Fiscal Manual de Saída

MATA926 - Complementos Fiscais do Documento

MATA930 - Reprocessamento do Livro Fiscal

 

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 TAFA067 - 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. 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.