Automatic invoicing in Moloni ON.
For Rioko to issue invoices in Moloni ON, the company needs the Cliente API (API client) module, the connection to the Portuguese tax authority (AT) and a series with the AT validation code on each document type. This guide covers what is done on the Moloni ON side.
A company in Moloni ON, with access to its subscription and settings.
About 10 minutes, if the AT sub-user already exists.
The Cliente API module: €1.80 + VAT a month, in the Moloni ON price simulator on 18/11/2026.
What you need
Check these points before opening Rioko's setup wizard.
- Cliente API moduleThe module that lets other programs connect to Moloni ON. You turn it on in the subscription, in step 1 of this guide.
- AT connectionMoloni ON connected to the AT with a sub-user. See Connect Moloni ON to the AT.
- Series with AT codesA series with the AT validation code on each document type Rioko issues. See Series in Moloni ON.
They are two different programs, each with its own account and connection. If you invoice in Moloni, see the Moloni guide.
If the same payments are already invoiced in another program, by Rioko or by another system, turn that invoicing off before turning this one on. The same payment would end up with two invoices.
Turn on the Cliente API module
Done once per company.
- 1In Moloni ON, open Configurações (settings) and choose Subscrição (subscription).
- 2Under Módulos ativos (active modules), check whether Cliente API already shows in the Ferramentas (tools) group. If it does, go to step 2.
- 3If it does not, click Gerir módulos (manage modules).
- 4In the Ferramentas group, switch on Cliente API.
- 5Confirm the subscription change in the summary on the right.
The Clientes API page, under Ferramentas, Developers, is for people who program their own connection. Rioko connects with your authorisation.
Connect Moloni ON to the AT
Under Fiscal, Ligação webservice.
- 1Create a sub-user with the WSE profile in the Portal das Finanças (the AT portal).
- 2In Moloni ON, open Fiscal, Ligação webservice, switch the connection on and enter the sub-user and password.
- 3Step by step: Connect Moloni ON to the AT.
Create the series with the AT codes
Under Configurações, Documentos, Séries de documentos.
- 1Create the series and, under Configurações do tipo de documento (document type settings), add Fatura (invoice), Fatura-Recibo (invoice-receipt), Nota de Crédito (credit note) and Recibo (receipt).
- 2On each type, enter the start date and the AT validation code.
- 3Step by step: Series in Moloni ON.
- 1Open Integrations. Under Payment / E-commerce platform, choose your platform; under Invoicing platform, choose Moloni ON. Click Configure now.
- 2Step 1 connects the payment platform.
- 3In step 2, click Authorise Moloni ON, sign in to Moloni ON with the user that has the company, and confirm. Moloni ON sends you back to Rioko, which shows Moloni ON authorised.
- 4Choose the company and the series. If the series lacks the AT code for a document type, Rioko says which one: register it in Moloni ON (step 3) or choose another series.
You sign in on Moloni ON's own page. Rioko neither sees nor stores your password.
Invoice settings
Step 3 of the wizard.
- Document type
- Invoice-receipt by default on Stripe, Easypay and EuPago, because the payment arrives already received; Invoice by default on Shopify and Lodgify.
- VAT included
- On, the amount paid already includes VAT.
- Auto-finalize
- Off by default: the document stays as a draft in Moloni ON, for you to check and finalize there. On, the document is finalized straight away.
- Send the invoice to the buyer
- On, the finalized document is emailed to the buyer. A draft is never sent.
- Exemption reason
- Used on lines with 0% VAT. Without it, an exempt sale is not invoiced.
Keep "Auto-finalize" off for the first payments, to check in Moloni ON that everything is right, and turn it on afterwards.
Activate and test
Check the first document before letting invoicing run on its own.
- 1On the same page, start the integration's subscription (monthly or yearly).
- 2In step 4, click Mark as active.
- 3Make a small payment on your platform.
- 4On the Dashboard, under Latest documents, the payment appears with the document's status. Open the document in Moloni ON and check the totals, VAT and customer.
A test payment from your platform (for example, in Stripe's test mode or the Easypay or EuPago sandbox) always stays as a draft in Moloni ON. Delete it there once you have seen it.
Frequently asked questions
Is Moloni ON the same as Moloni?
No. They are two different programs, each with its own account and connection. This guide is for Moloni ON; Moloni has its own guide.
Which Moloni ON module is needed?
Cliente API, in the Ferramentas group of the subscription. It is what lets other programs, such as Rioko, connect.
How much does the Cliente API module cost?
In the Moloni ON price simulator, on 18/11/2026: €1.80 a month, plus VAT. The price is set by Moloni ON and may change.
Do I need to create an API client under Ferramentas, Developers?
No. That page is for people who program their own connection. Rioko connects with your authorisation.
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