Tallene for en måned

GET/api/v1/reports/months/{month}

Virker

Tallene fra Tall for en måned: bare summer, aldri kundenavn. Hvert tall teller det som skjedde i måneden (norsk tid). Inneværende måned gir tallene så langt; en måned fram i tid avvises. Bare verkstedets egne nøkler.

Rettigheter: reports:read
Kundenøkkel: Nei
Grense: lesing, 120 i minuttet
Siden: 5. oktober 2026

Parametre

I adressen

monthstringMå medmønster ^\d{4}-(0[1-9]|1[0-2])$
Måneden, ÅÅÅÅ-MM

Svaret

200OKMånedstallene

application/jsonMonthReport

monthstringMå med
currencystringMå med
Alltid "NOK"
ordersobjectMå med
Vis 4 feltSkjul 4 felt
- receivedintegerMå med
- readyintegerMå med
- deliveredintegerMå med
- bySourceRecord<string, integer>Må mednøklene er tekst
invoicedobjectMå med
Vis 3 feltSkjul 3 felt
- countintegerMå med
- netOreintegerMå med
  Hele øre (1 kr = 100 øre)
- grossOreintegerMå med
  Hele øre (1 kr = 100 øre)
paidobjectMå med
Vis 2 feltSkjul 2 felt
- countintegerMå med
- grossOreintegerMå med
  Hele øre (1 kr = 100 øre)
outstandingobjectMå med
Vis 4 feltSkjul 4 felt
- countintegerMå med
- grossOreintegerMå med
  Hele øre (1 kr = 100 øre)
- overdueCountintegerMå med
- overdueGrossOreintegerMå med
  Hele øre (1 kr = 100 øre)
generatedAtstring · 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.
customer_key_not_allowedEn kundenøkkel kan ikke gjøre dette.
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.

422Unprocessable Entity

date_invalidDatoen er ikke en gyldig dag (ÅÅÅÅ-MM-DD).

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/reports/months/{month}

curl https://vbeslag.com/api/v1/reports/months/2026-09 \
  -H "Authorization: Bearer vb_test_…"

const res = await fetch('https://vbeslag.com/api/v1/reports/months/2026-09', {
  headers: {
    Authorization: 'Bearer vb_test_…',
  },
})
const data = await res.json()

$ch = curl_init('https://vbeslag.com/api/v1/reports/months/2026-09');
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

{
  "month": "2026-09",
  "currency": "NOK",
  "orders": {
    "received": 212,
    "ready": 198,
    "delivered": 151,
    "bySource": {
      "lapp": 140,
      "manuell": 31,
      "avrop": 22,
      "nettbutikk": 12,
      "api": 7
    }
  },
  "invoiced": {
    "count": 64,
    "netOre": 14230000,
    "grossOre": 17787500
  },
  "paid": {
    "count": 51,
    "grossOre": 11890000
  },
  "outstanding": {
    "count": 18,
    "grossOre": 5410000,
    "overdueCount": 4,
    "overdueGrossOre": 1234000
  },
  "generatedAt": "2026-10-06T08:00:00.000Z"
}