Skip to main content
PUT
{orders_api_base_url}
/
orders
/
accept
/
{
  "success": true,
  "message": "<string>",
  "order_id": "<string>",
  "status": "<string>",
  "estimated_ready_time": "<string>",
  "fulfillment_id": "<string>"
}
This endpoint allows stores to formally accept incoming orders from delivery platforms like DoorDash, UberEats, and Grub Hub. Accepting an order initiates the fulfillment workflow and notifies the delivery platform that the order is being processed.
Once an order is accepted, it cannot be rejected through normal processes. Use the cancel order endpoint if you need to cancel after acceptance.

​
Request Body

​
store_id
string
required
The unique identifier of the store accepting the order
​
order_id
string
required
The unique identifier of the order to accept
​
estimated_ready_time
string
Estimated time when the order will be ready for pickup/delivery (ISO 8601 format)
​
special_notes
string
Additional notes about the order preparation or any special considerations

​
Response

​
success
boolean
Indicates whether the order was successfully accepted
​
message
string
Confirmation message or error details
​
order_id
string
The accepted order’s unique identifier
​
status
string
New order status after acceptance (typically “accepted” or “in_progress”)
​
estimated_ready_time
string
Confirmed estimated ready time (if provided)
​
fulfillment_id
string
Unique identifier for the fulfillment tracking record created

​
Request Example

{
  "store_id": "449235c1-3d04-4519-998b-40d2a621e5e0",
  "order_id": "35d18f08-6d54-421d-9476-8cef629111bc",
  "estimated_ready_time": "2024-01-15T14:30:00Z",
  "special_notes": "Extra care required for fragile items"
}

​
Response Example

{
  "success": true,
  "message": "Order successfully accepted and fulfillment initiated",
  "order_id": "35d18f08-6d54-421d-9476-8cef629111bc",
  "status": "accepted",
  "estimated_ready_time": "2024-01-15T14:30:00Z",
  "fulfillment_id": "f60a1ebf-c9fd-4c5a-b25f-db5f59e03851"
}
When an order is accepted, the following happens automatically:
  1. Status Update: Order status changes from “pending” to “accepted”
  2. Platform Notification: The delivery platform (DoorDash, UberEats, etc.) is notified
  3. Fulfillment Creation: A new fulfillment record is created for tracking
  4. Timer Start: Preparation timer begins for performance metrics
  5. Inventory Hold: Items are reserved in inventory (if applicable)
  6. Staff Notification: Kitchen/preparation staff are notified of new order
Time Sensitive: Orders typically have acceptance windows (usually 10-15 minutes). Failing to accept within this window may result in automatic cancellation by the delivery platform.
Best Practice: Always provide realistic estimated_ready_time values. Accurate timing improves customer satisfaction and delivery platform ratings.
If you don’t provide an estimated_ready_time, the system will calculate one based on your store’s historical preparation times and current order volume.

​
Error Responses

Order Already Processed
{
  "success": false,
  "message": "Order has already been accepted or is no longer available",
  "error_code": "ORDER_ALREADY_PROCESSED"
}
Invalid Store
{
  "success": false,
  "message": "Store not authorized to accept this order",
  "error_code": "UNAUTHORIZED_STORE"
}
Acceptance Window Expired
{
  "success": false,
  "message": "Order acceptance window has expired",
  "error_code": "ACCEPTANCE_EXPIRED"
}
⌘I