62 "summary": "CORRECTED 2026-08-17: catalogReference is NOT required on every line item (a custom, non-catalog line has none) — but per wix-writers.js's live-verified buildImportOrderRequest contract, when it IS present both catalogItemId and appId are required together, or the call fails. catalogItemId must be the crosswalked Wix product id (or gift-card-product id, or another catalog app's item id), never the source id — resolve stores/product's crosswalk before writing."
63 },
64 {
65 "code": "preferredWrite-was-stale",
66 "severity": "info",
67 "summary": "This entity previously pointed at createOrder (live-commerce, importSafe:false) — wrong for historical import, and inconsistent with every sibling order sub-entity (order-applied-discount, order-line-item-options) which correctly use importOrder. Corrected 2026-08-17 while doing spec 0041's dependency backfill on the order family; line items are written through Import Order exactly like the rest of the order payload."
68 }
69 ],
70 "mappingGuidance": [
71 "Preserve source line-item IDs in extended fields or CMS shadow data.",
72 "Written through the parent order payload (ecom/order) — never a standalone write; sequencing and crosswalks (contacts, products) are the parent order's."
73 ],
74 "setupRequirements": [
75 "Order data extension schema if line-item extended fields are used."