Update Draft Invoice
PUT /invoices/{id}
PUT
/invoices/{id}
Update an existing invoice. Requires the invoice:create scope. Only invoices in draft state can be updated. Accepts the same payload as Create Invoice. Optionally set calculate_totals.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” id
required
string
uuid
required
string format: uuid
The UUID of the draft invoice to update.
Request Body required
Section titled “Request Body required ” StoreInvoiceRequest
object
calculate_totals
boolean
business_entity_id
string | null format: uuid
related_invoice_id
string | null format: uuid
header
object
specification
string | null
business_process
string | null
invoice_number
string | null
invoice_type_code
string | null
issue_date
string | null format: date-time
due_date
string | null format: date-time
tax_point_date
string | null format: date-time
currency
string | null
vat_currency
string | null
accounting_cost
string | null
buyer_reference
string | null
project_reference
string | null
contract_reference
string | null
tender_or_lot_reference
string | null
rounding_amount
integer | null
notes
array | null
invoice_period
object
start_date
string | null format: date-time
end_date
string | null format: date-time
description
string | null
seller
object
endpoint_id
object
scheme
string | null
value
string | null
identifiers
array | null
object
scheme
string | null
value
string | null
name
string | null
legal_name
string | null
trading_name
string | null
company_id
object
scheme
string | null
value
string | null
vat_number
string | null
tax_registration_id
object
scheme
string | null
value
string | null
legal_information
string | null
address
object
street
string | null
additional_line
string | null
city
string | null
subdivision
string | null
postal_code
string | null
country
string | null
contact
object
name
string | null
phone
string | null
email
string | null format: email
buyer
required
object
endpoint_id
object
scheme
string | null
value
string | null
identifiers
array | null
object
scheme
string | null
value
string | null
name
required
string
legal_name
string | null
trading_name
string | null
company_id
object
scheme
string | null
value
string | null
vat_number
string | null
tax_registration_id
object
scheme
string | null
value
string | null
address
object
street
string | null
additional_line
string | null
city
string | null
subdivision
string | null
postal_code
string | null
country
string | null
contact
object
name
string | null
phone
string | null
email
string | null format: email
payee
object
name
string | null
company_id
object
scheme
string | null
value
string | null
payment
object
terms
string | null
payments
Multiple payments
array | null
object
means_code
string | null
means_text
string | null
payment_id
string | null
bank_accounts
array | null
object
iban
string | null
bic
string | null
account_name
string | null
card
object
pan
string | null
network
string | null
holder_name
string | null
direct_debit
object
mandate_id
string | null
debited_account
string | null
means_code
Legacy single payment (backwards compatible)
string | null
means_text
string | null
payment_id
string | null
bank_account
object
iban
string | null
bic
string | null
account_name
string | null
card
object
pan
string | null
network
string | null
holder_name
string | null
direct_debit
object
mandate_id
string | null
debited_account
string | null
delivery
object
date
string | null format: date-time
location_id
string | null
party_name
string | null
address
object
street
string | null
additional_line
string | null
city
string | null
subdivision
string | null
postal_code
string | null
country
string | null
references
object
purchase_order
string | null
sales_order
string | null
preceding_invoices
array | null
object
number
string | null
issue_date
string | null format: date-time
totals
object
line_extension_amount
integer | null
tax_exclusive_amount
Sum of line totals (in cents)
integer | null
tax_inclusive_amount
Before tax
integer | null
tax_amount
After tax
integer | null
allowance_total_amount
integer | null
charge_total_amount
integer | null
paid_amount
integer | null
payable_rounding_amount
integer | null
payable_amount
integer | null
items
required
Array<object>
object
id
string | null
name
required
string
description
string | null
note
string | null
price
required
integer
quantity
required
Price in cents
number
unit_code
string | null
base_quantity
number | null
tax_rate
number | null
tax_category
string | null
tax_exemption_reason_code
string | null
tax_exemption_reason
string | null
order_line_reference
string | null
accounting_cost
string | null
origin_country
string | null
period
object
start_date
string | null format: date-time
end_date
string | null format: date-time
identifiers
Item identifiers
object
standard
object
scheme
string | null
value
string | null
sellers_item_id
string | null
buyers_item_id
string | null
classifications
Item classification
array | null
object
list_id
string | null
list_version
string | null
value
string | null
attributes
Item attributes
array | null
object
name
string | null
value
string | null
allowances
Line allowances
array | null
object
reason
string | null
reason_code
string | null
amount
integer | null
percentage
number | null
base_amount
integer | null
charges
Line charges
array | null
object
reason
string | null
reason_code
string | null
amount
integer | null
percentage
number | null
base_amount
integer | null
allowances
array | null
object
reason
string | null
reason_code
string | null
amount
integer | null
percentage
number | null
base_amount
integer | null
tax_category
string | null
tax_rate
number | null
tax_exemption_reason_code
string | null
tax_exemption_reason
string | null
charges
array | null
object
reason
string | null
reason_code
string | null
amount
integer | null
percentage
number | null
base_amount
integer | null
tax_category
string | null
tax_rate
number | null
tax_exemption_reason_code
string | null
tax_exemption_reason
string | null
tax_breakdown
array | null
object
category_code
string | null
rate
number | null
taxable_amount
integer | null
tax_amount
integer | null
exemption_reason
string | null
exemption_reason_code
string | null
attachments
array | null
object
filename
string | null
mime_type
string | null
description
string | null
data
string | null
external_reference
Base64 encoded
string | null
Responses
Section titled “ Responses ”Invoice updated successfully.
object
data
required
InvoiceResource
object
id
required
Unique invoice identifier (UUID).
string
company_id
required
UUID of the company that owns this invoice.
string
user_id
required
UUID of the user who created the invoice, if applicable.
string | null
state
required
Current workflow state: draft, approved, sending, sent, delivered, failed, or cancelled.
string
direction
required
Invoice direction: outgoing (sent by company) or incoming (received).
string
amount
required
Invoice total amount in cents.
integer
currency
required
ISO 4217 currency code (e.g. EUR, USD).
string
ubl_version
required
UBL specification version used. Peppol BIS 3.0 binds to UBL 2.1.
string
ubl_json
required
Full invoice data in structured UBL JSON format (header, seller, buyer, items, totals, etc.).
object | null
metadata_json
required
Additional metadata such as delivery details, error info, or processing history.
object | null
delivery_network_id
required
Delivery network used: peppol, ksef, or email.
string | null
business_entity_id
required
UUID of the business entity (seller identity) used for this invoice.
string | null
related_invoice_id
required
string | null
payment_status
required
string
total_paid_cents
required
integer
is_test
required
boolean
created_at
required
ISO 8601 timestamp when the invoice was created.
string
updated_at
required
ISO 8601 timestamp when the invoice was last updated.
string
deleted_at
required
ISO 8601 timestamp when the invoice was soft-deleted, or null.
string | null
Invoice not found or does not belong to your company.
object
message
required
string
Invoice is not in draft state, validation error, or API key not associated with a company.
Server error during invoice update.
object
success
required
boolean
message
required
string
data
required
null
errors
required
null