Price Lists

Short description

The Shoxl PriceList interface allows the import of price lists from ERP to the Shoxl Shop. The import can contain multiple price lists. The import enables the filtering of articles on net prices if the price model of the ERP system can be mapped to PriceLists and Customer-specific prices. Prices can be defined in multiple currencies. If no currency is specified then the price will be imported in Euro.

Delivery method

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

Filetype: Zipped XML

Filename: [SHOPNAME]_Shoxl_PriceLists_[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: \ShoxlPro\XmlImport\

Structure XML

<?xml version="1.0" encoding="utf-8"?>
<Import>
    <ImportSettings>
        <Importer>Shoxl_PriceLists</Importer>
        <Version>1.0</Version>
        <PartialImport>N</PartialImport>
    </ImportSettings>
    <PriceLists>
        <PriceList>
            <PriceListName></PriceListName>
            <ProductNumber></ProductNumber>
            <VatPercentage></VatPercentage>
            <QuantityDiscountPrices>
                <QuantityDiscountPrice>
                    <FromQuantity></FromQuantity>
                    <ToQuantity></ToQuantity>
                    <NettoPricePerItemExclVat Currency=""></NettoPricePerItemExclVat>
                </QuantityDiscountPrice>
            </QuantityDiscountPrices>
        </PriceList>
    </PriceLists>
</Import>

Fields XML

Import element:

Name	Description	Type	Required/Optional
ImportSettings	Container element for importsettings	Element	Required
PriceLists	Container element for PriceList data	Element	Required

ImportSettings element:

Name	Description	Type	Required/Optional
Importer	Name of the importer. Must be Shoxl_PriceLists.	Text	Required
Version	Version of the import xml. To be used for backward compatibility issues.	Text, must be 1.0	Required
PartialImport	Defines if the priceslists in the file contain prices for all the articlenumbers in the pricelist or if the prices represent a partial update of the pricelist.	Boolean, Default N	Optional

PriceList element:

Name	Description	Type	Required/Optional
PriceListName	Name of price list	Text	Required
ProductNumber	The identifier of a product	Text	Required
VatPercentage	VAT Percentage (%)	Decimal	Required
QuantityDiscountPrices	Container element for QuantityDiscountPrice data	Element	Required

QuantityDiscountPrice element: Prices can optionally be defined in multiple currencies. The NettoPricePerItemExclVat element may therefore occur more then once within a QuantityDiscountPrice element.

Name	Description	Type	Required/Optional
FromQuantity	The from quantity where the discount price is valid from	Decimal	Required
ToQuantity	The to quantity where the discount price is valid to	Decimal	Optional
NettoPricePerItemExclVat	The calculated net price per item. This is the price including discounts.	Decimal	Required
Currency	Attribute on NettoPricePerItemExclVat or DiscountAmountPerItemExclVat. Must contain the ISO 4217 3-letter currency code. Default is EUR.	Char[3]	Optional

Type	Values
Boolean	Y, N
Decimal	Number with point (.) as decimal separator character. Other separators are not allowed.