Invoicing · 9 min · 2026-11-07

How to issue automatic credit notes on Shopify with InvoiceXpress, Moloni or Vendus

Shopify processes the refund but issues no credit note. Why invoicing apps fail here, the hard cases of partial refunds and how to automate safely.

Credit noteShopify refundsInvoiceXpressMoloniVendus

Summary

What matters before moving forward.

  • A Shopify refund returns the money but creates no tax document. In Portugal, the certified invoice has to be corrected with a credit note linked to it.
  • Several invoicing apps for Shopify issue the invoice and do not handle the refund. Some stores pay developers just to build this part.
  • In InvoiceXpress, a credit note requires the number and series of the original document. Without storing that link when the invoice is issued, automation is impossible.
  • The hard case is the amount-only refund: Shopify allows refunding a free amount, but the credit note needs lines and VAT rates.
  • Shipping, items at different VAT rates and discounts already applied change the value of each credit note line. That is where the numbers stop matching.

A refund is not a tax document

When you refund an order in Shopify, the money goes back to the customer and the order is marked as refunded. From a tax point of view nothing happened: the certified invoice is still issued for the full amount.

A certified invoice cannot be deleted or edited. The only way to correct it is to issue a credit note that references it, in full or in part. If the credit note is not issued, the sales reported to the Tax Authority and the VAT charged stay above what the store actually invoiced.

In stores with few returns this is fixed by hand at month end. In stores with volume, especially fashion, the pile of refunds without credit notes grows every week and ends up on the accountant's desk.

Why invoicing apps do not solve it

Most invoicing apps for Shopify were designed around one event: order paid, issue invoice. A refund is a different event with more variations, and many apps simply do not handle it.

The clearest signal comes from the market. A store using InvoiceXpress posted a request on the Make forum in October 2025 to automate credit notes from returns, partial refunds and the Loop Returns app, because the app it used issued invoices but not credit notes. In June 2026 it was still receiving proposals, one of them for 799 dollars for a single refund type.

On the invoicing side the capability exists. The InvoiceXpress API creates credit notes through the same request as invoices, and the Vendus API supports credit notes. What is missing is the bridge between the Shopify refund and the right document.

The link that has to exist from the invoice

In InvoiceXpress, creating a credit note requires the number and series of the original document. It sounds obvious and it is where many automations fail: the invoice was issued by one app, the refund is handled by another, and neither stored which invoice belongs to which order.

The first rule of credit note automation therefore comes before the refund. When the invoice is issued, its number and series must be stored on the Shopify order, for example in a metafield. Without that, every credit note forces someone to look up the invoice by hand.

The hard cases of partial refunds

Item refunds. The customer returns one of three items. Shopify records the refunded line and quantity, and the credit note must credit exactly that line, at the price actually paid and not the list price.

Discounts already applied. If the order had a 10% coupon on the total, the discount was spread across the lines. The credit note has to use the line value after the discount, otherwise it returns more VAT than was charged. Shopify exposes that per line allocation in the API, but it has to be read.

Amount-only refunds. Shopify lets you return a free amount, for example 5 euros as compensation for a delay, without naming items. The credit note, however, needs lines and VAT rates. If the order only has items at 23%, the decision is simple; if it mixes rates, you need a rule agreed with your accountant to split the amount.

Shipping. Refunding shipping is another line. In Portugal, shipping follows the VAT rate of the goods shipped, so the shipping credit note must follow the same logic as the invoice.

Refund, return and restock are three different things

It is common to treat these three steps as one. They are not. You can refund without getting the item back (a damaged item the customer keeps), receive the item and refund only after inspection, or exchange without any refund.

The credit note follows the money returned, not the item received. An exchange for another size may need no credit note at all, or a credit note and a new invoice, depending on the price difference and how your accountant prefers to handle it.

Good automation starts with a map of these cases, written with your accountant, before a single line of code.

How Vokzar automates credit notes

We first make sure each order is linked to the number and series of its invoice. Then we connect the Shopify refund event to your invoicing software, whether InvoiceXpress, Moloni, Vendus or TOConline.

For each refund type, items, free amount, shipping and exchanges, we agree with your accountant on the calculation rule, including how discounts and VAT rates are split. The credit note goes out with the right lines and values, linked to the right invoice.

Cases outside the rules go to a review list instead of producing wrong documents. At the end of each month, a simple report confirms that every Shopify refund has its credit note.

Related next steps

Next steps.

Proof and validation

  • The public request to automate InvoiceXpress credit notes is on the Make community forum, posted in October 2025.
  • The requirement for the original document number and series comes from the InvoiceXpress FAQ.
  • The shipping rule summarises article 16(5)(b) of the Portuguese VAT Code. Splitting in mixed rate orders should be confirmed with your accountant.

Official documentation

Validated sources.

Technical strategy should be auditable. These sources link directly to the official documentation behind this guide.

Frequently asked questions

Common questions about this topic.

Does Shopify issue credit notes?

No. Shopify records the refund and returns the money, but it does not issue certified tax documents. The credit note must be issued in your invoicing software, linked to the original invoice.

What data do I need to issue a credit note in InvoiceXpress?

The number and series of the original document are mandatory. So the automation only works if that link is stored on the order when the invoice is issued.

How do I handle a partial refund with a discount?

The credit note must use the line value after the allocated discount, not the list price. Otherwise it returns more VAT than was charged.

Does a size exchange need a credit note?

It depends on the price difference and how your accountant prefers to handle exchanges. The credit note follows the money returned, not the item received.

Want to apply this to your site?

Next step Technical audit