Transmissão das OS´s de garantia através da integração Post Job Order.
| PRODUTOS | Linx DMS Principal |
|---|---|
| MENU | Linx DMS Fabrica > Fábrica > BYD > Parametros> Aba Repair Order |
| DATA |
|
| AUTOR | Produto Linx DMS |
| ÁREA | P&D Automotivo |
Esta atualização destina-se a todas as concessionárias da marca BYD.
Este documento tem por finalidade detalhar as adequações necessárias para atender o projeto Repair Order BYD, que é uma evolução do Job Order BYD.
Processos implementados :
- Obtenção dos dados para o cadastro/atualização de peças originais.
- Obtenção dos dados para o cadastro/atualização de serviços.
- Verificação dos dados do veículo durante o atendimento da oficina.
- Verificação e obtenção de campanhas sobre os veículos durante o atendimento da oficina.
- Consistência de peças e serviços originias para tipo de O.S. Garantia.
1 - Tipo de Serviço
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 tipo de seriço do LinxDMS.
Menu: Oficina > Cadastros > Tipo de Serviço
Figura 1: Manutenção de tipos de serviço
Garantia
| Repair Type Code | Repair Type Name in DCS (Portuguese) | Descrição |
| YBWX | Garantia Geral | Garantias com problemas de qualidade e/ou fabricação do veículo, que geram custos para a concessionária |
| CHARGER | Carregador | Defeitos de fabricação de carregadore |
| DJWX | Livre de débito | Garantias com problemas de qualidade e/ou fabricação do veículo, onde as peças são enviadas sem custo para o concessionário |
| JSXM | Campanha técnica | Tipo de garantia relacionado às campanhas técnicas onde há uma lista de chassis configurada no sistema |
| SYSP | Cortesia | Cortesia ao cliente, aprovada pelo time de operação de campo, quando o serviço não faz parte da garantia |
| CGBY | Free Regular maintenance | Campanha de revisão periódica grátis |
| BJSP | Peças balcão | Garantia para peças vendidas pela concessionária |
| SQWX | Manutenção pré-venda | Manutenção para veículos que ainda não foram vendidos |
Não Garantia
| Repair Type Code | Repair Type Name Portuguese |
| YBWXW | Reparo Geral |
| BPR | Funilaria |
| SGWX | Reparo de danos por acidente |
| PSM | Reparo de pré venda |
| CGBY | Regular maintenance |
| ACSS | Acessórios - Ordens relacionadas a acessórios |
| ITNL | Interna - Ordens internas |
Figura 2: Tabela fornecida pela BYD
2 - Parâmetros
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.
URLs fornecidas pela BYD
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 
Figura 3: 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 Pós Vendas :
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.
Repair Order:
--Parâmetros Gerais --
Url Repair Order: url da integração fornecida pela montadora : https://sadcsapi.bydauto.com
App Id : Identificador da aplicação fornecido pela montadora ( é o mesmo usado nas credenciais de Pós Vendas)
Secret Key: Chave fornecida pela montadora ( é o mesmo usado nas credenciais de Pós Vendas)
Request From: Campo que informa de onde está vindo a requisição, por padrão usar DEALER
Lang Type: A Linguagem utilizada para obter os dados por padrão pt-pt
Intervalo Serviço: intervalo para executar o processo de consulta de serviços (em minutos), mínimo 1440 (1 dia)
Último Envio Serviço: Refere-se a data que foi executado o processo pela última vez
Último Envio Peça: Refere-se a data que foi executado o processo pela última vez
Atualiza Descrição do Item: Se flegado vai atualizar a descrição das peças
--Parâmetros de Importação Padrão de Peças --
Marca: Marca das peças que vão ser importadas
Grupo: Grupo das peças que vão ser importadas
Índice de Preço: Índice das que vão ser importadas
Categoria: Categoria as peças que vão ser importadas
Unidade de Medida: Unidade de Medida das peças que vão ser importadas
Grupo de Desconto: rupo de Descontodas peças que vão ser importadas
3 - Ordens de serviço.
Ao ativar a aplicação serão transmitidas todas as O.S.s geradas na revenda, conforme sua situação. Para casa solicitação será gerado um registro com seu Repair Type correspondente determinado pelo Tipo de Serviço.
Depois disso 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.
4 - Fluxo
- Caminho: Oficina > Agendamento Oficina
- Após selecionar o cliente, quando for informado o veiculo, se o chassi for da marca BYD, o sistema irá consultar as campanhas cadastradas para o mesmo na base de dados da montadora. Caso haja, será apresentada uma tela com os dados.
Serviços, peças, descrição, data de inicio, fim.
“Informações fictícias apenas para fins ilustrativos" - Ao clicar no icone BYD, serão apresentados os detalhes (Solução e Orientação).
“Informações fictícias apenas para fins ilustrativos" - Ao clicar no botão "Criar Solicitação para Campanha", será gerada automaticamente uma solicitação do tipo de serviço cadastrado nos parâmetros da API.
Também serão inseridos os serviços e peças
“Informações fictícias apenas para fins ilustrativos"
“Informações fictícias apenas para fins ilustrativos" 
“Informações fictícias apenas para fins ilustrativos"
“Informações fictícias apenas para fins ilustrativos"- Após a geração da solicitação, não será possìvel alterar, incluir ou excluir as peças e serviços, eles são gerados pela campanha obtida na BYD.
“Informações fictícias apenas para fins ilustrativos"
- Caminho: Oficina > Agendamento Oficina
“Informações fictícias apenas para fins ilustrativos"- A partir da ativação da API Repair Order, nas solicitações do tipo Garantia, somente peças e serviços originais e associados ao SERIAL CODE do veículo poderão ser incluídos.
- Está associação é feita de forma exclusiva e automática através da API de importação de peças e serviços que ativada juntamente com os outros processos e segue as configurações realizadas na tela de parâmetros.
- Os dados do veículo estão disponíveis para consulta/manutenção da Ficha de seguimento, aba Inf. Adic. do Veículo, são atualizados automaticamente toda vez que for aberto um atendimento para o veículo ou manualmente atraves do botão "Carregar Informações"
“Informações fictícias apenas para fins ilustrativos"
- Na Abertura da O.S. :
- Quando o veículo tiver o combustível do tipo Hibrido, será obrigatório o preenchimento do campo Km Eletrico, sendo que não pode ser maior ou igual a Km total do veículo
“Informações fictícias apenas para fins ilustrativos"
- Se alguma solicitação do atendimento tiver o Tipo de Serviço que esteja associado ao repair type CGBY, então o campo Nro Revisão é de preenchimento obrigatório.
- O campo Condutor é obrigatório pra todos os atendimentos.
Obs : Os 3 campos serão apresentados na aba BYD
“Informações fictícias apenas para fins ilustrativos"
“Informações fictícias apenas para fins ilustrativos" - Ao gerar a O.S, a API do Job Order transmitirá automaticamente para a base de dados da Montadora, conforme o intervalo de execução informado nos parâmetros.
- Para cada solicitação incluída, será gerado um registro, formando o código com o Nro. da O.S + o Nro. da Solicitação.
- Na Abertura da O.S. :
4 - Conferência e Logs.
Para conferência do Log acesse: Linx DMS Principal > Configuração > Consulta Log Web
Em Processo selecione : Integração BYD
Em Operação selecione: JobOrder, RepairOrder
Clique em Pesquisar
“Informações fictícias apenas para fins ilustrativos"
Para Monitoramento das O.Ss, acesse Linx DMS Fabrica > BYD > Monitoramento de OSs BYD 
“Informações fictícias apenas para fins ilustrativos"
Além de monitorar o status de cada O.S é possivel efetuar o reenvio avulso ou de todas as O.S.
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.