Histórico da Página
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 |
Nome | MV_ESTADO |
Tipo | Caracter |
Descrição | Sigla do estado da empresa usuário do sistema, para efeito de cálculo de ICMS |
Valor Padrão |
Itens/Pastas | Descrição |
Nome | MV_EXTQTHR |
Tipo | Numérico |
Descrição | Indica a quantidade de threads que será utilizada no Extrator. |
Valor Padrão | 5 |
Atualmente esse parâmetro é utilizado apenas para geração do registro T013 (Documentos Fiscais).
Para os bancos Oracle e DB2 o processamento é sempre realizado em Mono Thread, independente da configuração
realizada pelo usuário no parâmetro.
Itens/Pastas | Descrição |
Nome | MV_DIMPTAF |
Tipo | Caracter |
Descrição | Diretó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 |
Nome | MV_INTTAF |
Tipo | Caracter |
Descrição | Habilita a integração online do Backoffice com o TAF. |
Valor Padrão | S |
Somente deve ser habilitado se o SIGATAF for um MÓDULO do ERP. Em ambientes segregados não tem efeito.
Itens/Pastas | Descrição |
Nome | MV_SUBTRIB |
Tipo | Caracter |
Descrição | Este 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_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
Campo | FT_TAFKEY |
---|---|
Tipo | Caractere |
Tamanho | 100 |
Decimal | 0 |
Formato | @! |
Contexto | Real |
Propriedade | Visualizar |
Título | TAFKEY ST1 |
Descrição | TAFKEY 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. |
Usado | Sim |
Browse | Sim |
Obrigatório | Nã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 Banco | Neste 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 e movimentos inseridos/alterados no Protheus na base do TAF, porém somente alguns estão contemplados para este modelo. Cadastros/Movimentos contemplados:
Neste modelo de integração sempre que o usuário realizar a movimentação de um documento fiscal (Inclusão/Reprocessamento/Exclusão) os cadastros utilizados são gravados no TAF, abaixo a relação de cadastros que o TAF leva automaticamente quando utilizado no documento fiscal:
Movimentações que são enviadas nativamente ao TAF:
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:"
- 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:
Grupo | EXTFISXTAF |
Ordem | 1 |
Pergunta | Diretório do Arquivo Destino |
Tipo | C |
Tamanho | 50 |
Help | Informe o Diretório destino do arquivo. Não utilizado no Schedule. |
Objeto | Edit |
Grupo | EXTFISXTAF |
Ordem | 2 |
Pergunta | Nome do Arquivo Destino |
Tipo | C |
Tamanho | 20 |
Help | Informe o nome destino do arquivo. Não utilizado no Schedule. |
Objeto | Edit |
Grupo | EXTFISXTAF |
Ordem | 3 |
Pergunta | Date de |
Tipo | D |
Tamanho | 8 |
Help | Informe a data início a ser considerada na extração dos dados. |
Objeto | Edit |
Grupo | EXTFISXTAF |
Ordem | 4 |
Pergunta | Data ate |
Tipo | D |
Tamanho | 8 |
Help | Informe a data final a ser considerada na extração dos dados. |
Objeto | Edit |
Grupo | EXTFISXTAF |
Ordem | 5 |
Pergunta | Seleciona Filiais? |
Tipo | C |
Tamanho | 1 |
Help | Informe se irá selecionar as filiais para processamento ou se irá considerar apenas filial corrente. Não utilizada para Schedule. |
Objeto | Combo |
Cont. Combo | - Sim - Não |
Grupo | EXTFISXTAF |
Ordem | 6 |
Pergunta | Período da Apuração de IPI? |
Tipo | C |
Tamanho | 1 |
Help | Período da Apuração de IPI: - Mensal; - Decendial. |
Objeto | Combo |
Cont. Combo | - Mensal - Decendial |
Grupo | EXTFISXTAF |
Ordem | 7 |
Pergunta | Incidência Tributaria Período |
Tipo | C |
Tamanho | 1 |
Help | Incidência tributário no período: - Regime não-cumulativo; - Regime cumulativo; - Regimes não-cumulativo e cumulativo. |
Objeto | Combo |
Cont. Combo | - Reg. não-cumula - Reg. Cumulativo - Ambos |
Grupo | EXTFISXTAF |
Ordem | 8 |
Pergunta | Ini. Obrig. Escrit. Fisc. CIAP |
Tipo | C |
Tamanho | 1 |
Help | Início Obrigação Escrituração Fiscal CIAP: - Sim; - Não. Se Sim os registros T050AC e T050AD são gerados para todos os bens com movimentação do ativo imobilizado (campo TIPO_MOV do registro T050AA igual a SI). |
Objeto | Combo |
Cont. Combo | - Sim - Não |
Grupo | EXTFISXTAF |
Ordem | 9 |
Pergunta | Seleciona Layouts? |
Tipo | C |
Tamanho | 1 |
Help | Informe se irá selecionar os layouts para processamento ou se considerará todos os layouts. Não utilizada para Schedule. |
Objeto | Combo |
Cont. Combo | - Sim - Não |
Grupo | EXTFISXTAF |
Ordem | 10 |
Pergunta | Produto Inicial |
Tipo | C |
Tamanho | 15 |
Help | Informe o código de produto início a ser considerado na extração dos dados. Utilizado para processamento do Inventário. |
Objeto | Edit |
Grupo | EXTFISXTAF |
Ordem | 11 |
Pergunta | Produto Final |
Tipo | C |
Tamanho | 15 |
Help | Informe o código de produto final a ser considerado na extração dos dados. Utilizado para processamento do Inventário. |
Objeto | Edit |
Grupo | EXTFISXTAF |
Ordem | 12 |
Pergunta | Armazém Inicial |
Tipo | C |
Tamanho | 2 |
Help | Informe o código de armazém início a ser considerado na extração dos dados. Utilizado para processamento do Inventário. |
Objeto | Edit |
Grupo | EXTFISXTAF |
Ordem | 13 |
Pergunta | Armazém Final |
Tipo | C |
Tamanho | 2 |
Help | Informe o código de armazém final a ser considerado na extração dos dados. Utilizado para processamento do Inventário. |
Objeto | Edit |
Grupo | EXTFISXTAF |
Ordem | 14 |
Pergunta | Cons. saldo De/Em Terceiros |
Tipo | C |
Tamanho | 1 |
Help | Considera o saldo De/Em poder de Terceiros: - Sim. - Não. - De Terceiros. - Em Terceiros. Utilizado para processamento do Inventário. |
Objeto | Combo |
Cont. Combo | - Sim - Não - De Terceiros - Em Terceiros |
Grupo | EXTFISXTAF |
Ordem | 15 |
Pergunta | Cons. saldo em processo |
Tipo | C |
Tamanho | 1 |
Help | Considera saldo em processo: - Sim. - Não. Utilizado para processamento do Inventário. |
Objeto | Combo |
Cont. Combo | - Sim - Não |
Grupo | EXTFISXTAF |
Ordem | 16 |
Pergunta | Motivo do Inventario |
Tipo | C |
Tamanho | 2 |
Help | Motivo do Inventário: - Final do período. - Mudança de trib. da mercadoria (ICMS). - Solic. da baixa cad., paral. temp. e outras. - Na alteração de regime de pagamento. - Por determinação dos fiscos. Utilizado para processamento do Inventário. |
Objeto | Combo |
Cont. Combo | - Final período - Mud. Trib. ICMS - Sol. baixa cad. - Alt. Reg. Pag. - Determ.fiscos |
Grupo | EXTFISXTAF |
Ordem | 17 |
Pergunta | Nome arq. Reg. Inv. Mod.7 |
Tipo | C |
Tamanho | 8 |
Help | Informe o nome do arquivo gerado pelo relatório Reg. Invent. Mod. 7(MATR460). Utilizado para processamento do Inventário. |
Objeto | Edit |
Grupo | EXTFISXTAF |
Ordem | 18 |
Pergunta | Data de fechamento do estoque |
Tipo | D |
Tamanho | 8 |
Help | Data de fechamento do estoque. Utilizado para processamento do Inventário. |
Objeto | Edit |
Grupo | EXTFISXTAF |
Ordem | 19 |
Pergunta | Cod. Rec. prestação serviços |
Tipo | C |
Tamanho | 6 |
Help | Informe o código da receita para prestação de serviços. |
Objeto | Edit |
Grupo | EXTFISXTAF |
Ordem | 20 |
Pergunta | Cod. Rec.demais operações |
Tipo | C |
Tamanho | 6 |
Help | Informe o código da receita para demais operações. |
Objeto | Edit |
Grupo | EXTFISXTAF |
Ordem | 21 |
Pergunta | Período Job |
Tipo | C |
Tamanho | 1 |
Help | Informe se o Job está agendado para ser executado diariamente ou mensalmente. Utilizado apenas no Schedule. |
Objeto | Combo |
Cont. Combo | - Diário - Mensal |
Grupo | EXTFISXTAF |
Ordem | 22 |
Pergunta | Data Job Mensal |
Tipo | C |
Tamanho | 1 |
Help | Informe a data a ser considerada para Job executado mensalmente: - Considera Data De/Até. - Primeiro Dia até Data Corrente. - Mês anterior. Utilizado apenas para o Schedule. |
Objeto | Combo |
Cont. Combo | - Cons. Dt De/Ate - 1º Dia a Dt. Dia - Mês Anterior |
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.
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
- 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:
- Acessa a rotina MATA010 - Cadastro de Produtos ( tabela SB1 );
- Realiza inclusão de novo produto e confirma;
- Caso parâmetro MV_INTTAF = S esse produto será enviado automaticamente para a base do TAF;
- Acessa a rotina TAFA067 - Cadastro de Itens/Serviços ( tabela C1L ) e verifica que o produto foi integrado com sucesso.
- 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:
- Acessa a rotina MATA103 - Documento Fiscal de Entrada;
- Realiza inclusão de novo documento fiscal e confirma;
- 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;
- 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;
- 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;
- orientamos que qualquer alteração de cadastros e movimentos deve ser realizada no sistema de origem, e enviado novamente para a base do TAF.
- Na sequência inicia-se a etapa 3 do fluxo.
- 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:
- Os dados da tabela TAFST2 são integrados para a base oficial do TAF;
- 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;
- Acesse as rotinas dos cadastros que foram enviados do Protheus para o TAF e verifique que foram integrados com sucesso.