Fakturaer

Opprett, send og følg opp fakturaer. Kreditnota, innbetalinger og innboks for mottatte EHF-fakturaer.

POST/v1/fakturaerOpprett faktura
POST/v1/fakturaer/{id}/sendSend faktura
GET/v1/fakturaer/{id}Hent faktura
POST/v1/fakturaer/{id}/kreditnotaOpprett kreditnota
GET/v1/innboksMottatte fakturaer

POST/v1/fakturaer

Opprett faktura

Oppretter et utkast. Fakturanummer tildeles ved sending. Bruk Idempotency-Key for å unngå dobbeltfakturering ved gjenforsøk.

Kropp (JSON)

mottakerobjectpåkrevd
«orgnr» for bedrift, eller «navn», «epost» og «adresse» for privatperson.
forfalldatepåkrevd
Forfallsdato, ISO 8601. Minst 14 dager frem for forbrukere.
linjerobject[]påkrevd
Hver linje: «tekst», «antall», «pris» (eks. mva), «mva» (0, 12, 15 eller 25), valgfritt «enhet» og «rabatt».
valutastring
NOK (standard), EUR, SEK, DKK, USD, GBP.
referansestring
Din referanse. Vises på fakturaen og i EHF (BuyerReference).
purreløpstring
ID på purreløp fra dashbordet, eller «ingen».
metadataobject
Fritt nøkkel/verdi, opptil 20 nøkler. Kommer tilbake i webhooks.

forespørsel

curl -X POST https://api.spireapi.com/v1/fakturaer \
  -H "Authorization: Bearer sk_test_…" -H "Idempotency-Key: ordre-10422" -H "Content-Type: application/json" \
  -d '{"mottaker":{"orgnr":"923456789"},"forfall":"2026-12-01","linjer":[{"tekst":"Konsulenttimer oktober","antall":40,"pris":1250,"mva":25}]}'

svar

{
  "id": "fak_01JBX4R8Q2M7",
  "status": "utkast",
  "mottaker": { "orgnr": "923456789", "navn": "Tallgruppen AS", "kan_motta_ehf": true },
  "belop": { "netto": 50000.00, "mva": 12500.00, "brutto": 62500.00, "valuta": "NOK" },
  "forfall": "2026-12-01",
  "opprettet": "2026-11-03T09:12:40Z"
}

POST/v1/fakturaer/{id}/send

Send faktura

Tildeler fakturanummer og sender via beste kanal: Peppol hvis mottaker er registrert, ellers e-post med PDF, ellers brev hvis «kanal» tillater det. Kan ikke angres; bruk kreditnota.

Stiparametre

idstringpåkrevd
Faktura-ID.

Kropp (JSON)

kanalstring
«auto» (standard), «peppol», «epost» eller «brev».

forespørsel

curl -X POST https://api.spireapi.com/v1/fakturaer/fak_01JBX4R8Q2M7/send \
  -H "Authorization: Bearer sk_test_…"

svar

{
  "id": "fak_01JBX4R8Q2M7",
  "nummer": 10422,
  "status": "sendt",
  "kanal": "peppol",
  "kid": "1042200000078",
  "sendt": "2026-11-03T09:12:44Z"
}

GET/v1/fakturaer/{id}

Hent faktura

Fakturaen med status, kanal, kvitteringer, innbetalinger og purrehistorikk.

Stiparametre

idstringpåkrevd
Faktura-ID.

forespørsel

curl https://api.spireapi.com/v1/fakturaer/fak_01JBX4R8Q2M7 \
  -H "Authorization: Bearer sk_test_…"

svar

{
  "id": "fak_01JBX4R8Q2M7",
  "nummer": 10422,
  "status": "betalt",
  "kanal": "peppol",
  "belop": { "brutto": 62500.00, "betalt": 62500.00, "rest": 0.00, "valuta": "NOK" },
  "innbetalinger": [ { "belop": 62500.00, "dato": "2026-11-28", "kilde": "ocr" } ],
  "purringer": [],
  "pdf_url": "https://filer.spireapi.com/fak_01JBX4R8Q2M7.pdf"
}

POST/v1/fakturaer/{id}/kreditnota

Opprett kreditnota

Krediterer hele eller deler av fakturaen. Kreditnotaen sendes i samme kanal som fakturaen.

Stiparametre

idstringpåkrevd
Faktura-ID.

Kropp (JSON)

linjerobject[]
Linjer som krediteres. Utelatt = hele fakturaen.
aarsakstringpåkrevd
Fritekst, vises på kreditnotaen.

forespørsel

curl -X POST https://api.spireapi.com/v1/fakturaer/fak_01JBX4R8Q2M7/kreditnota \
  -H "Authorization: Bearer sk_test_…" -H "Content-Type: application/json" -d '{"aarsak":"Feil antall timer"}'

svar

{ "id": "kre_01JBX7D2PQ4N", "faktura_id": "fak_01JBX4R8Q2M7", "nummer": 10423, "status": "sendt", "belop": { "brutto": -62500.00 } }

GET/v1/innboks

Mottatte fakturaer

Fakturaer mottatt via Peppol til din organisasjon, som strukturert JSON med linjer og vedlegg. Krever at Innboks er aktivert.

Spørringsparametre

statusstring
«ny», «behandlet» eller «alle».
fradate
Mottatt fra og med dato.
antallinteger
1–100.
markorstring
Neste side.

forespørsel

curl "https://api.spireapi.com/v1/innboks?status=ny" \
  -H "Authorization: Bearer sk_test_…"

svar

{
  "data": [
    { "id": "inn_01JBX8M1", "avsender": { "orgnr": "976543210", "navn": "Revisjonshuset AS" }, "nummer": "2026-1182", "belop": { "brutto": 18750.00 }, "forfall": "2026-11-30", "status": "ny", "linjer": 2, "vedlegg": 1 }
  ],
  "neste": null
}

Fant du en feil? Si fra, så retter vi innen en virkedag.