ATCUD Unique Document Code

ATCUD is a document code that makes it possible to uniquely identify a document, and is set at the moment of creating your Portugal transaction. On your transaction record, ATCUD 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.

Important:

In the Portugal Localization SuiteApp, you can only create the unique document code ATCUD 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:

1. 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:

   1. Go to Setup > Portugal Localization > Portugal Document Series.

   2. On the Portugal Document Series List page, find your Portugal document series and click on Edit in the Edit | View column.

   3. 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.

   4. Click Save.

2. 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

General Notices