read_products | Read | View product catalog to display inventory. |
write_products | Write | Two narrow uses: (1) publish app-owned metafields in the app--stockful namespace (stock status, days of supply, velocity trend, projected stockout, ABC class, restock status, sold last 30d, tracked flag); and (2) enable the admin_filterable capability on merchant-created product metafield definitions so Stockful can filter products by those metafields in tracking rules. The filterable toggle only affects the definition’s capability flag. No merchant metafield values are ever modified. We do not modify product titles, descriptions, variants, pricing, or any non-Stockful metafield values. |
read_locations | Read | List locations to show inventory by location. |
read_inventory | Read | Read inventory levels for monitoring and forecasting. |
read_orders, read_all_orders | Read | Read order and fulfillment history for sales velocity and demand forecasting. Only aggregate metrics are retained; individual customer personal data is not stored. |
read_fulfillments, read_merchant_managed_fulfillment_orders, read_third_party_fulfillment_orders | Read | Attribute stock movements correctly across fulfillment services. |
write_inventory | Write | Used only inside the health-check inventory-fix page so merchants can correct missing cost, SKU code, and barcode on inventory items in-app. Stockful never modifies inventory quantities or stock levels, only the metadata fields the merchant explicitly edits in our UI. |
read_inventory_transfers | Read | Read inventory transfers to show stock in transit and track the status of transfers created from Stockful. |
write_inventory_transfers | Write | Two uses, both started by an explicit merchant action: (1) acting on a transfer suggestion creates a draft transfer (tagged stockful) that the merchant completes in Shopify; (2) marking a purchase order as shipped creates the supplier-inbound transfer for that order as ready to ship (tagged stockful-po). Stockful only touches transfers it created. |
read_inventory_shipments | Read | Read inventory shipments to keep incoming-stock figures accurate as shipments move and arrive. |
write_inventory_shipments | Write | Create and update the shipment behind a purchase order when the merchant marks that order as shipped - adding the ordered items and saving the tracking details they enter in Stockful. Only shipments Stockful created for a purchase order are modified. |
read_inventory_shipments_received_items | Read | Read received-item quantities on shipments so incoming stock clears correctly when shipments are received, including partial receipts. |
write_inventory_shipments_received_items | Write | Record received quantities against a purchase order’s shipment when the merchant receives stock in Stockful, including partial receipts, so Shopify inventory and incoming-stock figures stay in sync. |
read_publications, read_product_listings | Read | Read which sales channels and catalogs a product is published to, so products can be filtered by sales channel, market, or catalog. |
read_markets | Read | Read the store’s markets to label region and B2B catalog filters. Only used if the store has Markets configured. |
read_companies | Read | Read B2B company locations to label company-location catalog filters. Only used if the store sells B2B. |
read_reports | Read | Run Shopify’s analytics queries (ShopifyQL) to import historical sales and inventory-movement aggregates, so sales velocity and stockout history can be backfilled beyond the order data available at install. Only aggregate per-product metrics are read; individual customer personal data is never queried or stored. |
write_app_proxy | Write | Required by Shopify to register the App Proxy endpoint used by storefront features. Does not modify any store data. |
