XML

XML is a flexible, text-based format used for structuring and storing data, commonly used in web services and data exchange between systems.

XML settings

Product Element

The key information required by Stockeo is the node name that contains the data for a single product.

<Products>
    <Product>
        <Code>0260</Code>
        <Title>Sitting Jazz Band Saxophonist</Title>
        <Price>13.73</Price>
        <RRP>32.95</RRP>
        <AvailableStock>181</AvailableStock>
        <Barcode>5050140026007</Barcode>
        <Description>A sitting jazz man, playing the saxophone.</Description>
        <Image>https://www.hill-interiors.com/images/giant/0260.jpg</Image>
    </Product>
    <Product>
        <Code>0261</Code>
        <Title>Sitting Jazz Band Trumpeter</Title>
        <Price>13.73</Price>
        <RRP>32.95</RRP>
        <AvailableStock>162</AvailableStock>
        <Barcode>5050140026106</Barcode>
        <Description>Bring timeless musical elegance to any setting with the Sitting Jazz Band
            Trumpeter.</Description>
        <Image1>https://www.hill-interiors.com/images/giant/0261.jpg</Image>
    </Product>
</Products>

In such a case above enter Product in the Product Element field.

Product Element

Fields associated with the product are relative to the node used as Product Element:

• Title

• Description

• Image URL

• Product Type

• Tag

• Vendor

• Product Metafield

Variant Element

Fill in this field only when variants are nested in the product node.

If variants are in separate nodes at the product level and have a node with the same value for all variants of a specific product like product name, parent SKU, or parent ID, leave this field empty. For more information navigate to Variants.

<Products>
    <Product>
        <Code>0260</Code>
        <Title>Sitting Jazz Band Saxophonist</Title>
        <Description>A sitting jazz man, playing the saxophone.</Description>
        <Image>https://www.hill-interiors.com/images/giant/0260.jpg</Image>
        <Variants>
            <Variant>
                <VariantCode>0260S</VariantCode>
                <Price>13.73</Price>
                <RRP>32.95</RRP>
                <AvailableStock>181</AvailableStock>
                <Barcode>5050140026007</Barcode>
                <Option>Small</Option>
            </Variant>
            <Variant>
                <VariantCode>0260M</VariantCode>
                <Price>20.59</Price>
                <RRP>32.95</RRP>
                <AvailableStock>56</AvailableStock>
                <Barcode>5050140026008</Barcode>
                <Option>Medium</Option>
            </Variant>
            <Variant>
                <VariantCode>0260L</VariantCode>
                <Price>30.89</Price>
                <RRP>32.95</RRP>
                <AvailableStock>74</AvailableStock>
                <Barcode>5050140026009</Barcode>
                <Option>Large</Option>
            </Variant>
        </Variants>
    </Product>
</Products>

In such a case above enter Variants/Variant in the Variant Element field.

Variant Element

Fields associated with the variant are relative to the node used as Variant Element:

• SKU

• Barcode

• Compare at price

• Continue selling when out of stock

• Charge tax

• Cost per item

• Market Price

• Price

• Quantity

• Weight

• Variant Metafield

• Option

An example feed mapping, where variant nodes are embedded within product nodes, may look as follows:

Data Mapping section with Variant Element

Enhanced XML Data Mapping

Product data might sometimes be stored in XML attributes. To navigate through elements and attributes in an XML document Stockeo relies on XPath. You can use the XPath expressions to pull data from a node's attribute or to extract data from a node containing a specific attribute with a specific value.

Extract data from an attribute

It can be that the data you want to extract from an XML and use them for creating/updating products are stored as XML attributes.

<product id="3378" currency="EUR" code_on_card="01269" producer_code_standard="OTHER" type="regular" vat="23.0" site="7">
  <names>
    <name xml:lang="eng"><![CDATA[Wooden Clock With Nickel Details]]></name>
    <name xml:lang="hun"><![CDATA[Fa óra nikkel részletekkel]]></name>
    <name xml:lang="pol"><![CDATA[Drewniany zegar z niklowymi dodatkami]]></name>
  </names>
  <stock quantity="443" available_stock_quantity="443" stock_quantity="443.000"/>
  <images>
    <large>
      <image iaiext:priority="1" url="https://www.hill-interiors.com/images/giant/19184.jpg" width="750" height="562"/>
      <image iaiext:priority="2" url="https://www.hill-interiors.com/images/giant/19185.jpg" width="750" height="562"/>
    </large>
    <icons>
      <icon url="https://www.hill-interiors.com/images/19186.jpg" 15:25:09" width="400" height="299"/>
    </icons>
  </images>
</product>

In the above example, the node with all information about a product is <product>.

Stockeo Product Element in the XML automation

The path to the nodes nested within it is relative. To get the id value which is the attribute of the product node, type the @ sign and attribute name.

Stockeo setting

Use the attribute of the stock node in the Stockeo automation

Copy this setting

To extract an attribute value from a node nested within <product>, enter the child node name, slash, @ sign and attribute name.

Stockeo setting

Use the attribute of the stock node in the Stockeo automation

Copy this setting

Select the node with the specific attribute

It may also happen you want to select a node with a specific attribute from which you need to extract data. Assume you would like to extract the product title from the name node containing the xml:lang="eng" attribute. In this case, provide the node name, and in the square bracket type the @ sign followed by the name of the attribute with its value. For our example XML it looks like this:

Stockeo setting

Select node with a specific attribute in the Stockeo automation

Copy this setting

Another example illustrates a combination of both: selecting a node with a specific attribute value and extracting data from the attribute to pull all product images from the feed.

Stockeo setting

Pull data from attribute of a node with specific other attribute in Stockeo automation

Copy this setting