Descrição de Erros e Procedimentos
Informativos – Sucesso na Operação
Abaixo tabela com detalhamento de retornos indicando sucesso na operação.
Todas as mensagens de retorno satisfatório iniciam com “OK” seguido de numero sequencial para informar de forma detalhada qual operação foi bem sucedida e apresentar claramente no painel de controle da integração.
| CÓDIGO | DESCRIÇÃO | INSTRUÇÕES AO INTEGRADOR/CLIENTE |
|---|---|---|
| OK0001 | Consulta Efetuada com sucesso | |
| OK0002 | Veículo inserido com sucesso | |
| OK0003 | Dados do veículo alterados com sucesso | |
| OK0004 | Motorista inserido com sucesso | |
| OK0005 | Dados do motorista alterados com sucesso | |
| OK0006 | O Rastreador foi alterado com sucesso | |
| OK0007 | SM inserida com sucesso | |
| OK0008 | Dados da SM alterados com sucesso | |
| OK0009 | Operação realizada com sucesso. Verificar Alertas | A Operação foi realizada porém algumas restrições foram apontadas. Verificar painel de controle. |
| OK0010 | Dados do faturamento alterados com sucesso |
Informativas – Alertas
Abaixo tabela com detalhamento de retornos indicando alertas identificados no curso da operação.
Essas mensagens indicam que a operação requer análise mais apurada pois podem, de alguma forma, impactar em operações futuras do cliente.
Todas as mensagens de retorno de alertas iniciam com “WA” (warning) seguido de numero sequencial para informar de forma detalhada qual ocorrência deve ser observada, sendo apresentadas claramente no painel de controle da integração.
| CÓDIGO | DESCRIÇÃO | INSTRUÇÕES AO INTEGRADOR/CLIENTE |
|---|---|---|
| WA0003 | Informe pelo menos um Rastreador para o Veículo | Caso não tenha informação do rastreador não será possível realizar a Solicitação de Monitoramento |
| WA0004 | RENAVAM incorreto | O RENAVAM deve ter 11 caracteres numéricos e DV deve estar corretos |
| WA0005 | Chassi incorreto | O Chassi deve ter um total de 17 caracteres |
| WA0006 | Carroceria do veiculo não informada | Associado como "não definida". Importante providenciar a alteração |
| WA0007 | Dados para inclusão de sinal não informados | Caso não informe os dados para inclusao de sinal do rastreador não será possivel realizar a Solicitação de Monitoramento |
| WA0008 | Dados de faturamento não informados | Incluído veiculo como cobrança "por embarque". Importante revisar essa informação |
| WA0009 | Dados do proprietário não informados | Importante revisar essa informação |
| WA0010 | O Modelo do Veículo é inválido | Associado como "modelo não definido". Importante providenciar a alteração |
| WA0011 | A Marca da Carreta é inválida | Associado como "marca não definida". Importante providenciar a alteração |
| WA0012 | Identificação da Carreta é inválida | Associado como "outro SR". Importante providenciar a alteração |
| WA0013 | O Município de licenciamento informado é invalido | Associado como "município não definido". Importante providenciar a alteração |
| WA0014 | Informação se veiculo Ativo/Inativo é invalida | Incluído veiculo como "ativo". Importante revisar essa informação |
| WA0015 | Informação sobre tipo de faturamento é invalida | Incluído veiculo como cobrança "por embarque". Importante revisar essa informação |
| WA0016 | Informação sobre forma de faturamento é invalida | Incluído como Fixo-Frota. Importante revisar essa informação |
| WA0017 | Informação sobre forma de faturamento é invalida | Incluído como Fixo-Agregado. Importante revisar essa informação |
| WA0018 | Informado CNPJ o proprietário para veiculo próprio | Informação ignorada pela integração |
| WA0019 | Informado nome o proprietário para veiculo próprio | Informação ignorada pela integração |
| WA0020 | Informado telefone de contato do proprietário para veiculo próprio | Informação ignorada pela integração |
| WA0021 | Formação padrão do veiculo de carga é inválida | Não é permitido informar composição para veículos tipo carreta ou para caminhões monobloco. Informação ignorada |
| WA0022 | Cadastro no perfil securitario vencido ou inexistente para o Condutor | Informar nova consulta de perfil securitário diretamente na base da NoxGR ou através de método de integração "Set_AlteraPerfilSecuritario", para evitar rejeição da Solicitação de Monitoramento |
| WA0023 | Checklist inexistente ou vencido para o Conjunto | Verificar necessidade de checklist e solicitar diretamente na base da NoxGR ou via integração no método Set_SolicitaChecklist. |
| WA0024 | Checklist solicitado automaticamente pela integração | |
| WA0025 | Campo #campo# com conteúdo fora das regras de validação | Verificar documentação no manual do integrador |
| WA0026 | Perfil securitário já cadastrado | O código de perfil nesse fornecedor já foi utilizado. Corrigir o código de pesquisa e/ou fornecedor e enviar novamente |
| WA0027 | Data de validade do perfil securitário está incorreta | A data de validade não pode ser superior a 12 meses para "CLT" ou 6 meses para "Agregados" ou 30 dias para "Terceiros - Autônomos) |
| WA0028 | Empresa de perfil Securitário inexistente | |
| WA0029 | Limite de viagens do checklist está próximo | Solicitar novo checklist o quanto antes para evitar rejeição nas próximas solicitações de monitoramento para esse conjunto-viagem |
Erros na Autenticação
Abaixo tabela com detalhamento de erros de autenticação no envio da requisição, indicando rejeição da requisição.
Essas mensagens indicam que a operação sequer foi registrada no painel de controle pois há erros no processo de autenticação do usuário ou mesmo falta requisitos mínimos para efetuar a operação no método solicitado. Requer análise, correção do problema identificado e reenvio da mesma, caso necessário.
Todas as mensagens de retorno de erros de autenticação iniciam com “EA” (ERRO DE AUTENTICAÇÃO) seguido de número sequencial para informar de forma detalhada qual ocorrência deve ser observada.
| CÓDIGO | DESCRIÇÃO | INSTRUÇÕES AO INTEGRADOR/CLIENTE |
|---|---|---|
| EA0001 | Falta usuário, senha ou token para autenticação | Todas as informações devem ser preenchidas. Requisição Rejeitada |
| EA0002 | Usuário não autorizado para acesso a integração | Requisição Rejeitada |
| EA0003 | Autenticação inválida | Senha incorreta. Requisição Rejeitada |
| EA0004 | Token inválido | Requisição Rejeitada |
| EA0005 | Senha invalida para o ambiente chamado | Se Ambiente de Produção utilizar senha de produção, caso contrário, utilizar senha de homologação. Requisição Rejeitada |
| EA0006 | Método inexistente ou inativo. Consulte métodos validos no manual do integrador | Requisição Rejeitada |
| EA0007 | Usuário não está ativo para acesso de integração. | Requisição Rejeitada |
| EA0008 | Status do Cliente não permite integração. | Requisição Rejeitada |
| EA0020 | Limite de requisições simultâneas excedido | Aguardar algum tempo para processamento de requisições em andamento e enviar novamente. Requisição Rejeitada |
| EA0021 | Campos obrigatórios inexistentes. | Requisição Rejeitada |
| EA0022 | Unidade de negócios inexistente ou inativa. | Requisição Rejeitada |
Erros no Processo
Abaixo tabela com detalhamento de erros indicando rejeição da operação solicitada.
Essas mensagens indicam que a operação foi registrada no painel de controle porem não foi realizada e requer análise, correção do problema identificado e reenvio da mesma, caso necessário.
Todas as mensagens de retorno de erros iniciam com “ER” (ERROR) seguido de número sequencial para informar de forma detalhada qual ocorrência deve ser observada, sendo apresentadas claramente no painel de controle da integração.
| CÓDIGO | DESCRIÇÃO | INSTRUÇÕES AO INTEGRADOR/CLIENTE |
|---|---|---|
| ER0005 | Não foi possível encontrar o #DescriçãoCampo# | |
| ER0010 | Rastreador auxiliar não existe ou não pertence ao cliente | Deve ser cadastrado o rastreador auxiliar no sistema NoxWeb |
| ER0011 | Numero de agentes de escolta incorreto | Deverá haver no minimo 1 e máximo 2 agentes por escolta |
| ER0012 | Não há apólice de seguros vigente para o cliente | Encaminhar apólice vigente para a NoxGR efetuar o cadastro no sistema |
| ER0013 | Não há apolice de seguros vigente para o embarcador | Encaminhar apólice vigente do embarcador para a NoxGR efetuar o cadastro no sistema |
| ER0014 | Seguradora informada diverge da apólice de seguros vigente para o embarcador | Encaminhar nova apólice vigente do embarcador para a NoxGR efetuar o cadastro no sistema ou enviar código da seguradora correta |
| ER0015 | Condutor já está cadastrado | |
| ER0016 | Empresa de perfil Securitário inexistente | |
| ER0017 | Data de validade da CNH incorreta | Validade máxima de 12 meses da data da solicitação do cadastro |
| ER0018 | Campo #campo# não informado | |
| ER0019 | Campo #campo# com conteúdo fora das regras de validação | Verificar documentação no manual do integrador |
| ER0020 | O Veículo não foi inserido | |
| ER0021 | Unidade de Negócios inativa | |
| ER0022 | Não foi possível encontrar veículo ou o mesmo está inativo | Veículo deverá estar cadastrado e "ativo" na base de dados da NoxGR |
| ER0023 | Informe a cor do veículo | Informe a cor com pelo menos 4 caracteres |
| ER0024 | Informe corretamente o ano de fabricação do veículo | Deve ser superior ao ano de 1980 |
| ER0025 | Formato de Placa incorreto | A Placa deve ter estar no formato AAA-9999 (Ter números, traço e quatro letras) |
| ER0026 | Informe corretamente o ano-modelo do veiculo | Deve ser igual ou imediatamente superior ao ano de fabricação |
| ER0027 | Tipo de veiculo incorreto | Deve ser informado 1 = Cavalo, 2 = Caminhão ou 3= Veiculo de Carga |
| ER0028 | Informar corretamente o vinculo do Veículo | Deve ser: F = Frota / A = Agregado / D = Dedicado / T = Terceiro (autônomo) |
| ER0029 | Informar corretamente a data de aquisição do veiculo | Formato AAAA-MM-DD. Ano deve ser maior que 1980 |
| ER0030 | Informar corretamente a data de venda do veiculo | Formato AAAA-MM-DD. Ano deve ser maior que 2014 e maior que data de aquisição |
| ER0031 | Informar corretamente a forma de faturamento | Cobrança pode ser na modalidade de: F = frota / A= Agregado / D= Dedicado / V=Visualização / T=Telemonitorado |
| ER0032 | Não permitido informar a forma de faturamento | Veiculo com tipo de faturamento por embarque não permite cobrança na modalidade de fixos |
| ER0033 | Tecnologia informada não existe | Verificar na tabela de validação de tecnologias (vide manual de integração) |
| ER0034 | Modelo do rastreador informado não existe | Verificar na tabela associativa de modelos de rastreadores (vide manual de integração) |
| ER0035 | Rastreador não cadastrado | Verificar se foi informado a tecnologia, modelo do rastreador e numero do serial |
| ER0036 | Numero do rastreador fora da faixa prevista para o modelo | Verificar se numero do serial e/ou modelo do rastreador e/ou tecnologia estão corretos |
| ER0037 | O Rastreador do Veículo está associado a outro veículo | O numero do serial informado pertence a outro veiculo. Caso a tecnologia, modelo e serial estejam corretos, entrar em contato com a NoxGR |
| ER0038 | Formação padrão não cadastrada | Deve ser informado o tipo de formação e as carretas associadas |
| ER0039 | Formação padrão invalida | Deve haver ao menos uma placa de carreta para a formação indicada |
| ER0040 | As placas associadas ao conjunto não atendem a formação padrão | Verificar se faltam/sobram placas informadas para a formação padrão ou se o tipo de carreta informada não atende ao tipo previsto na formação padrão ou se há necessidade de dolly |
| ER0041 | Veiculo inexistente na base de carretas ou inativo | Veículo de carga deverá estar cadastrado e "ativo" na base de dados da NoxGR |
| ER0042 | Placas duplicadas na formação do conjunto-viagem | Não pode repetir placas na formação do conjunto |
| ER0043 | Alteração não realizada | Informar pelo menos um campo para alteração |
| ER0044 | Unidade de Negócios inexistente | |
| ER0045 | Código de Formação padrão invalida | Verificar na tabela de validação de formações padrões (manual do integrador) |
| ER0046 | Condutor não cadastrado | |
| ER0047 | Condutor inativo na base de dados | Verificar data de interrupção de atividades |
| ER0048 | Veículo já está cadastrado | |
| ER0049 | Modelo do rastreador não pertence a tecnologia informada | Verificar modelo ou tecnologia informada |
| ER0050 | Faltam dados para inclusão ou exclusão de sinal | Verificar dados obrigatorios para inclusão ou exclusão de sinal no manual do integrador. |
| ER0051 | Alteração nos dados do veículo não realizada | Verificar ocorrências no painel de controle da integração |
| ER0052 | Veiculo já está cadastrado como Fixo | |
| ER0053 | Veiculo já está com cobrança por embarque | |
| ER0054 | Veículo não possui rastreador ativo. | Deve ativar o rastreador diretamente na base da NoxGR ou via integração no método Set_AlteraVeiculo |
| ER0055 | Veiculo com sinal inativo na NoxGR | Não foi solicitado inclusão de sinal para esse veiculo. Solicitar diretamente na base da NoxGR ou através do método de integração Set_AlteraVeiculo |
| ER0056 | Perfil securitário já cadastrado | O código de perfil nesse fornecedor já foi utilizado. Corrigir o código de pesquisa e/ou fornecedor e enviar novamente |
| ER0057 | Data de validade do perfil securitário está incorreta | A data de validade não pode ser superior a 12 meses para "CLT" ou 6 meses para "Agregados" ou 30 dias para "Terceiros - Autônomos" |
| ER0058 | Inclusão de veículo não realizada | Informar pelo menos um campo para incluir dados do veiculo |
| ER0059 | Não permitido alteração de fixos | Contrato do cliente não permite inclusão/exclusão de veículos com cobrança fixo-mensal |
| ER0060 | Veiculo já possui viagem agendada e/ou em curso | Somente será permitido novo agendamento quando o veiculo finalizar a viagem em curso |
| ER0061 | Checklist não foi realizado ou está vencido | Solicitar novo checklist para o conjunto-viagem solicitado ou alterar o conjunto-viagem |
| ER0062 | Checklist vencido - quantidade de viagens excedida | Quantidade de viagens excedida para o checklist desse conjunto. Necessário realizar novo checklist antes do agendamento |
| ER0063 | Checklist com Restrições e sem autorização de liberação | O ultimo checklist para esse conjunto-viagem apresentou restrições. Efetuar novo checklist ou enviar TAG sId_AutorizaCklNeg com valor = "S" autorizando SM com Check restrito. |
| ER0064 | Cadastro no perfil securitário vencido ou inexistente para o Condutor | Informar nova consulta de perfil securitário diretamente na base da NoxGR ou através de método de integração Set_AlteraVeiculo, para evitar rejeição da Solicitação de Monitoramento |
| ER0065 | CNH invalida para o condutor designado a viagem | Verificar data de validade da CNH e categoria (ver Tabela de Categorias CNH) |
| ER0066 | Condutor informado para a solicitação está em viagem em andamento | Enviar novamente a solicitação quanto a viagem do condutor for encerrada ou fornecer outro condutor para essa viagem. |
| ER0067 | Uma ou mais carretas do conjunto-viagem inexistente ou inativa | Certificar que todas as carretas do conjunto viagem estejam cadastradas e ativas no sistema |
| ER0068 | Uma ou mais carretas do conjunto-viagem possui viagem em andamento | Aguardar finalização de viagem da(s) carreta(s) em viagem ou substituir o conjunto-viagem antes de enviar novamente a solicitação |
| ER0069 | Conjunto-viagem não informado | Deve ser informado o tipo de formação e as carretas associadas ao veiculo trator no conjunto-viagem |
| ER0070 | Condutor não informado | Deve ser informado ao menos um condutor para a viagem |
| ER0071 | Ajudante(s) não informado(s) | Informado quantidade de ajudantes porém o CPF não foi indicado. |
| ER0072 | Ajudante não encontrado | Deve estar previamente cadastrado na base da NoxGR |
| ER0073 | Ajudante inativo na base de dados | Verificar data de interrupção de atividades |
| ER0074 | Ajudante informado para a solicitação está em viagem em andamento | Enviar novamente a solicitação quanto a viagem do ajudante for encerrada ou fornecer outro ajudante para essa viagem. |
| ER0075 | Cadastro no perfil securitário vencido ou inexistente para o Ajudante | Informar nova consulta de perfil securitário diretamente na base da NoxGR ou através de método de integração Set_AlteraVeiculo, para evitar rejeição da Solicitação de Monitoramento |
| ER0076 | Seguradora inexistente | Deve solicitar a NoxGR o cadastramento da Seguradora ou alterar a seguradora informada |
| ER0077 | Embarcador inexistente ou inativo informado na carta DDR | Deve cadastrar o Embarcador pelo sistema NoxWeb e o mesmo deverá estar ativo. Caso contrario, alterar o embarcador informado |
| ER0078 | Rota Inexistente | Deve solicitar a NoxGR o cadastramento da Rota ou fazer a associação caso utilize código interno do integrador |
| ER0079 | Rota Inativa no cliente | Deve ativar a rota ou alterar a rota informada |
| ER0080 | Município de Origem não pertence a Rota informada | Informar a rota e/ou município de origem corretos |
| ER0081 | Município de Destino não pertence a Rota informada | Informar a rota e/ou município de destino corretos |
| ER0082 | Previsão de inicio anterior a data-horário atuais | Informar previsão de inicio posterior a data e horário atuais |
| ER0083 | Previsão de fim de viagem incorreta | Informar previsão de fim de viagem posterior a previsão de inicio e à data e horário atuais |
| ER0084 | Valor de Carga Incorreto | Informar valor da carga para operações de Distribuição, Transferência ou Coleta.O Valor da carga não poderá ultrapassar o limite da apólice e deverá corresponder à somatória dos produtos informados no transporte |
| ER0085 | Embarcador da viagem inexistente ou inativo | Embarcador deve estar previamente cadastrado no sistema NoxWeb e deverá estar ativo antes de ser utilizado na viagem |
| ER0086 | Transportador Terceiro não cadastrado | Transportador deve estar previamente cadastrado no sistema NoxWeb antes de ser utilizado na viagem |
| ER0087 | Embarcador cliente (sequencia viagem) inexistente ou inativo | Embarcador deve estar previamente cadastrado no sistema NoxWeb e deverá estar ativo antes de ser utilizado na viagem |
| ER0088 | Produto informado não existe | Verificar na Tabela de Produtos- vide manual de integração |
| ER0089 | Valor de transporte do produto #NomeProduto# não é valido | Verificar se valor do produto é muito baixo ou excede o limite estabelecido na apólice do transportador ou do embarcador (caso tenha sido indicado transporte com DDR) |
| ER0090 | Valor do produto #NomeProduto# exige escolta | Deve ser informado os dados de escolta para essa solicitação |
| ER0091 | Valor do produto #NomeProduto# exige isca de carga | Deve ser informado os dados de rastreador auxiliar |
| ER0092 | Documento Fiscal não informado | Foi informado exigência de NF na TAG sId_DetNF porem nenhum documento fiscal foi informado |
| ER0093 | Veiculo de escolta não cadastrado ou inativo | Cadastrar o veiculo no sistema NoxWeb |
| ER0094 | Serial do rastreador do veiculo de escolta não cadastrado | Informar o serial do rastreador instalado no veiculo de escolta |
| ER0095 | Agente de Escolta não cadastrado ou inativo. CPF #CpfAgente# | Cadastrar o agente de escolta no sistema NoxWeb |
| ER0096 | Fora da faixa de temperatura permitida | Temperatura deve estar entre -20 e 30⁰ C |
| ER0097 | Não existe contato cadastrado para o(s) condutor(es) da viagem | Informar ao menos um contato para o condutor |
| ER0098 | Ajudantes informados incompatível com a quantidade declarada | Verificar se quantidade informada em está correta ou se tem informado a menor ou maior que quantidade declarada |
| ER0099 | Ajudante informado em duplicidade | |
| ER0100 | Solicitação Monitoramento rejeitada - Veiculo informado não existe na base de dados | Cadastrar veiculo ou corrigir a requisição |
| ER0101 | Solicitação Monitoramento rejeitada - Ocorrência de erros | Corrigir os erros apontados no painel de controle |
| ER0102 | O Veiculo não pode ser Inativado pois está com a Viagem: 9999999 em aberto! | Caso o veículo já tenha finalizado a viagem em questão é só fazer a Finalização da Viagem |
| ER0103 | O Veiculo não pode ter o Serial removido pois está com a Viagem: 9999999 em aberto! | Caso o veículo já tenha finalizado a viagem em questão é só fazer a Finalização da Viagem |
| ER0104 | O veículo não está posicionando, por favor verificar! | Verificar se o veículo está espelhado, ou se está cadastrado com a tecnologia e serial corretos. |