shopify-admin-bulk-fulfillment-creation

Purpose

Queries all open fulfillment orders for a location and batch-creates fulfillments with tracking numbers in a single workflow. No third-party app required — this skill handles the fulfillment creation layer; carrier label generation requires a separate tool or carrier integration.

Prerequisites

• Authenticated Shopify CLI session: shopify store auth --store <domain> --scopes read_orders,write_fulfillments
• API scopes: read_orders, write_fulfillments

Parameters

Parameter	Type	Required	Default	Description
store	string	yes	—	Store domain (e.g., mystore.myshopify.com)
location_id	string	yes	—	GID of the fulfillment location (e.g., gid://shopify/Location/123)
tracking_numbers	array	no	[]	List of {fulfillment_order_id, tracking_number, tracking_url, carrier} objects
notify_customer	bool	no	true	Send shipping confirmation email to customer
dry_run	bool	no	true	Preview fulfillments without executing mutations
format	string	no	human	Output format: human or json

Safety

⚠️ fulfillmentCreate is irreversible — fulfilled orders cannot be unfulfilled via the API. Run with dry_run: true first to confirm the list of fulfillment orders before committing. Each mutation creates one fulfillment record per fulfillment order.

Workflow Steps

1. OPERATION: fulfillmentOrders — query Inputs: assignedLocationId: <location_id>, status: OPEN, first: 250, pagination cursor Expected output: List of open fulfillment orders with id, order { name }, lineItems; paginate until hasNextPage: false

2. OPERATION: fulfillmentCreate — mutation Inputs: For each fulfillment order: fulfillmentOrderId, trackingInfo { company, number, url }, notifyCustomer Expected output: fulfillment { id, status, trackingInfo }, userErrors

GraphQL Operations

# fulfillmentOrders:query — validated against api_version 2025-01
query OpenFulfillmentOrders($locationId: ID!, $after: String) {
  fulfillmentOrders(
    assignedLocationId: $locationId
    first: 250
    after: $after
    query: "status:open"
  ) {
    edges {
      node {
        id
        status
        order {
          id
          name
        }
        lineItems(first: 10) {
          edges {
            node {
              id
              remainingQuantity
              variant {
                sku
                title
              }
            }
          }
        }
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}