API-referanse: alle endepunkter i v1

Finn riktig API-sti for kunder, perioder, mangler, utsendinger, innsendte filer, kontering og rapporter.

Oppdatert 16. november 2026

Adresse, nøkkel og ID-er

Bruk API-adressen fra tilkoblingsveiviseren. For norske byråer er produksjonsadressen https://www.bilagpilot.no/api/v1, og for internasjonale byråer https://www.bilagpilot.com/api/v1. Alle stiene under inkluderer /api/v1. Send nøkkelen i Authorization-headeren med Bearer.

Bytt ut verdier i klammeparenteser, som {clientId}, med ID-er fra lesekallene. Ikke send kundens navn i stedet for en ID. Hvert kall krever tilkoblingens tillatelse og følger kundeutvalget. Et godtatt kall returnerer JSON med data og requestId.

Alle POST-kall trenger Idempotency-Key i en HTTP-header, også kall som bare henter en kundelenke. Bruk en ny UUID per ny handling, og behold samme nøkkel, sti og innhold ved gjentakelse. Feltene til hver handling må sendes som et JSON-objekt med Content-Type: application/json.

Lesekall

  • GET /api/v1/me — hvem tilkoblingen representerer, med en stabil profil-ID.
  • GET /api/v1/status — byråets arbeidsstatus og tilkoblingens begrensninger.
  • GET /api/v1/clients — kunder tilkoblingen har tilgang til. limit begrenser antall kunder per side.
  • GET /api/v1/clients/{clientId} — én kunde med tellinger og lenke til kundesiden.
  • GET /api/v1/periods — tilgjengelige perioder og deres ID-er.
  • GET /api/v1/missing/overview — mangler i regnskapet og utsendingene per kunde. Oppgi periodId som søkeparameter.
  • GET /api/v1/missing/by-client — kunder som fortsatt skylder bilag, med frister og siste purring.
  • GET /api/v1/missing/items — bilagspunkter kunden ikke har levert eller som venter på kontroll.
  • GET /api/v1/accounting-findings — enkeltfunn fra Manglende bilag.
  • GET /api/v1/requests — utsendinger og utkast. Bruk status=draft for utkast.
  • GET /api/v1/requests/{requestId} — én utsending eller ett utkast med bilagspunkter og status.
  • GET /api/v1/reminders — planlagte og sendte purringer med status.
  • GET /api/v1/uploads — metadata om innsendte filer og hva Smart Kontroll har lest ut.
  • GET /api/v1/uploads/{uploadId}/download — nedlastingslenke til én fil som virker i fem minutter. Krever den egne tillatelsen Last ned filer.
  • GET /api/v1/postings — godkjente bilag som venter på kontering, med det Smart Kontroll har lest, lagret kontering og byråets leveringsmåte. status=all viser også bilag som er levert.
  • GET /api/v1/uploads/{uploadId}/posting — grunnlaget for å kontere ett bilag: hva kunden ble bedt om, det Smart Kontroll har lest, lagret kontering, eventuell levering og om bilaget kan leveres nå.
  • GET /api/v1/uploads/{uploadId}/posting/accounts — kundens kontoer, MVA-koder og konteringsregler fra regnskapssystemet. Konto- og MVA-ID-ene herfra brukes ved levering.
  • GET /api/v1/changes — endringer siden et tidspunkt eller videre fra en cursor. Oppgi since eller cursor som søkeparameter.
  • GET /api/v1/reports/collection — innsamlingsrapport for datointervallet i søkeparametrene from og to.
  • GET /api/v1/integrations — støttede regnskapssystemer og status på tilkoblingene.

Skrivekall med valgt tillatelse

