Applying Sales Pricing

Background

User research and recent user trends collected by Weedmaps have indicated that the predominant deciding factor in purchasing decisions is the price of an item.

This likely comes as no surprise to you. Under the guise of COVID-19, the current market conditions we are experiencing from the economic downturn further solidifies price sensitivity as a critical deciding factor for cannabis customers and MMJ patients.

As of October 2020, Weedmaps is implementing a new feature to accommodate budget-conscious consumers: Sale Pricing. This functionality allows retailers on Weedmaps to mark products as being on sale. On-sale products are indicated with an adjusted price (appearing as a discounted price in red-colored font) next to the original price (displayed with a strike-through).

Managing Sales Prices

We wanted the implementation of this feature to be as straightforward as possible. When you add a sale price to a menu item, you place it — and any of its associated variants — on sale. Due to the increasing demand for lower prices, adding this functionality to your POS should only entice more Listings to want to integrate with you.

Creating/Updating the Sales Price of a Product

When either creating or updating a product with a sales price, you must pass one more attribute — sale_percentage — in your request object. Changing the sales price works in the same way: You are required to pass the sale_percentage attribute in your request object with the product's updated sales price. If you never pass a sale_percentage attribute in your requests, the pricing will continue as it always has and won't be affected.

curl --globoff \
  --request POST \
  --url 'https://api-g.weedmaps.com/catalog/v1/catalogs/CATALOG_ID/sales?scope_by[organization_id]=ORGANIZATION_ID' \
  --header 'accept: application/vnd.api+json' \
  --header 'authorization: Bearer [ACCESS TOKEN HERE]' \
  --header 'content-type: application/vnd.api+json' \
  --data '{
    "data": {
      "type": "products",
      "id": CATALOG_ID,
      "data": {
        "attributes": {
          "product_id": PRODUCT_ID,
          "sale_percentage": 15
        }
      }
    }
  }'

🚧

All Associated Catalog Items Are Affected by Sales Pricing

Don't forget that all catalog items associated to the product are affected by adding a sales price. As you can see from the image above, all the weight breakpoints for "Pineapple Express" are shown with strike-throughs: You cannot add a sales price to an individual catalog item.

Deleting the Sales Price of a Product

In order to remove a sales price from a product, you need only pass the number zero "0" as the sale_percentage attribute in your update request.

curl --globoff \
  --request POST \
  --url 'https://api-g.weedmaps.com/catalog/v1/catalogs/CATALOG_ID/sales?scope_by[organization_id]=ORGANIZATION_ID' \
  --header 'accept: application/vnd.api+json' \
  --header 'authorization: Bearer [ACCESS TOKEN HERE]' \
  --header 'content-type: application/vnd.api+json' \
  --data '{
    "data": {
      "type": "products",
      "id": CATALOG_ID,
      "data": {
        "attributes": {
          "product_id": PRODUCT_ID,
          "sale_percentage": 0
        }
      }
    }
  }'