Bogfør faktura

POST /v1/invoices/{id}/book

Bogfører en kladde, så den bliver en rigtig faktura med nummer.

Parametre

id

intpåkrævet

Kladdens id, i adressen.

Sådan virker det

Fakturaen får det næste nummer i virksomhedens serie og bliver bogført i regnskabet. Numre kan ikke vælges og har ingen huller.

Bankoplysningerne på fakturaen tages fra virksomhedens seneste faktura. Har virksomheden ingen bankoplysninger endnu, svarer API'et 409 conflict.

Fakturadatoen skal ligge i et åbent regnskabsår, ellers svarer API'et 422.

Svar

200 med fakturaen, nu med number og public_url. Id'et er det samme som kladdens.

Efter bogført

Når fakturaen er bogført, kan den ikke længere redigeres eller slettes. API'et svarer 409 conflict.

Forespørgsel

curl -X POST https://api.tomin.dk/v1/invoices/3394/book \
  -H "Authorization: Bearer tomin_..."

Svar 200

{
  "data": {
    "id": 3394,
    "number": 1043,
    "status": "approved",
    "date": "2026-11-03",
    "payment_terms_days": 14,
    "due_date": "2026-11-17",
    "overdue": false,
    "order_reference": "PO-77",
    "vat_zone": "domestic",
    "currency": "DKK",
    "exchange_rate": 1,
    "customer": {
      "id": 812,
      "number": 1042,
      "name": "Hansen VVS ApS",
      "cvr": "12345678",
      "ean": null,
      "email": "faktura@hansen.dk",
      "phone": null,
      "attention": null,
      "address": "Lagervej 4",
      "zip": "8000",
      "city": "Aarhus C",
      "country": "Danmark"
    },
    "lines": [
      {
        "product_id": null,
        "name": "Konsulenttime",
        "description": null,
        "quantity": 3,
        "unit": { "id": 1, "name": "stk" },
        "price": 1000,
        "discount": 0,
        "total": 3000,
        "group_id": null,
        "account_number": 1010,
        "vat_rate": 25
      }
    ],
    "subtotal": 3000,
    "vat": 750,
    "total": 3750,
    "remaining": 3750,
    "public_url": "https://app.tomin.dk/invoice/o9ZuMPkesZLY3EU1Yx7S",
    "created_at": "2026-11-03T07:12:00Z",
    "updated_at": "2026-11-03T07:12:00Z",
    "self": "https://api.tomin.dk/v1/invoices/3394"
  }
}

Svar 409

{
  "error": {
    "code": "conflict",
    "message": "The invoice is booked and can no longer be changed. Correct it with a credit note."
  }
}