Dokumenter
Fakturaer og kreditnotaer
Plus selvfakturering og fakturasvar
Formater
JSON eller UBL XML
UBL 2.1-basert, ett dokument per forespørsel
Arrangementer
Signerte webhooks
Mottatt, levert, forsinket og mislyktes
Tilgjengelighet
99,8 % per måned
Kontraktsmessig, med tjenestekreditter
Send en faktura med én forespørsel
Send fakturaen som JSON eller UBL XML til det utgående endepunktet for kontoen din. Qvalia validerer den, slår opp mottakeren på Peppol og leverer den. Kreditnotaer, selvfaktureringsdokumenter og fakturasvar følger samme mønster.
- Sandkasse på api-test.qvalia.com, produksjon på api.qvalia.com
- API-nøkkel i autorisasjonsheaderen, eller et kortlivet token (JWT)
- En Idempotency-Key-header gjør nye forsøk trygge
● ● ●
Sandkasseforespørsel: send en faktura
curl -X POST \
"https://api-test.qvalia.com/transaction/$ACCOUNT_REG_NO/invoices/outgoing" \
-H "Authorization: $QVALIA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d @invoice.jsonHvordan en faktura beveger seg gjennom API-et
Systemet ditt fungerer med ett API. Qvalia driver Peppol aksesspunkt bak det.
1. Send inn
Send inn ett dokument per forespørsel. Hvis dataene er ugyldige, eller mottakeren ikke er registrert for dokumenttypen og ingen annen leveringskanal er konfigurert, svarer API-et på 422 med en stabil feilkode før noe sendes.
2. Valider og lever
Qvalia sjekker dokumentet mot gjeldende Peppol-regler, finner mottakerens aksesspunkt og leverer dokumentet via AS4.
3. Følg statusen
Webhooks rapporterer levering, pågående forsøk og feil. Statussluttpunktet returnerer hvert dokuments siste status uten dokumentnyttelasten.
4. Motta
Innkommende fakturaer og svar venter på de innkommende endepunktene. Det leste endepunktet returnerer uleste dokumenter og markerer dem som lest, slik at neste kall bare returnerer nye.
Fakturadokumenter og endepunkter
Hver vei starter med /transaction/{accountRegNo}, registreringsnummeret til kontoen din. Hver dokumenttype har utgående og innkommende endepunkter, et lest endepunkt for uleste dokumenter og et statusendepunkt.
| Dokument | Endepunkt | Peppol-spesifikasjon |
| Faktura | /invoices | Peppol BIS Billing 3.0 |
| Kreditnota | /creditnotes | Peppol BIS Billing 3.0 |
| Selvfakturerende faktura | /selfbillinginvoices | Peppol BIS Selvfakturering |
| Selvfakturerende kreditnota | /selfbillingcreditnotes | Peppol BIS Selvfakturering |
| Fakturasvar | /invoiceresponses | Peppol BIS Invoice Response |
| Svar på meldingsnivå | /messagelevelresponses | Peppol BIS Message Level Response |
Hvilke dokumenttyper kontoen din bruker, avhenger av tjenesten og planen. Forespørsels- og svarskjemaer finnes i referansene til Faktura-API-et og Kreditnota-API-et . For alle Qvalias API-er, se Peppol API-er og utviklerverktøy .
Sjekk mottakeren før du sender
Slå opp en Peppol ID før du sender inn fakturaen. Svaret viser om deltakeren er registrert på Peppol og hvilke dokumenttyper den kan motta, slik at systemet ditt kan flagge en manglende eller feil ID før nettverket avviser fakturaen.
- Begrens sjekken til én dokumenttype med
docTypeRoot, for eksempelInvoiceellerCreditNote - De Peppol ID er skjemaet og identifikatoren, for eksempel
0007:1234567890 - Samme basis-URL-er og autentisering som i transaksjons-API-et
● ● ●
Sandkasseforespørsel: slå opp en mottaker
curl \
"https://api-test.qvalia.com/account/$ACCOUNT_REG_NO/action/lookup/peppol/0007:1234567890?docTypeRoot=Invoice" \
-H "Authorization: $QVALIA_API_KEY"Bygget for produksjonsintegrasjoner
Detaljene som avgjør om en integrasjon holder mål i volum, alt dokumentert i API-referansen.
- Trygge nye forsøk
Send en Idempotency-Key, og en gjentatt forespørsel returnerer det opprinnelige svaret i stedet for å opprette en ny faktura. - Signerte webhooks
Hver hendelse har en hendelses-ID, og når du har angitt en signeringshemmelighet, en signatur du kan bekrefte. - Spill av arrangementet i 30 dager
Hent en levert hendelse igjen via ID-en, for eksempel etter nedetid hos deg. - Status uten nyttelasten
Avstem på volum med lette statusposter, filtrert etter dato, dokument-ID eller oppdateringstidspunkt. - Tydelige rentegrenser
Grensene telles per konto, og et 429-svar forteller deg hvor lenge du må vente. - Vedlegg
Legg til PDF-filer og bilder i meldingen. Hele forespørselen, inkludert vedlegg og Base64-kodet, må holde seg under Peppols grense på 100 MB.
Én faktura, formatet hver mottaker trenger
Send fakturaen én gang. Qvalia validerer den, slår opp mottakeren og leverer den på Peppol-nettverket som Peppol. BIS Billing 3.0 eller Peppol PINT. Når mottakeren ikke er på Peppol, kan Qvalia levere via EDI, PDF via e-post, print og B2C-nettbanker i utvalgte markeder. Dette er ytterligere leveringskanaler , ikke Peppol-spesifikasjoner. Se hvilke forretningsmeldingsformater Qvalia støtter .
Hvis systemet ditt ikke kan produsere Peppol BIS, last opp fakturaen i formatet det allerede oppretter: Svefaktura 1.0, EDIFACT INVOIC, cXML, Finvoice 3.0, XRechnung, CII eller XML-filen i ZUGFeRD og Factur-X. Qvalia konverterer den til Peppol. BIS Billing 3.0, validerer den og sender den. Se sending av fakturaer i ditt eksisterende format .
Velg ditt utgangspunkt
Programvareplattformer
Innebygd Peppol
Tilby e-fakturering til dine egne kunder. Partner API oppretter kontoene og Peppol-ID-ene deres, og fakturerings-API-et bærer dokumentene deres.
ERP- og finansteam
Peppol aksesspunkt
Connect ditt ERP- eller finanssystem til Peppol via API, SFTP eller en ferdiglaget kobling.
Utviklere
Hurtigstartveiledning
Gå fra API-nøkkel til din første sandkassefaktura, trinn for trinn, med forespørselseksempler.
Vanlige spørsmål om fakturerings-API
Hva er et API for e-fakturering?
Et e-fakturerings-API lar programvaren din sende og motta strukturerte elektroniske fakturaer uten å måtte bygge nettverkstilkoblingen selv. Med Qvalias fakturerings-API poster systemet ditt fakturaer som JSON eller UBL XML, og Qvalia validerer dem og leverer dem over Peppol-nettverket.
Hvilke fakturadokumenter kan jeg sende og motta?
Fakturaer, kreditnotaer, selvfakturaer og kreditnotaer, samt fakturasvar, hver med utgående og innkommende endepunkter. Hvilke dokumenttyper kontoen din bruker, avhenger av tjenesten og planen.
Trenger jeg å kunne Peppol BIS for å bruke API-et?
Dokumentene dine følger Peppol BIS Billing 3.0, i UBL 2.1-basert JSON eller XML. Eksempeldataene på api.qvalia.io viser en komplett faktura, og valideringsfeil peker mot regelen som må rettes. Se Hvordan Peppol-validering fungerer .
Finnes det en sandkasse?
Ja. Sandkassen på api-test.qvalia.com bruker sin egen API-nøkkel, slik at du kan teste mot dine egne systemer uten å påvirke virkelige kunder. API- og sandkassetilgang er inkludert fra Connect Medium plan.
Hvordan unngår jeg å sende samme faktura to ganger?
Send en Idempotency-Key-header med hver innsending. Hvis du gjentar forespørselen, for eksempel etter et tidsavbrudd, returnerer API-et det opprinnelige svaret i stedet for å opprette et nytt dokument. En ny innsending med samme dokument-ID og mottaker returnerer 409 Conflict med mindre du velger å overskrive.
Hvordan vet jeg at en faktura er levert?
Abonner på webhooks for leverings- og feilhendelser, eller les statusendepunktet. En webhook som endepunktet ditt ikke godtar, sendes ikke på nytt, så hold en periodisk statussjekk som et sikkerhetsnett. Enhver levert hendelse kan hentes på nytt i 30 dager.
Hvordan mottar jeg innkommende fakturaer?
Abonner på den nye dokument-webhooken, og hent deretter fakturaen fra det innkommende endepunktet. Det leste endepunktet returnerer uleste fakturaer og markerer dem som lest.
Hva koster fakturerings-API-et?
API-tilgang er inkludert fra Connect Medium plan. Partner og Bedrift Priser avhenger av volum og leveringsmodell. Se planer og Priser .
