How to import data from a SAF-T (PT) file

At Moloni ON, you can import your data from a SAF-T (PT) file.

At Moloni ON, you can import your data from a SAF-T (PT) file. You upload the file in the Client Area, choose what you want to bring in - documents, entities, products, categories, taxes and units of measure - and Moloni ON handles the import. At the end, you organise the imported data in a seven-step wizard.

What can you import?

  • Customers and Suppliers;
  • Products, Categories, and Units of measure;
  • Taxes;
  • Documents: Invoices, Simplified Invoices, Invoice-Receipts, Credit/Debit Notes, Purchase Orders, Estimates, and Receipts.

The import process has 3 phases:

  • Analysis and selection - We validate your SAF-T (PT) file and present the data contained within it;
  • Import - We import it to your company;
  • Organisation - Organise the imported data.

Data analysis and selection

Follow these steps:

1. In the Client Area, go to the Tools menu, select Imports and click on SAF-T (PT).

Tools menu open in the Moloni ON Client Area, with the Imports and SAF-T (PT) options highlighted

2. Drag the desired file to the imports area, located in the centre of the page. You can also click that area to choose the file on your computer. Only .xml files are accepted.

Import SAF-T (PT) page with the central drag and drop area highlighted

3. Once the file is ready, the status changes to Ready to import and Moloni ON sends you a notification. Click on the 3-dot menu and select the option Select data to import.

Imported files list with the 3-dot menu open and the Select data to import option highlighted

4. A list will appear with all the data contained in your SAF-T (PT). In the Documents section, you can see what is new or what already exists, all organised by document type.

Documents section of the data selection list, showing the total to import, total found and already existing items

5. In the Customers section, you can see the customers from the file, organised as new or existing. For those that already exist, choose between Ignore and Update.

Customers section of the data selection list, with the Ignore and Update options for existing customers

6. Still in the customers, select whether you want to import All customers or only those Used in documents.

All and Used in documents options highlighted in the Customers section

7. The remaining sections are organised in the same way. Check each one and select the desired options. If you do not want to import a section, switch off the toggle in the top right corner of that section.

Products, Categories and Taxes sections in the data selection list

8. After confirming everything, click the Import data button in the top right corner to proceed with the import.

Import data button highlighted in the top right corner of the data selection list

Data Import

Now, simply wait for the data to be imported to your company. Moloni ON will send you a notification as soon as the import is finished.

Data Organisation

Once the import is complete, you should organise your data.

Follow these steps:

1. A message appears with the number of imported items and any errors and/or warnings. To continue, click the Organise data button.

Import completion message with the Organise data button highlighted

If you wish to view the list of errors/warnings, click on Download errors.

Import completion message with the Download errors button highlighted

2. Documents: in the Doc. set column, select the document set to associate with each document.

Doc. set column highlighted in the imported documents list

The document set must be created beforehand. You can have a document set solely for use in migrated balances; you do not need to report it to the TA (Tax Authority).

If necessary, select the rows you want to remove and click the Delete button.

Selected items bar with the Delete button highlighted in the documents list

Click the Save changes button.

Save changes button highlighted in the documents step

Confirm the fields that will be updated and click Apply.

Save confirmation dialog with the Apply button highlighted

Once all the documents are organised, click Next.

Documents step completion screen with the Next button highlighted

3. Customers and Suppliers: in the Country and Language columns, select the corresponding options.

Country and Language columns highlighted in the imported customers list

Click the Save changes button, confirm with Apply and, at the end, click Next.

Customers step completion screen with the Next button highlighted

4. Products: in the Price, Unit, and Category columns, select the corresponding options.

Price, Unit and Category columns highlighted in the imported products list

Click the Save changes button, confirm with Apply and move on with Next.

5. Product categories: in the Parent category column, select the corresponding option.

Parent category column highlighted in the imported product categories list

This allows you to define hierarchical relationships between categories by setting a parent category for the imported categories.

Click the Save changes button, confirm with Apply and, at the end, click Next.

Product categories step completion screen with the Next button highlighted

6. Taxes: in the Name column, you can edit the name of the tax.

Name column highlighted in the imported taxes list

Click the Save changes button, confirm with Apply and move on with Next.

7. Units of measure: in the UNECERec20 code column, select the corresponding code.

UNECERec20 code column highlighted in the imported units of measure list

Click the Save changes button and confirm with Apply.

Save changes button highlighted in the units of measure step

Once all the steps are complete, Moloni ON confirms that you have everything well-organised.

Final screen of the organisation wizard confirming that everything is organised