QAD Adaptive Applications

User Guide
QAD Internationalization Portugal
Extension

Introduction to Portugal Extension

Installation Procedures
Release Notes for Current Release
Invoice and Shipment Certification
Fiscal Registration
Reports
Movement of Goods Authorization
QR and ATCUD Codes
Release Notes for Previous Releases

70-3300-4.0
QAD Adaptive Applications
QAD Adaptive ERP 2019 and higher, or QAD Adaptive UX March 2023
July 2023
This document contains proprietary information that is protected by copyright and other intellectual
property laws. No part of this document may be reproduced, translated, or modified without the
prior written consent of QAD Inc. The information contained in this document is subject to change
without notice.

QAD Inc. provides this material as is and makes no warranty of any kind, expressed or implied,
including, but not limited to, the implied warranties of merchantability and fitness for a particular
purpose. QAD Inc. shall not be liable for errors contained herein or for incidental or consequential
damages (including lost profits) in connection with the furnishing, performance, or use of this
material whether based on warranty, contract, or other legal theory.

This document contains trademarks owned by QAD Inc. and other companies.

Copyright © 2023 by QAD Inc.

I19_Portugal_EE_WebUI_UG_v4_0.pdf/ymg/me5/su9

QAD Inc.
100 Innovation Place
Santa Barbara, California 93108
Phone (805) 566-6000
https://www.qad.com
 Contents
Chapter 1 Introduction to Portugal Extension . . . . . . . . . . . . . . . . . .1
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Checking the Version Number of Installed Extensions . . . . . . . . . . . . . . 3
Accessing the Portugal Functionality in Adaptive UX . . . . . . . . . . . . . . 4

Chapter 2 Installation Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . .7

Installing into Adaptive ERP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Notifications Report Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
License Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Program Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Movement of Goods Authorization Components . . . . . . . . . . . . . . . . . 13
Customizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Notifications Control Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Translations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Installing into Adaptive ERP and Adaptive UX . . . . . . . . . . . . . . . . . . . . . . . . . 23
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
License Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Granting User Access to User-Defined Fields in Adaptive UX . . . . . . 26

Chapter 3 Release Notes for Current Release . . . . . . . . . . . . . . . . .33

Release Notes for Release 4.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Product Name Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Updated Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
New Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Enhancements and Fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Document Change Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Chapter 4 Invoice and Shipment Certification . . . . . . . . . . . . . . . . .37

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
iv QAD Internationalization Portugal Extension User Guide

Chapter 5 Fiscal Registration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Fiscal Registration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Support in QAD Adaptive ERP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Fiscal Representation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Fiscal Registration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Chapter 6 Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45

SAF-T File for Portugal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Annex VAT Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
QAD Solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Annex O Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Annex P Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Chapter 7 Movement of Goods Authorization . . . . . . . . . . . . . . . . .69

Movement of Goods Authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Business Requirement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
QAD Solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Setting Up the Authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Assigning an Authorization to a Shipper Manually . . . . . . . . . . . . . . . . 74
Assigning an Authorization to a Shipper Electronically . . . . . . . . . . . . 75
Viewing Shippers’ Movement of Goods Authorization Code Details . 79

Chapter 8 QR and ATCUD Codes . . . . . . . . . . . . . . . . . . . . . . . . . . .81

QR and ATCUD Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Business Requirement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
QAD Solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Setting Up the QR Code Functionality . . . . . . . . . . . . . . . . . . . . . . . . . 82

Chapter 9 Release Notes for Previous Releases . . . . . . . . . . . . . . .97

Release Notes for 3.0.1 Release . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Release Notes for 3.0 Release . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Release Notes for 2.2 Release . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Release Notes for 2.1 Release . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Release Notes for 2.0 Release . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103

Questions? Visit community.qad.com

 Chapter 1

Introduction to Portugal
Extension
This chapter introduces the QAD Internationalization solution for Portugal.
Overview 2
This section introduces QAD Internationalization for Portugal, lists related documents, and
outlines how to access related QAD resources.
2 QAD Internationalization Portugal Extension User Guide

Overview
Globalization presents challenges to global manufacturing companies. QAD helps companies
master these challenges by offering a solution that accommodates international variations in
language, financial practices, business practices, and regulatory compliance.
QAD addresses the challenge of internationalization by standardizing applicable processes and
functions for global manufacturing companies through country extensions. Country extensions
provide customers country-specific functionality, primarily in the areas of tax and compliance
reporting and related data extraction. Country extensions include the following components:
• Support for electronic banking, paper payment formats, audit files, and specific report layouts
• Specific configuration and methods to handle local codes, local tax and compliance
requirements
Country-specific requirements are distributed using the QAD Store.
This document describes an add-on module that meets specific local requirements for Portugal.
The module only relates to final configuration and formatting for Portugal. All core business
processes and database changes are delivered in the core product.

Related Documents
The following documents provide supporting information:
• QAD Internationalization User Guide describes the QAD Internationalization functions that
let you configure multiple international environments using one generic set of functions.
• QAD Financials User Guide describes the QAD Financials module of Enterprise Edition,
which provides a complete solution for global manufacturing companies. It includes support
for invoice certification.
• QAD Global Tax Management User Guide describes Global Tax Management, which offers
precise tax calculations and flexible setup for calculating taxes for multiple countries.
• QAD Sales User Guide describes the sales and shipping solution. It includes support for
shipper certification.quired by the European Uniaon regylatios
• QAD Intrastat User Guide describes the QAD solution for generating the Intrastat reports for
EU countries as required by the European Union regulations.

QAD Support for Product Documentation and the QAD Knowledgebase

QAD’s Web site offers various support-related tools. From Support, you can perform the
following steps:
• To access release notes, user guides, installation and conversion guides, training guides, and
other similar documents by product and release, select Support and then select Document
Library.
• To access the topic-specific user forums, select Forums.
• To access an additional array of tools that can vary based on your company’s maintenance
agreement with QAD, select Support Center. These include the Knowledgebase and direct
links to QAD Support experts.

Questions? Visit community.qad.com

 Introduction to Portugal Extension 3

Note Some parts of the Support site require QAD customers and alliance partners to enter a user
ID and password. If you do not have a user ID, click the Register Now link on the log-in screen to
apply for the user ID.

Checking the Version Number of Installed Extensions

Internationalization Extensions (36.5.8.0.1) displays a list of the internationalization extensions
installed in an environment, and the version number of each of these extensions.
Note You can also access the menu in the Adaptive UX. For more information, see “Accessing
the Portugal Functionality in Adaptive UX” on page 4.
Fig. 1.1
Adaptive ERP: Internationalization Extensions (36.5.8.0.1)

Comments? Go to goo.gl/MfwKHm
4 QAD Internationalization Portugal Extension User Guide

Fig. 1.2
Adaptive UX: Internationalization Extensions

Accessing the Portugal Functionality in Adaptive UX

In addition to Adaptive ERP, QAD now provides functionality through Adaptive UX that includes
a Portugal Extension role.
This user guide describes the Portugal functionality in Adaptive ERP, but you can also access the
Portugal reports and the Internationalization Extensions menu from Adaptive UX.
The Online Help, available from the Help drop-down menu in Adaptive UX, describes the
behavior of Adaptive UX in detail. It includes a Reports section, which describes the options
available in all reports including the Portugal Extension reports.
Fig. 1.3
Adaptive UX: Link to the Online Help

Questions? Visit community.qad.com

 Introduction to Portugal Extension 5

In Adaptive UX, the reports are available through the Portugal Extension role menu, as shown in
Figure 1.4. Your administrator must assign the Portugal Extension role to you.
Fig. 1.4
Adaptive UX: Reports Role Menu Option, in the Portugal Extension Role Menu

Your administrator must also give you access to the Internationalization Extensions screen. You
can use the Menu Search to search for and select the menu, as shown in Figure 1.5. The menu will
only be listed in the search results if your administrator granted you the required access.
Fig. 1.5
Adaptive UX: Menu Search

Comments? Go to goo.gl/MfwKHm
6 QAD Internationalization Portugal Extension User Guide

Questions? Visit community.qad.com

 Chapter 2

Installation Procedures
This chapter provides instructions for installing the extended internationalization features for
Portugal into QAD Adaptive ERP and QAD Adaptive UX environments.
Installing into Adaptive ERP 8

This section describes instructions for installing the extended internationalization features for
Portugal into a QAD Adaptive ERP environment.
Installing into Adaptive ERP and Adaptive UX 23

This section describes the procedure of installing the extended internationalization features for
Portugal into a QAD Adaptive UX environment.
8 QAD Internationalization Portugal Extension User Guide

Installing into Adaptive ERP

Requirements
The internationalization extension features for Portugal require QAD Adaptive ERP 2019 or
higher.
Due to new I19 packaging formats, install YAB 1.6 or higher.

Movement of Goods Authorization Requirements

The following software must be installed in the server as prerequisites to sending a shipper
authorization to the Tax and Customs Authority—Autoridade Tributária e Aduaneira (AT) —Web
service:
• OpenSSL (the latest version or at least version 1.0.2.*)
• cURL

Important Install cURL compiled with OpenSSL, supporting TLS 1.2 and https protocols.

For more information about cURL and OpenSSL, see “Movement of Goods Authorization
Components” on page 13.
In addition, the Movement of Goods Authorization functionality requires one folder that is
readable and one folder that is writable by the application in order to exchange files with the tax
authorities. Specify these folders in the Outbound Folder and Inbound Folder fields of the Site AT
Control menu (36.5.8.7.2.1). For more information about the Movement of Goods Authorization,
see QAD Internationalization User Guide.

Notifications Report Requirements

The Internationalization Releases Notifications included in the i19-library (automatically installed
while installing the Portugal app) require QAD Adaptive ERP 2019 or higher.
To send notifications to users using Notifications Report Web service, the following software must
be installed on the server as prerequisites:
• cURL - the minimum version: 7.29.0
• Mail User Agent (Mailx)

Procedure
Important To determine if you need to install this extension using QDT or YAB, see Table 2.4.

Questions? Visit community.qad.com

 Installation Procedures 9

Table 2.1 
Installation Procedures
Adaptive ERP On-Premise or 
Environment Cloud Installation QDT or YAB Procedure
2019 EE or higher Cloud YAB “Installing the Portugal Internationalization
Extension in a YAB Environment – Cloud
Installation” on page 9
2019 EE or higher On-Premise YAB “Installing the Portugal Internationalization
Extension in a YAB Environment – On-Premise
Installation” on page 9

Important If there are customizations in the propath that share the same file name as a program
included in this internationalization extension, then those customizations take precedence and the
package will not install completely. It is best practice to create customizations with a unique file
name so that they do not conflict with the package.

Installing the Portugal Internationalization Extension in a YAB Environment – Cloud

Installation

For information about installing the Portugal Internationalization Extension into an Adaptive ERP
cloud environment, contact QAD Cloud Operations.

Installing the Portugal Internationalization Extension in a YAB Environment – On-Premise

Installation

If you install the Portugal Internationalization Extension in an on-premise environment of version

2019 EE or higher, use the YAB client.
YAB is a deployment and management toolset that covers all products installed into an Adaptive
ERP environment. You can use it to start, stop, reconfigure, and maintain the consistency of your
Adaptive ERP environments. Your environment is defined in terms of discrete units, or packages,
which you can replace and add as needed.
See QAD Enterprise Edition Installation Guide for more information about using YAB.
To install this extension using YAB, perform the following steps:
1 Set the downtime for the environment.
Note Installation can take from 1 to 2 hours depending on the location of the server and how
many packages are required to be downloaded.
2 Back up the database and Adaptive ERP.
3 Download the add-on file from the QAD Store or from QAD Release Fulfillment.
4 Move the file to a file system that is accessible from the UNIX host where your Adaptive ERP
environment is installed.
5 Change to the directory where Adaptive ERP is installed.
cd directory

6 Install the Portugal Installation Extension by entering the following command:

yab install zip file

Comments? Go to goo.gl/MfwKHm
10 QAD Internationalization Portugal Extension User Guide

where zip file is the name of the file you received from QAD.
For example,
yab install i19pt-ee-app-image-encrypted-X.X.X.X.zip
where each X represents a number for that particular package.

Additional Steps to Upgrade from Version 1.x to the Current Version

From version 1.0 patch 2 of this extension onward, the SAFT-PT audit interface is available from a
new menu number.
If you install this version of the Portugal Internationalization Extension as a replacement for
version 1.0.1 or version 1.0, then run a utility to remove the old menu for this audit interface. The
utility removes the generalized codes associated with the old menu.
To run the utility, perform the following steps:
1 Open Progress Editor (36.25.80).
2 Enter run us/ut/utpormgen.p and press F1.
Fig. 2.1
Progress Editor (36.25.80)

Note If you run the utility with the Update field set to No, a report shows the content to be
removed, but no content is deleted, as shown in Figure 2.2.
Fig. 2.2
Running the Utility without Updating Generalized Codes

3 To delete the data, run the utility again with the Update field set to Yes.

Questions? Visit community.qad.com

 Installation Procedures 11

Fig. 2.3
Running the Utility and Updating Generalized Codes

4 To confirm that the data is removed, run the utility for a third time, with the Update field set to
No. The resulting report shows that there is no content for removal.
Fig. 2.4
Empty List of Generalized Codes for Removal

License Code
To use the installed QAD Internationalization Portugal extension, specify a valid license code.

Troubleshooting
Installation output is captured in a log file:
[OS temp directory]/installation.[user].log

