API – Documentation

Autentisering

Type

APIKEY — API-nøkkel

Sted

spørring / parameter: apikey

Reserve via spørring/kroppsparameter «apikey»

HENT https://api.peppox.com//sendsms/?apikey=YOUR_API_KEY

Fakturahåndtering

/faktura/legg til • Metoder: STOLPE

Legg til en salgsfakturahode

Oppretter en ny fakturahode med statusen UTKAST. Endepunktet registrerer all leverandør- og kundeinformasjon, utstedelsesdatoer, betalingsbetingelser og leveringsdetaljer. Leverandørdata lastes automatisk inn fra API-nøkkelregistreringen din (customer_api).

STOLPE /faktura/legg til • Vurder: 60 req/min • Godkjenning kreves

Parametere

Navn	Type	Obligatorisk	Misligholde	Beskrivelse
`apikey`	streng	Ja		Din Peppox API-nøkkel (fra din registrerte leverandørkonto).
`nettverk`	streng	Ingen		Valgfri nettverksidentifikator (Peppol som standard).
`inv_id`	streng	Ingen		Valgfritt internt fakturanummer.
`utstedelsesdato`	streng	Ja		Fakturautstedelsesdato (ÅÅÅÅ-MM-DD).
`forfallsdato`	streng	Ingen		Fakturaens forfallsdato (ÅÅÅÅ-MM-DD).
`fakturatypekode`	streng	Ingen	380	Peppol fakturatypekode (f.eks. 380 = Faktura, 381 = Kreditnota).
`valuta`	streng	Ingen	EUR	ISO-valutakode.
`regnskapskostnad`	streng	Ingen		Referanse til intern regnskapskode.
`kjøperreferanse`	streng	Ingen		Kjøperreferanse / PO-nummer.
`betalingsmiddelkode`	streng	Ingen	1	Betalingsmidler (Peppol-kodeliste).
`betaling.betalings-ID`	streng	Ingen		Betalingsidentifikator / referanse.
`betaling.iban`	streng	Ingen		Mottakerens IBAN.
`betalingskontonavn`	streng	Ingen		Navn på innehaver av betalingsmottakerkonto.
`betaling.bic`	streng	Ingen		Betalingsmottakers BIC/SWIFT-kode.
`betalingsvilkår_merknad`	streng	Ingen		Merknad om betalingsbetingelser.
`leveringsdato`	streng	Ingen		Leveringsdato.
`levering.lokasjonsskjema`	streng	Ingen	0088	Identifikator for leveringsstedordning.
`levering.steds-ID`	streng	Ingen		Leveringssteds-ID.
`levering.gate`	streng	Ingen		Leveringsadresse gate.
`leveringsby`	streng	Ingen		Leveringsadresse by.
`levering.post`	streng	Ingen		Postnummer for leveringsadresse.
`leveringsland`	streng	Ingen		Landskode for leveringsadresse.
`leveringsselskapsnavn`	streng	Ingen		Navn på leveringsselskap.
`kunde.endepunkt_skjema`	streng	Ingen	0208	Kundens Peppol-ordnings-ID.
`kunde.sluttpunkt_id`	streng	Ingen		Kundens Peppol-deltaker-ID.
`kundenavn`	streng	Ingen		Kundens navn.
`kunde.gate`	streng	Ingen		Kundegate.
`kunde.by`	streng	Ingen		Kundeby.
`kunde.post`	streng	Ingen		Kundens postnummer.
`kunde.land`	streng	Ingen		Kundens landskode.
`kunde.mva_id`	streng	Ingen		Kundens MVA-nummer.
`kunde.bedrifts-ID-ordning`	streng	Ingen	0208	Kundens bedrifts-ID-ordning.
`kunde.bedrifts-ID`	streng	Ingen		Kundens bedrifts-ID (nasjonalt nummer).
`kunde.telefon`	streng	Ingen		Kundekontakt telefon.
`kunde.e-post`	streng	Ingen		Kundekontakt-e-postadresse.

Be om eksempler

KRØLL

PYTON

curl -X POST "https://api.peppox.com/invoice/add/" \ -H "Autorisasjon: Bærer YOUR_API_KEY" \ -H "Innholdstype: application/json" \ -d "{ "issue_date": "2025-10-17", "due_date": "2025-11-17", "customer": { "endpoint_id": "9915:BE0123456789", "name": "ACME SPRL", "country": "BE" }, "payment": { "iban": "BE12345678901234", "bic": "GEBABEBB", "account_name": "Peppox-leverandør" } }"

Svar

Status: 200 — Faktura opprettet (utkast).

JSON

{ "ok": sann, "faktura_guide": "faktura-8c3b4a99-2025-10-17", "status": "UTKAST" }

Status: 400 — Ugyldige eller manglende felt.

Status: 401 — Ugyldig eller utløpt API-nøkkel.

Status: 500 — Intern server- eller databasefeil.

/fakturalinje/legg til • Metoder: STOLPE

Legge til en fakturalinje i en eksisterende faktura

Legger til en ny linje på en eksisterende faktura (identifisert av invoice_guid). Støtter enhets-, mengde-, pris-, mva-kategori- og produktidentifikasjonskoder.

STOLPE /fakturalinje/legg til • Vurder: 60 req/min • Godkjenning kreves

Parametere

Navn	Type	Obligatorisk	Misligholde	Beskrivelse
`apikey`	streng	Ja		Din Peppox API-nøkkel (påkrevd for autentisering).
`faktura_guide`	streng	Ja		Den unike faktura-GUID-en som ble returnert fra /invoice/add.
`linje_id`	streng	Ingen		Valgfri intern linjeidentifikator (standard er generert GUID).
`mengde`	tall	Ja		Mengde av varen eller tjenesten.
`enhetskode`	streng	Ingen		Enhetskode i henhold til UNECE Rec 20 (f.eks. H87 for «stykke»).
`prisbeløp`	tall	Ja		Enhetspris (ekskl. mva.).
`varebeskrivelse`	streng	Ingen		Beskrivelse av varen eller tjenesten.
`varenavn`	streng	Ingen		Varenavn eller tittel.
`selger_vare_id`	streng	Ingen		Selgers interne vare-ID eller SKU.
`std_item_id_scheme`	streng	Ingen	0088	Standard skjema-ID for vareidentifikasjon (f.eks. GTIN).
`std_item_id`	streng	Ingen		Standardisert vare-ID (GTIN, EAN osv.).
`opprinnelsesland`	streng	Ingen		Opprinnelsesland (ISO 3166-1 alpha-2).
`skattekategori`	streng	Ingen		Mva-kategorikode (f.eks. S, Z, AE).
`skatteprosent`	tall	Ingen		MVA-sats i prosent (f.eks. 21,00).

Be om eksempler

KRØLL

PYTON

