# Package Units Import

## Short description

This import is suitable for customers that want their shop to display multiple package units (e.g. Piece, Box, Pallet) on the article detail page. The import supports enables the user to define a list of available package units per article.

The package units will be directly imported in the shop database and will not be available in Vendisto. The import requires a complete set (for all articles).

## Delivery method

**Update Frequency**: Batch at least once a day\
**Incremental or complete set:** complete

**Filetype:** Zipped XML

**Filename: \[SHOPNAME]\_ArticlePackageUnits**\_**\[INDEXNUMBER]**.xml\
**Transport:** over FTPS, FTPS Vendisto server hosted by INTEGRACE, file will be placed on FTPS server by ERP party.

**Location within FTP root:** \Production\\

## Structure XML

*Contains example values*

```markup
<?xml version="1.0" encoding="utf-8"?>
<Import>
    <ImportSettings>
        <Importer>ArticlePackageUnits</Importer>
        <Version>1.0</Version>
    </ImportSettings>
    <ArticlePackageUnits>
        <ArticlePackageUnit>
            <ArticleNumber>123</ArticleNumber>
            <PackageBaseUnit>Piece</PackageBaseUnit>
            <PackageUnits>
                <PackageUnit>
                    <Unit>Box</Unit>
                    <Quantity>20</Quantity>
                </PackageUnit>
                <PackageUnit>
                    <Unit>Outer box</Unit>
                    <Quantity>100</Quantity>
                </PackageUnit>
                <PackageUnit>
                    <Unit>Pallet</Unit>
                    <Quantity>240</Quantity>
                </PackageUnit>
            </PackageUnits>
        </ArticlePackageUnit>
    </ArticlePackageUnits>
</Import>
```

## Fields XML

**Import element:**

<table data-header-hidden><thead><tr><th width="213.92212524611355">Name</th><th width="180">Description</th><th width="150">Type</th><th>Required/Optional</th></tr></thead><tbody><tr><td>Name</td><td>Description</td><td>Type</td><td>Required/Optional</td></tr><tr><td>ImportSettings</td><td>Container element for importsettings</td><td>Element</td><td>Required</td></tr><tr><td>ArticlePackageUnits</td><td>Container element for list of ArticlePackageUnit elements</td><td>Element</td><td>Required</td></tr></tbody></table>

**ImportSettings element:**

<table data-header-hidden><thead><tr><th width="174">Name</th><th>Description</th><th width="150">Type</th><th>Required/Optional</th></tr></thead><tbody><tr><td>Name</td><td>Description</td><td>Type</td><td>Required/Optional</td></tr><tr><td>Importer</td><td>Name of the importer.<br>Must be ArticlePackageUnits.</td><td>Text</td><td>Required</td></tr><tr><td>Version</td><td>Version of the import xml. To be used for backward compatibility issues.</td><td>Text,<br>default 1.0</td><td>Required</td></tr></tbody></table>

**ArticlePackageUnit element:**

<table data-header-hidden><thead><tr><th width="198.76795580110496">Name</th><th>Description</th><th width="150">Type</th><th>Required/Optional</th></tr></thead><tbody><tr><td>Name</td><td>Description</td><td>Type</td><td>Required/Optional</td></tr><tr><td>ArticleNumber</td><td>Article number of the article</td><td>Text</td><td>Required</td></tr><tr><td>PackageBaseUnit</td><td>Unit on which the quantities of the article's package units are based</td><td>Text</td><td>Required</td></tr><tr><td>PackageUnits</td><td>Container element for list of PackageUnit elements</td><td>Element</td><td>Required</td></tr></tbody></table>

**PackageUnit element**

<table data-header-hidden><thead><tr><th width="198.76795580110496">Name</th><th>Description</th><th width="150">Type</th><th>Required/Optional</th></tr></thead><tbody><tr><td>Name</td><td>Description</td><td>Type</td><td>Required/Optional</td></tr><tr><td>Unit</td><td>Name of the package unit</td><td>Text</td><td>Required</td></tr><tr><td>Quantity</td><td>Number of PackageBaseUnits contained in the Package Unit</td><td>int</td><td>Required</td></tr></tbody></table>