Forhåndsvisning av faktura, betalingsregistrering og kreditering via API-et

Historisk tilbakeblikk – mai til august 2026
Denne artikkelen ble skrevet i ettertid og beskriver de separate fakturahandlingene som ble tilgjengelige via API-et.

En integrasjon må skille mellom å lese en faktura, registrere en handling og flytte penger. Start med en forhåndsvisning når du kontrollerer linjer og beløp, og opprett eller hent deretter fakturaen som beskrives i den gjeldende kontrakten.

En syntetisk arbeidsflyt

1. Bruk forhåndsvisningsendepunktet for kundens faktura til å kontrollere perioder, linjer og totalsum.
2. Du kan eventuelt hente PDF-en av forhåndsvisningen for intern godkjenning.
3. Opprett eller les fakturaen, og bruk UUID-en dens i senere kall.
4. Bruk mark-as-sent når arbeidsflyten din har levert eller registrert dokumentet. Kallet sender aldri en e-post; det registrerer levering via en ekstern kanal og hindrer en ventende automatisk faktura-e-post i å bli sendt.
5. Bruk mark-as-paid når en betaling skal registreres manuelt. Dette starter ikke en ny kortbelastning.
6. Bruk krediteringsendepunktet når enkelte fakturalinjer skal krediteres. En kreditnota er en separat handling og er ikke det samme som å slette fakturaen.

En refusjon kan fortsatt vente etter at forespørselen er godtatt. Les svaret og senere status før du viser beløpet som tilbakebetalt.

Feil og forventninger

Forhåndsvisning, PDF, sendt, betalt og kreditert har ulike svar og statuser. Bruk den gjeldende OpenAPI-referansen for skjemaer og tillatte felter. Ikke legg ekte token eller kundeopplysninger i testkode; bruk syntetiske UUID-er i eksempler.

Se veiledningen for offentlig API og webhooks (Markdown-fil, AI-agentvenlig) for den gjeldende kontrakten.

Sender mark-as-sent en e-post? Aldri. Det registrerer at en ekstern kanal har levert fakturaen, og hindrer en ventende automatisk faktura-e-post i å bli sendt. Bruk den separate sendehandlingen hvis Alunta skal sende e-posten.

Flytter mark-as-paid penger? Nei. Den registrerer en manuell betaling; det er ikke en ny kortbelastning.

Kan en kreditering være delvis? Ja. Bruk den dokumenterte handlingen for kreditering av linjer, og les statusen tilbake før du viser den som fullført.

Hold statusene atskilt i integrasjonen

En forhåndsvisning kan vise brukeren hva som vil bli fakturert, før et endelig dokument finnes. En PDF gir de samme opplysningene i et format som kan godkjennes eller arkiveres. Når fakturaen finnes, registrerer mark-as-sent arbeidsflyten. Hvis integrasjonen også må sende dokumentet, bør den bruke den dokumenterte sendehandlingen og håndtere svaret separat.

På samme måte er mark-as-paid en manuell registrering. Bruk den bare når en bruker eller en avstemt ekstern kilde har bekreftet betalingen. Ikke utled et betalingskall fra en vellykket forhåndsvisnings- eller sendestatus. Kreditering av valgte linjer endrer fordringen gjennom en krediteringshandling; den sletter ikke den opprinnelige fakturaen og er ikke automatisk en kontantrefusjon. mark-as-sent sender aldri e-post, heller ikke når den kalles etter at fakturaen er ferdigstilt; den blokkerer den ventende automatiske utsendingen.

Bruk fakturaens UUID til oppfølgingskall, og les gjeldende status etter hver handling. Hvis svaret venter, viser du ventende i stedet for fullført. Da kan brukeren kontrollere neste resultat fra integrasjonen uten å gjenta en handling som allerede er registrert.