latestOpenAPI 3.0.0Apache 2.02026-07-2638645559.8 KB

436b47b78bf4

Quotes

Create a quote

Create a new quote with an Organization or a Person. Relationship store notes, metadata and accounting settings parameters

post/apps/{appId}/quotes

Path parameters

appIdinteger required

The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have several Sinao applications. To retrieve the identifiers of its applications, you must call the endpoint /apps.

Query parameters

idinteger
type'organization' | 'person'
namestring nullable

Customer name obtained from customer object or set manually

addressstring nullable

Customer addresss (street number and address) obtained from customer object or set manually

address2string nullable

Customer address subline obtained from customer object or set manually

locationstring nullable

Customer address location (city, postal code and country) obtained from customer object or set manually

detailsstring nullable
idinteger
type'organization' | 'person'
namestring nullable

Third account name obtained from customer object or set manually

addressstring nullable

Third account addresss (street number and address) obtained from customer object or set manually

locationstring nullable

Third account address location (city, postal code and country) obtained from customer object or set manually

titlestring
idinteger
detailstring

Description of the product or service

action'sell' | 'rent'
quantitynumber double

Quantity of product or service

amount_accuratelyinteger

Price without taxes in cents + 3 decimales, example : 9899000 = 98,99€ || 1 = 0,00001€

amount_with_taxesboolean

Used when there is a difference of 1 cent when starting from the amount with taxes

amountinteger

Price without taxes in cents

vat_percentinteger

VAT rate in cents

accountobject
unitystring

Unity, hours, days, meters, liters..

total_quantitystring

Information about total quantity to sell, only for display

designationstring
quantitystring
quantity_namestring
info_total_quantitystring
amountstring
subtotalstring
duestring
vat_percentstring
discountstring

List columns to display

referencestring

Free variable not display in document

namestring
amountinteger
percentinteger
currencystring
legal_noticestring

Legal mentions

bank_details_idinteger nullable
exemptedboolean
reasonstring
articlestring
{"stackTrail":"paths:/apps/{appId}/quotes:post:parameters:12:schema:items","oasType":"schema","type":"unknown"}
metadatastring[] nullable
amountinteger

Use downpayment request value for fix downpayment

percentinteger

Use downpayment request in percent for variable downpayment

commercialvalidity_deadlinestring date-time nullable
number_from_other_softwarestring

Invoices imported from another software are not counted in the numbering and are not locked

delivery_addressstring nullable

Delivery address if different from contact_infos address, null otherwise

delivery_address2string nullable

Delivery address subline if different from contact_infos address, null otherwise

delivery_detailsstring nullable

Delivery details

delivery_locationstring nullable

Delivery address location if different from contact_infos address, null otherwise

delivery_establishment_idinteger nullable

Delivery establishment id if different from contact_infos address, null otherwise

delivery_emailstring nullable

Delivery establishment contact email if different from contact_infos address, null otherwise

delivery_namestring nullable

Delivery establishment contact name if different from contact_infos address, null otherwise

delivery_phonestring nullable

Delivery establishment contact phone if different from contact_infos address, null otherwise

Response

Success

Quote required— unresolved $ref