Tabela 1: Fluxo de informações entre Linx DMS e AGCO

• O processo completo de integração (envio de todos os fluxos de informação), pode ocorrer de 3 maneiras, sendo elas:

Carga Inicial

de informações entre Linx DMS e AGCO

1. Carga Inicial

• Envia todos os dados necessários, para realizar uma carga inicial de dados na base da AGCO, para que seja possível iniciar o processo de recomendação de estoque;
• Executado ao clicar no botão “Carga Inicial”, na tela de configuração da Integração do TRC AGCO;
• Realiza os seguintes fluxos:
  • DMS-01: Todas as peças disponíveis com pedido, reserva ou devolução em aberto;
  • DMS-02: Dados cadastrais de todas as peças já movimentadas;
  • DMS-03: Compras, pedidos e transferências de filiais, considerando os últimos 6 meses;
  • DMS-04: Vendas, atendimento balcão e oficina, considerando os últimos 36 meses;
  • DMS-06: Dados cadastrais dos clientes ativos nos últimos 36 meses;

2. Fluxo Periódico

• Envia os dados encontrados no período entre a última execução e o início da execução atual;
• Dispara a execução do processo completo, a cada período configurado na tela de configuração da Integração do TRC AGCO;
• Realiza os fluxos:
  • DMS-01: Todas as peças

• • que tiveram movimentação de disponibilidade no período estabelecido;
  • DMS-02: Dados cadastrais de todas as peças

• • que foram cadastradas ou alteradas durante o período estabelecido;
  • DMS-03: Compras, pedidos e transferências de filiais,

• • registradas ou alteradas durante o período estabelecido;
  • DMS-04: Vendas, atendimento balcão e oficina,

• • registradas ou alteradas no período estabelecido;
  • DMS-05: Vendas perdidas registradas no período estabelecido;
  • DMS-06: Dados cadastrais dos clientes ativos

• • no período estabelecido;

3. Execução Manual

• Envia os dados encontrados no período entre a última execução e o início da execução atual

• , assim como o Fluxo Periódico;
• Executado ao clicar no botão “Executar Manualmente”, na tela de configuração da Integração do TRC AGCO;
• Realiza exatamente os

• DMS-01: Todas as peças que tiveram movimentação de disponibilidade no período estabelecido;
• DMS-02: Dados cadastrais de todas as peças que foram cadastradas ou alteradas durante o período estabelecido;
• DMS-03: Compras, pedidos e transferências de filiais, registradas ou alteradas durante o período estabelecido;
• DMS-04: Vendas, atendimento balcão e oficina, registradas ou alteradas no período estabelecido;
• DMS-05: Vendas perdidas registradas no período estabelecido;
• DMS-06: Dados cadastrais dos clientes ativos no período estabelecido;

Execução Manual

• Envia os dados encontrados no período entre a última execução e o início da execução atual, assim como o Fluxo Periódico;
• Executado ao clicar no botão “Executar Manualmente”, na tela de configuração da Integração do TRC AGCO;
• Realiza exatamente os mesmos fluxos que a Execução Periódica;

 Importante: A execução do processo “Execução Manual” não interfere no período de execução do processo “Fluxo Periódico”.

Configuração do Processo

 Manutenção de Parâmetros do Fábrica:

 Menu: Fabrica.exe > AGCO > Parâmetros;

Os parâmetros da Integração da TRC AGCO podem ser encontrados na aba "TRC" da tela de Manutenção de Parâmetros Massey.
Devem ser preenchidos para cada uma das Revendas que devem utilizar o processo de integração TRC. Caso os parâmetros não estejam configurados para a Revenda, o Integrador não realiza nenhum tipo de comunicação entre Revenda e Montadora.

Image Removed

Figura 1: Parâmetros do Fábrica AGCO

Campos:

• Aba “TRC”
  • Integração TRC: Indica se a empresa/revenda logada será utilizada no processo de exportação.
  • Usuário para notificações da Integração TRC: Usuário que irá receber o correio interno com notificações sobre o andamento da Integração.
  • Data da Última Comunicação: Data em que ocorreu o último processo de Integração. Esta data serve também como base (data inicial) para o próximo processo de Integração.
  • Categoria Clientes p/ Vendas entre Concessionárias: Categoria de clientes para identificar Vendas entre Concessionárias.

Manutenção de Itens de Exceção

 Fabrica.exe > Fábrica > AGCO >TRC > Manutenção Itens Exceção - TRC

Image Removed

Figura 2: Manutenção de Itens de Exceção

