EME4 – Integração Externa – Integração Banco de Dados – Importação Banco de Dados – TIMUS

EME4 – Versão 04.03.00 | Integração por banco de dados permite um controle mais eficiente dos dados enviados. Os dados são inseridos em tabelas de importação e, a partir destas, o EME4 interpretará os registros inserindo-os nas tabelas nativas do EME4.

Pré-Requisitos

  • Possuir o módulo m3Importacaobd publicado na base de dados. Solicitar a liberação do recurso junto à Área Comercial;
  • Solicitar o leiaute de importação à equipe técnica da EME4.

Configuração

Layout Importação Banco de Dados

Integração Externa > Importação Banco de Dados > Layout Importação Banco de Dados
 

Criar um novo layout

Informar Nome e Situação;

Sistema Origem: S – SEED, TOT – Totali (Varejo) ou O – Outros;

E-mails: informar o e-mails para que deve ser enviado a cada execução (separados por ponto-e-vírgula);

Formato: selecionar o formato do relatório que será enviando junto do e-mail;

| Quando a base de dados possuir mais de uma tarefa agendada para importação de TIMUS é possível definir que o sistema primeiro deve importar os cadastro, depois documentos e por último ocorrências, conforme abaixo.

Importação Cadastros (1 a 1): indica que não será importado cadastros em lote;

Importação Ocorrências (1 a 1): indica que não será importado ocorrências em lote;

Ordem: indica a ordem de importação de registros, neste exemplo, primeiro serão importados todos os clientes, depois os representantes, para então importar os documentos, evitando erros de importar o documento, sem antes ter importado os clientes e representantes.

Após finalização da configuração, [ Confirmar ].

Clicar em [ Ações ], [ Importar Tabelas e Campos Layout ] para importar os arquivos “.txt” enviados pela equipe técnica para criação das tabelas físicas.

Selecionar o arquivo de layout a ser importado e [ Importar ].

Para a criação das tabelas de timus no banco de dados, é necessário fazer a seguinte operação:

Clicar em [ Ações ], [ Refazer Tabelas e Campos Layout ].

| Ao refazer tabelas e campos layout, se já existir registros nas timus serão deletados, para situações de manutenção, para adicionar campos, é necessário criar um layout temporário para refazer as TIMUS. A operação de importação de layout deve ser feito no Layout temporário e no layout  já existente

Após refazer tabelas será mostrada a mensagem:

| Número de tabelas e campos é variável e está relacionado ao txt importado.

 

Tipos Operações Banco de dados

Integração Externa > Integração Banco de Dados > Tipos Operações Banco de dados
 
 
Onde será configurado as operações x tipo de documento no EME4, por exemplo, o sistema de terceiro envia o no campo TIPOOPERACAO o código 450, que se refere a uma transferência de estoque interna.
 
Código: informação enviada no campo TIPOOPERACAO das timus
  • Para clientes de varejo é necessário primeiro configurar o códigos externos no ttconfig;
  • Para cupom fiscal deve ser preenchido como 998;
  • Para recebimento de parcelas deve ser preenchido como 999.
Sigla: pode ser cadastrada uma abreviatura do tipo de documento, não tem nenhuma ação sobre a importação;
 
Descrição: cadastrar descrição da operação a ser importada;
 
Digitação Padrão: informar qual padrão de digitação do documento, ideal que seja  [ Confirmado ] para não haver necessidade de confirmação de documento a documento.
 
Padrão Documento: qual o padrão de documento pertence este documento;
 
Tipo de Documento: só serão apresentados os tipos de documentos vinculados ao padrão selecionado acima;
 
Qtde. Máxima Documentos: limite de número de documentos no lote de importação, informar penas no primeiro registros, se estiver zerado, sistema assume 25 como padrão.
 

 

Sequência Importação Banco de dados

Integração Externa > Integração Banco de Dados > Tipos Operações Banco de Dados
 

 

