New: Rioko now invoices in Moloni ON too, as well as InvoiceXpress, Moloni, Vendus and TOConlinein five invoicing programs. Compare the five programs
All articles
Technical guidesPedro Correia, Rioko team19 September 2026Updated on 17 November 20266 min

Invoicing Shopify Orders in Portugal: The Complete Guide

What Shopify doesn't do alone in Portugal, how to collect the VAT number, when to issue, and how to connect certified software without touching checkout.

Invoicing Shopify Orders in Portugal: The Complete Guide
In short: Shopify does not issue valid invoices in Portugal: every paid order has to produce a document in certified invoicing software, with a series filed with the tax authority and an ATCUD. The essentials are collecting the VAT number, issuing when the order is paid and handling each refund with a credit note.

Shopify is excellent at selling and it does not issue a single valid invoice in Portugal. That is not a flaw: Shopify is not software certified by the tax authority, and as a rule tax documents have to come out of certified invoicing software.

What Shopify produces is an order confirmation: it looks like an invoice, it carries amounts and VAT, and it has no tax value. It has no ATCUD, no QR Code, does not belong to a filed series and does not enter your SAF-T.

This guide is the whole path, from checkout to certified document.

What has to exist before you sell

Three things, in this order:

  1. An account with certified software. For example InvoiceXpress, Moloni, Moloni ON, Vendus or TOConline, the five Rioko connects to. If you are still choosing, there is a comparison of all five.
  2. A series filed with the tax authority, with an ATCUD validation code. Guides per software: InvoiceXpress, Moloni, Vendus and, to connect TOConline, its own guide. If you do not yet have the tax authority sub-user, start by creating it.
  3. A bridge between the shop and that software, turning every paid order into a document.

The classic mistake is doing this in reverse: opening the shop, selling for three months, and only then realising there are no tax documents for that period. Regularising 200 past orders is expensive and never entirely clean.

The path of an order

ShopifyPaid orderRIOKOPayment confirmedIt only enters once it is paid.Buyer and VAT numberFrom the checkout or the customer record.Regime and VATCountry, business or consumer, VIES.Series and typeThe filed series, the right type.Certified softwareIssues the documentThe certified software always issues. Rioko decides what to send it, and refuses to send what it cannot justify.From Shopify to Certified software: what gets decided on the way.

The VAT number in the Shopify checkout

According to Shopify's help, the checkout has its own NIF field for buyers in Portugal, in early access: it is switched on by request, through Shopify support. Until it is on, there are three ways around it, with different results:

ApproachHow it worksLimitation
Extra checkout fieldAn additional field, through a Checkout UI extension or an appCertain checkout positions require Shopify Plus
Order notesThe customer types the number into the notesFree text: it arrives with spaces, dots, "VAT:" in front
Customer recordThe number is stored on the customer and reused on later ordersOnly works from the second purchase onwards

Whichever you use, the number has to be cleaned and validated before it reaches the invoicing software. A number with spaces or letters creates a new, wrong customer in the certified package, and correcting it later means editing the customer record and cancelling and reissuing any document already finalised.

For business customers in other EU countries the number needs its country prefix (ES, FR, DE) and has to pass VIES: see how to invoice EU businesses.

The guide on where to ask for the NIF in the Shopify checkout shows Shopify's own field and where Rioko looks for the NIF.

When to issue: paid, not ordered

An order created is not a sale completed. In Portugal, with Multibanco, MB Way or bank transfer, the order exists long before the money does, and a share of them are never paid.

The sane rule is to invoice when the order's financial status becomes paid. Invoicing on creation produces documents for sales that never happened, and each one has to be undone with a credit note. Once the tax is due, the invoice has to go out by the 5th working day after that (article 36 of the VAT Code).

There are legitimate exceptions: anyone working on credit with business customers issues the invoice and gets paid later. But that is a decision, not a configuration accident. With Shopify B2B companies, the Invoice goes out on order and the Receipt on payment: see Shopify B2B: invoicing sales to companies.

Gift cards are another exception: with a multi-purpose voucher, selling the card carries no VAT and no invoice, and the tax is only due when the card is spent. See Gift cards: single- and multi-purpose vouchers.

Which document type

SituationDocument
Paid at once, customer asked for an invoice with a VAT numberInvoice-receipt (FR)
Paid at once, consumer with no VAT number, retail sale of goods up to €1,000Simplified invoice (FS)
On credit, to be paid laterInvoice (FT), then a Receipt (RC)
Refund or cancellationCredit note (NC)

Each type needs its own filed series. A typical shop needs at least two: sales and credit notes. The limits of each type are in the article invoice, invoice-receipt or simplified.

VAT: what Shopify calculates and what stays yours

Shopify calculates VAT and, configured properly, applies rates by country. If you sell in several currencies with Shopify Markets, see currencies, countries and VAT. The tax document has to come out with exactly the total the customer paid: if the invoicing software recalculates on its own and lands three cents away, the document stops matching the payment.

