Peppol for utviklere: Kom i gang med elektroniske bestillinger

Peppol er et internasjonalt, åpent B2B-nettverk som gjør det mulig for organisasjoner å utveksle strukturerte forretningsdokumenter som ordrer og fakturaer på en effektiv måte.

For utviklere er det avgjørende å forstå Peppols tekniske spesifikasjoner og implementeringsprosess for å kunne bygge robuste systemer som forbedrer organisasjonens effektivitet. Denne veiledningen beskriver nøkkelbegreper og teknisk veiledning for utviklere som ønsker å komme i gang med elektroniske bestillinger ved hjelp av Peppol.

Peppol (Pan-European Public Procurement Online) er et rammeverk som standardiserer elektronisk dokumentutveksling mellom bedrifter og offentlige organisasjoner. Det er ikke et ERP-system, en portal eller en innkjøpsplattform, men en protokoll som muliggjør interoperabilitet mellom ulike systemer.

Peppol bruker en firehjørnemodell, noe som betyr at hver organisasjon kobler seg til nettverket gjennom den valgte Peppol Access Point-leverandøren, slik at det ikke er nødvendig å samkjøre tjenesteleverandører med forretningspartnere.

De viktigste funksjonene i Peppol er:

Implementering av elektroniske bestillinger i Peppol innebærer å forstå Business Interoperability Specifications (BIS), meldingssyntaks og krav til datautveksling.

Her er en oversikt over de seks hovedtrinnene og de tekniske aspektene ved dem.

Utviklere som implementerer Peppol-fakturaer, må forstå hvordan de skal fylle ut cbc-elementer i henhold til Peppol BIS-retningslinjene for å sikre samsvar med dokumentet og vellykket overføring.

I forbindelse med Peppol og UBL (Universal Business Language)-syntaksen for fakturaer står cbc for Common Basic Components. Disse forhåndsdefinerte dataelementene i UBL-skjemaet representerer grunnleggende, gjenbrukbare byggesteiner i forretningsdokumenter som fakturaer, ordrer og pakkseddelmeldinger.

Peppol støtter tre primære spesifikasjoner, også kalt profiler, for ordreprosesser. Hver BIS er utviklet for spesifikke bruksområder, og forretningspartnerne må bli enige om hvilken som skal brukes.

BIS Order Only: For enkle bestillinger uten svar fra leverandøren.
BIS Ordering: Inkluderer ordresvar for å bekrefte aksept, avvisning eller delvis aksept.
BIS Despatch Advice: Informerer kjøperen om forsendelsesdetaljer.

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

For å kunne implementere Peppol på en effektiv måte må utviklerne ha en grundig forståelse av hvordan cbc-elementene skal fylles ut i tråd med Peppol BIS-retningslinjene, slik at både samsvar og smidig overføring sikres. Det er viktig å følge den påkrevde syntaksen for alle dokumentelementer, ettersom avvik fra Peppols valideringsregler kan føre til feil som forstyrrer ordreprosessen.

Her er noen eksempler på kjerneelementer i bestillingsdokumenter:

Datarepresentasjon: cbc-elementer representerer vanligvis enkeltstående datafelter, noe som gjør dem enkle å bruke og validere.
Attributter: Noen cbc-elementer inkluderer attributter som currencyID (for beløp) eller unitCode (for mengder).
Obligatorisk/valgfritt: Peppol BIS-retningslinjene (Business Interoperability Specification) spesifiserer hvilke cbc-elementer som er obligatoriske, valgfrie eller betinget påkrevde.

Mens cbc representerer grunnleggende komponenter, brukes cac (Common Aggregate Components) for komplekse datastrukturer som grupperer beslektede cbc- og andre cac-elementer. For eksempel grupperer cac:Party all informasjon om en forretningsenhet, som navn, adresse og identifikatorer.

For mer informasjon om spesifikke cbc-elementer som brukes i Peppol UBL-bestillinger, se den offisielle dokumentasjonen for Peppol BIS Ordering .

Peppol-transaksjoner distribueres gjennom sertifiserte Peppol Access Points, også kalt Peppol Service Providers. Som utvikler må applikasjonen din koble seg til en leverandørs API for å sende og motta dokumenter. Tilgangspunktene håndterer den tekniske kompleksiteten ved ruting av meldinger til og fra handelspartnere.

Finn ut mer om hvordan du får tilgang til Peppol-ordrer via Order API.

Validering sikrer samsvar med Peppols regler og BIS-krav. Implementer robuste valideringskontroller for å identifisere feil før overføring. Kontroller for eksempel obligatoriske felt som cbc:ID og cbc:DocumentCurrencyCode. Valider dataformater, inkludert datoer, valutaer og identifikatorer.

Formatvalidering er innebygd og automatisert for brukere av Qvalias Peppol Access Point.

Før du distribuerer løsningen, bør du teste integrasjonen i et sandkassemiljø som leveres av Access Point-leverandøren. På denne måten kan du simulere ulike scenarier, for eksempel å sende inn bestillinger, motta svar og håndtere meldinger om pakkseddel.

Peppol-ordrer baserer seg på XML-baserte UBL-skjemaer. Nedenfor følger en kort oversikt over kritiske elementer i ordrestrukturen:

Toppteksten inneholder viktige metadata om bestillingen.

Kjøper og selger defineres ved hjelp av segmentene cac:BuyerCustomerParty og cac:SellerSupplierParty.

Hver ordrelinje spesifiserer varer, antall og priser.

Spesifikasjonen BIS Despatch Advice gjør det mulig for leverandørene å informere kjøperne om forsendelsesdetaljer.

Meldingen kan inneholde:

Følg Peppol BIS-retningslinjene: Følg alltid den offisielle Peppol BIS-dokumentasjonen for å sikre samsvar.
Håndter lokale variasjoner: Selv om Peppol er en global standard, kan enkelte sektorer eller regioner kreve spesifikke tilpasninger.
Automatiser valideringen: Implementer automatiserte kontroller av syntaks og innhold før overføring.
Sikre data: Sørg for at alle data som overføres, er i samsvar med GDPR og andre personvernforskrifter.

Peppol gir et robust rammeverk for elektroniske bestillinger, noe som gjør det mulig for bedrifter å effektivisere driften og forbedre datanøyaktigheten. For utviklere er det viktig å forstå de tekniske spesifikasjonene for Peppol BIS, UBL-skjemaer og Access Point-integrasjon for å kunne skape skalerbare og effektive løsninger.