Integração de Ordens de Serviços entre concessionárias e montadora BYD.
Produto | Post Job Order |
|---|---|
Menu | BYD |
Data |
|
Autor | Flavia Lobo Alves |
Área | Automotivo |
Integrar Ordens de Serviços entre concessionárias e montadora BYD.
Esta atualização destina-se a todas as concessionárias da marca BYD.
Para iniciar a integração será necessário cadastrar as credenciais de acesso, sendo que essas credenciais devem ser obtidas junto à montadora. Sem essas informações a integração não será executada.
Uma vez cadastradas as credenciais, deve-se ativar as integrações pertinentes a cada processo em cada sub-aba apresentada logo abaixo.
A integração será feita para todas as revendas da marca BYD.
O processo transmitirá as ordens de serviço para a BYD em 03 momentos:
- Na abertura de OS's.
- No fechamento de OS's.
- No cancelamento de OS's.
Parâmetros:
1. Manutenção de parâmetros.
2. Manutenção de modelos - Inclusão dos campos: BYD_SERIES_CODE, BYD_SERIES_NAME, BYD_MODEL_CODE, BYD_MODEL_NAME
3. Manutenção Unidade de medida – Depara para unidade de medida (BYD)
4. Manutenção Mão-de-obra – indicação de mão-de-obra original (BYD)
5. Manutenção Categoria de OS – Depara para Repair Order (BYD)
6. Informações obrigatórias nas Ordens de serviço.
7. Reenvio/Monitoramento das Integrações.
8. Reiniciar o IIS.
1. Manutenção de Parâmetros:
Nesta tela deverão ser cadastrados os parâmetros para integração BYD conforme as sub-abas apresentadas
Menu Fábrica > BYD > Parâmetros Dealer
Figura 1: Manutenção de Parâmetros Dealer
Informações de Concessionária BYD
OrgCode: código que identifica a concessionária na montadora para integração de leads e veiculos.
DealerCode: código que identifica a concessionária na montadora para integração de Ordens de serviço.
As demais informações, OrgName, OrgClass, Register Tax No(CNPJ)e UpperOrgCode serão capturadas quando a primeira integração for executada.
O campo "Habilita Integração API BYD" Ativa as integrações selecionadas e ativadas nas sub-abas.
Subabas a serem preenchidas para a integração correta das Ordens de Serviços:
Auth:
Credenciais de acesso BYD
App_id e app_secret – Preencher as credenciais de acesso para integração em todas revendas.
Cadastrar em todas as revendas mesmo que as credenciais forem idênticas.
Informações disponibilizadas pela montadora BYD.
Url Token: https://uscrm.byd.com/api/open_api/get_token
JobOrder:
Inserir as Urls para integração com a montadora e habilitar a API
Url Job Order: https://bgate.bydauto.com/api/repairOrder/applyRepairOrder
O campo Intervalo determina de quanto em quanto tempo a API será executada.
É possível verificar a data do último envio.
Figura 2: Manutenção de Parâmetros Dealer - JOB ORDER
2. Manutenção de Modelos
No cadastro de modelos deverá ser informados os campos: BYD_SERIES_CODE, BYD_SERIES_NAME, BYD_MODEL_CODE, BYD_MODEL_NAME, correspondentes a cada modelo.
Informações disponibilizadas pela montadora BYD.
Menu: Veículos > Cadastros > Modelos
Figura 3: Manutenção de Modelos
3. Manutenção Unidade de medida
A BYD possui tabela própria de Unidade de medida onde será necessário cadastrar a unidade de medida (BYD) correspondente na tabela de unidade de medida do LinxDMS.
Peças > Cadastros > Unidade de medida
Campo: "BYD PORT UNIT"
Figura 4: Manutenção de Unidade de medida
4. Manutenção Mão-de-obra
No cadastro de mão-de-obra é necessário indicar se é original do fabricante ou não.
Menu: Oficina > Cadastros > Mão-de-obra
Figura 5: Manutenção de Mão-de-obra
5. Categoria de OS
A BYD possui tabela própria de tipo de reparo (Repair Type) onde será necessário cadastrar cada Repair Type (BYD) correspondente na tabela de categoria de OS do LinxDMS.
ATENÇÃO: Não efetuar o depara para as categorias de garantia. As garantias não serão tratadas nesta integração.
Menu: Oficina > Cadastros > Categoria de OS
Figura 6: Manutenção de Categoria de OS
OBS: Após inserção dos parâmetros, deve-se reiniciar o IIS. Ver seção "8. Reiniciar o IIS" neste manual.
6. Informações obrigatórias nas Ordens de serviço.
Para utilização desta integração é obrigatória a abertura de OS por tipo e o preenchimento das seguintes informações:
- Nome do condutor – Atendimento Oficina - Aba Dados Gerais .
- Diagnostico da solicitação – Manutenção Ordem de serviço - Aba Solicitações - sub menu (Diagnostico/ Ação / Reparo)
- Ação reparo da solicitação - Manutenção Ordem de serviço - Aba Solicitações - (Clicar com botão direito) sub menu (Diagnostico/ Ação / Reparo)
- Número da Revisão efetuada (Quando a OS for tipo revisão) - Manutenção Ordem de serviço - Aba Dados Gerais > Parâmetro
"Deve-se indicar o número da manutenção (primeira, segunda, terceira...) por meio de um número inteiro".
- Número da Revisão efetuada (Quando a OS for tipo revisão) - Manutenção Ordem de serviço - Aba Dados Gerais > Parâmetro
Figura 7 - Número da Revisão e Nome do condutor do veículo
Figura 8 - Diagnostico da solicitação e Ação reparo da solicitação
7. Reenvio/Monitoramento das Integrações:
Tela de monitoramento das integrações com a montadora.
A tela disponibiliza opções de reenvio individual, ou seja, uma ordem de serviço por vez, e possibilita o reenvio de todas as ordens de serviços existentes na base de dados da concessionária.
Menu: Fabrica > BYD > Monitoramento OSs BYD
Figura 9: Manutenção de Categoria de OS
8. LOG LINXDMSWEB
LOG das integrações BYD para verificação.
Figura 10 - LOG LINXDMSWEB
9. Reiniciar o IIS
ATENÇÃO: Após a parametrização será necessário reiniciar o IIS para que o serviço de integração possa iniciar.
Acessar o servidor onde se encontra instalado o Linx DMS Web.
No servidor, abra o 'CMD' como administrador:
Execute o comando 'iisreset' (sem aspas):
Certifique-se de que o comando foi executado com sucesso (parando e iniciando os serviços):
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.