by
Automatic invoicing in Vendus.
For Rioko to issue invoices in Vendus, the account needs the Flex or Pro plan, a connection to the Portuguese tax authority (AT) and the API turned on. This guide lists the requirements and shows how to make the connection. After that, every payment received on Shopify, Stripe, Lodgify, Easypay or EuPago becomes a document, and every refund a credit note.
Vendus on the Flex or Pro plan, connected to the AT.
About 10 minutes, if the AT connection is already done.
€7.50 + VAT per month or €75 + VAT per year, per integration.
What you need to have
Check these points before opening Rioko's wizard.
- Flex or Pro planThe Vendus API is included in the Flex and Pro plans. The Base plan does not include it. See the Vendus plans.
- AT connectionVendus must be connected to the AT with an AT sub-user. See Connect Vendus to the AT.
- Reported seriesIn Vendus, each shop is a series. See Series in Vendus.
- API KeyIt is in the menu under your name, in step 2 of this guide.
If the same payments are already invoiced in another program, through Rioko or another system, turn that invoicing off before activating this one. The same payment would end up with two invoices.
- 1Open Integrações.
- 2Under Plataforma de Pagamento / E-commerce, choose your platform. Under Plataforma de Faturação, choose Vendus.
- 3Click Configurar Agora.
- 4Step 1 connects the payment platform. Each step's Ver como se faz button shows where each value is.
Copy the API Key in Vendus
Rioko only needs this key.
- 1In Vendus, click your name, in the top right corner, and choose API.
- 2Check that Acesso API is Ligado (on).
- 3Copy the API Key.
The API Key authorises the creation of tax documents in your account. Do not share it by email, chat or screenshots.
Paste the key into Rioko
In the Vendus step of the wizard.
- Vendus API Key
- The key you copied.
- Environment
- Produção (production) for real documents. Sandbox issues in test mode, with no tax effect.
Invoice settings
Till, VAT, sending to the buyer and exemption.
- Till
- With a single till, documents are issued on that one. With several, choose one. The till belongs to a shop, and the shop defines the series.
- VAT included
- Does not change prices. On, it authorises Rioko to recalculate the rate when a tax registration is connected (OSS, regional rates, reverse charge).
- Exemption reason
- Applied when the invoice has 0% VAT.
Vendus issues the final document at once. To validate first, choose Sandbox in the credentials and switch to Produção at the end.
Activate and test
Check the first document before letting invoicing run on its own.
- 1On the same page, activate the integration's subscription (monthly or yearly).
- 2In the last step, click Marcar como Ativo (Mark as active).
- 3Make a small payment on your platform.
- 4On the Dashboard, under Últimos documentos, you see the payment and the document's status. Open the document in Vendus and check totals, VAT and customer.
Test documents have no tax effect. When everything is right, switch the environment to Produção.
Frequently asked questions
Does the Vendus Base plan work for connecting to Rioko?
No. The Vendus API is included in the Flex and Pro plans, and Rioko connects through the API.
Where do I find the Vendus API Key?
Click your name, in the top right corner of Vendus, and choose API. Check that Acesso API is Ligado.
Do I have to specify the Vendus till?
Only if you have more than one. Rioko reads the account's active tills and, if there are several, asks you to choose one.
How do I test the connection without issuing real documents?
Choose Sandbox in the environment. Vendus issues in test mode, with no tax effect.
Does the document stay as a draft in Vendus?
No. Vendus issues the final document at once. To validate first, use the Sandbox environment.
Related guides
Connect Vendus to the AT
Create the AT sub-user and enter the credentials.
See the guide →Series in Vendus
Each shop is a series.
See the guide →InvoiceXpress
Requirements and steps to connect InvoiceXpress to Rioko.
See the guide →Moloni
Requirements and steps to connect Moloni to Rioko.
See the guide →TOConline
Requirements and steps to connect TOConline to Rioko.
See the guide →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
by