Naar de hoofdinhoud

Integraties & API · Vraag

Een validatierapport lezen

Wat elke regel van een rapport over metingen betekent, waarom die ertoe doet en hoe u het oplost, één sectie per code.

Elke reeks metingen die A-REX ontvangt, krijgt een validatierapport: of die nu van een apparaatplatform komt, van uw eigen software of uit een loggerbestand dat u uploadt. Geldige metingen worden opgeslagen, ook als andere uit dezelfde reeks worden geweigerd, en er verdwijnt niets ongemerkt.

Zo leest u een rapport

Het rapport begint met de aantallen: ontvangen, opgeslagen (of geldig, bij een controle), geweigerd, al vastgelegd en waarschuwingen. Daaronder staat één regel per soort probleem: of de meting is geweigerd of een waarschuwing of opmerking kreeg, wat er gebeurde in gewone woorden, welke rijen of metingen het betreft, hoeveel metingen het raakte en hoe u het oplost. De code aan het eind van de regel opent de bijbehorende sectie hier. Een reeks zonder enige meting wordt geweigerd en er wordt niets van bewaard.

Hoe u een loggerbestand uploadt en controleert, leest u in Een loggerbestand uploaden; de codes hieronder zijn overal dezelfde.

READING_PROFILE_UNKNOWN

Geweigerd. Het rapport zegt: “We kennen het profiel … niet.”

  • Waarom het ertoe doet: Metingen kunnen zonder hun regels niet worden gecontroleerd.
  • Hoe u het oplost: Gebruik een van de profielen uit de handleiding.

READING_PROFILE_VERSION_RETIRED

Geweigerd. Het rapport zegt: “Versie … van profiel … wordt niet meer geaccepteerd.”

  • Waarom het ertoe doet: Oude regels worden niet meer ondersteund.
  • Hoe u het oplost: Stuur versie …; zie het wijzigingsoverzicht.

READING_PROFILE_NOT_PINNED

Opmerking. Het rapport zegt: “… hoort niet bij de afgesproken metingen van deze levering; het is als extra bewaard.”

  • Waarom het ertoe doet: De ontvanger heeft niet afgesproken dit te controleren.
  • Hoe u het oplost: Voeg het profiel toe aan de levering, of negeer deze melding.

READING_PROFILE_NOT_APPLICABLE

Waarschuwing. Het rapport zegt: “… wordt gemeten volgens …, dat niet geldt voor …; het is als extra bewaard.”

  • Waarom het ertoe doet: Elk profiel is bedoeld voor bepaalde goederen; metingen van andere goederen worden niet aan afgesproken regels getoetst.
  • Hoe u het oplost: Kies een profiel dat voor dit product geldt, of negeer dit als de extra meting nuttig is.

READING_FIELD_MISSING

Geweigerd. Het rapport zegt: “… ontbreekt.”

  • Waarom het ertoe doet: Het profiel vereist het, en EPCIS en UNTP hebben het nodig om de meting te beschrijven.
  • Hoe u het oplost: Stuur … mee; bijvoorbeeld: ….

READING_FIELD_RECOMMENDED_MISSING

Opmerking. Het rapport zegt: “… is niet opgegeven.”

  • Waarom het ertoe doet: Het maakt de meting betrouwbaarder en makkelijker te koppelen.
  • Hoe u het oplost: Voeg … toe als het apparaat het weet.

READING_FIELD_UNKNOWN

Opmerking. Het rapport zegt: “… hoort niet bij de meetregels en is genegeerd.”

  • Waarom het ertoe doet: Onbekende gegevens worden nooit opgeslagen.
  • Hoe u het oplost: Verwijder het, of koppel het aan een bekend veld in de koppeling van het eindpunt.

READING_VALUE_NOT_NUMBER

Geweigerd. Het rapport zegt: “… moet een getal zijn; we ontvingen "…".”

  • Waarom het ertoe doet: Een waarde die geen getal is, kan niet met een bereik worden vergeleken.
  • Hoe u het oplost: Stuur cijfers, met een punt voor decimalen.

READING_UNIT_UNKNOWN

Geweigerd. Het rapport zegt: “We herkennen de eenheid "…" voor … niet.”

  • Waarom het ertoe doet: Zonder bekende eenheid is de waarde dubbelzinnig.
  • Hoe u het oplost: Gebruik een UN/CEFACT Rec 20-code: ….

READING_UNIT_WRONG_KIND

Geweigerd. Het rapport zegt: “… is geen eenheid van … en kan dus niet voor … worden gebruikt.”

  • Waarom het ertoe doet: De waarde zou worden omgerekend tot onzin.
  • Hoe u het oplost: Gebruik een van deze eenheden: ….

READING_OUT_OF_RANGE

Geweigerd. Het rapport zegt: “… … … valt buiten wat een apparaat kan meten (… tot …).”

  • Waarom het ertoe doet: Het is een fout in de sensor of de koppeling, geen meting.
  • Hoe u het oplost: Controleer de sonde, de eenheid en de koppeling.

