Products

This section covers all the endpoints for working with products.

IDs and SKUs

Product SKUs and Variant SKUs are the unique identifiers for products and variants generated by the merchant himself.

  • Each Product SKU must be unique among all merchant’s Product SKUs.

  • Each Variant SKU must be unique among all merchant’s Variant SKUs.

  • A Product SKU may coincide with a Variant SKU.

Example: if there is just one variant in a product, you may want to give them similar SKUs.

Joom Product IDs and Joom Variant IDs are the unique identifiers of products and variants generated by Joom. (They are shown to you just for information.)

All the actions with products and variants can be performed by using SKUs only. But you may prefer to use Joom IDs, it’s up to you.

Please note:

Joom Store IDs are also important.

You must specify a Joom Store ID when creating a new product.

Product States

Each product exists in two versions: current version reflecting the most recent changes (a kind of a draft) and approved (published) version. Only the published version may be visible to customers.

The field hasActiveVersion reflects whether the product has a version that is currently available to customers. The field state reflects the state of the current version.

State Meaning
active This version of the product is approved and active (available to customers).
warning This version of the product is active, but may require merchant’s attention.
pending This version of the product is not active, it is awaiting verification from Joom. No action from the merchant is required. An older approved version might be active.
rejected This version of the product is not active. The merchant is expected to fix the problems. An older approved version might be active.
disabledByJoom The product is completely disabled by Joom and is not available to customers. This happens when the product’s store is disabled by Joom.
disabledByMerchant The product is completely disabled by the merchant and is not available to customers. This also happens when the product’s store is disabled by the merchant.
locked All changes to the product will be postponed until it is unlocked. This happens when the product participates in a promotion. An older approved version might be active.
archived The product is removed. Normally, removed products are not visible to merchants, but due to technical delays they may still appear in the API, so you’re advised to support this state. Products in this state may be ignored as non-existing.

Overview of Endpoints

In basic scenarios using this API documentation merchants are able to:


Learn more details on Product Requirements and Category Product Requirements in Joom Help Center.