ATCUD Unique Document Code
ATCUD is a document code that makes it possible to uniquely identify a document. On your transaction record, it can be found in the ATCUD field on the Portugal Transaction subtab. The code is also displayed on printed documents for supported transaction types, and present in the QR code message generated by the Portugal Localization SuiteApp. The supported transaction types include cash sale, cash refund, credit memo, delivery, invoice, payment receipt, and sales order.
ATCUD is generated in one of the following ways based on the SuiteApp version installed in your account:
-
For Portugal Localization SuiteApp in version other than 2.3.0, ATCUD is automatically generated after the Document Series Identifier is selected, and the transaction is saved.
-
For Portugal Localization SuiteApp in version 2.3.0, ATCUD is generated after the Document Series Identifier is selected, and the transaction is finalized. For more information, see Portugal Transaction Finalization.
In the Portugal Localization SuiteApp, the unique document code ATCUD can only be created for Portugal subsidiaries. This limitation derives from the same rule being applied to the assignment of Portugal document series. For more information, see Portugal Document Series.
For information about ATCUD code in Portugal SAF-T reports in XML format, see Portugal SAF-T for Billing and Portugal SAF-T for Shipping.
ATCUD Structure in Portugal Transactions and Printed Documents
The general structure of the ATCUD code results from the concatenation of the following two values divided by a hyphen:
-
Validation code – After you have reported your document series, the code is issued by the Portugal Tax and Customs Authority. The validation code is then used to generate the unique document code ATCUD. The validation code should contain 8 or more characters, and it cannot contain letters with diacritical marks, or numbers 1 and 0.
To enter the validation code:
-
Go to Setup > Portugal Localization > Portugal Document Series.
-
On the Portugal Document Series List page, find your Portugal document series and click on Edit in the Edit | View column.
-
On the Portugal Document Series page, fill in your validation code in the Validation Code field. You must enter the validation code exactly as provided by the Portugal Tax and Customs Authority.
-
Click Save.
-
-
Transaction sequence number – The sequence number of the transaction, which refers to the transaction certified by the same document series. This sequence number is also a part of the Portugal Transaction ID.
In some cases, transactions are missing one or both of the above mentioned values. Consequently, the structure of the ATCUD code changes, and is dependent on the following factors:
-
Transaction date
-
Whether the document series that the transaction belongs to has an assigned validation code
The following table summarizes possible forms in which ATCUD code may be displayed:
|
Displayed in the ATCUD field on the Portugal Transaction subtab |
Displayed on the printed documents |
Present in the QR code message |
---|---|---|---|
Transactions dated before January 1, 2022. |
0 |
not displayed |
0 |
Transactions with an attached document series identifier, and without a validation code. |
0 - Sequence number of the transaction within document series |
0 - Sequence number of the transaction within document series |
0 - Sequence number of the transaction within document series |
Transactions with an attached document series identifier, and with a validation code. |
Validation Code - Sequence number of the transaction within document series |
Validation Code - Sequence number of the transaction within document series |
Validation Code - Sequence number of the transaction within document series |