READING_OUTSIDE_AGREED_RANGE

Opmerking. Het rapport zegt: “… … valt buiten het afgesproken bereik …–….”

  • Waarom het ertoe doet: Het is een afwijking: die staat in de grafiek en wordt gegroepeerd in episodes.
  • Hoe u het oplost: Er hoeft niets aan de gegevens te worden aangepast.

READING_PRECISION_EXCESS

Waarschuwing. Het rapport zegt: “… heeft meer decimalen dan we bewaren; het is afgerond op ….”

  • Waarom het ertoe doet: Er wordt opgeslagen met de precisie die het profiel vastlegt.
  • Hoe u het oplost: Niets te doen, of rond af bij de bron.

READING_TIME_MISSING

Geweigerd. Het rapport zegt: “Het meettijdstip ontbreekt.”

  • Waarom het ertoe doet: Een meting zonder tijd kan niet worden geplaatst.
  • Hoe u het oplost: Stuur het tijdstip waarop het apparaat mat, niet het uploadtijdstip.

READING_TIME_NO_ZONE

Geweigerd. Het rapport zegt: “Het meettijdstip … heeft geen tijdzone.”

  • Waarom het ertoe doet: Dezelfde kloktijd ligt per tijdzone uren uit elkaar.
  • Hoe u het oplost: Voeg een verschuiving toe (Z of -03:00), of stel de tijdzone in het bestandssjabloon in.

READING_TIME_IN_FUTURE

Geweigerd. Het rapport zegt: “Het meettijdstip ligt … min in de toekomst.”

  • Waarom het ertoe doet: De klok van het apparaat of de tijdzone klopt niet.
  • Hoe u het oplost: Corrigeer de klok van het apparaat of de tijdzone.

READING_TIME_TOO_OLD

Geweigerd. Het rapport zegt: “Het meettijdstip is ouder dan 7 dagen.”

  • Waarom het ertoe doet: Late gegevens kunnen niet eerlijk binnen de termijn aan het register worden toegevoegd.
  • Hoe u het oplost: Upload in plaats daarvan het loggerbestand bij de levering; dat staat oudere gegevens toe en wordt gemarkeerd als "Opgegeven door uw bedrijf".

READING_TIME_OUTSIDE_DELIVERY

Waarschuwing. Het rapport zegt: “Deze meting is van vóór het ophalen of na de afronding van levering ….”

  • Waarom het ertoe doet: Hij kan bij een andere rit horen.
  • Hoe u het oplost: Controleer de koppeling van het apparaat; posities buiten deze periode worden niet opgeslagen.

READING_DUPLICATE

Opmerking. Het rapport zegt: “Al vastgelegd; wordt niet dubbel opgeslagen.”

  • Waarom het ertoe doet: Herhaalde pogingen en herzendingen zijn normaal.
  • Hoe u het oplost: Er hoeft niets te worden aangepast.

READING_CONFLICT

Geweigerd. Het rapport zegt: “Voor dit apparaat en dit tijdstip is al een andere waarde vastgelegd.”

  • Waarom het ertoe doet: Twee waarden voor hetzelfde moment wijzen op een fout in de koppeling of het apparaat.
  • Hoe u het oplost: Controleer de apparaat-ID en het volgnummer; de eerste waarde blijft staan.

READING_OUT_OF_ORDER

Opmerking. Het rapport zegt: “Kwam binnen na latere metingen; geplaatst volgens het eigen tijdstip.”

  • Waarom het ertoe doet: Gebufferde gegevens komen vaak later binnen.
  • Hoe u het oplost: Er hoeft niets te worden aangepast.

READING_DELIVERY_UNKNOWN

Geweigerd. Het rapport zegt: “We konden deze meting niet aan een levering koppelen.”

  • Waarom het ertoe doet: Elke meting hoort bij een levering.
  • Hoe u het oplost: Stuur de leveringsreferentie, het transportdocument, het containernummer of een gekoppeld apparaat.

READING_DELIVERY_CLOSED

Geweigerd. Het rapport zegt: “Levering … is afgerond; er kunnen geen metingen meer bij.”

  • Waarom het ertoe doet: Het dossier is gesloten.
  • Hoe u het oplost: Voeg het bestand in plaats daarvan als document toe aan de levering.

READING_DEVICE_UNKNOWN

Waarschuwing. Het rapport zegt: “Apparaat … is niet geregistreerd; vastgelegd als gemeld door ….”

  • Waarom het ertoe doet: Een onbekend apparaat verlaagt het vertrouwen in de gegevens.
  • Hoe u het oplost: Registreer het apparaat via Instellingen, Integraties, Metingen, onder Meetbronnen.

READING_DEVICE_NOT_ASSIGNED

