How to Create an Invoice Series in Vendus

Vendus is the certified package most used at physical points of sale in Portugal, but it works just as well for online sales through its API. Setting up a series in Vendus is straightforward, as long as you respect the order: create it locally, file it with the tax authority, paste the ATCUD.

This guide covers each stage in detail.

Before you start

To file a series you need Portal das Finanças sub-user credentials carrying the WSE — Comunicação e Gestão de Séries por webservice operation. If you do not have them, follow ATCUD: creating the user at the tax authority first.

It also helps to have the theory straight: read Invoice series: what they are and how to file them if you have never configured one.

Step 1: open series management in Vendus

1. Sign in at www.vendus.pt.
2. Go to Definições (the gear icon top right, or the side menu).
3. Submenu Faturação → Séries.
4. The page lists the existing series. New accounts usually carry a default series A for each document type.

Click Nova Série.

Note: Vendus automatically creates series at the start of each calendar year for the document types you used the previous year. You only need to create one by hand for an extra series (a new channel, a new establishment) or if you changed software mid-year.

Step 2: fill in the series

The form asks for:

| Field | Description | Example | |---|---|---| | Name | The series' unique identifier. Letters and digits, no spaces. | 2026FR | | Document type | FT, FS, FR, NC, ND, GT... | Fatura-Recibo (FR) | | Starting number | Where the count begins. Usually 1. | 1 | | Establishment | Only if you have more than one registered in Vendus | Principal | | Active | Tick to start using it | ✓ |

Some accounts also show:

• Default: tick it if this should be the series used when issuing documents of this type.
• Internal description: free text for your own reference. It does not appear on the document.

Save. The series now exists in Vendus but is not yet certified: it has no ATCUD code.

Step 3: file the series with the tax authority

Vendus supports two routes.

Automatic (recommended)

If the AT sub-user credentials are already configured in Vendus:

1. Go to Definições → Empresa → Comunicação AT (or Webservice AT, depending on the version).
2. Confirm the sub-user (NIF/N) and the AT password are filled in.
3. Go back to Definições → Faturação → Séries and open the series you just created.
4. Click Comunicar à AT, the button inside the series page.
5. Vendus sends the request by webservice. Within seconds the ATCUD validation code field fills in on its own.

By hand

If you prefer to file on the Portal das Finanças:

1. Go to Portal das Finanças → Todos os Serviços → Faturas e Outros Documentos Fiscais → Comunicar Séries Documentais → Registar Série.

2. Fill in:

   • Document type: the same one set in Vendus.
   • Series identifier: it has to be exactly the Name in Vendus (2026FR).
   • Starting sequence number: the same.
   • Processing method: Programa informático de faturação.
   • Certification number: 2230, Cegid Vendus's current number with the tax authority. Always confirm it in the Vendus panel under Sobre, or in the footer of an issued document, in case it changes.

3. Submit. The tax authority returns the 8-character validation code.

4. Back in Vendus, edit the series and paste the code into the ATCUD field.

5. Save.

Step 4: confirm certified issuing

Before putting the series into production, issue one test document and confirm everything lines up:

• The document number reads <TYPE> <SERIES>/<NUMBER>, for example FR 2026FR/1.
• The QR Code is present in the PDF.
• The ATCUD: CSDF7T5H-1 line appears on the document, with the right validation code.
• The PDF footer identifies Vendus as the certified software, with its number.

If any of these fails, do not use the series in production. Investigate and fix first.

Good practice in Vendus

• One series per document type per year: 2026FT, 2026FR, 2026NC. Easier to audit.
• Do not delete old series. At year end the 2025 series stays as permanent history. You stop using it, you do not delete it.
• Be careful with per-establishment series. With a physical shop and an online shop you might run 2026FRONLINE and 2026FRLOJA to keep them apart. Each has its own ATCUD.
• Do not change the name after the first document. Vendus blocks it, and even if it did not, you would lose the match with what was filed.

Common errors

• Série não comunicada à AT when issuing: the ATCUD field is empty. File the series first.
• Identificador da série já existe when filing: that name has already been filed under this VAT number. Choose another.
• Numeração inicial inválida: you are trying to start below a number already filed. Raise the starting number or file a different series.
• Documents with no QR Code: the software version may be out of date, or the series is not marked active. Check Definições → Empresa → Configuração SAF-T.

How Rioko helps

Once the Vendus series exists with a valid ATCUD, open Rioko, go to the relevant integration page (Stripe + Vendus or Shopify + Vendus) and copy the Vendus Series ID into the Rioko dashboard. The Series ID is in the URL of the series page inside Vendus (/series/edit/<id>) or available through the API. At configuration time Rioko checks the series carries an ATCUD and blocks the integration when it does not, so no Shopify order or Stripe payment produces an uncertified document.

Set up the Stripe + Vendus integration →