A aplicação TAF - TOTVS Automação Fiscal fornece aos ERP's, entre as suas funcionalidades de integração, uma interface de gerenciamento e monitoramento dos eventos de integração. Essa interface visa facilitar o dia-a-dia do administrador de ambiente e/ou usuários em relação as integrações realizadas para o TAF.
Criar uma ligação entre o ERP, de onde as informações foram extraídas, para que seja possível rastrear a origem da informação, além de realizar possíveis manutenções através da interface.
Produto | TOTVS Automação Fiscal |
---|---|
Países | Brasil |
Bancos de dados | Todos |
Índice |
O Gerenciador de Integração pode ser utilizado em três momentos distintos.
1) Ao executar manualmente o Job 2 - dois - será exibida uma pergunta no final do processamento. Caso selecione "Sim", será redirecionado ao Gerenciador de Integração.
2) Ao executar manualmente o Job 3 - três - será exibida uma pergunta no final do processamento. Caso selecione "Sim", será redirecionado ao Gerenciador de Integração.
3) Caso utilize os jobs de forma automática ( schedule ), poderá acessar o Gerenciador de Integração através do Menu: SIGATAF -> Miscelânea -> Integrações TAF -> Gerenciador de Integração.
Dentro da interface de gerenciamento de Integração podemos encontrar os seguintes containers:
Abaixo, pode visualizar a interface em uso. A seguir, o detalhamento de cada container e seus conceitos.
Responsável pelo gerenciamento de TICKET e TAFKEY.
Trata-se de um código que será gerado no momento da execução do Job 0 - zero ( entenda mais sobre os processos de integração clicando aqui ) e que será gravado na tabela TAFST2, utilizada no mecanismo de integração ( TAFST1 e TAFST2 ).
É gerado a partir de um componente de UUID, gerador de chave única universal, portanto não se repetirá.
O seu objetivo é possibilitar o rastreamento de um lote de registros enviados ao TAF, ou seja, toda vez que um novo processo de integração for executado, independente da quantidade de registros integrados, será gerado um novo TICKET.
Os TICKETS podem ser gerenciados através do Monitor de Integração, conforme imagem abaixo.
Representa uma chave de identidade da mensagem para controle do ERP em futuras consultas, atualizações, etc. Esta identidade (key) tem o objetivo de evitar duplicidades de informações.
É gerado pelo extrator, um para cada registro integrado, e composta por informações do próprio ERP.
Os TICKET podem ser gerenciados através da própria interface do Monitor de Integração. O botão Excluir executa a exclusão do TICKET, ou seja, de todos os registros que foram integrados ao TAF que estão relacionados ao TICKET selecionado.
Será apresentada uma tela para seleção dos registros que devem ser excluídos no TAF.
Os TAFKEY podem ser gerenciados através de um duplo clique em um TICKET, dentro do Monitor de Integração, conforme imagem abaixo:
Realiza duplo clique na linha do TICKET
É exibida uma tela com todos os TAFKEY associados a um único TICKET, além do status do registro.
Os registros exibidos na tela acima são baseados nas informações geradas na tabela TAFXERP.
Através de um duplo clique sobre o TAFKEY, é possível visualizar a mensagem de integração enviada para aquele registro, conforme imagem abaixo:
Realiza duplo clique no TAFKEY
É apresentada uma tela com a mensagem de integração enviada, de acordo com o Layout TOTVS ( entenda o Layout TOTVS clicando aqui )
Este recurso permite utilizar a mensagem original e forçar uma nova integração, gerando um novo TICKET mas mantendo o mesmo TAFKEY.
Um exemplo de uso, é a integração com o TAF de uma mensagem de nota fiscal, onde o participante (cliente/fornecedor) utilizado no documentos fiscal não foi enviado previamente, e essa falta de informação forçou o TAF a rejeitar a Nota Fiscal por falta de integridade para que seja corrigido e efetuada uma nova integração. Esse recurso implementado, permite que após o usuário incluir a informação faltante, via integração ou diretamente no TAF, seja possível reutilizar a mesma mensagem da Nota Fiscal e efetuar a integração novamente.
As mensagens processadas, são as apresentadas em tela que podem ser previamente filtradas - Outras Ações / Filtrar; inclusive a necessidade se dá em mensagens que tiveram falha no processamento da integração.
Mensagem final do processamento com o novo ticket gerado:
Apresentação no Gerenciador de Integração do novo ticket criado.
Abaixo informações sobre os ossíveis status dé registros integrados
Registro Inconsistente: Ocorre quando é encontrada uma inconsistência durante a integração do registro.
Possíveis inconsistências:
Código | Descrição | Observações |
---|---|---|
000001 | Erro de estrutura, favor verificar o Layout TAF. | Ocorre quando a mensagem enviada pelo sistema de origem não comporta as premissas mínimas de estrutura da mensagem no Layout TOTVS de integração. |
000002 | Filial não cadastrada no Cadastro de Complemento de Empresa do TAF. | Ocorre quando o registro enviado está relacionado a uma filial não cadastrada no Complemento de Empresa. Entenda mais sobre o Complemento de Empresa em Cadastre o complemento de empresa |
000003 | Erro na exclusão do registro | Ocorre quando a chave da mensagem enviada para exclusão não é encontrada na base de dados do sistema. Entenda mais sobre o registro de exclusão do Layout TOTVS acessando Layout Único Atual, procure pelo registro T999. |
000004 | Erro de integridade, registro não pode ser excluído. | Ocorre quando a chave da mensagem enviada para exclusão já está relacionada a outro registro na base de dados do sistema.Entenda mais sobre o registro de exclusão do Layout TOTVS acessando Layout Único Atual, procure pelo registro T999. |
000005 | Erro de duplicidade de registro. Clique em Depurar para mais informações. | Ocorre quando dentro da mensagem de integração enviada pelo sistema de origem existem registros com chave em duplicidade. |
000006 | Ambiente Desatualizado. Verifique a atualização de dicionário e repositório de objetos. | Ocorre quando o ambiente do TOTVS Automação Fiscal não está atualizado o suficiente para integrar a mensagem enviada pelo sistema de origem. |
000007 | A operação solicitada no XML está em desacordo com o cenário do registro na base do TAF | Ocorre quando a operação enviada no XML não pode ser efetuada na base de dados do sistema devido ao status atual do registro. Exclusivo eSocial. |
000008 | Existem TAG´s do XML com informações duplicadas, a integração não será realizada | Ocorre quando dentro da mensagem de integração enviada pelo sistema de origem existem registros com chave em duplicidade. Exclusivo eSocial. |
000009 | Registro não integrado. Duplo clique para mais informações! | Ocorre quando a mensagem enviada possui alguma das seguintes inconsistências: - Campo chave obrigatório não enviado. Exemplo: Mensagem de Documento Fiscal ( registro T013 ) que não possui conteúdo no campo de "Número do Documento Fiscal". - Campo que possui relação de chave estrangeira onde a chave enviada na mensagem não existe na base de dados do sistema. Exemplo: Mensagem de Documento Fiscal ( registro T013 ) onde o Participante enviado ainda não existe na base de dados do sistema. A mensagem detalhada da inconsistência fica armazenada no campo TAFERR da tabela TAFXERP. |
O código da inconsistência fica armazenado no campo TAFCODERR, da tabela TAFXERP.
Disponibiliza as informações geradas na tabela CU0, através do Job 3 - três ( entenda mais sobre os processos de integração clicando aqui ), e possibilita a correção das inconsistências na própria interface, sem a necessidade de acessar o cadastro no Menu do sistema.
Através do botão Visualizar, é possível visualizar as informações do registro em foco na tabela CU0. Entre essas informações, estão o código, descrição e data da inconsistência.
Seleciona a opção Visuzalizar
Tela com dados da incosistência registrada na tabela CU0.
Através do botão Corrigir, é possível ajustar as informações do cadastro pelo próprio monitor de Validação, conforme imagem abaixo:
Seleciona a opção Corrigir.
Visualiza a tela do próprio cadastro e realiza os devidos ajustes.
Salva os ajustes realizados.
Limpar Histórico
Na visão individualizada temos o botão Limpar Histórico que exclui todas as tentativas de integração, esta opção exclui todos os registros estando estes integrados ou não, EXCETO REGISTROS TRANSMITIDOS, deixando apenas o primeiro como referência.
A interface oferece dois gráficos para monitoramento de estatísticas e pendências da integração.
Indica a quantidade de TICKETS que já foram integrados para o TAF e a quantidade de TICKETS pendentes para integração.
Os TICKETS integrados são aqueles em que o Job 2 - dois - já foi executado e os registros do lote já foram importados ou rejeitados.
Os TICKETS pendentes são aqueles que já foram gerados, o lote já foi preparado através do Job 0 - zero - porém ainda não foi importado para o TAF.
Indica a quantidade de registros incluídos, alterados, excluídos ou inconsistentes nas integrações realizadas. Suas ocorrências estão detalhadas no tópico Status de TAFKEY.
A interface oferece um filtro de data, conforme os eventos de integração. Os monitores de integração e validação possuem o campo de data, e podem ser filtrados de acordo com Data De e Data Até.
Campos disponíveis para filtro.
Campos considerados de acordo com o filtro preenchido.
Objetivo do Relatório:
Este relatório irá listar todos os erros ocorridos no Processo de Integração do TAF, de acordo com os parâmetros informados pelo usuário. Poderá ser gerado para visualização na tela, em formato PDF, em formato Excel ou enviado via email.
Pré Requisitos:
Menu:
Miscelaneas -> Integracoes -> Gerenciador de Integração/Validação -> Outras Ações -> Exportar Tickets
Figura 1 - Acesso ao Relatório de Conferência
Parâmetros:
Para acessar os parâmetros do relatório clique em Outras Ações -> Parâmetros:
O relatório poderá ser gerado em formato PDF ou excel, para tanto basta selecionar qual a saída desejada na tela de parâmetros (conforme imagem acima).
Figura 2- Tela de Configuração do Relatório
Será exibido um box com os parâmetros disponíveis para o relatório:
Figura 3 - Tela de Parâmetros do Relatório - p.1
Figura 4 - Tela de Parâmetros do Relatório - p.2
Parâmetro | Descrição |
Registro De | Informar o código de Registro Inicial que será considerado para filtro do relatório. |
Registro Até | Informar o código de Registro Final que será considerado para filtro do relatório. |
Data De | Informar a Data Inicial da Integração a ser considerada para filtro do relatório. |
Data Até | Informar a Data Final da Integração a ser considerada para filtro do relatório. |
Status De | Informar o código de Status Inicial que será considerado para filtro do relatório. |
Status Até | Informar o código de Status Final que será considerado para filtro do relatório. |
Cod. Erro De | Informar o código de Erro Inicial que será considerado para filtro do relatório. |
Cod. Erro Até | Informar o código de Erro tatus Final que será considerado para filtro do relatório. |
Considera Última Ocorrência | Informe se deseja listar somente a última ocorrência de erro. Caso seja Sim, só serão listados os últimos registros de erro para Chave(TAFKEY) listada, do contrário todas as ocorrências do TAFKEY que existirem serão listadas. |
Impressão do Relatório:
A Saída do relatório informa a data da integração, o número do ticket, a chave, o tipo de registros, a mensagem de integração, a descrição do erro, o código do status e descrição do erro de integração.
Figura 5 - Saída do Relatório de Integração
Campo do Relatório | Descrição |
Data | Data da Integração |
Ticket | Número do Ticket TAF |
Chave | Número da Chave TAF |
Tipo | Tipo de Registro |
Mensagem | Mensagem de Integração |
Erro | Descrição do Erro de Integração |
Status | Código do Status da Integração |
Cod. Erro | Código e Descrição de Erro da Integração do registro. |