RiokobyKapta
Setup guide · November 2026
/ Guides · TOConline · OSS

OSS in TOConline: one series per country.

In TOConline, OSS lives in the series: one series with the Regime One Stop Shop for each EU country you sell to. Rioko sends each OSS sale to the series of the buyer's country, at that country's VAT rate.

01What you need

TOConline's Gestão Comercial Plus licence, and TOConline connected to the AT.

02Where it is done

Empresa, Configurações, Séries de documentos.

03Who does it

The business or whoever does its accounting: the series are created and reported in TOConline.

01

When it applies

Distance sales to consumers in another EU country.

  1. 1OSS is for selling to consumers in other EU countries: each sale carries the VAT of the buyer's country, and is declared through OSS, on the Portal das Finanças.
  2. 2It is mandatory above €10,000 a year in sales to consumers in other EU countries, all added up, and can be used by choice below that.
  3. 3Sales to businesses with a valid VAT number are not OSS: they are outside this guide.
02

Create one OSS series per country

In Empresa, Configurações, Séries de documentos.

  1. 1Press the + button and choose Criar série (create series).
  2. 2Fill in the Prefixo (prefix) and the Descrição (description), for example OSS-IT and OSS Itália.
  3. 3Go on to Regimes específicos de IVA (special VAT regimes).
  4. 4In Regime One Stop Shop, pick the country and confirm the rates.
  5. 5Press Criar (create). Repeat for each country you sell to.
The + button and Criar série in TOConline's Séries de documentos. The company's details are blurred.
The new series' first screen: Prefixo OSS-IT and Descrição OSS Itália.
Regime One Stop Shop: the series' country and the rates to use.
Video: creating the OSS series for Italy, with captions (no sound).
The series' rates do not limit Rioko

The rates you pick in the series are the ones TOConline suggests by default. Rioko writes each line at the sale's rate, and TOConline takes any rate of that series' country.

03

Report each series to the AT

In the series' menu, inside TOConline.

  1. 1In the list, hover over the series' row and open the menu with the arrow.
  2. 2In the AT section, choose Comunicar a série (report the series).
  3. 3The rest is the same as for any series: see Report series in TOConline.
The OSS series in TOConline's list and the series' menu, with Comunicar a série. The company's details are blurred.
04

Switch OSS on in Rioko

In the invoice settings of the TOConline integration.

  1. 1Switch on I am registered for OSS. Rioko shows each EU country with its OSS series ready, missing, or not yet reported.
  2. 2Pick the code for sales outside the EU: M40 for services, M05 for goods.
  3. 3Each OSS sale goes in the series of the buyer's country, at that country's rate. Credit notes and receipts go in the same series.
  4. 4A sale to a country with no reported OSS series is not invoiced: it raises a notice to create the series in TOConline and report it to the AT.
FAQ

Frequently asked questions

Do I need an OSS series for each country?

Yes. In TOConline, each OSS series belongs to one country and takes only customers from that country. Create one for each country you sell to.

Which TOConline licence do I need for OSS?

Gestão Comercial Plus. Without it, TOConline does not let you create series under the Regime One Stop Shop.

Can I use OSS below €10,000?

Yes, by choice. Above €10,000 a year in sales to consumers in other EU countries it is mandatory.

What happens to a sale to a country with no OSS series?

It is not invoiced. Rioko says that country's series is missing; create it in TOConline and report it to the AT.

Does the series' default rate limit the invoice's rates?

No. Rioko writes each line at the sale's rate, and TOConline takes any rate of the series' country.

Which series do an OSS sale's credit notes go in?

The same OSS series as the invoice, like the receipts.

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