O TAF ( TOTVS Automação Fiscal ) foi criado com o objetivo de consolidar dados e layouts, a fim de fornecer recursos de validação e consistências desses dados para posterior envio as plataformas governamentais.
Este documento visa fornecer as especificações técnicas para que os softwares de gestão possam iniciar integração com o TAF.
O software controlador dos processos empresarias gerará uma mensagem eletrônica contendo as informações fiscais, contábeis e trabalhistas, no formato pré-definido pela TOTVS, de maneira a garantir a integridade dos dados. Esta mensagem eletrônica será então submetida a processos de integração e validação de estrutura, com o intuito de consistir integridade e conteúdo da mensagem, definindo assim se esta está apta a ser importada ao sistema consolidador.
Após receber todos os dados necessários, o TAF submete as informações importadas a outros processos como validação e consistência de layout. O objetivo final é gerar os dados para importação/transmissão dos arquivos em formato pré-definido pela Secretaria de Fazenda Estadual de jurisdição do contribuinte emitente, Prefeitura ou Receita Federal.
De forma resumida existem quatro modelos de integração disponíveis para integração:
Qualquer ERP( Totvs e não Totvs ) é elegível de integração com o TAF, basta desenvolver a mensagem de integração baseada no Layout Único de Integração.
Para geração do E-Social o layout de integração com o TAF é o mesmo Layout disponibilizado pela Receita Federal e pode ser encontrado na página abaixo:
O Layout Único de Integração do TAF tem como objetivo possuir a maior quantidade de informações para a geração das mais variadas obrigações acessórias, ou seja, o Layout foi elaborado de forma lógica, garantindo que de apenas uma integração diversas obrigações possam ser geradas dentro do TAF.
Além do Layout Único de Integração existe também escopos onde o TAF utiliza o próprio Layout da obrigação disponibilizada pelo Fisco para integração com os ERP´s, como por exemplo o e-Social.
Abaixo temos uma tabela demonstrando quais escopos utilizam o Layout Único do TAF e quais utilizam o próprio Layout da Receita.
Escopo | Layout Único | Layout da Receita |
---|---|---|
Informações Fiscais ( Ex: EFD ICMS/IPI, EFD Contribuições... ) | Sim | Não |
Informações Contábeis ( Ex: ECF, Apuração IRPJ/CSLL... ) | Sim | Não |
Informações Trabalhistas ( Ex: eSocial ) | Não | Sim |
As API's abaixo devem ser utilizadas somente para o modelo de integração nativa (online), ou seja, onde o TAF está sendo utilizado como módulo do sistema Microsiga Protheus.
Objetivo: Serviço utilizado para invocar de forma automática os processos de integração do TOTVS Automação Fiscal.
Modo de Uso:
Exemplo de Uso:
Parâmetros de entrada:
Objetivo: Serviço utilizado para integração de informações no Layout do eSocial
Modo de Uso: Deverá ser chamada após a validação completa do modelo de dados do ERP. Em termos técnicos, poderá ser chamada após a efetivação da função TudoOk().
Exemplo de Uso: Inicialmente deverá ser realizado o desenvolvimento de string no formato XML, exemplo:
cXml += '<eSocial>' cXml += '<evtTabRubrica>' cXml += '<infoRubrica>' If cOper == "3" cXml += '<inclusao>' ElseIf cOper == "4" cXml += '<alteracao>' Else cXml += '<exclusao>' Endif cXml += '<ideRubrica>' cXml += '<codRubr>' + cCodRubr + '</codRubr>' If lGeraCod cXml += '<ideTabRubr>' + (cAliasSRV)->RV_FILIAL + '</ideTabRubr>' Else cXml += '<ideTabRubr>' + "" + '</ideTabRubr>' Endif cXml += '<iniValid>' + cAnoMes + '</iniValid>' cXml += '<fimValid>' + "" + '</fimValid>' cXml += '</ideRubrica>' cXml += '<dadosRubrica>' cXml += '<dscRubr>' + cDescRub + '</dscRubr>' cXml += '<natRubr>' + (cAliasSRV)->RV_NATUREZ + '</natRubr>' cXml += '<tpRubr>' + cINDTRB + '</tpRubr>' cXml += '<codIncCP>' + (cAliasSRV)->RV_INCCP + '</codIncCP>' cXml += '<codIncIRRF>' + (cAliasSRV)->RV_INCIRF + '</codIncIRRF>' cXml += '<codIncFGTS>' + (cAliasSRV)->RV_INCFGTS + '</codIncFGTS>' cXml += '<codIncSIND>' + (cAliasSRV)->RV_INCSIND + '</codIncSIND>' cXml += '<repDSR>' + cREPDSR + '</repDSR>' cXml += '<rep13>' + cREPDTE + '</rep13>' cXml += '<repFerias>' + cREPFER + '</repFerias>' cXml += '<repAviso>' + cREPREC + '</repAviso>' cXml += '<fatorRubr>' + Alltrim(Str(nFatRub)) + '</fatorRubr>' cXml += '<observacao>' + "" + '</observacao>' cXml += '<ideProcessoCP>' cXml += '<tpProc>' + (cAliasSRV)->RV_TPPROCP + '</tpProc>' cXml += '<nrProc>' + (cAliasSRV)->RV_NRPROCP + '</nrProc>' cXml += '<extDecisao>' + (cAliasSRV)->RV_EXPROCP + '</extDecisao>' cXml += '</ideProcessoCP>' cXml += '<ideProcessoIRRF>' cXml += '<nrProc>' + (cAliasSRV)->RV_NRPIRRF + '</nrProc>' cXml += '</ideProcessoIRRF>' cXml += '<ideProcessoFGTS>' cXml += '<nrProc>' + (cAliasSRV)->RV_NRPFGTS + '</nrProc>' cXml += '</ideProcessoFGTS>' cXml += '<ideProcessoSIND>' cXml += '<nrProc>' + (cAliasSRV)->RV_NRPSIND + '</nrProc>' cXml += '</ideProcessoSIND>' cXml += '</dadosRubrica>' If cOper == "3" cXml += '</inclusao>' ElseIf cOper == "4" cXml += '</alteracao>' Else cXml += '</exclusao>' Endif cXml += '</infoRubrica>' cXml += '</evtTabRubrica>' cXml += '</eSocial>' |
Parâmetro de entrada:
Objetivo: Serviço utilizado para integração de informações no Layout Único TOTVS ( dados fiscais e contábeis )
Modo de Uso:
Exemplo de Uso:
Parâmetros de entrada:
Objetivo: Serviço utilizado para consultar o status de determinado registro na base de dados do TAF
Modo de Uso:
Exemplo de Uso:
Parâmetros de entrada:
Tendo em mente a tabela acima vamos detalhar agora os modelos de integração existentes:
Neste modelo de integração o ERP irá gravar a mensagem de integração em uma tabela compartilhada do seu banco de dados e o TAF irá realizar a leitura dessa informações para integração, conforme abaixo:
I. Conhecendo a tabela compartilhada:
A tabela compartilhada é criada após a execução da Wizard Inicial do TAF( Sempre executada no primeiro acesso ao TAF ), no banco do ERP seu nome será TAFST1, e ela possui os seguintes campos:
Os demais campos são de controle do TAF
II. Exemplo da tabela TAFST1 populada:
Quando é enviado para o TAF um XML do eSocial, por exemplo, o mesmo é submetido a uma regra que define se a operação será realizada ou não dentro do TAF, sempre que o retorno for negativo a Origem receberá um retorno com o erro, seja via gerenciador de integração ( Integração Banco a Banco ) ou um array com os erros encontrados ( Integração OnLine )
Acesse a página abaixo para mais detalhes do comportamento da integração para o E-Social:
Comportamento da Integração TAF - eSocial
Nessa integração o TAF sempre verifica o campo TAFKEY, caso seja uma TAFKEY já enviada previamente o TAF realiza o Replace do cadastro no TAF, caso contrário realiza a inclusão da informação.
sempre que ocorrer algum problema na integração a Origem receberá um retorno com o erro, seja via gerenciador de integração ( Integração Banco a Banco ) ou um array com os erros encontrados ( Integração OnLine )
Quando utilizada a integração banco a banco o TAF possui alguns JOB´s de processamento automático para realizar o processo de carga dos dados, sendo eles:
TAFAINTG0:
Descrição: Busca as informações na ST1 no ERP e integra para a ST2 (TAF). Alterando o flag desses registros na ST1 (STATUS=2 - Integrados).
TAFAINTG2:
Descrição: Realiza a integração da TAFST2 para as tabelas internas do TAF. Integra as informações mesmo com inconsistências alimentando o gerenciador de integração
TAFAINTG3:
Descrição: Rotina que varre a base de dados procurando as inconsistências para apresentá-las no monitor de integrações.
Para maiores informações de como realizar a configuração dos Jobs de Integração acesse o lonk abaixo:
A chamada efetiva da API deverá ser efetuada conforme abaixo, e tem como retorno um array de erros ( caso ocorram ):
aErros := TAFPrepInt( cEmpEnv , cFilEnv , cXml , cKey , cTpInteg, cEvento )
Foi disponibilizada a função TAFGetStat() que possibilita consultar o status de um determinado registro no TAF.
TafGetStat( cEvento , cChave , cEmpEnv , cFilEnv )
Parâmetro | Descrição | Obrigatório? | Default |
---|---|---|---|
cEvento | Evento do eSocial a que se refere o registro | Sim | |
cChave | Chave de busca do registro. No caso onde a chave do registro é composta por mais de um campo, os valores devem ser informados separados por ";" (ponto e vírgula). | Sim | |
cEmpEnv | Empresa do registro no ERP | Não | cEmpAnt |
cFilEnv | Filial do registro no ERP | Não | cFilAnt |
Local cStatus := ""
Local cEvento := "S-1010"
Local cChave := "RUB_001"
cStatus := TAFGetStat( cEvento, cChave )
Os retornos possíveis são:
Particularidade de Integração do eSocial
Múltiplas Rúbricas
Integração do evento S-1010 (Rubricas) considerando o código identificador da tabela de rubricas no ERP origem.
Foi criado o cadastro Atualizações -> Cadastros eSocial -> Identificadores de Rubrica, onde é armazenado o código identificador da tabela enviado pelo ERP e gerado um código único e sequencial (ID). Esse código sequencial será utilizado pelo TAF na tag <ideTabRubr> do XML a ser transmitido ao RET .
Isso possibilita a integração de rubricas onde o código identificador da tabela no ERP é maior que 8 caracteres, como previsto no manual do eSocial.
Este documento tem como objetivo demonstrar os resultados que devem ser alcançados nos cenários possíveis de manutenção com relação aos eventos do E-Social no TAF, é fundamental e obrigatório que os requisitos entregues estejam respeitando todos os cenários abaixo tanto no modelo de integração quanto manual.
Novo Registro | Evento Corrente: Incluído | Evento Corrente: Alterado | Evento Corrente: Excluído | Situação Corrente: Transmitido | Situação Corrente: Não Transmitido | |
---|---|---|---|---|---|---|
Inclusão | Executa | Operação não realizada | Operação não realizada | Analisar duas próximas colunas | Executa | Operação não realizada |
Alteração | Operação não realizada | Executa | Executa | Analisar duas próximas colunas | Operação não realizada | Executa |
Exclusão | Operação não realizada | Executa | Executa | Operação não realizada |
***Seguindo com o documento temos maiores detalhes sobre cada uma das operações citadas na tabela acima***
Quando o registro já existente no TAF não foi transmitido ao RET, ou seja, seu campo de Status é diferente de 2,3 e 4 a operação
deve ser realizada normalmente na base de dados, caso já tenha sido enviado deve ser realizada a operação seguindo as regras
abaixo:
**Duplicar o registro, mantendo o atual e gerando uma nova linha na tabela com as seguintes regras:**
Protocolo = O novo registro gerado deve ter esse campo vazio
Penúltimo Protocolo = O novo registro deve ter nesse campo o valor do protocolo do registro anterior com a mesma chave
Versão = O novo registro deve ter uma nova versão
Versão Anterior = O novo registro deve ter o valor da versão do registro anterior com a mesma chave
Evento = O novo registro deve ter a operação que foi realizada
Ativo = O novo registro deve ter a situação igual a 1 ( Ativo ) e setar o registro anterior com a mesma chave para 2 ( Inativo ).