Skip to main content

How to import PIES

This article provides a clear process for importing PIES, including required structure, minimum segments and fields, and expected values

Updated over a week ago

To have a successful import, your .xml file must meet the format and structural requirements defined by the PIES standard and supported by PDM. This includes using the correct file extension, encoding, and schema version, as well as including the required segments and fields.

This article outlines the minimum requirements your PIES file must meet to be considered valid for import, including:

  • File format and encoding expectations

  • Required XML segments and their structure

  • Mandatory fields within each segment.

  • Examples of expected values.

By following these guidelines, you can ensure your data is properly structured and ready for import into PDM.

Prepare your PIES file

Make sure your XML file meets these requirements before uploading:

  • Extension: Must be .xml

  • Encoding: Use UTF‑8

  • Schema Version: Should match the versions supported by PDM, such as 7.2

  • Required Sections:

    • Header: General info about your file

    • Items: Your product records, one for each item

    • Trailer: Summary details

Tip: If you’re unsure, add a test product in PDM and export a sample PIES XML to use as a template.

Fill in All Required Fields

Minimum Required Segments

Here are the fields PDM expects to see in your file:

Segment Name

XML Element

Description

Header

<Header>

File metadata and trading partner info

Items

<Items>

Contains one or more <Item> segments

Trailer

<Trailer>

File summary and validation info

Minimum Required Fields to create a new product

Header Segment (<Header>)

Field Name

XML Element

Requirement

Expected Value Example

Notes

PIES Version

<PIESVersion>

Mandatory

7.2

Current PIES version

Submission Type

<SubmissionType>

Mandatory

FULL, UPDATE, TEST

Indicates file type

PCdb Version Date

<PCdbVersionDate>

Mandatory

2025-07-31

Latest Autocare table version

PAdb Version Date

<PAdbVersionDate>

Mandatory

2025-07-31

Latest Autocare table version

FULL, UPDATE, or TEST Submission Type: All work the same in PDM

Here are the expected values for the Header segment and the version of PIES, you can see them by going to ACES/PIES XML Headers in the Brand settings segment.

Item Segment (<Item> inside <Items>)

Field Name

XML Element

Requirement

Expected Value Example

Notes

Maintenance Type

<MaintenanceType>

Mandatory

A (Add), C (Change)

Indicates action for item

Part Number

<PartNumber>

Mandatory

TEST01

Unique product identifier

Brand AAIAID

<BrandAAIAID>

Mandatory

XXXX

Brand code (Autocare or internal)

Trailer Segment (<Trailer>)

Field Name

XML Element

Requirement

Expected Value Example

Notes

Item Count

<ItemCount>

1

Number of items in file

Transaction Date

<TransactionDate>

Mandatory

2025-07-10

Date file was created

Step-by-Step Instructions

  • Validate your XML file against the PIES guidelines before importing.

  • Confirm that all mandatory fields are present.

  • Choose the correct Brand

  • Click on the Import/Export tab on the left bar.

  • In the Import/Export tab, select Import.

  • Choose PIES as the format.

  • Click Upload and select your PIES file.

  • After uploading, review the import report for errors.

  • If there are errors, download the error report and follow the instructions.

To understand the structure and expected format, we recommend filling everything manually for a part number and exporting PIES to have a template.

Tips for Successful Import

  • Always validate your XML file with the official PIES guidelines before importing.

  • Ensure all required elements and attributes are present and correctly formatted.

  • Only include one brand per XML file.

  • Do not alter the XML header structure unless instructed.

  • Review error messages carefully and correct issues before re-importing.

  • If you remove segments from the file, PDM will ignore that; they won't be removed.

You cannot leave a segment without any data. You'll get the warning "Missing child elements"

Attachment icon
Did this answer your question?