Begreper

Seks ting du må kjenne for å forstå svarene fra API-et.

Ordre og nummer

Alt er en ordre: en lapp fra verkstedet, en ordre fra disken, en forespørsel fra nettbutikken eller fra deg. Hver ordre får neste nummer i verkstedets serie, vist som 004711. Testordre har egen serie, T-000012.

{ "number": 4711, "numberDisplay": "004711", "isTest": false }

Bruk numberDisplay når du viser nummeret til et menneske. Det er det samme nummeret som står på lappen.

Stigen

En ordre går oppover stigen: Forespørsel → Mottatt → I arbeid → Klar → Levert → Fakturert → Betalt. Avbrutt kan skje underveis.

status er den lagrede verdien (forespurt, mottatt …), statusLabel ordet appen viser. Fakturert og Betalt settes bare av faktura og betaling, aldri med API-et. Et system med retten orders:status kan flytte en ordre til I arbeid, Klar og Levert med POST /orders/{number}/status.

curl https://vbeslag.com/api/v1/orders/004711/status \
  -H "Authorization: Bearer $VBESLAG_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "to": "klar" }'

Penger i øre

Beløp er hele øre med «Ore» til slutt: unitPriceOre: 61200 er 612 kr. Moms er basispunkter: vatBp: 2500 er 25 %. En linje uten pris har priceStatus: "pending": Pris kommer.

{ "unitPriceOre": 61200, "vatBp": 2500, "priceStatus": "priced" }

Test og ekte

En testnøkkel (vb_test_) lager testordre som ikke vises i listene, sender aldri SMS eller e-post, teller ikke på regningen og slettes etter 30 dager. Den leser de ekte kundene, men kan ikke endre kunderegisteret. Se Nøkler og tilgang.

Verkstedsnøkkel og kundenøkkel

En verkstedsnøkkel ser hele verkstedet. En kundenøkkel hører til en kunde: den ser bare den kundens ordre, avtaler og sendte fakturaer, sender forespørsler og avrop på kundens godtatte avtaler, og kan trekke tilbake sine egne forespørsler.

Et annet verksteds eller en annen kundes ordre eller faktura svarer 404, aldri 403. Se Nøkler og tilgang.

Tid

Tidspunkter er ISO 8601 i UTC. Datoer (requestedDate, deliveryDate) er dager på Oslo-kalenderen, ÅÅÅÅ-MM-DD.

{ "createdAt": "2026-12-14T10:42:07Z", "deliveryDate": "2026-12-18" }