ATCUD management

Use this function to generate and manage ATCUD codes for Portuguese legislation.

The ATCUD and QR code are required on all accounting documents. If there is no valid code in the ATCUD field, you cannot post or validate accounting documents.

Process overview

Steps to complete

  1. Create the Sequence number definition for the folder, company, or site by year using the ATDUC identification number. The Type should be Alphanumeric. You can only generate for the final series. If not, you receive an error. In the Components grid, you need to define the sequence number as shown below. This example is for a site. On line 6, the slash is required to comply with the Portuguese tax authority.

Component type Length Formula
1 Constant 3 PRF
2 Constant 1
3 Site 5
4 Constant 1
5 Year 2
6 Constant 1 /
  1. Select Generate to create the series number for a specific document type. You need to generate a series for each document type.
  2. You need to manually provide the series to the Portuguese fiscal authorities website. The fiscal authority sends you the ATCUD code for the series.
  3. Enter the ATCUD code you receive from the fiscal authorities into the ATCUD field.

ATCUD code in accounting documents

The ATCUD code in the ATCUD field is automatically added to documents when you perform a final action where the document, like an invoice, can no longer be modified. Depending on the function, this can include posting, validating, or selecting electronic signature. A log file details the insertion of the ATCUD code.

  • Sales invoices GESSIH
  • Sales deliveries GESSDH
  • Sales deliveries GESSDH2
  • Sales orders GESSOH
  • Sales quotes GESSQH
  • Payment/receipt entry GESPAY
  • Customer invoices GESBIC
  • Transport note GESTNH
  • Purchasing returns GESPNH
  • Customer returns GESSRH
  • Subcontract returns GESSTR
  • Intersite transfers GESSIS
  • Subcontractor transfers GESSST
  • Invoice/credit memo validation FUNCFMINV
  • Delivery validation FUNCFMDLV
  • Transport note validation FUNCFMTNH
  • Order electronic signature FUNCFMSOH
  • Quote electronic signature FUNCFMSQH
  • Customer invoice posting BPCVAL
  • Payment proposals PAYPROPAL
  • Open item management MODECHE
  • Direct order invoice gen. FUNAUTINVO
  • Invoice validation FUNPIH
  • Purchasing Return validation FUNPNHTRT
  • Sales Return validation FUNCFMSRH
  • Proforma electronic signature FUNCFMPRO

Suppliers

To communicate autoinvoices for suppliers to the fiscal authority using the webservice, you need to register the agreement with the "Portal das Finanças" to obtain the agreement number.

In the supplier record, you need to select the Autoinvoice agreement checkbox and enter the agreement number in the related field.

See the Supplier help for more information.

Reports

When you print a document or a report, the ATCUD and QR code are included.

SAF-T export

When you perform a SAF-T export, the ATCUD code is included in the <atcud> </atcud> tag with the same format used for documents. If there is no ATCUD code, a 0 is placed in the tag.

Importing invoices

When you import an invoice, you receive a blocking message if the ATCUD field is empty. You need to enter the ATCUD code to import an invoice for a Portuguese company.

The ATCUD code is limited to 10 alphanumeric characters. Only consonants and the number 2 through 9 are accepted. Special characters, like dashes or ampersands, cannot be used.

Prerequisites

Refer to the documentation on Implementation.

Screen management

Entry screen

Company (CPY)
Enter or select a Portuguese company.
Sequence number (CODNUM)
The sequence from the Sequence number definition function.
SAF-T document type (SAFTINVTYP)
Select the document type.
Series (SEQ)
This identification is composed sequentially of the following elements: the internal code of the document type, a space, the document series identifier, a slash (/), and the sequential number of that document within that series.
Next value (VAL1)
The following document number to be created using this series.
Document type (TYP)
ATCUD (ATCUD)
The unique document code (ATCUD) is a code that allows a document to be uniquely identified, regardless of its issuer, document type, or series used. The ATCUD, as defined in Article 3 of Ordinance No. 195/2020 of August 13, results from the concatenation of the validation code assigned to the series with the sequential number of the document within that series.
Active (ENAFLG)
Select this checkbox so that the series can be used in documents.

Register

Date series (REFDAT)
Enter or select a date to include series. The date is needed to register, consult, cancel, and finalize the series using the fiscal authority's webservice.

Cancel

Accept (STA)
Select this checkbox to confirm that you, the taxable person, should not cancel the communication of a series if the series was already used in documents issued with its information.

Finalize

Accept (STA)
Select this checkbox to confirm that you, the taxable person, should not cancel the communication of a series if the series was already used in documents issued with its information.
Reason (COMMENT)
You can enter a comment on why the series was closed.

Inquiry/Agreement inquiry

Start/end date (STRDAT/ENDDAT)
Enter a range to limit the inquiry to series or agreements associcated with autoinvoice series. Results depend on which ATCUD action you select: Consult or Agreement.

Status

Return code (RETCOD)
This field displays the return code from the webservice for the last action performed. The codes are defined in the fiscal authority documentation. There is a unique code for each action.
Status (TYPSERIE)

The status can be:

A: Active

N: Canceled

F: Finalized
Message (RETMES)
This displays any messages from the fiscal authority. The message is specific to the return code. This information is defined in the fiscal authority documentation.

Specific actions

Use this action to generate the series number that you need to submit to the Portuguese fiscal authorities.

All: All sequence numbers for all companies and years. This can take a long time to process.

Sequence number: Enter the final sequence number. If you enter another number, you receive a blocking error and the generation is not carried out.

Company: Enter the Portuguese company for the sequence number.

Year: Enter the year.

All results display in the Selection list. For example, if the company has several sites, a series is generated for each site for the company.

When you first generate a series and you do not have the ATCUD code, the results are listed under ATCUD missing. After you submit the those series to the fiscal authorities and enter the returned ATCUD code or codes, the series are listed under ATCUD management.

Actions menu

Select this action to register a series with the tax authority. When the communication is successful, you receive the ATCUD code for this series.

Select this action to register a series with the tax authority. When the communication is successful, you receive the ATCUD code for this series.

Select this action to cancel a series with the tax authority. This is covered bylegal rules and you can only cancel a series that is not used.
Select this action to finalize a series with the tax authority. You can finalize a series at any time if you will no longer use the series.

Select this action to check the communication status with the tax authority.

To do this, you need to enter start and end dates under the Inquiry/Agreement inquiry block.

Select this action to check the status of an agreement with the tax authority.

To do this, you need to enter start and end dates under the Inquiry/Agreement inquiry block.

Error messages

The only error messages are the generic ones.

Tables used

Refer to the documentation on Implementation.