The logging threshold can be adjusted to capture additional information to diagnose the problem,
by setting the loglevel argument when the installer is run.
-Dloglevel=[error,warn,info,debug,trace]

For example:
-Dloglevel=debug

If the installation fails without writing to the log file, an error occurred while setting up the
environment to run the installer. These kinds of boot issues can be diagnosed in the following
way:

Comments? Go to goo.gl/MfwKHm
12 QAD Internationalization Portugal Extension User Guide

• Windows: Hold down the <CTRL> key immediately after launching the installer until a
console window appears.
• UNIX: Set the following environment variable before running the installer:
export LAX_DEBUG=true

Known Issues

YAB Installation Errors Related to finudf and fin-sync

During YAB installations, you can receive an error related to finudf or fin-sync:
BuildContext - finudf-i19pt-update ERROR
BuildContext - fin-sync-run-update ERROR

To resolve these errors, upgrade to the latest YAB version or assign a blank password to the mfg
user before restarting the installation.

Running QRF Reports that Use Financial APIs

In a YAB environment, you can encounter an issue when running QAD Reporting Framework
reports that use Financial APIs. QAD Reporting Framework crashes if the propath is incorrect.
To resolve this issue—after the extension is installed in a YAB environment—specify the
Financials proxy source to include in the MFG application server propath:
1 Edit build/config/configuration.properties:
#@append
appserver.mfg.propath=$ {packages.fin-src-proxy.dir}

2 Apply the change:

yab appserver-mfg-update

3 Restart the application.

Installing the Extension in an Environment with Existing Internationalization Extensions

When you try to install this internationalization package in an environment that contains packages
for other countries, and these packages depend on old versions of the i19-library package or
i19-intrastat package, the following error occurs:
ERROR [main] Boot - The request does not have a solution.

To fix this error, reinstall all internationalization packages using the latest version of the package
that is causing this issue—i19-library or i19-intrastat.
Or, as a temporary solution, perform the following steps:
1 Update the configuration.properties file to treat all references to i19-library as
references to the latest package version; for example, i19-library-1.0.0.11:
dependency.redirects=i19-library=i19-library-1.0.0.11

2 Apply the change:

yab -check-for-updates -r -v

Questions? Visit community.qad.com

 Installation Procedures 13

3 Try to install the zip file for the new package again.
4 Run the yab info command; ensure that all expected packages are listed.
Important Review this setting with each internationalization extension installation. If a new
package requires a new version of the i19-library or i19-intrastat package, update the
dependency.redirects setting accordingly.

Example The i19bl-ee-app package is already installed and depends on the i19-library
package, version 1.0.0.3. You try to install the i19pt-ee-app package, which depends on the
latest version of the i19-library package—1.0.0.11; an error occurs. As a temporary solution,
update the configuration.properties file with the latest version of the i19-library
package, dependency.redirects=i19-library=i19-library-1.0.0.11, and try to
install the i19pt-ee-app package again.

Program Access
If you cannot access the programs described in QAD Internationalization Portugal Extension User
Guide, run System Synchronize (36.24.3.2). For more information about System Synchronize, see
QAD System Administration Guide.

Movement of Goods Authorization Components

