Developers Program

How do I edit multi-variation listings to include the new item specific details in the variations?

Published: May 02 2011, 4:13:00 PMยทUpdated: September 07 2022, 2:43:13 PM

Products

Question

For e.g. Women's Jeans now require Brand, Trouser Size, Style. My listings have Size as the variation. How do I update these listings to have the variation updated to Trouser Size?

Answer

You can pass Variation.Delete flag and set it to true in ReviseFixedPriceItem API call to delete a variation even if the variation still has quantity and/or has had one or more previous sales during the life of the listing

Below is the sample ReviseFixedPriceItem request xml snippet with new variations which have Variation as 'Trouser Size' and delete the existing variations with the old item specific (Size):

Variations container for original listing
<Variations>
<Variation>
<SKU><![CDATA[4451___1]]></SKU>
<StartPrice currencyID="GBP">49.99</StartPrice>
<Quantity><![CDATA[10]]></Quantity>
<VariationSpecifics>
<NameValueList>
<Name><![CDATA[Size]]></Name>
<Value><![CDATA[30]]></Value>
</NameValueList>
</VariationSpecifics>
</Variation>
<Variation>
<SKU><![CDATA[4451___2]]></SKU>
<StartPrice currencyID="GBP">49.99</StartPrice>
<Quantity><![CDATA[10]]></Quantity>
<VariationSpecifics>
<NameValueList>
<Name><![CDATA[Size]]></Name>
<Value><![CDATA[32]]></Value>
</NameValueList>
</VariationSpecifics>
</Variation>
<Variation>
<SKU><![CDATA[4451___3]]></SKU>
<StartPrice currencyID="GBP">49.99</StartPrice>
<Quantity><![CDATA[10]]></Quantity>
<VariationSpecifics>
<NameValueList>
<Name><![CDATA[Size]]></Name>
<Value><![CDATA[34]]></Value>
</NameValueList>
</VariationSpecifics>
</Variation>
<VariationSpecificsSet>
<NameValueList>
<Name><![CDATA[Size]]></Name>
<Value><![CDATA[30]]></Value>
<Value><![CDATA[32]]></Value>
<Value><![CDATA[34]]></Value>
</NameValueList>
</VariationSpecificsSet>
</Variations>

Variations container for relist request
<Variations>
<!--Delete existing variations and add new variations -->

<Variation>
<SKU><![CDATA[4451___1]]></SKU>
<Delete>true</Delete>
</Variation>
<Variation>
<SKU><![CDATA[4451___2]]></SKU>
<Delete>true</Delete>
</Variation>
<Variation>
<SKU><![CDATA[4451___3]]></SKU>
<Delete>true</Delete>
</Variation>
<Variation>
<SKU><![CDATA[4451___11]]></SKU>
<StartPrice currencyID="GBP">49.99</StartPrice>
<Quantity><![CDATA[10]]></Quantity>
<VariationSpecifics>
<NameValueList>
<Name><![CDATA[Trouser Size]]></Name>
<Value><![CDATA[30]]></Value>
</NameValueList>
</VariationSpecifics>
</Variation>
<Variation>
<SKU><![CDATA[4451___21]]></SKU>
<StartPrice currencyID="GBP">49.99</StartPrice>
<Quantity><![CDATA[10]]></Quantity>
<VariationSpecifics>
<NameValueList>
<Name><![CDATA[Trouser Size]]></Name>
<Value><![CDATA[32]]></Value>
</NameValueList>
</VariationSpecifics>
</Variation>
<Variation>
<SKU><![CDATA[4451___31]]></SKU>
<StartPrice currencyID="GBP">49.99</StartPrice>
<Quantity><![CDATA[10]]></Quantity>
<VariationSpecifics>
<NameValueList>
<Name><![CDATA[Trouser Size]]></Name>
<Value><![CDATA[34]]></Value>
</NameValueList>
</VariationSpecifics>
</Variation>

<VariationSpecificsSet>
<NameValueList>
<!--Update VariationSpecificsset with the new name -->

<Name><![CDATA[Trouser Size]]></Name>
<Value><![CDATA[30]]></Value>
<Value><![CDATA[32]]></Value>
<Value><![CDATA[34]]></Value>
</NameValueList>
</VariationSpecificsSet>
</Variations>

Note: This example is for the UK Clothes, Shoes & Accessories > Men's Clothing > Jeans category

API Document: ReviseFixedPriceItem.html#Request.Item.Variations.Variation.Delete

How well did this answer your question?