curl -X POST "https://api.peppox.com/invoice_line/add/" \ -H "Autorisering: Bærer YOUR_API_KEY" \ -H "Innholdstype: application/json" \ -d "{ "invoice_guid": "inv-8c3b4a99-2025-10-17", "antall": 2, "enhetskode": "H87", "prisbeløp": 49,99, "varenavn": "Konsulenttjeneste", "avgiftsprosent": 21 }"

Svar

Status: 200 — Fakturalinje lagt til.

JSON

{ "ok": sant, "line_guid": "line-2b4fa3c1-2025-10-17" }

Status: 400 — Ugyldige parametere (mangler invoice_guid eller ugyldige numeriske felt).

Status: 401 — Ugyldig eller utløpt API-nøkkel.

Status: 500 — Intern database- eller serverfeil.

/faktura_vedlegg_pdf/legg til • Metoder: STOLPE

Legg ved en PDF-fil til en eksisterende faktura

Legger ved et PDF-dokument (via opplasting, Base64 eller ekstern URL) til en eksisterende faktura identifisert av invoice_guid. Bare ett vedlegg per faktura lagres; eventuelle tidligere filer erstattes.

STOLPE /faktura_vedlegg_pdf/legg til • Vurder: 30 req/min • Godkjenning kreves

Parametere

Navn	Type	Obligatorisk	Misligholde	Beskrivelse
`apikey`	streng	Ja		Din Peppox API-nøkkel (autentisering).
`faktura_guide`	streng	Ja		GUID-en til fakturaen som PDF-filen skal legges ved.
`dok_id`	streng	Ingen		Valgfri dokumentidentifikator (standard er faktura-ID eller en generert UUID).
`filnavn`	streng	Ingen	vedlegg.pdf	Vedleggets filnavn (f.eks. faktura.pdf).
`mime`	streng	Ingen	søknad/pdf	MIME-typen til filen.
`innholdsbase64`	streng	Ingen		PDF-innhold som Base64-streng. Godtar data-URI-format.
`fil_url`	streng	Ingen		Ekstern HTTPS-URL til en PDF som skal lastes ned og legges ved.
`fil`	fil	Ingen		Filopplastingsfelt (flerdelt/skjemadata).

Be om eksempler

KRØLL

curl -X POST "https://api.peppox.com/invoice_attach_pdf/add/" \ -H "Autorisering: Bærer YOUR_API_KEY" \ -F "invoice_guid=inv-8c3b4a99-2025-10-17" \ -F "file=@invoice.pdf"

curl -X POST "https://api.peppox.com/invoice_attach_pdf/add/" \ -H "Autorisering: Bærer YOUR_API_KEY" \ -H "Innholdstype: application/json" \ -d "{ "invoice_guid": "inv-8c3b4a99-2025-10-17", "filnavn": "invoice.pdf", "content_base64": "JVBERi0xLjQKJeLjz9MKMyAwIG9iago8PC9UeXBlIC9QYWdl..." }"

curl -X POST "https://api.peppox.com/invoice_attach_pdf/add/" \ -H "Autorisering: Bærer YOUR_API_KEY" \ -H "Innholdstype: application/json" \ -d "{ "invoice_guid": "inv-8c3b4a99-2025-10-17", "file_url": "https://example.com/invoice-2025.pdf" }"

Svar

Status: 200 — PDF-filen er lagt ved fakturaen.

JSON

{ "ok": true, "invoice_guid": "inv-8c3b4a99-2025-10-17", "doc_id": "DOC-1452", "filnavn": "invoice-2025-10.pdf", "mime": "applikasjon/pdf", "size_bytes": 184527 }

Status: 400 — Ugyldige parametere eller manglende innhold (ingen Base64, fil eller URL).

Status: 401 — Ugyldig eller utløpt API-nøkkel.

Status: 404 — Fakturaen ble ikke funnet.

Status: 500 — Intern server- eller databasefeil.

XML-generering

/xml/generer • Metoder: STOLPE

Generer en UBL XML-fil for en faktura eller kreditnota

Kombinerer faktura-/kreditnotahode, linjer og vedlagt PDF (hvis noen) til et Peppol-kompatibelt UBL 3.0 XML-dokument. Returnerer den lokale banen til den genererte filen og oppdaterer faktura-/kreditnotastatusen til XML_BUILT.

STOLPE /xml/generer • Vurder: 30 req/min • Godkjenning kreves

Parametere

Navn	Type	Obligatorisk	Beskrivelse
`apikey`	streng	Ja	Din Peppox API-nøkkel for autentisering.
`faktura_guide`	streng	Ja	Den unike identifikatoren til fakturaen som skal konverteres til XML.
`veileder`	streng	Ingen	Alternativ nøkkel for invoice_guid.

Be om eksempler

KRØLL

PYTON

curl -X POST "https://api.peppox.com/xml/generate/" \ -H "Autorisering: Bærer YOUR_API_KEY" \ -H "Innholdstype: application/json" \ -d "{ "invoice_guid": "inv-8c3b4a99-2025-10-17" }"

Svar

Status: 200 — XML er generert og lagret på serveren.

JSON

{ "ok": sann, "status": "XML_BUILT", "xml_path": "/var/www/vhosts/peppox.com/httpdocs/invoices_xml/inv-8c3b4a99-2025-10-17.xml" }

Status: 400 — Manglende invoice_guid eller fakturalinjer.

Status: 401 — Ugyldig eller utløpt API-nøkkel.

Status: 404 — Fakturaen ble ikke funnet.

Status: 500 — Intern XML-genererings- eller skrivefeil.

Kreditnotater

/kreditnota/legg til • Metoder: STOLPE

Legg til en kreditnotaoverskrift

Oppretter en ny kreditnotaoverskrift med statusen UTKAST. Leverandørdata lastes automatisk inn fra API-nøkkelkontoen, mens felt for kunde, betaling og levering godtas fra forespørselen.

STOLPE /kreditnota/legg til • Vurder: 60 req/min • Godkjenning kreves

Parametere

