Quotes

Create a quote

Creates a new quote owned by the authenticated user's company. Server-managed fields (id, company_id, created_by, seq_number, status, all timestamps, totals) are filled in automatically. Status starts as waiting. Line items are not accepted at creation time.

Foreign-key references in the body (customer_id, vehicle_id, work_category_id) must resolve to resources owned by the authenticated user's company. Unreachable refs return 422 parameter_invalid pointing at the offending field.

post/v1/quotes

Request

  • Base URL: https://api.officina.it
  • URL: https://api.officina.it/v1/quotes
  • Auth: HTTP bearer

Request body

customer_idstring required
vehicle_idstring nullable
titlestring nullable
commentsstring nullable
internal_commentsstring nullable
work_category_idstring nullable

Single-category form, accepted in every revision: the document's only category. To set several, send work_category_ids instead (not both).

work_category_idsstring[]

The document's work categories, in the order chosen (work_category_id in responses reports the first). Trimmed and de-duplicated (first occurrence wins); at most 10, each one of the company's categories (GET /v1/work-categories) — an unknown id is reported on /work_category_ids/{i}. Do not send together with work_category_id: both → 422 parameter_invalid. Available since revision 2026-10-03.

kmnumber nullable

Response

Quote created.

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.