Cada conjunto de lecturas que recibe A-REX tiene un informe de validación, venga de una plataforma de dispositivos, de tu propio software o de un archivo del registrador que subes. Las lecturas válidas se guardan aunque otras del mismo conjunto se rechacen, y nada se descarta sin avisar.
Cómo se lee un informe
El informe empieza con los totales: lecturas recibidas, guardadas (o válidas, si es solo una comprobación), rechazadas, ya registradas y advertencias. Debajo hay una fila por cada tipo de problema: si la lectura se rechazó o recibió una advertencia o una nota, qué pasó en palabras sencillas, las filas o lecturas afectadas, a cuántas lecturas afectó y cómo corregirlo. El código al final de la fila abre su sección en esta página. Un conjunto sin ninguna lectura se rechaza y no se conserva nada de él.
Sube y comprueba un archivo del registrador en Sube un archivo del registrador; los códigos de abajo son los mismos en todas partes.
READING_PROFILE_UNKNOWN
Rechazada. El informe dice: “No conocemos el perfil ….”
- Por qué importa: Las lecturas no se pueden revisar sin sus reglas.
- Cómo corregirlo: Usa uno de los perfiles de la guía.
READING_PROFILE_VERSION_RETIRED
Rechazada. El informe dice: “La versión … del perfil … ya no se acepta.”
- Por qué importa: Las reglas antiguas ya no tienen soporte.
- Cómo corregirlo: Envía la versión …; consulta el registro de cambios.
READING_PROFILE_NOT_PINNED
Nota. El informe dice: “… no forma parte de las mediciones acordadas para esta entrega; se guardó como extra.”
- Por qué importa: El receptor no acordó revisarlo.
- Cómo corregirlo: Agrega el perfil a la entrega o ignora este aviso.
READING_PROFILE_NOT_APPLICABLE
Advertencia. El informe dice: “… se mide con …, que no aplica a …; se guardó como extra.”
- Por qué importa: Cada perfil está pensado para ciertos productos; las lecturas de otros productos no se revisan con reglas acordadas.
- Cómo corregirlo: Elige un perfil que aplique a este producto, o ignora el aviso si la lectura extra es útil.
READING_FIELD_MISSING
Rechazada. El informe dice: “Falta ….”
- Por qué importa: El perfil lo exige, y EPCIS y UNTP lo necesitan para describir la lectura.
- Cómo corregirlo: Envía …; por ejemplo: ….
READING_FIELD_RECOMMENDED_MISSING
Nota. El informe dice: “No se indica ….”
- Por qué importa: Hace que la lectura sea más confiable y más fácil de asociar.
- Cómo corregirlo: Agrega … cuando el dispositivo lo conozca.
READING_FIELD_UNKNOWN
Nota. El informe dice: “… no forma parte de las reglas de lecturas y se ignoró.”
- Por qué importa: Los datos desconocidos nunca se guardan.
- Cómo corregirlo: Quítalo o asígnalo a un campo conocido en el mapeo del endpoint.
READING_VALUE_NOT_NUMBER
Rechazada. El informe dice: “… debe ser un número; recibimos "…".”
- Por qué importa: Un valor que no es un número no se puede comparar con un rango.
- Cómo corregirlo: Envía dígitos, con punto para los decimales.
READING_UNIT_UNKNOWN
Rechazada. El informe dice: “No reconocemos la unidad "…" para ….”
- Por qué importa: Sin una unidad conocida, el valor es ambiguo.
- Cómo corregirlo: Usa un código UN/CEFACT Rec 20: ….
READING_UNIT_WRONG_KIND
Rechazada. El informe dice: “… no es una unidad de …, así que no se puede usar para ….”
- Por qué importa: El valor se convertiría en algo sin sentido.
- Cómo corregirlo: Usa una de estas unidades: ….
READING_OUT_OF_RANGE
Rechazada. El informe dice: “… … … está fuera de lo que un dispositivo puede medir (… a …).”
- Por qué importa: Es un error del sensor o del mapeo, no una medición.
- Cómo corregirlo: Revisa la sonda, la unidad y el mapeo.
READING_OUTSIDE_AGREED_RANGE
Nota. El informe dice: “… … está fuera del rango acordado …–….”
- Por qué importa: Es una desviación: se muestra en el gráfico y se agrupa en episodios.
- Cómo corregirlo: No hay nada que corregir en los datos.
READING_PRECISION_EXCESS
Advertencia. El informe dice: “… tiene más decimales de los que guardamos; se redondeó a ….”
- Por qué importa: Se guarda con la precisión que fija el perfil.
- Cómo corregirlo: No hace falta nada, o redondea en el origen.
READING_TIME_MISSING
Rechazada. El informe dice: “Falta la hora de medición.”
- Por qué importa: Una lectura sin hora no se puede ubicar.
- Cómo corregirlo: Envía la hora en que midió el dispositivo, no la hora de envío.
READING_TIME_NO_ZONE
Rechazada. El informe dice: “La hora de medición … no tiene zona horaria.”
- Por qué importa: La misma hora de reloj difiere varias horas entre zonas horarias.
- Cómo corregirlo: Agrega un desfase (Z o -03:00), o define la zona horaria en la plantilla del archivo.
READING_TIME_IN_FUTURE
Rechazada. El informe dice: “La hora de medición está … min en el futuro.”
- Por qué importa: El reloj del dispositivo o la zona horaria está mal.
- Cómo corregirlo: Corrige el reloj del dispositivo o la zona horaria.
READING_TIME_TOO_OLD
Rechazada. El informe dice: “La hora de medición tiene más de 7 días.”
- Por qué importa: Los datos tardíos no se pueden sumar con honestidad al registro dentro de su plazo.
- Cómo corregirlo: Sube el archivo del registrador a la entrega; admite datos más antiguos y se marca como "Declarado".
READING_TIME_OUTSIDE_DELIVERY
Advertencia. El informe dice: “Esta lectura es de antes de la recogida o después del cierre de la entrega ….”
- Por qué importa: Puede pertenecer a otro viaje.
- Cómo corregirlo: Revisa la asignación del dispositivo; las posiciones fuera de este período no se guardan.
READING_DUPLICATE
Nota. El informe dice: “Ya registrada; no se guarda dos veces.”
- Por qué importa: Los reintentos y reenvíos son normales.
- Cómo corregirlo: No hay nada que corregir.
READING_CONFLICT
Rechazada. El informe dice: “Ya se registró otro valor para este dispositivo y esta hora.”
- Por qué importa: Dos valores para un mismo momento indican un error del mapeo o del dispositivo.
- Cómo corregirlo: Revisa el ID del dispositivo y el número de secuencia; se conserva el primer valor.
READING_OUT_OF_ORDER
Nota. El informe dice: “Llegó después de lecturas posteriores; se ubicó según su hora.”
- Por qué importa: Los datos en búfer suelen enviarse tarde.
- Cómo corregirlo: No hay nada que corregir.
READING_DELIVERY_UNKNOWN
Rechazada. El informe dice: “No pudimos asociar esta lectura a una entrega.”
- Por qué importa: Cada lectura pertenece a una entrega.
- Cómo corregirlo: Envía la referencia de la entrega, el documento de transporte, el número de contenedor o un dispositivo asignado.
READING_DELIVERY_CLOSED
Rechazada. El informe dice: “La entrega … está cerrada; ya no acepta lecturas.”
- Por qué importa: El registro está cerrado.
- Cómo corregirlo: Adjunta el archivo a la entrega como documento.
READING_DEVICE_UNKNOWN
Advertencia. El informe dice: “El dispositivo … no está registrado; se guardó como informado por ….”
- Por qué importa: Un dispositivo desconocido reduce la confianza en los datos.
- Cómo corregirlo: Registra el dispositivo en Configuración, Integraciones, Lecturas, en Fuentes de lecturas.
READING_DEVICE_NOT_ASSIGNED
Rechazada. El informe dice: “El dispositivo … está asignado a la entrega …, no a la ….”
- Por qué importa: Evita que se mezclen dos viajes.
- Cómo corregirlo: Cambia la asignación del dispositivo o la referencia de la entrega.
READING_POSITION_INVALID
Rechazada. El informe dice: “Esta posición no es válida (…, …).”
- Por qué importa: Una posición 0, 0 o valores invertidos son un error común.
- Cómo corregirlo: Envía primero la latitud, en grados (WGS-84).
READING_ACCURACY_LOW
Advertencia. El informe dice: “La precisión de la posición es de … m, demasiado baja para comprobar llegadas.”
- Por qué importa: Comprobar llegadas por zona requiere … m o mejor.
- Cómo corregirlo: Prefiere posiciones satelitales (GNSS) a las de antenas de telefonía.
READING_PERSONAL_DATA_DROPPED
Advertencia. El informe dice: “… se refiere al conductor y no se guardó.”
- Por qué importa: La velocidad, el nombre del conductor y las horas de conducción nunca se guardan.
- Cómo corregirlo: Deja de enviarlo.
READING_BATTERY_LOW
Nota. El informe dice: “Batería al … %.”
- Por qué importa: El envío de datos puede detenerse a mitad del viaje.
- Cómo corregirlo: Carga o cambia la batería antes del próximo viaje.
READING_GAP
Advertencia. El informe dice: “Sin lecturas de … durante … (se esperaban cada …).”
- Por qué importa: Un hueco sin explicación debilita el registro de la cadena de frío.
- Cómo corregirlo: Revisa la cobertura; los datos en búfer todavía pueden llegar dentro de 7 días.
READING_CLOCK_SKEW
Advertencia. El informe dice: “El reloj de … parece desfasado … min.”
- Por qué importa: Las horas pueden estar desplazadas.
- Cómo corregirlo: Sincroniza el reloj del dispositivo (hora NTP o GNSS).
READING_LATE
Nota. El informe dice: “Las lecturas llegan en promedio … min después de medirse.”
- Por qué importa: Las alertas llegan tarde.
- Cómo corregirlo: Acorta el intervalo de envío si las alertas importan.
READING_BATCH_TOO_LARGE
Rechazada. El informe dice: “Esta solicitud tiene … lecturas; el límite es ….”
- Por qué importa: El límite mantiene al receptor justo con todos los emisores.
- Cómo corregirlo: Divide el envío en varias solicitudes más pequeñas.
READING_FORMAT_INVALID
Rechazada. El informe dice: “Esto no es … válido: ….”
- Por qué importa: No se pudo leer nada.
- Cómo corregirlo: Compara el archivo o el cuerpo con el ejemplo de la guía.
READING_EPCIS_UNSUPPORTED
Advertencia. El informe dice: “Estas reglas de lecturas no leen EPCIS …, que se ignoró.”
- Por qué importa: Solo los datos de sensores de un evento EPCIS cuentan como lecturas.
- Cómo corregirlo: Usa la ruta de captura EPCIS para otros eventos.
READING_COLUMN_UNMAPPED
Rechazada. El informe dice: “La columna "…" se necesita para …, pero no está asignada.”
- Por qué importa: El campo obligatorio faltaría en todas las filas.
- Cómo corregirlo: Asigna la columna en la plantilla del archivo.
READING_ROW_MALFORMED
Rechazada. El informe dice: “No se puede leer la fila …: ….”
- Por qué importa: Una fila con errores no bloquea las demás.
- Cómo corregirlo: Corrige o borra la fila.
READING_RATE_LIMITED
Rechazada. El informe dice: “Demasiadas lecturas de …; vuelve a intentarlo en … s.”
- Por qué importa: El límite protege el servicio de recepción.
- Cómo corregirlo: Reduce el ritmo; no se perdió nada de nuestro lado.
READING_PDF_LAYOUT_UNKNOWN
Advertencia. El informe dice: “No pudimos leer este informe, así que no se guardó nada de él.”
- Por qué importa: No conocemos el diseño de este PDF, y nunca adivinamos valores a partir de un informe.
- Cómo corregirlo: Envía la exportación CSV del registrador, o pídenos que agreguemos este diseño de informe.