Setting the file. One moment.
Product · Rp Target Wix · wix/skills · Skills Docs
Back to the top of the page (opens in a new tab)
domains/stores/entities/ product.json
JSON · 90 lines · 4 KB
,
10 "idPolicy" : "server-assigned" ,
11 "crosswalkRequired" : true
12 },
13 "sourceAliases" : [
14 { "sourceSystem" : "woocommerce" , "sourceEntity" : "product" , "routes" : [ "/wc/v3/products" ], "confidence" : "high" },
15 { "sourceSystem" : "wix" , "sourceEntity" : "storesProduct" , "routes" : [ "Stores Catalog V1 Products" , "Stores Catalog V3 Products" ], "confidence" : "high" }
16 ],
17 "preferredWrite" : {
18 "surface" : "Stores Catalog V3 Products" ,
19 "endpoint" : "POST /stores/v3/products" ,
20 "writerId" : "createStoresProduct" ,
21 "verification" : "verified-live" ,
22 "importSafe" : true ,
23 "bulk" : false
24 },
25 "fieldContracts" : [
26 {
27 "domain" : "stores" ,
28 "entity" : "product" ,
29 "surface" : "catalog-v3" ,
30 "operation" : "createProduct" ,
31 "path" : "product.subscriptionDetails" ,
32 "verificationLevel" : "live-create-and-readback" ,
33 "lastVerified" : "2026-07-26" ,
34 "verifiedBy" : "migration-20260726-01" ,
35 "requiredPaths" : [
36 "product.subscriptionDetails.allowOneTimePurchases" ,
37 "product.subscriptionDetails.subscriptions[]" ,
38 "product.subscriptionDetails.subscriptions[].title" ,
39 "product.subscriptionDetails.subscriptions[].description" ,
40 "product.subscriptionDetails.subscriptions[].frequency" ,
41 "product.subscriptionDetails.subscriptions[].interval" ,
42 "product.subscriptionDetails.subscriptions[].autoRenewal"
43 ],
44 "constraints" : [
45 {
46 "path" : "product.subscriptionDetails.subscriptions[].description" ,
47 "maxLength" : 60 ,
48 "source" : "live-validation"
49 },
50 {
51 "path" : "product.subscriptionDetails.subscriptions[].frequency" ,
52 "enum" : [ "DAY" , "WEEK" , "MONTH" , "YEAR" ],
53 "source" : "live-create"
54 },
55 {
56 "path" : "product.subscriptionDetails.subscriptions[].interval" ,
57 "minimum" : 1 ,
58 "integer" : true ,
59 "source" : "live-create"
60 }
61 ],
62 "readback" : {
63 "product.subscriptionDetails" : "returned-after-create" ,
64 "product.subscriptionDetails.subscriptions[].id" : "server-assigned" ,
65 "product.subscriptionDetails.subscriptions[].title" : "preserved" ,
66 "product.subscriptionDetails.subscriptions[].description" : "preserved" ,
67 "product.subscriptionDetails.subscriptions[].frequency" : "preserved" ,
68 "product.subscriptionDetails.subscriptions[].interval" : "preserved" ,
69 "product.subscriptionDetails.subscriptions[].autoRenewal" : "preserved"
70 }
71 }
72 ],
73 "fallbacks" : [
74 { "classification" : "cms" , "when" : "Use for plugin rules, source-only metadata, or catalog semantics that do not fit product extended fields." }
75 ],
76 "reliability" : { "status" : "partially-reliable" , "flags" : [] },
77 "pitfalls" : [
78 { "code" : "catalog-v3-normalization" , "severity" : "blocker" , "summary" : "Normalize V1/simple product fields into Catalog V3 product and variant shapes before create." },
79 { "code" : "variant-matrix-two-pass" , "severity" : "warning" , "summary" : "Full variable product matrices require a post-create option-choice and variant pass." }
80 ],
81 "mappingGuidance" : [
82 "Create categories, tags, and media references before products when the source uses them." ,
83 "Preserve recurring offers natively via product.subscriptionDetails.subscriptions[] when the source exposes clear cadence data; live create coverage was verified on July 26, 2026, while patch/update coverage remains unverified."
84 ],
85 "setupRequirements" : [ "Wix Stores app" , "Product data extension schema when source-only product fields are preserved natively." ],
86 "evidence" : [
87 { "type" : "repo-research" , "path" : "research/import-api-suitability/stores-catalog-inventory.md" },
88 { "type" : "repo-research" , "path" : "research/source-entity-import-suitability-wordpress-woocommerce-wix.md" }
89 ]
90 }