Treez Catalog Service
The Catalog APIs exposes the functionality of the Treez Catalog service. Treez Catalog provides a comprehensive per-organization product catalog that enables a single point of management that spans across all stores in an organization. Products and SKUs for all stores within an organization are managed in the catalog.
When an organization uses Treez catalog, all Create and Update operations for products and SKUs must be done through the Catalog API. The dispensary-level Product API is still active for read-only operations against the products in a given dispensary.
Production: https://api-prod.treez.io/service/catalog/{{version}}/
Build: https://api-dev.treez.io/service/catalog/{{version}}/
Product & SKU relationships
There are several layers of related IDs that connect parent products, SKUs, and dispensary products. See below for a visual example.
- Catalog Product ID is the ID of the main parent product record in Catalog. Variants (SKUs) are linked as children to this main product record.
- Variant/SKU ID is the unique id assigned to a product variant, which is linked to a parent product. SKU-to-parent is a many-to-one relationship; Multiple SKUs can be created for a single parent product. One common example is creating variants by size, e.g. 3.5g, 7g, 14g.
- Dispensary Product ID is the identifier for a product when using the dispensary-level Product API. The
product_idin a dispensary will match the variant/SKU id in the catalog, and will be the same across all stores in an organization. This provides consistency when executing lookup operations at the dispensary level.
Supported Operations
- When Catalog is enabled, all Create and Update operations for parent products and SKUs must be done using the Catalog API. Changes made in catalog are pushed out to individual dispensaries, so the changes must originate centrally.
- The dispensary-level Product API is read-only, and provides valuable information about pricing, inventory, and discounts at the dispensary level. This data will vary across dispensaries in a multi-store environment, so having direct access to lookup at the dispensary level is critical.
