Enten du er en liten bedrift, en stor Bedrift , eller en programvareleverandør, gir Qvalias API deg én enkelt, standardbasert måte å integrere med Peppol-nettverket på, med valgfri støtte for ytterligere EDI-flyter, intelligent dokumentbehandling og databerikelse.

Through the service Invoicing API, you can work with invoice-related Peppol messages such as BIS Billing (invoice), BIS Billing Credit Note (credit note), BIS Self-Billing Invoice, BIS Self-Billing Credit Note and BIS Invoice Response, and, when needed, complement them with Message Level Response for message-level validation results during the MLR transition period. Transport receipts, Message Level Status (MLS) between service providers, and business-level responses are separate mechanisms.

API-et kan:

I denne veiledningen lærer du hvordan du:

Peppol API tilbyr et enhetlig grensesnitt for elektroniske forretningsmeldinger over Peppol og EDI. Det er bygget for å støtte kjernescenarier som:

Et felles designprinsipp brukes på tvers av alle endepunkter:

For deg betyr dette at du kan tenke i forretningsmeldinger i stedet for nettverk og protokoller. Du oppretter gyldige UBL-baserte dokumenter; Qvalia håndterer Peppol- og EDI-laget i bakgrunnen.

For å komme i gang med Qvalias Peppol API kreves det bare noen få grunnleggende prinsipper:

Qvalia-konto
Organisasjonen din er registrert som Qvalia-kunde. Du mottar et kontoregistreringsnummer som unikt identifiserer kontoen din i alle transaksjonsanrop.

API-nøkkel
Autentisering håndteres via en API-nøkkel, med separate nøkler for test- og produksjonsmiljøer. Alle anrop gjøres over HTTPS med moderne TLS.

Kontoregistreringsnummer i URL-banen
Transaksjonskall inkluderer kontoregistreringsnummeret ditt i banen. For eksempel:

Formatvalg: JSON eller XML
Du kan velge JSON eller XML via standard HTTP-overskrifter (Content-Type og Accept). JSON er standard hvis det ikke gjøres noe eksplisitt valg.

Når disse elementene er på plass, er du klar til å begynne å teste Peppol-trafikk med Qvalia.

Denne delen går gjennom en typisk første integrasjon mellom systemet ditt og Qvalias transaksjons-API, som dekker både sending og mottak av Peppol-fakturaer.

Begynn med å integrere mot sandkassemiljøet:

Dette lar deg bygge og teste uten å påvirke reelle kunder eller økonomiske strømmer.

I konfigurasjonen din, lagre:

Hver forespørsel bør inneholde:

Peppol business document endpoints use the UBL 2.1-based structure defined by the applicable BIS or PINT specification. Other Qvalia APIs and endpoints may use different payload models; confirm the current API documentation for the endpoint you are implementing.

Du kan enten:

Overskrifter styrer formatet:

JSON (standard)

XML

Denne fleksibiliteten lar deg integrere Peppol API i både JSON-first- og XML-first-miljøer.

Deretter tilordner du den interne fakturamodellen din til UBL-elementer. Både UBL JSON og UBL XML er tilgjengelige.

Målet er å sikre at:

Deretter serialiserer du dette enten som JSON eller XML, avhengig av formatvalget. For innkommende fakturaer bruker du den samme UBL-strukturen når du leser, validerer og tilordner data fra Qvalia til den interne modellen din.

Step 5: Send an outgoing Peppol invoice

Med den utgående nyttelasten klar, eksempel på endepunkt:

Inkludere:

Qvalia validerer fakturaen og ruter den via Peppol-nettverket eller EDI/ VAN , og returnerer et svar med identifikatorer og status.

For å hente innkommende fakturaer fra Qvalia via API, gjør du vanligvis følgende:

Kall det innkommende endepunktet, for eksempel:

Valgfritt kan du:

Den returnerte UBL JSON- eller XML-filen blir deretter tilordnet den interne datamodellen din for publisering, godkjenning eller videre behandling.

Transaksjons-API-et bruker forutsigbare HTTP-statuskoder som du kan tilordne til logger, overvåking og brukermeldinger. Typiske mønstre:

