name: commerce-orders description: Manage order lifecycles, fulfillment, shipping, and cancellations. Use when running stateset-orders, stateset-direct orders, or updating order status.

Commerce Orders

Handle order creation, status transitions, and fulfillment updates.

How It Works

1. Fetch the order and validate current status.
2. Apply allowed status transitions.
3. Ship, cancel, or update fulfillment details.
4. Report final status and tracking info.

Usage

• CLI: stateset-orders ... or stateset-direct orders <action>
• Writes require --apply.
• MCP tools: list_orders, get_order, create_order, update_order_status, ship_order, cancel_order.

Output

{"status":"updated","order_id":"ord_123","order_status":"shipped"}

Present Results to User

• Status transition applied and any tracking numbers.
• Items or totals affected.
• Follow-up actions required (refunds, returns).

Troubleshooting

• Invalid transition: confirm the current status before updating.
• Already shipped: create a return flow instead of cancelling.

References

• references/order-status.md
• /home/dom/stateset-icommerce/cli/.claude/skills/commerce-orders/SKILL.md
• /home/dom/stateset-icommerce/examples/workflows.md