Peppol API i korte træk
Fra API-nøgle til første anmodning
Vores onboarding-team hjælper dig gennem integrations- og testfasen.
export ACCOUNT_REG_NO=YOUR_ACCOUNT_REGISTRATION_NUMBER
# Identifies the account in every Transaction API requestBrug denne værdi i anmodningsstien ved hvert Transaction API-kald.
export QVALIA_API_KEY=YOUR_SANDBOX_API_KEY
export QVALIA_BASE_URL=https://api-test.qvalia.comHold adgangsoplysningerne til testmiljøet og produktionsmiljøet adskilt.
curl -X POST \
${QVALIA_BASE_URL}/transaction/${ACCOUNT_REG_NO}/invoices/outgoing \
-H Authorization:${QVALIA_API_KEY} \
-H Content-Type:application/json \
-d @invoice.jsonSvaret bekræfter, at dokumentet er modtaget. Valideringsresultater og leveringsstatus følger via webhooks eller dokumentstatus.
export QVALIA_API_KEY=YOUR_PRODUCTION_API_KEY
export QVALIA_BASE_URL=https://api.qvalia.comSpor behandling og levering via webhooks eller dokumentstatus.
Én konto, seks API’er
API til fakturering
Send og modtag fakturaer og kreditnotaer via Peppol med validering inden levering.
Bestil API
Send og modtag indkøbsordrer via Peppol, herunder ordresvar, ændringer og annulleringer, der dækker hele bestillingsforløbet.
Partner-API
Opret og administrer slutkundekonti og Peppol-id’er fra din egen platform med webhooks til dokumenthændelser.
OCR API
Udtræk strukturerede data fra PDF-fakturaer med henblik på gennemgang og videre behandling.
Enrichment API
Klassificer dokumenter og linjeposter, og berig transaktioner med strukturerede data.
Regnskabs-API
Generer bogføringsforslag ud fra indgående fakturaer for at fremskynde gennemgangen og bogføringen.
Flere måder at komme i kontakt på
Når en API-integration ikke er den rigtige løsning, eller når du har brug for mere end blot udveksling af dokumenter.
- SFTP
Udveksle filer i XML- eller CSV-format via SFTP, når API-integration ikke er en mulighed. - ERP-integrationsmoduler
Færdige konnektorer til almindelige ERP- og regnskabssystemer. - Peppol MCP-server
Giv AI-agenter og MCP-klienter struktureret adgang til transaktioner, linjeposter, leveringsstatus og validering. - Punchout
Kobl en leverandørkatalog til indkøberens indkøbssystem. - B2B-kasse
Tilføj en B2B-betalings- og faktureringsmulighed til en WooCommerce-butik med levering via Peppol.
Peppol-referencevejledning for udviklere
Denne side omhandler Qvalia’s API’er og de Peppol-dokumenter, de indeholder. Peppol-standarden, der ligger til grund for dem – herunder specifikationer, valideringsregler og kodelister – er beskrevet i vores Peppol-dokumentation og implementeringsvejledning. Den fulde oversigt over endpoints findes på api.qvalia.io. De normative Peppol-specifikationer offentliggøres af OpenPeppol på docs.peppol.eu.
Peppol-dokumenter og deres API’er
| Dokument | Peppol-specifikationen | Qvalia API |
| Faktura | Peppol BIS Billing 3.0 | Faktura-API’er |
| Kreditnota | Peppol BIS Billing 3.0, kreditnota | API’er til kreditnotaer |
| Bestilling og svar på bestilling | Peppol BIS Ordering | API’er til ordrer, API’er til ordresvar |
| Bestillingsaftale | Peppol BIS Order Agreement | Bestillingsaftale-API’er |
| Ændring og annullering af ordre | Peppol BIS Advanced Ordering | API’er til ændring af ordrer, API’er til annullering af ordrer |
| Råd om afsendelse | Peppol BIS Despatch Advice | API’er til forsendelsesbekræftelser |
| Katalog | Peppol- BIS Catalogue en med svar | Katalog-API’er |
| Leveringsstatus | Respons på meddelelsesniveau og status på meddelelsesniveau | API’er til respons på meddelelsesniveau, API’er til status på meddelelsesniveau |
Validering og fejl
Kodelister
Adressering og opslag
Test og drift
Sandkasse
Test din integration i forhold til dine egne systemer uden at påvirke rigtige kunder eller pengestrømme.
Versionsstyring
Ændringer, der medfører kompatibilitetsbrud, udgives som en ny API-version med mindst en måneds varsel.
Systemstatus
Se den aktuelle tilgængelighed af tjenesterne og opdateringer om driftsforstyrrelser.
Sikkerhed
Læs, hvordan Qvalia arbejder med informationssikkerhed, forretningskontinuitet og tillid.
Peppol til din virksomhed eller dine kunder?
Peppol Access Point
Du ønsker at sende og modtage Peppol-dokumenter til din egen virksomhed. Opret forbindelse til Qvalia’s Peppol Access Point og integrer det med dit ERP-system eller via API’et.
Partnerløsninger
Tilbyd Peppol til dine egne kunder med den model, der passer bedst til din rolle. Integrer Peppol i dit produkt via Qvalia’s API, eller drift et Hosted Access Point under din egen identitet som Peppol-tjenesteudbyder.
Spørgsmål, som udviklere stiller
Du kan finde yderligere vejledning til implementering i vores vidensbase.
Findes der et testmiljø?
Ja. Sandkassen på api-test.qvalia.com bruger en separat API-nøgle, så du kan teste uden at påvirke rigtige kunder eller økonomiske transaktioner. Følg den trinvise vejledning til Peppol API i vidensdatabasen.
Hvilke formater understøtter API’et?
Som standard JSON eller XML. Begge formater anvender UBL 2.1-baserede strukturer til de relevante Peppol-dokumentendepunkter. Indstil »Content-Type« og »Accept« til »application/json« eller »application/xml«. Se Peppol-meddelelsestyper for de forretningsdokumenter og -processer, der understøttes af netværket.
Hvordan logger jeg ind?
Med en API-nøgle i Authorization-headeren eller med et kortvarigt token (JWT), som du henter fra /token-endpointet ved hjælp af din nøgle. Du får separate nøgler til test- og produktionsmiljøet.
Hvordan kan jeg se, om et dokument er blevet leveret?
Abonner på webhooks, eller forespørg API’et. Qvalia sender hændelser, når et dokument modtages, når det leveres, og når leveringen mislykkes. For svarmeddelelser på Peppol-niveau henvises til »Status på meddelelsesniveau« i vidensdatabasen.
Skal jeg selv implementere Peppol-transporten?
Nej. Qvalia driver adgangspunktet og står for søgning efter modtagere, AS4-transport og levering. Du sender et dokument til API’et. Læs, hvordan SMP- og SML-tjenesteopdagelse finder det modtagende slutpunkt.
Kan jeg integrere uden at skrive kode?
Ja. Brug en ERP-konnektor, eller udveksle XML- eller CSV-filer via SFTP.
Hvilke Peppol-dokumenter kan jeg udveksle?
Fakturaer, kreditnotaer, ordrer, ordresvar, ordreaftaler, ordreændringer og -annulleringer, forsendelsesmeddelelser, kataloger og svar på meddelelsesniveau. Tabellen under »Peppol-reference for udviklere« viser specifikationerne bag hver enkelt type. Hvilke dokumenttyper din opsætning omfatter, afhænger af den valgte tjeneste og integration. Se »Hvad er meddelelsestyperne i Peppol?« for at få et overblik.
Hvordan finder API’et modtagerens endpoint?
Qvalia bruger modtagerens Peppol ID til at finde sin Service Metadata Publisher (SMP) via Service Metadata Locator (SML). SMP returnerer de dokumentfunktioner, proces- og transportendepunkter, der er nødvendige for leveringen. Læs »Peppol SMP og SML: Sådan fungerer serviceopdagelse«.
Hvad sker der, når et dokument ikke består Peppol-valideringen?
Et dokument med en alvorlig valideringsfejl skal rettes, før det sendes. Fejlkoden angiver, hvilket regelsæt der er tale om, og hvilken del af dokumentet der skal undersøges nærmere. Se afsnittene »Sådan fungerer Peppol-validering « og »Peppol-valideringsreglekoder«.
Hvordan kan jeg kontrollere en modtagers Peppol ID og dokumentkapacitet?
Brug Qvalia-søgningen »Peppol ID « til at finde deltageren og de dokumentfunktioner, der er offentliggjort i kataloget. For oplysninger om identifikatorstrukturer og -skemaer henvises til afsnittet »Hvad er Peppol ID? « i vidensdatabasen.