Quotes

Retrieve a quote by number

Returns the quote carrying number number in year year (the year of its document date) — the number shown in the app, e.g. 12/2026.

The response is identical to GET /v1/quotes/{id}. A number that matches more than one document (repeated in historical data) returns 409 ambiguous_number with their ids in candidates.

get/v1/quotes/by-number/{year}/{number}

Request

  • Base URL: https://api.officina.it
  • URL: https://api.officina.it/v1/quotes/by-number/{year}/{number}
  • Auth: HTTP bearer

Response

The quote, exactly as retrieving it by id returns it.

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.