Opret faktura

POST /v1/invoices

Opretter en faktura som kladde.

Sådan virker det

En faktura laves i to trin. Først opretter du en kladde, som kan redigeres og slettes. Derefter bogfører du den med Bogfør faktura, og først da får den et fakturanummer.

Kunden, kontoen på hver linje, moms og totaler findes af Tomin. Du sender kun kundens id og linjerne.

Indhold

customer_id

intpåkrævet

Id på en kunde i virksomheden. Kundens oplysninger kopieres ind på fakturaen.

date

datevalgfri

Fakturadato. Skal ligge i et åbent regnskabsår.

Standard i dag

payment_terms_days

intvalgfri

Betalingsfrist i dage.

Interval 1 til 30Standard kundens betalingsfrist

order_reference

stringvalgfri

Kundens ordre- eller rekvisitionsnummer. Bruges på e-fakturaer.

Længde højst 60

vat_zone

stringvalgfri

Momszone. Bestemmer konti og moms på linjerne.

Værdier domesticdomestic_no_vateuforeignStandard kundens momszone

currency

stringvalgfri

Valutakode på tre bogstaver, for eksempel EUR.

Længde 3Standard DKK

Linjer

lines

listpåkrævet

Varelinjerne, i den rækkefølge de skal stå.

Længde 1 til 100

lines[].product_id

intvalgfri

Id på et produkt. Navn, pris, enhed og gruppe hentes fra produktet, når du ikke selv sender dem.

lines[].name

stringvalgfri

Linjens tekst. Påkrævet når der ikke er et product_id.

Længde 1 til 255Standard produktets navn

lines[].quantity

decimalpåkrævet

Antal, for eksempel 2.5 timer.

Interval 0.01 til 1000000Decimaler højst 2

lines[].price

decimalvalgfri

Pris pr. enhed uden moms. Påkrævet når der ikke er et product_id.

Interval 0 til 9999999.99Decimaler højst 2Standard produktets pris

lines[].discount

intvalgfri

Rabat i procent.

Interval 0 til 100Standard 0

lines[].unit_id

intvalgfri

Id fra Hent enheder.

Standard produktets enhed, ellers stk

lines[].group_id

intvalgfri

Id på en produktgruppe. Gruppen bestemmer omsætningskontoen.

Standard produktets gruppe

lines[].description

stringvalgfri

Uddybende tekst. Må have linjeskift.

Længde højst 1000

Svar

201 med kladden. Har et felt en forkert type eller værdi, svarer API'et 422 med details, og intet bliver gemt. Se Typer og validering.