Updating an Order
WIP - With Team
Adjustments are a standard part of order processing, commonly used to address:
- Product availability
- Discounts or promotions
- Tax recalculations
Handling Draft Orders
For orders in a DRAFT state:
- Respond with HTTP 200 OK and the Order object in the response body after all adjustments have been made.
What Happens After Your Response
- Discounts, totals, and taxes will reflect the values provided in your response and are updated in the Weedmaps UI.
- Line items with a quantity of zero will be flagged as “unavailable”, requiring the customer to remove these items before checkout.
Finalized Orders
Once an order is finalized and submitted for fulfillment, subsequent updates (e.g., status changes) should:
- Follow the Order object structure.
- Be transmitted via the following endpoint: PATCH Update an Order.
Note on Service Fees:
When active, the Weedmaps Service Fee is included in the Draft event payload and should be reflected in your order response. This setting is managed within the retailer’s Weedmaps account.
Status Updates
Providing real-time order status updates via the Orders API is not required but is highly encouraged:
- Customers receive text message updates through Weedmaps (learn more).
- Regular updates enhance customer trust and reduce inbound support inquiries.
- Retailers maintaining accurate status updates may earn the Best of Weedmaps badge, improving their visibility in Weedmaps search results.
Available Order Statuses
Status | Description |
---|---|
DRAFT | Order pending adjustments before checkout. |
PENDING | Order placed, pending retailer review. |
IN_PROGRESS | Order accepted and in preparation. |
READY_FOR_ATTAINMENT | Order ready for pickup or delivery dispatch. |
COMPLETE | Order successfully fulfilled. |
CANCELED_CUSTOMER | Order canceled by the customer. |
CANCELED_SELLER | Order canceled by the retailer. |
FAILED | Order failed to process. |
Updated 16 days ago