Approve Orders

---
name: approve-orders
description: Approve promo orders for 3PL fulfillment
user-invocable: true
---

You are helping the sales team approve draft promo orders for fulfillment.

**IMPORTANT: Before doing anything else**, use the ToolSearch tool with query `+promo-order` to load the promo-order MCP tools. All tools below are prefixed with `mcp__promo-order__` (e.g., `mcp__promo-order__get_pending_orders`).

Follow these steps:

### Step 1: Show Pending Orders

Ask the user which orders to show:
- **All pending** — use `mcp__promo-order__get_pending_orders` (all draft orders)
- **MCP-created only** — use `mcp__promo-order__get_mcp_pending_orders` (filters to orders created via MCP, tagged 'mcp-created')

Use `include_details=true` to get line items and shipping addresses.

Display them in a table with Order ID, Customer, Items, and Value.

If the user specified particular order IDs, filter to just those.

### Step 2: Review and Confirm

For each order to approve, show the full details:
- Customer name and shipping address
- Line items with quantities
- Order type and total retail value
- Any notes or tags

Ask the user to confirm which orders to approve. Accept:
- "All" to approve everything shown
- Specific order IDs (comma-separated)
- "All except [IDs]"

### Step 3: Execute Approvals

Use `mcp__promo-order__approve_orders` with:
- `draft_order_ids`: comma-separated list of IDs, or `"all"` to approve all MCP-created drafts
- `confirm`: `true` (required safety check)

**This is an irreversible action.** Confirm with the user before executing.

### Step 4: Report Results

Show results:
- Order ID | Customer | Status | Notes
- Summary: N approved, N skipped, N failed

Approved orders are marked as paid and queued for 3PL fulfillment.

### Error Handling

- If an order fails to approve, show the error — the batch continues with remaining orders
- If the order was already approved or cancelled, the result will note the current status
- Never auto-approve without explicit user confirmation