Peppol API i korte trekk
Fra API-nøkkel til første forespørsel
Vårt onboarding-team støtter deg gjennom integrasjon og testing.
export ACCOUNT_REG_NO=YOUR_ACCOUNT_REGISTRATION_NUMBER
# Identifies the account in every Transaction API requestBruk denne verdien i forespørselsbanen for hvert Transaction API-kall.
export QVALIA_API_KEY=YOUR_SANDBOX_API_KEY
export QVALIA_BASE_URL=https://api-test.qvalia.comHold sandkasse- og produksjonslegitimasjon atskilt.
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 bekrefter at dokumentet ble mottatt. 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 for fakturering
Send og motta fakturaer og kreditnotaer via Peppol, med validering før levering.
Bestill API
Send og motta bestillinger via Peppol, med bestillingssvar, endringer og kanselleringer for hele bestillingsprosessen.
Partner-API
Opprett og administrer sluttkundekontoer og Peppol-ID-er fra din egen plattform, med webhooks for dokumenthendelser.
OCR API
Hent ut strukturerte data fra PDF-fakturaer for gjennomgang og videre behandling.
Berikelses-API
Klassifiser dokumenter og linjeposter, og berik transaksjoner med strukturerte data.
API for regnskap
Generer konteringsforslag fra innkommende fakturaer for raskere gjennomgang og kontering.
Flere måter å koble til på
Når en API-integrasjon ikke passer, eller du trenger mer enn dokumentutveksling.
- SFTP
Utveksle filer i XML eller CSV over SFTP når API-integrasjon ikke er et alternativ. - ERP-koblinger
Ferdige koblinger for vanlige ERP- og regnskapssystemer. - Peppol MCP-server
Gi KI Agenter og MCP-klienter strukturert tilgang til transaksjoner, linjeelementer, leveringsstatus og validering. - Punchout
Connect en leverandørkatalog til kjøperens innkjøpssystem. - B2B-kasse
Legg til et B2B-betalings- og faktureringsalternativ i en WooCommerce-butikk, med levering via Peppol.
Peppol-referanse for utviklere
Denne siden dekker Qvalias API-er og Peppol-dokumentene de inneholder. Peppol-standarden bak dem, med spesifikasjoner, valideringsregler og kodelister, er dekket i vår Peppol-dokumentasjons- og implementeringsveiledning . Den fullstendige endepunktreferansen finnes på api.qvalia.io . De normative Peppol-spesifikasjonene er publisert av OpenPeppol på docs.peppol.eu .
Peppol-dokumenter og deres API-er
| Dokument | Peppol-spesifikasjon | Qvalia API |
| Faktura | Peppol BIS Billing 3.0 | Faktura-API-er |
| Kreditnota | Peppol BIS Billing 3.0, kreditnota | API-er for kreditnotaer |
| Bestilling og ordrerespons | Peppol BIS Ordering | Bestillings-API-er, bestillingsrespons-API-er |
| Ordreavtale | Peppol BIS Order Agreement | API-er for bestillingsavtaler |
| Ordreendring og kansellering | Peppol BIS Advanced Ordering | API-er for ordreendring, API-er for ordrekansellering |
| Forsendelsesråd | Peppol BIS Despatch Advice | API-er for forsendelsesråd |
| Katalog | Peppol BIS Catalogue med svar | Katalog-API-er |
| Leveringsstatus | Svar på meldingsnivå og status på meldingsnivå | API-er for svar på meldingsnivå, API-er for status på meldingsnivå |
Validering og feil
Kodelister
Adressering og oppslag
Testing og drift
Sandbox
Test integrasjonen mot dine egne systemer uten å påvirke reelle kunder eller økonomiske strømmer.
Versjonering
Viktige endringer sendes som en ny API-versjon, med minst én måneds varsel.
Systemstatus
Se gjeldende tjenestetilgjengelighet og hendelsesoppdateringer.
Sikkerhet
Les hvordan Qvalia jobber med informasjonssikkerhet, forretningskontinuitet og tillit.
Peppol for din bedrift eller dine kunder?
Peppol aksesspunkt
Du ønsker å sende og motta Peppol-dokumenter for din egen bedrift. Connect til Qvalias Peppol aksesspunkt og integrer det med ERP-systemet ditt eller gjennom API-et.
Partnerløsninger
Tilby Peppol til dine egne kunder med modellen som passer din rolle. Bruk innebygd Peppol i produktet ditt gjennom Qvalias API, eller kjør en Hosted aksesspunkt under din egen Peppol-tjenesteleverandøridentitet.
Spørsmål utviklere stiller
Finn mer implementeringsveiledning i kunnskapsbasen vår.
Finnes det et testmiljø?
Ja. Sandkassen på api-test.qvalia.com bruker en separat API-nøkkel, slik at du kan teste uten å påvirke reelle kunder eller økonomiske strømmer. Følg Peppol API-veiledningen trinn for trinn i kunnskapsbasen.
Hvilke formater godtar API-et?
JSON som standard, eller XML. Begge bruker UBL 2.1-baserte strukturer for de relevante Peppol-dokumentsluttpunktene. Sett Content-Type og Accept til application/json eller application/xml. Se Peppol-meldingstyper for forretningsdokumenter og prosesser som støttes av nettverket.
Hvordan autentiserer jeg?
Med en API-nøkkel i Authorization-headeren, eller med en kortlivet token (JWT) som du får fra /token-endepunktet ved hjelp av nøkkelen din. Du får separate nøkler for test og produksjon.
Hvordan vet jeg om et dokument ble levert?
Abonner på webhooks, eller avspør API-et. Qvalia sender hendelser når et dokument ankommer, når det leveres og når levering mislykkes. For svarmeldinger på Peppol-nivå, se Meldingsnivåstatus i kunnskapsbasen.
Må jeg implementere Peppol transport selv?
Nei. Qvalia driver aksesspunkt og håndterer mottakeroppslag, AS4-transport og levering. Du sender et dokument til API-et. Les hvordan SMP- og SML-tjenesteoppdagelse finner mottakerendepunktet.
Kan jeg integrere uten å skrive kode?
Ja. Bruk en ERP-kobling, eller utveksle XML- eller CSV-filer via SFTP.
Hvilke Peppol-dokumenter kan jeg bytte?
Fakturaer, kreditnotaer, bestillinger, ordresvar, bestillingsavtaler, ordreendringer og -kanselleringer, leveringsvarsel, kataloger og svar på meldingsnivå. Tabellen under Peppol-referanse for utviklere viser spesifikasjonen bak hver enkelt. Hvilke dokumenttyper oppsettet ditt inkluderer avhenger av den valgte tjenesten og integrasjonen. Se Hva er meldingstypene i Peppol? for en oversikt.
Hvordan finner API-et mottakerens endepunkt?
Qvalia bruker mottakerens Peppol ID for å finne sin Service Metadata Publisher (SMP) gjennom Service Metadata Locator (SML). SMP returnerer dokumentfunksjonene, prosessen og transportendepunktet som trengs for levering. Les Peppol SMP og SML: hvordan tjenesteoppdagelse fungerer .
Hva skjer når et dokument ikke valideres med Peppol?
Et dokument med en fatal valideringsfeil må korrigeres før det sendes. Feilkoden identifiserer regelsettet og den delen av dokumentet som må undersøkes. Se Hvordan Peppol-validering fungerer og Peppol-valideringsregelkoder .
Hvordan kan jeg sjekke en mottakers Peppol ID og dokumentasjonsmuligheter?
Bruk Qvalias Peppol ID -søk for å finne deltakeren og dokumentfunksjonene som er publisert i katalogen. For identifikatorstruktur og -skjemaer, se Hva er Peppol ID ? i kunnskapsbasen.