Creating and managing inventory item groups

An inventory item group is a group of related products, that will usually only differ by one or two aspects, such as color and size, for an item such as shirt. So, the seller will place each variation of a product into an inventory item group. Note that an inventory item record must exist for a product in order for that product to belong to an inventory item group. The rest of this section will go into more details about putting together an inventory item group and then converting this inventory item group into a multiple-variation eBay listing.

An inventory item group is initially created and updated with the createOrReplaceInventoryItemGroup call. The seller must name the inventory item group through the inventoryItemGroupKey field. Once the inventoryItemGroupKey value is set, it cannot be changed. If the seller is using the createOrReplaceInventoryItemGroup call to update an existing inventory item group, they must make sure that the inventoryItemGroupKey value is accurate, otherwise, they'll either be updating the wrong inventory item group or creating a new inventory item group. When using the createOrReplaceInventoryItemGroup call to update an existing inventory item group, all fields must be passed in, even if the values of those fields did not change. This includes all SKU values for inventory items in the group. For any SKU values that are omitted, the inventory items associated with those missing SKUs will be removed from the inventory item group.

The following information is required when creating or updating an inventory item group:

  • A seller-defined inventoryItemGroupKey value for the inventory item group. This value must be unique within that seller's inventory;
  • The inventory items (defined by their SKU value) that will become members of the inventory item group. These SKU values are passed in under the variantSKUs container;
  • Title and description of the inventory item group. Note that the title and description values will become the listing title and listing description of the live, multiple-variation eBay listing, and the product.title and product.description values that are given for the inventory items that are part of that inventory item group must have the same values. Those values must be the same, as those inventory items will ultimately be listed in the same multiple-variation listing;
  • Links to product images. At least one link to a product image must be included under the imageUrls container;
  • Variation aspects. The variesBy container is used to specify the aspects where each variation of the product varies. A variesBy.specifications node is required for each product aspect where the variations differ. The product aspect is identified through the specifications.name field, and each variation of that particular aspect is identified through multiple specifications.values fields. In the variesBy.aspectsImageVariesBy container, at least one of the defined product aspects must be identified to indicate how the image(s) of each product variation varies.

The following information is optional when creating an inventory item group:

  • Product aspects that each item within the group share. For example, common product aspects of shirts in a multiple-variation listing might be Pattern (e.g. Solid) and Sleeve Length (e.g. Short). Any values specified here will become Item Specifics in the eBay listing;
  • Subtitle of the inventory item group. Note that the subtitle value will become the listing subtitle of the live, multiple-variation eBay listing, and the product.subtitle value that is given for the inventory items that are part of that inventory item group must have the same value. Those values must be the same, as those inventory items will ultimately be listed in the same multiple-variation listing.

Once all members of an inventory item group are ready to be published, the publishOfferByInventoryItemGroup call can be used to publish a multiple-variation eBay listing with these inventory items. For the publishOfferByInventoryItemGroup call to be successful, all offers associated with the inventory items in the group must be valid. If one of those offers is not valid, the publishOfferByInventoryItemGroup call will fail.

The getInventoryItemGroup call should be used to retrieve all of the details of a specific inventory item group. The inventoryItemGroupKey value is passed in at the end of getInventoryItemGroup call URI.

The deleteInventoryItemGroup call is used to delete a specific inventory item group. The inventoryItemGroupKey value is passed in at the end of deleteInventoryItemGroup call URI.