Product APIs

🚧

NEW! Sellable_Quantity Cap

A cap will be applied to the Sellable_Quantity field in the Product API June 1, 2021. The cap has been set to 25. If it should change, Partners will be notified.

If a product has more units available for sale than the Sellable_Quantity cap, the cap value will be displayed (currently 25). The Sellable_Quantity field will show the true inventory level once the unit count drops below the cap.

📘

Page Size + GET/List of Products

When using the GET/List of Products endpoint, Treez recommends excluding the page_size as a query parameter. When page_size is excluded Treez will return the maximum amount of information possible by default. Having this set up will ensure that your integration is not making any unnecessary calls to our mutual customer's site.

The current maximum page_size for the GET/ List of Products endpoint is 100 and we are currently testing a 200 page_size with select locations.

INTRODUCTION

Using the Product API you can easily create new products in the POS system. The Product API also allows you to update the details of an existing product, search for a specific product, and download a list of all existing products.

AUTHORIZATION

In order to access the Product API, please use the client_id and API key provided to your organization to generate an access_token with the Authorization API.

LIMITATIONS

  • You can’t create an additional data field for the product.
  • You can’t set a field as required.
  • You can’t adjust the inventory for a product when you create or update a product.
  • You can’t add a product image when you create or update a product.
  • Rate limit is 5TPS per client_id
  • Each product variant(s) are a separate product and have their own unique id. This is well-matched with the product module in the POS portal.

UPLOAD A PRODUCT IMAGE VIA API

Treez allows uploading an image via API. Reference request call: https://api.treez.io/v2.0/dispensary/{dispensary_name}/product/{product_id}/image/upload

RESTRICTIONS:

  • Requires authorization.
  • Only 1 image upload at a time.
  • File size can't be bigger than 5 MB.
  • Can't submit an empty file.
  • Almost all file extensions are supported. Treez check file MIME type that begins with image/. For example, we consider image/png, image/jpg, but not ''text''/csv.
  • The document should be uploaded against valid product_id.

Page_count and total_count explained

Page_count attribute provides the count of items on the current page. In order to know how many pages are available use total_count attribute and divide by page_count.

Most pages will show the same page_count with exception of the last page if there is a remainder.

Calling a page out of range with return page_count and total_count as zero


Did this page help you?