AT Webservice User
In Portugal, every document is numbered in a series that is registered with the Tax and Customs Authority (AT), and every document carries the ATCUD, which consists of the series validation code issued by the AT and the sequential number of the document. fiskaltrust registers the series for each queue through the AT series webservice (Comunicação de Séries) and obtains the validation codes automatically.
The series belong to the merchant, so the AT requires every call to the series webservice to be made with the merchant's own credentials for the Portal das Finanças. These credentials must belong to a sub-user (subutilizador) that has the WSE profile. Before the series of a production queue can be registered, the merchant therefore has to:
- create a sub-user with the WSE profile in the Portal das Finanças, and
- enter the credentials of this sub-user in the fiskaltrust.Portal.
This page describes both steps. You can share it with your merchants as part of onboarding.
Before you start
- The merchant needs the NIF of the company and the password for the Portal das Finanças of the NIF holder. Only the NIF holder can create sub-users.
- Do not use the main access of the NIF holder for the webservice. The AT requires a sub-user with the WSE profile.
- If the merchant already has a sub-user for another AT webservice, for example for invoicing software or e-Fatura, the WSE profile can be added to this sub-user instead of creating a new one.
Step 1: Create the sub-user in the Portal das Finanças
- Log in to the Portal das Finanças with the NIF and password of the company.
- Open the user management (
Gestão de utilizadores) and create a new sub-user. The form can also be opened directly at acesso.gov.pt – Criar utilizador. - Enter the details of the sub-user and set a password.
- Assign the profile
WSE - Comunicação e Gestão de Séries por webservice(Communication and Series Management by webservice) to the sub-user. - Save the sub-user and note its number. The AT assigns each sub-user a number; the full user name of the sub-user is the NIF followed by a slash and this number, for example
123456789/2.
To add the WSE profile to an existing sub-user, open the sub-user in Gestão de utilizadores, add the WSE - Comunicação e Gestão de Séries por webservice profile, and save.
Step 2: Enter the credentials in the fiskaltrust.Portal
Enter the following data of the sub-user in the fiskaltrust.Portal for the merchant's account:
| Data | Example |
|---|---|
| NIF of the company | 123456789 |
| Number of the sub-user | 2 |
| Password of the sub-user |
Table 1. Credentials of the AT webservice user.
fiskaltrust uses these credentials only to communicate the series of the merchant's queues to the AT. The password is transmitted to the AT in encrypted form, as required by the AT.
If the password of the sub-user is changed in the Portal das Finanças, update it in the fiskaltrust.Portal as well. Otherwise new series cannot be registered.
Further information
- Comunicação de Séries à AT e ATCUD (AT, Portuguese): the AT page with the integration manuals for the series webservice. Section 2 of the manual Comunicação de Séries Documentais – Manual de Integração de SW – Aspetos Genéricos describes the credentials of the economic operator and the sub-user with the WSE profile.
- For what fiskaltrust does with the series and the ATCUD as operator of the certified program, see Certification.