Förhandsgranska fakturor, registrera betalning och kreditera via API

Historisk tillbakablick – maj till augusti 2026
Den här artikeln skrevs i efterhand och beskriver de separata fakturaåtgärder som gjordes tillgängliga via API:et.

En integration måste skilja mellan att läsa en faktura, registrera en åtgärd och flytta pengar. Börja med en förhandsgranskning när du kontrollerar rader och belopp och skapa eller hämta sedan fakturan som beskrivs i det aktuella kontraktet.

Ett syntetiskt arbetsflöde

1. Använd kundens ändpunkt för fakturaförhandsgranskning för att kontrollera perioder, rader och totalsumma.
2. Hämta eventuellt PDF-filen från förhandsgranskningen för intern granskning.
3. Skapa eller läs fakturan och använd dess UUID för senare anrop.
4. Använd mark-as-sent när ditt arbetsflöde har levererat eller registrerat dokumentet. Anropet skickar aldrig e-post; det registrerar leverans via en extern kanal och stoppar en väntande automatisk fakturae-post.
5. Använd mark-as-paid när en betalning ska registreras manuellt. Det startar ingen ny kortdebitering.
6. Använd kreditändpunkten när enskilda fakturarader ska krediteras. En kreditnota är en separat åtgärd och inte samma sak som att ta bort fakturan.

En återbetalning kan fortfarande vänta efter att begäran godkänts. Läs svaret och den senare statusen innan du visar pengarna som återbetalda.

Fel och förväntningar

Förhandsgranskning, PDF, skickad, betald och krediterad har olika svar och statusar. Använd den aktuella OpenAPI-referensen för scheman och tillåtna fält. Lägg inte in riktiga tokenvärden eller kunduppgifter i testkod; använd syntetiska UUID:n i exemplen.

Se guiden om publikt API och webhooks (Markdown-fil, AI-agentvenlig) för aktuellt kontrakt.

Skickar mark-as-sent ett mejl? Aldrig. Det registrerar att en extern kanal levererat fakturan och stoppar ett väntande automatiskt fakturamejl. Använd den separata utskicksåtgärden om Alunta ska skicka mejlet.

Flyttar mark-as-paid pengar? Nej. Det registrerar en manuell betalning; det är ingen ny kortdebitering.

Kan krediteringen vara partiell? Ja. Använd den dokumenterade åtgärden för att kreditera fakturarader och läs tillbaka statusen innan du visar den som slutförd.

Håll statusar åtskilda i integrationen

En förhandsgranskning kan visa användaren vad som kommer att faktureras innan ett slutligt dokument finns. En PDF ger samma uppgifter i ett format som kan godkännas eller arkiveras. När fakturan finns registrerar mark-as-sent arbetsflödet. Om integrationen även måste skicka dokumentet ska den använda den dokumenterade utskicksåtgärden och hantera det svaret separat.

På samma sätt är mark-as-paid en manuell registrering. Använd den endast när en användare eller en avstämd extern källa bekräftat betalningen. Härled inte ett betalningsanrop från en lyckad förhandsgranskning eller utskicksstatus. Kreditering av valda rader ändrar fordran via en kreditåtgärd; den tar inte bort originalfakturan och är inte automatiskt en kontantåterbetalning. mark-as-sent skickar aldrig e-post, inte ens efter att fakturan har slutförts; åtgärden blockerar den väntande automatiska leveransen.

Använd fakturans UUID för uppföljningsanrop och läs den aktuella statusen efter varje åtgärd. Om svaret är väntande visar du väntande i stället för slutförd. Då kan användaren kontrollera integrationens nästa resultat utan att upprepa en redan registrerad åtgärd.