New: Rioko now invoices in Moloni ON too, as well as InvoiceXpress, Moloni, Vendus and TOConlinein five invoicing programs. Compare the five programs
All articles
Tax guidesPedro Correia, Rioko team25 May 2026Updated on 09 November 20268 min

ATCUD: How to Create a User at the Portuguese Tax Authority

Step by step: creating a sub-user on the Portal das Finanças with permission to file invoice series and obtain the ATCUD validation code.

ATCUD: How to Create a User at the Portuguese Tax Authority
In short: For your invoicing software to file series with the tax authority, create a sub-user on the Portal das Finanças with the WSE operation. The credential is that sub-user's NIF/N pair and password, with no separate key. From then on, the software can obtain each series' validation code on its own.

Before any certified invoicing package can issue an invoice with a valid ATCUD, the series has to have been filed with the Portuguese tax authority (AT) and to have received its validation code. That is done on the Portal das Finanças, and the cleanest way, particularly if you work with an external accountant or with several people handling invoicing, is to create a dedicated sub-user carrying the WSE (Comunicação e Gestão de Séries por webservice) operation and nothing beyond what you need.

This guide shows exactly how.

Why you want a sub-user

The obligation to carry an ATCUD on every relevant tax document comes from Portaria 195/2020, of 13 August, which regulates the QR Code and the unique document code. In force since 1 January 2023, it means every invoice series has to be filed with the tax authority beforehand. Only then can certified software include the ATCUD on the invoices it issues.

Creating a dedicated sub-user has three practical advantages:

  • Credential separation: your accountant or employee files series without reaching the rest of the company's tax information.
  • Audit trail: each series is associated with the sub-user that filed it.
  • Quick reset: if the employee leaves, you revoke the sub-user without changing the company's main password.

Important: the sub-user is created by the company (its corporate VAT number) and does not replace the legal representative's password. It is a delegated account with limited permissions.

Step 1: reach the Portal das Finanças

  1. Open www.portaldasfinancas.gov.pt.
  2. Click Iniciar Sessão, top right.
  3. Sign in with the company VAT number and its password. Do not use the manager's personal number: it has to be the corporate one, because the obligation to file series belongs to the legal entity.

Step 2: open user management

Inside the company area:

  1. Go to Todos os Serviços, or type Gestão de Utilizadores into the search bar at the top.
  2. In the Autenticação de Contribuintes group, open Gestão de Utilizadores.
Portal das Finanças, Todos os Serviços, with Gestão de Utilizadores highlighted in the Autenticação de Contribuintes groupUnder Todos os Serviços, Gestão de Utilizadores sits in the Autenticação de Contribuintes group. Screenshot: Moloni

The page lists the existing sub-users and the operations each one holds. The first time, it is empty. Click Criar Novo Utilizador.

Portal das Finanças Gestão de Utilizadores page with the sub-user list and the Criar Novo Utilizador buttonThe sub-user list. Criar Novo Utilizador opens the form. Screenshot: Moloni

Step 3: create the sub-user

In the Novo Utilizador form you set the credential yourself:

FieldWhat to put
UtilizadorThe sub-user's number. With the company VAT number in front it makes the credential NIF/N (for example 500123456/1)
NomeA readable label, for example Comunicação Séries. It only helps you spot it in the list
Senha and Confirmar SenhaA strong password, different from the company's main one
EmailOptional: an address for the tax authority's notices about this sub-user
Perfis AtribuíveisThe operations the sub-user may perform. See the table below. At minimum, WSE

The Permitir ao utilizador realizar operações através do telefone option is not needed to file series.

Portal das Finanças Novo Utilizador form with Utilizador, Nome, Senha, Confirmar Senha, Email and the Perfis Atribuíveis tableThe Novo Utilizador form. Operations are picked further down, under Perfis Atribuíveis. Screenshot: Moloni

Which operations to tick

The Perfis Atribuíveis table lists operations by code, over several pages. Typing W into the Filtrar box shows the webservice ones. Three matter to anyone invoicing:

CodeDescription, as it appears on the portalWho needs it
WSEComunicação e Gestão de Séries por webserviceEveryone. This is the one that authorises series. Without it the sub-user exists with no access to series registration
WFAWebservice de comunicação de dados de facturasAnyone filing invoice data by webservice rather than submitting the SAF-T file by hand
WDTWebservice de comunicação de documentos de transporteOnly those issuing delivery notes

WSE is the minimum and the indispensable one. The other two depend on what your software does for you: most certified packages file invoices on their own (WFA), and anyone shipping goods with a delivery note needs WDT.

