Tax mapping
Choose the Zoho tax each Shopify tax becomes, including GST tax groups, shipping tax and zero-rated lines.
Shopify records a tax title and rate on each order line, for example VAT 20% or CGST 9% + SGST 9%. Zoho needs one of its own taxes on each line. Tax mapping is where you say which Zoho tax each Shopify tax becomes.
Open Orders → Documents & Accounting → Tax mapping.
Tax sync must be on
Tax is sent only when Tax is ticked under Order settings. When it is unticked, this card shows a notice and no tax is sent.
Without any mapping
You do not have to map anything to start. With no mappings, Zync picks a Zoho tax with the same percentage as the Shopify tax, preferring an ordinary tax over a GST-specific one. If none exists, it creates one at that rate.
Map your taxes when the right Zoho tax cannot be told from the rate alone: two Zoho taxes with the same rate, GST tax groups, or taxes that post to different accounts.
Auto-detect from recent orders
The quickest way to fill the table:
- Click Auto-detect from recent orders.
- Zync reads the taxes on your last 100 orders and adds a row for each one, with the Zoho tax of the same rate already selected.
- Check each row and change the Zoho tax where needed.
- Save.
Rows you already have are left alone. If a Shopify tax has no Zoho tax at the same rate, a warning names it. Add the tax in Zoho under Settings → Taxes, then run auto-detect again.
The mapping table
| Column | Meaning |
|---|---|
| Shopify tax | The tax title as Shopify records it |
| Rate | The rate the row applies to. any rate matches the title at every rate |
| Zoho tax | The Zoho tax or tax group to use |
| Fallback | Select one row to use for any Shopify tax that has no row of its own |
To add a row by hand, type the Shopify tax title, the rate as a percentage (or leave it empty for any rate), choose the Zoho tax and click Add mapping.
Several taxes on one line
When Shopify charges more than one tax on a line, the titles are joined with + and the rates are added together. CGST 9% and SGST 9% become one row:
| Shopify tax | Rate | Zoho tax |
|---|---|---|
CGST + SGST | 18% | GST18 (tax group) |
IGST | 18% | IGST18 |
Map the combined row to the matching Zoho tax group.
Options
| Option | Default | What it does |
|---|---|---|
| When a tax is not mapped, pick or create a Zoho tax with the same percentage | On | Off: an unmapped tax is left off the line, and the reason is written to the job log |
| Send the tax Shopify charged on shipping | Off | Applies the mapped tax to the shipping charge as well |
| Send an explicit zero tax on untaxed lines | Off | Sends the tax you choose under Zoho zero-rate tax on lines Shopify did not tax |
Turn on Send an explicit zero tax on untaxed lines if Zoho adds the item's own default tax to orders that Shopify charged no tax on.
How a line's tax is chosen
For each order line, Zync uses the first of these that applies:
- A row with the same title and rate.
- A row with the same title and any rate.
- The Fallback row.
- A Zoho tax with the same percentage, picked or created (when that option is on).
- No tax on the line.
Prices that include tax
If your Shopify prices include tax, the Zoho document is created as tax-inclusive too, so the totals match.
Checking the result
After changing tax settings, run a dry-run backfill on a few orders, or sync one order and compare its total in Zoho with Shopify. Reconcile lists every order whose Zoho total differs from Shopify: a tax that is mapped to the wrong rate shows up there as an amount difference.