Order Tracking

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

Checkout      -> status: PENDING,   payment_status: UNPAID,         fulfillment_status: PENDING
Payment       -> status: CONFIRMED, payment_status: PAID,           fulfillment_status: PENDING
Store accepts -> status: CONFIRMED, payment_status: PAID,           fulfillment_status: IN_PROGRESS
Preparation   -> status: CONFIRMED, payment_status: PAID,           fulfillment_status: PREPARING
Ready         -> status: CONFIRMED, payment_status: PAID,           fulfillment_status: READY_FOR_PICKUP
Picked up     -> status: COMPLETED, payment_status: PAID,           fulfillment_status: FULFILLED

import requests

BASE_URL = "https://sandbox.api.tote.ai/v1/online-ordering"
headers = {"Authorization": "Bearer YOUR_ACCESS_TOKEN"}
order_id = "f9a8b7c6-d5e4-3210-fedc-ba9876543210"

response = requests.get(
    f"{BASE_URL}/orders/{order_id}",
    headers=headers,
)
order = response.json()

print(f"Status:      {order['status']}")
print(f"Payment:     {order['payment_status']}")
print(f"Fulfillment: {order['fulfillment_status']}")
print(f"Total:       ${order['total']['amount'] / 100:.2f}")
print(f"Paid:        ${order['total_paid']['amount'] / 100:.2f}")
print(f"Balance due: ${order['balance_due']['amount'] / 100:.2f}")

{
  "id": "f9a8b7c6-d5e4-3210-fedc-ba9876543210",
  "cart_id": "c1d2e3f4-a5b6-7890-cdef-1234567890ab",
  "location_id": "b5a7c8d9-e0f1-4a2b-8c3d-4e5f6a7b8c9d",
  "status": "CONFIRMED",
  "payment_status": "PAID",
  "fulfillment_status": "PREPARING",
  "items": [
    {
      "id": "d4e5f6a7-b8c9-0123-4567-890abcdef012",
      "name": "Build Your Own Sub Sandwich",
      "quantity": 1,
      "item_total": { "amount": 1399, "currency": "USD" }
    },
    {
      "id": "e7f8a9b0-c1d2-3456-7890-abcdef123456",
      "name": "Bottled Water",
      "quantity": 2,
      "item_total": { "amount": 398, "currency": "USD" }
    }
  ],
  "payments": [
    {
      "id": "a1b2c3d4-0001-4000-8000-000000000001",
      "status": "COMPLETED",
      "payment_method": "CREDIT_CARD",
      "amount": { "amount": 1945, "currency": "USD" }
    }
  ],
  "handoff": {
    "mode": "CURBSIDE",
    "vehicle_make": "Toyota",
    "vehicle_model": "Camry",
    "vehicle_color": "Silver"
  },
  "subtotal": { "amount": 1797, "currency": "USD" },
  "total_tax": { "amount": 148, "currency": "USD" },
  "total_discount": { "amount": 0, "currency": "USD" },
  "total": { "amount": 1945, "currency": "USD" },
  "total_paid": { "amount": 1945, "currency": "USD" },
  "balance_due": { "amount": 0, "currency": "USD" },
  "created_at": "2026-01-31T10:07:00Z",
  "updated_at": "2026-01-31T10:09:00Z"
}

response = requests.get(
    f"{BASE_URL}/orders",
    headers=headers,
    params={
        "location_id": "b5a7c8d9-e0f1-4a2b-8c3d-4e5f6a7b8c9d",
        "limit": 20
    },
)
data = response.json()
orders = data["data"]
pagination = data["pagination"]

for order in orders:
    print(f"{order['id']} | {order['status']} | {order['fulfillment_status']} | ${order['total']['amount'] / 100:.2f}")

response = requests.get(
    f"{BASE_URL}/orders",
    headers=headers,
    params={
        "status": "CONFIRMED",
        "fulfillment_status": "READY_FOR_PICKUP",
        "location_id": "b5a7c8d9-e0f1-4a2b-8c3d-4e5f6a7b8c9d"
    },
)
ready_orders = response.json()["data"]
print(f"{len(ready_orders)} orders ready for pickup")

from datetime import datetime, timezone

today_start = datetime.now(timezone.utc).replace(
    hour=0, minute=0, second=0, microsecond=0
).isoformat()

response = requests.get(
    f"{BASE_URL}/orders",
    headers=headers,
    params={
        "date_from": today_start,
        "location_id": "b5a7c8d9-e0f1-4a2b-8c3d-4e5f6a7b8c9d"
    },
)
todays_orders = response.json()["data"]

