Gerenciador de Integração

Procedimentos para Utilização

Utilização da Interface

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.

Interface e suas propriedades

Dentro da interface de gerenciamento de Integração podemos encontrar os seguintes containers:

• Filtros
• Gráfico Ticket - Por Lote
• Gráfico Ticket - Por Registro
• Monitor de Integração
• Monitor de Validação

Abaixo, pode visualizar a interface em uso. A seguir, o detalhamento de cada container e seus conceitos.

Monitor de Integração

Responsável pelo gerenciamento de TICKET e TAFKEY.

Conceito de TICKET

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.

Conceito de TAFKEY

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.

Gerenciamento de TICKET e TAFKEY

TICKET

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.

TAFKEY

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 )

Outras Ações / Habilitar Re-integração

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.

Status de TAFKEY

Abaixo informações sobre os ossíveis status dé registros integrados

• Registro Incluído: Ocorre quando o registro é incluído com sucesso no TAF.
• Registro Alterado: Ocorre quando o registro é alterado com sucesso no TAF. Um evento de alteração acontece quando é enviado um TAFKEY que já foi integrado anteriormente.
• Registro Excluído: Ocorre quando o registro é excluído com sucesso no TAF.

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

Monitor de Validação

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.

Gráficos

A interface oferece dois gráficos para monitoramento de estatísticas e pendências da integração.

Gráfico Ticket - Por Lote

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.

Gráfico Ticket - Por Registro

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.

Filtros disponíveis

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.

Relatório de Conferência de Integração

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:

• Aplicar o pacote de dicionário do TAF com data de 30/04/2018 ou superior
• Estar com a rotina TAFTICKET.PRW com data igual ou superior a 30/04/2018.

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

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