Este programa permite que itens sejam configurados como itens em exceção. A informação de que um determinado item está em exceção será utilizada na geração de cada uma das API’s, excluindo o item da integração entre Linx DMS e AGCO.

• mesmos fluxos que a Execução Periódica;

 Importante: A execução do processo “Execução Manual” não interfere no período de execução do processo “Fluxo Periódico”.

Configuração do Processo

Manutenção de Parâmetros do Fábrica

 Acesse o menu Fabrica > AGCO > Parâmetros

Os parâmetros da Integração da TRC AGCO podem ser encontrados na aba "TRC" da tela de Manutenção de Parâmetros Massey.
Devem ser preenchidos para cada uma das Revendas que devem utilizar o processo de integração TRC. Caso os parâmetros não estejam configurados para a Revenda, o Integrador não realiza nenhum tipo de comunicação entre Revenda e Montadora.

Image Added

Figura 1: Parâmetros do Fábrica AGCO

Campos:

Aba “TRC”

• Integração TRC: Indica se a empresa/revenda logada será utilizada no processo de exportação.
• Usuário para notificações da Integração TRC: Usuário que irá receber o correio interno com notificações sobre o andamento da Integração.
• Data da Última Comunicação: Data em que ocorreu o último processo de Integração. Esta data serve também como base (data inicial) para o próximo processo de Integração.
• Categoria Clientes p/ Vendas entre Concessionárias: Categoria de clientes para identificar Vendas entre Concessionárias.

Manutenção de Itens de Exceção

 Acesse o Menu Fábrica > AGCO >TRC > Manutenção Itens Exceção - TRC

Image Added

Figura 2: Manutenção de Itens de Exceção

Este programa permite que itens sejam configurados como itens em exceção. A informação de que um determinado item está em exceção será utilizada na geração de cada uma das API’s, excluindo o item da integração entre Linx DMS e AGCO.

• Para adicionar um grupo de itens como exceção, siga os passos abaixo:

1. Selecione a aba “Grupo”;
2. Selecione o grupo desejado;
3. Clique no botão “1 - Incluir”.

• Para remover um grupo de itens como exceção, siga os passos abaixo:

1. Selecione a aba “Grupo”;
2. Selecione o grupo desejado;
3. Clique no botão “2 – Excluir”.

• Sempre que um item for adicionado na lista de exceção, ele será mostrado na grade da tela e, quando for removido da lista de exceção, não será mais apresentado na grade.

Mapeamento de Itens do TRC

Mapeamento de Itens do TRC

Menu: Fábrica > AGCO > TRC > Mapeamento de Itens;

Para que o processo seja executado corretamente, deve ser realizado o mapeamento dos Itens da base de dados do Linx DMS com os itens da Agco. Para isto é necessário utilizar a ferramenta de Mapeamento de Itens do TRC, disponibilizada no menu informado acima.

• O mapeamento deverá seguir os seguintes processos:

1. 1. Exportar o arquivo de formato CSV, contendo os itens da base de dados;
   2. Enviar para a Agco o arquivo exportado, para que o arquivo seja preenchido com as informações necessárias;
   3. Importar o arquivo de formato XLS ou XLSX, enviado pela montadora, contendo as informações necessárias preenchidas;

Exportação do arquivo

Para realizar a exportação, acesse a ferramenta “Mapeamento de Itens – TRC”, e siga os seguintes passos:

1. Selecione a opção “Exportação de itens”;
2. Clique no botão “Exportar”;
3. Aguarde a busca dos itens da base de dados;

 

Image Removed

Figura 3: Mapeamento de Itens – TRC

 

Verifique os itens encontrados para a exportação do arquivo;

Observação: Ao selecionar a opção "Exportação de Itens" será habilitado uma nova configuração chamada "Considerar Itens em Exceção", onde:

• Quando estiver marcada o programa irá buscar todos os itens da base de dados.
• Quando estiver desmarcada o programa irá buscar os itens, exceto os itens que estão configurados como Exceção.

Image Added

Figura 3: Mapeamento de Itens – TRC

Verifique os itens encontrados para a exportação do arquivo;

Clique no botão “Exportar para arquivo CSV” para finalizar a exportação;

Image Modified

Figura 4: Mapeamento de Itens – TRC

Após a exportação do arquivo, entre em contato com a Agco para verificar a melhor maneira de realizar o envio do arquivo para a montadora.

Importação do arquivo

Menu: Fábrica > AGCO > TRC > Mapeamento de Itens;

