Jeg har strukturerede fakturadata
Opret hovedet, tilføj hver linje, vedhæft eventuelt PDF’en og generer Peppol UBL-dokumentet.
Se dette flow →
Peppox Developer Platform
Send din første faktura via Peppol, trin for trin.
Vælg den rute, der passer til dit system – fra første API-kald til leveringssporing.
PEPPOX / INTEGRATION FLOW
- 01Dashboard
- 02API-nøgle
- 03Faktura
- 04Valider
- 05Peppol
READY TO BUILD
01 · Før det første kald
Fire ting, der klargøres én gang
Klargør først konto og leverandørprofil. Derefter genbruger din applikation de samme oplysninger til hvert dokument.
- 01
Opret din Peppox-konto
Registrer den juridiske virksomhed, der sender dokumenter.
- 02
Udfyld leverandørprofilen
Virksomheds-, moms-, bank- og Peppol-routingdata hentes fra kontoen.
- 03
Åbn integrationsmiljøet
Test sikkert med dashboardværktøjerne før produktion.
- 04
Kopiér API-nøglen
Opbevar den kun på serveren, aldrig i browser- eller appkode.
02 · Vælg den korteste rute
Start med de data, du allerede har
Jeg producerer allerede en PDF
Upload PDF’en, lad Peppox udtrække data, kontrollér, bekræft og send via Peppol.
Se dette flow →03 · PDF2Peppol
En komplet afsendelse i fire API-kald
Den mest direkte dokumenterede rute, når systemet allerede producerer PDF-fakturaer.
- 01
Upload PDF’en
Send fil, Base64 eller URL, og gem queue_guid.
POST/pdf2peppol/add - 02
Kontrollér udtrukne data
Forespørg til behandlingen er færdig, og kontrollér køber, totaler, moms og linjer.
GET/pdf2peppol/check - 03
Bekræft dokumentet
Bekræft først, når alle udtrukne data er korrekte.
POST/pdf2peppol/confirm - 04
Send til Peppol
Send det bekræftede dokument, og gem dokumentets GUID.
POST/pdf2peppol/send - 05
Følg leveringen
Brug listen over sendte dokumenter eller dashboardet til slutstatus.
GET/doc-sent/header/list
Minimalt eksempel
Upload → check → confirm → send
Erstat eksempelværdierne med dit id og identifikatorerne fra det foregående kald.
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 til strukturerede fakturaer
Byg en Peppol-klar faktura fra dine data
Ideel når ERP’et allerede gemmer hvert felt og hver linje struktureret.
- 01
Opret hovedet
Send kunde, datoer, valuta, betaling og levering; gem invoice_guid.
POST/invoice/add - 02
Tilføj linjerne
Gentag kaldet for hvert produkt eller hver tjeneste.
POST/invoice_line/add - 03
Vedhæft PDF (valgfrit)
Tilføj den læsbare faktura som fil, Base64 eller URL.
POST/invoice_attach_pdf/add - 04
Generer UBL XML
Peppox samler hoved, linjer og bilag; succes returnerer XML_BUILT.
POST/xml/generate - 05
Følg og administrer
Se dokument og status i dashboardet eller via sendte-dokument-API’er.
GET/doc-sent/header/list
API NOTE
Vigtigt: Den publicerede reference for strukturerede fakturaer dokumenterer XML-generering, men aktuelt ikke et separat endeligt /send-endpoint. Brug PDF2Peppol til et eksplicit sendekald, eller afslut via det konfigurerede Peppox-flow eller dashboard.
05 · Endpoint-oversigt
Alle endpoints forklaret enkelt
01Fakturaer
POST/invoice/addOpret fakturahoved og modtag invoice_guid.
POST/invoice_line/addTilføj en linje til en faktura.
POST/invoice_attach_pdf/addVedhæft eller erstat fakturaens PDF.
02UBL-generering
POST/xml/generateGenerer Peppol-kompatibel UBL XML.
03Kreditnotaer
POST/creditnote/addOpret kreditnotahoved.
POST/creditnote_line/addTilføj en linje til kreditnotaen.
POST/creditnote_attach_pdf/addVedhæft eller erstat dens PDF.
04Sendte dokumenter
GET/doc-sent/header/listVis sendte hoveder med filtre og sider.
GET/doc-sent/lines/listHent linjerne i et sendt dokument.
05Modtagne dokumenter
GET/doc-received/header/listVis modtagne hoveder med filtre og sider.
GET/doc-received/lines/listHent linjerne i et modtaget dokument.
06PDF2Peppol
POST/pdf2peppol/addUpload PDF og start udtrækning.
GET/pdf2peppol/checkKontrollér status og udtrukne felter.
POST/pdf2peppol/confirmBekræft kontrollerede data.
POST/pdf2peppol/sendSend bekræftet dokument via Peppol.
06 · Test uden kode
Forstå hver anmodning i dashboardet, før du koder
Guidede formularer i Peppox-dashboardet kalder API’erne for dig. Test rigtige dokumenter, se påkrævede parametre og forstå JSON-svaret, før ERP’et tilsluttes.
- 01Vælg endpoint og udfyld felter
- 02Kør uden at skrive en testklient
- 03Se GUID’er, JSON og fejl
- 04Valider flowet i integrationsmiljøet
- 05Genbrug det fungerende kald i backend
- 06Overvåg sendte og modtagne dokumenter
Gem disse identifikatorer
Integrationens tilstand er enkel
invoice_guidForbinder hoved, linjer, PDF og genereret XML.
queue_guidForbinder de fire PDF2Peppol-kald under udtrækning.
dokument-GUIDForbinder slutdokumentet med levering og afstemning.
Hvis et kald fejler
400Kontrollér manglende eller ugyldige felter.401Kontrollér API-nøgle og miljø.404Kontrollér GUID fra forrige kald.429Sænk hastigheden og prøv igen med stigende ventetid.500Log kaldet, prøv sikkert igen og kontakt Peppox, hvis fejlen fortsætter.