Do not tick what you do not need, but do not be stingy either: adding an operation later means going back to the portal, and the automatic filing that was failing in the meantime does not recover on its own.

Last page of Perfis Atribuíveis with WSE ticked, WFA and WDT visible, and the Criar Utilizador buttonWSE sits next to WFA and WDT. Tick the ones you need and click Criar Utilizador. Screenshot: Moloni

Click Criar Utilizador. The portal creates the sub-user and shows a summary.

Keep the NIF/N and the password. That pair is what goes into the invoicing software, not the company VAT number on its own nor the name you gave the sub-user.

The webservice is configured here, and only here. The operations you ticked on this form are what authorise automatic filing (WSE for series, WFA for invoices, WDT for delivery notes), and the webservice credential is this same NIF/N with this sub-user's password. There is no key to generate afterwards and no second password on the side: what you later enter into InvoiceXpress, Moloni, Moloni ON, Vendus or TOConline is exactly this pair.

That is why it is worth creating the sub-user even if you plan to file your series by hand the first time. The day you want the software to file on its own, everything is already in place.

Step 4: file your first series

If the software will file series on its own, all it needs is the NIF/N and the password: each package's guide is linked at the end of this page. The concept is covered in invoice series. To file by hand, sign in to the Portal das Finanças and open:

Todos os Serviços → Faturas e Outros Documentos Fiscais
                  → Comunicação de Séries Documentais
                  → Registar Série

(Typing série into the portal's search gets there faster.)

Fill in:

  • Document type: FT, FS, FR, NC, ND, GT...
  • Series identifier: the name exactly as it is in your software, for example 2026FR.
  • Starting sequence number: normally 1.
  • Expected start date.
  • Processing method: Programa informático de faturação, plus the software's certification number. Each package has its own, for example InvoiceXpress 192, Moloni 2860, Vendus 2230. Always confirm in your software's About panel or in the footer of an issued document.

Submit. The tax authority returns a validation code of at least 8 characters, for example CSDF7T5H. It is the first half of the ATCUD for that series, and it is what you enter into the invoicing software.

Step 5: maintenance

  • One series, one code. Each document type + identifier pair gets its own code. If you have FT and FR, those are two separate filings.
  • Do not reuse identifiers across years without filing a new series. If you want 2026FR, file it; 2025FR stays closed.
  • The sub-user password expires. The portal forces periodic renewal. Put a reminder in your calendar, preferably before the turn of the year.
  • Revocation: if the employee leaves, go to Gestão de Utilizadores and remove or deactivate the sub-user. The series they filed remain valid.

How Rioko helps

Rioko does not need the AT sub-user credentials at all: that part stays on the Portal das Finanças and in your invoicing software, under your control. What Rioko does is use the series you have already filed, whose ATCUD is configured in your InvoiceXpress, Moloni, Moloni ON, Vendus or TOConline account. When you connect your Shopify store or Stripe account, you set in the dashboard the series invoices should come out of, and it is your certified software that puts the ATCUD on them. Guides per package: InvoiceXpress, Moloni, Vendus. To go deeper on the concept of a series, read Invoice series: what they are and how to file them.

See how Rioko invoices sales from Shopify, Stripe, Lodgify, Easypay and EuPago, and check the pricing.

Sources

#ATCUD#Tax authority#Filing series#Portal das Finanças

Frequently asked questions

Can I file series with the company password, without creating a sub-user?

You can, but the software cannot. Automatic filing by webservice needs a sub-user carrying the WSE operation, because that is the credential you enter into the invoicing software.

Which operations do I tick when creating the user?

WSE, for series, is mandatory. WFA if you want the software to file invoice data by webservice, and WDT if you issue delivery notes.

What do I enter in the invoicing software?

The NIF/N pair and the sub-user's password. There is no key to generate afterwards and no second password on the side.

Does one sub-user work for every package I use?

It does. The same NIF/N and password can be entered into more than one certified package. If you prefer a separate audit trail per package, create one sub-user for each.

Does the sub-user password expire?

The Portal das Finanças forces periodic renewal. When you change the password, update it in the invoicing software, or automatic filing stops.

I lost the sub-user password. What now?

Go back to Gestão de Utilizadores with the company password and generate a new one for that sub-user. Series already filed are unaffected, but the software stops filing until you enter the new password.

What happens if the employee who created the user leaves?

You deactivate the sub-user in Gestão de Utilizadores. The series they filed stay valid: they belong to the company, not to them.

Does Rioko need the tax authority credentials?

No. That part stays on the Portal das Finanças and in your invoicing software. Rioko uses the series you have already filed.

Still have questions

Write the question. It reaches a person, not a form.