Alterar a forma de transmissão de arquivos via WS para o ambiente DDS, pois a GM descomissionará o DataPower, até então utilizado. 

As transferências de arquivo serão via WebService.

Este programa destina-se a todas as concessionárias das marcas GM

Pré requisitos:

Parametrizar dados para comunicação com a GM:

Fabrica GM - Parâmetros - Gerais - Aba Transferência via Web Service 

Campos:

• Transferência de Arquivos via Webservice : quando marcado esse campo passa a fazer a transferência de arquivos via webservice.

      As informações da comunicação são fixas entre a Montadora e Linx:

• API Key Linx : DJUw7dZG
• Autorização Linx (Produção) : QlJMTlhfOTk5OTk5OkJ0Mm41TkpYcnFEU2U3Yw== 

ATENÇÃO : Estas credenciais são fornecidas pela GM ==> Definidas para cada DMS e podem expirar. Quando expirar, a GM irá comunicar e o usuário deverá alterar nos Parâmetros.

• URL Envio Unbond  https://apim.gm.com/api-0273/ws/rest/th/payload/v1/  
• URL Recebimento NroArquivos ( Outbound/Count ) : https://apim.gm.com/api-0273/ws/rest/th/outbound/find/count/LINX
• Recebimento Paginas (Outbound/metadata) : https://apim.gm.com/api-0273/ws/rest/th/outbound/find/metadata/LINX
• Recebimento Arquivo (Outbound/Download) : https://apim.gm.com/api-0273/ws/rest/th/outbound/download/LINX 
• Horário Recebimento Automático (Rôbo) : informar o horário em que o robô irá fazer o download automático dos arquivos.  Horário deve ser a partir de 10 minutos.
• Executar carga inicial a partir do dia: informar a partir de qual data todos os arquivos novos serão baixados.
• Envio /Recebimento em Ambiente de homologação : marcar somente se o cliente estive em homologação com a Linx e Montadora.

Parametrizar diretórios de envio e recebimento de arquivos (já devem estar parametrizados, pois o processo atual (via DataPower) utilizam estes diretórios).

Fabrica GM - Parâmetros - Gerais - Aba Diretórios

Funcionamento INBOUND:

Os arquivos serão gerados no diretório parametrizado em FabricaGM > Parâmetros > Gerais> aba Diretórios, na sub-pasta 'Webservice" e enviados via WebService para a GM.

ATENÇÃO : De tempos em tempos estes arquivos deverão ser excluídos do diretório pelo TI da Concessionária, pois estão sendo gravados para simples conferência.

Informações sobre operações de transferência realizadas no LinxDMS

Envio (Inbound)

1 -Geração do Aviso de Vendas

• Na emissão da nota fiscal (Frente de Caixa > Manutenção de Contatos) será gerado o arquivo de aviso de venda de veículos e transmitido para a montadora 
• No Cancelamento da Nota Fiscal Aviso de Vendas  (Linx DMS > Consultas/Relatórios > Operações Fiscais), será gerado o arquivo de Cancelamento do Aviso de Venda de veículos e transmitido para a montadora 
• Fabrica GM > Veículos > Aviso Vendas > Aviso de Vendas Veículos → Envio manual do Aviso de Vendas 

2 – Informação Diária de Peças

A transmissão via WebService será feita automaticamente pelo Agenda de Processos, conforme parametrizado em Fabrica GM > Parâmetros > Gerais, aba AutoGIRO.

O processamento Manual poderá ser feito através do menu Peças > Autogiro > Montagem do Arquivo para Transmissão > Informação Diária de Peças.

OBS:  esta opção só ficará disponível após 5 tentativas de envio automático sem sucesso.

3 – Fabrica GM - Peças - Autogiro – Montagem Arquivo Transmissão - Pedido /Complementar 

Ao enviar o arquivo é exibido a mensagem :

4 -Fabrica GM - Peças - Autogiro- Montagem Arquivo Transmissão – Pedido Emergência

Ao enviar o arquivo é exibido a mensagem :

5 –Fabrica GM - Pós-Vendas – Extrator Pós-Vendas - Geração - Repair Order – menu 41453 

Ao enviar o arquivo é exibido a mensagem :

6 –Fabrica GM - Pós-Vendas – Extrator Pós-Vendas - Geração - Parts Invoice – menu 41453 

Ao enviar o arquivo é exibido a mensagem :

7 –Fabrica GM - Pós-Vendas – Extrator Pós-Vendas - Geração - Parts Inventory – menu 41453 

Ao enviar o arquivo é exibido a mensagem :

8 -Fabrica GM - Veículos - Extrator Inventário Veículos: Menu 41591

Não está disponível:. Foi substituído pela versão 2.x  do Extrator.

9 -Fabrica GM - Extrator DDS – Dealer Data Share – Parts Inventory 

Ao enviar o arquivo é exibido a mensagem :

10 -Fabrica GM - Extrator DDS – Dealer Data Share – Parts Counter Ticket  

Ao enviar o arquivo é exibido a mensagem :

11 - Fabrica GM -Extrator DDS – Dealer Data Share – Service Repair Order 

Ao enviar o arquivo é exibido a mensagem :

12 -Fabrica GM - Extrator DDS – Dealer Data Share – Vehicle Sales 