Geweigerd. Het rapport zegt: “Apparaat … is gekoppeld aan levering …, niet aan ….”

  • Waarom het ertoe doet: Zo raken twee ritten niet door elkaar.
  • Hoe u het oplost: Wijzig de koppeling van het apparaat of de leveringsreferentie.

READING_POSITION_INVALID

Geweigerd. Het rapport zegt: “Deze positie is ongeldig (…, …).”

  • Waarom het ertoe doet: Een positie 0, 0 of verwisselde waarden zijn een veelvoorkomende fout.
  • Hoe u het oplost: Stuur eerst de breedtegraad, in graden (WGS-84).

READING_ACCURACY_LOW

Waarschuwing. Het rapport zegt: “De positienauwkeurigheid is … m, te grof voor aankomstcontroles.”

  • Waarom het ertoe doet: Aankomstcontroles per gebied vragen … m of beter.
  • Hoe u het oplost: Gebruik liever satellietposities (GNSS) dan posities via zendmasten.

READING_PERSONAL_DATA_DROPPED

Waarschuwing. Het rapport zegt: “… gaat over de chauffeur en is niet opgeslagen.”

  • Waarom het ertoe doet: Snelheid, naam van de chauffeur en rijtijden worden nooit bewaard.
  • Hoe u het oplost: Stuur het niet meer mee.

READING_BATTERY_LOW

Opmerking. Het rapport zegt: “Batterij op … %.”

  • Waarom het ertoe doet: De gegevensstroom kan halverwege de rit stoppen.
  • Hoe u het oplost: Laad of vervang de batterij voor de volgende rit.

READING_GAP

Waarschuwing. Het rapport zegt: “Geen metingen van … gedurende … (verwacht elke …).”

  • Waarom het ertoe doet: Een onverklaard gat verzwakt het bewijs van de koelketen.
  • Hoe u het oplost: Controleer de dekking; gebufferde gegevens kunnen nog binnen 7 dagen binnenkomen.

READING_CLOCK_SKEW

Waarschuwing. Het rapport zegt: “De klok van … lijkt … min af te wijken.”

  • Waarom het ertoe doet: Tijden kunnen verschoven zijn.
  • Hoe u het oplost: Synchroniseer de klok van het apparaat (NTP- of GNSS-tijd).

READING_LATE

Opmerking. Het rapport zegt: “Metingen komen gemiddeld … min na het meten binnen.”

  • Waarom het ertoe doet: Waarschuwingen komen te laat.
  • Hoe u het oplost: Verkort het verzendinterval als waarschuwingen belangrijk zijn.

READING_BATCH_TOO_LARGE

Geweigerd. Het rapport zegt: “Dit verzoek bevat … metingen; de limiet is ….”

  • Waarom het ertoe doet: De limiet zorgt dat alle afzenders eerlijk worden behandeld.
  • Hoe u het oplost: Splits de zending in kleinere verzoeken.

READING_FORMAT_INVALID

Geweigerd. Het rapport zegt: “Dit is geen geldige …: ….”

  • Waarom het ertoe doet: Er kon niets worden gelezen.
  • Hoe u het oplost: Vergelijk het bestand of de inhoud met het voorbeeld in de handleiding.

READING_EPCIS_UNSUPPORTED

Waarschuwing. Het rapport zegt: “EPCIS … valt buiten de meetregels en is genegeerd.”

  • Waarom het ertoe doet: Alleen de sensorgegevens in een EPCIS-gebeurtenis tellen als metingen.
  • Hoe u het oplost: Gebruik de EPCIS-vastlegroute voor andere gebeurtenissen.

READING_COLUMN_UNMAPPED

Geweigerd. Het rapport zegt: “Kolom "…" is nodig voor …, maar is niet gekoppeld.”

  • Waarom het ertoe doet: Het verplichte veld zou in elke rij ontbreken.
  • Hoe u het oplost: Koppel de kolom in het bestandssjabloon.

READING_ROW_MALFORMED

Geweigerd. Het rapport zegt: “Rij … kan niet worden gelezen: ….”

  • Waarom het ertoe doet: Eén foute rij houdt de andere niet tegen.
  • Hoe u het oplost: Herstel of verwijder de rij.

READING_RATE_LIMITED

Geweigerd. Het rapport zegt: “Te veel metingen van …; probeer het over … s opnieuw.”

  • Waarom het ertoe doet: De limiet beschermt de ontvangende dienst.
  • Hoe u het oplost: Stuur langzamer; aan onze kant is niets verloren gegaan.

READING_PDF_LAYOUT_UNKNOWN

Waarschuwing. Het rapport zegt: “We konden dit rapport niet lezen, dus er is niets van opgeslagen.”

  • Waarom het ertoe doet: We kennen de opmaak van deze pdf niet, en we raden nooit waarden uit een rapport.
  • Hoe u het oplost: Stuur in plaats daarvan de CSV-export van de logger, of vraag ons deze rapportopmaak toe te voegen.