Após receber o arquivo (nos formatos XLS ou XLSX) com as informações da montadora preenchidas, acesse a ferramenta “Mapeamento de Itens – TRC” e realize a importação, seguindo os seguintes passos:

1. 1. Selecione a opção “Importação de itens referência”;
   2. Selecione o arquivo na opção “Selecione o arquivo para importar”;
   3. Clique no botão “Importar” e aguarde a conclusão da importação do arquivo;

 

Image Modified

Figura 5: Mapeamento de Itens – TRC

Configuração do Linx DMS Integrador

1. Execute o programa LDIConfig.exe, existente na pasta principal do Linx DMS Integrador;
2. Acesse o menu “Configuração > AGCO”;
3. Na aba “Configuração”, preencha os dados de acesso ao banco de dados;

Image Removed

Figura 6: Tela de configuração do banco de dados

• Clique em “Testar Conexão”.
  Prosseguir somente ser for apresentada a mensagem “Conexão realizada com sucesso!” Caso não ocorra, verifique se os parâmetros informados são os mesmos utilizados pelo Linx DMS Apollo;

• Preencha o campo “Permanência do Log no Banco”.
  Informar o número de dias para que o log da integração seja mantido no seu banco de dados, conforme a regra descrita a seguir:

Relatório de Itens de Exceção

Menu: Fábrica > AGCO > TRC > Relatório Itens Exceção - TRC

É possível visualizar um relatório de itens que foram configurados como exceção, para isto, devemos acessar o menu descrito acima.

1. Nesta tela podemos ordenar as informações por Código ou Grupo.
2. Nesta tela podemos filtrar as informações por Grupo de peças. 
3. Nesta tela podemos visualizar as informações na grade, onde podemos exportar as informações para Excel, clicando no botão de ícone no formato de "X".

Image Added

Figura 6: Relatório de Itens – TRC

Para visualizar as informações, tanto da grade quanto do relatório, devemos informar os filtros e clicar no botão "OK".

Configuração do Linx DMS Integrador

1. Execute o programa LDIConfig.exe, existente na pasta principal do Linx DMS Integrador;
2. Acesse o menu “Configuração > AGCO”;
3. Na aba “Configuração”, preencha os dados de acesso ao banco de dados;

Image Added

Figura 7: Tela de configuração do banco de dados

Clique em “Testar Conexão”.
Prosseguir somente ser for apresentada a mensagem “Conexão realizada com sucesso!” Caso não ocorra, verifique se os parâmetros informados são os mesmos utilizados pelo Linx DMS;

Image Removed

Image Added

Figura

8: Tela de configuração da transmissão de arquivos

Preencha os dados para o acesso ao serviço.

 Opções disponíveis:

• Nome: Nome do arquivo externo da configuração;
• Descrição: Descrição da configuração;
• Log Detalhado: Indicativo para gravação do log detalhado no banco de dados;
• Log de XML: Indicativo para gravação dos XML’s de comunicação no banco de dados;
• Log de SQL: Indicativo para gravação dos comandos executados no banco de dados;
• URL: Endereço da API de autenticação fornecido pela AGCO;

• Interfaces: Interfaces que deseja transmitir;

IMPORTANTE:

Clique em “Next”;

Finalize as configurações, clicando em “Next” e depois em “Finish”;

Image Modified

Figura

9: Tela de conclusão das configurações

• Reinicie o serviço do Linx DMS Integrador;

Reiniciar o serviço do Linx DMS Integrador

1. No Windows, pressione a tecla do logotipo do Windows + ”R”;
2. Digite services.msc e clique em “Ok”;
3. Localize e clique sobre o serviço “Linx DMS Integrador”;
4. Clique em “Reiniciar o serviço”;
5. Após este procedimento, o status do serviço deve continuar como “Em Execução”.

Image Modified

Figura

10: Tela do serviço

A partir da conclusão das configurações, o Linx DMS Integrador é o responsável por efetuar a comunicação com o WebService da montadora, através de configurações específicas.
Por ele é realizada a transmissão de todos os dados, que se enquadrem com as características previamente explicadas neste manual, com as características abaixo:

Realizada periodicamente.

Leva em consideração a quantidade de minutos configurada para realizar o início do processo de transmissão.

Dados transmitidos

