Hent en faktura

GET/api/v1/invoices/{id}

Virker

Med linjer, KID og ordrene den dekker. En kundenøkkel får bare sin egen kundes; en annen kundes faktura og et utkast svarer 404.

Rettigheter: invoices:read
Kundenøkkel: Ja, for sine egne
Grense: lesing, 120 i minuttet
Siden: 5. oktober 2026

Parametre

I adressen

idstring · uuidMå med
UUID

Svaret

200OKFakturaen

application/jsonInvoice

Vis alle 20 feltSkjul de 20 feltene

idstring · uuidMå med
UUID
kindstringMå med
Verdierinvoicecredit_noteerp_mark
numberstringMå medkan være null
statusstringMå med
Verdierutkastsendtforfaltbetaltkansellertkreditert
issueDatestring · dateMå medkan være nulleks. 2026-12-18
Dato på Oslo-kalenderen, ÅÅÅÅ-MM-DD
dueDatestring · dateMå medkan være nulleks. 2026-12-18
Dato på Oslo-kalenderen, ÅÅÅÅ-MM-DD
kidstringMå medkan være null
customerobjectMå medkan være null
Vis 3 feltSkjul 3 felt
- idstring · uuidMå med
  UUID
- numberintegerMå medkan være null
- namestringMå med
orderReferencestringMå medkan være null
customerReferencestringMå medkan være null
orderNumbersinteger[]Må med
currencystringMå med
Alltid "NOK"
netOreintegerMå medkan være null
Hele øre (1 kr = 100 øre)
vatOreintegerMå medkan være null
Hele øre (1 kr = 100 øre)
grossOreintegerMå medkan være null
Hele øre (1 kr = 100 øre)
linesInvoiceLine[]Må med
Vis 6 feltSkjul 6 felt
- descriptionstringMå med
  Varen slik den står på fakturaen: navnet og målene.
- quantitynumberMå med
- unitstringMå medkan være null
  Alltid null i v1: fakturalinjene lagrer ingen enhet. Enheten står i description når den er kjent.
- unitPriceOreintegerMå med
  Hele øre (1 kr = 100 øre)
- netOreintegerMå med
  Hele øre (1 kr = 100 øre)
- vatBpintegerMå med0–10000
  Moms i basispunkter: 2500 = 25 %
erpobjectMå medkan være null
Vis 2 feltSkjul 2 felt
- vendorstringMå med
  Verdierpowerofficetripletexfiken
- invoiceNostringMå medkan være null
paidAtstring · date-timeMå medkan være nulleks. 2026-12-14T09:03:00.000Z
Tidspunkt, ISO 8601 i UTC
createdAtstring · date-timeMå medeks. 2026-12-14T09:03:00.000Z
Tidspunkt, ISO 8601 i UTC
updatedAtstring · date-timeMå medeks. 2026-12-14T09:03:00.000Z
Tidspunkt, ISO 8601 i UTC

Feilkoder

Alle feil har samme form. Velg handling etter code, aldri etter message. Les mer under Feil.

400Bad Request

invalid_requestNoe i forespørselen er feil eller ukjent. fields sier hva.

401Unauthorized

unauthorizedNøkkelen mangler, er feil, er slått av eller har gått ut. En nøkkel som slås av, slutter å virke innen 1 minutt.

403Forbidden

account_closedVerkstedet er stengt.
dpa_requiredVerkstedet må godta databehandleravtalen før koblinger kan brukes.
feature_not_in_planVerkstedet har ikke slått på delen dette trenger. feature sier hvilken.
insufficient_scopeNøkkelen har ikke lov til dette. requiredScope sier hvilken rett som mangler.

404Not Found

not_foundFant ikke dette.

429Too Many Requests

rate_limitedFor mange kall. Vent retryAfterSeconds sekunder.

500Internal Server Error

internalNoe gikk galt hos oss. Feilen er meldt. Oppgi requestId hvis du spør.

GET/invoices/{id}

curl https://vbeslag.com/api/v1/invoices/9a4c2f10-6b1e-4d8a-9f3e-2c7d5b8a1e04 \
  -H "Authorization: Bearer vb_test_…"

const res = await fetch('https://vbeslag.com/api/v1/invoices/9a4c2f10-6b1e-4d8a-9f3e-2c7d5b8a1e04', {
  headers: {
    Authorization: 'Bearer vb_test_…',
  },
})
const data = await res.json()

$ch = curl_init('https://vbeslag.com/api/v1/invoices/9a4c2f10-6b1e-4d8a-9f3e-2c7d5b8a1e04');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer vb_test_…',
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Svaret

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": "9a4c2f10-6b1e-4d8a-9f3e-2c7d5b8a1e04",
  "kind": "invoice",
  "number": "10442",
  "status": "sendt",
  "issueDate": "2026-12-31",
  "dueDate": "2027-01-14",
  "kid": "0104424",
  "customer": {
    "id": "5d0a7c3e-2f41-4b9a-8e6d-1a2b3c4d5e6f",
    "number": 312,
    "name": "Byggmester Hansen AS"
  },
  "orderReference": "Lapp 004708, 004711",
  "customerReference": "P-2231 · Ole",
  "orderNumbers": [
    4708,
    4711
  ],
  "currency": "NOK",
  "netOre": 1250000,
  "vatOre": 312500,
  "grossOre": 1562500,
  "lines": [
    {
      "description": "Vindskie 150×40",
      "quantity": 10,
      "unit": "stk",
      "unitPriceOre": 61200,
      "netOre": 612000,
      "vatBp": 2500
    }
  ],
  "erp": {
    "vendor": "poweroffice",
    "invoiceNo": "20231"
  },
  "paidAt": null,
  "createdAt": "2026-12-31T08:12:00.000Z",
  "updatedAt": "2026-12-31T08:14:00.000Z"
}