| Disponível a partir da versão 05.03.00 | Quando a empresa possui a importação de documentos, por exemplo, Pedido de Venda, Nota de Venda e Devolução de Venda, é necessário configurar a sequência de importação a fim de evitar que a devolução seja importada antes da venda.  Com a sequência informada, força o sistema a seguir a ordem sequencial de ocorrência dos fatos.

Adicionado campo [ Sequência ].

Para que o mesmo funcione marcar [ Ref. outro Documento ].

Exemplo:

 

Importação Banco de Dados

Integração Externa > Integração Banco de Dados > Importação Banco de Dados

 

Por padrão a execução de importação do registros é feito pela ordem de inserção. No exemplo abaixo, consta a importação seguindo a configuração acima. Onde, mesmo o registro de pedido de venda ter sido inserido após o Documento de cupom fiscal e devolução de venda, ele foi o primeiro a ser importado, desta forma evitando erro no cupom por não encontrar o pedido de venda.

 

Configurar Importação BD

Integração Externa   > Configurar Importação BD
 
 
| O monitor mostra em tempo real a situação da importação de dados via banco de dados.
 
No primeiro acesso, não irá possuir indicadores cadastrados, por isso, nesse primeiro acesso [é necessário publicar os indicadores, basta clicar no botão [ Publicar Indicadores Padrões ]
 
Timer Monitor ( segundos ): informar de quanto em quantos segundos a tela de monitoramento irá atualizar os dados de forma automática;
 
Dias anteriores a Data Atual ( Período Monitor ): quantidade de dias anterior que será mostrada os registros de monitoramento, no exemplo abaixo, onde a data atual = 24/03 e data inicial = 21/03 serão mostrados somente os registros nesse período;
 
Utiliza ID Master x Detail: quando marcada essa opção, o sistema entende que deve localizar as partes de uma timu_documento através do IDMASTER, ou seja, tenho uma venda, onde o id da timu_documento =1, ele irá procurar partes do documento onde o campo idmaster é =1.
 
 
Após a publicação dos indicadores padrões, será mostrado a lista abaixo na aba [ Indicadores Importação BD ].
 
Sequencia: sequência que será mostrada na tela do monitor;
 
Descrição do Indicador: descritivo da informação que será listada no indicador;
 
Cor de Exibição: cor que será indicada no monitor no resumo e no grid com as informações listadas;
 
Status Exibição do Grid: status da timus que será mostrada no grid:
  • Aguardando Importação: está aguardando inicio de importação;
  • Importando: está sendo importado no momento, REQUER ATENÇÃO quando passar de 1 dia importando;
  • Erro: existe erro na integração, por exemplo, um campo que deveria estar obrigatório como filial;
  • Registro Importado: importação realizada com sucesso;
  • Falha na Interpretação: quando é enviado um código não cadastrado no eme4, exemplo, código de produto.

Caso deseje criar um novo indicador, basta clicar no [ + ] e preencher os campos:

Sequência: informar a sequência que ele deve ser apresentado no monitor;

Descrição Indicador: descrição que o mesmo deve ser apresentado no monitor;

Select Indicador: query utilizada para listagem da quantidade de registros. Pode ser usado um existem como base, e ajustar a informação de filtro, no meu exemplo, copei registros importando a 2 e criar para 10 dias;

Status Exibição Grid: qual status será mostrado no grid;

Cor Exibição: informar a cor que deverá ser mostrado no grid para este indicador.

Em [ Informações Monitor Importação BD ] poderá ser adicionadas timus que se deseja mostrar o monitor. Por padrão será publicada apenas a [ TIMU_DOCUMENTO ], pois em caso de erro nas suas partes, o documento ficará com erro.

No campo de select (descrição) poderá ser personalizado os dados apresentados, bastando ajustar o texto que está em azul na imagem abaixo.

 

Importação Banco de Dados

Integração Externa > Integração Banco de dados > Importação Banco de Dados
 
| A importação das TIMUS pode ocorrer de duas formas, manual e através de tarefa agendada.
 
Além de processar a importação das timus é possível fazer verificar os possíveis erros que possam ocorrer.
 
Acesse aqui para verificar erros e soluções de integração de timus.
  1. Inserir um novo registro;
  2. Informar filial apenas se deseja importar de uma filial específica;
  3. Informar o layout de importação BD que será usado na importação;
  4. Depois confirmar para dar início à importação de dados.

Após conclusão será mostrado o grid abaixo, separado em 3 partes:

1. Dados do lote de importação, onde mostra quantidade de registros importado com sucesso, quantidade de registros importados com erro, situação do lote que segue abaixo:

  • Importado com Erros;
  • Importado com Sucesso;
  • Nenhum Registro Importado.

2. Ocorrências Importação BD: Mostra as informações do Documento/Cadastro processado, no exemplo abaixo mostra um registro que não foi importado, devido ao erro [ Não foi possível gravar o Cabeçalho Requisição de Compras porque ocorreram erros ao incluir suas requisições. ], quando ocorrer erro parte do documento, é necessário verificar em [ Ocorrências Importação BD ].

Porém, pode existir erros na inclusão do registro principal, por exemplo [Tabela [TIMU_Documento] Campo [IDF_IDENTIFICACAO] obrigatório! Campos requeridos: [CodigoCliFor=; CPFCNPJCliFor=;]], onde irá existir erro na importação do cabeçalho do documento.

3. Ocorrências Importação BD: mostra a situação dos detalhes do documento, por exemplo, parte item documento, parcelamento e etc. Quando o campo Sucesso estiver marcado, significa que o registro foi importado, porém se não estiver marcado, é importante verificar o campo descrição, onde irá conter o motivo de rejeição. No exemplo abaixo: Tabela [TIMU_ParteDoctoItem] Campo [IDF_PRODUTO] IDF não encontrado! Filial 0. Campos requeridos: [CodigoProduto=XXXXX;] ], ou seja, não foi encontrado o produto enviado

