Fila de Integração com ERPs (Monitor)

O Monitor de Fila de Integração com ERPs é uma ferramenta de monitoramento e controle que permite visualizar e gerenciar os itens da fila de sincronização entre o sistema e ERPs como SAP Business One. Esta seção é destinada exclusivamente para Administradores e deve ser utilizada com cautela, principalmente para reenfileirar itens em casos de erro de integração. Os dados só são exibidos quando existe integração ativa com algum ERP configurado no sistema.

Acessando a Lista de Fila de Integração

Para acessar o monitor de fila de integração, navegue pelo menu principal até a seção de integrações ou ERPs. O acesso é restrito a usuários com perfil de Administrador.

Esta funcionalidade só estará disponível e exibirá dados quando houver integração configurada com algum ERP, como SAP Business One. Sem integração ativa, a lista permanecerá vazia.

Tela da lista de fila de integração mostrando itens com colunas de modelo de dados, ID, ação, direção, status e datas
Tela principal da lista de fila de integração, onde você pode visualizar todos os itens pendentes ou processados, com informações sobre direção da sincronização, status atual e datas de processamento.

Visualizando os Itens da Fila

A lista de fila de integração exibe informações organizadas em colunas que permitem um controle detalhado dos processos de sincronização:

  • Modelo de Dados: Indica qual tipo de informação está sendo sincronizada (Cliente, Produto, Pedido, etc.)
  • ID do Modelo: Identificador único do registro no sistema
  • ID do ERP: Identificador correspondente no sistema ERP
  • Ação: Tipo de operação (Adicionado, Modificado, Deletado)
  • Direção: Sentido da sincronização (Sistema → ERP ou ERP → Sistema)
  • Status: Estado atual do processamento
  • Descrição: Detalhes adicionais ou mensagens de erro
  • Data de Criação: Quando o item foi adicionado à fila
  • Data de Atualização: Última modificação do item

Filtros e Busca

A interface oferece recursos de filtragem para localizar itens específicos na fila:

  • Filtro por Modelo de Dados: Selecione um tipo específico de registro
  • Filtro por Status: Visualize apenas itens com determinado status
  • Filtro por Direção: Separe por direção de sincronização
  • Filtro por Data: Defina períodos específicos para análise
  • Busca por ID: Localize itens por identificador do sistema ou ERP

Editando um Item da Fila

Para editar um item da fila, clique no ícone de edição na linha correspondente. Esta ação deve ser realizada apenas em casos de erro que necessitem reprocessamento.

A edição de itens da fila de integração deve ser feita apenas pelo Administrador e com extrema cautela. Modificações inadequadas podem causar inconsistências entre os sistemas e perda de dados.

Formulário de edição de item da fila de integração com campos para modelo de dados, IDs, ação, direção, status e descrição
Tela de edição de um item da fila, onde é possível modificar principalmente o status para reprocessamento. A maioria dos campos são somente leitura para preservar a integridade dos dados.

Campos do Formulário

Campo Tipo Descrição Editável
Modelo de Dados Texto Tipo de registro sendo sincronizado Não
ID do Modelo Texto Identificador único no sistema Não
ID do ERP Texto Identificador correspondente no ERP Não
Ação Lista Tipo de operação (Adicionado/Modificado/Deletado) Não
Direção Lista Sentido da sincronização Não
Data de Criação Data/Hora Quando o item foi criado Não
Data de Atualização Data/Hora Última modificação Não
Status Lista Estado atual do processamento Sim
Descrição Texto Longo Detalhes adicionais ou mensagens de erro Não

Status de Integração

Os itens da fila podem apresentar três estados principais:

  • Sincronizado (Synced): Item processado com sucesso
  • Em Espera (OnHold): Item aguardando processamento
  • Erro (Error): Item com falha no processamento

Para reenfileirar um item com erro, altere seu status de “Error” para “OnHold”. O sistema tentará reprocessar o item automaticamente no próximo ciclo de sincronização.

Tipos de Direção

A direção indica o fluxo dos dados:

  • Sistema → ERP (MeToErp): Dados sendo enviados do sistema para o ERP
  • ERP → Sistema (ErpToMe): Dados sendo recebidos do ERP para o sistema

Tipos de Ação

As ações representam o tipo de operação:

  • Adicionado (Added): Novo registro criado
  • Modificado (Modified): Registro existente alterado
  • Deletado (Deleted): Registro removido

Perguntas Frequentes

Por que a fila de integração está vazia?

A fila só exibe dados quando há integração ativa com um ERP configurado. Verifique se o SAP Business One ou outro ERP está devidamente configurado e conectado ao sistema.

Posso deletar itens da fila de integração?

Não é recomendado deletar itens da fila. Em caso de erro, altere o status para “OnHold” para reprocessamento. A exclusão pode causar inconsistências entre os sistemas.

O que fazer quando um item fica com status de erro?

Verifique a descrição do erro, corrija o problema na origem (sistema ou ERP) e altere o status para “OnHold” para nova tentativa de processamento.

Com que frequência os itens são processados?

A frequência depende da configuração do sistema de integração. Consulte o administrador do sistema para informações sobre intervalos de sincronização.

Posso editar todos os campos de um item da fila?

Não. A maioria dos campos é somente leitura para preservar a integridade. Apenas o status pode ser modificado para fins de reprocessamento.

Como identificar se um item foi processado com sucesso?

Itens processados com sucesso apresentam status “Sincronizado” e possuem data de atualização recente sem mensagens de erro na descrição.

É possível filtrar itens por período específico?

Sim. Use os filtros de data de criação ou atualização para visualizar itens processados em períodos específicos.

O que significa “ID do ERP” em branco?

ID do ERP em branco indica que o item ainda não foi processado pelo ERP ou houve erro na criação do registro no sistema externo.

Posso forçar a sincronização de um item específico?

Sim. Altere o status do item para “OnHold” e ele será reprocessado no próximo ciclo de sincronização automática.

Como interpretar as mensagens de erro na descrição?

As mensagens de erro fornecem detalhes técnicos sobre falhas de processamento. Consulte a documentação do ERP ou contate o suporte técnico para interpretação detalhada.