Convert Product from Standalone to a Child SKU


When to Use

  • To change a product from a standalone product type to a child of another product.
  • Cannot update the following things with this request:
    • Attributes & attribute values - see the section on Attributes
    • Images - see the section Images
    • Quantity - see the section on Quantity
    • Labels - see the section on Labels
    • Bundles - see the section on Bundles.
  • Requires the Product ID and Parent Product ID (not the Skus - the ChannelAdvisor unique IDs representing the products).
    • Place a GET Products request and $filter=Sku eq 'PRODUCT SKU VALUE'&$select=ID to return the standalone Product ID to use in this request.
    • Place a GET Products request and $filter=Sku eq 'PARENT SKU VALUE'&$select=ID to return the Parent Product ID to use in this request.

Resource URL / Endpoint

PATCH or PUT https://api.channeladvisor.com/v1/Products(ProductID)

Important and/or Required Parameters

PropertyType (Max Length)RequiredNote
ProductIDinteger (32 bit)RequiredInclude in URL. The ChannelAdvisor defined unique ID (not the Sku value) of the product.
IsInRelationshipbooleanRequiredInclude in body. Whether or not the product is in a parent/child relationship. Parents and children will be true, standalone products will be false.
ParentProductIDinteger (32 bit)RequiredInclude in body. If the product is a child, this will contain the ChannelAdvisor Product ID of the parent product.
RelationshipNamestringRequiredInclude in body. If the product is in a relationship, this value represents the relationship type. The types are user-defined within ChannelAdvisor.
All other Product Entity fields are optional within this request type.
Example Request
PATCH or PUT https://api.channeladvisor.com/v1/Products(25030557)?access_token=xxxxxxxxxx
{
    "IsInRelationship": true,
    "ParentProductID": 25398134,
    "RelationshipName": "Color and Size"
}
Example Response (Success)
204 No Content