Disse kallene krever skrivetilgang. Valget for den enkelte handlingen avgjør om den kjøres direkte eller venter på godkjenning i BilagPilot.

  • POST /api/v1/periods — oppretter en egendefinert periode som utkast. Oppgi periodId, displayLabel, startDate, endDate og documentDeadline.
  • POST /api/v1/drafts — oppretter et usendt utkast med clientId, periodId, dueDate og bilagspunkter i items eller funn-ID-er i gapIds. Et fritekstpunkt trenger title og note. externalRef er valgfritt.
  • POST /api/v1/drafts/{draftId}/items — legger items eller gapIds til et usendt utkast. Like titler legges ikke til to ganger.
  • POST /api/v1/drafts/{draftId}/discard — forkaster et usendt utkast ved å arkivere det.
  • POST /api/v1/requests/{requestId}/deadline — setter dueDate for åpne bilagspunkter i en sendt utsending. requestItemIds kan begrense hvilke punkter som endres.
  • POST /api/v1/clients/{clientId}/reminders/pause — setter kundens automatiske purringer på pause.
  • POST /api/v1/clients/{clientId}/reminders/resume — slår kundens automatiske purringer på igjen.
  • POST /api/v1/requests/{requestId}/close — lukker en sendt utsending når alle bilagspunktene er behandlet.
  • POST /api/v1/requests/{requestId}/upload-link — henter kundelenken til en sendt, åpen utsending uten å sende en melding.
  • POST /api/v1/uploads/{uploadId}/link — knytter en fil til et bilagspunkt på samme utsending. Oppgi requestItemId eller aliaset itemId.
  • POST /api/v1/uploads/{uploadId}/approve — godkjenner en innsendt fil. En intern note er valgfri. Er filen knyttet til en regnskapspost, følger den vanlige leveringsflyten etter kontroll.
  • POST /api/v1/uploads/{uploadId}/posting/suggest — kjører Smart Kontering på ett godkjent bilag og lagrer forslaget. Ingenting leveres. En kontering som allerede er bekreftet eller under levering, erstattes ikke.
  • POST /api/v1/postings/deliveries/{jobId}/cancel — angrer en levering av kontering innen to minutter etter at den ble godkjent. Etter det må bilaget rettes i regnskapssystemet.

Kall som alltid venter på godkjenning i BilagPilot

HTTP 202 med data.status lik awaiting_approval betyr at handlingen er lagt til Venter på godkjenning. Den er ikke utført ennå. Gjenta samme kall med samme Idempotency-Key for å følge utfallet. Hvis et utkast endres etter at sendingen ble lagt til godkjenning, må det godkjennes på nytt.

En levering av kontering oppretter bilag i regnskapssystemet. Den som godkjenner, ser BilagPilots egen forhåndsvisning av hver kontering med kontoer, MVA-kode og leveringsmåte. Leveringsmåten, ubokført kladd eller bokført, følger byråets innstilling og kan ikke velges i kallet. En kontering du er usikker på, sendes alene med uncertain satt til true og en forklaring i note.

Utsending til kunder, filnedlasting, godkjenning av filer og forslag og levering av kontering slås ikke på som en følge av å velge Full tilgang i veiviseren. Byråets eier må gi disse tillatelsene for den konkrete tilkoblingen.

  • POST /api/v1/drafts/{draftId}/send — ber om å sende det nøyaktige utkastet med valgte channels, for eksempel email.
  • POST /api/v1/requests/{requestId}/remind — ber om en manuell purring med valgte channels.
  • POST /api/v1/uploads/{uploadId}/reject — ber om å avvise filen med reason som kunden får beskjed om.
  • POST /api/v1/clients/{clientId}/contact — ber om å endre contactEmail, contactPhone eller begge for kunden.
  • POST /api/v1/postings/deliver — ber om å levere konteringen av opptil ti godkjente bilag til regnskapssystemet. Hver kontering i postings trenger uploadId, debitAccountId, creditAccountId, amount, date, description, byråets leveringsmåte i deliveryMode og et MVA-valg: vatCodeId eller withoutVatCode.

Feil og avgrensninger

Et feilsvar har error.code, error.message og requestId. Kontroller at et kall lyktes før systemet registrerer det som utført. Les veiledningen om skrivehandlinger og feilsvar før du bygger automatiske gjentakelser.

API-et har ingen kall for betaling, brukeradministrasjon, abonnement eller sletting av kunder og sendte utsendinger. Bokføring skjer bare som levering av en kontering som en person har godkjent i BilagPilot. API-et kan ikke hente integrasjonshemmeligheter eller gi sin egen nøkkel flere tillatelser.

Fant du ikke svaret?

Kontakt support, så hjelper vi deg videre.

Kontakt support