Shopify Ecommerce Ops

---
id: shopify-ecommerce-ops
name: Shopify E-commerce Ops
description: Orders, products, sales reports
role: sales
requiredTools:
  - type: mcpService
    serviceType: shopify
---

## Shopify E-commerce Ops

When working with Shopify orders and products:

- Use **shopify_get_order** (tool name may have a suffix if multiple Shopify servers exist) to find an order by ID or number (e.g. #1001).
- Use **shopify_search_products** to search products by title for inventory and pricing; inventory lives on variants (inventory_quantity).
- Use **shopify_sales_report** to summarize order counts and gross sales by date range.
- Summarize results clearly; cite order IDs or date ranges when relevant.
- Shopify uses offline access tokens so data can be queried in the background.

## Step-by-step instructions

1. For "order #1001" or "order by ID": call **shopify_get_order** with the order ID or number.
2. For "products matching X" or inventory/pricing: call **shopify_search_products** with the search query; report title, variants, inventory_quantity, and pricing from the response.
3. For "sales last week" or revenue summary: call **shopify_sales_report** with the date range; report order counts and gross sales.
4. When summarizing orders: include status, total, and key line items if relevant; for products, include variant inventory when the user asks about stock.
5. If the user asks for a date range, use it for **shopify_sales_report**; otherwise infer (e.g. last 7 days) or ask.

## Examples of inputs and outputs

- **Input**: "What's in order #1001?"  
  **Output**: Order status, total, and line items (product, quantity, price) from **shopify_get_order**.

- **Input**: "Sales summary for last month."  
  **Output**: Order count and gross sales from **shopify_sales_report** for that date range; cite the range.

- **Input**: "Do we have stock for product X?"  
  **Output**: Product and variant info including inventory_quantity from **shopify_search_products**; summarize stock status.

## Common edge cases

- **Order not found**: Say "Order [id/number] not found" and suggest checking the ID or number format.
- **No products found**: Say "No products matching [query]" and suggest a different search term.
- **Date range for sales**: **shopify_sales_report** needs a date range; infer from "last week/month" or ask.
- **API/OAuth error**: Report that Shopify returned an error and suggest reconnecting or retrying.

## Tool usage for specific purposes

- **shopify_get_order**: Use to look up an order by ID or number (e.g. #1001); returns order details and line items.
- **shopify_search_products**: Use to search products by title; use for inventory (variants.inventory_quantity) and pricing.
- **shopify_sales_report**: Use for order counts and gross sales over a date range; always specify the range.