Oavsett om du är ett mindre företag, en stor organisation eller en systemleverantör erbjuder Qvalias API ett enda, standardbaserat sätt att integrera med Peppol-nätverket, med valfritt stöd för ytterligare EDI-flöden, intelligent dokumenthantering och databerikning.

Via tjänsten Faktura-API kan du hantera fakturarelaterade Peppol-meddelanden som BIS Billing (faktura), BIS Billing Credit Note (kreditnota), BIS Self-Billing Invoice (självfaktura), BIS Self-Billing Credit Note (självfaktura–kreditnota) och BIS Invoice Response (fakturasvar), samt vid behov komplettera med Message Level Response för tekniska kvittenser kopplade till fakturor och andra Peppol-meddelanden.

Användningsområden:

Den här guiden innehåller hur man:

Qvalias Peppol API tillhandahåller ett enhetligt gränssnitt för elektroniska affärsmeddelanden via Peppol och EDI. Det är byggt för att stödja affärskritiska områden:

Gemensamma principer:

Det innebär att du kan fokusera på affärsmeddelanden snarare än nätverksprotokoll. Du skapar giltiga UBL-dokument; Qvalia hanterar Peppol- och EDI-lagret i bakgrunden.

För att komma igång med Qvalias Peppol-API behöver du några grundläggande komponenter:

Qvalia-konto
Din organisation onboardas som Qvalia-kund. Du får ett account registration number som identifierar ditt konto i alla transaktionsanrop

API-nyckel
Autentisering sker med API-nyckel, med separata nycklar för test och produktion. Alla anrop görs över HTTPS med modern TLS.

AccountRegNo i URL-sökvägen
Transaktionsanrop inkluderar accountRegNo i path, till exempel:

Formatval: JSON eller XML
Du kan välja JSON eller XML via HTTP-headrar (Content-Type och Accept). JSON används som standard om inget anges.

När dessa är på plats kan du börja testa Peppol-flöden i Qvalias sandbox-miljö.

Det här avsnittet beskriver en typisk första integration mellan ditt system och Qvalias Transaction API — inklusive både utgående och inkommande fakturor.

Integrera först mot testmiljön:

Det gör att du kan bygga och testa utan att påverka verkliga dataflöden.

I din konfiguration lagrar du:

Alla anrop ska inkludera:

Alla transaktioner använder UBL 2.1.

Du kan:

Headers styr formatet:

JSON (standard)

XML

Mappa ditt interna fakturaobjekt till relevanta UBL-element:

Målet:

För inkommande fakturor använder du samma UBL-modell för tolkning, validering och vidare mapping.

När din UBL-payload är klar, endpoint-exempel:

Inkludera:

Qvalia validerar fakturan, skickar den via Peppol-nätverket eller EDI/VAN och returnerar status och identifierare.

För att hämta inkommande fakturor via API:

Du kan även:

Den mottagna UBL-JSON eller XML-datat mappas sedan in i dina interna processer för bokföring, attest, eller vidare behandling.

Transaction API använder förutsägbara HTTP-statuskoder:

Samma beteende gäller för alla dokumenttyper.

Utöver API-svaren kan du när som helst logga in i Qvalia och granska transaktionsloggen, med bl.a.:

Transaktionsloggen är värdefull för:

Tillsammans ger HTTP-svar + transaktionslogg en helhetsbild för både systemlogik och operativ insyn.

När fakturor fungerar är det enkelt att lägga till fler dokumenttyper.

Typiska utökningar:
Ordrar – ta emot och skicka ordermeddelanden
Orderbekräftelser och orderändringar
Kataloger – artikel- och prisuppdateringar
Despatch advice – leveransinformation
Message-level responses – tekniska och affärsmässiga kvittenser

Eftersom allt detta använder samma API-design, autentiseringsmodell och UBL 2.1-datamodell behöver du inga separata projekt eller gateways för varje dokumenttyp. Du aktiverar nya användningsfall i takt med att din verksamhet eller dina kunders behov utvecklas.

Programvaruleverantörer — t.ex. fakturaplattformar, ERP, ekonomisystem eller integrationsmotorer — behöver en annan modell. Qvalias Partner API kan hantera flerkundslösningar för att möjliggöra meddeladeutbyte för slutanvändare, inklusive Peppol-ID registreringar.

Partner API behövs ifall du:

Qvalias partnermodell är utformad för just detta.

När en kund aktiverar Peppol/e-faktura i ert gränssnitt skapas eller länkas ett Qvalia-konto.
accountRegNo lagras tillsammans med ert interna kund-ID.

För att skicka eller ta emot meddelanden på uppdrag av en kund används:

Exempel:

Qvalia routar och tar emot meddelanden som om kunden själv skickade dem — med full spårbarhet per konto.

Utöver transportlager och Peppol-anslutning erbjuder Qvalia även Enrichment API — en tjänst för databerikning, klassificering och PDF-extraktion.

Enrichment API är asynkront:

Resultatet kan innehålla:

Skicka faktura för berikning

Polla status

Hämta specifik enrichment-typ

Qvalias API ger enkel och skalbar accesspunkt till Peppol-nätverket — oavsett företagstyp:

Nästa steg är enkelt: anslut mot sandbox, skicka din första testfaktura och planera hur Peppol, EDI och databerikning kan bli en naturlig del av dina processer — inte ett separat projekt.