Navn	Type	Obligatorisk	Misligholde	Beskrivelse
`apikey`	streng	Ja		Din Peppox API-nøkkel.
`nettverk`	streng	Ingen		Valgfri nettverksidentifikator.
`kreditnota_id`	streng	Ingen		Foretrukket kreditnotanummer/identifikator.
`cn_id`	streng	Ingen		Alternativt alias for kreditnota-ID.
`kreditnota-ID`	streng	Ingen		Alternativt alias for kreditnota-ID.
`inv_id`	streng	Ingen		Alternativ eldre identifikator.
`utstedelsesdato`	streng	Ja		Utstedelsesdato for kreditnota (ÅÅÅÅ-MM-DD).
`forfallsdato`	streng	Ingen		Forfallsdato (ÅÅÅÅ-MM-DD).
`fakturatypekode`	streng	Ingen	381	Dokumenttypekode. Standard 381 = Kreditnota.
`valuta`	streng	Ingen	EUR	ISO-valutakode.
`regnskapskostnad`	streng	Ingen		Intern regnskapsreferanse.
`kjøperreferanse`	streng	Ingen		Kjøperreferanse / kundes innkjøpsordrereferanse.
`betalingsmiddelkode`	streng	Ingen	1	Betaling betyr kode.
`betaling.betalings-ID`	streng	Ingen		Betalingsreferanse.
`betaling.iban`	streng	Ingen		Mottakerens IBAN.
`betalingskontonavn`	streng	Ingen		Navn på betalingsmottakerkonto.
`betaling.bic`	streng	Ingen		Betalingsmottaker BIC / SWIFT.
`betalingsvilkår_merknad`	streng	Ingen		Merknad om betalingsbetingelser.
`leveringsdato`	streng	Ingen		Leveringsdato.
`levering.lokasjonsskjema`	streng	Ingen	0088	Ordning med leveringssted.
`levering.steds-ID`	streng	Ingen		Identifikator for leveringssted.
`levering.gate`	streng	Ingen		Leveringsgate.
`leveringsby`	streng	Ingen		Leveringsby.
`levering.post`	streng	Ingen		Leveringspostnummer.
`leveringsland`	streng	Ingen		Leveringslandskode.
`leveringsselskapsnavn`	streng	Ingen		Navn på leveringsselskap.
`leverandør.endepunktsordning`	streng	Ingen	0208	Leverandørens endepunktskjema. Leverandørverdier lastes ellers inn fra API-kontoen.
`kunde.endepunkt_skjema`	streng	Ingen	0208	Kundens endepunktskjema.
`kunde.sluttpunkt_id`	streng	Ingen		Kundens endepunkt-ID.
`kundenavn`	streng	Ingen		Kundens juridiske navn.
`kunde.gate`	streng	Ingen		Kundegate.
`kunde.by`	streng	Ingen		Kundeby.
`kunde.post`	streng	Ingen		Kundens postnummer.
`kunde.land`	streng	Ingen		Kundens landskode.
`kunde.mva_id`	streng	Ingen		Kundens MVA-nummer.
`kunde.bedrifts-ID-ordning`	streng	Ingen	0208	Kundens bedrifts-ID-ordning.
`kunde.bedrifts-ID`	streng	Ingen		Kundens firma-ID.
`kunde.telefon`	streng	Ingen		Kundetelefon.
`kunde.e-post`	streng	Ingen		Kundens e-post.

Be om eksempler

KRØLL

PYTON

curl -X POST "https://api.peppox.com/creditnote/add/" -H "Autorisering: Bærer YOUR_API_KEY" -H "Innholdstype: application/json" -d "{ "creditnote_id": "CN-2025-001", "issue_date": "2025-10-17", "currency": "EUR", "customer": { "endpoint_id": "9915:BE0123456789", "name": "ACME SPRL", "country": "BE" } }"

Svar

Status: 200 — Kreditnotaen er opprettet.

JSON

{ "ok": true, "invoice_guid": "cn-8c3b4a99-2025-10-17", "document_type": "KREDITNOTATE", "status": "UTKAST" }

Status: 400 — Ugyldige eller manglende felt.

Status: 401 — Ugyldig eller utløpt API-nøkkel.

Status: 500 — Intern server- eller databasefeil.

/kreditnota_linje/legg til • Metoder: STOLPE

Legg til en kreditnotalinje

Legger til en linje i en eksisterende kreditnota. Godtar automatisk alias for creditnote_guid og beregner tax_category fra tax_percent når det er mulig.

STOLPE /kreditnota_linje/legg til • Vurder: 60 req/min • Godkjenning kreves

Parametere

Navn	Type	Obligatorisk	Misligholde	Beskrivelse
`apikey`	streng	Ja		Din Peppox API-nøkkel.
`kreditnota_guide`	streng	Ja		GUID for målkreditnotaen.
`faktura_guide`	streng	Ingen		Alias for creditnote_guid.
`veileder`	streng	Ingen		Alias for creditnote_guid.
`linje_id`	streng	Ingen		Valgfri intern linjeidentifikator.
`ordrelinje-ID`	streng	Ingen		Alias for linje_id.
`mengde`	tall	Ja		Linjemengde.
`antall`	tall	Ingen		Alias for mengde.
`q`	tall	Ingen		Alias for mengde.
`enhetskode`	streng	Ingen		Enhetskode.
`enhet`	streng	Ingen		Alias for enhetskode.
`du`	streng	Ingen		Alias for enhetskode.
`prisbeløp`	tall	Ja		Enhetsprisbeløp.
`pris`	tall	Ingen		Alias for price_amount.
`enhetspris`	tall	Ingen		Alias for price_amount.
`varebeskrivelse`	streng	Ingen		Linjebeskrivelse.
`beskrivelse`	streng	Ingen		Alias for varebeskrivelse.
`beskrivelse`	streng	Ingen		Alias for varebeskrivelse.
`varenavn`	streng	Ingen		Varenavn/tittel.
`navn`	streng	Ingen		Alias for varenavn.
`tittel`	streng	Ingen		Alias for varenavn.
`selger_vare_id`	streng	Ingen		Selgers vare-ID / SKU.
`selger_ID`	streng	Ingen		Alias for selger_vare_id.
`sku`	streng	Ingen		Alias for selger_vare_id.
`std_item_id_scheme`	streng	Ingen	0088	Standard skjema for gjenstandsidentifikasjon.
`std_scheme`	streng	Ingen		Alias for std_item_id_scheme.
`ordning`	streng	Ingen		Alias for std_item_id_scheme.
`std_item_id`	streng	Ingen		Standard vare-ID (EAN, GTIN osv.).
`gtin`	streng	Ingen		Alias for std_item_id.
`ean`	streng	Ingen		Alias for std_item_id.
`opprinnelsesland`	streng	Ingen		Opprinnelsesland.
`land`	streng	Ingen		Alias for opprinnelsesland.
`skattekategori`	streng	Ingen		Mva-kategorikode. Automatisk tvunget til S eller Z avhengig av avgiftsprosent.
`skattekatt`	streng	Ingen		Alias for skattekategori.
`momskategori`	streng	Ingen		Alias for skattekategori.
`skatteprosent`	tall	Ingen		MVA-prosent.
`momssats`	tall	Ingen		Alias for skatteprosent.
`avgift`	tall	Ingen		Alias for skatteprosent.
`moms`	tall	Ingen		Alias for skatteprosent.

Be om eksempler

KRØLL

PYTON

curl -X POST "https://api.peppox.com/creditnote_line/add/" -H "Autorisering: Bærer YOUR_API_KEY" -H "Innholdstype: application/json" -d "{ "creditnote_guid": "cn-8c3b4a99-2025-10-17", "antall": 2, "enhetskode": "H87", "prisbeløp": 49,99, "varenavn": "Returnert konsulenttjeneste", "avgiftsprosent": 21 }"

Svar

Status: 200 — Kreditnotalinje er lagt til.

JSON

{ "ok": sant, "line_guid": "line-2b4fa3c1-2025-10-17" }

