Replace an invoice

PUT/invoices/{invoice}

Replaces every field of the invoice with the request body, under the same rules as create. Always resend the current invoice_number: when it is omitted the invoice is renumbered from the series counter. Items, payment options and custom fields are rewritten, totals recalculated and the PDF regenerated. Fires the invoice.updated webhook.

Autorizacija

bearerAuth

AutorizacijaBearer <token>

Business token created in the app under Settings, Integrations, API. The token is scoped to exactly one business, has no expiry and is shown only once. Send it as Authorization: Bearer <token> together with Accept: application/json.

Vieta: header

Kelio parametrai

invoice*string

The invoice ID.

Užklausos turinys

application/json

TypeScript tipai

Naudokite request body tipą TypeScript kode.

Body of POST /invoices and PUT /invoices/{invoice}. On update every field is replaced with what you send; always resend invoice_number or the invoice is renumbered.

type*string

Invoice type. The *vat_invoice types require seller.vat_code and vat_percentage on every line.

Reikšmė iš

"regular_invoice"
"vat_invoice"
"preliminary_invoice"
"preliminary_vat_invoice"
"credit_invoice"
"credit_vat_invoice"

invoice_date*string

Issue date.

Formatasdate

pay_until_date?|

Due date.

Formatasdate

series*string

Series code the number belongs to. A new code starts its own counter.

Ilgislength <= 255

notes?|

Free text printed under the lines.

Ilgislength <= 255

currency*string

One of the codes from GET /currencies.

payment_status?|null

language?|

Language of the PDF and the share page. Defaults to lt.

Reikšmė iš

"en"
"lt"
"es"
"de"
"fr"
null

invoice_number?|

Number within the series; must be unique there. Omit on create to auto-number. On update always resend the current number, otherwise the invoice is renumbered from the series counter. Accepts the padded ("007") or unpadded ("7") form; numbers are compared exactly as sent, so use one form consistently within a series.

Atitiktis^(.*)+$

Ilgislength <= 255

buyer*

use_default_seller_info?|

When true the seller block is copied from the business profile (plus the custom fields of the latest invoice) and seller must be omitted.

seller*

Required unless use_default_seller_info is true. Which fields are required depends on the business type: companies send company_name (required) and company_code (optional); individual activities send first_name and last_name (required) and individual_activity_id (optional). Fields of the other kind are rejected.

products*array<>

Invoice lines. Each line carries exactly one of price, total or total_incl_vat.

Elementai1 <= items

payment_options?array<>|

Payment details printed on the invoice.

Atsakymo turinys

`application/json`

curl -X PUT "https://example.com/invoices/string" \  -H "Content-Type: application/json" \  -d '{    "type": "vat_invoice",    "invoice_date": "2026-09-12",    "series": "SF",    "currency": "EUR",    "buyer": {      "type": "company"    },    "seller": {},    "products": [      {        "name": "Consulting",        "units": "h",        "quantity": 2      }    ]  }'

{  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "business_id": "f59fcbb7-848d-4242-af07-a8bb7e3ab37c",    "invoice_type": "regular_invoice",    "series": "string",    "invoice_number": "string",    "invoice_date": "2019-08-24",    "pay_until_date": "2019-08-24",    "language": "en",    "subtotal": 0,    "vat": 0,    "total_incl_vat": 0,    "currency": "string",    "payment_status": "not_paid",    "notes": "string",    "share_link": "http://example.com",    "seller": {      "business_type": "small_partnership",      "first_name": "string",      "last_name": "string",      "company_name": "string",      "company_code": "string",      "individual_activity_id": "string",      "vat_code": "string",      "address": "string",      "email": "string",      "phone": "string",      "custom_fields": [        {          "label": "string",          "value": "string"        }      ]    },    "buyer": {      "type": "company",      "first_name": "string",      "last_name": "string",      "company_name": "string",      "company_code": "string",      "individual_activity_id": "string",      "vat_code": "string",      "address": "string",      "email": "string",      "phone": "string"    },    "items": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "name": "string",        "price": 0,        "vat_percentage": 0,        "quantity": 0,        "units": "string"      }    ],    "payment_options": [      {        "type": "bank",        "bank_account": "string",        "bank_name": "string",        "routing_or_sort_number": "string",        "swift_bic_code": "string",        "fields": [          {            "label": "string",            "value": "string"          }        ]      }    ],    "created_at": 0,    "updated_at": 0  }}

Replace an invoice

Autorizacija

Kelio parametrai

Užklausos turinys

Atsakymo turinys

200application/json

401application/json

403application/json

404application/json

422application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`