Så felsöker man med transaktionsloggen

Transaktionsloggen innehåller metadata för varje transaktion. Metadatafönstret visar detaljerad teknisk information som hjälper dig att förstå varför ett meddelande har misslyckats och hur det kan åtgärdas.

Hitta transaktioner med fel

1. Gå till Loggar → Transaktionslogg.

2. Ange det tidsintervall du vill analysera.

3. Klicka på Filter och sätt Status till Fel.

4. Klicka på Använd.

5. Rader med fel markeras i listan och blir enklare att hitta.

Arbeta med metadata

Varje rad i transaktionsloggen har en kolumn för Metadata. När det finns ett värde kan du klicka på länken för att öppna metadatafönstret.

Metadatafönstret innehåller vanligtvis avsnitt som:

Error

• Message: en läsbar beskrivning av felet, till exempel
  ”Error sending document via Peppol – see log for details”.

Peppol

• Message id: Peppol-nätverkets unika message ID.

• Sender peppol id: avsändarens Peppol-ID som användes vid sändningen.

Peppol reporting (och andra kontextspecifika avsnitt)

• C2 id: identitet som används i Peppol- eller operatörrapportering.

• C1 country: land för avsändande eller mottagande part, till exempel SE.

Exakt struktur och fältnamn kan variera beroende på meddelandetyp och hur transaktionen har behandlats, men principen är densamma: metadata ger teknisk kontext till vad som hänt med transaktionen.

Använda metadata för att rätta felaktiga transaktioner

Transaktionsloggen är skrivskyddad. Du kan inte ändra eller skicka om meddelanden direkt i loggen. I stället använder du informationen i loggen och metadata för att rätta grundorsaken i dina system och skickar sedan en ny transaktion.

1. Identifiera felet

   • Öppna metadatafönstret för en rad med status Fel.

   • Gå igenom avsnittet Error och eventuell Peppol-information.

2. Tolka orsaken. Vanliga orsaker kan vara:

   • Ogiltigt eller saknat Peppol-ID.

   • Mottagaren är inte nåbar i valt nätverk.

   • Icke kompatibel XML eller saknade obligatoriska fält.

   • Anslutningsproblem eller timeout i distributionskanalen.

3. Rätta källsystemet. Gör korrigeringar i ert affärssystem, fakturasystem eller integration:

   • Uppdatera kund- eller leverantörsregister (till exempel Peppol-ID:n).

   • Korrigera innehållet i dokumentet och skapa en ny fil.

   • Justera integrationsinställningar om routning eller format är felaktiga.

4. Skicka om dokumentet

   • Skicka dokumentet på nytt från källsystemet eller integrationen.

   • Använd transaktionsloggen igen för att verifiera att den nya transaktionen behandlas och får status Hanterat.

Exportera filtrerade fellistor

När du behöver analysera eller dela felinformation:

1. Använd relevanta filter (till exempel viss period, kund och Status = Fel).

2. Klicka på Ladda ner.

3. Öppna CSV-filen i ditt analysverktyg för att gruppera, sammanfatta eller bifoga i supportärenden.

Användningsområden

• Regelbundna kvalitetsgenomgångar av din integration.

• Att samordna korrigeringar med kunder, leverantörer eller intern IT.

• Att ge underlag och teknisk detaljinformation till Qvalias support vid behov.