Peppol för utvecklare: att komma igång med elektroniska ordrar

Peppol är ett internationellt öppet B2B-nätverk som gör det möjligt för organisationer att utbyta strukturerade affärsdokument, såsom ordrar och fakturor, på ett effektivt sätt.

Att förstå Peppols tekniska specifikationer och implementationsprocess är avgörande för utvecklare som vill bygga robusta system som förbättrar organisatorisk effektivitet. Den här guiden beskriver nyckelkoncept och teknisk vägledning för att hjälpa utvecklare att komma igång med elektroniska ordrar via Peppol.

Peppol (Pan-European Public Procurement Online) är ett ramverk som standardiserar elektroniskt dokumentutbyte mellan företag och offentliga organisationer. Det är inte ett affärssystem, en portal eller en inköpsplattform, utan ett protokoll som möjliggör interoperabilitet mellan olika system.

Peppol använder en fyrhörnsmodell, vilket innebär att varje organisation ansluter till nätverket via sin valda Peppol accesspunkt-leverantör, vilket eliminerar behovet av att anpassa tjänsteleverantörer med affärspartners.

De viktigaste funktionerna i Peppol är:

Att implementera elektroniska ordrar i Peppol innebär att förstå dess Business Interoperability Specifications (BIS), meddelandesyntax och krav på datautbyte.

Här är en översikt över de sex grundläggande stegen och deras tekniska överväganden.

Developers implementing Peppol invoices must understand how to properly populate cbc elements according to the Peppol BIS guidelines to ensure document compliance and successful transmission.

I kontexten av Peppol och UBL (Universal Business Language) syntax för fakturor står cbc för Common Basic Components. Dessa fördefinierade dataelement inom UBL-schemat representerar grundläggande, återanvändbara byggstenar för affärsdokument såsom fakturor, ordrar och leveransaviseringar.

Peppol stödjer tre huvudsakliga specifikationer, eller profiler, för orderprocesser. Varje BIS är utformad för specifika användningsfall, och affärspartners måste komma överens om vilken som ska användas.

BIS Order Only: För enkla orderinlämningar utan leverantörssvar.
BIS Ordering: Inkluderar ordersvar för att bekräfta godkännande, avslag eller delvis godkännande.
BIS Despatch Advice: Informerar köparen om leveransdetaljer.

Peppol-ordertransaktionen/Peppol Order transaction (T01) följer UBL-standard (Universal Business Language).

För att implementera Peppol på ett effektivt sätt behöver utvecklare ha en grundlig förståelse för hur cbc-element ska fyllas i enligt Peppol BIS-riktlinjerna, vilket säkerställer både överensstämmelse och smidig överföring. Det är avgörande att följa den föreskrivna syntaxen för alla dokumentelement, eftersom avvikelser från Peppols valideringsregler kan leda till fel som stör orderprocessen.

Here are a few examples of core elements for order documents:

Data Representation: cbc elements typically represent single data fields, making them straightforward to use and validate.
Attributes: Some cbc elements include attributes like currencyID (for amounts) or unitCode (for quantities).
Mandatory/optional: The Peppol BIS (Business Interoperability Specification) guidelines specify which cbc elements are mandatory, optional, or conditionally required.

While cbc represents basic components, cac (Common Aggregate Components) is used for complex data structures that group related cbc and other cac elements. For example, cac:Party groups all information about a business entity, such as its name, address, and identifiers.

For more details on specific cbc elements used in Peppol UBL ordering, go to the Peppol BIS Billing 3.0 syntax guide.

Medan cbc representerar grundläggande komponenter används cac (Common Aggregate Components) för komplexa datastrukturer som grupperar relaterade cbc- och andra cac-element. Till exempel grupperar cac:Party all information om en affärsenhet, såsom namn, adress och identifierare.

För mer information om specifika cbc-element som används i Peppol UBL-order, see den officiella Peppol BIS Ordering-dokumentationen.

Peppol-transaktioner distribueras via certifierade Peppol accesspunkter, även kallade Peppol-tjänsteleverantörer. Som utvecklare måste din applikation ansluta till en leverantörs API för att skicka och ta emot dokument. Accesspunkter hanterar oftast de tekniska komplexiteterna med att dirigera meddelanden till och från affärspartners.

Läs mer om hur du får åtkomst till Peppol-ordrar via Order-API.

Validering säkerställer efterlevnad av Peppols regler och BIS-krav. Implementera robusta valideringskontroller för att identifiera fel innan överföring. Kontrollera till exempel obligatoriska fält som cbc:ID och cbc:DocumentCurrencyCode. Validera även dataformat, inklusive datum, valutor och identifierare.

Formatvalideringar är inbyggda och automatiserade för användare av Qvalias Peppol accesspunkt.

Innan du distribuerar din lösning bör du testa integrationen i en sandlådemiljö som tillhandahålls av din accesspunkt-leverantör. Detta gör det möjligt att simulera olika scenarier, såsom att skicka ordrar, ta emot svar och hantera leveransaviseringar.

Peppol-ordrar bygger på XML-baserade UBL-scheman. Här är en kort översikt av viktiga element:

Huvudet innehåller viktig metadata om ordern.

Köparen och säljaren definieras med hjälp av segmenten cac:BuyerCustomerParty och cac:SellerSupplierParty.

Varje orderrad specificerar artiklar, kvantiteter och priser.

Specifikationen för BIS Despatch Advice gör det möjligt för leverantörer att informera köpare om leveransdetaljer.

Meddelandet kan inkluderas:

Peppol ger en robust ram för elektroniska ordrar och hjälper företag att effektivisera sina processer. Utvecklare behöver förstå de tekniska specifikationerna för Peppol BIS, UBL-scheman och Access Point-integration för att skapa skalbara och effektiva lösningar.