Produto | Linx DMS Apollo |
|---|---|
Menu | Fabrica GM Fabrica Linxdms Web Frente de Caixa |
Data |
|
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
https://apim.gm.com/api-0273/ws/rest/th/outbound/find/
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.
Arquivo | Processo | Menu | Arquivo Atual (exemplo) | Novo Formato Arquivo enviado pelo WS | Diretório onde será salvo para conferência (subpasta WEBSERVICE) | |
1 | AV | Aviso de Vendas | NFe | E68_AV163233.141 | GMBVEHSNOT_{TPCODE}_{BAC}_20240521093002240.141.gz | Diretório Saída GM Connect |
2 | DMS | Autogiro - Inf. Diária Peças | 41354 | E68_E68001.dms | GMBRIMDSPI_{TPCODE}_{BAC}_20240521093002240.dms.gz | Diretório Saída Autogiro |
3 | CO | Autogiro - Pedido Complementar | 41354 | E68_CO174226.129 | GMBRIMCORD_{TPCODE}_{BAC}_20240521093002240.129.gz | Diretório Saída Autogiro |
4 | VO | Autogiro - Pedido Emergência | 41354 | E68_VO174104.129 | GMBRIMEORD_{TPCODE}_{BAC}_20240521093002240.129.gz | Diretório Saída Autogiro |
5 | GBLOPTINRO | Repair Order | 41453 | E68_GBLOPTINRO-GlobalRepairOrder_Show_198627_20240514220052800.xml | GBLOPTINRO_{TPCODE}_{BAC}_20240521093002240.xml.gz | Diretório Saída Extrato |
6 | GBLPRTINVC | Parts Invoice | 41453 | E68_GBLPRTINVC-GlobalPartsInvoice_Show_198627_20240518220105540.xml | GBLPRTINVC_{TPCODE}_{BAC}_20240521093002240.xml.gz | Diretório Saída Extrato |
7 | GBLPRTINVT | Parts Inventory | 41453 | E68_GBLPRTINVT-GlobalPartsInventory_Show_198627_20240518220210164.xml | GBLPRTINVT_{TPCODE}_{BAC}_20240521093002240.xml.gz | Diretório Saída Extrato |
8 | GBLVEHINVT | Vehicle Inventory (Extrator Inventário) | 41591 | N43_GBLVEHINVT-VehicleInventory_Show_280436_20240508204501.xml | GBLVEHINVT_{TPCODE}_{BAC}_20240521093002250.xml.gz | Não está sendo utilizado |
9 | DDSPRTINVT | Parts Inventory | 41799 | J36_PartsInventory_Show_198563_20240506201357ET20240506191701144.xml | DDSPRTINVT_{TPCODE}_{BAC}_20240521093002250.xml.gz | Diretório Saída Extrator |
10 | DDSPRTINVC | Parts Counter Ticket | 41799 | J36_PartsInvoice_Show_198563_20240506201047209ET20240506191148068.xml | DDSPRTINVC_{TPCODE}_{BAC}_20240521093002250.xml.gz | Diretório Saída Extrator |
11 | DDSREPORDR | Service Repair Order | 41799 | J36_RepairOrder_Show_198563_20240505200801911ET20240505191032187.xml | DDSREPORDR_{TPCODE}_{BAC}_20240521093002250.xml.gz | Diretório Saída Extrator |
12 | DDSNRETAIL | Vehicle Sales | 41799 | J36_RetailDeliveryReporting_Process_198563_20240506200936ET20240506191125340.xml | DDSNRETAIL_{TPCODE}_{BAC}_20240521093002250.xml.gz | Diretório Saída Extrator |
13 | DDSVEHINVT | Vehicle Inventory | 41799 | E68_VehicleInventory_Show_198627_20240506200218ET20240506200241739.xml | DDSVEHINVT_{TPCODE}_{BAC}_20240521093002240.xml.gz | Diretório Saída Extrator |
14 | GMBPARTORD | Pedido de Peças (menu Peças) | 41340 | O84_PPO84001.137 | GMBPARTORD_{TPCODE}_{BAC}_20240521093002260.137.gz | Diretório Saída GM Connect |
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.
Arquivo | Processo | Diretório onde será salvo ( download ) | |
1 | AR | Retorno do Aviso de Vendas | Diretório Entrada GM Connect |
2 | R1 | Pedido de peças para reposição automática | Diretório Entrada Autogiro |
3 | R2 | Pedido de peças para reposição automática | Diretório Entrada Autogiro |
4 | CP | Cadastro de peças | Diretório Entrada GM Connect |
5 | SU | Substituição de peças | Diretório Entrada GM Connect |
6 | NP | Nota fiscal de peças | Diretório Entrada GM Connect |
7 | PV | Progresso de veículos | Diretório Entrada GM Connect |
8 | NV | Nota fiscal de veículos | Diretório Entrada GM Connect |
9 | RO | Itens Genuínos para Carga Inicial | Diretório Entrada GM Connect |
10 | THGMB1 | Descrição de códigos - Atualizações | Diretório Entrada GM Connect |
11 | THGMB2 | Tempos padrões - Carga Total | Diretório Entrada GM Connect |
12 | THGMB3 | Tempos padrões - Atualizações | Diretório Entrada GM Connect |
13 | THGMB4 | Descrição de códigos - Carga Total | Diretório Entrada GM Connect |
14 | POS | Peças obsoletas | Diretório Entrada GM Connect |
15 | POD | Peças obsoletas | Diretório Entrada GM Connect |
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.