Från API-nyckel till första anropet
Vårt onboardingteam stöttar er genom integration och test.
export ACCOUNT_REG_NO=YOUR_ACCOUNT_REGISTRATION_NUMBER
# Identifierar kontot i varje anrop mot Transaction APIAnvänd värdet i sökvägen för varje anrop mot Transaction API.
export QVALIA_API_KEY=YOUR_SANDBOX_API_KEY
export QVALIA_BASE_URL=https://api-qa.qvalia.comHåll inloggningsuppgifterna för sandbox och produktion åtskilda.
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äftar att dokumentet har tagits emot. Valideringsresultat och leveransstatus kommer via webhooks eller dokumentstatus.
export QVALIA_API_KEY=YOUR_PRODUCTION_API_KEY
export QVALIA_BASE_URL=https://api.qvalia.comFölj bearbetning och leverans via webhooks eller dokumentstatus.
Ett konto, sex API:er
Faktura-API
Skicka och ta emot fakturor och kreditnotor via Peppol, med validering före leverans.
Order-API
Ta emot inköpsorder och skicka orderbekräftelser för e-order via Peppol.
Partner-API
Skapa och hantera slutkunders konton och Peppol-ID:n från er egen plattform, med webhooks för dokumenthändelser.
OCR-API
Extrahera strukturerad data ur PDF-fakturor för granskning och vidare bearbetning.
Databeriknings-API
Klassificera dokument och fakturarader och berika transaktioner med strukturerad data.
Bokförings-API
Ta fram konteringsförslag för inkommande fakturor, för snabbare granskning och bokföring.
Fler sätt att ansluta
När en API-integration inte passar, eller när ni behöver mer än dokumentutbyte.
- SFTP
Utbyt filer i XML eller CSV via SFTP när en API-integration inte är ett alternativ. - ERP-kopplingar
Färdiga kopplingar till vanliga affärs- och ekonomisystem. - Peppol MCP-server
Ge AI-agenter och MCP-klienter strukturerad åtkomst till transaktioner, fakturarader, leveransstatus och validering. - Punchout
Koppla en leverantörskatalog till köparens inköpssystem. - B2B-kassa
Lägg till B2B-betalning och fakturering i en WooCommerce-butik, med leverans via Peppol.
Peppol-referens för utvecklare
Reglerna som era dokument valideras mot och kodlistorna de använder. Samlade i Peppol-dokumentationen.
Test och drift
Sandbox
Testa integrationen mot era egna system utan att påverka riktiga kunder eller betalflöden.
Versionshantering
Ändringar som bryter bakåtkompatibiliteten släpps som en ny API-version, med minst en månads framförhållning.
Systemstatus
Se aktuell tillgänglighet och information om incidenter.
Säkerhet
Läs hur Qvalia arbetar med informationssäkerhet, kontinuitet och förtroende.
Peppol för ert företag eller era kunder?
Peppol-accesspunkt
Ni vill skicka och ta emot Peppol-dokument för ert eget företag. Anslut till Qvalias Peppol-accesspunkt och integrera den med ert affärssystem eller via API:et.
Partnerlösningar
Erbjud Peppol till era egna kunder med den modell som passar er roll. Bygg in Peppol i er produkt via Qvalias API med Embedded Peppol, eller drifta en Hosted Access Point med er egen identitet som Peppol-tjänsteleverantör.
Vanliga frågor från utvecklare
Mer stöd för implementeringen finns i vår kunskapsbank.
Finns det en testmiljö?
Ja. Sandboxen på api-qa.qvalia.com använder en separat API-nyckel, så ni kan testa utan att påverka riktiga kunder eller betalflöden. Följ steg-för-steg-guiden för Peppol-API:et i kunskapsbanken.
Vilka format tar API:et emot?
JSON som standard, eller XML. Båda bygger på UBL 2.1-strukturer för respektive Peppol-dokument. Sätt Content-Type och Accept till application/json eller application/xml. Se meddelandetyper i Peppol för de affärsdokument och processer som nätverket stöder.
Hur sker autentiseringen?
Med en API-nyckel i Authorization-headern. Ni får separata nycklar för test och produktion. Partner-API:et använder OAuth 2.0 client credentials.
Hur vet jag att ett dokument har levererats?
Prenumerera på webhooks eller fråga API:et löpande. Qvalia skickar händelser när ett dokument kommer in, när det har levererats och när leveransen misslyckas. För svarsmeddelanden på Peppol-nivå, se Message Level Status i kunskapsbanken.
Behöver jag implementera Peppol-transporten själv?
Nej. Qvalia driftar accesspunkten och sköter uppslag av mottagare, AS4-transport och leverans. Ni skickar dokumentet till API:et. Läs hur tjänsteuppslag med SMP och SML hittar mottagarens endpoint.
Kan jag integrera utan att skriva kod?
Ja. Använd en ERP-koppling, eller utbyt XML- eller CSV-filer via SFTP.
Vilka Peppol-dokument kan jag utbyta?
Peppol stöder strukturerade affärsdokument för fakturering, beställning, kataloger, leveransaviseringar och tillhörande svar. Vilka dokumenttyper som ingår i er Qvalia-lösning beror på vald tjänst och integration. Se Vilka meddelandetyper finns i Peppol? för en översikt.
Hur hittar API:et mottagarens endpoint?
Qvalia använder mottagarens Peppol-ID för att hitta dess Service Metadata Publisher (SMP) via Service Metadata Locator (SML). SMP:n returnerar dokumentkapacitet, process och den transport-endpoint som behövs för leverans. Läs Peppol SMP och SML: så fungerar tjänsteuppslaget.
Vad händer när ett dokument inte klarar Peppol-valideringen?
Ett dokument med ett fatalt valideringsfel måste rättas innan det skickas. Felkoden visar vilken regeluppsättning och vilken del av dokumentet som behöver undersökas. Se Så fungerar Peppol-validering och Regelkoder för Peppol-validering.
Hur kontrollerar jag en mottagares Peppol-ID och dokumentkapacitet?
Använd Qvalias sökning på Peppol-ID för att hitta deltagaren och den dokumentkapacitet som publicerats i katalogen. För identifierarnas struktur och scheman, se Vad är ett Peppol-ID? i kunskapsbanken.