Bogfør kreditnota

POST /v1/credit-notes/{id}/book

Bogfører en kladde og modregner den i fakturaen.

Parametre

id

intpåkrævet

Kladdens id, i adressen.

Sådan virker det

Kreditnotaen får det næste nummer i samme serie som fakturaerne, bliver bogført og modregnet i sin faktura.

Fakturaens status skifter til credited, når hele beløbet er krediteret, og ellers til partially_paid.

Svar

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

Efter bogført

Når kreditnotaen 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/credit-notes/290/book \
  -H "Authorization: Bearer tomin_..."

Svar 200

{
  "data": {
    "id": 290,
    "number": 1044,
    "status": "approved",
    "date": "2026-11-06",
    "invoice_id": 3394,
    "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,
    "public_url": "https://app.tomin.dk/credit-note/EkcOPnDPZzR3WWiLLsp4",
    "created_at": "2026-11-06T09:30:00Z",
    "updated_at": "2026-11-06T09:30:00Z",
    "self": "https://api.tomin.dk/v1/credit-notes/290"
  }
}

Svar 409

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