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 a 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 sales 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 Menu Item

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

curl --globoff \
  --request PATCH \
  --url 'https://api-g.weedmaps.com/wm/v1/menu_items/89761327' \
  --header 'accept: application/json' \
  --header 'authorization: Bearer [ACCESS TOKEN HERE]' \
  --header 'content-type: application/json' \
  --data '{
    "type": "menu_item",
    "id": 89761327,
    "data": {
      "attributes": {
        "sale": {
          "type": "percentage",
          "amount": 15
        }
      }
    }
  }'

🚧

All Variants Are Affected by Sales Pricing

Don't forget that all variants within a 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 variant/weight.

📘

Percentages Only

As of October 2020, this feature only supports percentage-based sales with an integer amount. The current format of this request, however, is designed to allow us to expand this offering in the future without breaking changes.

Deleting the Sales Price of a Menu Item

In order to remove a sales price from a menu item, you need only pass an empty sale attribute in your update request.

curl \
  --request PATCH \
  --url 'https://api-g.weedmaps.com/wm/v1/menu_items/89761327' \
  --header 'accept: application/json' \
  --header 'authorization: Bearer [ACCESS TOKEN HERE]' \
  --header 'content-type: application/json' \
  --data '{
    "type": "menu_item",
    "id": 89761327,
    "data": {
      "attributes": {
        "sale": null
      }
    }
  }'