Ao enviar o arquivo é exibido a mensagem :

 13 - Fabrica GM -Extrator DDS – Dealer Data Share – Vehicle Inventory 

Ao enviar o arquivo é exibido a mensagem :

 14 -Fabrica GM - Peças - Montagem Arquivos Transmissão - Montagem Pedido de Peças 

 Ao enviar o arquivo é exibido a mensagem :

Funcionamento OUTBOUND:

Os arquivos serão baixados no diretório parametrizado em FabricaGM > Parâmetros > Gerais> aba Diretórios, nos campos GM Connect e AutoGIRO.  O processo de download, incrementa as rotinas já existentes de processamento de arquivo. Essa nova função, faz o download dos arquivos necessários para execução das rotinas de processamento.

ATENÇÃO :  O usuário associado ao IIS do servidor onde está instalado o LinxDMS Web, deve ter acesso de escrita e leitura aos diretórios parametrizados nos campos: Diretório Entrada GM Connect e Diretório Entrada AutoGIRO e adicionalmente este diretório deve ser configurado no sistema como um caminho de rede e não como um caminho local. 

Os usuários das aplicações desktop do LinxDMS precisam também ter acesso à pasta onde o LinxDMS Web está instalado, pois ambas as aplicações acessam este diretório para que as comunicações sejam efetivas

Se o diretório escolhido começar com letras ( C:, D:, E: e etc ), isso será um forte indício de que este é um diretório LOCAL e isso pode gerar erros, por isso, informe um diretório compartilhado, ou seja, que inicia normalmente com \\nomeDoPc\DiretorioXXX.

O diretório compartilhado deve estar OBRIGATORIAMENTE no SERVIDOR

A ausência das configurações acima pode acarretar em Erro 500 internal server error, ou semelhante, no momento da comunicação da aplicação!

Recebimento (Outbound)

1 - Fabrica GM -> Veículos -> Aviso Vendas -> Retorno Aviso de Vendas

  * O arquivo que será baixado nesta tela é: AR - Retorno do aviso de vendas

  Ao clicar em <Download Arquivos> será aberto as opções

    a) Novos, são os arquivos disponíveis, atualmente, na API 

    b) Retroativo, são os arquivos disponíveis de acordo com a data informada

    c) Após o download os arquivos serão listados na tela

2 -  Fabrica GM -> Peças -> Autogiro -> Processamento Arquivos

  Os arquivos que serão baixados nesta tela são:

    a) R1 - Pedido de peças para reposição automática 

    b) R2 - Pedido de peças para reposição automática

  O download será efetuado se a opção Efetuar Download estiver marcada.  Ao marcar a opção Retroativo, os arquivos que estiverem disponíveis, a partir da data informada em Data de Referência, serão baixados.

3 - Acessar menu Fabrica GM -> Peças -> Processamento Arquivos 

  Os arquivos desta tela são:

    a) CP - Cadastro de peças

    b) SU - Substituição de peças

    c) NP - Nota fiscal de peças

  O download será efetuado se a opção Efetuar Download estiver marcada.  Ao marcar a opção Retroativo, os arquivos que estiverem disponíveis, a partir da data informada em Data de Referência, serão baixados.

4 - Acessar menu Fabrica GM -> Veículo -> Processamento Arquivos

  Os arquivos desta tela são:

    a) PV - Progresso de veículos

    b) NV - Nota fiscal de veículos

  O download será efetuado se a opção Efetuar Download estiver marcada.  Ao marcar a opção Retroativo, os arquivos que estiverem disponíveis, a partir da data informada em Data de Referência, serão baixados.

5 - Acessar menu Fabrica GM -> Veículo -> Reprocessamento Arquivos

  Os arquivos desta tela são:

    a) PV - Progresso de veículos

    b) NV - Nota fiscal de veículos

  O download será efetuado se a opção Efetuar Download estiver marcada.  Ao marcar a opção Retroativo, os arquivos que estiverem disponíveis, a partir da data informada em Data de Referência, serão baixados.

6 - Robô

  A cada execução do Robô somente os arquivos novos serão baixados.  Na Carga Inicial, a partir da data informada, somente os novos arquivos serão baixados. 

  Os arquivos que poderão ser baixados, de acordo com disponibilidade da Montadora, são:

Download efetuado pelo robô e de forma manual

AR - Retorno do aviso de vendas
R1 - Pedido de peças para reposição automática
R2 - Pedido de peças para reposição automática
CP - Cadastro de peças
SU - Substituição de peças
NP - Nota fiscal de peças
PV - Progresso de veículos
NV - Nota fiscal de veículos

Download efetuado somente através do robô
RO - Itens Genuínos para Carga Inicial (Cadastrão de Peças)
THGMB1 - Descrição de Códigos - Atualizações
THGMB2 - Tempos Padrões - Carga Total
THGMB3 - Tempos Padrões - Atualizações
THGMB4 - Descrição de Códigos - Carga Total
POS - Peças Obsoletas
POD - Peças Obsoletas

ATENÇÃO :  Quando a carga inicial for executada, a informação da data parametrizada em Executar carga inicial a partir do dia, será apagada.

Conferência do Envio pelo Log

Para conferência da comunicação com a GM, verificar no Log Web:

Opção Configuração > Consulta Log Web

Filtrar o processo : 52 - Transmissão Arquivo GM por API

Poderá também filtrar a operação

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.