| name | shopify-core-workflow-b |
| description | Manage Shopify orders, customers, and fulfillments using the GraphQL Admin API.
Use when querying orders, processing fulfillments, managing customers,
or building order management integrations.
Trigger with phrases like "shopify orders", "shopify customers",
"shopify fulfillment", "process shopify order", "shopify checkout".
|
| allowed-tools | Read, Write, Edit, Bash(npm:*), Grep |
| version | 2.7.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","ecommerce","shopify"] |
| compatibility | Designed for Claude Code |
Shopify Orders & Customer Management
Overview
Secondary core workflow: manage orders, customers, and fulfillments. Query order data, process fulfillments, and handle customer records through the GraphQL Admin API.
Prerequisites
- Completed
shopify-install-auth setup
- Access scopes:
read_orders, write_orders, read_customers, write_customers, read_fulfillments, write_fulfillments
- Familiarity with
shopify-core-workflow-a (products)
Instructions
Step 1: Query Orders
Query orders with financial/fulfillment status filters, line items, customer data, and shipping addresses. Uses Shopify query syntax (financial_status:paid, fulfillment_status:unfulfilled, name:#1001, etc.).
See Query Orders for the complete query with pagination and query syntax examples.
Step 2: Create a Draft Order
Create draft orders with variant line items, custom line items, discounts, shipping addresses, and customer assignment.
See Draft Order Create for the complete mutation and variables.
Step 3: Process Fulfillment
Two-step process: first query fulfillment orders for an order to get line item IDs, then create the fulfillment with tracking information and customer notification.
See Fulfillment Processing for both queries and the complete workflow.
Step 4: Customer Management
Search customers by email, order count, total spent, tags, and state. Returns addresses and metafields.
See Customer Search Query for the complete query and syntax examples.
Output
- Orders queryable with financial and fulfillment status filters
- Draft orders created with line items, discounts, and shipping
- Fulfillments processed with tracking information
- Customer records searchable with spending and order filters
Error Handling
| Error | Cause | Solution |
|---|
Access denied for orders | Missing read_orders scope |
