Linx DMS Integrador | Manual de Configuração JSON Massey

O escopo do processo visa a Integração de notas fiscais de venda e devolução de venda que ocorram das revendas para o cliente final, e notas fiscais de transferência entre as filias, transmitindo os dados para a AGCO.

Esta atualização destina-se a todas as concessionárias da marca Massey.

Enviar para a AGCO informações de Notas Fiscais (Venda, Devolução e Transferência) através de um Webservice disponibilizado para esta comunicação e utilizando o formato JSON.

Considerar as notas fiscais de entrada (devoluções), saída (vendas) e transferência entre filiais aptas a serem integradas, e que contenham produtos Massey novos a serem integrados, conforme definido no cadastro de produto. Somente para notas transmitidas e autorizadas pela SEFAZ, após o prazo máximo definido para o cancelamento. Não está previsto nenhum tratamento sobre o cancelamento de notas.

1. Venda

• Produto que foi faturado para um cliente final.
• Produto que foi faturado para outra concessionária AGCO não deve ser enviado como venda e sim como transferência

2. Devolução

• Devolução de um produto do cliente final para a concessionária.
• Devoluções da concessionária para a AGCO não devem ser enviadas

3. Transferência

• Transferência entre filiais ou transferência de uma concessionária para outra.

Atenção! Caso alguma nota de Devolução de Venda não seja eletrônica (Nota Fiscal de Produtor em Bloco), a mesma não será integrada.
Neste caso, o concessionário deve abrir um ticket para a AGCO solicitando a devolução do produto ao estoque, e então a nova Nota Fiscal de Venda que será emitida deste produto será integrada.

Uma mensagem de correio interno será enviada para o usuário informado na configuração do Linx DMS Integrador, sempre que uma Nota Fiscal for transmitida.

Configuração do Linx DMS Integrador

Abra o programa LDIConfig.exe que fica em c:\LinxDMSIntegrador. Acesse o menu “Configuração > JSON Massey”. Após cada passo relacionado a seguir, clique no botão Next.

Na tela “Configurações”, informe os campos referentes ao banco de dados que serão acessados para buscar as informações;

Figura 1: Configurações – Banco de dados

No caso do Banco de Dados “Informix”, no campo “Host”, informe o nome da instância de produção. Exemplo: ol_standard;

Após informar todos os dados, clique no botão “Testar conexão” para verificar se o sistema irá conseguir se conectar com o bando de dados;

Figura 2: Conexão realizada com sucesso

Importante: Caso a conexão com o banco de dados não seja realizada com sucesso, verifique os campos informados, pois alguma informação não foi digitada corretamente.

Na tela “Dados de Configuração”, informe os dados para cadastrar a configuração desejada:

Figura 3: Configurações - Comunicação

Campos:

1. Nome: Informe o nome da configuração. O nome a ser informado é de livre escolha da concessionária. Ex: NF_Massey;

2. Descrição: Informe a descrição da configuração. Ex: Envio dos dados de NF-e Massey;

3. Url: Informe o endereço url do serviço para envio dos dados;

4. Url Token: Informe o endereço url do serviço para obter o token de autenticação;

5. Usuário: Informe o nome de usuário do WebService da Massey;

6. Senha: Informe a senha do usuário do WebService da Massey;

7. Tempo Máximo para cancelamento de nota fiscal no Sefaz: Este campo considera o tempo definido pelo cliente antes de enviar as informações das notas fiscais. Se a nota for cancelada antes do tempo definido o sistema não envia nada;

8. Agendamento: O agendamento poderá ser configurado de duas maneiras:

   • Agendamento Diário: Informe os dias e o horário de exportação das informações;

   • Agendamento por Intervalo: Informe o intervalo de minutos de exportação das informações;

9. Data da última execução: Data a ser considerada como último envio executado.

10. Usuário para receber as notificações: Clique no botão ao lado do campo para selecionar um usuário que receberá as notificações da execução do integrador. Será enviado uma mensagem de correio sempre que uma nota for integrada, ou ocorrer algum erro durante a integração.

11. Selecione também os campos Log Detalhado, Log de XML e Log de SQL, para que todos os dados sejam registrado no log de execução.

Figura 4: Seleção de usuário

Na tela de conclusão, clique no botão “Finish” para concluir e salvar a configuração. O sistema deve fechar a tela;

Figura 5: Configurações - Conclusão

Acesse na barra de ferramentas do Windows, menu “Iniciar > Painel de Controle > Ferramentas Administrativas > Serviços”. Localize e clique sobre o serviço instalado “Linx DMS Integrador”.

Figura 6: Serviço (local)

Clique na opção “Reiniciar” e aguarde concluir o processo.

A partir deste momento o sistema enviará os dados das NF-e via JSON para Massey.

Importante: Caso os registros não estejam sendo enviados, verifique se o serviço do Linx DMS Integrador está ativo.

