Possíveis erros na integração de Ordens de Serviço entre PDG e Solution ERP

Versão: 12.007.005

1 – ERRO – DMS:E014 – Erro ao inserir ordem de serviço: Preço unitário não informado

Quando no Solution, o cadastro do serviço estiver definido como preço manual e o técnico utilizar esse serviço na OS, a tela exige que o técnico preencha o valor do serviço.

No PDG, ao incluir um serviço na OS, não existe campo de preço para o técnico informar. Devido a isso, ao utilizar no PDG, um serviço que esteja configurado como preço manual, ele será enviado ao ERP sem preço e o ERP não terá como calculá-lo.

Esse erro acontece porque o serviço utilizado possui como Tipo de Cálculo de Preço a opção “Preço Manual”, que não é aceito no processo de integração.

Orientações

Não utilizar serviços configurados com Preço Manual. 

Para serviços vinculados ao SRT, configurar um serviço com outro tipo de cálculo de preço através do Módulo Configurações > Integração > API > Integrações(rotina 2877).

Hierarquia para definição do tipo de cálculo de preço de serviço:

1 – Serviço (2025);

2 – Classe (2024);

3 – Tipo de OS (2026).

Opções de tipo de cálculo de preço para serviços:

• Preço fixo: Considera o valor informado na lista de preço vinculada ao tipo de OS. 
• Horas vendidas x Valor da hora: Considera a quantidade de horas informadas no campo “Horas vendidas” e multiplicada pelo valor da “Base valor hora”.
• Tempo padrão x Valor da hora: Considera o tempo padrão do cadastro do serviço multiplicado pelo valor da “Base valor hora”.
• Preço manual: O campo do preço fica liberado para digitação no momento da alocação.
  • ⚠️Não aceito na integração com o PDG

Para mais informações, acesse: Tipos de cálculo de preço para Serviços

2 – ERRO – Request {GET SYNC VEHICLES}: ended erro

Erro encontrado no endpoint /autenticate; 400; Não foi possível processar a requisição, tente novamente.

Esse erro ocorre quando o ERP do cliente está inacessível ou bloqueado para acesso externo pela rede. 

Orientações

Verificar se o ERP está online e acessível pela rede local. 

Validar se há bloqueios de firewall, VPN ou regras de rede impedindo o acesso externo. 

Confirmar se o endpoint /authenticate está respondendo corretamente.

3 – ERRO – Não foi possível sincronizar a Ordem de Serviço: Workshop do not exists in Digital Jobcard

Esse erro ocorre no momento do envio bidirecional, quando o sistema não encontra o número do Dealer configurado para a filial. Sem essa informação, não é possível enviar a OS ao PDG. 

Orientações

Acesse o Módulo Módulo Configurações > Integração > APP’s > PDG > Parâmetros (rotina 2794) e insira o número do Dealer e associar à filial correta.

Após salvar, realize uma nova tentativa de envio da OS, através das Ordens de Serviço (rotina 2292), no botão “Enviar ao PDG”.

4 – ERRO – DMS:E014 – Erro ao inserir ordem de serviço: Vendedor não encontrado

Esse erro ocorre porque o responsável pela abertura da O.S no PDG não está definido como vendedor no ERP. Durante a integração, o sistema tenta vincular esse usuário como vendedor da OS, mas não encontra o cadastro correspondente. 

Orientações

Acesse o Módulo Administrativo > Configurações > Funcionário (rotina 99030), selecione o funcionário correspondente e clique no botão “Funções”. Clique no ícone do “+” e adicione a função “Vendedor” para esse funcionário.

Salve as alterações e tente novamente a integração. 

5 – ERRO – Datas ou horários inseridos não consistentes

Esse erro ocorre quando os apontamentos ou a previsão de entrega possuem horários inválidos, como registros lançados para datas futuras ou em conflito com outros apontamentos já existentes. Também pode acontecer quando a data de previsão de entrega está anterior ao dia atual.

Orientações

No PDG, verifique os apontamentos já cadastrados para a OS.