Status: 400 — Mangler obligatoriske verdier som creditnote_guid, quantity eller price_amount.

Status: 401 — Ugyldig eller utløpt API-nøkkel.

Status: 500 — Intern databasefeil.

/kreditnota_vedlegg_pdf/legg til • Metoder: STOLPE

Legg ved en PDF-fil til en kreditnota

Legger ved et PDF-dokument til en eksisterende kreditnota ved hjelp av flerdelt opplasting, Base64-nyttelast eller ekstern URL. Forrige vedlegg erstattes.

STOLPE /kreditnota_vedlegg_pdf/legg til • Vurder: 30 req/min • Godkjenning kreves

Parametere

Navn	Type	Obligatorisk	Misligholde	Beskrivelse
`apikey`	streng	Ja		Din Peppox API-nøkkel.
`kreditnota_guide`	streng	Ja		Kreditnota-GUID-en som PDF-filen skal legges ved.
`faktura_guide`	streng	Ingen		Alias for creditnote_guid.
`veileder`	streng	Ingen		Alias for creditnote_guid.
`dok_id`	streng	Ingen		Valgfri dokumentidentifikator. Standardinnstillingen er inv_id eller en generert UUID.
`filnavn`	streng	Ingen	vedlegg.pdf	Vedleggets filnavn.
`mime`	streng	Ingen	søknad/pdf	Vedlegg MIME-type.
`innholdsbase64`	streng	Ingen		PDF-innhold kodet som Base64.
`pdf_base64`	streng	Ingen		Alias for content_base64.
`fil_url`	streng	Ingen		HTTP/HTTPS-URL-en til PDF-filen som skal lastes ned og legges ved.
`pdf_url`	streng	Ingen		Alias for file_url.
`fil`	fil	Ingen		Flerdelt opplastet fil.

Be om eksempler

KRØLL

curl -X POST "https://api.peppox.com/creditnote_attach_pdf/add/" -H "Autorisering: Bærer YOUR_API_KEY" -F "creditnote_guid=cn-8c3b4a99-2025-10-17" -F "fil=@creditnote.pdf"

curl -X POST "https://api.peppox.com/creditnote_attach_pdf/add/" -H "Autorisering: Bærer YOUR_API_KEY" -H "Innholdstype: application/json" -d "{ "creditnote_guid": "cn-8c3b4a99-2025-10-17", "filnavn": "creditnote.pdf", "content_base64": "JVBERi0xLjQKJeLjz9MKMyAwIG9iago8PC9UeXBlIC9QYWdl..." }"

curl -X POST "https://api.peppox.com/creditnote_attach_pdf/add/" -H "Autorisering: Bærer YOUR_API_KEY" -H "Innholdstype: application/json" -d "{ "creditnote_guid": "cn-8c3b4a99-2025-10-17", "file_url": "https://example.com/creditnote-2025.pdf" }"

Svar

Status: 200 — PDF-filen er lagt ved kreditnotaen.

JSON

{ "ok": true, "creditnote_guid": "cn-8c3b4a99-2025-10-17", "doc_id": "CN-2025-001", "filnavn": "creditnote.pdf", "mime": "applikasjon/pdf", "size_bytes": 184527 }

Status: 400 — Ugyldig forespørsel: manglende creditnote_guid, ugyldig Base64, ugyldig URL eller intet innhold oppgitt.

Status: 401 — Ugyldig eller utløpt API-nøkkel.

Status: 404 — Kreditnota ikke funnet.

Status: 500 — Intern database- eller filhåndteringsfeil.

Sendte dokumenter

/dokument-sendt/overskrift/liste • Metoder: BLI

Liste over sendte fakturaoverskrifter

Viser en liste over sendte salgsfakturaoverskrifter for en leverandør. Støtter nøkkelordsøk, datofiltre, Peppol-statusfiltre, lokale statusfiltre, inkludering av råsvar, sortering og paginering.

BLI /dokument-sendt/overskrift/liste • Vurder: 300 req/min

Parametere

Navn	Type	Obligatorisk	Misligholde	Beskrivelse
`leverandør_id`	streng	Ja		Nødvendig leverandør-ID. Denne verdien er tilordnet invoices.apikey.
`q`	streng	Ingen		Søk etter nøkkelord på tvers av fakturahodefelt.
`side`	heltall	Ingen	1	Sidetall.
`per_side`	heltall	Ingen	300	Rader per side. Maksimum: 300.
`dato`	streng	Ingen		Filter for nøyaktig dato i formatet ÅÅÅÅ-MM-DD.
`dato_fra`	streng	Ingen		Startdato for periodefilter i formatet ÅÅÅÅ-MM-DD.
`dato_til`	streng	Ingen		Sluttdato for periodefilter i formatet ÅÅÅÅ-MM-DD.
`datofelt`	streng	Ingen	sendt_på	Datofelt brukt for dato/dato_fra/dato_til. Tillatt: issue_date, due_date, delivery_date, xml_built_at, sent_at, created_at, updated_at, status_from_peppol_date.
`status_fra_peppol`	streng	Ingen		Filtrer etter Peppol-status. Støtter CSV-verdier.
`peppol_status`	streng	Ingen		Alias for status_from_peppol.
`status`	streng	Ingen		Alias for status_from_peppol.
`lokal_status`	streng	Ingen		Filtrer etter lokal fakturastatus fra invoices.status. Støtter CSV-verdier.
`include_raw`	boolsk	Ingen	0	Sett til 1 for å inkludere sent_reply_api og all_response_api i svaret.
`search_raw`	boolsk	Ingen	0	Sett til 1 for å inkludere sent_reply_api og all_response_api i nøkkelordsøk.
`sorter_etter`	streng	Ingen	sendt_på	Sorteringskolonne. Tillatt: id, invoice_guid, inv_id, issue_date, due_date, xml_built_at, sent_at, status, created_at, updated_at, status_from_peppol, status_from_peppol_date, c_name, s_name, currency, network.
`sorteringsmappe`	streng	Ingen	BESKRIVELSE	Sorteringsretning: ASC eller DESC.

Be om eksempler

KRØLL

PYTON

krøll "https://api.peppox.com/doc-sent/header/list/?supplier_id=DIN_LEVERANDØR_ID"

curl "https://api.peppox.com/doc-sent/header/list/?supplier_id=DIN_LEVERANDØR_ID&date_from=2025-10-01&date_to=2025-10-31&date_field=sent_at&status_from_peppol=sent&page=1&per_page=100"

krøll "https://api.peppox.com/doc-sent/header/list/?supplier_id=DIN_LEVERANDØR_ID&q=INV-2025&include_raw=1&search_raw=1"

import requests url = "https://api.peppox.com/doc-sent/header/list/" params = { "supplier_id": "DIN_LEVERANDØR_ID", "date_from": "2025-10-01", "date_to": "2025-10-31", "date_field": "sendt_at", "status_from_peppol": "sendt", "side": 1, "per_side": 100 } r = requests.get(url, params=params) print(r.json())

