Inventory Item

1{
2  "schemaVersion": 1,
3  "domain": "stores",
4  "entity": "inventory-item",
5  "displayName": "Stores Inventory Item",
6  "capability": "commerce.inventory",
7  "target": {
8    "classification": "native",
9    "nativeEntity": "Stores Inventory Item",
10    "verifiedFqdn": null,
11    "idPolicy": "server-assigned",
12    "crosswalkRequired": true
13  },
14  "sourceAliases": [
15    {
16      "sourceSystem": "woocommerce",
17      "sourceEntity": "product_variation_inventory",
18      "routes": [
19        "/wc/v3/products",
20        "/wc/v3/products/{productId}/variations"
21      ],
22      "confidence": "medium"
23    },
24    {
25      "sourceSystem": "wix",
26      "sourceEntity": "inventoryItem",
27      "routes": [
28        "Stores Inventory APIs"
29      ],
30      "confidence": "high"
31    }
32  ],
33  "preferredWrite": {
34    "surface": "Stores Inventory V3",
35    "endpoint": "POST /stores/v3/inventory-items",
36    "writerId": "createInventoryItem",
37    "verification": "unverified",
38    "importSafe": true,
39    "bulk": false
40  },
41  "fallbacks": [
42    {
43      "classification": "cms",
44      "when": "Use for source stock history or multi-location detail not represented by the selected target inventory plan."
45    }
46  ],
47  "reliability": {
48    "status": "partially-reliable",
49    "flags": []
50  },
51  "pitfalls": [
52    {
53      "code": "product-first",
54      "severity": "blocker",
55      "summary": "Inventory requires target product and variant IDs."
56    },
57    {
58      "code": "bis-side-effects",
59      "severity": "warning",
60      "summary": "Avoid stock transitions that trigger Back in Stock notifications on live stores."
61    }
62  ],
63  "mappingGuidance": [
64    "Create products first, then create or update inventory per variant."
65  ],
66  "setupRequirements": [
67    "SCOPE.STORES.INVENTORY_ITEM_WRITE"
68  ],
69  "evidence": [
70    {
71      "type": "wix-docs",
72      "url": "https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/inventory-items-v3/inventory-item-object",
73      "note": "object page (docs-survey sweep 2026-08-11)"
74    }
75    
76  ]
77}