New: payments, credit notes, tax mapping and order reconciliation for Zoho Books — see all features
Accounting

Shopify Refunds to Zoho Credit Notes: How Refund Sync Works

A Shopify refund should reduce what the customer owes and what you booked as revenue. See how Zync turns each refund into a Zoho credit note, applies it to the invoice, and records the money paid back.

A refund is an accounting event, not a status change

In Shopify, a refund looks simple. You click a button, the customer gets money back, and the order shows as refunded or partially refunded. In your books it is a real transaction. The invoice you raised for that order now overstates what the customer owes, the revenue you booked is too high, and the tax you recorded on the refunded items is no longer due.

The correct accounting document for that is a credit note. It reduces the invoice, reverses the revenue and tax on the refunded lines, and gives you something to hang the outgoing money on. Creating one by hand for every refund is slow and easy to get wrong, especially for partial refunds. Zync does it from the Shopify refund itself.

What happens in Zoho when an order is refunded

With refund sync on, here is the sequence for each Shopify refund:

  • The app reads the refund from Shopify, including which line items and how much shipping were refunded.
  • It creates one Zoho credit note for the same customer, dated with the day of the refund.
  • It applies the credit note to whatever the order's invoice still owes.
  • If you asked for it, it records the money paid back as a refund on the credit note.
  • It writes a row to Logs and remembers on the Shopify order that this refund is settled.

Refunds are one step in the same sync that handles everything else on an order. The fixed order is documents, then the invoice, then payments, then credit notes, then tracking, then voiding. That ordering matters: by the time a credit note is created, the invoice and any payment against it already exist.

Turn it on

Refund settings live under Orders, on the Documents & Accounting tab, in the section called Refunds, cancellations and fulfilments. Everything in that section describes what happens in Zoho after the order is placed. Orders always flow from Shopify to Zoho.

Tick Create a credit note when an order is refunded. It is off by default.

A credit note needs an invoice to credit, so check the Create each order as setting on the same tab. Sales order, then invoice when paid, Sales order and invoice together, and Invoice only all raise an invoice. The plain Sales order option does not, and refunds on those orders simply wait. If you are deciding between the options, see choosing a document flow.

What goes on the credit note

The credit note is built from the refund, not copied from the invoice. That is what makes partial refunds come out right.

  • Refunded items. Each refunded line item becomes a line on the credit note, with the refunded quantity and a rate worked out from the amount Shopify actually refunded for that line. The line is linked to the same Zoho item the order used.
  • Refunded shipping. If shipping was refunded, it appears as its own line, named after the shipping method.
  • Money-only refunds. A refund with no items and no shipping, for example a goodwill amount, still gets one line carrying the refunded amount.
  • Tax. When tax sync is on, each credit line uses the same Zoho tax the order line used, through the same tax mapping. If the order used tax-inclusive prices, the credit note does too.
  • Notes and reference. The notes say which Shopify order the refund belongs to and include the refund note if staff wrote one. The currency follows your currency setting.

Two edge cases are worth knowing. Refund adjustments that are not line items are noted in the job log and are not itemised on the credit note. And a refund with nothing to credit at all is marked as handled so it is not retried forever.

Product mappings apply to refunds too

If you use Product mapping to send one Shopify SKU to a different Zoho item and quantity, refunds follow the same rule. Refunding one case that maps to 24 cans credits 24 cans, at a rate that keeps the line total equal to what Shopify refunded. Your Zoho item quantities on credit notes stay consistent with the quantities on the original invoice. The mapping itself is explained in mapping case and pack SKUs to Zoho items.

Applying the credit and recording the payout

Creating the credit note is half of the job. It also has to be settled, and there are two places the credit can go.

The first is the invoice. If the invoice still has a balance, the credit is applied to it, up to that balance. This is the unpaid-order case: the customer owed 100, you refunded 30 before they paid, and the invoice now owes 70.

The second is back to the customer. If the invoice was already paid, there is no balance to reduce, and the credit represents money you have returned. Tick Record the money paid back as a refund on the credit note to record that payout in Zoho. A Refund from account picker appears. Choose the account the money leaves from, or keep the default, which is the deposit account of the order's payment gateway. That default pairs naturally with gateway mapping for payments: money that came in through a gateway's account goes back out of the same one.

