Add products into an assortment.

An assortment defines which products a particular store is allowed to sell and/or to purchase.

To retrieve a list of assortments, see getAssortments. To edit an assortment or add a new one, see saveAssortment. To manipulate with the products associated with an assortment, see API calls getAssortmentProducts, editAssortmentProducts and removeAssortmentProducts. To retrieve all products that can be sold in location according to product status in assortment and it's card see getSellableProducts.

This API call is available only if "Assortments" module has been enabled on your account.

Input parameters

Parameter name Description Possible value Required
productIDs  Comma-separated list of product IDs.  String  yes  
assortmentID  Assortment ID.  Integer  yes  
status  Product status, possible statuses are 'ACTIVE', 'NO_LONGER_ORDERED', 'NOT_FOR_SALE' and 'ARCHIVED'. If you don't specify this field, products will be added to assortment with the default status 'ACTIVE'.  String   


Field name Type Description
productsAlreadyInAssortment  String  Comma-separated list of already products that already exist in this assortment. Note that the status of these items will not be changed. To change the status of items that already are in the assortment, use editAssortmentProducts.  
nonExistingIDs  String  Comma-separated list of non-existing products.  

This API call returns error code 1006 if "Assortments" module has not been enabled on your account.