The same patterns apply whether you are sending or receiving invoices. OpenPeppol is replacing MLR with MLS in the eDelivery layer: the MLS activation window starts on 1 March 2027, MLS becomes mandatory for service providers on 1 April 2027, and MLR is retired on 1 May 2027.

I tillegg til API-svarene kan du alltid logge inn på Qvalia og se gjennom aktiviteten i transaksjonsloggen. Dette gir deg en brukergrensesnittbasert oversikt over hva som skjer i integrasjonen din, inkludert for eksempel:

Transaksjonsloggen er nyttig for:

Sammen gir HTTP-statuskodene og transaksjonsloggen et komplett bilde: systemet ditt kan reagere programmatisk på svar, mens teamet ditt kan undersøke og følge opp direkte i Qvalia ved behov.

Når du har fakturaer på plass, er det enkelt å utvide integrasjonen til en komplett Peppol-meldingsportefølje.

Typical extensions include:
Orders. Receive and send structured orders electronically
Order responses and changes. Confirm, modify, or cancel orders
Catalogues. Maintain product and price information in electronic catalogues
Despatch advice. Communicate shipment information
Message-level validation and status. Track MLR during the transition period, MLS between service providers, and the relevant business response for each process

The available endpoints use a consistent account and authentication model, but payload structures and enabled message types depend on the relevant Peppol profile and your Qvalia service configuration. You enable new use cases as your business or your customers’ requirements evolve.

Det er her løftet om «ett Peppol API uansett behov» blir konkret: den samme integrasjonen betjener små leverandører, store bedrifter og komplekse plattformscenarioer.

Hvis du er en programvareleverandør – som driver en faktureringsplattform, ERP, regnskapsløsning eller integrasjonsplattform – er kravene dine litt annerledes. Med Qvalias Partner API kan du sette opp en flerleietakerkonfigurasjon for utveksling av meldinger for sluttbrukere, inkludert administrasjon av Peppol ID registreringer.

Partner-API-et for Peppol er nødvendig hvis du trenger å:

Qvalias partnerorienterte modell er spesielt utviklet for dette formålet.

Applikasjonen din genererer eller bruker UBL-nyttelaster (fakturaer, bestillinger osv.) på samme måte som med standard Transaction API. For å sende eller motta transaksjoner på vegne av en bestemt kunde, kaller du Transaction API gjennom det partnerprefikserte URI-mønsteret:

For eksempel:

Qvalia ruter og mottar meldinger som om de ble sendt eller mottatt direkte av kunden, med full sporbarhet per konto.

I tillegg til transport og tilkobling tilbyr Qvalia også Enrichment API , som kan berike transaksjoner med linjeelementklassifisering, behandling før og etter transaksjoner og mer, og kan trekke ut og transformere PDF-dokumenter til rike, strukturerte og validerte data med minimal innsats.

Berikelses-API-et er utformet som en asynkron tjeneste:

Dette resultatet kan inkludere:

En typisk integrasjon ser slik ut:

Send inn en faktura for berikelse
Ring et endepunkt, legg ved fakturafilen og eventuelle relevante metadata, og
Lagre den returnerte pollingId-en.

Avstemning for fullføring
Kall med trygge intervaller. Under behandlingen bekrefter API-et at jobben fortsatt kjører. Når den er ferdig, returnerer den en status og lenker til berikelsesresultatet.

Hent spesifikke berikelsestyper
Ring for å få et bestemt berikelsesresultat – for eksempel detaljerte fakturadata eller Peppol-valideringsresultater. Mat dette inn i regnskapsmotoren, analysestakken eller automatiseringslogikken din.

I alle tilfeller er tilgangen til denne teknologien enkel: samme konto- og sikkerhetsmodell som Transaction API, og et lite sett med veldefinerte endepunkter.

Qvalias API er bygget for å gi deg en forenklet, skalerbar aksesspunkt til Peppol-nettverket , uavhengig av bedriftstype:

Neste steg er enkelt: koble til sandkassen, send din første testfaktura, og begynn å planlegge hvordan Peppol, EDI og berikelse kan bli en innebygd del av driften eller produktet ditt – i stedet for et separat, komplekst prosjekt.