If you leave the payout option off, any credit that could not be applied to the invoice stays on the credit note as an open balance for you to deal with in Zoho. If you turn the payout option on but no account can be worked out, the credit note is left open and the job log says so.

Several refunds on one order

Shopify lets you refund an order more than once, and each refund is its own event. Zync treats them the same way. Every refund gets its own credit note, and the app tracks each one separately on the Shopify order. Refund a single item today and the shipping next week, and Zoho ends up with two credit notes that together match what Shopify shows.

Cancellations: void instead of credit

A cancelled order is different from a refunded one. If nothing was ever paid, the cleanest result is for the Zoho documents to stop counting altogether. Tick Void the Zoho documents when an order is cancelled and the app voids the invoice and the sales order when Shopify cancels the order. It is off by default.

Two rules keep this honest:

  • An invoice that already has a payment cannot be voided. In that case the Shopify refund is credited instead, through the credit note flow above.
  • Orders cancelled before they ever synced are skipped. There is nothing to void, and no point creating documents only to cancel them.

The same section has one more option, Write the ship date and tracking onto the sales order, which is on by default. It adds each shipment to the sales order notes on its own line and keeps existing notes. It does not create Zoho packages or shipment records.

Why a retry cannot credit twice

Every sync runs as a queued job with up to three attempts and exponential backoff, and one job runs per order at a time. For refunds, each step protects itself:

  • The credit note is created with a reference tied to the Shopify refund. Before creating one, the app searches Zoho for that reference and links the existing credit note if it finds it.
  • Before applying credit or recording a payout, the app re-reads the credit note and the invoice from Zoho and works from their current balances. A lost response cannot cause a second application or a second payout.
  • Each completed step is saved on the Shopify order before the next begins.

If Zoho's API limit is hit midway, the order waits and is queued again instead of failing.

What refund sync does not do

  • It does not itemise refund adjustments that are not line items. Those are noted in the job log for you to review.
  • It does not create anything in Shopify. Refunds flow from Shopify to Zoho only.
  • It does not email the customer.
  • It cannot credit an order that has no invoice.

Next step

Open Orders, go to Documents & Accounting, and tick Create a credit note when an order is refunded. Decide whether you also want the payout recorded, then refund a test order and watch the result in Logs. The field-by-field reference is in the refunds, cancellations and fulfilments documentation, and the refund sync overview shows how it fits with accounting sync. To check that refunded orders still tie out, run the comparison described in reconciling before month-end.

TopicsRefundsCredit NotesZoho BooksAccountingCancellationsOrder Sync
FAQ

Common questions

Does Zync create a Zoho credit note when a Shopify order is refunded?
Yes, when you tick Create a credit note when an order is refunded under Orders, Documents & Accounting. The setting is off by default. Each Shopify refund becomes one credit note.
Do refunds work if my orders sync as sales orders only?
No. A credit note needs an invoice to credit, so refund sync needs a document option that includes an invoice. With the plain Sales order option, refunds wait until an invoice exists.
How are partial refunds handled?
Each refund is handled on its own. A partial refund creates a credit note for just the items, shipping, or amount that was refunded, and a second refund on the same order later creates a second credit note.
Can Zync record the money I paid back to the customer?
Yes. Tick Record the money paid back as a refund on the credit note and choose a Refund from account. If you leave the account empty, the deposit account of the order's payment gateway is used.
What happens when an order is cancelled instead of refunded?
If Void the Zoho documents when an order is cancelled is ticked, the invoice and sales order are voided. An invoice that already has a payment cannot be voided, so its Shopify refund is credited instead.
Will a retry create a duplicate credit note?
No. Each credit note carries a reference tied to the Shopify refund, and the app looks for it in Zoho before creating one. It also re-reads the credit note and the invoice before applying credit or recording a payout.

Connect Shopify and Zoho in an afternoon

Start a free trial, connect your Zoho org, and run a dry-run backfill to see exactly what would land in Zoho. No engineering required.