TRC

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

Atenção: Caso sua concessionária seja composta por matriz e filial(is), recomendamos executar a “Carga Inicial” uma Revenda por vez.

Considerando a quantidade de informações transmitidas durante a carga inicial, o processo de comunicação entre Revenda e Montadora poderá demorar várias horas.

 Image AddedTabela 1: Fluxo 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 mesmos 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;

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.

• 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.
• Nesta tela, é possível exportar para Excel os itens da grade para uma futura conferência, para isto, é necessário apenas clicar no botão com ícone do Excel.

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:

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;

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 Modified

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

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 Modified

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 Removed

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

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

• Preencha os dados para o acesso ao serviço.

 Opções disponíveis:

IMPORTANTE: Este endereço será utilizado como base para o endereço de todas as comunicações realizadas;

1. Usuário: Usuário para autenticação fornecido pela AGCO;
2. Senha: Senha para autenticação fornecido pela AGCO;
3. Agendamento:

IMPORTANTE:

1. O botão “Executar Manualmente” efetua a comunicação com a AGCO sem a utilização do serviço do Linx DMS Integrador.
2. A configuração criada será utilizada para todas as revendas.

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

Image Removed

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

• Reinicie o serviço do Linx DMS Integrador;

Observação: Recomendamos o reinício do serviço do Linx DMS Integrador após a realização de todas as Cargas Iniciais necessárias.

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 Removed

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 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 Removed

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 Removed

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 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;

Clique em “Next”;

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

Image Added

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

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 Added

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.

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