Create quotation line

Creates a new line in a quotation.

Line Types

TypeDescription
normalStandard product/service line with pricing
titleSection header (no pricing, just title)
subtotalSubtotal line that sums previous lines

Body Fields

FieldTypeRequiredDescription
quotationobjectYesQuotation: {"id": <quotation_id>}
taxobjectYesTax rate: {"id": <tax_id>}
lineTypestringYesLine type: normal, title, or subtotal
titlestringNoSection title (for title lines)
productTitlestringNoCustom product title
descriptionstringNoLine description (HTML supported)
quantityfloatNoQuantity (default: 1)
unitPricefloatNoUnit price excl. tax (default: 0)
coeffloatNoCoefficient/multiplier (default: 1)
weightintegerYesSort order/position
discountfloatNoDiscount value (default: 0)
discountTypestringNopercentage or amount (default: percentage)
optionbooleanNoMark as optional line (default: false)
hidebooleanNoHide from output (default: false)
productobjectNoLink to product: {"id": <product_id>}
productPriceobjectNoLink to product price: {"id": <product_price_id>}
unityobjectNoUnit of measure: {"id": <unity_id>}
parentobjectNoParent line: {"id": <line_id>}
mediasarrayNoMedia files: [{"id": <media_id>}, ...]
customFieldsobjectNoCustom field values
subTotalConfigobjectNoSubtotal configuration (for subtotal lines)

Pricing Calculation

The totalHt and totalTtc are automatically calculated:

baseTotal = unitPrice × quantity × coef
totalHt = baseTotal - discount (or baseTotal × (1 - discount/100) for percentage)
totalTtc = totalHt × (1 + taxRate)

Response

  • 201 Created: Quotation line successfully created
  • 400 Bad Request: Invalid request body or validation error
  • 401 Unauthorized: Invalid or missing API key
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
quotation
object
tax
object
string
string
string
integer
number
integer
integer
integer
string
boolean
boolean
unity
object
Responses
201

Resource created

400

Bad request

401

Unauthorized

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here!