What remains your responsibility, outside Shopify:

  • Being registered for OSS if you sell above the threshold into the EU (guide).
  • Invoicing EU businesses without VAT, with the VAT number validated in VIES, which Shopify does not do on its own.
  • Carrying the right exemption code on zero-rated lines (table).
  • Shipping: it is part of the sale's taxable amount (article 16 of the VAT Code). In a basket with items at different rates, check the rate to apply with your accountant.

Refunds

A Shopify refund is not a tax document. An invoice already issued is only undone by a credit note, in its own series: the guide From refund to credit note has the full path.

Two distinct situations, and treating them as one is where the accounting drifts:

  • Partial refund: the credit note carries the returned lines, not a lump sum.
  • Full cancellation: the credit note mirrors the entire invoice.

At peak times returns all arrive at once: see what to check before Black Friday.

Shopify app or external bridge

The invoicing apps on the Shopify App Store solve the simple case: Portuguese shop, Portuguese customers, VAT at 23%, no complicated refunds.

Where they typically stop being enough:

  • EU sales with OSS and per-country rates.
  • Business customers with VIES validation.
  • More than one payment source (Shopify and Stripe and manual payments).
  • Automatic credit notes from refunds.
  • Reconciliation: knowing, at month end, that no sale went uninvoiced.

If you invoice in InvoiceXpress, see also the comparison between Xpressifi and Rioko.

How Rioko helps

Rioko connects to the shop by webhook, with no checkout extensions and without touching the theme. When an order becomes paid, the webhook arrives, the buyer and the VAT number are resolved, the VAT regime is decided from the buyer's country and status, and the document comes out in the series you chose, in the invoicing software you already use (InvoiceXpress, Moloni, Moloni ON, Vendus or TOConline).

What is rarely there in the alternatives, and where the time goes:

  • Daily reconciliation. Every morning the period's orders are compared against the documents that exist. An uninvoiced sale shows up in the dashboard instead of being discovered by your accountant in April.
  • No guessing. If VIES does not answer, the sale does not go out at 0%. On connections to InvoiceXpress it is held and retried; on the others it keeps the VAT charged. A late invoice can be sorted out; a wrong certified invoice takes a credit note.
  • Idempotency. The same order is not invoiced twice, even when Shopify repeats the webhook, and it does.

See how it works with Shopify → · Pricing

If a payment ends up without an invoice, see what stops an invoice going out. Before you automate, read what changes between draft and finalised.

Sources

#Shopify#Invoicing#VAT number#E-commerce#ATCUD

Frequently asked questions

Does the Shopify order confirmation count as an invoice?

No. Shopify is not certified by the Portuguese tax authority: the document it produces has no ATCUD, does not belong to a filed series and never enters your SAF-T file.

Where does the customer enter a VAT number in the Shopify checkout?

Shopify has its own NIF field for Portugal, in early access, switched on by request through Shopify support. Without it, it is solved with an extra checkout field, with the order notes, or by storing the number on the customer record. See where to ask for the NIF in the Shopify checkout.

Should I invoice when the order is created or when it is paid?

When it is paid, unless you have decided to work on credit. With Multibanco and bank transfer the order exists long before the money, and some orders are never paid.

What is the legal deadline for issuing the invoice?

As a rule, by the 5th working day after the tax becomes due, under article 36 of the Portuguese VAT Code. A shop that invoices when the order is paid settles this the same day.

Which document do I issue for an order that is already paid?

An invoice-receipt, if the customer asked for an invoice with a VAT number. With no VAT number, on a retail sale of goods up to €1,000, it can be a simplified invoice. Each type needs its own series filed with the tax authority.

Does a Shopify refund cancel the invoice?

No. A certified document is only undone by a credit note: with the returned lines if it is partial, mirroring the whole invoice if it is a cancellation.

How do I invoice sales to other EU countries?

To consumers, above €10,000 a year across the EU, the destination country's rate applies, and OSS spares you a registration per country. To businesses with a number valid in VIES, the sale goes out without VAT, with code M16.

Does Shopify calculate VAT for me?

It calculates the rate, if it is configured properly, but it does not issue the tax document. The invoice total has to be what the customer paid, and the exemption code on zero-rated lines still has to be right.

Are the Shopify invoicing apps enough?

For the simple case, yes. They stop being enough with OSS, with sales to businesses validated in VIES, with more than one payment source in the same shop, or when you need to know at month end that no sale went uninvoiced. There is a comparison of the apps.

How much does it cost to connect the shop with Rioko?

€7.50 + VAT a month, or €75 + VAT a year, per integration, with no per-document fee. A card is required to activate the subscription. See pricing and how it works with Shopify.

Still have questions

Write the question. It reaches a person, not a form.