Ajuste a data e hora dos apontamentos para que não estejam em conflito entre si. 

Certifique-se de que não existam apontamentos em datas futuras. 

Confira se a data de previsão de entrega não está anterior ao dia vigente. 

Após corrigir as inconsistências, tente novamente a integração.

6 – ERRO – DMS:E014 – Erro ao inserir ordem de serviço: Informe um vendedor válido

Esse erro ocorre quando o funcionário que abriu a OS no PDG não possui a função de “Vendedor” cadastrada no ERP. Durante a integração, o sistema exige que o responsável esteja vinculado como vendedor, e ao não encontrar, gera o erro. 

Orientações

Acesse o Módulo Administrativo > Configurações > Funcionário (rotina 99030), selecione o funcionário correspondente e clique no botão “Funções”. Em seguida, clique no ícone do “+” e adicione a função “Vendedor” para esse funcionário.

Salve as alterações e tente novamente a integração. 

7 – ERRO – DMS:E015 – “Erro ao atualizar ordem de serviço: Erro encontrado no endpoint /authenticate 0”

Esse erro indica uma falha de conexão entre o PDG e o ERP da concessionária.
Na maioria das vezes, ocorre porque o servidor onde o ERP está instalado não está disponível ou não responde externamente.

Orientações

Verifique se o ERP está online e acessível pela rede local.

Valide se há bloqueios de firewall, VPN ou regras de rede impedindo o acesso externo. 

Confirme se o endpoint /authenticate está respondendo corretamente. 

8 – ERRO – DMS:E003 – “Erro ao consultar cadastro de veículos próprios”

Ocorre quando o veículo informado na OS não é encontrado no ERP.
Geralmente acontece porque o usuário informou um chassi de veículo próprio da empresa que não está cadastrado no banco de dados do ERP.

Orientações

Verifique se o chassi do veículo informado nas saídas do PDG está cadastrado no ERP.

Esse cadastro deve ser feito como veículo próprio da empresa, utilizado para deslocamento de mecânicos em campo, através do Modulo Oficina > Cadastros > Veículo > Atendimento (rotina 2022).

9 – ERRO – “Não foi possível sincronizar a Ordem de Serviço: Exception in Bi-Directional Flow: query did not return a unique result 2; nested exception is javax.persistence.NonUniqueResultException: query did not return a unique result: 2”

Esse erro ocorre quando o processo de sincronização da Ordem de Serviço no PDG encontra resultados duplicados em uma consulta, gerando inconsistência no fluxo bidirecional de dados.

Orientações

O erro deve ser comunicado diretamente ao suporte do PDG.

Deve-se abrir um ticket junto ao PDG informando o ocorrido.

Caso seja necessário apoio adicional, o time do PDG entrará em contato por e-mail.

10 – ERRO – “Não foi possível sincronizar a Ordem de Serviço: Ordem de Serviço não pode ter peças sem serviço vinculado”

Esse erro ocorre quando há tentativa de sincronizar uma OS que possui peças sem vínculo com serviços.

No PDG e no ERP, todas as peças precisam obrigatoriamente estar associadas a um serviço para que a sincronização seja validada.

Orientações

Acesse a OS no ERP através do Módulo Oficina > Ordens de Serviço > Ordens de Serviço (rotina 2292), selecione a OS com erro e clique no ícone do lápis.

Acesse a aba “Peças”, no produto listado, clique no ícone do lápis e informe o serviço correspondente.

Salve as alterações e reprocesse a sincronização após o ajuste.

11 – ERRO – “Não foi possível sincronizar a Ordem de Serviço: Vehicle not found on DJC”

Ocorre quando o veículo do cliente não é encontrado no DJC.
O cadastro de veículos no DJC é realizado via processo de agendamento automático, que ocorre uma vez por dia, durante a noite.

Orientações

Verifique se o veículo do cliente já existe no DJC.

Caso o veículo tenha sido cadastrado antes da abertura da OS, ele somente será migrado para o DJC na próxima execução noturna do agendamento.

Se necessário, aguarde a sincronização automática para que o veículo esteja disponível. 