Svar

Status: 200 — Suksess – returnerer fakturaoverskrifter med filtre, sorteringsinformasjon, paginering og datarader.

JSON

{ "ok": true, "endpoint": "doc-sent/header/list", "method": "GET", "filters": { "supplier_id": "DIN_LEVERANDØR_ID", "q": "", "date": "", "date_from": "2025-10-01", "date_to": "2025-10-31", "date_field": "sendt_at", "status_from_peppol": "sendt", "local_status": "", "include_raw": "0", "search_raw": "0" }, "sort": { "sort_by": "sendt_at", "sort_dir": "DESC" }, "pagination": { "page": 1, "per_page": 300, "total": 1, "total_pages": 1, "has_prev": false, "has_next": false }, "count": 1, "data": [ { "id": 125, "invoice_guid": "inv-8c3b4a99-2025-10-17", "inv_id": "INV-2025-001", "issue_date": "2025-10-17", "due_date": "2025-11-17", "invoice_type_code": "380", "currency": "EUR", "buyer_reference": "PO-12345", "s_name": "Leverandørselskap", "s_endpoint_id": "0208:0123456789", "c_name": "Kundeselskap", "c_endpoint_id": "0208:0987654321", "status": "SENDT", "sent_at": "2025-10-17 14:30:00", "sent_http_code": 200, "network": "peppol", "status_from_peppol": "sendt", "status_from_peppol_date": "2025-10-17 14:31:00", "status_from_peppol_error": null, "flowin_invoice_id_from_sent_reply_api": "flowin-doc-id-123", "flowin_document_endpoint_used": "/peppol/leverandører/.../fakturaer" } ] }

Status: 400 — Mangler obligatorisk leverandør-ID.

Status: 500 — Serverfeil.

/doc-sendt/linjer/liste • Metoder: BLI

Liste over sendte fakturalinjer

Viser linjene i en sendt faktura ved hjelp av supplier_id og invoice_guid. supplier_id må samsvare med invoices.apikey av sikkerhetshensyn.

BLI /doc-sendt/linjer/liste • Vurder: 300 req/min

Parametere

Navn	I	Type	Obligatorisk	Misligholde	Beskrivelse
`leverandør_id`	spørsmål	streng	Ja		Nødvendig leverandør-ID. Denne verdien må samsvare med invoices.apikey.
`faktura_guide`	spørsmål	streng	Ja		Faktura-GUID brukes til å liste opp fakturalinjer.
`q`	spørsmål	streng	Ingen		Valgfritt nøkkelordsøk på tvers av fakturalinjefelt.
`side`	spørsmål	heltall	Ingen	1	Sidetall.
`per_side`	spørsmål	heltall	Ingen	300	Rader per side. Maksimum: 300.

Be om eksempler

KRØLL

PYTON

krøll "https://api.peppox.com/doc-sent/lines/list/?supplier_id=DIN_LEVERANDØR_ID&invoice_guid=inv-8c3b4a99-2025-10-17"

krøll "https://api.peppox.com/doc-sent/lines/list/?supplier_id=DIN_LEVERANDØR_ID&invoice_guid=inv-8c3b4a99-2025-10-17&q=consulting&page=1&per_page=100"

importforespørsler url = "https://api.peppox.com/doc-sent/lines/list/" params = { "leverandør_id": "DIN_LEVERANDØR_ID", "faktura_guide": "inv-8c3b4a99-2025-10-17", "q": "konsulentvirksomhet", "side": 1, "per_side": 100 } r = requests.get(url, params=params) print(r.json())

Svar

Status: 200 — Suksess – returnerer fakturametadata, filtre, paginering og fakturalinjer.

JSON

{ "ok": true, "endpoint": "doc-send/lines/list", "invoice": { "invoice_guid": "inv-8c3b4a99-2025-10-17", "inv_id": "INV-2025-001", "status": "SENDT", "sendt_på": "2025-10-17 14:30:00" }, "filters": { "supplier_id": "DIN_LEVERANDØR_ID", "invoice_guid": "inv-8c3b4a99-2025-10-17", "q": "konsulentvirksomhet" }, "pagination": { "page": 1, "per_page": 300, "total": 1, "total_pages": 1, "has_prev": false, "has_next": false }, "count": 1, "data": [ { "id": 1, "invoice_guid": "inv-8c3b4a99-2025-10-17", "line_guid": "line-001", "line_id": "1", "quantity": "2.00", "unit_code": "H87", "price_amount": "49.99", "item_description": "Konsulenttjeneste", "item_name": "Konsulenttjeneste", "seller_item_id": "SKU-001", "std_item_id_scheme": "0088", "std_item_id": null, "origin_country": "BE", "tax_category": "S", "tax_percent": "21.00", "created_at": "2025-10-17 14:00:00", "updated_at": null } ] }

Status: 400 — Mangler obligatorisk supplier_id eller invoice_guid.

Status: 404 — Fakturaen ble ikke funnet eller er ikke tillatt for denne leverandør-ID-en.

Status: 500 — Serverfeil.

Mottatte dokumenter

/doc-mottatt/header/liste • Metoder: BLI

Liste overskrifter for mottatte kjøpsfakturaer

Lister opp fakturaoverskrifter mottatt av en leverandør gjennom Peppol. Støtter nøkkelordsøk, datofiltre, importstatus, dokumenttypekode, råfelt, sortering og paginering.

BLI /doc-mottatt/header/liste • Vurder: 300 req/min

Parametere

Navn	Type	Obligatorisk	Misligholde	Beskrivelse
`leverandør_id`	streng	Ja		Nødvendig leverandør-ID. Denne verdien tilordnes til peppox_inbound_purchase_invoices.supplier_id.
`q`	streng	Ingen		Søk etter nøkkelord på tvers av felt for mottatte fakturahode.
`side`	heltall	Ingen	1	Sidetall.
`per_side`	heltall	Ingen	300	Rader per side. Maksimum: 300.
`dato`	streng	Ingen		Filter for nøyaktig dato i formatet ÅÅÅÅ-MM-DD.
`dato_fra`	streng	Ingen		Startdato for periodefilter i formatet ÅÅÅÅ-MM-DD.
`dato_til`	streng	Ingen		Sluttdato for periodefilter i formatet ÅÅÅÅ-MM-DD.
`datofelt`	streng	Ingen	api_opprettet_at	Datofelt brukt for dato/dato_fra/dato_til. Tillatt: api_opprettet_at, utstedelsesdato, forfallsdato, skattetidspunktdato, opprettet_at, oppdatert_at.
`importstatus`	streng	Ingen		Filtrer etter importstatus. Støtter CSV-verdier.
`status`	streng	Ingen		Alias for import_status.
`dokumenttypekode`	streng	Ingen		Filtrer etter dokumenttypekode. Støtter CSV-verdier. Eksempel: 380-faktura, 381-kreditnota.
`type_kode`	streng	Ingen		Alias for dokumenttypekode.
`include_raw`	boolsk	Ingen	0	Sett til 1 for å inkludere customization_id, profile_id, xml_without_pdf, api_attributes_json, parser_json og notification_sent_by_email_response.
`search_raw`	boolsk	Ingen	0	Sett til 1 for å søke i rå/lange felt.
`sorter_etter`	streng	Ingen	api_opprettet_at	Sorteringskolonne. Tillatt: id, kunde_id, leverandør_id, flyt_dokument_id, api_opprettet_at, dokument_type_kode, dokument_nummer, utstedelsesdato, forfallsdato, avgiftspunktdato, valuta, leverandør_navn, kundenavn, total_ekskl._mva., total_mva., total_inkl._mva., betalbar_beløp, import_status, opprettet_at, oppdatert_at.
`sorteringsmappe`	streng	Ingen	BESKRIVELSE	Sorteringsretning: ASC eller DESC.

