Article Import

Short description

This import is enabled for customers that manage their product data in the PIM component of Vendisto.

The Article XML import is the XML equivalent of the Article Excel import. These files enable the user to batch update product data in Vendisto.

The file can be upload by hand into Vendisto via the import/export dialog or by an automated process that is started when the file is placed in the correct upload location within in the FTP root.

If an optional field is left empty, or the element itself does not exist, the importer will use an empty string.

Delivery method

Update Frequency: Batch at least once a day

Incremental or complete set: Incremental

Filetype: Zipped XML

Filename: [SHOPNAME]_Articles_[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: \Vendisto\Integration\

Structure XML

<?xml version="1.0" encoding="utf-8"?>
<Import>
    <ImportSettings>
        <Importer>Articles</Importer>
        <Version>1.0</Version>
        <IsPartial>Y</IsPartial>
        <CreateUnknownClassificationPaths>Y</CreateUnknownClassificationPaths>
        <SplitArticlePropertyValuesInUnits>Y</SplitArticlePropertyValuesInUnits>
        <DisableGtinValidation>N</DisableGtinValidation>
        <DeleteNotImportedProperties>N</DeleteNotImportedProperties>    
        <ArticleGroupDefaultTitle>ArticleNumber</ArticleGroupDefaultTitle>    
        <EnableArticleGroupSplitting>N</EnableArticleGroupSplitting>    
    </ImportSettings>
    <ArticleGroups>
        <ArticleGroup id="">
            <Name>String</Name>
            <DescriptionHeader>String</DescriptionHeader>
            <DescriptionFooter>String</DescriptionFooter>
            <Brand>String</Brand>
            <Kind>String</Kind>
            <BluePencil transposed=""/>
            <Classification declassify="">
                <Level1>string</Level1>
                <Level2>string</Level2>
                <Level3>string</Level3>
                <Level4>string</Level4>
            </Classification>
            <Assets>
                <Logo>
                    <Name>String</Name>
                    <Value>String</Value>
                </Logo>
                <Image>
                    <Name>String</Name>
                    <Value>String</Value>
                </Image>
                <Icon>
                    <Name>String</Name>
                    <Value>String</Value>
                </Icon>
                <Document>
                    <Name>String</Name>
                    <Value>String</Value>
                </Document>
                <Media>
                    <Name>String</Name>
                    <Value>String</Value>
                </Media>
            </Assets>
            <Articles>
                <Article number="" gtin="" state="">
                    <Title>String</Title>
                    <Description>String</Description>
                    <TypeNumber>String</TypeNumber>
                    <Manufacturer gln="" mpn="" gtin=""/>
                    <SubGroup id="" index=""/>
                    <Assets>
                        <Logo>
                            <Name>String</Name>
                            <Value>String</Value>
                        </Logo>
                        <Image>
                            <Name>String</Name>
                            <Value>String</Value>
                        </Image>
                        <Icon>
                            <Name>String</Name>
                            <Value>String</Value>
                        </Icon>
                        <Document>
                            <Name>String</Name>
                            <Value>String</Value>
                        </Document>
                        <Media>
                            <Name>String</Name>
                            <Value>String</Value>
                        </Media>
                    </Assets>
                    <Properties>
                        <Property>
                            <Header>String</Header>
                            <Value>String</Value>
                            <Unit>String</Unit>
                            <Icon>String</Icon>
                            <BluePencil hidden="" spec="" index="">
                                <Description>String</Description>
                                <Icon>String</Icon>
                            </BluePencil>
                        </Property>
                    </Properties>
                    <AuthorizationProfiles>
                        <AuthorizationProfile>
                        </AuthorizationProfile>
                        <AuthorizationProfile>
                        </AuthorizationProfile>
                    </AuthorizationProfiles>
                </Article>
            </Articles>
            <SubGroups>
                <SubGroup id="">
                    <DescriptionHeader>String</DescriptionHeader>
                    <DescriptionFooter>String</DescriptionFooter>
                </SubGroup>
            </SubGroups>
        </ArticleGroup>
    </ArticleGroups>
</Import>

Fields XML

Import element:

ImportSettings element:

The IsPartial element works on rows, not columns. A partial import will update or add the articles it contains, and will not delete articles that are not mentioned. For a specific article, the partial import assumes that the information that is offered is exhaustive, and will delete any information that is present in the database but not mentioned in the file.

ArticleGroup element:

BluePencil element:

Classification element:

Assets element:

Logo, Image, Icon, Media (Asset) element:

Article element:

Manufacturer element:

Article/SubGroup element:

Article/Property element:

Properties are always imported as a full set. When importing properties, the full set should be present, or alternatively no properties at all. If the file contains only a subset of the properties for a specific article, all properties that are not specified will be deleted.

Property/BluePencil element:

SubGroup element:

AuthorizationProfile element:

Types: