Introdução

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.

 

Objetivo

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.

ProdutoTOTVS Automação Fiscal
PaísesBrasil
Bancos de dadosTodos
Índice

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ódigoDescrição
    000001Erro de estrutura, favor verificar o Layout TAF.
    000002Filial não cadastrada no Cadastro de Complemento de Empresa do TAF.
    000003Erro na exclusão do registro.
    000004Erro de integridade, registro não pode ser excluído.
    000005Erro de duplicidade de registro.

    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.