QAD Internationalization Portugal Extension User Guide describes how you can electronically
request a mandatory movement of goods authorization for shippers from the Tax and Customs
Authority—Autoridade Tributária e Aduaneira (AT) —Web service.
To request movement of goods authorization electronically, install the following communication
software:
• Download and install cURL software (http://curl.haxx.se/download.html).
• Ensure that OpenSSL is installed and updated in Unix to the latest version.

Comments? Go to goo.gl/MfwKHm
14 QAD Internationalization Portugal Extension User Guide

Fig. 2.5
Adaptive ERP: System Maintain (36.24.3.1)

For more information about installing OpenSSL, see the Invoice Certification section of QAD
Financials User Guide.

Customizations

UI Customizations

All UI customizations for the Portugal package are implemented at role level, and are only visible
to users with QAD Portugal Role assigned. Create this role in Role Create (36.3.6.1). Ensure that
all users who need access to the Portugal customizations have their default role set to QAD
Portugal Role in Role Membership Maintain (36.3.6.6).
For more information about roles and permissions, see QAD Security and Controls User Guide.

Non-Intrusive Customizations

The extended internationalization features for Portugal include customizations to the following
program:
• bgl.p

If you previously customized this program, complete program merges to save your customizations
and the Portugal package customizations.
The program is located in the main directory of the package. After you complete the required
merges, place the programs in the AppServer propath where you usually save the financial
customizations. Compile the programs, and then trim the fin server. Finally, check if the
customizations were detected by using the Customization tab in System Monitor (36.24.3.4).

Questions? Visit community.qad.com

 Installation Procedures 15

Importing UI Customizations

Internationalization Portugal Extension provides customizations for the components listed in

Table 2.2.
Table 2.2 
Components with Customizations for Internationalization Portugal Extension
Component
GL Account
Customer Invoice

Note The customizations are performed at role level. If you have customizations for these
components at the general level, or want to save customizations at a different level, then add your
customizations manually. For more information, see “Verifying Existing Customizations” on
page 15 and “Adding the UI Customization Manually” on page 16.

Loading a UI Customization

If you have no UI customizations for the components listed in Table 2.2, then you can import the
customizations collectively. You can find the .xml file to import all customizations in the
UI_Customization folder in the Customizations.zip file. Copy the necessary .xml files to
the needed location on the server.

Verifying Existing Customizations

To verify existing customizations, perform the following steps:

1 Access Export UI Customization (36.4.26).
2 View the contents of the Business Component drop-down menu. This menu contains an entry
for each existing customization.
3 View the contents of the Customization Level field. If this field displays Role, then loading the
customization delivered with the Portugal extension overwrites existing customizations in the
system.
Fig. 2.6
Adaptive ERP: Export UI Customization, Customization Level

Comments? Go to goo.gl/MfwKHm
16 QAD Internationalization Portugal Extension User Guide

Adding the UI Customization Manually

The following user-defined fields are delivered with the Internationalization Portugal Extension
package, and are only visible to users with QAD Portugal Role assigned.
Table 2.3 
User-Defined Fields
Component User-Defined Field UI Field Label
GL Account GL.CustomShort19 Taxonomy Code
Customer Invoice DInvoice.QADC01 ARCNo

Customer Invoice Customization

1 Access Customer Invoice View (27.1.1.3). Select an invoice.

2 Click Tools. Click Design Mode.
Fig. 2.7
Adaptive ERP: Design Mode

3 Set Customization Level to Role, and select QAD Portugal Role as the role.
Fig. 2.8
Adaptive ERP: Set Design Mode

4 In the General tab, add the ARCNo field, as shown in Figure 2.9:

Questions? Visit community.qad.com

 Installation Procedures 17

Fig. 2.9
Adaptive ERP: Customer Invoice Customization

5 Close the Field list/properties window. Select Role as the customization level. Ensure that
QAD Portugal Role is selected. Save the customization for all activities.

Removing Outdated Customizations

The Taxonomy Reference field was removed from GL Account (25.3.13). You can now add it to
the Portugal SAFT-PT Control File (36.5.8.7.1.4) selection criteria. For more information, see
QAD Internationalization Portugal Extension User Guide.
If you have the Portugal 2.0 Patch 1 package installed, you must revoke the GL Account (25.3.13)
UI customizations by performing the following steps:
1 Access Customization Delete (36.4.18.3).
2 Click Apply.
3 For Layer = ROLE (QAD Portugal Role) and Business Component = GL Account, specify All
in the delete column for all available activities.

Comments? Go to goo.gl/MfwKHm
18 QAD Internationalization Portugal Extension User Guide

Fig. 2.10
Adaptive ERP: Customization Delete

4 Click Delete.

GL Account Customization

To customize GL Account, perform the following steps:

1 Access GL Account View (25.3.13.3). Select a GL Account.
2 Click Tools. Click Design Mode.
Fig. 2.11
Adaptive ERP: GL Account View, Design Mode

Questions? Visit community.qad.com

 Installation Procedures 19

3 Set Customization Level to Role, and select QAD Portugal Role as the role.
Fig. 2.12
Adaptive ERP: Set Design Mode

4 In the General tab, add the Taxonomy Code field, as shown in Figure 2.13:
Fig. 2.13
Adaptive ERP: GL Account Customization

5 Close the Field list/properties window. Select Role as the customization level. Ensure that
QAD Portugal Role is selected. Save the customization for all activities.

Notifications Control Components

Users must receive email notifications about the newly released versions of I19 country
extensions. QAD Internationalization Releases Notifications User Guide describes how you can
configure Notifications Control and set up Notifications Report. To configure Notifications
Control, set up the following menus:
• E-Mail Definition Maintenance (36.4.20)
• User Maintenance (36.3.1)

Setting Up E-Mail Definition Maintenance

Access E-mail Definition Maintenance (36.4.20) and define the command line for each system that
you want to access, as shown in Figure 2.14. For more information about maintaining email
definitions, see QAD System Administration Guide.

Comments? Go to goo.gl/MfwKHm
20 QAD Internationalization Portugal Extension User Guide

Fig. 2.14
Adaptive ERP: Email Definition Maintenance (36.4.20)

E-mail System. Specify I19Notif.

Operating System. Specify the name of the operating system on the user’s computer. You can
specify one of the following values: UNIX or WIN32.
Start Effective. Specify the start date when the system is available for use.

End Effective. Specify the end date when the system is available for use. This is an optional
field.
Description. Specify a brief description of this system.

Path and Program Name. Specify the complete path to the executable email application file.

Setting Up User Maintenance

After you set up E-mail Definition Maintenance, link the defined email system to the user who will
run Notifications Report.
Access User Maintenance (36.3.1) and specify values for E-mail Def and E-mail Address, as
displayed in Figure 2.15. For more information about maintaining email definitions, see QAD
System Administration Guide.

Questions? Visit community.qad.com

 Installation Procedures 21

Fig. 2.15
Adaptive ERP: User Maintenance (36.3.1)

User ID. Specify the ID of the user.

User Name. Check the user name. This field is populated automatically.

Language. Check the language.

Country Code. Check the code of the country.

User Type. Check the type of the user.

Time Zone. Check the time zone.

E-mail Def. Specify i19Notif.

E-mail Address. Specify the user’s email address to send the notifications to.

Setting Up the Night Batch

You can automate the process of generating reports by scheduling them to run automatically at
specified time or intervals.
If you set up a night batch for Notification Report, the report will automatically run outside of
working hours, and users will receive updates on new releases every day. This step is optional. For
more information about setting up the night batch for the QRF report, see the “Set up batch run for
QRF report” procedure in QAD Reporting Framework User Guide.

Comments? Go to goo.gl/MfwKHm
22 QAD Internationalization Portugal Extension User Guide

Translations
Internationalization Releases Notifications functionality is available in English. Other languages
will be added later. To translate notifications messages, access Message Maintenance (36.4.6.1)
and fill in the fields.
Fig. 2.16
Adaptive ERP: Message Maintenance (36.4.6.1)

Language ID. Select the relevant language from the lookup.

Message Number. Specify the relevant message number, depending on the message type that
users will receive. The following message numbers are available for this field:
• 15647. For this message number, translate the following message into the required
language: New I19 Country Extension Available.
• 15648. For this message number, translate the following message into the required
language: &1 &2 is available to install starting &3, where:
• &1 is the code for the package name
• &2 is the code for the package release version
• &3 is the code for the release date
Message. Specify the translated message to correspond to the message number that you
specified

Questions? Visit community.qad.com

 Installation Procedures 23

Installing into Adaptive ERP and Adaptive UX

Requirements
The extended internationalization features for Portugal are compatible with the QAD Adaptive UX
March 2023 version, and Portugal 4.0 Adaptive ERP App.
For Portugal 4.0 package, the following dependencies are required:
• qad-enterprise-platform[3.28.0.280,4.0)
• i19pt-ee[4.0.0)

Procedure
Important To determine if you need to install this extension using QDT or YAB, see Table 2.4.

Table 2.4 
Installation Procedures
Adaptive ERP On-Premise or 
Environment Cloud Installation QDT or YAB Procedure
2019 EE or higher Cloud YAB “Installing the Portugal Internationalization
Extension in a YAB Environment – Cloud
Installation” on page 9
2019 EE or higher On-Premise YAB “Installing the Portugal Internationalization
Extension in a YAB Environment – On-Premise
Installation” on page 9

Important If there are customizations in the propath that share the same file name as a program
included in this internationalization extension, then those customizations take precedence and the
package will not install completely. It is best practice to create customizations with a unique file
name so that they do not conflict with the package.

Installing the Extension in a YAB Environment – Cloud Installation

For information about installing the Portugal Internationalization Extension into an Adaptive ERP
cloud environment, contact QAD Cloud Operations.

Installing the Extension in a YAB Environment – On-Premise Installation

If you install the Portugal Internationalization Extension in an on-premise environment of version

2019 EE or higher, use the YAB client.
YAB is a deployment and management toolset that covers all products installed into an Adaptive
ERP environment. You can use it to start, stop, reconfigure, and maintain the consistency of your
Adaptive ERP environments. Your environment is defined in terms of discrete units, or packages,
which you can replace and add as needed.
See QAD Enterprise Edition Installation Guide for more information about using YAB.
To install this extension using YAB, perform the following steps:

Comments? Go to goo.gl/MfwKHm
24 QAD Internationalization Portugal Extension User Guide

1 Set the downtime for the environment.

Note Installation can take from 1 to 2 hours depending on the location of the server and how
many packages are required to be downloaded.
2 Back up the database and Adaptive ERP.
3 Download the add-on file from the QAD Store or from QAD Release Fulfillment.
4 Move the file to a file system that is accessible from the UNIX host where your Adaptive ERP
environment is installed.
5 Change to the directory where Adaptive ERP is installed.
cd directory

6 Install the Portugal Installation Extension by entering the following command:

yab install zip file
where zip file is the name of the file you received from QAD.
For example,
yab install i19pt-web-app-image-encrypted-X.X.X.X.zip
where each X represents a number for that particular package.

Additional Steps to Upgrade from Version 1.x to the Current Version

From version 1.0 patch 2 of this extension onward, the SAFT-PT audit interface is available from a
new menu number.
If you install this version of the Portugal Internationalization Extension as a replacement for
version 1.0.1 or version 1.0, then run a utility to remove the old menu for this audit interface. The
utility removes the generalized codes associated with the old menu.
To run the utility, perform the following steps:
1 Open Progress Editor (36.25.80).
2 Enter run us/ut/utpormgen.p and press F1.
Fig. 2.17
Progress Editor (36.25.80)

3 The utility starts, as shown in Figure 2.2.

4 If you run the utility with the Update field set to No, a report shows the content to be removed,
but no content is deleted.

Questions? Visit community.qad.com

 Installation Procedures 25

Fig. 2.18
Running the Utility without Updating Generalized Codes

5 To delete the data, run the utility again with the Update field set to Yes.
Fig. 2.19
Running the Utility and Updating Generalized Codes

6 To confirm that the data is removed, run the utility for a third time, with the Update field set to
No. The resulting report shows that there is no content for removal.
Fig. 2.20
Empty List of Generalized Codes for Removal

License Code
To use the installed QAD Internationalization Portugal Extension, specify a valid license code.

Comments? Go to goo.gl/MfwKHm
26 QAD Internationalization Portugal Extension User Guide

Granting User Access to User-Defined Fields in Adaptive UX

A user’s access to the user-defined fields available for Portugal in Adaptive UX is determined by
the Design Layout.
Note For more information about using the Design Layout, see QAD Platform Developer’s
Guide, which is available as part of the QAD Adaptive UX Release documents for September
2019.
A system-level Design Layout, QAD Portugal Extension, is automatically installed as a part of this
extension.
This layout contains all of the fields listed in Table 1.3 on page 11 as available in Adaptive UX.
These fields appear in Portugal Extension panels in the screens that correspond to the components
listed in Table 1.2 on page 10. You can access the fields in the QAD Portugal Extension layout in a
number of ways:
• Copy this layout and set it as the active layout, on either a system-wide or domain basis. This
approach is useful when you are currently using the default layout, rather than a customized
layout that contains additional user-defined fields. For more information, see “Switching from
the Default Layout to the QAD Portugal Extension Layout” on page 26.
• Add the user-defined fields from the QAD Portugal Extension layout to an existing active,
customized layout that you are using on either a system-wide or domain basis.

Switching from the Default Layout to the QAD Portugal Extension Layout

If you are using the default system layout, you can copy the QAD Portugal Extension layout and
make it active to make the additional fields visible across all domains, or in a single domain.
Note While it is possible to make the read-only QAD Portugal Extension layout active, the
recommended approach is to copy and rename the layout, and then set this new layout as Active.
1 Access a screen that contains user-defined fields, for example, the Customer Invoices screen.
2 Access Design Layout by clicking More and then clicking Design Layout.
3 Select the QAD Portugal Extension layout, as shown in Figure 2.21.

Questions? Visit community.qad.com

 Installation Procedures 27

Fig. 2.21
Adaptive UX: Selecting the Portugal Extension Layout

4 Click Continue to open the Design Layout for the screen, as shown in Figure 2.22. This
Design Layout is read-only. Scroll or click on the panel title to view the Portugal Extension
panel.
Note You can select the Portugal Extension panel to see details of the user-defined fields to
the right of the screen.
Fig. 2.22
Adaptive UX: QAD Portugal Extension Design Layout, Customer Invoices Screen with Portugal Extension Panel

5 Click More -> New Layout.

6 In the New Layout pop-up window, perform the following steps:
a Assign a new name and description to the layout.

Comments? Go to goo.gl/MfwKHm
28 QAD Internationalization Portugal Extension User Guide

b Use the Layout Content field to make the layout available in all domains—system wide—
or in a single domain, as show in Figure 2.23.
c Click Continue to save the new layout and return to the Design Layout screen, which now
shows the new layout name at the top of the screen.
Fig. 2.23
Adaptive UX: New Layout Pop-Up Window

7 Set the new layout to Active by clicking Manage Active Layouts in the Set Layout Properties
section to the right of the layout, as shown in Figure 2.24.
Fig. 2.24
Adaptive UX: Set Layout Properties

8 Ensure that you make your chosen layout active by setting the Active field to Yes, as shown in
Figure 2.25, and clicking Apply.
Important An active domain-level layout takes precedence over the system-level layout.

Questions? Visit community.qad.com

 Installation Procedures 29

Fig. 2.25
Adaptive UX: Manage Active Layouts

9 In the Confirm Active Layout Change, review the proposed change and click Confirm, as
shown in Figure 2.26.
Note After each update to the layout, refresh the screen to see your changes.

Fig. 2.26
Adaptive UX: Confirm Active Layout Change

Adding the User-Defined fields from the Extension Layout to an Existing Customized
Layout

If you are already using a customized layout, you can create a new layout that includes the
functionality in both your existing layout and the QAD Portugal Extension layout. You can create
this layout at the system level or at the domain level using one of the existing layouts as a template.
It is not possible to merge two or more layouts automatically—you must create a new layout that
contains the elements of the other layouts.
1 Access the screen that contains the user-defined fields; for example, the Customer Invoices
screen.
2 Access Design Layout by clicking More and then clicking Design Layout.
3 Select New Layout.

Comments? Go to goo.gl/MfwKHm
30 QAD Internationalization Portugal Extension User Guide

4 Complete the Name, Description, and Layout Context fields and choose an existing layout
template, as shown in Figure 2.27. In this example, the layout is at the domain level. Click
Continue to create the layout.
Fig. 2.27
Adaptive UX: Creating a New Design Layout Based on an Existing Layout

5 In the Customized Layout screen, expand the Add to Layout section and drag the Panel form
element into the layout.
Fig. 2.28
Adaptive UX: Add to Layout and New Panel

6 Update the panel label to Portugal Extension and drag the user-defined fields for Portugal to
the panel.
Note You can add the panel title as a hard-coded string, or click the lookup to select a
translatable string.

Questions? Visit community.qad.com

 Installation Procedures 31

Fig. 2.29
Adaptive UX: Customized Design Layout with Portugal Extension Content

7 Click Save to save the layout updates.

Comments? Go to goo.gl/MfwKHm
32 QAD Internationalization Portugal Extension User Guide

Questions? Visit community.qad.com

 Chapter 3

Release Notes for Current

Release
This chapter describes the release notes for the current Portugal extension package release.
Product Name Changes 34

This section describes the product changes for the current Portugal extension package release.
Document Change Summary 35

This section describes significant differences between the current Portugal extension package
release and its previous versions.
34 QAD Internationalization Portugal Extension User Guide

Release Notes for Release 4.0

These release notes include information about the latest QAD Internationalization Portugal
extension fixes and changes. To view a set of cumulative release notes for earlier versions of the
extension, see “Release Notes for Previous Releases” on page 97.
Note Starting from September 2019, the name for QAD’s complete portfolio of products is QAD
Adaptive Applications, and QAD Adaptive ERP is the name for QAD’s flagship ERP solution.
QAD Adaptive ERP includes the functionality previously associated with QAD Cloud ERP and
QAD Enterprise Applications - Enterprise Edition (EE).

Product Name Changes

Review this document before proceeding. QAD highly recommends that you implement the latest
QAD Internationalization release available. Check the QAD Store site to make sure you have the
latest documentation and installation media.
https://store.qad.com

Updated Functionality
This QAD Internationalization Portugal extension package contains the following updated
functionality:
• The AT Authorization selection criteria includes new Effective Date, Assign Dispatch Date,
Assign Dispatch Time, and Show Previously Authorized Shippers selection fields.
• The AT Authorization report output is converted from the 4GL to the QRF format.
• Excel layout option is added for the AT Authorization report.
• Portugal Enable Fiscal Registration contains a new Company field that enables printing the
VAT ID of the specified company in Portugal Annex O Report, Portugal Annex P Report, and
Portugal SAF-T Declaration.

New Functionality
This QAD Internationalization Portugal extension package contains the following new
functionality:
• Portugal Pre-Shipper/Shipper Print now enables printing the shipper invoices including the
QR and ATCUD code.

Enhancements and Fixes

To view tickets related to enhancements and fixes in the QAD Internationalization Portugal
extension package, version 4.0, see the following links:
• QAD Adaptive ERP Product Changes UI
• QAD Adaptive UX Product Changes UI

Questions? Visit community.qad.com

 Release Notes for Current Release 35

Document Change Summary

The following table summarizes significant differences between this document and the previous
versions.

Date/Version Description Reference

July 2023, v.4.0 Updated the QAD Solution for Fiscal Registration in Portugal section. page 41
Updated the Assigning an Authorization to a Shipper Electronically page 75
section.
Added the Portugal Pre-Shipper/Shipper Print with QR Code and page 93
ATCUD code section.
January 2023, v. 3.0.1 Minor editorial changes --
December 2020, v3.0 Added the QR and ATCUD Codes chapter. page 81
Added the Accessing the Portugal Functionality in Adaptive UX page 4
section.
Added a new Fiscal Registration chapter. page 40
Updated the Setting Up the Document Number Element in Generalized page 49
Codes Maintenance section.
Added the Tax Exemption field description in the Setting Up Tax page 52
Exemption Information section.
Added the Setting Up Taxonomy Code section. page 54
Updated the Report Access section and added the Supplier field page 58
description.
Updated the SAF-T Output File section. page 60
Updated the Annex O Report section. page 63
Updated the Annex P Report section. page 66
April 2019, v2.2 Updated the SAFT-PT report section, including the selection criteria page 46
and report output, to reflect the updated solution.
June 2018, v2.1 Updated information for setting up the SAFT-PT report. page 46
Added information about setting up the Annex O and Annex P reports. page 63,
page 66
Updated information for setting up the Movement of Goods page 70
Authorization.
January 2017, v2.0 Added information about the Internationalization Extensions menu, page 3
which lists the version number of each internationalization extension
installed in an environment.
Updated the invoice certification and SAF-T file information. page 46,
Added a section about the movement of goods authorization. page 70
November 2013, v1.0 First release of package. --

Comments? Go to goo.gl/MfwKHm
36 QAD Internationalization Portugal Extension User Guide

Questions? Visit community.qad.com

 Chapter 4

Invoice and Shipment

Certification
Overview 38
This section outlines invoice and shipment certification requirements for Portugal and advises you
on where you can find more information about the QAD solution.
38 QAD Internationalization Portugal Extension User Guide

Overview

Business Requirement
Invoice certification is a legal requirement in Portugal. Invoice certification involves associating a
customer invoice with a unique, encrypted digital signature. Adding a signature uniquely identifies
the origin and the main properties of an invoice. This information must be supplied to the
government so that it can verify that the reported amounts and the invoice numbers in the SAF-T
audit file comply with the information in the encrypted signatures.
Similarly, shipment certification is a legal requirement in Portugal and involves associating a
shipper with a unique, encrypted digital signature. The signature is based on the main properties of
the shipper such as the shipper confirm date and signature creation date/time. This information
must be supplied to the government so that it can validate that reported shipper details comply with
the information in the encrypted signatures.

QAD Solution
QAD Enterprise Financials 2011.1 and higher were certified by the Portugal government
according to Decree 363/2010 requirements for invoice certification. It is possible to create a
digital signature for each invoice and shipper. You can then output these details to audit files, such
as the SAF-T file, to send to the government.
For a full explanation of invoice certification in QAD Enterprise Financials, including the required
setup, see QAD Financials User Guide.
For a full explanation of shipment certification, including the required setup, see QAD Sales User
Guide.
For a description of the QAD SAF-T solution for Portugal, see “SAF-T File for Portugal” on
page 46.

Questions? Visit community.qad.com

 Chapter 5

Fiscal Registration
This chapter describes fiscal registration support in the QAD Internationalization Portugal
extension. It also outlines the concept of fiscal representation.
Overview 40
This section outlines the fiscal registration concept.
Support in QAD Adaptive ERP 40
This section describes the QAD solution to support fiscal registration and fiscal representation.
40 QAD Internationalization Portugal Extension User Guide

Overview
A fiscal representative acts on behalf of another party, such as a foreign company, performing
various financial duties such as ensuring compliance with local accounting rules or fulfilling tax
reporting obligations in a particular country.

Fiscal Registration
In a number of countries, including those in the European Union, companies can do business in a
country, without having a legal entity in that country. To do this, companies must register as a non-
resident VAT trader—fiscal registration.
Fiscal registration ensures that businesses that are not established in a country and that do not have
any presence locally—premises, employees, bank accounts, and so on—can register for VAT,
despite being non-resident.
After the company is registered, it must comply with the relevant VAT and compliance laws of that
country.
In case a foreign company has a fiscal registration in Portugal, the VAT amount paid must be
submitted to the corresponding foreign government authorities—which means that it must be in all
reports regarding VAT. For the same foreign company, the VAT amount is also submitted to the
Portugal law and to the Portugal Government, except those related to foreign operations which can
not be reported in duplicate.

Support in QAD Adaptive ERP

Fiscal Representation
Several country electronic declaration structures have a section where the properties of the fiscal
representation can be added—name, address, tax identification, main contact, and so on.
The relevant internationalization country extensions provide the possibility to enter the data for
that section. Usually, this is done through a menu item with the name format: <COUNTRY>
<REPORTING NAME> Control File.

Fiscal Registration
The concept of a fiscal registration has a major impact on the data that is submitted. In standard
reporting, transactions are queried at the entity level. Because transactions for the fiscal
registration are also stored on the level of (and together with the transactions of) the entity to
which the registration is legally connected, the query logic must be refined.
Example A company has a legal entity in Portugal but has fiscal registration in Hungary.
Transactions subject to the Portugal VAT legislation must be reported to the Portugal tax
authorities. Transactions originating from the fiscal registration, subject to Hungarian legislation,
must be reported to the Hungarian tax authorities.

Questions? Visit community.qad.com

 Fiscal Registration 41

QAD’s Internationalization Extensions provide fiscal registration functionality on a country basis.

The functionality varies from country to country, to accommodate the various reporting
requirements, but shares a common approach:
8 Enable fiscal registration for a particular country for a given legal entity.
9 Identify fiscal registration currency.
10 Create an Exchange Rate Type PT Statutory ER for fiscal registration currency.

11 Apply exchange rates for fiscal registration currency.

12 Identify the taxable base and tax amounts that you want to report to the tax authority of the
legal entity and all its fiscal registrations. This is usually done by defining the tax codes for
which the transactions must be reported.
13 Specify the particular submissions, such as declarations or reports, that you want to send to the
tax authority.
14 Review the fiscal registration settings.

15 Create the submissions for the entity.

The fiscal registration functionality for each country is available in the QAD Internationalization
Extension of that country and is explained in the related user guide.
Note The number of QAD Internationalization Extensions that include fiscal registration
functionality is expected to increase over time. For the most up-to-date information about a
particular country, see the QAD Internationalization Extension user guide for that country.

QAD Solution for Fiscal Registration in Portugal

If your company is based outside of Portugal but conducts sales in Portugal and is required to
make tax returns to the Portugal authorities, you can use the fiscal registration functionality
included in this extension to record and report the necessary information.
The QAD fiscal registration solution for Portugal is available for the following reports:
• Portugal SAFT-PT (for monthly and self-billing declaration types only)
• Annex O Report
• Annex P Report

To avail of this solution, complete the prerequisite and follow the flow before preparing and
running the reports as described in the related sections of this guide.

Prerequisite

Ensure that all tax setup for your entity and any related entities is complete. You must set up tax
codes by entity. For more information about tax setup, see QAD Global Tax Management User
Guide.

Comments? Go to goo.gl/MfwKHm
42 QAD Internationalization Portugal Extension User Guide

Flow

1 Use Portugal Enable Fiscal Registration (36.5.8.7.13) to enable or disable the Portugal fiscal
registration feature for the relevant entity.
Fig. 5.1
Adaptive ERP: Portugal Enable Fiscal Registration (36.5.8.7.13)

Entity. Select the entity for which you want to enable or disable the Portugal fiscal
representation functionality.
Active. To enable the Portugal fiscal representation functionality for the selected entity, select
this field. In this scenario, the other fiscal representation setup is required for the entity.
Currency. Specify the currency in which the reports are submitted to the government.

Company. Specify the company code. The VAT ID of the specified company will be printed in
the following reports:
• Portugal Annex O Report
• Portugal Annex P Report
• Portugal SAF-T Declaration

2 Configure the fiscal registration settings for the entity in Portugal Fiscal Registration Control
(36.5.8.7.14).
Fig. 5.2
Adaptive ERP: Portugal Fiscal Registration Control (36.5.8.7.14)

Entity. Specify the entity for which you want to configure fiscal registration settings.

Tax Code, Report. For the selected entity, specify each tax code that you want to include in
each report. Add each combination of tax code and report individually.
Note To select a report, first select a tax code and then click Next to bring the focus to the
Report field or Reports area. Then use the Insert key to add a report.

Questions? Visit community.qad.com

 Fiscal Registration 43

3 Review the settings in Portugal Fiscal Registration Browse (36.5.8.7.15) and make any
necessary adjustments.
Fig. 5.3
Adaptive ERP: Portugal Fiscal Registration Browse (36.5.8.7.15)

4 Create a fiscal registration exchange rate that you can use to make any necessary currency
conversions in the Portugal reports. When running the reports, you can then choose the fiscal
registration currency in the selection criteria instead of the base currency or statutory currency.
Note If you select the fiscal registration currency in the report selection criteria, then the
system uses the following order to determine which currency type to take amounts from:
• If you have a fiscal registration rate specified for the currency and date related to the
transaction, this rate is used to convert the amount to euro.
• If the base currency is in euro, the base currency is used to report this transaction in the
report.
• If the statutory currency is in euro, the statutory currency is used to report this transaction
in the report.
• Otherwise, an error is recorded in the report output.

To convert the invoice amounts in each transaction selecting the effective date exchange rate, each
report must be generated in EUR using the following criteria:
• Use transaction currency amount in transactions in case this currency is equal to Declaration
Currency (set up in Portugal Enable Fiscal Registration).
• If the transaction currency amount is not equal to Declaration Currency, convert amounts
using PT Statutory ER.
• If there is no PT Statutory ER, use the Base Amount if the Base Currency is equal to
Declaration Currency.
• If the Base Currency is not the same as the Declaration Currency, use Statutory Amount if the
Statutory Currency is equal to Declaration Currency.
• If the Statutory Currency is not the same as the Declaration Currency, add PT Statutory ER
type for currency from/to and related effective date.
To create an exchange rate type specifically for fiscal registration, use Exchange Rate Type Create
(26.3.1). Use the naming convention <COUNTRY_CODE> Statutory ER, where
<COUNTRY_CODE> is a two-letter code representing the country.

Comments? Go to goo.gl/MfwKHm
44 QAD Internationalization Portugal Extension User Guide

Fig. 5.4
Adaptive ERP: Exchange Type Rate Create (26.3.1)

Use Exchange Rate Create (26.4.1) to create the fiscal registration exchange rate. The fiscal
registration exchange rate is supplied by the Portugal government. Ensure that you specify the
correct rate and applicable dates, which are available from the Portugal tax authorities.
Fig. 5.5
Adaptive ERP: Exchange Rate Create (26.4.1)

For more information about exchange rates, see the QAD Financials User Guide.

Questions? Visit community.qad.com

 Chapter 6

Reports
This chapter describes the reports that QAD developed to meet the Portugal requirements.
SAF-T File for Portugal 46
This section describes the QAD solution for Portugal SAF-T requirements.
Annex VAT Reports 63
This section describes the QAD solution for Annex VAT Reports requirements.
46 QAD Internationalization Portugal Extension User Guide

SAF-T File for Portugal

Business Requirement
Portuguese tax authorities require companies to submit accounting details to the Tax and Customs
Authority—Autoridade Tributária e Aduaneira (AT)—Web service in a Standard Audit File - Tax
(SAF-T) file. This file must be in XML format and comply with the specification of the tax
authorities, which is available on the Tax and Customs Authority Web site.

QAD Solution
QAD developed the SAF-T solution to meet this requirement. The solution complies with version
1.04 of the SAF-T specification for Portugal.
The solution allows you to create the Complete, Monthly, or Supplier Self-Invoice SAF-T XML
output file based on selection criteria such as the entity and declaration type. The complete version
of the file contains more information than the monthly version of the file, including information
about the GL setup of the entity. The Supplier Self-Invoice declaration contains only the self-
billing invoices and it is sent only to the supplier who requested this declaration and not to the
government authorities as regular reports.
For Adaptive ERP 2019 and higher, the declaration includes invoices created during self-billing
and identifies them using the relevant XML elements. For more information about self-billing, see
QAD Financials User Guide.
The ATCUD code is created during the report printing using the Portugal Customer Invoice Print
or Portugal Invoice Print or Reprint function. In case the report is not printed, a message to run the
report is shown when running SAF-T Declaration.

Flow

1 Complete the “Prerequisites” on page 47.

2 Complete invoice certification and use Customer Invoice View (27.1.1.3) to confirm that all of
the invoice information necessary for the SAF-T XML output file is available. For information
about invoice certification, see QAD Financials User Guide.
3 Complete shipment certification and use Shipment Certification Browse (75.6.3) to confirm
that all of the shipper information necessary for the SAF-T XML output file is available. For
information about shipment certification, see QAD Sales User Guide.
4 Add movement of goods information to each shipper. Use AT Authorization Browse
(36.5.8.7.2.4) to confirm that all of the necessary movement of goods information for shippers
in the SAF-T XML output file is available. For more information about movement of goods,
see “Movement of Goods Authorization” on page 70.

Questions? Visit community.qad.com

 Reports 47

Prerequisites

Setting Up a COA Cross-Reference

The SAF-T file must contain the official government accounting reference, which can differ from
the GL accounting code that your company uses in QAD Enterprise Applications.
If necessary, use COA Cross Reference Create (25.3.14.1) to relate the GL accounting code in the
application to the official government reference. The GL combination—account, sub-account, cost
center, and project—from the journal entry transactions in the SAF-T file are matched to a
mapping in the cross-reference table for the COA cross-reference that you specify in the Portugal
SAFT-PT selection criteria. For a detailed description of COA cross-references, see QAD
Financials User Guide.
You can use separate or combined COA dimension mappings to create the SAF-T file content.
You cannot use alternate COA mappings.
If you use a separate COA reference, only the GL account mapping is relevant to the creation of
the SAF-T file. The mapping of sub-account, cost center, and project are not taken into account
because they do not appear in the SAF-T file.
If you use a combined COA reference, the whole GL combination of the GL account, sub-account,
cost center, and project is relevant to the mapping in the SAF-T file. The precedence for matching
is as follows:
• Matching account, sub-account, cost center, and project
• Matching account, sub-account, cost center, and blank project
• Matching account, sub-account, blank cost center, and project
• Matching account, sub-account, blank cost center, and blank project
• Matching account, blank sub-account, blank cost center, and blank project

This behavior can affect the opening and closing balances for accounts listed in the SAF-T file, as
individual journal entry transactions can be mapped to different account numbers.
If there is no match, the original GL account numbers are included in the SAF-T file, and the
AccountDescription and TaxonomyCode elements for the account contain the text
Desconhecido—unknown.

Setting Up the Transaction Types in Generalized Codes Maintenance

To print transaction types in the XML output file, set up the generalized codes in Generalized
Codes Maintenance.
Access Generalized Codes Maintenance (36.2.13).

Comments? Go to goo.gl/MfwKHm
48 QAD Internationalization Portugal Extension User Guide

Fig. 6.1
Adaptive ERP: Generalized Codes Maintenance (36.2.13), Transaction Types

Field Name. Specify the generalized code for setting up the <TransactionType> element.
Enter QAD_I19_PT_SAFT_MG in this field.
Value. Specify the value of the code that you want to set up. Enter TRANSACTION_TYPE in
this field.
Comments. Specify, in a comma-separated list, the various transaction types that you want to
set up for the XML output file.
Note If the generalized codes setup is not completed, all shippers are printed.

Formatting the Invoice Number for XML Output file

The InvoiceNo element in the XML output file contains a string based on the invoice number of a
transaction. The exact format of the string is:
<INV_TYPE> <YYYY><DAYBOOK_CODE><NUM_SEQ_PART1>/<NUM_SEQ_PART2>
<INVOICE_TYPE> is FT (fatura or invoice) or ND (nota de débito or debit note), <YYYY> is
the invoice year, and <NUM_SEQ_PART1> and <NUM_SEQ_PART2> consist of zero or more
characters from the numeric sequence generated during invoice creation.
Use the QAD_I19_PT_SAFT_INVOICENO generalized code to specify the position of the /
character in the InvoiceNo element for invoices posted to a particular daybook.
Access Generalized Codes Maintenance (36.2.13).
Fig. 6.2
Adaptive ERP: Generalized Codes Maintenance (36.2.13), Special Character Position in the InvoiceNo Element

Field Name. Set this field to QAD_I19_PT_SAFT_INVOICENO.

Value. Specify a daybook code for which you want to format the InvoiceNo element. All
invoices posted to this daybook will have the same InvoiceNo format.

Questions? Visit community.qad.com

 Reports 49

Comments. Specify the character position, starting at zero and counting from right to left,
where the / character is placed in the invoice number.
Example Invoice number 2016CINV000000001 and the QAD_I19_PT_SAFT_INVOICENO
generalized code settings in Figure 6.2 result in an InvoiceNo element with the value
FT 2016CINV000/000001.

Setting Up the Document Number Element in Generalized Codes Maintenance

To print the Shipper ID in the <DocumentNumber> element of the XML output file, set up the
generalized codes for the Shipper ID PREFIX and SEQUENCE values.
Access Generalized Codes Maintenance (36.2.13).
Fig. 6.3
Adaptive ERP: Generalized Codes Maintenance (36.2.13), Prefix for Shipper ID

Fig. 6.4
Adaptive ERP: Generalized Codes Maintenance (36.2.13), Sequence for Shipper ID

Field Name. Specify the generalized code that you want to set up. Enter QAD_I19_PT_AT in
this field.
Value. Set up the PREFIX and the SEQUENCE for the Shipper ID, to be printed in the XML
output file.
Comments. Specify, in a comma-separated list, the position of the shipper number to be read
and the number of characters to be printed.
The shipper ID is printed in the <DocumentNumber> element of the XML output file as shown in
Figure 6.5.

Comments? Go to goo.gl/MfwKHm
50 QAD Internationalization Portugal Extension User Guide

Note If the shipper is not authorized by AT, the <SH> value is added to the <DocumentNumber>
element in the XML output file.
Fig. 6.5
Portugal SAFT-PT (36.5.8.7.1.1), XML Output File

In the XML output file, the shipper ID is printed in the following format:
<Document_Type>_<PREFIX><“/”><SEQUENCE>
Note If the shipper documents are not confirmed, the data still appears in the SAFT-PT XML
output file, in the StockMovement section as A (Documento Anulado).

Setting the SerialNumber Element to Unknown in Generalized Codes Maintenance

The SerialNumber element in the SAF-T XML output file contains the serial or lot number for a
particular item. This number is taken from the data stored in Invoice History.
If you would prefer the SerialNumber element to be marked as unknown, use the
QAD_I19_PT_DESCONHECIDO generalized code to set the element to Desconhecido—
unknown. After you set up the generalized code, the text Desconhecido appears in the
<SerialNumber> elements of the SAF-T XML output file.
To update QAD_I19_PT_DESCONHECIDO, access Generalized Codes Maintenance (36.2.13)
and fill in the following fields:
Fig. 6.6
Adaptive ERP: Generalized Codes Maintenance (36.2.13), SerialNumber Element

Field Name. The generalized code that you want to set up. Enter
QAD_I19_PT_DESCONHECIDO in this field.
Value. The XML element that you want to print the Comments value in. Enter SerialNumber
in this field.
Comments. The text that you want to display in the XML element specified in the Value field.
Enter Desconhecido in this field.

Questions? Visit community.qad.com

 Reports 51

Setting Up the Tax Class in Generalized Codes Maintenance

Access Generalized Codes Maintenance (36.2.13).

Fig. 6.7
Adaptive ERP: Generalized Codes Maintenance (36.2.13), Tax Class

Field Name. Specify the generalized code that you want to set up. Enter
QAD_I19_PT_SAFT_TAX_CODE in this field.
Value. Specify a tax class from Tax Class Maintenance (29.1.5).

Comments. Specify the text that you want to display in the Tax Code field of the SAF-T XML
output file for the tax class specified in the Value field of this generalized code.

Setting Up Item Information

Portugal SAFT-PT Item Information (36.5.8.7.1.2) allows you to link the item code to the product
type and optionally to the CN codes and UN numbers. The item code can be linked to one or more
CN codes or UN numbers at the same time.
Access Portugal SAFT-PT Item Information (36.5.8.7.1.2).
Fig. 6.8
Adaptive ERP: Portugal SAFT-PT Item Information (36.5.8.7.1.2)

Item Number. Specify an item number to define the additional item data.

Product Type. Specify the Product Type code from the list of values. Possible options are P, S,
O, E, and I. Items that do not exist in the item master are automatically assigned the value S.
Items that are not set in Portugal SAFT-PT Item Information but exist in Item Master get the
value P.
CN Code. Specify the CN Code for the item.

UN Num. Specify the UN Number for the item.

Access Portugal SAFT-PT Item Browse (36.5.8.7.1.3) to view updates made in Portugal SAFT-PT
Item Information.

Comments? Go to goo.gl/MfwKHm
52 QAD Internationalization Portugal Extension User Guide

Fig. 6.9
Adaptive ERP: Portugal SAFT-PT Item Browse

Setting Up Tax Exemption Information

1 Set up tax exemptions in Portugal Tax Rate (36.5.8.7.1.5).

Fig. 6.10
Adaptive ERP: Portugal Tax Rate (36.5.8.7.1.5)

Tax Code. Select the tax code you want to define as a tax exemption code. Tax exemption
codes must be defined for the tax codes with a tax rate of 0%.
Tax Exemption. Specify a three-character tax exemption code.

2 Set up a tax exemption comment in Tax Rate Maintenance (29.4.1).

Questions? Visit community.qad.com

 Reports 53

Fig. 6.11
Adaptive ERP: Tax Rate Maintenance, Frame 1

Fig. 6.12
Adaptive ERP: Tax Rate Maintenance, Frame 2

Setting Up Taxonomy References

Use Generalized Codes Maintenance (36.2.13) to set up the mandatory Taxonomy Reference field
for Portugal SAFT-PT Control File (36.5.8.7.1.4).
Access Generalized Codes Maintenance (36.2.13).
Fig. 6.13
Adaptive ERP: Generalized Codes Maintenance (36.2.13), Taxonomy References

Field Name. Specify the generalized code that you want to set up. Enter
i19_pt_taxonomy_reference in this field.

Comments? Go to goo.gl/MfwKHm
54 QAD Internationalization Portugal Extension User Guide

Value. Specify the value that you want to print in the <TaxonomyReference> element of the
SAFT-PT Declaration.
Comments. Specify that you want to print SNC Microentities in the Comments section.

Setting Up Taxonomy Code

Access GL Account Modify (25.3.13.2).

Fig. 6.14
Adaptive ERP: GL Account Modify, Taxonomy Code

Fig. 6.15
Adaptive UX: GL Accounts, Taxonomy Code

Taxonomy Code. Specify the taxonomy code that allows the characterization of accounts
according to the accounting standards.

Questions? Visit community.qad.com

 Reports 55

Specifying ARC Number Data

1 Access Shipper ATDocCodeID Maintenance (36.5.8.7.2.2).

Fig. 6.16
Adaptive ERP: Shipper ATDocCodeID Maintenance Access (36.5.8.7.2.2)

ARCNo. Specify the ARCNo for the selected shipper.

2 Use Customer Invoice Create (27.1.1.1) or Customer Invoice Modify (27.1.1.2) to add the
ARC number to the customer invoice.
Fig. 6.17
Adaptive ERP: Customer Invoice Create (27.1.1.1)

Comments? Go to goo.gl/MfwKHm
56 QAD Internationalization Portugal Extension User Guide

Fig. 6.18
Adaptive UX: Customer Invoices

ARCNo. Specify the ARCNo information for the customer invoice.

Excluding Invoices from the SalesInvoices Element

It is possible to exclude invoices that are created manually in the Financials module from the
SalesInvoices element of the XML output file. The QAD_I19_PT_INVOICE_EXCL generalized
code allows you to exclude an invoice of this type from the SalesInvoices element based on the
daybook that the invoice is posted to.
Fig. 6.19
Adaptive ERP: Generalized Codes Maintenance (36.2.13), Excluding Invoices from the <SalesInvoices> Element

Field Name. Set this field to QAD_I19_PT_INVOICE_EXCL.

Value, Comments. Use these fields to identify a daybook that contains invoices that were
created manually in the Financials module and that you want to exclude from the
SalesInvoices element of the SAF-T XML output file. Specify the relevant daybook code in
this field.
Note If you want to specify more than one daybook code, create a
QAD_I19_PT_INVOICE_EXCL generalized code for each daybook code.

Questions? Visit community.qad.com

 Reports 57

Fig. 6.20
Adaptive ERP: Generalized Codes Maintenance (36.2.13), QAD_I19_PT_INVOICE_EXCL Generalized Codes

Specifying the Output File Name Prefix and XML Header Details

Access Portugal SAFT-PT Control File (36.5.8.7.1.4).

Before running the SAFT-PT XML output file, it is necessary to set up the Portugal SAFT-PT
Control File. This setup includes the following:
• Default XML file output options
• Taxonomy reference information for the SAF-T content
• Entity and currency details for the Header section of the XML output file
• Software authorization data in the XML output file

Fig. 6.21
Adaptive ERP: Portugal SAFT-PT Control File (36.5.8.7.1.4)

XML Prefix. Specify the text that you want to appear in the editable XML Prefix field in
Portugal SAFT-PT. For more information about the XML Prefix field in Portugal SAFT-PT,
see “XML Prefix” on page 60. Setting this value allows you to specify the file name prefix
once, rather than entering it each time that you run Portugal SAFT-PT.
Directory. Specify the text that you want to appear in the editable Output Directory field in
Portugal SAFT-PT. For more information about the Directory field in Portugal SAFT-PT, see
“Output Directory” on page 60. Setting this value allows you to specify the output directory
once, rather than entering it each time that you run Portugal SAFT-PT.
Currency Code. Specify the currency code that you want to appear in the CurrencyCode
element in the Header section of the XML output file. Enter EUR in this field.
Tax Entity. Specify the tax entity for this report. This value appears in the TaxEntity element in
the Header section of the XML output file.
Taxonomy Reference. Specify the taxonomy reference, as defined in Generalized Codes
Maintenance (36.2.13). This value appears in the <TaxonomyReference> element in the
Header section of the XML output file. For more information about taxonomy references, see
“Setting Up Taxonomy References” on page 53.

Comments? Go to goo.gl/MfwKHm
58 QAD Internationalization Portugal Extension User Guide

Product Company Tax ID. Specify the Product Company Tax ID. This value appears in the
ProductCompanyTaxID element in the Header section of the XML output file. If you do not
specify a value in this field, then the ProductCompanyTaxID element contains 503916170 by
default.
Product ID. Specify the Product ID to identify the QAD software used to create the SAF-T
XML output file. This value appears in the ProductID element in the Header section of the
XML output file. If you do not specify a value in this field, then the ProductID element
contains QAD/Enterprise Financials by default.
Software Certificate Number. Specify the Software Certificate Number; enter 1352 in this
field. This value appears in the SoftwareCertificateNumber element in the Header section of
the XML output file.

Report Access

Access Portugal SAFT-PT (36.5.8.7.1.1).

Fig. 6.22
Adaptive ERP: Portugal SAFT-PT (36.5.8.7.1.1)

Questions? Visit community.qad.com

 Reports 59

Fig. 6.23
Adaptive UX: SAFT - Portugal

The solution includes the following selection criteria for the SAF-T file:
Entity Code. Specify the entity for which you want to create the SAF-T file.

Include Related Entities. To create the SAF-T file for a corporate group of entities that
includes the entity specified in the Entity field, select this field. All entities in the corporate
group must be in the same domain. For more information about corporate groups, see QAD
Financials User Guide.
Layer Code. Select the layer code. You can run the report for the official or management layer.
The SAF-T file contains general ledger and account information from the accounting layer of
your choice. It is not possible to create the SAF-T report for the transient layer.
Important If you want to run the report for the management layer, you must set selection
criteria for both the official (primary) layer and the management layer. The selection of both
layers is required because the SAF-T report contains sales invoice information, and this
information is always stored in the official layer.
COA Cross Reference. If you want to create the SAF-T file based on a COA cross-reference,
then use this field to specify the cross-reference. For more information about COA cross-
reference, see “Setting Up a COA Cross-Reference” on page 47.
Important If you specify a cross-reference in this field, and that cross-reference does not
contain mappings for all of the GL accounts in the SAF-T file, then a warning displays in the
Viewer tab for each GL account that does not have a mapping. In this situation, the original
GL account numbers are included in the SAF-T file, and the AccountDescription and
TaxonomyCode elements for the account contain the text Desconhecido—unknown.

Comments? Go to goo.gl/MfwKHm
60 QAD Internationalization Portugal Extension User Guide

Effective Date. If you want to create the SAF-T file based on an effective date range, then
specify the effective date range.
GL Year, GL Period. If you want to create the SAF-T file based on a GL year and period range,
then specify the range details. The report cannot span fiscal years.
Note The SAFT-PT XML output file prints the transactions data only for the selected period
of time.
Comments. Specify a comment to be recorded in the SAF-T file. The value of this field
appears in the HeaderComment element in the Header section of the XML output file.
Supplier. If you want to generate the declaration for a certain supplier (Supplier Self-Invoice
declaration), select the needed supplier code from the lookup.
Declaration Type. If you want to create the complete version of the SAF-T file, select
Complete (not available for the Fiscal Registration currency). If you want to create the
monthly version of the SAF-T file, select Monthly. If you want to create the declaration for a
certain supplier, select the Supplier Self-Invoice.
Note The Supplier Self-Invoice declaration has the same layout as the regular report, but
contains only the following sections in the XML output file: Header (supplier information),
Customer (company which self-invoiced the supplier), Items, and SalesInvoices (Supplier
invoices created by ERS).
Currency. Select the currency that you want to use for the SAF-T file.

Output Directory. Specify the directory to which you want to save the file. The default value
for this field is set in SAF-T Control File, but you can update this field.
XML Prefix. Specify the file name prefix for the SAF-T XML output file. The SAF-T file name
is composed of the file name prefix, a single date or a date range, and a sequence number. The
default value for this field is set in SAF-T Control File, but you can update this field. For more
information about the generated file name, see “SAF-T Output File” on page 60.
The SAFT-PT report implements the fiscal registration functionality to print data according to the
settings in Portugal Fiscal Registration Control if you enable this functionality in Portugal Enable
Fiscal Registration. The report with the Monthly or Supplier Self-Invoice type contains only the
invoices related to the tax codes selected in Portugal Fiscal Registration Control, and this report
can be printed in Base, Statutory, or Fiscal Registration currency. For more information about
fiscal registration, see “Fiscal Registration” on page 39.

SAF-T Output File

The Viewer tab of Portugal SAFT-PT displays information about the report. It includes the output
directory and file name. It also displays any warnings related to COA mappings.
The file name can be in one of two formats:
• For files created based on an effective date range, the format is <PREFIX><FROM_MMDD>-
<TO_MMDD>-<TIMESTAMP>.xml, where:
• <PREFIX> is the value specified in the XML Prefix field in the Portugal SAFT-PT
selection criteria
• <FROM_MMDD> is the start of the effective date range.

Questions? Visit community.qad.com

 Reports 61

• <TO_MMDD> is the end of the effective date range.

• <TIMESTAMP> is a number based on the timestamp when the report was run.
Example PTSaft0101-0131-44127.xml is a report based on an effective date range of January
1 to January 31.
• For files created based on a GL year and GL period, the format is <PREFIX><YYMM>-
<TIMESTAMP>.xml, where:
• <PREFIX> is the value specified in the XML Prefix field in the Portugal SAFT-PT
selection criteria.
• <YYMM> is the current year and date.
• <TIMESTAMP> is a number based on the timestamp when the report was run.
Example PTSaft1902-60829.xml is a report created on a date in February 2019. The file
name does not give any information about the particular GL year or period specified in the
Portugal SAFT-PT selection criteria.
Fig. 6.24
Portugal SAF-T Result, Viewer Tab

Comments? Go to goo.gl/MfwKHm
62 QAD Internationalization Portugal Extension User Guide

Fig. 6.25
Portugal SAF-T Result, Complete SAF-T XML Output File Based on GL Year and Period Range

Questions? Visit community.qad.com

 Reports 63

Annex VAT Reports

Business Requirement
Portuguese tax authorities require companies to submit a recapitulative customer and supplier
report. The reports must include the value of the goods or services and the fiscal number of the
customer or supplier where the total annual transactions between your company and the customer
or supplier exceeds a specified value. These reports must be sent by electronic means as
established in article 29 (2) (f) of the VAT code.

QAD Solution
QAD developed Annex O Report (36.5.8.7.4) and Annex P Report (36.5.8.7.5) to meet this
requirement.

Prerequisites

Use Annex Limit Amount (36.5.8.7.3) to identify customers and suppliers available for inclusion
in the Annex Reports based on the value of your annual transactions with them. Any suppliers or
customers with a transaction amount equal to or above the limit amount are eligible to appear on
the report.
Fig. 6.26
Adaptive ERP: Annex Limit Amount (36.5.8.7.3)

Annex O Report
Access Annex O Report (36.5.8.7.4).
Fig. 6.27
Adaptive ERP: Annex O Report (36.5.8.7.4)

Comments? Go to goo.gl/MfwKHm
64 QAD Internationalization Portugal Extension User Guide

Fig. 6.28
Adaptive UX: Annex O Report

Complete the fields:

Entity. Select the primary entity to print the report.

Related Entity. If you want the report to include all entities in the same corporate group as the
primary entity, then select Yes; otherwise, set this field to No.
Year. Specify the year for which you want to run the report.

Period. Specify the period for which you want to run the report. If this field is left blank, then
the report will be an annual report.
Daybook. Specify the daybook for which you want to run the report.

Customer. Enter a customer’s code to bring up a single customer’s report or leave the field
empty to print a full report.
Reporting Currency. Select the currency that you want to use for the Annex O report. By
default, this field is set to the base currency.
Functional. Choose to print the customer code or state tax ID in the report.

Click Run.
The Annex O report implements the fiscal registration functionality to print data according to the
settings in Portugal Fiscal Registration Control if you enable this functionality in Portugal Enable
Fiscal Registration. The report contains only the invoices related to the tax codes selected in
Portugal Fiscal Registration Control. Also, the invoice amounts are calculated based on the Base,
Statutory, or Fiscal Registration currency selected in Portugal Fiscal Registration Control. For
more information about fiscal registration, see “Fiscal Registration” on page 39.

Questions? Visit community.qad.com

 Reports 65

File Output

Fig. 6.29
Annex O Report Viewer (36.5.8.7.4), Result

Comments? Go to goo.gl/MfwKHm
66 QAD Internationalization Portugal Extension User Guide

Annex P Report
Access Annex P Report (36.5.8.7.5).
Fig. 6.30
Adaptive ERP: Annex P Report (36.5.8.7.5)

Fig. 6.31
Adaptive UX: Annex P Report

Complete the fields:

Entity. Select the primary entity to print the report.

Related Entity. If you want the report to include all entities in the same corporate group as the
primary entity, then select Yes; otherwise, set this field to No.
Year. Specify the year for which you want to run the report.

Period. Specify the period for which you want to run the report. If this field is left blank, then
the report will be an annual report.
Daybook. Specify the daybook for which you want to run the report.

Questions? Visit community.qad.com

 Reports 67

Supplier. Enter a supplier’s code to bring up a single supplier’s report or leave the field empty
to print a full report.
Reporting Currency. Select the currency that you want to use for the Annex P report. By
default, this field is set to the Base Currency.
Functional. Choose to print the supplier code or state tax ID in the report.

Click Run.
The Annex P report implements the fiscal registration functionality to print data according to the
settings in Portugal Fiscal Registration Control, if you enable this functionality in Portugal Enable
Fiscal Registration. The report contains only the invoices related to the tax codes selected in
Portugal Fiscal Registration Control. Also, the invoice amounts are calculated based on the Base,
Statutory, or Fiscal Registration currency selected in Portugal Fiscal Registration Control. For
more information about fiscal registration, see “Fiscal Registration” on page 39.

File Output

Fig. 6.32
Annex P Report (36.5.8.7.5)

Comments? Go to goo.gl/MfwKHm
68 QAD Internationalization Portugal Extension User Guide

Questions? Visit community.qad.com

 Chapter 7

Movement of Goods
Authorization
This chapter describes the Portugal requirement for a movement of goods authorization and the
QAD solution for this requirement.
Movement of Goods Authorization 70
This section outlines the Portugal requirement for a movement of goods authorization and the
QAD solution for this requirement.
70 QAD Internationalization Portugal Extension User Guide

Movement of Goods Authorization

Business Requirement
The Portugal legislation requires companies to include a movement of goods authorization in each
shipper document, including:
• A unique movement of goods authorization code; companies must obtain this code from the
Tax and Customs Authority—Autoridade Tributária e Aduaneira (AT) —Web service or AT
Web service.
• The dispatch date and time of the shipper, which can vary from the shipper creation date and
time.
• The document type associated with the shipper; for example, remittance note.

The SAF-T .xml output file must include this movement of goods information for each reported
shipper; the authorization code appears in the ATDocCodeID element of the .xml output file.
For more information about the QAD SAF-T solution, see “SAF-T File for Portugal” on page 46.

QAD Solution
QAD developed a solution that allows you to perform the following actions:
1 Record the movement of goods authorization code, document type, and dispatch date and time
of each shipper. To obtain and assign the authorization code for a shipper, you have the
following two options:
• Request a movement of goods authorization code from the Tax and Customs Authority
and use ATDocCodeID Maintenance (36.5.8.7.2.2) to add the authorization code to the
shipper manually. For more information about adding the authorization code to the shipper
manually, see “Assigning an Authorization to a Shipper Manually” on page 74.
• Use AT Authorization (36.5.8.7.2.3) to communicate with the AT Web service
electronically to request a movement of goods authorization code for a shipper and assign
it to the shipper automatically. For more information about integrating QAD Enterprise
Applications with the AT Web service, see “Setting Up the Authorization” on page 71. For
more information about requesting a code, see “Assigning an Authorization to a Shipper
Electronically” on page 75.
Both of these menu options allow you to manually add the document type, dispatch date, and
dispatch time to shippers.
2 View all shippers and corresponding movement of goods information in AT Authorization
Browse (36.5.8.7.2.4), which is described in “Viewing Shippers’ Movement of Goods
Authorization Code Details” on page 79.

Prerequisites

Setting Up the Transaction Types in Generalized Codes Maintenance

To print transaction types in the .xml output file, set up generalized codes in Generalized Codes
Maintenance. For more information about setting up the generalized codes, see “Setting Up the
Transaction Types in Generalized Codes Maintenance” on page 70.

Questions? Visit community.qad.com

 Movement of Goods Authorization 71

Setting Up the Document Number Element in Generalized Codes Maintenance

To print the Shipper ID in the <DocumentNumber> element of the .xml output file, set up the
generalized codes for the Shipper ID in Generalized Codes Maintenance. For more information
about setting up the generalized codes for the Shipper ID, see “Setting Up the Document Number
Element in Generalized Codes Maintenance” on page 71.

Setting Up the Authorization

As described in “QAD Solution” on page 70, there are two methods of obtaining a movement of
goods authorization. If you want to use AT Authorization (36.5.8.7.2.3) to communicate with the
AT Web service electronically, complete the following setup:
• “Specifying the Domain Time Zone” on page 71
• “Creating Certificate Files for AT Web Service Communication” on page 72
• “Configuring Communication with the AT Web Service” on page 73

Otherwise, complete the following setup:

• “Specifying the Domain Time Zone” on page 71

Specifying the Domain Time Zone

Specify the domain time zone in the Time Zone field in Domain Modify (36.1.1.1.2). This is the
time zone that applies when you assign a dispatch date and dispatch time to a shipper.
Fig. 7.1
Adaptive ERP: Domain Modify (36.1.1.1.2)

Comments? Go to goo.gl/MfwKHm
72 QAD Internationalization Portugal Extension User Guide

Creating Certificate Files for AT Web Service Communication

Important To perform the steps described in this section, install the Movement of Goods
Authorization Components listed in “Installation Procedures” on page 7.
1 Create a .csr (Certificate Signing Request) file and an encryption key file using the
following command:
openssl req -new -subj "C=<COUNTRY>/ST=<STATE>/L=<LOCALITY>/O=
<ORGANIZATION>/OU=<ORGANIZATIONAL_UNIT>/CN=
<COMMON_NAME>/emailAddress=<E-MAIL>" -newkey rsa:2048 -nodes -out
<COMMON_NAME>.csr -keyout <COMMON_NAME>.key
where <COMMON_NAME> is the first 9 digits from your login to the AT Web service.
Example openssl req -new -subj "C=PT/ST=Distrito da Sede/L=Local da
Sede/O=Empresa /OU=Departamento de Informatica/CN=
555555555/[email protected]" -newkey rsa:2048 -
nodes -out 555555555.csr -keyout 555555555.key

2 Verify that the .csr file is created properly:

openssl req -text -noout -in <COMMON_NAME>.csr

3 Use the Certificate Signing Request to request the public certificate file from the AT Web site
by performing the following steps:
a Log in to the https://faturas.portaldasfinancas.gov.pt/consultarPedidosAdesao.action
website.
b Click the Efetuar Novo Pedido link to view the Service Request page.
Fig. 7.2
Service Request

c In the CSR field, paste the certification request from <COMMON_NAME>.csr, accept the
terms and conditions, and click Aderir.
d Check your e-mail for a ZIP file that contains a <COMMON_NAME>.cer certification file.

Questions? Visit community.qad.com

 Movement of Goods Authorization 73

4 Create a .pfx private certificate key file based on the .cer and .key files:
openssl pkcs12 -export -in <COMMON_NAME>.cer> -inkey
<COMMON_NAME>.key -out <COMMON_NAME.pfx>

5 To integrate with the production environment of the AT Web service, create a .pem certificate
file based on the <COMMON_NAME>.pfx file, as follows:
openssl pkcs12 -in <COMMON_NAME>.pfx -out <COMMON_NAME>.pem

Configuring Communication with the AT Web Service

Important To perform the steps described in this section, install the Movement of Goods
Authorization Components listed in “Installation Procedures” on page 7.
Use Site AT Control Menu (36.5.8.7.2.1) to set up parameters for communicating with the AT Web
service. After you complete this setup, you can send .xml format requests for authorization
codes to the AT Web service using the AT Authorization menu option.
Fig. 7.3
Adaptive ERP: Site AT Control Menu (36.5.8.7.2.1)

Site. Specify the site for which you want to request a movement of goods authorization code.

Login, Password. Specify your login and password for the AT Web service.

Certificate File. Specify the .cer file name for the digital certificate that authorizes your
company to request movement of goods authorization codes.
Public Certificate File. Specify the .pem file name for the digital certificate that authorizes
your company to request movement of goods authorization codes.
Certificate Password. Specify the certificate password that is required to connect to the AT
Web service.
Certificate Directory. Specify the directory in which the digital certificate is stored.

Curl Timeout. Specify the amount of time in seconds until the system tries to access the
Internet address of the AT Web service.

Comments? Go to goo.gl/MfwKHm
74 QAD Internationalization Portugal Extension User Guide

Note cURL is a command line tool used to send files using URL syntax and communicate
with the AT Web service.
1 - Product 2 - Test. Specify the AT environment type.
1: production AT environment
2: test AT environment
Webservice Production. If you use the AT production environment, specify the related Web
service.
Webservice Test. If you use the AT test environment, specify the related Web service.

Outbound Folder. Specify the path to the directory in which the .xml-format authorization
code requests are stored. The outbound file name is the same as the shipper number. These
files are sent to the AT Web service electronically using AT Authorization.
Inbound Folder. Specify the path to the directory in which the.xml-format authorization code
responses are stored. The inbound response file name is the same as the outbound request file,
with the text _return added at the end of the name.

Assigning an Authorization to a Shipper Manually

To assign a movement of goods authorization code to a shipper manually, request the code from
the Tax and Customs Authority, and use Shipper ATDocCodeID Maintenance (36.5.8.7.2.2) to add
it to the shipper.
Fig. 7.4
Adaptive ERP: Shipper ATDocCodeID Maintenance (36.5.8.7.2.2)

Ship-From. Specify the ship-from code.

Shipper ID. Specify the Shipper ID.

Short Signature, Create Date, Create Time, Signature status. These fields are from the
shipper signature and are read-only.
Document Type. Specify a valid document type.

Dispatch Date, Dispatch Time. Specify a dispatch date and time.

ATDocCodeID. Specify the movement of goods authorization code.

Questions? Visit community.qad.com

 Movement of Goods Authorization 75

Assigning an Authorization to a Shipper Electronically

Access AT Authorization (36.5.8.7.2.3) to request a movement of goods authorization code for a
shipper from the AT Web service and assign it to a shipper automatically. The request to, and
response from, the Web service are in the .xml format and are stored in the folders specified in
Site AT Control Menu.
Note Before you run AT Authorization, check if a confirmed shipper with a signature exists. For
more information about the shipper signature, see QAD Sales User Guide.
Fig. 7.5
Adaptive ERP: AT Authorization - Portugal (36.5.8.7.2.3)

Ship-From. Specify the ship-from range for which you want to select shippers.

Ship-To. Specify the ship-to range for which you want to select shippers.

Shipper Number. Specify the range of shippers for which you want to request an authorization
code.
Effective Date. Specify the date to limit the selection of Shippers to be sent for authorization.
The default value is the current date.
Document Type. Specify the document type related to the shipper and authorization code.

Assign Dispatch Date, Assign Dispatch Time. Specify the desired dispatch date and time for
the shippers to be declared. By default, the field is blank. If you do not specify any value, the
report assigns the Dispatch Date and Dispatch Time as current date and time.
Send Authorization. Select Yes to send the authorization code request to the AT Web service.
Otherwise, set this field to No.
If you select No, click Next to view the details for the shipper range. You can use AT
Authorization to request the authorization codes later.
Show Previously Authorized Shippers. Select Yes to display all shippers in query with
previously received authorization ID details. Select No to filter only non-authorized shippers.

Comments? Go to goo.gl/MfwKHm
76 QAD Internationalization Portugal Extension User Guide

Fig. 7.6
Adaptive UX: AT Authorization - Portugal

Report Output

When you run the report, the system generates an output file, as shown in Figure 7.7:
Fig. 7.7
AT Authorization, Report Output

You can also display the report in the Excel format by selecting the corresponding layout from the
Layout drop-down selection, as shown in Figure 7.8:

Questions? Visit community.qad.com

 Movement of Goods Authorization 77

Fig. 7.8
Adaptive ERP: AT Authorization - Portugal, Layout Selection

Example of an Excel Output

Fig. 7.9
AT Authorization - Portugal, Excel Output

Examples of .xml Request and Response Files

Example of an .xml request sent to the AT Web service:

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/" xmlns:doc=
"https://servicos.portaldasfinancas.gov.pt/sgdtws/documentosTransporte">
<S:Header>
<wss:Security xmlns:wss="http://schemas.xmlsoap.org/at.ws/2002/12/secext">
<wss:UsernameToken>
<wss:Username>599999993/37</wss:Username>
<wss:Password>6QhsoItkxQIDERx3DevIkQ==</wss:Password>
<wss:Nonce>Mt488JOp7fnlyJfkatbT8NbFHdcGq8YxmHfMoy6Rcv55HI8VKdbQA6b9Kt/yZCUBGpm8kb0z13ryWeU
szsC0J4tFY0dq40G3ocwodRh7U5J5Ya1gAw8g3n5WbbwLheVamfe5PUmdezDUE13gmVSfB8LIjDy7vdeHaNw0hdWpV
oTZb26YxOjSASdsD851MTxbnbgmQWB0p7JDagb4bHxP9BHdhDWYpYcBOr04pWIQNuJRq7Fs5hfdMcqKONN9JwcTdGw
PYX1HpA52WwFYwihk8nmc4syTzNe4tZcVsLq2QWLzCnWIyO+aWencK7yevKiW3Ut+MTn6HVtu4piOy0mYfA==
</wss:Nonce>
<wss:Created>3QyNoeeKWCa19oVcYRHDbFu+cllZIK2b5USHi9f242k=</wss:Created>
</wss:UsernameToken>
</wss:Security>
</S:Header>
<S:Body>
<ns2:envioDocumentoTransporteRequestElem xmlns:ns2=
"https://servicos.portaldasfinancas.gov.pt/sgdtws/documentosTransporte/">
<TaxRegistrationNumber>599999993</TaxRegistrationNumber>
<CompanyName>Portugal Division</CompanyName>
<CompanyAddress>

Comments? Go to goo.gl/MfwKHm
78 QAD Internationalization Portugal Extension User Guide

<Addressdetail>Avenida Jose Malhoa, Edificio EuropaNo. 16-Bs3rd floor</Addressdetail>

<City>Lisbon</City>
<PostalCode>1070-158</PostalCode>
<Country>PT</Country>
</CompanyAddress>
<DocumentNumber>SH S/1002070616</DocumentNumber>
<MovementStatus>N</MovementStatus>
<MovementDate>2016-07-06</MovementDate>
<MovementType>GR</MovementType>
<CustomerTaxID>504727060</CustomerTaxID>
<CustomerAddress>
<Addressdetail>Lagoas ParkEdificio 12</Addressdetail>
<City>OEIRAS</City>
<PostalCode>2740-269</PostalCode>
<Country>PT</Country>
</CustomerAddress>
<CustomerName>Cisco International Limited</CustomerName>
<AddressTo>
<Addressdetail>Lagoas ParkEdificio 12</Addressdetail>
<City>OEIRAS</City>
<PostalCode>2740-269</PostalCode>
<Country>PT</Country>
</AddressTo>
<AddressFrom>
<Addressdetail>Avenida Jose Malhoa, Edificio EuropaNo. 16-Bs3rd floor</Addressdetail>
<City>Lisbon</City>
<PostalCode>1070-158</PostalCode>
<Country>PT</Country>
</AddressFrom>
<MovementStartTime>2016-10-06T18:13:00</MovementStartTime>
<Line>

Example of an AT Web service .xml response to a successful request:

<?xml version="1.0" encoding="UTF-8"?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Header>
<work:WorkContext xmlns:work=
"http://oracle.com/weblogic/soap/workarea/">rO0ABXdKABN3ZWJsb2dpYy5hcHAuc2dkdHdzAAAA1gAAAC
N3ZWJsb2dpYy53b3JrYXJlYS5TdHJpbmdXb3JrQ29udGV4dAAGMS4yMC41AAA=</work:WorkContext>
</S:Header>
<S:Body>
<ns0:envioDocumentoTransporteResponseElem xmlns:ns0=
"https://servicos.portaldasfinancas.gov.pt/sgdtws/documentosTransporte/">
<ResponseStatus>
<ReturnCode>0</ReturnCode>
<ReturnMessage>OK</ReturnMessage>
</ResponseStatus>
<DocumentNumber>SH S/1001100516</DocumentNumber>
<ATDocCodeID>1097268249</ATDocCodeID>
</ns0:envioDocumentoTransporteResponseElem>
</S:Body>
</S:Envelope>

Example of an AT Web service .xml response to an unsuccessful request:

<?xml version="1.0" encoding="UTF-8"?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Header>
<work:WorkContext xmlns:work=
"http://oracle.com/weblogic/soap/workarea/">rO0ABXdKABN3ZWJsb2dpYy5hcHAuc2dkdHdzAAAA1gAAAC
N3ZWJsb2dpYy53b3JrYXJlYS5TdHJpbmdXb3JrQ29udGV4dAAGMS4yMC41AAA=</work:WorkContext>
</S:Header>
<S:Body>
<ns0:envioDocumentoTransporteResponseElem xmlns:ns0=
"https://servicos.portaldasfinancas.gov.pt/sgdtws/documentosTransporte/">
<ResponseStatus>
<ReturnCode>-3</ReturnCode>
<ReturnMessage>Já foi inserido um Documento de Transporte com o número
fornecido.</ReturnMessage>
</ResponseStatus>
</ns0:envioDocumentoTransporteResponseElem>
</S:Body>

Questions? Visit community.qad.com

 Movement of Goods Authorization 79

</S:Envelope>

Viewing Shippers’ Movement of Goods Authorization Code Details

Access AT Authorization Browse (36.5.8.7.2.4) to view shippers and associated authorization
codes.
The authorization code is displayed in the ATDocCodeID column of the browse.
Fig. 7.10
Adaptive ERP: AT Authorization Browse (36.5.8.7.2.4)

Comments? Go to goo.gl/MfwKHm
80 QAD Internationalization Portugal Extension User Guide

Questions? Visit community.qad.com

 Chapter 8

QR and ATCUD Codes

This chapter describes the Portugal requirement for a bar code (QR code) and the unique document
code (ATCUD) and the QAD solution for this requirement.
QR and ATCUD Codes 82
This section outlines the Portugal requirement for two-dimensional bar code (QR code) and the
unique document code (ATCUD), and the QAD solution for this requirement.
82 QAD Internationalization Portugal Extension User Guide

QR and ATCUD Codes

Business Requirement
On August 13, 2020, the Portugal Secretary of State of Tax Affairs published order number 195,
which requires creation of two-dimensional bar code (QR code) and the unique document code
(ATCUD) that appears on invoices and other tax documents issued as of January 1, 2021.
The order number 195 indicates the identifying information that must be provided to the Portugal
tax authorities relating to the document series prior to its use. Then the tax authorities issue a
validation code for the reported series. This validation code will be integrated into the ATCUD,
which appears on invoices and other tax documents issued through invoicing software programs or
other electronic means.
The required technical specifications for developing QR code, which must appear on invoices and
other tax documents issued through invoicing software programs certified by the tax authorities,
are available on the tax authorities’ website.

ATCUD Requirements

The validation code of the series that must be assigned by AT consists of minimum eight
characters.
ATCUD consists of the following elements separated by a '-' symbol without quotes:
• Validation code
• Voucher number

Note The sequential number consists of numerals and goes immediately after the slash (/), as
defined in the data structure referred to Ordinance No. 321 -A / 2007 of March 26 in the technical
notes corresponding to the fields “Unique identification of the sales document”, “Unique
identification of the handling documentgoods”, “Unique document identification”, and “Unique
receipt identification” of the group of “Business documents” data.

QAD Solution
Portugal Customer Invoice Print is the Internationalization Extension version of a standard report
27.1.1.4 (Customer Invoice Print). Portugal Invoice Print or Reprint is the Internationalization
Extension version of 75.10.6.7 report (Invoice Print or Reprint). Now, it is possible for both
reports to print the QR code and ATCUD code according to the Portugal Tax Authority definitions,
which became mandatory to be printed for all Tax Documents as of January 1, 2021.
QAD developed a solution that allows you to print the QR code and the corresponding ATCUD
code in the Customer Invoice Print and Invoice Print or Reprint functions. To create the QR code,
you must have a validation code which is controlled on a maintenance screen by entity, document
type, serial code, and initial and end validation date.

Setting Up the QR Code Functionality

If you want to use the QR code functionality, complete the following setup:

Questions? Visit community.qad.com

 QR and ATCUD Codes 83

• “Add Validation Code” on page 83

• “View Validation Code” on page 83
• “Print Invoice with QR Сode and ATCUD Сode” on page 84
• “Print or Reprint Invoice with QR Code and ATCUD Сode” on page 87

Add Validation Code

Portugal Serial Document Maintenance (36.5.8.7.6.1) allows you to set up a serial code, document
type, and start and end dates in order to add a validation code.
Fig. 8.1
Adaptive ERP: Portugal Serial Document Maintenance (36.5.8.7.6.1)

Entity. Specify the entity for which you want to enable the QR code functionality.

Serial Code. Specify the code that defines the start and end date of the invoice numbering.
You can view the Serial Code in the SAFT Invoice Number.
Document Type. Specify a valid document type.

Initial Date. Specify the starting date of the serial code.

End Date. Specify the end date of the serial code.

Validation Code. Specify the code provided by the tax authority.

View Validation Code

Portugal Serial Document Browse (36.5.8.7.6.4) allows you to view all records created in Portugal
Serial Document Maintenance: Entity, Serial Code, Document Type, Initial Date, End Date, and
Validation Code.

Comments? Go to goo.gl/MfwKHm
84 QAD Internationalization Portugal Extension User Guide

Fig. 8.2
Adaptive ERP: Portugal Serial Document Browse (36.5.8.7.6.4)

Fig. 8.3
Adaptive UX: Portugal Serial Document Browse

Print Invoice with QR Сode and ATCUD Сode

Portugal Customer Invoice Print (36.5.8.7.6.2) allows you to print the customer invoice in the
layout required by the tax authorities. The ATCUD code is generated and stored at the time the
report is printed.

Questions? Visit community.qad.com

 QR and ATCUD Codes 85

Fig. 8.4
Adaptive ERP: Portugal Customer Invoice Print (36.5.8.7.6.2)

Fig. 8.5
Adaptive UX: Customer Invoice Print - Portugal

Comments? Go to goo.gl/MfwKHm
86 QAD Internationalization Portugal Extension User Guide

Bill-To-Customer. Specify the bill-to-customer value or range of values for which you want to
run the report.
Business Relation. Select the business relation codes.

Currency Code. Specify the currency code that you want to appear in the Currency Code
element in the Header section of the XML output file.
Customer Code. Select the range of customer codes to be printed in the report.

Customer Codes. Select the customer codes separated by comma to be printed in the report.

Daybook Codes. Select the related customer invoice daybook codes.

Entity. Specify the entity for which you want to run the report.

Invoice Date and Invoice Due Date. Specify the invoice date or range of dates for which you
want to run the report.
Invoice Open. Specify whether to print customer invoices with open balance amounts.

Invoice Type. Select the type of invoice to print: Invoices, Finance Charges, Credit Notes,
Deductions, Adjustments, Prepayments, or Invoice Corrections.
Ship-To-Customer. Specify whether to print customer invoices based on ship-to address.

Voucher. Specify the voucher range for which you want to generate the report.

Year. Specify the invoice year or range of years for which you want to run the report.

Questions? Visit community.qad.com

 QR and ATCUD Codes 87

Fig. 8.6
Portugal Customer Invoice Print (36.5.8.7.6.2), Result

Print or Reprint Invoice with QR Code and ATCUD Сode

Portugal Invoice Print or Reprint (36.5.8.7.6.3) allows you to print or reprint the invoice in the
layout required by the tax authorities. The ATCUD code is generated and stored at the time the
report is printed.

Comments? Go to goo.gl/MfwKHm
88 QAD Internationalization Portugal Extension User Guide

Fig. 8.7
Adaptive ERP: Portugal Invoice Print or Reprint (36.5.8.7.6.3)

Questions? Visit community.qad.com

 QR and ATCUD Codes 89

Fig. 8.8
Adaptive UX: Invoice Print or Reprint - Portugal

Invoice Number. Specify the invoice number or range of numbers for which you want to run
the report.

Comments? Go to goo.gl/MfwKHm
90 QAD Internationalization Portugal Extension User Guide

Sales Order. Specify the sales order number or range of numbers for which you want to run
the report.
Ship date. Specify the ship date or range of ship dates for which you want to run the report.

Site. Specify the site or range of sites for which you want to run the report.

Sold-To. Specify the sold-to value or range of values for which you want to run the report.

Bill To. Specify the bill-to value or range of values for which you want to run the report.

Ship To. Specify the ship-to address or range of values for which you want to run the report.

Invoice Date. Specify the invoice date or range of dates for which you want to run the report.

Daybook. Specify the range of daybooks for which you want to run the report.

Batch. Specify the shipment batch number.

Language ID. Select the language in which you want to print the report.

Print in Selected Language. Specify if the report must be printed in the selected language.

Reprint. Specify if you want to reprint the report or print it for the first time.

Incl Credit Memos. Specify if the credit memos must be included in the selection.

Override Print Invoice. Select this option to print invoices that were marked as not to be
printed by the Print Inv Hist indicator in the Sales Order Maintenance and Customer
Scheduled Order Maintenance functions.
Discount Detail. Specify the way in which discount detail is shown on the printed invoices:
• None (default) - no detail is shown.
• Amount: discount detail is expressed as the currency amount.
• Percent: discount detail is expressed as a percentage of the list price, unless the discount
type is Accrual. In that case, the discount detail is expressed as a percentage of the net
price.
Discount Summary. Specify the way in which discount summary information is shown on the
printed invoices.
• None (default): no discount summary is shown.
• Amount: discount summary is expressed as the currency amount.
• Percent: discount summary is expressed as a percentage of the list price, unless the
discount type is Accrual. In that case, the discount summary is expressed as a percentage
of the net price.
Entity Code. Specify the entity for which you want to generate the report.

Print Lot/Serial Numbers Shipped. Specify if you want the lot and serial details to be printed in
the report.
Print Features and Options. Select Yes to print configured sales order line item numbers
followed by a list of features and options selected for the item. Select No to print only the
configured item number.

Questions? Visit community.qad.com

 QR and ATCUD Codes 91

Print Only Lines to Invoice. Specify whether to print only line items with a non-zero quantity
allocated or all lines with a non-zero open quantity, regardless of the quantity allocated.
Print Call Invoice Detail. Specify whether you want the call invoice details to be printed in the
report.
Message. Specify a message text to be printed on the trailer.

Print Heading. Specify whether the Invoice Type Description must be printed in the header of
the report.
Print Header Comment. Specify whether the header comments must be printed in the report.

Print Line Comment. Specify whether the line comment must be printed in the report.

Print Line Tax %. Specify whether the tax percentage for lines must be printed in the report.

Print Description 2. Specify whether the item Description 2 must be printed for lines in the
report.
Print Customer Item. Specify whether you want to print the customer item number in the
report.

Comments? Go to goo.gl/MfwKHm
92 QAD Internationalization Portugal Extension User Guide

Fig. 8.9
Portugal Invoice Print or Reprint (36.5.8.7.6.3), Result

Questions? Visit community.qad.com

 QR and ATCUD Codes 93

Portugal Pre-Shipper/Shipper Print with QR Code and ATCUD Сode

Portugal Pre-Shipper/Shipper Print (36.5.8.7.2.5) allows you to print the shipper invoices in the
layout required by the tax authorities, including the QR and ATCUD codes.

Comments? Go to goo.gl/MfwKHm
94 QAD Internationalization Portugal Extension User Guide

Fig. 8.10
Adaptive ERP: Portugal Pre-Shipper/Shipper Print (36.5.8.7.2.5)

For more information about the selection criteria field descriptions for Portugal Pre-
Shipper/Shipper Print, see QAD Sales User Guide.

Questions? Visit community.qad.com

 QR and ATCUD Codes 95

Fig. 8.11
Adaptive UX: Pre-Shipper/Shipper Print - Portugal (36.5.8.7.2.5)

Comments? Go to goo.gl/MfwKHm
96 QAD Internationalization Portugal Extension User Guide

Report Output

Fig. 8.12
Portugal Pre-Shipper/Shipper Print, Report Output

Questions? Visit community.qad.com

 Chapter 9

Release Notes for Previous

Releases
This chapter includes the release notes for the previous Portugal extension package releases.
Release Notes for 3.0.1 Release 98
This section includes the release notes for the 3.0.1 release.
Release Notes for 3.0 Release 99
This section includes the release notes for the 3.0 release.
Release Notes for 2.2 Release 100
This section includes the release notes for the 2.2 release.
Release Notes for 2.1 Release 101
This section includes the release notes for the 2.1 release.
Release Notes for 2.0 Release 102
This section includes the release notes for the 2.0 release.
98 QAD Internationalization Portugal Extension User Guide

Release Notes for 3.0.1 Release

QAD Internationalization Portugal Extension Version: 3.0.1
Release Date: January 2023
QAD Product Suite Compatibility: QAD Enterprise Edition 2018 or higher and QAD Adaptive
ERP 2022.1 or higher

Documentation Updates
The following documents are updated for this release:
• QAD Internationalization Portugal Extension User Guide
• QAD Internationalization Portugal Extension Installation Guide

Updated Functionality
The package of QAD Internationalization Portugal extension contains the following updated
functionality:
• Portugal SAFT-PT
The Portugal SAFT-PT menu now performs the following operations correctly:
• Sets the value in the SettlementAmount XML tag when there is no discount available
• Displays the Unit Price XML tag for negative trailer charges
• Displays the amount in the CreditAmount XML tag when a sales order is created with
multiple lines, where one of the lines contains the List Price value as zero

New Functionality
The QAD Internationalization Portugal extension package contains no new functionality.

Enhancements and Fixes

To view tickets related to enhancements and fixes in the QAD Internationalization Portugal
extension package, version 3.0.1, see the following links:
• QAD EE Product Changes UI
• QAD Adaptive UX Product Changes UI

Questions? Visit community.qad.com

 Release Notes for Previous Releases 99

Release Notes for 3.0 Release

QAD Portugal Internationalization Extension Version: 3.0
Release Date: December 2020
QAD Product Suite Compatibility: QAD 2016 Enterprise Edition and higher

Documentation Updates
The following documents are updated for this release:
• QAD Portugal Internationalization Extension User Guide
• QAD Portugal Internationalization Extension Installation Guide

New Functionality
The extension includes new functionality:
• Accessing the Portugal Functionality in Adaptive UX
• Fiscal Registration
• Portugal Customer Invoice Print and Portugal Invoice Print or Reprint reports
• QR and ATCUD codes
• Taxonomy Code

Updated Functionality
The extension contains updated functionality:
• SAF-T Declaration (Supplier Self-Invoice declaration is added)
• Generalized Codes Maintenance (Shipper ID can be printed in the XML output file)
• Annex O report (implements the Fiscal Registration functionality)
• Annex P report (implements the Fiscal Registration functionality)

Enhancements and Fixes

To view tickets related to enhancements and fixes in the QAD Portugal Internationalization
Extension package, see the Product Changes UI.

Comments? Go to goo.gl/MfwKHm
100 QAD Internationalization Portugal Extension User Guide

Release Notes for 2.2 Release

QAD Portugal Internationalization Extension Version: 2.2
Release Date: April 2019
QAD Product Suite Compatibility: QAD 2015 Enterprise Edition and higher

Documentation Updates
The following documents are updated for this release:
• QAD Portugal Internationalization Extension User Guide
• QAD Portugal Internationalization Extension Installation Guide

Updated Functionality
The extension contains the following updated functionality:
• SAF-T Declaration

Enhancements and Fixes

To view tickets related to enhancements and fixes in the QAD Portugal Internationalization
Extension package, see the Product Changes UI.

Questions? Visit community.qad.com

 Release Notes for Previous Releases 101

Release Notes for 2.1 Release

QAD Portugal Internationalization Extension Version: 2.1
Release Date: July 2018
QAD Product Suite Compatibility: QAD 2014 Enterprise Edition and higher

Documentation Updates
The following documents are updated for this release:
• QAD Portugal Internationalization Extension User Guide
• QAD Portugal Internationalization Extension Installation Guide

New Functionality
The extension includes new functionality:
• Annexio VAT Reports

Updated Functionality
The extension contains updated functionality:
• SAF-T Declaration
• Movement of Goods Authorization

Enhancements and Fixes

To view tickets related to enhancements and fixes in the QAD Portugal Internationalization
Extension package, see the Product Changes UI.

Comments? Go to goo.gl/MfwKHm
102 QAD Internationalization Portugal Extension User Guide

Release Notes for 2.0 Release

QAD Portugal Internationalization Extension Version: 2.0
Release Date: January 2017
QAD Product Suite Compatibility: QAD 2014 Enterprise Edition and higher

Documentation Updates
The following documents are updated for this release:
• QAD Portugal Internationalization Extension User Guide
• QAD Portugal Internationalization Extension Installation Guide

New Functionality
The QAD Portugal Internationalization Extension package contains new functionality:
• The QAD Portugal Internationalization Extension now supports the movement of goods
authorization in a shipper. The package allows you to communicate with the Tax and Customs
Authority—Autoridade Tributária e Aduaneira (AT) —Web service to request the
authorization and to assign it to a shipper.
• For information purposes, Internationalization Extensions (36.4.32) lists the version number
of each internationalization extension installed in an environment.

Updated Functionality
The QAD Portugal Internationalization Extension package contains updates to existing
functionality:
• The SAF-T QAD solution now conforms to version 1.03 of SAF-T (PT) specifications.
• The SAF-T QAD solution is available from the new menu number SAFT-PT (36.5.1.1).
It is necessary to remove the old SAF-T menu—in Regional Accounting/Tax Data Export—
from the installation. For more information about how to remove this menu, see QAD
Portugal Internationalization Extension Installation Guide.

Questions? Visit community.qad.com

 Index

Numerics D
25.3.13.2 54 Domain Modify 71
26.3.1 43
26.4.1 44 E
27.1.1.1 55, 56 Exchange Rate Create 44
36.1.1.1.2 71 Exchange Rate Type Create 43
36.2.13 53
36.3.1 20 F
36.5.8.7.1.1 58 Fiscal Registration 39
36.5.8.7.1.2 51
36.5.8.7.1.3 51 G
36.5.8.7.1.4 53 Generalized Codes Maintenance 53
36.5.8.7.1.5 52 GL Account Modify 54
36.5.8.7.13 42
36.5.8.7.14 42 P
36.5.8.7.15 43 Portugal Customer Invoice Print 84
36.5.8.7.2.1 73 Portugal Enable Fiscal Registration 42
36.5.8.7.2.2 55 Portugal Fiscal Registration 43
36.5.8.7.2.3 75 Portugal Fiscal Registration Control 42
36.5.8.7.2.4 79 Portugal Invoice Print or Reprint 87
36.5.8.7.2.5 93 Portugal Pre-Shipper/Shipper Print 93
36.5.8.7.3 63 Portugal SAFT-PT 58
36.5.8.7.4 63 Portugal SAFT-PT Control File 53, 57
36.5.8.7.5 66 Portugal SAFT-PT Item Browse 51
36.5.8.7.6.1 83 Portugal SAFT-PT Item Information 51
36.5.8.7.6.2 84 Portugal Serial Code Document Browse 83
36.5.8.7.6.3 87 Portugal Serial Document Maintenance 83
36.5.8.7.6.4 83 Portugal Tax Rate 52
A Q
Annex Limit Amount 63 QR and ATCUD Codes 81
Annex O Report 63
Annex P Report 66 S
AT Authorization 75
Shipper ATDocCodeID Maintenance 55
AT Authorization Browse 79
Site AT Control Menu 73
C
U
Customer Invoice Create 55, 56
User Maintenance 20
104 QAD Internationalization Portugal Extension User Guide

Questions? Visit community.qad.com