Uanset om du er en lille virksomhed, en stor virksomhed eller en softwareleverandør, giver Qvalias API dig en enkelt, standardbaseret måde at integrere med Peppol-netværket på, med valgfri understøttelse af yderligere EDI-flows, intelligent dokumentbehandling og databerigelse.

Gennem tjenesten Invoicing API kan du arbejde med fakturarelaterede Peppol-meddelelser som BIS BIS Billing (faktura), BIS BIS Billing Credit Note (kreditnota), BIS Self-Billing Invoice, BIS Self-Billing Credit Note og BIS Invoice BIS Invoice Response og, når det er nødvendigt, supplere dem med Message Level Response til tekniske bekræftelser relateret til fakturaer og andre Peppol-meddelelser.

Det kan API'en:

I denne guide lærer du, hvordan du gør:

Peppol-API'en giver en samlet grænseflade til elektroniske forretningsmeddelelser via Peppol og EDI. Det er bygget til at understøtte kernescenarier som f.eks:

Et fælles designprincip bruges på tværs af alle slutpunkter:

For dig betyder det, at du kan tænke i forretningsmeddelelser i stedet for netværk og protokoller. Du opretter gyldige UBL-baserede dokumenter; Qvalia håndterer Peppol- og EDI-laget i baggrunden.

At komme i gang med Qvalias Peppol API kræver kun nogle få grundlæggende ting:

Qvalia-konto
Din organisation er onboardet som Qvalia-kunde. Du modtager et kontoregistreringsnummer, som unikt identificerer din konto i alle transaktionsopkald.

API-nøgle
Autentificering håndteres via en API-nøgle med separate nøgler til test- og produktionsmiljøer. Alle opkald foretages via HTTPS med moderne TLS.

Kontoregistreringsnummer i URL-stien
Transaktionskald inkluderer dit accountRegNo i stien. For eksempel:

Valg af format: JSON eller XML
Du kan vælge JSON eller XML via standard HTTP-overskrifter (Content-Type og Accept). JSON er standard, hvis der ikke foretages et eksplicit valg.

Når disse elementer er på plads, er du klar til at begynde at teste Peppol-trafik med Qvalia.

Dette afsnit gennemgår en typisk første integration mellem dit system og Qvalias transaktions-API, som dækker både afsendelse og modtagelse af Peppol-fakturaer.

Begynd med at integrere mod sandkassemiljøet:

Det giver dig mulighed for at bygge og teste uden at påvirke rigtige kunder eller økonomiske strømme.

Gem det i din konfiguration:

Hver anmodning skal indeholde:

Alle transaktioner bruger UBL 2.1 som den underliggende standard.

Det kan du enten gøre:

Overskrifter styrer formatet:

JSON (standard)

XML

Denne fleksibilitet gør det muligt at integrere Peppol-API'en i både JSON-først og XML-først-miljøer.

Dernæst skal du mappe din interne fakturamodel til UBL-elementer. Både UBL JSON og UBL XML er tilgængelige.

Målet er at sikre det:

Derefter serialiserer du dette som enten JSON eller XML, afhængigt af dit valg af format. For indgående fakturaer bruger du den samme UBL-struktur, når du læser, validerer og mapper data fra Qvalia til din interne model.

Trin 5a: Send en udgående Peppol-faktura

Med din udgående payload klar, endpoint-eksempel:

Inklusive:

Qvalia validerer fakturaen, sender den videre via Peppol-netværket eller VAN og returnerer et svar med identifikatorer og status.

For at hente indgående fakturaer fra Qvalia via API, skal du typisk:

Ring f.eks. til det indgående slutpunkt:

Det kan du også gøre:

Den returnerede UBL JSON eller XML mappes derefter ind i din interne datamodel til bogføring, godkendelse eller videre behandling.

Transaktions-API'en bruger forudsigelige HTTP-statuskoder, som du kan mappe til logfiler, overvågning og brugermeddelelser. Typiske mønstre:

De samme mønstre gælder, uanset om du sender eller modtager fakturaer.