Be om eksempler

KRØLL

PYTON

krøll "https://api.peppox.com/doc-received/header/list/?supplier_id=327c58aa-f3e1-4c56-ae75-327c58916148"

curl "https://api.peppox.com/doc-received/header/list/?supplier_id=327c58aa-4c56-ae75-327c58916148&date_from=2025-10-01&date_to=2025-10-31&date_field=api_created_at&document_type_code=380&page=1&per_page=100"

krøll "https://api.peppox.com/doc-received/header/list/?supplier_id=327c58aa-f3e1-4c56-ae75-327c58916148&q=INV-2025&include_raw=1&search_raw=1"

importforespørsler url = "https://api.peppox.com/doc-received/header/list/" params = { "leverandør_id": "327c58aa-f3e1-4c56-ae75-327c58916148", "dato_fra": "2025-10-01", "dato_til": "2025-10-31", "dokument_type_kode": "380", "side": 1, "per_side": 100 } r = forespørsler.get(url, params=params) print(r.json()) * ...

Svar

Status: 200 — Vellykket – returnerer mottatte fakturaoverskrifter for kjøp med filtre, sortering, paginering og datarader.

JSON

{ "ok": true, "endpoint": "doc-received/header/list", "method": "GET", "filters": { "supplier_id": 327c58aa-f3e1-4c56-ae75-327c58916148", "q": "", "date": "", "date_from": "2025-10-01", "date_to": "2025-10-31", "date_field": "api_created_at", "import_status": "importert", "document_type_code": "380", "include_raw": "0", "search_raw": "0" }, "sort": { "sort_by": "api_created_at", "sort_dir": "DESC" }, "pagination": { "page": 1, "per_page": 300, "total": 1, "total_pages": 1, "has_prev": false, "has_next": false }, "count": 1, "data": [ { "id": 25, "customer_id": 7, "supplier_id": 327c58aa-f3e1-4c56-ae75-327c58916148", "document_id": "flowin-doc-id-123", "environment": "production", "api_created_at": "2025-10-17 14:30:00", "document_type_label": "Faktura", "document_type_code": "380", "document_number": "INV-2025-001", "issue_date": "2025-10-17", "due_date": "2025-11-17", "tax_point_date": "2025-10-17", "currency": "EUR", "buyer_reference": "PO-12345", "order_reference": "ORD-987", "supplier_name": "Leverandørselskap", "supplier_company_id": "0123456789", "supplier_endpoint_id": "0208:0123456789", "supplier_vat_id": "BE0123456789", "supplier_street": "Leverandørgate 1", "supplier_city": "Brussel", "supplier_zip": "1000", "supplier_country": "BE", "customer_name": "Kundeselskap", "customer_company_id": "0987654321", "customer_endpoint_id": "0208:0987654321", "customer_vat_id": "BE0987654321", "customer_street": "Kundegate 2", "customer_city": "Namur", "customer_zip": "5000", "customer_country": "BE", "total_excl_vat": "100.00", "total_vat": "21.00", "total_incl_vat": "121.00", "payable_amount": "121.00", "line_extension_amount": "100.00", "tax_exclusive_amount": "100.00", "tax_inclusive_amount": "121.00", "allowance_total_amount": "0.00", "charge_total_amount": "0.00", "prepaid_amount": "0.00", "payment_means_code": "30", "payment_id": "INV-2025-001", "iban": "BE12345678901234", "bic": "GEBABEBB", "has_embedded_pdf": 1, "created_at": "2025-10-17 14:31:00" } ] }

Status: 400 — Mangler obligatorisk leverandør-ID.

Status: 500 — Serverfeil.

/doc-mottatt/linjer/liste • Metoder: BLI

Liste over mottatte fakturalinjer for kjøp

Viser linjene i en mottatt kjøpsfaktura ved hjelp av supplier_id og document_id. document_id er tilordnet peppox_inbound_purchase_invoices.flowin_document_id.

BLI /doc-mottatt/linjer/liste • Vurder: 300 req/min

Parametere

Navn	Type	Obligatorisk	Misligholde	Beskrivelse
`leverandør_id`	streng	Ja		Nødvendig leverandør-ID.
`dokument_id`	streng	Ja		Nødvendig mottatt dokument-ID. Tilordnes til flowin_document_id.
`q`	streng	Ingen		Søk etter nøkkelord på tvers av felt for mottatte fakturalinjer.
`side`	heltall	Ingen	1	Sidetall.
`per_side`	heltall	Ingen	300	Rader per side. Maksimum: 300.
`include_raw`	boolsk	Ingen	0	Sett til 1 for å inkludere raw_line_xml og parser_json.
`search_raw`	boolsk	Ingen	0	Sett til 1 for å søke i raw_line_xml og parser_json.
`sorter_etter`	streng	Ingen	linjenummer	Sorteringskolonne. Tillatt: id, invoice_header_id, customer_id, supplier_id, flowin_document_id, line_no, line_id, item_name, quantity, unit_code, unit_price, moms_rate, line_total_excl_vat, line_total_vat, line_total_incl_vat, currency, created_at.
`sorteringsmappe`	streng	Ingen	ASC	Sorteringsretning: ASC eller DESC.

Be om eksempler

KRØLL

PYTON

krøll "https://api.peppox.com/doc-received/lines/list/?supplier_id=327c58aa-f3e1-4c56-ae75-327c58916148&document_id=e1de8615-ce41-425a-ba88-0b834bf3ccf9"

krøll "https://api.peppox.com/doc-received/lines/list/?supplier_id=327c58aa-f3e1-4c56-ae75-327c58916148&document_id=e1de8615-ce41-425a-ba88-0b834bf3ccf9&q=consulting&page=1&per_page=100"

krøll "https://api.peppox.com/doc-received/lines/list/?supplier_id=327c58aa-4c56-ae75-327c58916148&document_id=e1de8615-ce41-425a-ba88-0b834bf3ccf9&include_raw=1&search_raw=1"

