Movement of Goods in Portugal Localization SuiteApp

As a company in Portugal that deals with selling and delivering products, you must declare the movement of goods and have the shipping documents validated by the Portugal Tax and Customs Authority (AT) before they leave your company's premises. Declaring the movement of goods is additionally required for transporting goods between warehouses owned by the same company. For more information, see Portugal Shipping Documents.

To declare and validate the Movement of Goods:

Generate the SAF-T for Shipping file in NetSuite. For more information, see Generating the SAF-T for Shipping File in Portugal Localization SuiteApp.
Submit the SAF-T for Shipping file to AT.
Obtain an XML file from AT. For each shipping document, The XML file should contain a ATDocCodeID. Receiving the ATDocCodeIDs from AT indicates that the shipping documents have been validated by AT.
In NetSuite, upload the XML file from AT to update the shipping documents' ATDocCodeIDs. For more information, see Updating ATDocCodeIDs in Portugal Shipping Documents.

Assigning Permissions to Generate the PT SAF-T Files

Besides the standard roles supported by the Portugal Localization SuiteApp, you can also assign other standard or custom roles the permissions to generate, view, and download the PT SAF-T files.

The roles must have sufficient permissions to the Tax Reporting Framework SuiteApp and must not have restrictions to general ledger (GL) accounts.

To assign permissions for generating the PT SAF-T files:

Go to Setup > Tax Reporting > Manage Tax Reporting Framework Roles.
Click Assign Tax Reporting Framework Permissions to a Role.
In the Role field, select a non-Administrator role to whom you want to grant permissions for generating the PT SAF-T file.
Next to the Country Tax Report permission, select the level Full.

This permission enables the role to generate, view, and export tax reports. For information about other permissions you can grant to a role, see Roles and Permissions in Tax Reporting Framework.
Next to the Country Tax Report Preferences permission, select the level Full.

This permission enables the role to modify the start date, reporting frequency, and period filters of country tax reports.

Important:
Full-level permissions for both Country Tax Report and Country Tax Report Preferences enable the role to access the Generate SAF-T Shipping page. Other levels in either of these permissions are insufficient to access the page.
Click Save.
Go to Setup > Users/Roles > User Management > Manage Roles.
Click Customize (if the role is a standard NetSuite role) or Edit next to the role that you assign tax reporting framework permissions.
On the Restrictions subtab, see what segments this role is restricted to.
Verify which accounts are restricted to the mentioned segment on the Restrictions subtab: class, location, or department.

You can use saved searches to audit roles. For more information, see Use Searches to Audit Roles.
Clear or adjust the restrictions as necessary.

The role you have chosen must not have restrictions to all GL accounts.

Generating the SAF-T for Shipping File in Portugal Localization SuiteApp

Note:

This procedure refers to generating the PT SAF-T files provided by the Portugal Localization SuiteApp. It provides support in generating shipping documents that are required in Portugal for the goods in circulation, and are created in NetSuite using item fulfillments.

Before generating the PT SAF-T for Shipping report, you must select which item fulfillments, which act as the shipping documents, you want to include in the report.

To generate SAF-T for Shipping file:

Go to Reports > Portugal Localization > Generate SAF-T Shipping.
From the Subsidiary list, select a subsidiary whose item fulfillments you want to include in the SAF-T for Shipping report.
(Optional) Set a date range. The date range filters out the item fulfillments of the selected subsidiary, whose transaction date is within the date range.
On the Generate SAF-T Shipping page, check the boxes next to the item fulfillments that you want to include in the SAF-T for Shipping report.

The list of filtered item fulfillments you can choose from only contains certified item fulfillments, which means those that have a Portugal Transaction ID. Only certified item fulfillments are considered for SAF-T for Shipping report generation.

The Included in SAFT Shipping On column indicates which specific item fulfillments have already been reported in the SAF-T for Shipping file. It shows the date when a specific item fulfillment was last included in the report.

Note:
You should only add up to 500 item fulfillments to this list.
Click Generate Report. This button leads you to the Country Tax Report page, where the SAF-T for Shipping report is being generated. You do not have to fill in the fields on the Country Tax Report page.

Downloading the SAF-T for Shipping File

Generating the SAF-T for Shipping file is initiated on the Generate SAF-T Shipping page, but the file is generated and becomes available for download from the Country Tax Report page. To go to the Country Tax Report page manually, go to Reports > Tax > Country Tax Report.

On the Report Execution Log subtab, click Download next to the generated SAF-T for Shipping report.

If errors occur during the report generation, download a TXT file with details about the error. If the error refers to missing information, see Portugal SAF-T for Shipping and find out which fields in the affected transaction records you need to fill in to address the error.

Updating ATDocCodeIDs in Portugal Shipping Documents

ATDocCodeID is a code provided by the Portugal Tax and Customs Authority (AT) as an indication that the item fulfillment record has been validated. You must update the shipping documents with the ATDocCodeIDs. In NetSuite, the item fulfillments act as the shipping documents.

Note:

This procedure refers to updating the shipping documents‘ ATDocCodeIDs, which you received from AT in the XML file format. After the update, they can be found in the item fulfillment records.

Before updating the ATDocCodeIDs, you must select the subsidiary that is associated with the shipping documents that you want to update.

To update shipping documents' ATDocCodeIDs:

Go to Reports > Portugal Localization > ATDocCodeIDs Update.
From the Subsidiary list, select a subsidiary whose item fulfillments you want to include in the ATDocCodeIDs Update. Filling out this field is required.
Drag-and-drop the XML files containing the ATDocCodeIDs that you want to update into the drag-and-drop pane. You can upload only one XML at a time.

Important:
Do not edit the XML file that you received from AT manually. If you encountered a notification that the file upload failed owing to a nonstandard schema or invalid XML, do not attempt to alter the file. Instead, report the error to the XML provider.
Make sure that the Update button is enabled. If it remains disabled, check if subsidiary is selected.
Click Update.

If the update is successful, you can see the updated list of ATDocCodeIDs generated below in the table or by accessing the item fulfillments list through the link in the banner.

If an error occurs, see Resolving Possible Error Scenarios for SAF-T for Shipping XML Files Upload, and Resolving Possible Error Scenarios for ATDocCodeIDs Update for more information.

General Notices