12 – ERRO – “Não foi possível sincronizar a Ordem de Serviço: Exception in Bi-Directional Flow: ids for this class must be manually assigned before calling save(): capgemini.cnh.commons.model.workshop.WorkshopUser; nested exception is org.hibernate.id.IdentifierGenerationException: ids for this class must be manually assigned before calling save(): capgemini.cnh.commons.model.workshop.WorkshopUser”

Esse erro ocorre devido a uma falha na integração do lado do PDG, relacionada ao cadastro de identificadores no fluxo bidirecional.
Não se trata de um problema de configuração ou operação no ERP.

Orientações

O erro deve ser comunicado diretamente ao suporte do PDG.

Trata-se de um retorno gerado pelo próprio PDG. 

Caso seja necessário, o time do PDG entrará em contato solicitando informações adicionais por e-mail.

13 – ERRO – “Não foi possível sincronizar a Ordem de Serviço: Cliente XXX não encontrado no DJC”

Normalmente ocorre quando o cliente foi cadastrado apenas no sistema Solution e a integração ainda não enviou os dados ao PDG ou quando há alguma inconsistência de identificação (ID, CNPJ, código) entre os dois sistemas.

Orientações

É necessário que o cliente entre em contato diretamente com o suporte do PDG, pois o cadastro e controle de clientes do lado deles são de responsabilidade do sistema PDG.

Somente o PDG poderá confirmar se o cliente realmente existe no banco de dados deles, podem corrigir possíveis erros de integração ou então liberar o cadastro, caso esteja bloqueado ou pendente.

14 – ERRO – Caused by: java.lang.ArrayIndexOutOfBoundsException: 1 >= 1

Ao tentar enviar uma OS ao PDG, sendo que esta cumpriu com todas as obrigatoriedades para a integração, ocorre uma queda no sistema em que o ‘caused by’ está descrito acima.

O mecânico ou vendedor informado na OS está apenas com um nome genérico, e o PDG obriga a informar nome e sobrenome dos mecânicos e vendedores, portanto as OS com nomes fictícios não serão enviadas e o sistema acaba se perdendo quando procura o sobrenome dos envolvidos na OS.

Orientações

O mecânico ou vendedor deve sempre ser o funcionário responsável, com nome e sobrenome cadastrados. 

DÚVIDA – Como faz para abrir a OS no PDG informando a tipo de OS do ERP ?

O campo subtipo de pagamento é equivalente ao tipo de OS cadastrados no ERP, na rotina 2026. Nesse campo irá apresentar todos os tipos de OS vinda do ERP.

15 – ERRO – “Não foi possível sincronizar a Ordem de Serviço: o usuário xxx bloqueou a ordem no DJC.”

O sistema não conseguiu sincronizar a OS porque ela está bloqueada (travada) pelo usuário no DJC.
Ou seja, alguém está com a ordem aberta ou em edição no sistema DJC, impedindo que outro processo (como a sincronização ou faturamento) seja executado.

Orientações

Solicitar ao usuário mencionado no erro para fechar ou liberar a OS no DJC, e então tentar sincronizar novamente.

16 – ERRO – Ordem de Serviço: Exception in Bi-Directional Flow: ids for this class must be manually assigned before calling save().”

(Exception in Bi-Directional Flow: os IDs para esta classe devem ser atribuídos manualmente antes de chamar o método save().)”

O erro indica que o sistema tentou salvar um registro da Ordem de Serviço sem que o ID (identificador único) estivesse previamente definido. 
Em processos de integração ou sincronização (como no fluxo bidirecional entre sistemas), esse ID precisa ser informado manualmente antes da gravação dos dados, caso contrário o salvamento é interrompido e a operação falha. 

Identificado um desvio entre o ID do usuário de abertura da OS no PDG e o ID correspondente no ERP. 

Orientações

Verifique o ID do usuário responsável pela abertura da Ordem de Serviço. 
Caso haja alguma dúvida ou inconsistência nas informações, deve entrar em contato com a CNH para validação.