Documents
Choose whether a Shopify order becomes a Zoho sales order, an invoice or both, and set the defaults for every document.
Open Orders → Documents & Accounting. The first card, Documents, decides what a Shopify order becomes in Zoho, and when.
Create each order as
| Option | What Zync creates | Choose it when |
|---|---|---|
| Sales order | One Zoho sales order per Shopify order | You track orders in Zoho and invoice by hand, or do not need invoices |
| Sales order, then invoice when paid | The sales order at once. The invoice is raised from it once Shopify marks the order paid | You take payment later (COD, bank transfer, terms) |
| Sales order and invoice together | Both, as soon as the order syncs | Orders are paid at checkout and you want the full trail |
| Invoice only | An invoice and no sales order | Sales orders are switched off in your Zoho organisation |
New installs start on Sales order.
When an invoice is raised from a sales order, each invoice line is tied to its sales order line, so Zoho shows the sales order as invoiced.
Save documents as
| Option | Sales order | Invoice |
|---|---|---|
| Draft (review in Zoho first) | Draft | Draft |
| Confirmed (sales order open, invoice sent) | Open | Sent |
Marking an invoice as sent changes its status only. Zoho does not email the customer.
Two cases where Zync confirms a document even on Draft, because Zoho requires it:
- A sales order is confirmed before an invoice is raised from it.
- An invoice is marked sent before a payment is recorded against it.
Only sync orders placed on or after
Optional. Orders placed before this date are skipped. Set it when you move from another connector, so the orders it already sent are not sent again.
A backfill ignores this date, because you choose its dates yourself.
Use the Shopify order number as the Zoho document number
| Setting | Zoho document number |
|---|---|
| Off | Zoho's next number in its own series |
| On | The Shopify order name, for example #1001 |
If Zoho rejects the number (it is already used, or contains a character Zoho does not accept), that one order falls back to Zoho's own numbering and still syncs.
Whatever you choose, the Shopify order name is always stored as the document's reference number, so you can search Zoho for #1001.
Document defaults
| Setting | What it does |
|---|---|
| Show discounts | On each line item puts each line's discount on that line. As one amount on the document shows a single discount for the whole document |
| Default salesperson | Sets the salesperson on every document. Leave empty unless your Zoho organisation requires one. Click the field to pick from your Zoho salespeople |
| Invoice payment terms (days) | 0 means due on receipt, 30 means Net 30. Empty uses the customer's own terms in Zoho |
| Add shipping as a line item | Off: shipping is sent as the document's shipping charge. On: it is added as a line named Shipping - (method) |
| Show the SKU on each line | Adds the Shopify SKU to each line's description |
| Customer notes | Your own text for the notes field. See below |
| Terms and conditions | Text for the terms field. {order_name} and {shop} can be used |
Customer notes template
Leave it empty for the standard note (Shopify Order: #1001, plus the order note and tags if you ticked them in Order settings).
Write your own to replace it. These variables are filled in for each order:
| Variable | Becomes |
|---|---|
{order_name} | The Shopify order name, for example #1001 |
{shop} | Your store name, without .myshopify.com |
{order_note} | The note on the Shopify order |
{tags} | The order's tags, separated by commas |
Example: Web order {order_name} from {shop}. {order_note}
What every document carries
Whichever option you choose, the Zoho document has:
- The customer, as a Zoho contact. See Customers on orders.
- Each line item with quantity and price, matched to a Zoho item. See Items and product mapping.
- Tax on each line. See Tax mapping.
- Shipping, discounts, and the billing and shipping addresses.
- The order date, the currency you chose, and whether prices include tax.
Changing the option later
A change applies to orders that sync from then on. To bring earlier orders up to date, for example to raise invoices for orders that only have a sales order, run a backfill with Only orders that are not in Zoho yet unticked.