Zync Docs
Orders & Accounting

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:

  1. Click Auto-detect from recent orders.
  2. 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.
  3. Check each row and change the Zoho tax where needed.
  4. 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

ColumnMeaning
Shopify taxThe tax title as Shopify records it
RateThe rate the row applies to. any rate matches the title at every rate
Zoho taxThe Zoho tax or tax group to use
FallbackSelect 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 taxRateZoho tax
CGST + SGST18%GST18 (tax group)
IGST18%IGST18

Map the combined row to the matching Zoho tax group.

Options

OptionDefaultWhat it does
When a tax is not mapped, pick or create a Zoho tax with the same percentageOnOff: an unmapped tax is left off the line, and the reason is written to the job log
Send the tax Shopify charged on shippingOffApplies the mapped tax to the shipping charge as well
Send an explicit zero tax on untaxed linesOffSends 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:

  1. A row with the same title and rate.
  2. A row with the same title and any rate.
  3. The Fallback row.
  4. A Zoho tax with the same percentage, picked or created (when that option is on).
  5. 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.