importforespørsler url = "https://api.peppox.com/doc-received/lines/list/" params = { "leverandør_id": "327c58aa-f3e1-4c56-ae75-327c58916148", "dokument_id": "e1de8615-ce41-425a-ba88-0b834bf3ccf9", "q": "konsulenttjenester", "side": 1, "per_side": 100 } r = requests.get(url, params=params) print(r.json()) * ...

Svar

Status: 200 — Vellykket – returnerer mottatte fakturametadata, filtre, sortering, paginering og linjerader.

JSON

{ "ok": true, "endpoint": "doc-received/lines/list", "method": "GET", "invoice": { "id": 25, "customer_id": 7, "supplier_id": 327c58aa-f3e1-4c56-ae75-327c58916148", "document_id": "e1de8615-ce41-425a-ba88-0b834bf3ccf9", "document_number": "INV-2025-001", "document_type_code": "380", "document_type_label": "Faktura", "issue_date": "2025-10-17", "due_date": "2025-11-17", "currency": "EUR", "supplier_name": "Leverandørselskap", "customer_name": "Kundeselskap", "total_excl_vat": "100.00", "total_vat": "21.00", "total_incl_vat": "121.00", "payable_amount": "121.00", "import_status": "importert", "api_created_at": "2025-10-17 14:30:00" }, "filters": { "supplier_id": 327c58aa-f3e1-4c56-ae75-327c58916148", "document_id": "e1de8615-ce41-425a-ba88-0b834bf3ccf9", "q": "", "include_raw": "0", "search_raw": "0" }, "sort": { "sort_by": "linjenummer", "sort_dir": "ASC" }, "paginering": { "side": 1, "per_side": 300, "total": 1, "total_pages": 1, "has_prev": false, "has_next": false }, "antall": 1, "data": [ { "leverandør_id": 327c58aa-f3e1-4c56-ae75-327c58916148", "dokument_id": "e1de8615-ce41-425a-ba88-0b834bf3ccf9", "linje_id": "1", "beskrivelse": "Konsulenttjeneste", "varenavn": "Konsulenttjeneste", "vareselger_id": "SKU-001", "varekjøper_id": null, "antall": "2.00", "enhetskode": "H87", "enhetspris": "50.00", "base_quantity": "1,00", "vat_category_id": "S", "vat_rate": "21,00", "vat_scheme": "MVA", "line_total_excl_vat": "100,00", "line_total_vat": "21,00", "line_total_incl_vat": "121,00", "currency": "EUR", "created_at": "2025-10-17 14:31:00" } ] }

Status: 400 — Mangler obligatorisk leverandør-ID eller dokument-ID.

Status: 404 — Mottatt faktura ble ikke funnet eller er ikke tillatt for denne leverandør-ID/dokument-ID.

Status: 500 — Serverfeil.

PDF til Peppol

/pdf2peppol/legg til • Metoder: STOLPE

Last opp en PDF for Peppol-konvertering

Mottar et PDF-dokument via filopplasting, base64 eller URL. Peppox lagrer det i PDF til Peppol-køen og starter konverteringsprosessen. Dokumentet sendes ikke umiddelbart til Peppol: det må først behandles, kontrolleres, bekreftes og deretter sendes.

STOLPE /pdf2peppol/legg til • Vurder: 50 PDF/måned som standard

Parametere

Navn	I	Type	Obligatorisk	Misligholde	Beskrivelse
`leverandør_id`		streng	Ja		Leverandør-ID. Alias akseptert: apikey eller api_key.
`pdf_url`		streng	Ingen		Offentlig URL til PDF-filen som skal importeres. Alias: file_url, document_url, url.
`pdf_base64`	kropp	streng	Ingen		PDF-innhold kodet i base64. Alias: content_base64, file_base64, document_base64, base64.
`pdf-fil`		fil	Ingen		PDF-filopplasting. Godkjente feltnavn: pdf, fil, faktura_pdf, dokument, pdf_fil.
`filnavn`		streng	Ingen	dokument.pdf	Opprinnelig filnavn. Brukes ved sending av base64 eller URL.
`nettverk`		streng	Ingen	produksjon	Peppol-nettverk. Tillatt: produksjon eller integrasjon. Alias: net_work, environment.
`dokumenttypekode`		streng	Ingen	380	Dokumenttype. 380 = salgsfaktura, 381 = kreditnota. Aliaser: fakturatypekode, dokumenttype, type.

Be om eksempler

KRØLL

krøll "https://api.peppox.com/pdf2peppol/add/?supplier_id=de5c7119-0f03-4058-9d3b-9f9520c2a46e&pdf_url=https://peppox.com/invoice2.pdf"

curl -X POST "https://api.peppox.com/pdf2peppol/add/" -F "leverandør_id=de5c7119-0f03-4058-9d3b-9f9520c2a46e" -F "pdf=@faktura.pdf"

curl -X POST "https://api.peppox.com/pdf2peppol/add/" -H "Innholdstype: applikasjon/json" -d "{"leverandør_id":"de5c7119-0f03-4058-9d3b-9f9520c2a46e","pdf_base64":"JVBERi0xLjQ...","filnavn":"faktura.pdf"}"

Svar

Status: 200 — PDF-filen ble godkjent og lagt til i konverteringskøen.

JSON

{ "success": true, "message": "PDF-dokument mottatt. Det venter nå på behandling.", "queue_guid": "pdf-6e9466501393cfbb32b1ec80498a1dfa", "status": "venter", "from_api": 1, "supplier_id": "de5c569-0f03-4248-9dae-9f9520c2a477e", "queue_customer_id": 12, "document_type_code": "380", "document_type_label": "Salgsfaktura", "network": "production", "pdf_source": "url", "filename": "invoice2.pdf", "monthly_limit": { "limit": 50, "used": 4, "remaining_before_upload": 46 } }

Status: 400 — Ugyldig forespørsel, ugyldig leverandør, ugyldig PDF, fil for stor eller månedlig grense nådd.

/pdf2peppol/sjekk • Metoder: BLI

Sjekk konverteringen av PDF til Peppol

Returnerer konverteringsstatus, uttrukne toppdata, uttrukne linjer, PDF-lenke og Peppol-beredskapskontroller for et PDF-dokument i kø.

BLI /pdf2peppol/sjekk • Vurder: 300 req/min

Parametere

Navn	I	Type	Obligatorisk	Misligholde	Beskrivelse
`leverandør_id`		streng	Ja		Leverandør-ID. Alias akseptert: apikey eller api_key.
`kø_guide`		streng	Ja		Kø-GUID returnert av /pdf2peppol/add. Alias: guid.
`nedlasting_pdf`	spørsmål	boolsk	Ingen	0	Hvis satt til 1, returneres den originale PDF-filen i stedet for JSON.

Be om eksempler

KRØLL

krøll "https://api.peppox.com/pdf2peppol/check/?supplier_id=de5c7119-0f03-4058-9d3b-9f9520c2a46e&queue_guid=pdf-6e9466501393cfbb32b1ec80498a1dfa"

Svar

Status: 200 — Konverteringen er lastet inn.

JSON

{ "success": true, "message": "Konvertering fra PDF til Peppol lastet inn.", "queue": { "queue_guid": "pdf-6e9466501393cfbb32b1ec80498a1dfa", "supplier_id": "de5c569-0f03-4248-9dae-9f9520c2a477e", "document_type_code": "380", "document_type_label": "Salgsfaktura", "network": "production", "filename": "invoice.pdf", "pdf_url": "https://api.peppox.com/pdf2peppol/check/?download_pdf=1&supplier_id=de5c569-0f03-4248-9dae-9f9520c2a477e&queue_guid=pdf-6e9466501393cfbb32b1ec80498a1dfa", "processing": { "status": "parsed", "is_waiting": false, "is_finished": true, "has_error": false }, "verification": { "confirmed": false, "confirmed_at": "" }, "peppol_send": { "status": "blokkert", "requested_at": "", "completed_at": "", "peppox_invoice_guid": "", "error": "" } }, "peppol_readiness": { "ready_for_peppol": true, "can_be_verified": true, "verification_confirmed": false, "can_be_sent_now": false, "send_block_reason": "Dokumentet må bekreftes før det kan sendes." }, "converted_data": { "header": { "document": { "document_number": "INV-2025-001", "document_date": "2025-10-17", "document_type_code": "380", "document_type_label": "Salgsfaktura", "currency": "EUR", "peppol_ready": true }, "buyer": { "name": "Kundeselskap", "company_number": "0123456789", "country": "BE" }, "totals": { "total_excl_vat": "100.00", "total_vat": "21.00", "total_incl_vat": "121.00" } }, "lines_count": 1, "lines": [ { "line_no": 1, "description": "Konsulenttjeneste", "quantity": "1", "unit_price": "100.00", "vag_rate": "21" } ] } }

Status: 400 — Ugyldig supplier_id, queue_guid eller konvertering ble ikke funnet.

/pdf2peppol/bekreft • Metoder: STOLPE

Bekreft konvertert PDF-informasjon

Bekrefter at den uttrukne faktura- eller kreditnotainformasjonen er korrekt. Denne bekreftelsen er nødvendig før dokumentet kan sendes til Peppol.

STOLPE /pdf2peppol/bekreft • Vurder: 300 req/min

Parametere

Navn	Type	Obligatorisk	Misligholde	Beskrivelse
`leverandør_id`	streng	Ja		Leverandør-ID. Alias akseptert: apikey eller api_key.
`kø_guide`	streng	Ja		Kø-GUID returnert av /pdf2peppol/add. Alias: guid.
`bekreftet`	boolsk	Ingen	1	Valgfritt bekreftelsesflagg. Endepunktet bekrefter dokumentet hvis alle nødvendige Peppol-felt er tilgjengelige.

Be om eksempler

KRØLL

krøll "https://api.peppox.com/pdf2peppol/confirm/?supplier_id=ed751d5a-661e-4f6e-9d74-2d7447be4a9d&queue_guid=pdf-6e9466501393cfbb32b1ec80498a1dfa"

Svar

Status: 200 — Dokumentverifisering bekreftet og klar til sending.

JSON

{ "success": true, "message": "Dokumentverifisering bekreftet. Dokumentet er klart til å sendes til Peppol.", "supplier_id": "ed751d5a-661e-4f6e-9d74-2d7447be4a9d", "queue_guid": "pdf-6e9466501393cfbb32b1ec80498a1dfa", "document_type_code": "380", "document_type_label": "Salgsfaktura", "verification_confirmed": true, "verification_confirmed_at": "2025-10-17 15:10:00", "send_status": "klar", "ready_for_peppol": true, "checks": { "document_number": true, "document_date": true, "buyer_name": true, "buyer_identifier": true, "buyer_street": true, "buyer_city": true, "buyer_postal": true, "buyer_country": true, "document_lines": true }, "missing_fields": [] }

Status: 400 — Dokumentet kan ikke bekreftes fordi data mangler eller konverteringen ikke er klar.

/pdf2peppol/send • Metoder: STOLPE

Send bekreftet PDF-dokument til Peppol

Sender en bekreftet PDF til Peppol. Peppox oppretter fakturaen eller kreditnotaen, legger til linjer, legger ved den originale PDF-filen, genererer Peppol XML og starter sendearbeidsflyten. Viktig: Etter at du har kalt dette endepunktet, må du tillate en forsinkelse på noen få minutter fordi flere interne prosesser fullfører og validerer dokumentet før endelig Peppol-levering.

STOLPE /pdf2peppol/send • Vurder: 300 req/min

Parametere

Navn	I	Type	Obligatorisk	Misligholde	Beskrivelse
`leverandør_id`		streng	Ja		Leverandør-ID. Alias akseptert: apikey eller api_key.
`kø_guide`		streng	Ja		Kø-GUID returnert av /pdf2peppol/add. Alias: guid.

Be om eksempler

KRØLL

krøll "https://api.peppox.com/pdf2peppol/send/?supplier_id=ed751d5a-661e-4f6e-9d74-2d7447be4a9d&queue_guid=pdf-6e9466501393cfbb32b1ec80498a1dfa"

Svar

Status: 200 — Dokument sendt eller allerede sendt. Endelig leveringsstatus for Peppol kan ta noen minutter fordi intern behandling fortsetter etter forespørselen.

JSON

{ "success": true, "message": "Salgsfaktura sendt til Peppol.", "supplier_id": "ed751d5a-661e-4f6e-9d74-2d7447be4a9d", "queue_guid": "pdf-6e9466501393cfbb32b1ec80498a1dfa", "peppox_document_guid": "0e8b3c9d-1111-4444-9999-aabbccddeeff", "document_type_code": "380", "document_type_label": "Salgsfaktura", "network": "production", "send_status": "sendt", "payment_reference": "INV-2025-001", "buyer": { "name": "Kundeselskap", "vat_id": "BE0123456789", "company_id": "0123456789", "gate": "Kunde Gate 1", "by": "Brussel", "postal": "1000", "land": "BE", "telefon": "+32123456789", "e-post": "kunde@eksempel.com" }, "trinn": { "document_create": "ok", "document_lines": "ok", "pdf_attachment": "ok", "xml_generate": "ok" }, "peppox_responses": { "invoice_add": { "ok": true, "invoice_guid": "0e8b3c9d-1111-4444-9999-aabbccddeeff", "status": "UTKAST" }, "xml_generate": { "ok": true, "status": "XML_BUILT", "xml_path": "opprettet" } } }

Status: 400 — Dokumentet kan ikke sendes. Det kan hende det ikke er analysert, ikke bekreftet, allerede sendes, data mangler, eller Peppox API returnerte en feil.

Status: 405 — Metoden er ikke tillatt.

Webhooks

Ingen webhooks dokumentert.

SDK-er

Ingen SDK-er oppført.

Feilkatalog

Ingen feil definert.

Endringslogg

Ingen utgivelser ennå.