Tid till sandbox
Timmar
Validera mot era egna system och Peppols testnät.
Tid till lansering
Dagar till veckor
Lansera enligt er integrations- och releaseprocess.
Anropsgräns
Avtalas per partner
Kapaciteten sätts per partner.
Rollen som tjänsteleverantör
Qvalia
Qvalia driftar accesspunkt, SMP och nätverksstyrning.
Teknisk support
Tredje linjen
Qvalia tillhandahåller teknisk support i tredje linjen.
Passar för
Affärssystemsleverantörer · Faktura- och bokföringsprogram · CRM-system · VAN-operatörer
B2B-marknadsplatser · Redovisningsbyråer · IT-konsulter
Er produkt, vår infrastruktur
Partnern bygger och äger användarupplevelsen. Qvalia driftar accesspunkten, SMP:n och meddelandeinfrastrukturen bakom den, nåbar via ett API.
Ni styr kundupplevelsen, avtalet och prissättningen. Qvalia driftar Peppol-tjänsten bakom ert gränssnitt.
Vad vi driftar, vad ni äger
Detta driftar Qvalia
- Accesspunkt och SMP under Qvalias roll som Peppol-tjänsteleverantör
- Validering, formatkonvertering och leverans av meddelanden i nätverket
- Registrering och uppslag av deltagare
- Övervakning, uppdateringar och regelefterlevnad i nätverket
Detta äger ni
- Gränssnittet era kunder använder, i er egen produkt
- Kundrelationen, avtalet och prissättningen
- Ert eget onboarding- och supportflöde
Så fungerar Partner-API:et
Partner-API:et omfattar systemautentisering, uppsättning av kunder, inskick av dokument och hantering av inkommande meddelanden. Qvalia driftar Peppol-transport, uppslag, validering och certifikathantering.
1. Autentisera
Partnersystem autentiserar med en API-nyckel, eller byter den mot en kortlivad JWT. Samma uppgifter gäller för Transaction-, Partner-, Account- och Enrichment-API:erna.
curl --location --globoff -X POST \
'https://api.qvalia.com/token' \
--data '{
"client_id": "{partnerRegNo}",
"client_secret": "{apiKey}"
}'
# Valid for one hour. Send it on every call:
# Authorization: Bearer <token>2. Skapa kunden
Skapa kontot och registrera dess Peppol-ID. Qvalia sköter registrering av deltagare och uppdateringar i katalogen
curl --location --globoff -X POST \
'https://api.qvalia.com/partner/{partnerRegNo}/account' \
--header 'Authorization: Bearer <token>' \
--data '{
"accountRegNo": "5567321707",
"name": "Nordkap Logistik AB",
"address": "Wallingatan 33",
"postalCode": "111 24",
"country": "SE"
}'
curl --location --globoff -X PUT \
'https://api.qvalia.com/partner/{partnerRegNo}/account/5567321707/peppol/0007:5567321707' \
--header 'Authorization: Bearer <token>'3. Skicka och ta emot meddelanden
Dokument valideras mot gällande Peppol-specifikationer före sändning. Strukturerade valideringssvar returneras till ert system, och inkommande meddelanden nås via samma konto.
curl --location --globoff -X POST \
'https://api.qvalia.com/partner/{partnerRegNo}/transaction/5567321707/invoices/outgoing' \
--header 'Authorization: Bearer <token>' \
--data '{ "Invoice": { } }'
# 200
# { "status": "success", "data": { "message": "invoice 12335675 sent" } }4. Prenumerera på händelser
Prenumerera på dokumenthändelser med webhooks. Qvalia anropar er endpoint när ett dokument kommer in, när leveransstatus ändras och när en leverans misslyckas.
curl --location --globoff -X PUT \
'https://api.qvalia.com/partner/{partnerRegNo}/webhook/configure' \
--header 'Authorization: Bearer <token>' \
--data '{
"url": "https://your-platform.example/qvalia/events",
"events": ["new_document", "document_delivery", "document_error"]
}'
# Delivered as HTTPS POST with a JSON body.
# Respond 2xx within 10 seconds.| Specifikation | Detalj |
| Transport | Peppol AS4-transport, ebMS-meddelanden och hantering av PKI-certifikat driftas av Qvalia. |
| Svarstid | API:ets svarstid beror på meddelandets storlek och uppkopplingen. Peppol-leverans är asynkron och beror på den mottagande accesspunkten. |
| Brytande ändringar | Brytande ändringar släpps som en ny API-version med minst en månads varsel, normalt längre |
Kontomodeller för flera kunder
Välj en samlad uppsättning eller ett separat konto per kund, utifrån krav på registrering, dataseparation och användarhantering.
| Samlat konto | Konto per kund | |
| Peppol-registrering | Gemensam uppsättning som ni hanterar | Eget konto och Peppol-ID per slutkund |
| Data och användare | Hanteras samlat i er plattform | Separat data, användare och inställningar per kund |
| Onboarding | Snabbaste sättet att lägga till en kund | Registrering av deltagare och kataloguppdateringar sköts av Qvalia |
| Passar | Många små kunder under en tjänst som ni driver | Kunder som behöver egen Peppol-identitet och eget spårbarhetsunderlag |
Ni styr onboardingupplevelsen i båda modellerna. Kontomodellen avgör hur deltagare registreras och hur data separeras.
Affärsdokument som stöds
Samma integration stödjer tillgängliga flöden för fakturering, order och närliggande affärsdokument.
| Dokument | Peppol-namn | Detalj |
| Faktura | Invoice | Ett betalningskrav med rader, moms och betalningsvillkor |
| Kreditnota | CreditNote | En rättelse eller återföring av en redan skickad faktura |
| Självfakturering | SelfBillingInvoice | En faktura som köparen utfärdar för leverantörens räkning |
| Kreditnota vid självfakturering | SelfBillingCreditNote | Motsvarande kreditnota till en självfakturerad faktura |
| Order | Order | En inköpsorder från köpare till leverantör |
| Ordersvar | OrderResponse | Godkännande, avslag eller ändring av en order |
| Orderavtal | OrderAgreement | Ett ramavtal som senare order hänvisar till |
| Orderändring | OrderChange | En ändring av en redan skickad order |
| Orderannullering | OrderCancellation | Annullering av en redan skickad order |
| Leveransavisering | DespatchAdvice | Vad som faktiskt har levererats, mot vilken order |
| Katalog | Catalogue | Produkter, beskrivningar och avtalade priser |
| Katalogsvar | CatalogueResponse | Godkännande eller avslag av en katalog |
| Meddelandesvar | MessageLevelResponse | Tekniskt kvitto eller avslag på ett meddelande |
| Meddelandestatus | MessageLevelStatus | Behandlingsstatus för ett meddelande i nätverket |
Punchout, PDF och EDI kan använda samma kontostruktur. Qvalia sköter validering, routing, leverans och felhantering på nätverksnivå.
Strukturerad transaktionsdata
Dokumenten finns tillgängliga som strukturerad transaktionsdata för rapportering, analys och bokföringsautomation.
Fakturarad, som den kom in
ART 4471-B
Printing paper A4 80G 5X500
12 pcs 489,00 SEKSamma rad, klassificerad
| UNSPSC | 14111507 Kopieringspapper |
| Kategori | Kontorsmaterial |
| Enhet | 12 × 2 500 ark |
| Styckpris | 40,75 SEK |
| Leverantör | Matchad mot masterdata |
Fakturarader kan struktureras och klassificeras i realtid, med masterdata kopplad till transaktionsflödet. Det ger underlag för rapportering, spendanalys och bokföringsautomation i er produkt. OCR, automatiserad kontering och klassificering finns som tillval.
Ansvar för Peppol-efterlevnad
Qvalia innehar rollen som Peppol-tjänsteleverantör för Inbyggd Peppol. Partnern ansvarar för sin kundrelation och sitt kommersiella erbjudande. Endast aktiva juridiska personer kan tilldelas ett Peppol-ID.
| Ansvar | Qvalia | Ni |
| Certifierad roll som Peppol-tjänsteleverantör | Qvalia | |
| Drift av accesspunkt och SMP | Qvalia | |
| Peppol-certifiering, revisioner och nätverksstyrning | Qvalia | |
| Ledningssystem enligt ISO/IEC 27001:2022 och ISO 22301:2019 | Qvalia | |
| Kundkännedom | Partner | |
| Kontroll av att kunder inte är avregistrerade, insolventa eller bryter mot penningtvättsregler | Partner | |
| Avtal, prissättning och kommersiell relation med slutkunden | Partner |
Detta gäller Inbyggd Peppol och White-label-plattformen. Partner som behöver inneha rollen som Peppol-tjänsteleverantör i eget namn bör i stället titta på Egen accesspunkt.
Vanliga frågor
Vad innebär Inbyggd Peppol i praktiken?
Ni erbjuder era egna kunder Peppol-anslutning och regelenligt utbyte av affärsmeddelanden, inbyggt i er produkt via ett API. Qvalia driftar Peppol-infrastrukturen i bakgrunden. Ni äger kundrelationen och erbjudandet.
Måste vi sköta Peppol-efterlevnaden själva?
Nej. Med Inbyggd Peppol innehar Qvalia rollen som Peppol-tjänsteleverantör och driftar accesspunkten och SMP:n. Qvalia sköter nätverksstyrning och teknisk regelefterlevnad för tjänsten. Ni ansvarar för avtal med slutkund, onboardinguppgifter, prissättning och support. Partner som behöver inneha rollen som tjänsteleverantör i eget namn bör överväga Egen accesspunkt.
Hur stödjer ni Peppol-uppsättningar för flera kunder?
Qvalia stödjer både samlade och kundseparerade modeller. Ni kan hantera flera slutkunder i en gemensam uppsättning, eller ge varje kund eget konto och eget Peppol-ID.
Vilka Peppol-meddelandetyper kan vi erbjuda våra användare och slutkunder?
Fakturor, kreditnotor, order, ordersvar, leveransaviseringar, kataloger och närliggande affärsmeddelanden, samt punchout. Qvalia sköter validering, routing, leverans och felhantering i nätverket. PDF och EDI går genom samma kontostruktur.
Hur onboardas och hanteras slutkunder?
Slutkunder tilldelas egna Peppol-ID och routingregler vid onboarding. Qvalia sköter registrering av deltagare, kataloguppdateringar och nätverkskonfiguration i bakgrunden, medan ni styr onboardingupplevelsen.
Måste vi polla efter inkommande dokument?
Nej. Prenumerera på webhook-händelser, så anropar Qvalia er endpoint när ett Peppol-meddelande eller dokument kommer in, när leveransstatus ändras och när en leverans misslyckas. Endpoints för pollning finns som alternativ.
Kan vi erbjuda mer än meddelandeutbyte?
Ja. Varje transaktion finns som strukturerad data med klassificering på radnivå, vilket gör att ni kan bygga rapportering, spendanalys och automatiserad kontering i er egen produkt i stället för att bara flytta dokument. OCR, automatiserad kontering och klassificering finns som tillval.
Finns det anropsgränser?
Ja. Partnerkonton ligger väl över gränserna för vanliga konton, och gränsen anpassas efter er förväntade volym. Planerar ni en stor onboarding eller ett tungt månadsskifte, hör av er.
Hur snabbt kan vi komma igång?
Tillgång till sandbox finns normalt inom några timmar. Produktionssättning beror på integration, tester och er releaseprocess.
Hur byggs integrationen?
Plattformen integreras via REST-API:er. Systemautentisering sker med OAuth 2.0 client credentials. SSO för användare konfigureras separat via de identitetslösningar som stöds. Om ni inte behöver gränssnittet i er egen produkt ger White-label-plattformen Qvalias applikation under ert varumärke.
Andra lösningar
Välj White-label-plattform för en komplett applikation, eller Egen accesspunkt när er organisation behöver inneha rollen som tjänsteleverantör.
Ni vill ha produkten, inte bygget
White-label-plattformen är Qvalias kompletta applikation under ert varumärke, er domän och er prissättning. Den ger ett fullständigt gränssnitt utan utvecklingsprojekt.
Ni behöver vara leverantören, i eget namn
Egen accesspunkt gör er till certifierad Peppol-tjänsteleverantör med egen accesspunktsidentitet och eget PKI-certifikat, på infrastruktur som Qvalia driftar.
Hör av er
Berätta vilken produkt ni bygger ut, vilka marknader ni stödjer och vilka transaktionsvolymer ni räknar med. Vi definierar kontomodell, integrationsomfattning och lanseringsplan.