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 stiHva
POST /api/v1/invoicesRegistrer leverandørfaktura. Matches med en gang.
GET /api/v1/invoices?status=avvikList fakturaer (filter: kontroll, avvik, matchet, godkjent, sendt, betalt, avvist).
GET /api/v1/invoices/:idFaktura med matching og historikk.
POST /api/v1/packing-slipsRegistrer pakkseddel, valgfritt med varemottak.
GET /api/v1/orders?status=bestiltBestillinger med linjer (for å koble skannede dokumenter).
GET /api/v1/itemsVarekatalog: 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..." }
  }'
FeltBeskrivelse
supplier *Leverandørkoden fra Innstillinger, f.eks. SG.
invoiceNo *Fakturanummer. Samme nummer fra samme leverandør avvises som duplikat.
invoiceDate, dueDateDatoer på formen ÅÅÅÅ-MM-DD.
amountExVat, vat, amountBeløp eks. mva, mva og totalt å betale (NOK).
orderIdRestoq-bestillingen. Utelates den, finner Restoq beste treff hos leverandøren rundt fakturadatoen.
lines[]itemNo (leverandørens varenummer), description, qty, unitPrice eks. mva.
fileValgfritt 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

KodeBetydning
401Mangler eller ugyldig API-nøkkel.
404Fant ikke ressursen.
422Ugyldige data, f.eks. ukjent leverandør eller duplikat. Se message.