Todo conjunto de leituras que a A-REX recebe ganha um relatório de validação: venha ele de uma plataforma de dispositivos, do seu próprio software ou de um arquivo de registrador que você carrega. As leituras válidas são guardadas mesmo quando outras do mesmo conjunto são recusadas, e nada é descartado em silêncio.
Como o relatório se organiza
O relatório começa pelas contagens: leituras recebidas, guardadas (ou válidas, em uma verificação), recusadas, já registradas e avisos. Abaixo vem uma linha por tipo de problema: se a leitura foi recusada, recebeu um aviso ou uma observação, o que aconteceu em palavras simples, as linhas ou leituras envolvidas, quantas leituras foram afetadas e como corrigir. O código no fim da linha abre a seção dele aqui. Um conjunto sem nenhuma leitura é recusado e nada dele é mantido.
Carregue e verifique o arquivo de um registrador em Carregue o arquivo do registrador; os códigos abaixo são os mesmos em todo lugar.
READING_PROFILE_UNKNOWN
Recusada. O relatório diz: “Não conhecemos o perfil ….”
- Por que importa: As leituras não podem ser verificadas sem as suas regras.
- Como corrigir: Use um dos perfis listados no guia.
READING_PROFILE_VERSION_RETIRED
Recusada. O relatório diz: “A versão … do perfil … não é mais aceita.”
- Por que importa: Regras antigas já passaram do período de suporte.
- Como corrigir: Envie a versão …; veja o histórico de mudanças.
READING_PROFILE_NOT_PINNED
Observação. O relatório diz: “… não faz parte das medições combinadas desta entrega; foi mantido como extra.”
- Por que importa: O destinatário não combinou verificar esse dado.
- Como corrigir: Adicione o perfil à entrega ou ignore este aviso.
READING_PROFILE_NOT_APPLICABLE
Aviso. O relatório diz: “… é medido pelo …, que não se aplica a …; foi mantido como extra.”
- Por que importa: Cada perfil serve para certos produtos; leituras de outros produtos não são verificadas com regras combinadas.
- Como corrigir: Escolha um perfil que se aplique a este produto, ou ignore se a leitura extra for útil.
READING_FIELD_MISSING
Recusada. O relatório diz: “Falta ….”
- Por que importa: O perfil exige esse dado, e EPCIS e UNTP precisam dele para descrever a leitura.
- Como corrigir: Envie …; por exemplo: ….
READING_FIELD_RECOMMENDED_MISSING
Observação. O relatório diz: “Não foi informado: ….”
- Por que importa: Torna a leitura mais confiável e mais fácil de associar.
- Como corrigir: Adicione … quando o dispositivo tiver essa informação.
READING_FIELD_UNKNOWN
Observação. O relatório diz: “… não faz parte das regras de leituras e foi ignorado.”
- Por que importa: Dados desconhecidos nunca são armazenados.
- Como corrigir: Remova esse dado ou associe-o a um campo conhecido no mapeamento do endpoint.
READING_VALUE_NOT_NUMBER
Recusada. O relatório diz: “… deve ser um número; recebemos "…".”
- Por que importa: Um valor que não é número não pode ser comparado a uma faixa.
- Como corrigir: Envie dígitos, com ponto para as casas decimais.
READING_UNIT_UNKNOWN
Recusada. O relatório diz: “Não reconhecemos a unidade "…" para ….”
- Por que importa: Sem uma unidade conhecida, o valor fica ambíguo.
- Como corrigir: Use um código UN/CEFACT Rec 20: ….
READING_UNIT_WRONG_KIND
Recusada. O relatório diz: “… não é uma unidade de …, então não pode ser usada para ….”
- Por que importa: O valor seria convertido em algo sem sentido.
- Como corrigir: Use uma destas unidades: ….
READING_OUT_OF_RANGE
Recusada. O relatório diz: “… … … está fora do que um dispositivo consegue medir (… a …).”
- Por que importa: É uma falha do sensor ou do mapeamento, não uma medição.
- Como corrigir: Verifique a sonda, a unidade e o mapeamento.
READING_OUTSIDE_AGREED_RANGE
Observação. O relatório diz: “… … está fora da faixa combinada …–….”
- Por que importa: É uma excursão: aparece no gráfico e é agrupada em episódios.
- Como corrigir: Não há nada a corrigir nos dados.
READING_PRECISION_EXCESS
Aviso. O relatório diz: “… tem mais casas decimais do que guardamos; foi arredondado para ….”
- Por que importa: O armazenamento segue a precisão definida pelo perfil.
- Como corrigir: Nada a fazer, ou arredonde na origem.
READING_TIME_MISSING
Recusada. O relatório diz: “Falta o horário da medição.”
- Por que importa: Uma leitura sem horário não pode ser posicionada.
- Como corrigir: Envie o horário em que o dispositivo mediu, não o horário do envio.
READING_TIME_NO_ZONE
Recusada. O relatório diz: “O horário da medição … não tem fuso horário.”
- Por que importa: A mesma hora do relógio pode diferir em horas entre fusos.
- Como corrigir: Adicione um deslocamento (Z ou -03:00) ou defina o fuso no modelo do arquivo.
READING_TIME_IN_FUTURE
Recusada. O relatório diz: “O horário da medição está … min no futuro.”
- Por que importa: O relógio do dispositivo ou o fuso horário está errado.
- Como corrigir: Corrija o relógio do dispositivo ou o fuso horário.
READING_TIME_TOO_OLD
Recusada. O relatório diz: “O horário da medição tem mais de 7 dias.”
- Por que importa: Dados atrasados não podem ser incluídos honestamente no registro dentro do prazo.
- Como corrigir: Envie o arquivo do registrador para a entrega; ele aceita dados mais antigos e é marcado como "Declarado".
READING_TIME_OUTSIDE_DELIVERY
Aviso. O relatório diz: “Esta leitura é de antes da coleta ou depois do fechamento da entrega ….”
- Por que importa: Ela pode pertencer a outra viagem.
- Como corrigir: Verifique a atribuição do dispositivo; posições fora desse período não são armazenadas.
READING_DUPLICATE
Observação. O relatório diz: “Já registrada; não é armazenada duas vezes.”
- Por que importa: Novas tentativas e reenvios são esperados.
- Como corrigir: Não há nada a corrigir.
READING_CONFLICT
Recusada. O relatório diz: “Já foi registrado outro valor para este dispositivo e horário.”
- Por que importa: Dois valores para o mesmo momento indicam uma falha no mapeamento ou no dispositivo.
- Como corrigir: Verifique o ID do dispositivo e o número de sequência; o primeiro valor é mantido.
READING_OUT_OF_ORDER
Observação. O relatório diz: “Chegou depois de leituras posteriores; foi posicionada pelo horário.”
- Por que importa: Dados em buffer costumam ser enviados com atraso.
- Como corrigir: Não há nada a corrigir.
READING_DELIVERY_UNKNOWN
Recusada. O relatório diz: “Não conseguimos associar esta leitura a uma entrega.”
- Por que importa: Toda leitura pertence a uma entrega.
- Como corrigir: Envie a referência da entrega, o documento de transporte, o número do contêiner ou um dispositivo atribuído.
READING_DELIVERY_CLOSED
Recusada. O relatório diz: “A entrega … está encerrada; não aceita mais leituras.”
- Por que importa: O registro está encerrado.
- Como corrigir: Anexe o arquivo à entrega como documento.
READING_DEVICE_UNKNOWN
Aviso. O relatório diz: “O dispositivo … não está cadastrado; registrado como informado por ….”
- Por que importa: Um dispositivo desconhecido reduz a confiança nos dados.
- Como corrigir: Cadastre o dispositivo em Configurações, Integrações, Leituras, em Fontes de leituras.
READING_DEVICE_NOT_ASSIGNED
Recusada. O relatório diz: “O dispositivo … está atribuído à entrega …, não à ….”
- Por que importa: Isso evita misturar duas viagens.
- Como corrigir: Altere a atribuição do dispositivo ou a referência da entrega.
READING_POSITION_INVALID
Recusada. O relatório diz: “Esta posição não é válida (…, …).”
- Por que importa: Uma posição 0, 0 ou valores trocados são uma falha comum.
- Como corrigir: Envie a latitude primeiro, em graus (WGS-84).
READING_ACCURACY_LOW
Aviso. O relatório diz: “A precisão da posição é de … m, baixa demais para verificar chegadas.”
- Por que importa: Verificar chegadas por área exige … m ou melhor.
- Como corrigir: Prefira posições por satélite (GNSS) às de antenas de celular.
READING_PERSONAL_DATA_DROPPED
Aviso. O relatório diz: “… diz respeito ao motorista e não foi armazenado.”
- Por que importa: Velocidade, nome do motorista e horas de direção nunca são guardados.
- Como corrigir: Pare de enviar esse dado.
READING_BATTERY_LOW
Observação. O relatório diz: “Bateria em … %.”
- Por que importa: O envio de dados pode parar no meio da viagem.
- Como corrigir: Carregue ou troque a bateria antes da próxima viagem.
READING_GAP
Aviso. O relatório diz: “Sem leituras de … por … (esperadas a cada …).”
- Por que importa: Uma lacuna sem explicação enfraquece o registro da cadeia de frio.
- Como corrigir: Verifique a cobertura; dados em buffer ainda podem chegar em até 7 dias.
READING_CLOCK_SKEW
Aviso. O relatório diz: “O relógio de … parece defasado em … min.”
- Por que importa: Os horários podem estar deslocados.
- Como corrigir: Sincronize o relógio do dispositivo (hora NTP ou GNSS).
READING_LATE
Observação. O relatório diz: “As leituras chegam em média … min depois de medidas.”
- Por que importa: Os alertas chegam atrasados.
- Como corrigir: Encurte o intervalo de envio se os alertas forem importantes.
READING_BATCH_TOO_LARGE
Recusada. O relatório diz: “Esta requisição tem … leituras; o limite é ….”
- Por que importa: O limite mantém o recebimento justo para todos os remetentes.
- Como corrigir: Divida o lote em requisições menores.
READING_FORMAT_INVALID
Recusada. O relatório diz: “Isto não é … válido: ….”
- Por que importa: Nada pôde ser lido.
- Como corrigir: Compare o arquivo ou o corpo com o exemplo do guia.
READING_EPCIS_UNSUPPORTED
Aviso. O relatório diz: “Estas regras de leituras não leem EPCIS …, que foi ignorado.”
- Por que importa: Só os dados de sensores de um evento EPCIS contam como leituras.
- Como corrigir: Use a rota de captura EPCIS para outros eventos.
READING_COLUMN_UNMAPPED
Recusada. O relatório diz: “A coluna "…" é necessária para …, mas não está mapeada.”
- Por que importa: O campo obrigatório faltaria em todas as linhas.
- Como corrigir: Mapeie a coluna no modelo do arquivo.
READING_ROW_MALFORMED
Recusada. O relatório diz: “Não é possível ler a linha …: ….”
- Por que importa: Uma linha com erro não bloqueia as outras.
- Como corrigir: Corrija ou exclua a linha.
READING_RATE_LIMITED
Recusada. O relatório diz: “Leituras demais de …; tente de novo em … s.”
- Por que importa: O limite protege o serviço de recebimento.
- Como corrigir: Diminua o ritmo; nada foi perdido do nosso lado.
READING_PDF_LAYOUT_UNKNOWN
Aviso. O relatório diz: “Não conseguimos ler este relatório, então nada dele foi guardado.”
- Por que importa: Não conhecemos o layout deste PDF, e nunca deduzimos valores de um relatório.
- Como corrigir: Envie a exportação CSV do registrador ou peça para adicionarmos este layout de relatório.