Peppol for udviklere: Kom godt i gang med elektroniske ordrer

Peppol er et internationalt åbent B2B-netværk, der gør det muligt for organisationer at udveksle strukturerede forretningsdokumenter som ordrer og fakturaer på en effektiv måde.

Forståelse af Peppols tekniske specifikationer og implementeringsproces er afgørende for, at udviklere kan bygge robuste systemer, der forbedrer organisationens effektivitet. Denne vejledning beskriver nøglebegreber og teknisk vejledning til udviklere, så de kan komme i gang med elektroniske ordrer ved hjælp af Peppol.

Peppol (Pan-European Public Procurement Online) er en ramme, der standardiserer elektronisk dokumentudveksling mellem virksomheder og offentlige organisationer. Det er ikke et ERP-system, en portal eller en indkøbsplatform, men en protokol, der muliggør interoperabilitet mellem forskellige systemer.

Peppol bruger firehjørnemodellen, hvilket betyder, at hver organisation opretter forbindelse til netværket via den valgte Peppol Access Point-udbyder, hvilket fjerner behovet for at afstemme tjenesteudbydere med forretningspartnere.

De vigtigste funktioner i Peppol er:

Implementering af elektroniske ordrer i Peppol kræver, at man forstår dens Business Interoperability Specifications (BIS), meddelelsessyntaks og krav til dataudveksling.

Her er en oversigt over de seks vigtigste trin og deres tekniske overvejelser.

Udviklere, der implementerer Peppol-fakturaer, skal forstå, hvordan man udfylder cbc-elementer korrekt i henhold til Peppol BIS-retningslinjerne for at sikre dokumentoverensstemmelse og vellykket overførsel.

I forbindelse med Peppol og UBL-syntaksen (Universal Business Language) for fakturaer står cbc for Common Basic Components. Disse foruddefinerede dataelementer i UBL-skemaet repræsenterer grundlæggende, genanvendelige byggesten i forretningsdokumenter som fakturaer, ordrer og pakkemeddelelser.

Peppol understøtter tre primære specifikationer, også kaldet profiler, for ordreprocesser. Hver BIS er designet til specifikke brugsscenarier, og forretningspartnere skal blive enige om, hvilken der skal bruges.

BIS Order Only: Til simple ordreafgivelser uden leverandørrespons.
BIS Ordering: Inkluderer ordresvar for at bekræfte accept, afvisning eller delvis accept.
BIS Despatch Advice: Informerer køberen om forsendelsesdetaljer.

Peppol Order-transaktionen (T01) følger UBL (Universal Business Language) standard.

For at implementere Peppol effektivt skal udviklere have en grundig forståelse af, hvordan man udfylder cbc-elementer i overensstemmelse med Peppol BIS-retningslinjerne, hvilket sikrer både overholdelse og problemfri transmission. Det er vigtigt at overholde den krævede syntaks for alle dokumentelementer, da afvigelser fra Peppols valideringsregler kan føre til fejl, der forstyrrer ordreprocessen.

Her er et par eksempler på kerneelementer i ordredokumenter:

Datarepræsentation: cbc-elementer repræsenterer typisk enkeltstående datafelter, hvilket gør dem enkle at bruge og validere.
Attributter: Nogle cbc-elementer indeholder attributter som currencyID (for beløb) eller unitCode (for mængder).
Obligatorisk/valgfri: Peppol BIS-retningslinjerne (Business Interoperability Specification) specificerer, hvilke cbc-elementer der er obligatoriske, valgfrie eller betinget påkrævede.

Mens cbc repræsenterer basiskomponenter, bruges cac (Common Aggregate Components) til komplekse datastrukturer, der grupperer relaterede cbc- og andre cac-elementer. For eksempel grupperer cac:Party alle oplysninger om en forretningsenhed, såsom dens navn, adresse og identifikatorer.

For flere detaljer om specifikke cbc-elementer, der bruges i Peppol UBL-bestilling, se den officielle Peppol BIS Ordering -dokumentation.

Peppol-transaktioner distribueres gennem certificerede Peppol Access Points, også kaldet Peppol Service Providers. Som udvikler skal din applikation oprette forbindelse til en udbyders API for at sende og modtage dokumenter. Access Points håndterer den tekniske kompleksitet i forbindelse med routing af meddelelser til og fra handelspartnere.

Læs mere om at få adgang til Peppol-ordrer via Order API.

Validering sikrer overholdelse af Peppols regler og BIS-krav. Implementer robuste valideringstjek for at identificere fejl før overførsel. Tjek f.eks. obligatoriske felter som cbc:ID og cbc:DocumentCurrencyCode. Valider dataformater, herunder datoer, valutaer og identifikatorer.

Formatvalidering er indbygget og automatiseret for brugere af Qvalias Peppol Access Point.

Før du implementerer din løsning, skal du teste integrationen i et sandkassemiljø, som din Access Point-udbyder stiller til rådighed. Det giver dig mulighed for at simulere forskellige scenarier, f.eks. indsendelse af ordrer, modtagelse af svar og håndtering af forsendelsesmeddelelser.

Peppol-ordrer er baseret på XML-baserede UBL-skemaer. Nedenfor er en kort oversigt over kritiske elementer i ordrestrukturen:

Overskriften indeholder vigtige metadata om ordren.

Køber og sælger defineres ved hjælp af segmenterne cac:BuyerCustomerParty og cac:SellerSupplierParty.

Hver ordrelinje specificerer varer, mængder og priser.

Specifikationen BIS Despatch Advice gør det muligt for leverandører at informere købere om forsendelsesdetaljer.

Beskeden kan indeholde:

Følg Peppol BIS' retningslinjer: Følg altid den officielle Peppol BIS-dokumentation for at sikre overensstemmelse.
Håndter lokale variationer: Selv om Peppol er en global standard, kan nogle sektorer eller regioner kræve specifikke tilpasninger.
Automatiser validering: Implementer automatiserede kontroller af syntaks og indholdsoverensstemmelse før transmission.
Sikre data: Sørg for, at alle overførte data overholder GDPR og andre regler for beskyttelse af personlige oplysninger.

Peppol giver en robust ramme for elektroniske ordrer, som gør det muligt for virksomheder at strømline driften og forbedre datanøjagtigheden. For udviklere er det vigtigt at forstå de tekniske specifikationer for Peppol BIS, UBL-skemaer og Access Point-integration for at kunne skabe skalerbare og effektive løsninger.