Em caso de erro executar o seguinte procedimento:

Falta de cadastro:

  • Cadastros enviados pelo software de Terceiro: deverá cerificar se o cadastro foi enviado para o EME4 e se foi importado com sucesso. Caso não foi enviado, reenviar a do importação do mesmo. Em caso de erro de processamento do cadastro, corrigir o mesmo para depois reenviar ou reprocessar a importação.
  • Cadastro no EME4: quando o cadastro é feito no EME4 e enviado ao software de terceiro, deve ser verificado se o código retornado na TIMU está correto, se ele existe no EME4. Em exceções, que foi cadastrado no software de terceiro manual, o mesmo deve cadastrado no EME4 com o mesmo código.  Caso seja cadastrado no EME4, basta reprocessar a importação, caso esteja incorreto, deve ser corrigido no software de origem e reenviado para o EME4

Reprocessar o registro: marcar o registro a ser reprocessado, clicar em [ Ações ], [ Alterar StatusM3 Aguardando Processamento ].

 

Monitorar Integração BD – Indicadores

Integração Externa > Integração Banco de Dados >  Monitorar Integração BD – Indicadores
 
Painel de Indicadores: será mostrado de acordo com as configurações feito na tela [ Integração Externa   > Configurar Importação BD ], mostrando a descrição e quantidade de registro de cada indicador.
 
Painel filtros: será aberto de acordo com o parâmetro [ Dias anteriores a data atual ( Período Monitor ) ] em [ Integração Externa   > Configurar Importação BD ].
 
No grid serão listadas as timus processadas. A cor no grid e coluna descrição serão mostrados de acordo com [ Integração Externa  > Configurar Importação BD ].
 
 

Agendar Tarefas

Relatórios e Indicadores > Agenda Tarefas
 
Incluir uma nova tarefa
  1. Preencher o nome da tarefa;
  2. Escolher opção Método;
  3. Escolher o Método [ Importação Automática Banco de Dados ];
  4. Preencher os agendamentos.
 
 
Em [ Parâmetros ] informar o layout da importação BD a ser utilizado, [ Confirmar ] e [ Ativar Tarefa ].