Order Types Built
An order type is the policy a sale order follows: which discounts it may carry and how much, whether it must be paid before despatch, and what it needs before it can be submitted to HO.
What an order type does
Every sale order has exactly one type, chosen when the order is keyed. The type is checked at three points:
- Discounts, on every line. The strictest of the salesperson's, the product's and the type's limit applies. A type cap of 0 % means the type adds no cap of its own.
- Payment, at HO approval and release. A type that doesn't require payment (COD, free supply) lets HO approve and release with nothing paid. The per-line minimum payment % holds a delivery move back until that share of the line is paid; the stricter of the type's and the product's minimum applies — On Credit and no-payment types (COD, free supply) ignore the product's minimum.
- Requirements, at Submit to HO. A parent order, an attachment, a business associate, the customer's GSTIN, and — for free supply — every line discounted to ₹0. A type with the code
CODalso needs an order total above ₹0. - Customer confirmation, at the first Submit to HO. A type can email and/or text the customer "Order SO-… received for 3 item(s). We'll confirm despatch separately."
What this means for the people keying orders is described in Sale Orders → Order types.
Where to find it & who can see it
Open Sales › Order Types in the left navigation.
Columns
| Column | Shows |
|---|---|
| Code | The type's stable key, as a badge. Searchable. |
| Name | What people see on the order. Searchable, sortable; the list's default sort. |
| Active | Only active types are offered on new orders. |
| Free supply | Free-of-charge supply — see below. |
| Payment required | Whether the order must be paid (or have approved credit) before HO approval and release. |
| Discount caps | A summary such as "Party 10 % · BA none · Special 15 % · Overall 20 %". "none" = the tier isn't allowed; a tier at 0 % is left out; "No type caps" = the type adds none; free-supply types show "Exempt (free supply)". |
Create or edit a type
Select New order type, or row Edit. The form has four sections.
- Identity
Field Required Notes Code Yes Unique, up to 50 characters. Fixed once created — the system finds some types by code ( standardis the default for new orders).Name Yes Unique. Description No When the type is used. Active No On by default. Switch off to retire the type: it stops being offered on new orders (the app and the API refuse it too); existing orders keep it. Standard can't be switched off — new orders fall back to it. - Discount policy
Field Notes Allow party / BA / special discount A tier that is off can't be used on this type's orders at any amount. Max party / BA / special discount 0–100 %, per line and tier. 0 = no type cap. Max overall discount (per line) 0–100 %, caps party + BA + special together on each line. 0 = no type cap. - Payment
Field Notes Require payment allocation On: the order must be paid, or have approved credit, before HO approval and release. Off: nothing needs to be paid (COD, free supply). Min payment per line 0–100 %. A delivery move is held until this share of its line is paid. The stricter of this and the product's minimum applies — except on On Credit and no-payment types (COD, free supply), which ignore the product's minimum and use only this. Min payment for the whole order 0–100 %. Only when payment allocation is required: the order's delivery moves are held until this share of the whole order is paid. The stricter of this and the product's whole-order minimum applies. Ignored on types that don't require payment. Free supply The order is given free of charge: no discount limit applies (the salesperson's and the product's included) and every line is priced at ₹0 automatically (its whole value on the special discount; checked again at Submit to HO). A free-supply type can't require payment allocation — saving with both on shows "A free-supply order type cannot require payment allocation." on the field. Free-supply orders also need a free-supply approval at HO. Re-send order For orders that re-send undelivered or returned goods. Their items skip the order-line credit check at reservation (the goods were already paid for or counted on the original order). The other holds still apply. On credit (November 2026) At Submit to HO the order's unpaid balance goes on credit by itself — approved within the salesperson's yearly credit limit and the customer's credit limit, the rest left pending for HO. Keep Require payment allocation on (settlement is checked through the credit) and the minimum payment percentages at 0. Can't be combined with Free supply. - Requirements
Checked when the order is submitted to HO.
Field Notes Requires a parent order The order must be linked to a parent order of the same customer. On the order form the parent picker then shows straight away, marked required. Requires an attachment At least one file on the order, e.g. the approval letter — uploaded on the order's Controls tab or from the field app. Requires a business associate The order must name a business associate (bookseller) — another customer than the one invoiced. Off on every delivered type. Requires the customer's GSTIN The order's customer must have a valid 15-character GST registration number on their customer record. Off on every delivered type — turn it on for the types AIR invoices to GST-registered buyers. HO can waive it for one order with a GST registration override. - Customer confirmation
Tells the customer their order has reached HO.
Field Notes Email the customer Emails the order's customer "Order SO-… received for n item(s). We'll confirm despatch separately." (n = the number of lines). On for New Subscription only as delivered. Text the customer The same message by SMS. Off on every delivered type. It is sent once, when the order is first submitted to HO — not when the draft is created, because a new draft has no lines yet. An order that HO resets to draft and the salesperson submits again doesn't send it a second time. It goes to the customer's primary email / phone; a customer who has turned email or SMS off in their notification preferences doesn't get it on that channel. If sending fails, the submit still goes through.
Changes apply to new orders; existing orders keep the rules they were created with. An order copies its type's rules (caps, payment, minimum payment % per line and for the whole order, requirements, business associate, GSTIN, free supply, customer confirmation) when it is created, and again only if its type is changed while it is still a draft. Resetting an order to draft doesn't pick up the new rules — change its type to do that.
The delivered types
| Code | Name | Caps (party / BA / special / overall) | Payment required | Free supply | Other |
|---|---|---|---|---|---|
standard | Standard | 0 / 0 / 0 / 0 (no type caps) | Yes | No | Default for new orders |
NEW | New Subscription | 10 / 5 / 15 / 20 | Yes | No | Emails the customer a confirmation at the first submit to HO |
RENEWAL | Renewal | 10 / 5 / 15 / 20 | Yes | No | |
CREDIT | On Credit | 10 / 5 / 15 / 20 | Yes (settled through credit) | No | On credit on: at submit the unpaid balance goes on credit automatically (within the salesperson's yearly limit; the rest waits for HO). Minimum payments 0 % — see On Credit |
COD | COD | 0 / 0 / 0 / 0 | No | No | Order total must be above ₹0 (the code is what marks an order as COD — keep it) |
FREE | Free Supply | exempt | No | Yes | |
COMPLIMENTARY | Complimentary Copy | exempt | No | Yes | Attachment required (approval letter) |
Deleting a type
Row Delete (and Delete on the edit page) is offered only while no order uses the type — cancelled and deleted orders count. Once a type has been used, switch Active off instead. Standard can never be deleted. Deletion is permanent.
Anyone who can create an order can choose FREE or COD — order types carry no permission of their own. A free-supply order needs no payment and no discount approval, so HO approval is the only check; the Approve dialog warns about it.
Related pages
Sale Orders → Order types for what each rule means when keying and approving an order; Discounts, Refunds & Charges for the salesperson and product discount limits the type caps combine with; Attachments for the field-app upload API.