The Range - Deactivate Product

The purpose of this page is to describe in details how deactivation products in The Range marketplace works.

If we send 0 stock to a product it will remain unpurchaseable, but The Range recommend to deactivate the product from the marketplace. Basically, to deactivate a product we should use the API for create/update product and the major difference is we need to include into the payload the value active:1. The deactivation on The Range means the product will be still visible but not saleable on the website though.

TBD: Is it enough to send the SKU and Active:1 or we must send the complete payload?

Product status - Product Published; Listing Status - Active ; End Item = Pending

After successful update we will have:

Product status -Product Published ; Listing Status - Inactive; End Item = Not Needed

If error:

Product status - Product Published; Listing Status - Active ; End Item = Error **and the error will be stored into End Item Еrror field.

API Call: https://supplier.rstore.com/rest/product_feed.api?supplier_id=12345

API Docs: https://marketplacetherange.zendesk.com/hc/en-gb/articles/360018370397-API-Product-Feed

Example Call:

{

"product_arr" : [{

"vendor_sku" : "ABC 123",
"related_product" : "M1234567", # Optional - Kube will generate its own unique product code if
not provided
"title" : "Test Shoe",
"brand" : "The Range",

''gtin'' : ''12345678901'' , #Optional
"price_arr": [{

"price" : "49.50", # No currency symbol expected
"currency" : "GBP", # Not supporting other currencies at the moment
"effective_from" : "2019-05-10" # May be the current active price - can also provide
future price changes
}],

"product_category" : "Shoes",
"description" : "A Shoe Test", # We allow for HTML to be captured here - excluding script/embed
/iframe tags
"feature_arr" : [ # May be empty - not to be confused with attributes, certain Amazon fields such as TargetAudience and SubjectContent belong here
"Includes Sole",
"Prevents falling over",
"Waterproof"
],

"child_hazard" : 0, # Optional whether this product is hazardous to children
"age_restriction" : "16", # Optional minimum age
"image_url_arr" : [ # All media to be linked to this SKU
"https://www.therange.co.uk/example1.jpg",
"https://www.therange.co.uk/example2.jpg",
"https://www.therange.co.uk/example3.jpg"
],
"youtube_url_arr" : [ # All video media to be linked to this SKU
"https://www.youtube.com/watch?v=Zhr1uk_O-so",
"https://www.youtube.com/watch?v=Zhr1uk_O-so"
],
51
"fulfilment_class" : "Small", # May be one of our supported size classes (Small/Regular/Fragile
/Medium/Large/Extra Large), only required if not using Free Delivery
"product_attribute" : { # All attributes listed below are optional, only colour becomes
mandatory if colour_name is present
"colour" : "#8B4513", # Only required if colour is a distinct attribute of the SKU - we
should be able to map the HEX to our colour group.
"colour_name" : "Saddle Brown", # Optional descriptive name of the colour
"colour_group" : "Brown", # Optional Colour group the primary colour belongs to eg. Red
/Blue/Yellow/Orange etc.
"length" : "1m",
"width" : "5mm",
"height" : "10cm",
"weight" : "9kg",
# Other common attributes batteries required/included, legal disclaimer, warning -
list to be finalised
"other_attribute" : { # Optional list of any other unusual attributes of interest, may
be a dynamic list of key/value pairs.
"ATTR_NAME" : "ATTR_VALUE"
}
},
"launch_date" : "2019-05-30", # Optional date when the SKU will automatically be activated
(given that it has completed the onboarding process)
"active" : 1, # Optional - only to be used once the product is already Live, allows it to be
deactivated/discontinued (still visible but not saleable on the website though), or later be re-activated
"visible" : 1 # Optional - only to be used once the product is already Live, allows it to be
hidden from the website
}]
}

All fields are the same as create product fields, except “Active“ field. Please, bear in mind the mapping for the fields can be found here: The Range - Create Product - In progress .

Example Response:

{"result":[{"label": "product_feed", "sku_list":"ABC 123"}]}

Error Cases: TBD