{
  "data": [ ... ],
  "pagination": {
    "has_more": true,
    "next_cursor": "eyJpZCI6ImIyYzNkNGU1LWY2YTctODkwMS1iY2RlLWYxMjM0NTY3ODkwMiJ9"
  }
}

def fetch_all_orders(headers, params):
    """Fetch all orders with automatic pagination."""
    all_orders = []
    cursor = None

    while True:
        if cursor:
            params["cursor"] = cursor

        response = requests.get(
            f"{BASE_URL}/orders",
            headers=headers,
            params=params,
        )
        data = response.json()
        all_orders.extend(data["data"])

        if not data["pagination"]["has_more"]:
            break

        cursor = data["pagination"]["next_cursor"]

    return all_orders


# Fetch all confirmed orders at a location
all_confirmed = fetch_all_orders(headers, {
    "status": "CONFIRMED",
    "location_id": "b5a7c8d9-e0f1-4a2b-8c3d-4e5f6a7b8c9d",
    "limit": 50
})
print(f"Total confirmed orders: {len(all_confirmed)}")

import time

def poll_order_status(order_id, headers, target_status, max_attempts=30):
    """
    Poll an order until it reaches the target fulfillment status.

    Uses exponential backoff starting at 2 seconds, capping at 30 seconds.
    """
    base_delay = 2
    max_delay = 30

    for attempt in range(max_attempts):
        response = requests.get(
            f"{BASE_URL}/orders/{order_id}",
            headers=headers,
        )
        order = response.json()
        current = order["fulfillment_status"]

        print(f"[Attempt {attempt + 1}] Fulfillment: {current}")

        if current == target_status:
            return order

        if current == "CANCELLED":
            raise Exception("Order was cancelled")

        # Exponential backoff: 2s, 4s, 8s, 16s, 30s, 30s, ...
        delay = min(base_delay * (2 ** attempt), max_delay)
        time.sleep(delay)

    raise TimeoutError(f"Order did not reach {target_status} after {max_attempts} attempts")


# Wait for order to be ready for pickup
order = poll_order_status(
    "f9a8b7c6-d5e4-3210-fedc-ba9876543210",
    headers,
    target_status="READY_FOR_PICKUP",
)
print(f"Order is ready! Status: {order['fulfillment_status']}")

order_id = "f9a8b7c6-d5e4-3210-fedc-ba9876543210"

cancel_response = requests.post(
    f"{BASE_URL}/orders/{order_id}/cancel",
    headers={**headers, "Idempotency-Key": str(uuid4())},
    json={"reason": "Customer changed their mind"},
)

{
  "id": "f9a8b7c6-d5e4-3210-fedc-ba9876543210",
  "status": "CANCELLED",
  "payment_status": "UNPAID",
  "fulfillment_status": "CANCELLED",
  "total_paid": { "amount": 0, "currency": "USD" },
  "balance_due": { "amount": 1945, "currency": "USD" }
}

from uuid import uuid4

cancel_response = requests.post(
    f"{BASE_URL}/orders/{order_id}/cancel",
    headers={**headers, "Idempotency-Key": str(uuid4())},
    json={"reason": "Customer changed their mind"},
)

if cancel_response.status_code == 409:
    error = cancel_response.json()["error"]
    print(f"Cannot cancel: {error['message']}")
    print("The order is already being prepared.")
    print("Contact the store directly to request cancellation.")
elif cancel_response.status_code == 200:
    print("Order cancelled successfully.")
    cancelled_order = cancel_response.json()
    print(f"Status: {cancelled_order['status']}")

1. Customer builds cart
   Cart: ACTIVE

2. Customer checks out
   Cart: CHECKED_OUT
   Order: status=PENDING, payment_status=UNPAID, fulfillment_status=PENDING

3. Customer submits payment
   Order: status=CONFIRMED, payment_status=PAID, fulfillment_status=PENDING

4. Store accepts order
   Order: status=CONFIRMED, payment_status=PAID, fulfillment_status=IN_PROGRESS

5. Store starts preparation
   Order: status=CONFIRMED, payment_status=PAID, fulfillment_status=PREPARING

6. Order is ready
   Order: status=CONFIRMED, payment_status=PAID, fulfillment_status=READY_FOR_PICKUP

7. Customer picks up order
   Order: status=COMPLETED, payment_status=PAID, fulfillment_status=FULFILLED