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 )

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 Ocorre quando a mensagem enviada pelo sistema de origem não
verificar o Layout TAF. comporta as premissas mínimas de estrutura da mensagem no
Layout TOTVS de integração.

000002 Filial não cadastrada Ocorre quando o registro enviado está relacionado a uma filial não
no Cadastro de cadastrada no Complemento de Empresa. Entenda mais sobre o
Complemento de Complemento de Empresa em Cadastre o complemento de
Empresa do TAF. empresa

000003 Erro na exclusão do Ocorre quando a chave da mensagem enviada para exclusão não
registro é 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, Ocorre quando a chave da mensagem enviada para exclusão já
registro não pode ser está relacionada a outro registro na base de dados do
excluí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 Ocorre quando dentro da mensagem de integração enviada pelo
registro. Clique em sistema de origem existem registros com chave em duplicidade.
Depurar para mais
informações.

000006 Ambiente Ocorre quando o ambiente do TOTVS Automação Fiscal não está
Desatualizado. atualizado o suficiente para integrar a mensagem enviada pelo
Verifique a atualização sistema de origem.
de dicionário e
repositório de objetos.

000007 A operação solicitada Ocorre quando a operação enviada no XML não pode ser
no XML está em efetuada na base de dados do sistema devido ao status atual do
desacordo com o registro. Exclusivo eSocial.
cenário do registro na
base do TAF

000008 Existem TAG´s do XML Ocorre quando dentro da mensagem de integração enviada pelo
com informações sistema de origem existem registros com chave em
duplicadas, a duplicidade. Exclusivo eSocial.
integração não será
realizada

000009 Registro não integrado. Ocorre quando a mensagem enviada possui alguma das seguintes
Duplo clique para mais inconsistências: - Campo chave obrigatório não enviado. Exemplo:
informações! 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.

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.