• DMS-01: Transmitido quando a busca periódica identificar alguma movimentação de estoque de peça.
• DMS-02: Transmitido quando a busca periódica identificar uma primeira compra, uma primeira data de disponibilidade ou a peça for atualizada (cadastro novo ou atualização em cadastro existente);
• DMS-03: Transmitido quando a busca periódica identificar uma nova compra (pedido) ou alteração em compra(pedido); e quando for identificada transferência entre filiais.
• DMS-04: Transmitido quando a busca periódica identificar uma venda, pedido de venda e/ou pedido de venda for aberto e salvo (balcão e oficina) e sempre que essas informações sofrerem uma alteração;
• DMS-05: Transmitido quando a busca periódica identificar uma venda perdida por falta de estoque.
• DMS-06: Transmitido quando a busca periódica identificar que a DMS-03, DMS-04 e DMS-05 for enviada. O cadastro do cliente sempre é enviado junto destas transmissões.

 

Conforme a comunicação é realizada, o Linx DMS Integrador envia mensagens para o correio interno informando o andamento da execução. A mensagem será enviada para o usuário informado no parâmetro “Usuário para notificações da integração TRC” do cadastro Manutenção de Parâmetros AGCO.

Image Removed

Figura 10: Exemplo de correio interno

Monitor de Log do Linx DMS Integrador

No LDIConfig, acesse o menu “Configuração > Monitor Log de Execução”:

Image Removed

Figura 11: Monitor do Log de Execução do Linx DMS Integrador

Nesta tela é apresentado o log das integrações em tempo real. O tempo de atualização pode ser configurado na barra superior do programa.
Os logs referentes ao processo de Integração do TRC são identificados pelo módulo eLDITRCAGCO.exe.
A coluna "Tipo" apresenta o tipo do log gravado. Os tipos "XML" e "SQL" permitem uma consulta detalhada do arquivo ou comando respectivamente.
O botão "Pesquisar logs anteriores" permite que o histórico seja consultado.

Image Removed

Figura 12: Pesquisa em Logs – Aba Consulta

Nesta tela é possível filtrar os dados do log conforme a necessidade do usuário.
Ao selecionar o filtro e clicar em "Pesquisar", será apresentada a aba Resultado com os dados da pesquisa:

Image Removed

• por falta de estoque.
• DMS-06: Transmitido quando a busca periódica identificar que a DMS-03, DMS-04 e DMS-05 for enviada. O cadastro do cliente sempre é enviado junto destas transmissões.

Correio Interno

Conforme a comunicação é realizada, o Linx DMS Integrador envia mensagens para o correio interno informando o andamento da execução. A mensagem será enviada para o usuário informado no parâmetro “Usuário para notificações da integração TRC” do cadastro Manutenção de Parâmetros AGCO.

Image Added

Figura 11: Exemplo de correio interno

Monitor de Log do Linx DMS Integrador

No LDIConfig, acesse o menu “Configuração > Monitor Log de Execução”:

Image Added

Figura 12: Monitor do Log de Execução do Linx DMS Integrador

Nesta tela é apresentado o log das integrações em tempo real. O tempo de atualização pode ser configurado na barra superior do programa.
Os logs referentes ao processo de Integração do TRC são identificados pelo módulo eLDITRCAGCO.exe.
A coluna "Tipo" apresenta o tipo do log gravado. Os tipos "XML" e "SQL" permitem uma consulta detalhada do arquivo ou comando respectivamente.
O botão "Pesquisar logs anteriores" permite que o histórico seja consultado.

Image Added

Figura 13: Pesquisa em Logs – Aba Consulta

Nesta tela é possível filtrar os dados do log conforme a necessidade do usuário.
Ao selecionar o filtro e clicar em "Pesquisar", será apresentada a aba Resultado com os dados da pesquisa:

Image Added

Figura 14: Pesquisa em Logs – Aba Resultado

Consulta Pesquisa de Log - LINXDMS WEB

Acesse o Menu Fabrica - AGCO - TRC - Pesquisa Log TRC

 Na tela inicial não é obrigatório informar nenhum filtro, os dados iniciais já começam com a empresa e revenda logada. 

Image Added

Figura 15: Consulta do Log de Envio de TRC

Após clicar no botão pesquisa, o usuário será direcionado para a aba resultado caso haja retorno do endpoint, caso a pesquisa retorne sem dados, será apresentado uma mensagem na tela. 

Para visualizar os registros de detalhes exceção, é necessário selecionar um registro na tabela de Resultados.

E para visualizar os registros da requisição JSON, basta seleciona o registro na tabela de exceção.

Caso o registro da tabela de resultado seja desmarcado, as tabelas abaixo serão limpas e todo o processo de seleção necessita ser refeito. 

Image Added

         Figura 16: Consulta do Log de Envio de TRC - Resultado

Conteúdo do pacote