Updating An Order

Adjustments are common practice when processing customer orders. Availability, discounts, and tax corrections are a few reasons as to why adjustments occur.

In the event of a DRAFT, respond with an HTTP status code of 200 and the Order object in the body after all adjustments have been made.

Based on the Order object in the response, Weedmaps presents the following to the customer/patient:

  • Discounts, Totals, and Taxes will be displayed to reflect the values in the response.
  • Line Items removed will be removed from the order displayed. (Deprecated 10-6-21 and will no longer be supported on 2-1-22: For Draft responses, set item quantity to zero so that changes are communicated to the customer. For Created Orders when changes result in zero line items, we advise canceling the order. )
  • Line Items marked with a quantity of zero will be identified as "unavailable" and require the customer/patient to remove these items before the order can be submitted.

After the order has been finalized and submitted for fulfillment in the POS system, updates to the order must conform to the Order object structure and then be transmitted to the below HTTP endpoint.

https://api-g.weedmaps.com/oos/integrators/v2/merchants/:merchantId/orders/:orderId
  • :merchantId is the WMID associated with the POS retailer's location.
  • :orderId is the target order's reference identifier.
Components of the Order That Can Be Modified by the POS System
  • lineItems
  • Totals
  • discounts
  • shippingAddress
Components of the Order That Cannot Be Modified by the POS System
  • Customer/Patient Information
  • Seller Information
  • source
  • orderId
  • Weedmaps Service Fee
  • documents
  • customerNote
  • requestedSchedulingInfo
  • payments

📘

The Weedmaps Service Fee is enabled by default in the retail client's Weedmaps account. When enabled, the Weedmaps Service Fee is shared with the integrated POS platform in the Draft event.

Status Updates

When a customer/patient places an order on Weedmaps, they are provided status updates about their order via text message.

Though order status updates aren't required, they enhance the customer experience, and help build confidence and trust with the retailer. Weedmaps encourages retailers to keep its customers informed with order status updates.

Additionally, Weedmaps promotes retailers that go the extra mile to provide customers/patients with great customer service by awarding them with a Best of Weedmaps badge. Providing accurate order statuses helps retailers receive added visibility on Weedmaps.

Available Statuses for Orders
  • DRAFT
  • PENDING
  • IN_PROGRESS
  • READY_FOR_ATTAINMENT
  • COMPLETE
  • CANCELED_CUSTOMER
  • CANCELED_SELLER
  • FAILED

Below is a partial screenshot of a retailer page on Weedmaps with a "Best of Weedmaps" distinction.

532532