Quotes

Mutate quote line items in a batch

Adds, updates, removes, and reorders the quote's line items in a single atomic diff, then returns the full quote with recomputed totals and the updated line_items array. The top-level quote PATCH is metadata-only; all line-item mutation flows through this endpoint. Identical wire shape to the worksheet batch endpoint.

Operations (all arrays optional; empty body is a no-op): add, update (full replace by id), remove (by id), reorder. An id may appear in at most one of remove/update/reorder. As with worksheets, update is a remove+add internally so an updated line receives a NEW id; tax_rate is resolved server-side from vat_code.

Quotes are estimates — there is no invoice-freeze rule and article references on lines do not move inventory stock (they are validated for ownership only).

post/v1/quotes/{id}/line-items/batch

Request

  • Base URL: https://api.officina.it
  • URL: https://api.officina.it/v1/quotes/{id}/line-items/batch
  • Auth: HTTP bearer

Request body

removestring[]

Ids of line items to delete.

Response

Batch applied. Returns the updated quote (with line_items).

object'quote' required
idstring required
seq_numberinteger required
status'waiting' | 'accepted' | 'rejected' required
titlestring nullable
commentsstring nullable
internal_commentsstring nullable
customer_idstring required
customer_namestring required
vehicle_idstring nullable
vehicle_namestring nullable
vehicle_licensestring nullable
work_category_idstring nullable
work_category_namestring nullable
work_category_idsstring[] required

Every work category ("categoria") of the document, in the order chosen. work_category_id (kept for clients that handle a single category) always equals the first. [] when the document has none, never null. Available since revision 2026-10-03.

kmnumber double nullable
worksheet_idstring nullable
worksheet_seq_numberinteger nullable
worksheet_created_atstring date-time nullable
total_before_taxnumber double
total_taxnumber double
total_after_taxnumber double
total_discountnumber double
total_discount_before_taxnumber double
total_after_discountnumber double
total_worknumber double
total_articlesnumber double
hide_discountsboolean
delivered_atstring date-time nullable
created_atstring date-time required
updated_atstring date-time required
archived_atstring date-time nullable
deleted_atstring date-time nullable

Changes

No recorded changes to this operation across all 1 revision of this API.