Ud over API-svarene kan du altid logge ind på Qvalia og gennemgå aktiviteterne i transaktionsloggen. Dette giver dig en UI-baseret visning af, hvad der sker i din integration, herunder f.eks:

Transaktionsloggen er nyttig til:

Sammen giver HTTP-statuskoderne og transaktionsloggen et komplet billede: Dit system kan reagere programmatisk på svar, mens dit team kan undersøge og følge op direkte i Qvalia, når det er nødvendigt.

Når du har fakturaer på plads, er det nemt at udvide din integration til en fuld Peppol-meddelelsesportefølje.

Typiske udvidelser omfatter:
Ordrer. Modtag og send strukturerede ordrer elektronisk
Ordresvar og ændringer. Bekræft, ændr eller annullér ordrer
Kataloger. Vedligehold produkt- og prisoplysninger i elektroniske kataloger
Forsendelsesadvisering. Kommuniker forsendelsesoplysninger
Svar på meddelelsesniveau. Spor tekniske og forretningsmæssige bekræftelser

Fordi alt dette bruger samme API-design, godkendelsesmodel og UBL 2.1-datamodel, har du ikke brug for separate projekter eller gateways til hver dokumenttype. Du muliggør nye use cases, efterhånden som din virksomhed eller dine kunders krav udvikler sig.

Det er her, at løftet om "én Peppol API uanset behov" bliver håndgribeligt: Den samme integration tjener små leverandører, store virksomheder og komplekse platformsscenarier.

Hvis du er softwareleverandør - og driver en faktureringsplatform, ERP, regnskabsløsning eller integrationsplatform - er dine krav lidt anderledes. Med Qvalias Partner API kan du opsætte en multi-tenant-konfiguration til udveksling af meddelelser til slutbrugere, herunder håndtering af Peppol ID .

Partner-API'en til Peppol er nødvendig, hvis du har brug for det:

Qvalias partnerorienterede model er designet specielt til dette formål.

Din applikation genererer eller forbruger UBL-nyttelast (fakturaer, ordrer osv.) på samme måde som med standard Transaction API. Hvis du vil sende eller modtage transaktioner på vegne af en bestemt kunde, kalder du Transaction API'en via det partnerpræfiksede URI-mønster:

For eksempel:

Qvalia videresender og modtager beskeder, som om de var sendt eller modtaget direkte af kunden, med fuld sporbarhed pr. konto.

Ud over transport og tilslutning tilbyder Qvalia også Enrichment API, som kan berige transaktioner med klassificering af varelinjer, behandling før og efter transaktioner og meget mere, og som kan udtrække og omdanne PDF-dokumenter til rige, strukturerede og validerede data med en minimal indsats.

Berigelses-API'en er designet som en asynkron tjeneste:

Dette resultat kan omfatte:

En typisk integration ser sådan ud:

Indsend en faktura til berigelse
Kald et endpoint, vedhæft fakturafilen og eventuelle relevante metadata, og
Gem det returnerede pollingId.

Poll for completion
Kald med sikre intervaller. Under behandlingen bekræfter API'en, at jobbet stadig kører. Når det er færdigt, returnerer det en status og et link til berigelsesresultatet.

Hent specifikke berigelsestyper
Ring for at få et bestemt berigelsesoutput - f.eks. detaljerede fakturadata eller Peppol-valideringsresultater. Indsæt dette i din regnskabsmotor, analysestak eller automatiseringslogik.

I alle tilfælde er adgangen til denne teknologi ligetil: den samme konto- og sikkerhedsmodel som Transaction API og et lille sæt veldefinerede endpoints.

Qvalias API er bygget til at give dig et forenklet, skalerbart adgangspunkt til Peppol-netværket, uanset din virksomhedstype:

Det næste skridt er ligetil: Opret forbindelse til sandkassen, send din første testfaktura, og begynd at planlægge, hvordan Peppol, EDI og berigelse kan blive en indbygget del af din drift eller dit produkt - i stedet for et separat, komplekst projekt.