Så följer du en order genom Peppol

• Varje Peppol-meddelande som passerat Qvalia har ett unikt transaktions-ID i formen @QVALIA-PSE000094 . Var du hittar det beror på riktningen: se avsnittet nedan.
• Lämna det ID:t till motparten. Det är den uppgift som gör att de kan hitta meddelandet i sin egen logg.
• Ligger meddelandet i loggen men inte hos mottagaren: kontrollera att mottagarens Peppol-ID är registrerat för rätt profil, inte bara att det finns.
• Försvinner ordersvar i mängd är orsaken nästan alltid att överförings-ID:t inte är unikt: se avsnittet längre ned.

Var ordern syns i varje steg

Det unika transaktions-ID:t

Behöver motparten felsöka på sin sida är transaktions-ID:t den mest användbara uppgiften du kan lämna. Var du hittar det beror på riktningen.

För ett meddelande du har skickat: öppna raden i transaktionsloggen, klicka på Metadata och läs fältet Message id under rubriken Peppol.

För ett meddelande du har tagit emot: läs kolumnen Correlation ID direkt i loggen.

Värdet ser likadant ut i båda fallen, till exempel b923d1a5-492c-4948-928b-9d4444e5d11a@QVALIA-PSE000094. I samma metadataruta ser du också avsändarens och mottagarens Peppol-ID, dokumenttyp och tidpunkten då meddelandet växlades.

Fält- och kolumnnamnen visas på engelska även om du har valt svenska i portalen.

Hämta ordrar programmatiskt

Två vägar finns, och båda kräver att API eller SFTP är påslaget för ditt konto:

1. API. Inkommande ordrar hämtas med GET /transaction/{accountRegNo}/orders/incoming/readorders. Lägg till query-parametern includeRead för att även få tillbaka ordrar som redan markerats som lästa: det är den vanligaste orsaken till att en order "saknas" vid ett anrop. API-dokumentationen finns på api.qvalia.io/api-documentation/apis/transaction-api.
2. SFTP. Samma ordrar kan hämtas som filer, om det passar din integration bättre.

Qvalia skriver inte order direkt till din egen databas. Mönstret som rekommenderas är att du hämtar via API eller SFTP och själv skriver vidare till din databas.

Registrering per profil: det som oftast saknas

Ett Peppol-ID kan ta emot order utan att kunna ta emot orderbekräftelse, eller tvärtom. Registreringen görs per Peppol-ID och per profil, till exempel Peppol BIS Ordering 3 och Peppol BIS Order Agreement 3. Registreringen görs av Qvalia, inte av dig. Ska du börja ta emot en ny meddelandetyp behöver du lista vilka Peppol-ID och vilka meddelandetyper det gäller och be Qvalia registrera dem. Arbetssättet är att först köra ett test i QA-miljön och därefter slå på i produktion.

Där flödet faktiskt stoppar

1. Överförings-ID:t är inte unikt

Detta är den tyngsta orsaken till att ordersvar försvinner. Det mottagande systemet läser i första hand InstanceIdentifier i SBDH (Standard Business Document Header, kuvertet runt själva meddelandet). Saknas SBDH används i stället meddelandets eget ID. Sätter avsändaren samma ID på varje ordersvar blir överförings-ID:t identiskt gång på gång: filer skriver över varandra och ordersvar försvinner utan att någon får ett felmeddelande.

SBDH kan aktiveras som en inställning per konto hos Qvalia. Observera konsekvensen: om SBDH läggs till gäller det alla inkommande meddelanden, inklusive fakturor. Ändringen kräver ditt godkännande och testas i QA innan den aktiveras i produktion.

Inställningen går inte att ändra i portalen. Kontakta Qvalia och ange vilka meddelandetyper det gäller.

Bygger du en integration bör du säkerställa unika ID:n i källsystemet. Då kan varje meddelande identifieras även om ett filnamn eller ett överföringssteg behöver felsökas.

2. Filnamnet är inte unikt

Filnamnet kan ställas in per dokumenttyp, inklusive order, ordersvar och katalog. Mönstret kan innehålla meddelandets transaktions-ID, ett löpande sekvensnummer, datum eller dokument-ID. För order och ordersvar rekommenderas transaktions-ID, eftersom det är unikt och går att slå upp i transaktionsloggen.

Inställningen görs av Qvalia, inte av dig i portalen. Kontakta supporten och ange vilka meddelandetyper det gäller. Bygg inte integrationen kring ett exakt filnamnsmönster innan det har bekräftats för ditt konto.

3. Ogiltigt Peppol-ID i ordern

En order med innehåller ett organisationsnummer utan Peppol-schema och kan inte routas. Se artikeln om att köparens organisationsnummer inte är deras Peppol-ID.

4. Tekniska stoppunkter i testmiljö

Om adressen ligger kvar efter en avregistrering

Att en adress fortfarande syns i Peppol Directory efter avregistrering betyder inte att den är kvar i nätverket. Peppol Directory är en separat, publikt sökbar katalog som inte alltid hänger med. I den tekniska katalog som accesspunkterna faktiskt använder är adressen borta och kan registreras av en ny operatör. Se artikeln om att avregistrera ett Peppol-ID.

Om det fortfarande inte fungerar

• Kontrollera en sista gång: att meddelandet finns i transaktionsloggen med ett transaktions-ID, att mottagarens Peppol-ID är registrerat för rätt profil, och att dina utgående meddelanden har unika ID:n.
• Ha med dig när du kontaktar supporten: det unika transaktions-ID:t från metadatafältet, avsändarens och mottagarens Peppol-ID, meddelandetyp och profil, datum och tidpunkt, filnamnet om filen lades på SFTP, och om det gäller QA eller produktion.
• Kontakta supporten: via supportformuläret längst ned på https://qvalia.com eller på help@qvalia.com.