skroutz / developer.skroutz.gr

The Skroutz developer platform
https://developer.skroutz.gr
Other
33 stars 18 forks source link

Multiple Colors in Skroutz - XML With size Variations. #210

Open Shahed-BD71 opened 1 year ago

Shahed-BD71 commented 1 year ago

We do not understand the multiple colors. Your example has a single color, White. What if, If I have multiple colors?

Please advise. It will be helpful to us if you provide this code example with multiple colors.

teokal commented 1 year ago

@Shahed-BD71 please check https://developer.skroutz.gr/feedspec/#color

In case multiple colors for a given model exist, they should be submitted as different products with separate Unique IDs.

Practically, you will send a different <product> for each available color.

That being said, it will be (removed basic fields):

<products>
  <product>
    <!-- Unique ID for Product and Color -->
    <!-- This id will also be needed for Skroutz Analytics and Skroutz Reviews. -->
    <!-- It cannot be changed. Make sure it is future-proof and can be  -->
    <!-- reverse-matched from your shop if needed (e.g.: Skroutz Marketplace) -->
    <id>productId-colorId</id>

    <!-- Product's title - Product Color -->
    <name><![CDATA[Product Title - Color]]></name>

    <!-- Product's URL, can optionally have parameters to preselect color -->
    <link><![CDATA[https://www.mywebstore.co.uk/product/322233?color=colorID]]></link>

    <!-- Product's main image. Can be different for each color -->
    <!-- Same applies to `additional_images` -->
    <image><![CDATA[https://www.mywebstore.co.uk/product/322233-COLOR_TITLE.jpg]]></image>

    <!-- Product's MPN - color differentiated if available -->
    <mpn>M7652C</mpn>

    <!-- Product's available sizes for this color -->
    <!-- Comma separated, use . (dot) as a decimal separator -->
    <size>43,44.5</size>

    <!-- Product's color (as on title) -->
    <color>White</color>

    <!-- Product's available quantity of this color -->
    <!-- Should be the sum of variations' `quantity` -->
    <quantity>10</quantity>

    <!-- Size variations of product and color -->
    <variations>
      <variation>
        <!-- Variation's unique ID - Could be the sku ID -->
        <!-- It cannot be changed. Make sure it is future-proof and can be  -->
        <!-- reverse-matched from your shop if needed (e.g.: Skroutz Marketplace) -->
        <variationid>SkuId</variationid>

        <!-- Variation Link, else it will be product's URL -->
        <link><![CDATA[https://www.mywebstore.co.uk/product/322233?color=White&size=43]]></link>

        <!-- Variation's MPN -->
        <manufacturersku>M7652C</manufacturersku>

        <!-- Variation's EAN -->
        <ean>886952780692</ean>

        <!-- Variation's Final Price -->
        <price_with_vat>33.00</price_with_vat>

        <!-- Variation's Size -->
        <size>43</size>

        <!-- Variation's Available Stock -->
        <quantity>6</quantity>
      </variation>
    </variations>
  </product>
</products>

Edited example from Skroutz's documentation.

   <products>
      <product>
        <id>322233.White</id>
        <name><![CDATA[Converse All Star Chuck Taylor Ox - White]]></name>
        <link><![CDATA[https://www.mywebstore.co.uk/product/322233?color=White]]></link>
        <image><![CDATA[https://www.mywebstore.co.uk/product/322233-White.jpg]]></image>
        <mpn>M7652C-White</mpn>
        <size>43,45</size>
        <color>White</color>
        <quantity>10</quantity>
        <variations>
          <variation>
            <variationid>322233.White.43</variationid>
            <link><![CDATA[https://www.mywebstore.co.uk/product/322233?color=White&size=43]]></link>
            <manufacturersku>M7652C</manufacturersku>
            <ean>886952780692</ean>
            <price_with_vat>33.00</price_with_vat>
            <size>43</size>
            <quantity>6</quantity>
          </variation>
          <variation>
            <variationid>322233.White.45</variationid>
            <link><![CDATA[https://www.mywebstore.co.uk/product/322233=White&size=45]]></link>
            <manufacturersku>M7653C</manufacturersku>
            <ean>886952780693</ean>
            <price_with_vat>30.00</price_with_vat>
            <size>45</size>
            <quantity>4</quantity>
          </variation>
        </variations>
      </product>
      <product>
        <id>322233.Blue</id>
        <name><![CDATA[Converse All Star Chuck Taylor Ox - Blue]]></name>
        <link><![CDATA[https://www.mywebstore.co.uk/product/322233?color=Blue]]></link>
        <image><![CDATA[https://www.mywebstore.co.uk/product/322233-Blue.jpg]]></image>
        <mpn>M7654C</mpn>
        <size>42,44</size>
        <color>Blue</color>
        <quantity>4</quantity>
        <variations>
          <variation>
            <variationid>322233.Blue.42</variationid>
            <link><![CDATA[https://www.mywebstore.co.uk/product/322233?color=Blue&size=42]]></link>
            <manufacturersku>M7654C</manufacturersku>
            <ean>886952780694</ean>
            <price_with_vat>30.00</price_with_vat>
            <size>42</size>
            <quantity>3</quantity>
          </variation>
          <variation>
            <variationid>322233.Blue.44</variationid>
            <link><![CDATA[https://www.mywebstore.co.uk/product/322233?color=Blue&size=44]]></link>
            <manufacturersku>M7655C</manufacturersku>
            <ean>886952780695</ean>
            <price_with_vat>35.00</price_with_vat>
            <size>44</size>
            <quantity>1</quantity>
          </variation>
        </variations>
      </product>
   </products>
</mywebstore>

Make sure you use the XML validator: https://validator.skroutz.gr

If needed, you can raise a ticket from the Skroutz Merchants panel.

I hope that helps.