Restoq API v1
Med API-et kan skannere, EDI-løsninger og andre systemer registrere leverandørfakturaer og pakksedler i Restoq. Restoq matcher dem automatisk mot bestilling og varemottak. Godkjenning, sending til Tripletex og betaling gjøres av leder i appen.
Autentisering
Leder lager en API-nøkkel under Innstillinger → API-nøkler. Nøkkelen gjelder for ett utsted og sendes i hver forespørsel:
Authorization: Bearer rq_xxxxxxxxxxxxxxxxxxxxxxxx
Nøkkelen vises bare én gang. Behandle den som et passord, og slett den i appen hvis den kommer på avveie. Alle kall går over HTTPS og bruker JSON.
Endepunkter
| Metode og sti | Hva |
|---|---|
POST /api/v1/invoices | Registrer leverandørfaktura. Matches med en gang. |
GET /api/v1/invoices?status=avvik | List fakturaer (filter: kontroll, avvik, matchet, godkjent, sendt, betalt, avvist). |
GET /api/v1/invoices/:id | Faktura med matching og historikk. |
POST /api/v1/packing-slips | Registrer pakkseddel, valgfritt med varemottak. |
GET /api/v1/orders?status=bestilt | Bestillinger med linjer (for å koble skannede dokumenter). |
GET /api/v1/items | Varekatalog: leverandør, varenummer, navn, enhet og avtalt pris. |
Registrer faktura
curl -X POST https://restoq.no/api/v1/invoices \
-H "Authorization: Bearer rq_xxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"supplier": "SG",
"invoiceNo": "104882",
"invoiceDate": "2026-11-17",
"dueDate": "2026-12-01",
"amountExVat": 1375.60,
"vat": 206.34,
"amount": 1581.94,
"kid": "000104882",
"lines": [
{ "itemNo": "545657", "description": "SMØR 500G", "qty": 8, "unitPrice": 62.50 },
{ "itemNo": "2474740", "description": "HELMELK 1L", "qty": 40, "unitPrice": 21.89 }
],
"file": { "name": "faktura-104882.pdf", "contentBase64": "JVBERi0xLjcK..." }
}'| Felt | Beskrivelse |
|---|---|
supplier * | Leverandørkoden fra Innstillinger, f.eks. SG. |
invoiceNo * | Fakturanummer. Samme nummer fra samme leverandør avvises som duplikat. |
invoiceDate, dueDate | Datoer på formen ÅÅÅÅ-MM-DD. |
amountExVat, vat, amount | Beløp eks. mva, mva og totalt å betale (NOK). |
orderId | Restoq-bestillingen. Utelates den, finner Restoq beste treff hos leverandøren rundt fakturadatoen. |
lines[] | itemNo (leverandørens varenummer), description, qty, unitPrice eks. mva. |
file | Valgfritt vedlegg: { name, contentBase64 }. PDF, PNG, JPEG, TIFF eller EHF (XML), maks 10 MB. Kreves for å sende fakturaen til Tripletex. |
Svar:
HTTP/1.1 201 Created
{
"id": "m3k9x2ab12cd",
"status": "avvik",
"orderId": "lq8w1z3k",
"match": {
"ok": false,
"issues": [
"Fakturert 1375.60 kr eks. mva, forventet 1250.60 kr ut fra mottatte varer og avtalte priser.",
"1 varelinje har avvik."
],
"expectedExVat": 1250.60,
"invoicedExVat": 1375.60,
"lines": [ { "itemNo": "545657", "ordered": 8, "received": 6, "invoiced": 8, "flags": ["Fakturert 8, mottatt 6"] } ]
}
}Matching
Hver varelinje sammenlignes med bestilt antall, mottatt antall (fra varemottak eller pakkseddel) og avtalt pris. Restoq markerer: fakturert mer enn mottatt, ikke bestilt, mottatt men ikke fakturert, ikke registrert mottatt, prisavvik over 2 % og ukjent vare. Totalbeløpet eks. mva sammenlignes med forventet beløp (mottatt × avtalt pris) med toleranse på 1 %, minst 10 kr. Status blir matchet, avvik eller kontroll (ingen bestilling funnet).
Registrer pakkseddel
curl -X POST https://restoq.no/api/v1/packing-slips \
-H "Authorization: Bearer rq_xxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"supplier": "SG",
"slipNo": "PS-77812",
"date": "2026-11-17",
"receive": true,
"lines": [ { "itemNo": "545657", "qty": 6 }, { "itemNo": "2474740", "qty": 40 } ]
}'Med "receive": true registreres varemottaket på den åpne bestillingen med pakkseddelens antall. Varer som står på bestillingen, men ikke på pakkseddelen, registreres som 0 mottatt.
Tripletex
Når leder har koblet Restoq til Tripletex (Innstillinger → Tripletex), sendes godkjente fakturaer til bilagsmottaket i Tripletex for bokføring. Leverandørfakturaer som allerede ligger i Tripletex, for eksempel EHF, hentes inn og matches i stedet for å sendes på nytt. Når fakturaen er bokført i Tripletex, kan den godkjennes og legges til betaling derfra via Restoq. Selve utbetalingen skjer gjennom banken som er koblet til Tripletex.
Feil
| Kode | Betydning |
|---|---|
| 401 | Mangler eller ugyldig API-nøkkel. |
| 404 | Fant ikke ressursen. |
| 422 | Ugyldige data, f.eks. ukjent leverandør eller duplikat. Se message. |