RiokobyKapta
Setup guide · November 2026
/ Guides · Moloni ON · OSS and withholding

OSS and withholding in Moloni ON.

In Moloni ON, each VAT rate of another country is created under Configurações, Impostos & Retenções, Impostos (taxes), with that country as the fiscal zone. Withholding rates are created next to it, under Retenções.

01What you need

The VAT rate of each country you sell to under OSS.

02Where

Configurações, Impostos & Retenções.

03Suggested name

The country code and the rate, such as FR20 or ES21.

01

Create another country's VAT rate

Under Configurações, Impostos & Retenções, Impostos.

  1. 1Open Configurações (settings), Impostos & Retenções (taxes and withholding) and choose Impostos.
  2. 2Click Criar (create).
  3. 3Nome (name): for example FR20, the country and the rate.
  4. 4Tipo: Percentagem (percentage). Valor: the country’s rate, for example 20.
  5. 5Zona Fiscal (fiscal zone): the country, for example [fr] - França. Tipo de imposto (tax type): IVA (VAT).
  6. 6Click Guardar (save). The rate shows on the list, with the country’s fiscal zone.
A new rate in Moloni ON: FR20, percentage, 20%, fiscal zone France, tax type VAT.
Video: creating the FR20 rate and a withholding rate, with captions (no sound).
Taxes in Moloni ON, with FR20 on the list next to the Portuguese rates.
Do not create 0% rates

Moloni ON itself asks you not to create 0% taxes: on an exempt sale, the document carries the exemption reason.

02

Madeira and Azores rates

Created by hand, one per rate level, in each region.

  1. 1Under Impostos, click Criar.
  2. 2Nome: for example IVA Madeira 12%. Tipo: Percentagem. Valor: the rate.
  3. 3Zona Fiscal: [pt-ma] - Portugal | Madeira or [pt-ac] - Portugal | Açores.
  4. 4Tipo de imposto: IVA. Patamar de valor acrescentado (rate level): Normal, Intermédio or Reduzido, to match the rate.
  5. 5Click Guardar and repeat for each level.
A Madeira rate in Moloni ON: fiscal zone pt-ma, tax type VAT, level Intermédio.
Video: creating the Madeira and Azores rates, with captions (no sound).
Madeira
Normal 22%, Intermédio 12%, Reduzido 4% (since 1 October 2024).
Azores
Normal 16%, Intermédio 9%, Reduzido 4%.
Taxes in Moloni ON, with the six Madeira (pt-ma) and Azores (pt-ac) rates.
Why by hand?

Moloni ON does not let other programs create the autonomous regions’ rates, so Rioko does not create them for you.

03

Create a withholding rate

Under Configurações, Impostos & Retenções, Retenções.

  1. 1Open Configurações, Impostos & Retenções and choose Retenções (withholding).
  2. 2Click Criar.
  3. 3Nome: for example IRS 11,5%. Valor: the percentage.
  4. 4Click Guardar.
A new withholding rate in Moloni ON: the name and the percentage.
Withholding in Moloni ON, with the new rate on the list.
FREQUENTLY ASKED QUESTIONS

Frequently asked questions

What should I name another country's rate?

Whatever you like. We suggest the country code and the rate, such as FR20, to spot it quickly on the list.

Can I create a 0% rate for exempt sales?

No. Moloni ON asks you not to create 0% taxes: the document carries the exemption reason.

Where are the Madeira and Azores rates?

Under Impostos, one per level, with the fiscal zone [pt-ma] - Portugal | Madeira or [pt-ac] - Portugal | Açores. They are created by hand: Rioko does not create them for you.

Where are withholding rates created?

Under Configurações, Impostos & Retenções, Retenções: each rate has a name and a percentage.

CONTINUE

Related guides

Need help?

If you would rather set it up with us, book a call. We configure everything with you, live.

Book a call ↗ calendly.com/pedro-kapta/rioko-support
RiokobyKapta