Após a realização das configurações o sistema estará pronto e realizará o envio automático dos dados das NF-e via JSON de notas fiscais de veículo para o WebService definido nos parâmetros.

Configuração dos parâmetros do Fábrica.

Conforme a regra definida pela AGCO, os produtos que forem faturados para outra concessionária AGCO deverão ser enviados como transferência, independente da origem da Nota Fiscal. Em virtude disso foi criado um parâmetro na manutenção de parâmetros do fábrica Massey para controle desses clientes, conforme descrito abaixo.

Abra o programa Fabrica.exe e acesse o menu “Fábrica > AGCO > Parâmetros” e em seguida a aba TRC.

Figura 7: Manutenção de Parâmetros Massey

Nesta tela existe o campo “Categoria Clientes p/Vendas entre Concessionárias” que deve ser preenchido com a categoria de clientes que será tratada com o caso explicado acima.

Acompanhando o status de integração das Notas Fiscais

Para acompanhar o status da integração das Notas Fiscais, e até mesmo retransmitir uma Nota Fiscal, acesso o programa Fábrica.exe, e em seguida o menu Fábrica > AGCO > Linx DMS Integrador.

Figura 8: Status de integração das Notas Fiscais

Informe os parâmetros de busca "Seleção de Notas Fiscais por Data" e ou "Seleção de Notas Fiscais por Número", em seguida quais os Tipos de Registros deseja que sejam retornados, e clique no botão Pesquisar. As Notas Fiscais localizadas serão listadas no grid. Para visualizar a mensagem de Retorno/Status, arraste a barra de rolagem do grid para a direita.

Para reenviar uma Nota Fiscal, marque a(s) nota(s) desejada(s) no campo "Sel.", a esquerda do grid, e clique no botão Transmitir. Será exibida a mensagem de "Registros processados com sucesso." e a(s) Nota(s) Fiscal(is) serão integradas no próximo intervalo de execução do integrador.

Figura 9: Mensagem de registros processados com sucesso

Os botões Todos e Nenhum pode ser usados para, respectivamente, selecionar todas ou nenhuma Nota Fiscal. O botão Limpar, pode ser utilizado para limpar os parâmetros de busca.

Monitor de Log

Abra o programa LDIConfig.exe que fica em c:\LinxDMSIntegrador. Acesse o menu “Configuração > Monitor do Log de Execução”.

Figura 10: Linx DMS Integrador

No programa “Monitor Log de Execução”, clique no botão Configurar Conexão para abrir a janela “Configuração de Conexão”.

Na janela aberta, preencha os campos com os dados de acesso da base que deseja monitorar.

Figura 11: Linx DMS Integrador – Conexão Banco de Dados

Clique em “Testar Conexão” para verificar se a comunicação com a base de dados está ok.

Figura 12: Mensagem de conexão realizada com sucesso

Ainda na tela do monitor é possível realizar filtros utilizando os campos presentes no menu superior, conforme explicado abaixo:

Campos para filtros:

1. Exibir Log: Informe se o log será exibido de forma resumida (status geral do processo, se concluiu com sucesso ou se apresentou erro) ou de forma completa (mostra todos os registros de envio e de retorno das informações);

2. Módulo - dll: Selecione o módulo eLDIJSONMassey.exe;

3. Processos: Informe o processo Exportação de Notas Fiscais Eletrônicas - Massey;

4. Configuração: Informe à configuração que deseja visualizar (Exemplo: NF_Massey);

5. Restrição do Log:

   • Selecione o intervalo de minutos que deseja visualizar na exibição do log (Exemplo: 60min);

   • Selecione a quantidade de registros que serão exibidos;

   • Marque a opção “Exibir Log Detalhado” caso deseje verificar as informações detalhadas dos registros processados.

Após a seleção dos filtros, o usuário deverá clicar no botão “Atualizar Log” para que os filtros possam ser aplicados à consulta.

Obs: Caso alguma das opções de “a” até “e” não seja preenchida, estes filtros não serão considerados na seleção das informações.

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

Com base nos filtros informados pelo usuário, o Monitor do Log de execução irá retornar as seguintes informações:

• • Data/Hora: Data e Hora da execução do processo;

  • Módulo: Nome do módulo que deu origem ao envio das informações;

  • Configuração: Descrição da configuração utilizada neste processo;

  • Descrição do Processo: Descrição padrão do processo de envio de XML para a Renault;

  • Mensagem Log: Mensagem indicativa do resultado da execução do processo. Por exemplo, as mensagens retornadas pela Renault para cada envio de arquivo XML;

  • Tipo: Poderá ser Normal, SQL ou XML. Normal é apenas uma mensagem informativa do evento que está sendo executado. SQL ou XML se referem à mensagem informativa e permitem que o usuário possa aplicar um duplo clique sobre o registro para visualizar o SQL de execução ou o XML descrito na mensagem.

Em caso de dúvidas sobre o conteúdo deste documento, entre em contato com o Suporte Nacional, através do site cliente.linx.com.br.