@wix/agent-skills 1.5.0 → 1.7.0

package/skills/wix-manage/references/ecommerce/api-shipping.md

@@ -0,0 +1,443 @@
+---
+name: "API: Shipping Delivery"
+description: REST API reference for Shipping Options and Delivery Profiles. Covers CRUD operations, region/carrier management, and query patterns for both services. Internal reference — these APIs are not yet published in public docs.
+layer: config
+---
+# API: Shipping Delivery
+
+Two services govern the shipping configuration of a Wix eCommerce store:
+
+- **Delivery Profiles** — define geographic regions and which carriers serve each region. Each site has a default profile. Regions contain destinations (countries/subdivisions) and carriers.
+- **Shipping Options** — define the rate entries customers see at checkout (flat, tiered, free). Each option is scoped to one or more delivery regions.
+
+**Base URL**: `https://www.wixapis.com/ecom`
+
+**How to call these APIs**: Use `CallWixSiteAPI`.
+
+---
+
+## Shipping Options
+
+### Query Shipping Options
+
+Retrieves all shipping options for the site. Up to 1,000 per request (cursor paging).
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/shipping-options/query`
+
+**Request**:
+```json
+{
+  "query": {
+    "cursorPaging": { "limit": 100 }
+  }
+}
+```
+
+**Filterable fields**: `id`, `delivery_region_id`, `delivery_region_ids`, `estimated_delivery_time`, `created_date`, `updated_date`
+
+**Response**:
+```json
+{
+  "shippingOptions": [
+    {
+      "id": "abc123",
+      "revision": "1",
+      "deliveryRegionId": "region-guid",
+      "deliveryRegionIds": ["region-guid"],
+      "title": "Standard Shipping",
+      "category": "STANDARD",
+      "estimatedDeliveryTime": "3-5 business days",
+      "rates": [
+        {
+          "id": "rate-guid",
+          "title": "Standard Shipping",
+          "amount": "5.99",
+          "multiplyByQuantity": false,
+          "active": true,
+          "conditions": []
+        }
+      ]
+    }
+  ],
+  "pagingMetadata": { "count": 1, "hasNext": false }
+}
+```
+
+---
+
+### Create Shipping Option
+
+Creates a new shipping option and associates it with one or more delivery regions.
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/shipping-options`
+
+**Required fields**: `shippingOption.deliveryRegionId` (or `deliveryRegionIds`), `shippingOption.title`, `shippingOption.rates[]`
+
+**Request**:
+```json
+{
+  "shippingOption": {
+    "deliveryRegionId": "region-guid",
+    "title": "Free Shipping Over $75",
+    "category": "FREE",
+    "estimatedDeliveryTime": "5-7 business days",
+    "rates": [
+      {
+        "title": "Free Shipping",
+        "amount": "0",
+        "multiplyByQuantity": false,
+        "active": true,
+        "conditions": [
+          {
+            "type": "BY_TOTAL_PRICE",
+            "operator": "GTE",
+            "value": "75"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+**Response**: `{ "shippingOption": { ... } }` — the created option with `id` and `revision`.
+
+**Error**: `INVALID_QUANTITY_VALUE` (400) — condition value cannot be fractional.
+
+---
+
+### Get Shipping Option
+
+Retrieves a single shipping option by ID.
+
+**Endpoint**: `GET https://www.wixapis.com/ecom/v1/shipping-options/{shippingOptionId}`
+
+**Response**: `{ "shippingOption": { ... } }`
+
+---
+
+### Update Shipping Option
+
+Updates a shipping option. Requires `id` and the current `revision`. Each update increments `revision`.
+
+**Endpoint**: `PATCH https://www.wixapis.com/ecom/v1/shipping-options/{shippingOption.id}`
+
+**Required fields**: `shippingOption.id`, `shippingOption.revision`
+
+**Request**:
+```json
+{
+  "shippingOption": {
+    "id": "abc123",
+    "revision": "1",
+    "rates": [
+      {
+        "id": "rate-guid",
+        "title": "Free Shipping",
+        "amount": "0",
+        "multiplyByQuantity": false,
+        "active": true,
+        "conditions": [
+          {
+            "type": "BY_TOTAL_PRICE",
+            "operator": "GTE",
+            "value": "85"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+**Response**: `{ "shippingOption": { ... } }` with updated `revision`.
+
+---
+
+### Delete Shipping Option
+
+Permanently deletes a shipping option.
+
+**Endpoint**: `DELETE https://www.wixapis.com/ecom/v1/shipping-options/{shippingOptionId}`
+
+---
+
+### Add Delivery Region (to Shipping Option)
+
+Associates an additional delivery region with an existing shipping option.
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/shipping-options/{shippingOptionId}/add-delivery-region`
+
+**Required fields**: `deliveryRegionId`, `revision`
+
+**Request**:
+```json
+{
+  "deliveryRegionId": "region-guid",
+  "revision": "2"
+}
+```
+
+---
+
+### Remove Delivery Region (from Shipping Option)
+
+Removes a delivery region association from a shipping option.
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/shipping-options/{shippingOptionId}/remove-delivery-region`
+
+**Required fields**: `deliveryRegionId`, `revision`
+
+---
+
+## Rate Configuration
+
+Rate types are determined by the `conditions` array, not an explicit field:
+
+| Rate Type | `amount` | `conditions` |
+|-----------|---------|-------------|
+| Flat rate | any | empty `[]` |
+| Free shipping | `"0"` | optional `BY_TOTAL_PRICE GTE <threshold>` |
+| Price-based tiers | any | one or more `BY_TOTAL_PRICE` conditions |
+| Weight-based tiers | any | `BY_TOTAL_WEIGHT` conditions |
+| Quantity-based | any | `BY_TOTAL_QUANTITY` conditions |
+
+**Condition operators**: `EQ`, `GT`, `GTE`, `LT`, `LTE`
+
+Multiple conditions in one rate combine with AND logic.
+
+**`multiplyByQuantity: true`** charges `amount × cart quantity`. Flag this configuration — it penalizes large orders and should be replaced with flat or tiered pricing.
+
+---
+
+## Delivery Profiles
+
+### Query Delivery Profiles
+
+Retrieves all delivery profiles for the site. Typically one default profile exists.
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/delivery-profiles/query`
+
+**Request**: `{}`
+
+**Response**:
+```json
+{
+  "deliveryProfiles": [
+    {
+      "id": "profile-guid",
+      "revision": "3",
+      "name": "General profile",
+      "default": true,
+      "deliveryRegions": [
+        {
+          "id": "region-guid",
+          "name": "United States",
+          "active": true,
+          "destinations": [
+            { "countryCode": "US", "subdivisions": [] }
+          ],
+          "deliveryCarriers": [
+            {
+              "appId": "45c44b27-ca7b-4891-8c0d-1747d588b835",
+              "backupRate": {
+                "title": "Standard Shipping",
+                "amount": "5.99",
+                "active": true
+              },
+              "additionalCharges": []
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}
+```
+
+---
+
+### Get Delivery Profile
+
+Retrieves a single delivery profile by ID.
+
+**Endpoint**: `GET https://www.wixapis.com/ecom/v1/delivery-profiles/{deliveryProfileId}`
+
+**Response**: `{ "deliveryProfile": { ... } }`
+
+---
+
+### Get Delivery Profile by Region
+
+Retrieves the profile that contains a given delivery region.
+
+**Endpoint**: `GET https://www.wixapis.com/ecom/v1/delivery-profiles/delivery-regions/{deliveryRegionId}`
+
+---
+
+### Create Delivery Profile
+
+Creates a new delivery profile (rarely needed — most sites use the default profile).
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/delivery-profiles`
+
+---
+
+### Update Delivery Profile
+
+Updates profile-level fields (name, etc.). Requires current `revision`.
+
+**Endpoint**: `PATCH https://www.wixapis.com/ecom/v1/delivery-profiles/{deliveryProfile.id}`
+
+---
+
+### Add Delivery Region
+
+Adds a geographic region to a delivery profile. Returns the updated profile with the new region's `id`.
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/delivery-profiles/{deliveryProfileId}/delivery-region`
+
+**Required fields**: `deliveryRegion.name`, `deliveryRegion.destinations[]`, `revision`
+
+**Request**:
+```json
+{
+  "deliveryRegion": {
+    "name": "United States",
+    "active": true,
+    "destinations": [
+      { "countryCode": "US" }
+    ]
+  },
+  "revision": "3"
+}
+```
+
+**Response**: `{ "deliveryProfile": { ... } }` — full updated profile with new region `id`.
+
+**Error**: `DESTINATIONS_COLLISION` — country already assigned to another region in this profile. Use the existing region instead.
+
+---
+
+### Update Delivery Region
+
+Updates name, active status, or destinations of an existing region.
+
+**Endpoint**: `PATCH https://www.wixapis.com/ecom/v1/delivery-profiles/{deliveryProfileId}/delivery-region/{deliveryRegion.id}`
+
+---
+
+### Remove Delivery Region
+
+Removes a delivery region from a profile.
+
+**Endpoint**: `DELETE https://www.wixapis.com/ecom/v1/delivery-profiles/{deliveryProfileId}/delivery-region/{deliveryRegionId}`
+
+---
+
+### List Installed Delivery Carriers
+
+Returns all carriers installed on the site (both built-in and third-party apps). Use this to find the `id` of a specific carrier (e.g., Pickup, Basic Shipping) before calling Add Delivery Carrier.
+
+**Endpoint**: `GET https://www.wixapis.com/ecom/v1/delivery-profiles/installed-carriers`
+
+**Response**:
+```json
+{
+  "installedDeliveryCarriers": [
+    {
+      "id": "50d8c12f-715e-41ad-be25-d0f61375dbee",
+      "displayName": "Pickup",
+      "fallbackDefinitionMandatory": false,
+      "toggleGetCarrierSettingsEnabled": true
+    },
+    {
+      "id": "45c44b27-ca7b-4891-8c0d-1747d588b835",
+      "displayName": "Basic Shipping",
+      "description": "Manage shipping rates and options for this region",
+      "fallbackDefinitionMandatory": false,
+      "toggleGetCarrierSettingsEnabled": true
+    }
+  ]
+}
+```
+
+---
+
+### List Delivery Carriers (in a Profile)
+
+Lists the carriers configured within a specific delivery profile.
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/delivery-profiles/{deliveryProfileId}/delivery-carriers`
+
+---
+
+### Add Delivery Carrier
+
+Adds a carrier to a delivery region within a profile. The carrier appears as a shipping option to customers in that region.
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/delivery-profiles/add-delivery-carrier`
+
+**Request**:
+```json
+{
+  "deliveryRegionId": "region-guid",
+  "deliveryCarrier": {
+    "appId": "50d8c12f-715e-41ad-be25-d0f61375dbee",
+    "backupRate": {
+      "title": "Pickup at 123 Main St",
+      "amount": "0",
+      "active": true
+    }
+  }
+}
+```
+
+**Response**: `{ "deliveryProfile": { ... } }` — full updated profile.
+
+**Errors**:
+| Error | Cause |
+|-------|-------|
+| `CARRIER_ALREADY_EXISTS_IN_REGION` | Carrier already in this region |
+| `DELIVERY_CARRIER_MISSING_BACKUP_RATE` | `backupRate` or `backupRate.amount` missing |
+
+---
+
+### Remove Delivery Carrier
+
+Removes a carrier from a delivery region.
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/delivery-profiles/remove-delivery-carrier`
+
+**Request**:
+```json
+{
+  "deliveryRegionId": "region-guid",
+  "appId": "carrier-app-id"
+}
+```
+
+---
+
+### Update Delivery Carrier
+
+Updates `backupRate` or `additionalCharges` for a carrier in a region.
+
+**Endpoint**: `PATCH https://www.wixapis.com/ecom/v1/delivery-profiles/update-delivery-carrier`
+
+---
+
+### Set Delivery Carrier Active Status
+
+Activates or deactivates a carrier in a delivery region.
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/delivery-profiles/delivery-carriers/set-active-status`
+
+---
+
+## Known Carrier IDs
+
+| Carrier | App ID |
+|---------|--------|
+| Basic Shipping | `45c44b27-ca7b-4891-8c0d-1747d588b835` |
+| Pickup | `50d8c12f-715e-41ad-be25-d0f61375dbee` |

package/skills/wix-manage/references/ecommerce/flow-add-free-shipping.md

@@ -27,10 +27,10 @@ Adds a free shipping option with an optimal threshold calibrated against the sit
 
 ## Required APIs
 
-- [Query Shipping Options](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/shipping-options/query-shipping-options)
-- [Create Shipping Option](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/shipping-options/create-shipping-option)
-- [Update Shipping Option](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/shipping-options/update-shipping-option)
-- [Query Delivery Profiles](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/delivery-profiles/query-delivery-profiles)
+- [Query Shipping Options](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#query-shipping-options)
+- [Create Shipping Option](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#create-shipping-option)
+- [Update Shipping Option](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#update-shipping-option)
+- [Query Delivery Profiles](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#query-delivery-profiles)
 
 ---
 
@@ -263,5 +263,4 @@ Report to the merchant:
 
 ## References
 
-- [Delivery Profiles API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/delivery-profiles/introduction)
-- [Shipping Options API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/shipping-options/introduction)
+- [API: Shipping Delivery](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping)

package/skills/wix-manage/references/ecommerce/flow-fix-coverage-gaps.md

@@ -26,9 +26,9 @@ Detects delivery regions where customers cannot see any shipping options at chec
 
 ## Required APIs
 
-- [Query Delivery Profiles](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/delivery-profiles/query-delivery-profiles)
-- [Query Shipping Options](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/shipping-options/query-shipping-options)
-- [Create Shipping Option](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/shipping-options/create-shipping-option)
+- [Query Delivery Profiles](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#query-delivery-profiles)
+- [Query Shipping Options](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#query-shipping-options)
+- [Create Shipping Option](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#create-shipping-option)
 
 ---
 
@@ -296,5 +296,4 @@ Use the same request from Step 2 and verify the count now covers all active, non
 
 ## References
 
-- [Delivery Profiles API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/delivery-profiles/introduction)
-- [Shipping Options API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/shipping-options/introduction)
+- [API: Shipping Delivery](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping)

package/skills/wix-manage/references/ecommerce/flow-optimize-shipping-rates.md

@@ -27,9 +27,9 @@ Analyzes the site's catalog price distribution and current shipping rate structu
 
 ## Required APIs
 
-- [Query Shipping Options](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/shipping-options/query-shipping-options)
-- [Update Shipping Option](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/shipping-options/update-shipping-option)
-- [Create Shipping Option](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/shipping-options/create-shipping-option)
+- [Query Shipping Options](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#query-shipping-options)
+- [Update Shipping Option](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#update-shipping-option)
+- [Create Shipping Option](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#create-shipping-option)
 
 ---
 
@@ -360,5 +360,4 @@ Verify:
 
 ## References
 
-- [Shipping Options API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/shipping-options/introduction)
-- [Delivery Profiles API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/delivery-profiles/introduction)
+- [API: Shipping Delivery](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping)

package/skills/wix-manage/references/ecommerce/goal-increase-aov.md

@@ -25,7 +25,7 @@ references:
 > - [Flow: Upsell Boost](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/flow-upsell-boost)
 > - [Flow: Bundle and Save](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/flow-bundle-and-save)
 >
-> **Shipping flows that also serve AOV goals** (read with `ReadFullDocsArticle` if shipping domain is active):
+> **Shipping flows that also serve AOV goals** (load if shipping domain is active):
 > - [Flow: Add Free Shipping](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/flow-add-free-shipping) — free shipping threshold pushes carts above AOV
 > - [Flow: Optimize Shipping Rates](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/flow-optimize-shipping-rates) — rate optimization improves conversion on higher-value orders
 >

package/skills/wix-manage/references/ecommerce/goal-reduce-cart-abandonment.md

@@ -15,11 +15,10 @@ references:
 ---
 # Goal: Reduce Cart Abandonment
 
-> **Related skills** (read with `ReadFullDocsArticle` if needed):
+> **Related skills**:
 > - [Flow: Fix Coverage Gaps](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/flow-fix-coverage-gaps) — shipping coverage gaps block checkout entirely
 > - [Recipe: Apply Shipping Recommendations](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/recipe-apply-shipping-recommendations)
 > - [Setup Store Pickup Location](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/setup-store-pickup-location)
-> - [Setup Store Pickup Location](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/setup-store-pickup-location)
 
 Reduce checkout abandonment caused by shipping friction — coverage gaps, unexpected costs, and missing free shipping options — by optimizing the delivery step of the checkout funnel.
 

package/skills/wix-manage/references/ecommerce/guardrail-shipping-health.md

@@ -9,8 +9,8 @@ references:
 ---
 # Guardrail: Shipping Health
 
-> **Related skills** (read with `ReadFullDocsArticle` if needed):
-> - [Troubleshoot: Checkout Delivery Drop-off](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/troubleshoot-checkout-delivery-drop-off)
+> **Related skills**:
+> - [Troubleshoot: Checkout Delivery Drop-off](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/troubleshoot-checkout-delivery-dropoff)
 
 ## When to use
 

package/skills/wix-manage/references/ecommerce/recipe-apply-shipping-recommendations.md

@@ -11,14 +11,14 @@ description: Applies AI-generated shipping recommendations to a Wix e-commerce s
 
 ## Required APIs
 
-- [Query Delivery Profiles](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/delivery-profiles/query-delivery-profiles)
-- [Get Delivery Profile](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/delivery-profiles/get-delivery-profile)
+- [Query Delivery Profiles](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#query-delivery-profiles)
+- [Get Delivery Profile](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#get-delivery-profile)
 
 ---
 
 ## Step 1: Query the current shipping configuration
 
-Call [Query Delivery Profiles](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/delivery-profiles/query-delivery-profiles) to understand the site's delivery setup — profiles, regions, carriers, and backup rates.
+Call [Query Delivery Profiles](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#query-delivery-profiles) to understand the site's delivery setup — profiles, regions, carriers, and backup rates.
 
 **Endpoint**: `POST https://www.wixapis.com/ecom/v1/delivery-profiles/query`
 
@@ -295,5 +295,4 @@ After applying recommendations, query shipping options again (Step 2) to confirm
 
 ## References
 
-- [Delivery Profiles API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/delivery-profiles/introduction)
-- [Shipping Options API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/shipping-options/introduction)
+- [API: Shipping Delivery](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping)

package/skills/wix-manage/references/ecommerce/recommend-ecommerce-strategy.md

@@ -106,9 +106,9 @@ CallWixSiteAPI(
     "fields": [
       "language",
       "merchant_business_country",
-      "success_last_30_days_industry",
-      "success_last_30_days_sub_industry",
-      "success_last_30_days_distinct_visitors",
+      "suggested_main_industry",
+      "suggested_sub_industry",
+      "last_30_days_distinct_visitors",
       "last_30_days_orders_count",
       "online_gpv_last_30_days",
       "payment_currency"
@@ -123,9 +123,9 @@ CallWixSiteAPI(
 |---|---|---|---|
 | `language` | STRING | Wix site language code | Locale-aware recommendations |
 | `merchant_business_country` | STRING | Merchant's business country (ISO alpha-2) | Holiday detection, region analysis, shipping |
-| `success_last_30_days_industry` | STRING | Dominant industry in last 30 days (user growth model) | Domain classification, goal selection |
-| `success_last_30_days_sub_industry` | STRING | Dominant sub-industry in last 30 days | Domain classification |
-| `success_last_30_days_distinct_visitors` | LONG | Distinct visitors in last 30 days (incl. app sessions) | Traffic-based thresholds |
+| `suggested_main_industry` | STRING | Dominant industry in last 30 days (user growth model) | Domain classification, goal selection |
+| `suggested_sub_industry` | STRING | Dominant sub-industry in last 30 days | Domain classification |
+| `last_30_days_distinct_visitors` | LONG | Distinct visitors in last 30 days (incl. app sessions) | Traffic-based thresholds |
 | `last_30_days_orders_count` | LONG | Order count in last 30 days | AOV calculation, goal selection |
 | `online_gpv_last_30_days` | LONG | Online Gross Payment Volume in last 30 days (site currency units) | Revenue analysis, AOV calculation |
 | `payment_currency` | STRING | Store payment currency code (ISO-4217) | Discount/shipping amount formatting |
@@ -153,7 +153,7 @@ Extracting values:
 
 **Currency rule:** All monetary values (`online_gpv_last_30_days`, `aov`, discount thresholds, shipping amounts) are in the site's `payment_currency`. Never assume USD. Always display and compute amounts using `payment_currency`.
 
-**STOP if `merchant_business_country`, `success_last_30_days_industry`, or `online_gpv_last_30_days` are missing or null.** Report: "Cannot generate recommendations — missing required site data: {fields}."
+**STOP if `merchant_business_country`, `suggested_main_industry`, or `online_gpv_last_30_days` are missing or null.** Report: "Cannot generate recommendations — missing required site data: {fields}."
 
 ---