The series has no AT validation code (ATCUD)

Symptom

• When you click Confirm on an invoice, Cannot confirm yet opens and the invoice stays in Draft; or
• on a series in Draft, the Fiscal officer clicks Activate and the series does not become active; or
• when registering the validation code, fiscaldoo refuses the code.

Message

On the invoice (Billing profile), when the chosen journal has the series for the year but it is still in draft:

“Cannot confirm yet One thing is missing: Journal “Faturas (série de teste da AT)” has the series REG2026 for 2026, but it is not active yet. Every document is numbered by a series reported to the tax authority; without it the number cannot be given. Register the validation code that the tax authority gave to the series (Portal) and activate it in Accounting › Configure › Certified invoicing › Fiscal series.”

The window has the Go to fiscal series and Close buttons.

On the series, when you click Activate and confirm (Fiscal officer profile):

“Series "FT REG2026" cannot be activated without a validation code of at least 8 characters and a planned start date. Communicate the series to the AT and register the code it returns, then activate.”

When registering a code shorter than 8 characters:

“The validation code of series "FT REG2026" is too short: the AT codes have at least 8 characters. Copy the full code returned by the AT.”

All three messages were triggered in the demo database.

Verified causes

• The series was created but not communicated to the AT. A series always starts in Draft. It only becomes active (Active in the list and on the form) once it has the validation code the AT returns and a Planned start date. Until then, it does not number documents.
• The series was communicated on the Portal das Finanças, but the code was not registered in fiscaldoo. The AT gave the code, but the series form still has an empty Validation code.
• The code was copied incomplete or with spaces and hyphens. AT codes have at least 8 characters, letters and digits only.

The validation code is the first part of each document's ATCUD (the ATCUD is the code, a hyphen and the document number). So, without a code, the series cannot issue.

What to check

1. In Accounting › Configure › Certified invoicing › Fiscal series, the AT validation code column and the Series status of the series for the invoice's journal and year. In the demo, FT REG2026 was in Draft, without a code.
2. Whether the series has already been communicated to the AT (in fiscaldoo, with Communicate to the AT, or on the Portal das Finanças). The Communicated at and Communicated by fields on the form show this.
3. Whether the invoice is in the right journal. If you chose by mistake a journal you do not use, change the invoice's Journal to the usual journal and confirm.

How to fix it

Who does it: Fiscal officer (the Billing and Accountant profiles reach the list through the Go to fiscal series button, but the series is communicated and activated by the Fiscal officer).

The series has not been communicated yet

Open the series and click Communicate to the AT. Read what will be sent, tick I confirm that these data are correct and can be communicated and click Communicate. When the AT accepts, the code is registered and the series becomes Active. The steps, and what to do if the AT refuses, are in How to create a series and communicate it to the AT.

To communicate from fiscaldoo, the company needs the AT credentials: How to connect fiscaldoo to the Tax and Customs Authority.

The communication cannot be undone

The AT's response is recorded and a communicated series cannot be deleted: a series with a code can no longer be deleted, only cancelled. Check the identifier, the document type, the journal and the fiscal year before communicating.

The series was communicated on the Portal das Finanças

1. Open the series and click Register validation code (Portal).
2. In Validation code, type the code exactly as the AT returned it, without spaces or hyphens. Check Communicated at and, if you have it, attach the Proof (PDF). If the code contains the digits “0” or “1”, the window shows a Warning: “The code contains "0" or "1": the official FAQ says the AT never returns those digits in a validation code — check it was copied correctly. This is only a warning (that detail is not in the Portaria's own text): the wizard still lets you save it.” Check the code against the proof (for example, a letter “O” read as zero) before registering.
3. Click Register.
4. Click Activate and, in the Confirmation window (“Activate this series? Its identity can no longer be changed.”), Confirm.

Once the code is registered, the Register validation code (Portal) button no longer appears on the series.

After activating

Go back to the invoice and click Confirm. The invoice receives the series number and the ATCUD.

Expected result

• In the Fiscal series list, the series becomes Active (on the form, Active), with the AT validation code filled in.
• The invoice is confirmed and shows the ATCUD, which starts with the series' validation code.

In the demo, with the Fiscal officer profile, the code DOCSXEKR was registered on FT REG2026 with Register validation code (Portal), the series was activated and became Active in the list. Then, with the Billing profile, the invoice that had been refused in the Faturas (série de teste da AT) journal was confirmed as FT REG2026/1, with ATCUD DOCSXEKR-1.

When to contact support

• The AT accepted the series (you have the proof), but fiscaldoo says the code already belongs to another series or does not save it.
• The series has a code and a Planned start date, and Activate is still refused.
• You need to correct a validation code that has already been registered on an active series.

Information to send

• The company, the series (for example FT REG2026) and the journal.
• The full text of the message, copied from the screen.
• The proof of the communication on the Portal das Finanças, if you did it there (without passwords).
• The profile you logged in with.