Basic Information

appmixer.zoho.books.CreateSalesOrder

Create Sales Order

1.0.0

Public

Create a sales order for a customer in Zoho Books.

Input Ports

in

FieldTypeDescription
Organization ID text Select the organization, or enter its ID. When empty, the default organization of the connected account is used.
Customer ID text ID of the customer the sales order is for.
Line Items textarea Line items as a JSON array of objects. Use item_id to reference an existing item, or set name/description, rate and quantity directly. Example: [{"item_id": "460000000017088", "quantity": 2}, {"description": "Consulting", "rate": 120, "quantity": 1}]. See the Zoho Books API docs for all line item fields.
Sales Order Number text Number of the sales order. Required only when Ignore Auto Number Generation is on; otherwise Zoho Books numbers the sales order.
Reference Number text Your reference for the order, e.g. the order number in your store.
Date date-time Date of the sales order. Defaults to today.
Shipment Date date-time Expected shipment date.
Currency ID text ID of the currency of the sales order. Defaults to the customer's currency.
Exchange Rate number Exchange rate of the currency.
Discount text Discount on the sales order, as a percentage (12.5%) or an amount (190).
Discount Type select Whether the discount applies to the whole order or per line item.
Discount Before Tax toggle Apply the discount before tax is calculated.
Rates Include Tax toggle Line item rates include tax.
Delivery Method text Delivery method of the order, e.g. Courier.
Salesperson Name text Name of the salesperson.
Estimate ID text ID of the estimate the sales order is created from. Zoho Books converts only accepted estimates.
Notes textarea Notes shown on the sales order.
Terms textarea Terms and conditions shown on the sales order.
Shipping Charge number Shipping charge added to the order.
Adjustment number Amount added to or subtracted from the total, e.g. for rounding.
Adjustment Description text Description of the adjustment, e.g. Rounding off.
Custom Fields textarea Custom fields as a JSON array. Example: [{"customfield_id": "460000000639129", "value": "Web shop"}].
Ignore Auto Number Generation toggle Use the Sales Order Number you set instead of the automatic number.

Output Ports

out

FieldTypeDescription
Sales Order ID string -
Sales Order Number string -
Date string -
Shipment Date string -
Reference Number string -
Status string -
Customer ID string -
Customer Name string -
Currency Code string -
Delivery Method string -
Sub Total number -
Tax Total number -
Total number -
Line Items array -
Notes string -
Terms string -
Salesperson Name string -
Created Time string -
Last Modified Time string -

Full Metadata