Catalog identifiersIdentify your products from within Catalog
Get familiar with Catalog's product identifiers so you can easily create and reference your products. Zonos Catalog offers the flexibility to use SKU and product ID, either individually or in combination, as your product identifier.
The identifier is the combination of the SKU and product ID, even if only one field is populated. Leaving a field blank still creates a unique identifier (see below for an example of this). Additionally, note that product IDs and SKUs are case-insensitive.
After creating a product with a SKU and/or a product ID, you cannot edit these fields as they serve as the identifier that you and Zonos use to reference your product. If you need to modify either field, you must delete the product and create it again.
To ensure effective referencing of Catalog items, we have a decision tree that takes into account various scenarios and provides guidelines for accurate retrieval. Understanding the logic behind referencing products is crucial to ensure accurate referencing, so it's important to familiarize yourself with this decision tree in order to seamlessly reference products:
Combination of Product ID and SKU: We'll first reference the combination of the
skuexactly, which serve as the primary identifier combo for catalog items. Note that if one field is
null, you can just reference the field with a value. For example, if your
null, you can just reference your
Prioritizing SKU: If we don't find a Catalog item on the
skucombo, then we'll search for a match on
productId, giving preference to the
sku. If a matching
skuis found, it will be used.
Fallback to product ID: If no
skumatch is found or if multiple occurrences of the same
skuexist, we will then favor the
Multiple instances of the same product ID: In cases where multiple instances of the same
productIdexist, we will not return a catalog item to avoid potential confusion or ambiguity.
If an item isn't found in Zonos Catalog, we will reference your ecommerce platform's product information. If you don't use one of our plugins or if you don't have all the necessary product information, we'll reference your Zonos default information.