sinfactura-types 1.10.458 → 1.10.459

package/dist/ai.d.ts

@@ -75,17 +75,23 @@ declare global {
          * The supplier's own product code for this line, as printed, trimmed.
          * Absent when the line prints none — never `''`.
          *
-         * A JOIN KEY that survives a misread `description`: match the line to a
-         * purchase-order line on `barcode`, then `sku`, then name. Additive — a
-         * line extracted before this field existed simply lacks it.
+         * A JOIN KEY that survives a misread `description`: it joins a
+         * purchase-order line's `PurchaseOrderItem.supplierSku` (the same
+         * supplier namespace), NEVER `PurchaseOrderItem.sku`, which copies the
+         * store's `Product.sku` — a coincidental match across the two namespaces
+         * pairs the wrong product. Additive — a line extracted before this field
+         * existed simply lacks it.
          */
         sku?: string;
         /**
          * The printed barcode (EAN/UPC), reduced to its DIGITS — spaces, dashes
          * and any other character are removed server-side. Absent when the line
          * prints none, or nothing numeric survives — never `''`. Its length is
-         * NOT validated as an EAN/UPC here: it is a join key, and a misread value
-         * simply fails to match, so fall back to `sku`, then name.
+         * NOT validated as an EAN/UPC here: it is a join key — matched against the
+         * PO line's PRODUCT barcodes through `productId`, since a
+         * `PurchaseOrderItem` carries none — and a misread value simply fails to
+         * match, so fall back to `sku` (against
+         * `PurchaseOrderItem.supplierSku`), then name.
          */
         barcode?: string;
         /**

package/dist/purchaseOrder.d.ts

@@ -109,7 +109,20 @@ declare global {
         productId: string;
         /** Name DENORMALIZED at write time; the order records what was ordered, under the name it had then. */
         name: string;
+        /** The STORE's code for this product — a copy of `Product.sku`, in the store's own namespace. */
         sku?: string;
+        /**
+         * The SUPPLIER's own article code for this line — the supplier's namespace,
+         * distinct from `sku`, which copies the store's `Product.sku`. It is the
+         * join key for a supplier document's line (`SupplierDocExtractItem.sku`);
+         * joining that to `sku` instead compares two namespaces, and a coincidental
+         * match pairs the wrong product.
+         *
+         * Client-supplied on create and draft edit. Trimmed; absent when blank —
+         * never `''`. Additive: an order written before this field existed simply
+         * lacks it.
+         */
+        supplierSku?: string;
         /** Units ordered. */
         quantity: number;
         /**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "sinfactura-types",
-	"version": "1.10.458",
+	"version": "1.10.459",
 	"description": "Shared wire and entity contracts for the SINFACTURA platform.",
 	"type": "module",
 	"main": "dist/index.js",