Jeg har strukturerte fakturadata
Opprett hodet, legg til hver linje, legg eventuelt ved PDF-en og generer Peppol UBL-dokumentet.
Se denne flyten →
Peppox Developer Platform
Send din første faktura via Peppol, trinn for trinn.
Velg ruten som passer systemet ditt – fra første API-kall til leveringssporing.
PEPPOX / INTEGRATION FLOW
- 01Dashboard
- 02API-nøkkel
- 03Faktura
- 04Valider
- 05Peppol
READY TO BUILD
01 · Før første kall
Fire ting som klargjøres én gang
Konfigurer konto og leverandørprofil først. Deretter bruker applikasjonen de samme opplysningene for hvert dokument.
- 01
Opprett Peppox-konto
Registrer den juridiske virksomheten som sender dokumenter.
- 02
Fullfør leverandørprofilen
Bedrifts-, MVA-, bank- og Peppol-routingdata hentes fra kontoen.
- 03
Åpne integrasjonsmiljøet
Test trygt med dashboard-verktøyene før produksjon.
- 04
Kopier API-nøkkelen
Oppbevar den kun på serveren, aldri i nettleser- eller appkode.
02 · Velg den korteste ruten
Start med dataene du allerede har
Jeg lager allerede en PDF
Last opp PDF-en, la Peppox trekke ut data, kontroller, bekreft og send via Peppol.
Se denne flyten →03 · PDF2Peppol
En komplett sending i fire API-kall
Den mest direkte dokumenterte ruten når systemet allerede produserer PDF-fakturaer.
- 01
Last opp PDF
Send fil, Base64 eller URL, og lagre queue_guid.
POST/pdf2peppol/add - 02
Kontroller uttrukne data
Spør til behandlingen er ferdig, og kontroller kjøper, totaler, MVA og linjer.
GET/pdf2peppol/check - 03
Bekreft dokumentet
Bekreft først når alle uttrukne data er riktige.
POST/pdf2peppol/confirm - 04
Send til Peppol
Send det bekreftede dokumentet og lagre dokumentets GUID.
POST/pdf2peppol/send - 05
Følg leveringen
Bruk listen over sendte dokumenter eller dashboardet for sluttstatus.
GET/doc-sent/header/list
Minimalt eksempel
Upload → check → confirm → send
Erstatt eksempelverdiene med din identifikator og ID-ene fra forrige kall.
pdf2peppol.sh
curl -X POST "https://api.peppox.com/pdf2peppol/add/" \
-F "supplier_id=YOUR_SUPPLIER_ID" \
-F "pdf=@invoice.pdf" \
-F "network=integration"
# Save queue_guid, then check it
curl "https://api.peppox.com/pdf2peppol/check/?supplier_id=YOUR_SUPPLIER_ID&queue_guid=QUEUE_GUID"
curl -X POST "https://api.peppox.com/pdf2peppol/confirm/" \
-H "Content-Type: application/json" \
-d '{"supplier_id":"YOUR_SUPPLIER_ID","queue_guid":"QUEUE_GUID","confirmed":1}'
curl -X POST "https://api.peppox.com/pdf2peppol/send/" \
-H "Content-Type: application/json" \
-d '{"supplier_id":"YOUR_SUPPLIER_ID","queue_guid":"QUEUE_GUID"}'04 · API for strukturert faktura
Bygg en Peppol-klar faktura fra dine data
Ideelt når ERP-systemet allerede lagrer alle felt og linjer strukturert.
- 01
Opprett hodet
Send kunde, datoer, valuta, betaling og levering; lagre invoice_guid.
POST/invoice/add - 02
Legg til linjene
Gjenta kallet for hvert produkt eller hver tjeneste.
POST/invoice_line/add - 03
Legg ved PDF (valgfritt)
Legg til den lesbare fakturaen som fil, Base64 eller URL.
POST/invoice_attach_pdf/add - 04
Generer UBL XML
Peppox kombinerer hode, linjer og vedlegg; suksess gir XML_BUILT.
POST/xml/generate - 05
Følg og administrer
Se dokument og status i dashboardet eller via API-er for sendte dokumenter.
GET/doc-sent/header/list
API NOTE
Viktig: Den publiserte referansen for strukturerte fakturaer dokumenterer XML-generering, men for tiden ikke et separat endelig /send-endepunkt. Bruk PDF2Peppol for et eksplisitt sendekall, eller fullfør via konfigurert Peppox-flyt eller dashboard.
05 · Endepunktoversikt
Alle endepunkter enkelt forklart
01Fakturaer
POST/invoice/addOpprett fakturahode og motta invoice_guid.
POST/invoice_line/addLegg til en linje i fakturaen.
POST/invoice_attach_pdf/addLegg ved eller erstatt faktura-PDF.
02UBL-generering
POST/xml/generateGenerer Peppol-kompatibel UBL XML.
03Kreditnotaer
POST/creditnote/addOpprett kreditnotahode.
POST/creditnote_line/addLegg til en linje i kreditnotaen.
POST/creditnote_attach_pdf/addLegg ved eller erstatt dens PDF.
04Sendte dokumenter
GET/doc-sent/header/listList sendte hoder med filtre og sider.
GET/doc-sent/lines/listHent linjene i et sendt dokument.
05Mottatte dokumenter
GET/doc-received/header/listList mottatte hoder med filtre og sider.
GET/doc-received/lines/listHent linjene i et mottatt dokument.
06PDF2Peppol
POST/pdf2peppol/addLast opp PDF og start uttrekk.
GET/pdf2peppol/checkKontroller status og uttrukne felt.
POST/pdf2peppol/confirmBekreft kontrollerte data.
POST/pdf2peppol/sendSend bekreftet dokument via Peppol.
06 · Testing uten kode
Forstå hver forespørsel i dashboardet før du programmerer
Veiledede skjemaer i Peppox-dashboardet kaller API-ene for deg. Test ekte dokumenter, finn obligatoriske parametere og forstå JSON-svaret før ERP-et kobles til.
- 01Velg endepunkt og fyll ut feltene
- 02Kjør uten å skrive en testklient
- 03Se GUID-er, JSON og feil
- 04Valider flyten i integrasjonsmiljøet
- 05Gjenbruk fungerende kall i backend
- 06Overvåk sendte og mottatte dokumenter
Lagre disse identifikatorene
Integrasjonsstatusen er enkel
invoice_guidKobler hode, linjer, PDF og generert XML.
queue_guidKobler de fire PDF2Peppol-kallene under uttrekk.
dokument-GUIDKobler sluttdokumentet til levering og avstemming.
Hvis en forespørsel feiler
400Kontroller manglende eller ugyldige felt.401Kontroller API-nøkkel og miljø.404Kontroller GUID fra forrige kall.429Senk hastigheten og prøv igjen med økende ventetid.500Logg forespørselen, prøv trygt igjen og kontakt Peppox hvis feilen fortsetter.