Quotes

Apply the waste-disposal charge

Appends the charge line — quantity 1 at the previewed amount, unit lav, the company's default VAT rate (its first enabled one), last position — recomputes the totals and returns the updated document (as the line-items batch does).

The rules are re-checked server-side and the line is written in one transaction holding the document's row lock, so concurrent calls run one after the other and add the line once. When the charge can't be applied the response is 409 waste_disposal_not_applicable with error.reason (disabled, already_applied, nothing_to_charge, and on worksheets fully_paid).

post/v1/quotes/{id}/waste-disposal

Request

  • Base URL: https://api.officina.it
  • URL: https://api.officina.it/v1/quotes/{id}/waste-disposal
  • Auth: HTTP bearer

Response

Line added. Returns the updated document (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.