@open-mercato/core 0.6.8-develop.7057.1.61440fc3bc → 0.6.8-develop.7059.1.f45d1ae6a1

package/dist/modules/sales/components/documents/lineItemShipmentLock.js

@@ -0,0 +1,54 @@
+const SHIPPED_LINE_IMMUTABLE_PAYLOAD_FIELDS = [
+  "kind",
+  "productId",
+  "productVariantId",
+  "quantityUnit",
+  "unitPriceNet",
+  "unitPriceGross",
+  "priceId",
+  "priceMode",
+  "taxRateId",
+  "taxRate",
+  "taxAmount",
+  "discountAmount",
+  "discountPercent",
+  "catalogSnapshot",
+  "metadata"
+];
+function scaleTotal(total, previousQuantity, nextQuantity) {
+  if (!Number.isFinite(total) || !Number.isFinite(previousQuantity) || previousQuantity <= 0) {
+    return void 0;
+  }
+  return total * (nextQuantity / previousQuantity);
+}
+function prepareShippedLineUpdatePayload(payload, currentLine) {
+  if (!currentLine) return payload;
+  const nextPayload = { ...payload };
+  for (const field of SHIPPED_LINE_IMMUTABLE_PAYLOAD_FIELDS) {
+    delete nextPayload[field];
+  }
+  delete nextPayload.totalNetAmount;
+  delete nextPayload.totalGrossAmount;
+  const nextQuantity = Number(nextPayload.quantity);
+  if (!Number.isFinite(nextQuantity) || nextQuantity === currentLine.quantity) {
+    return nextPayload;
+  }
+  const scaledNetTotal = scaleTotal(
+    currentLine.totalNetAmount,
+    currentLine.quantity,
+    nextQuantity
+  );
+  const scaledGrossTotal = scaleTotal(
+    currentLine.totalGrossAmount,
+    currentLine.quantity,
+    nextQuantity
+  );
+  if (scaledNetTotal !== void 0) nextPayload.totalNetAmount = scaledNetTotal;
+  if (scaledGrossTotal !== void 0)
+    nextPayload.totalGrossAmount = scaledGrossTotal;
+  return nextPayload;
+}
+export {
+  prepareShippedLineUpdatePayload
+};
+//# sourceMappingURL=lineItemShipmentLock.js.map

package/dist/modules/sales/components/documents/lineItemShipmentLock.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/sales/components/documents/lineItemShipmentLock.ts"],
+  "sourcesContent": ["type ShippedLineSnapshot = {\n  quantity: number;\n  totalNetAmount?: number | null;\n  totalGrossAmount?: number | null;\n};\n\nconst SHIPPED_LINE_IMMUTABLE_PAYLOAD_FIELDS = [\n  \"kind\",\n  \"productId\",\n  \"productVariantId\",\n  \"quantityUnit\",\n  \"unitPriceNet\",\n  \"unitPriceGross\",\n  \"priceId\",\n  \"priceMode\",\n  \"taxRateId\",\n  \"taxRate\",\n  \"taxAmount\",\n  \"discountAmount\",\n  \"discountPercent\",\n  \"catalogSnapshot\",\n  \"metadata\",\n] as const;\n\nfunction scaleTotal(\n  total: number | null | undefined,\n  previousQuantity: number,\n  nextQuantity: number,\n): number | undefined {\n  if (\n    !Number.isFinite(total) ||\n    !Number.isFinite(previousQuantity) ||\n    previousQuantity <= 0\n  ) {\n    return undefined;\n  }\n  return (total as number) * (nextQuantity / previousQuantity);\n}\n\nexport function prepareShippedLineUpdatePayload(\n  payload: Record<string, unknown>,\n  currentLine: ShippedLineSnapshot | null,\n): Record<string, unknown> {\n  if (!currentLine) return payload;\n\n  const nextPayload = { ...payload };\n  for (const field of SHIPPED_LINE_IMMUTABLE_PAYLOAD_FIELDS) {\n    delete nextPayload[field];\n  }\n\n  delete nextPayload.totalNetAmount;\n  delete nextPayload.totalGrossAmount;\n\n  const nextQuantity = Number(nextPayload.quantity);\n  if (!Number.isFinite(nextQuantity) || nextQuantity === currentLine.quantity) {\n    return nextPayload;\n  }\n\n  const scaledNetTotal = scaleTotal(\n    currentLine.totalNetAmount,\n    currentLine.quantity,\n    nextQuantity,\n  );\n  const scaledGrossTotal = scaleTotal(\n    currentLine.totalGrossAmount,\n    currentLine.quantity,\n    nextQuantity,\n  );\n  if (scaledNetTotal !== undefined) nextPayload.totalNetAmount = scaledNetTotal;\n  if (scaledGrossTotal !== undefined)\n    nextPayload.totalGrossAmount = scaledGrossTotal;\n\n  return nextPayload;\n}\n"],
+  "mappings": "AAMA,MAAM,wCAAwC;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,SAAS,WACP,OACA,kBACA,cACoB;AACpB,MACE,CAAC,OAAO,SAAS,KAAK,KACtB,CAAC,OAAO,SAAS,gBAAgB,KACjC,oBAAoB,GACpB;AACA,WAAO;AAAA,EACT;AACA,SAAQ,SAAoB,eAAe;AAC7C;AAEO,SAAS,gCACd,SACA,aACyB;AACzB,MAAI,CAAC,YAAa,QAAO;AAEzB,QAAM,cAAc,EAAE,GAAG,QAAQ;AACjC,aAAW,SAAS,uCAAuC;AACzD,WAAO,YAAY,KAAK;AAAA,EAC1B;AAEA,SAAO,YAAY;AACnB,SAAO,YAAY;AAEnB,QAAM,eAAe,OAAO,YAAY,QAAQ;AAChD,MAAI,CAAC,OAAO,SAAS,YAAY,KAAK,iBAAiB,YAAY,UAAU;AAC3E,WAAO;AAAA,EACT;AAEA,QAAM,iBAAiB;AAAA,IACrB,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ;AAAA,EACF;AACA,QAAM,mBAAmB;AAAA,IACvB,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ;AAAA,EACF;AACA,MAAI,mBAAmB,OAAW,aAAY,iBAAiB;AAC/D,MAAI,qBAAqB;AACvB,gBAAY,mBAAmB;AAEjC,SAAO;AACT;",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/core",
-  "version": "0.6.8-develop.7057.1.61440fc3bc",
+  "version": "0.6.8-develop.7059.1.f45d1ae6a1",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -252,16 +252,16 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@open-mercato/ai-assistant": "0.6.8-develop.7057.1.61440fc3bc",
-    "@open-mercato/shared": "0.6.8-develop.7057.1.61440fc3bc",
-    "@open-mercato/ui": "0.6.8-develop.7057.1.61440fc3bc",
+    "@open-mercato/ai-assistant": "0.6.8-develop.7059.1.f45d1ae6a1",
+    "@open-mercato/shared": "0.6.8-develop.7059.1.f45d1ae6a1",
+    "@open-mercato/ui": "0.6.8-develop.7059.1.f45d1ae6a1",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@open-mercato/ai-assistant": "0.6.8-develop.7057.1.61440fc3bc",
-    "@open-mercato/shared": "0.6.8-develop.7057.1.61440fc3bc",
-    "@open-mercato/ui": "0.6.8-develop.7057.1.61440fc3bc",
+    "@open-mercato/ai-assistant": "0.6.8-develop.7059.1.f45d1ae6a1",
+    "@open-mercato/shared": "0.6.8-develop.7059.1.f45d1ae6a1",
+    "@open-mercato/ui": "0.6.8-develop.7059.1.f45d1ae6a1",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^7.0.0",
     "@testing-library/react": "^16.3.1",

package/src/modules/sales/components/documents/ItemsSection.tsx

@@ -131,6 +131,11 @@ function resolveInjectedColumnValue(
   return current;
 }
 
+const SHIPMENTS_PAGE_SIZE = 100;
+// A single order beyond this many shipment pages is pathological; stopping there
+// keeps the shipped state explicitly unresolved rather than silently partial.
+const SHIPMENTS_MAX_PAGES = 50;
+
 type SalesDocumentItemsSectionProps = {
   documentId: string;
   kind: "order" | "quote";
@@ -168,6 +173,12 @@ export function SalesDocumentItemsSection({
   const [shippedTotals, setShippedTotals] = React.useState<Map<string, number>>(
     new Map(),
   );
+  // Quotes have no shipments at all, so their shipped state is known up front.
+  // For orders it stays unknown until every shipment page has been read — an
+  // empty map from a pending or failed load must never read as "nothing shipped".
+  const [shippedTotalsResolved, setShippedTotalsResolved] = React.useState(
+    kind !== "order",
+  );
 
   const { widgets: allColumnWidgets } = useInjectionDataWidgets(
     extensionPoints.hosts.orderItemColumns.spotId,
@@ -379,22 +390,31 @@ export function SalesDocumentItemsSection({
   const loadShippedTotals = React.useCallback(async () => {
     if (kind !== "order") {
       setShippedTotals(new Map());
+      setShippedTotalsResolved(true);
       return;
     }
+    setShippedTotals(new Map());
+    setShippedTotalsResolved(false);
     try {
-      const params = new URLSearchParams({
-        page: "1",
-        pageSize: "100",
-        orderId: documentId,
-      });
-      const response = await apiCall<{
-        items?: Array<Record<string, unknown>>;
-      }>(`/api/sales/shipments?${params.toString()}`, undefined, {
-        fallback: { items: [] },
-      });
-      if (response.ok && Array.isArray(response.result?.items)) {
-        const totals = new Map<string, number>();
-        response.result.items.forEach((shipment) => {
+      const totals = new Map<string, number>();
+      let page = 1;
+      let collected = 0;
+      let complete = false;
+      while (page <= SHIPMENTS_MAX_PAGES) {
+        const params = new URLSearchParams({
+          page: String(page),
+          pageSize: String(SHIPMENTS_PAGE_SIZE),
+          orderId: documentId,
+        });
+        const response = await apiCall<{
+          items?: Array<Record<string, unknown>>;
+          total?: unknown;
+        }>(`/api/sales/shipments?${params.toString()}`, undefined, {
+          fallback: { items: [] },
+        });
+        if (!response.ok || !Array.isArray(response.result?.items)) return;
+        const shipments = response.result.items;
+        shipments.forEach((shipment) => {
           const entries = Array.isArray(shipment.items)
             ? (shipment.items as Array<Record<string, unknown>>)
             : [];
@@ -412,13 +432,22 @@ export function SalesDocumentItemsSection({
             totals.set(lineId, current + quantity);
           });
         });
-        setShippedTotals(totals);
-      } else {
-        setShippedTotals(new Map());
+        collected += shipments.length;
+        const reportedTotal = normalizeNumber(response.result?.total, Number.NaN);
+        const hasMore =
+          shipments.length >= SHIPMENTS_PAGE_SIZE &&
+          (!Number.isFinite(reportedTotal) || collected < reportedTotal);
+        if (!hasMore) {
+          complete = true;
+          break;
+        }
+        page += 1;
       }
+      if (!complete) return;
+      setShippedTotals(totals);
+      setShippedTotalsResolved(true);
     } catch (err) {
       logger.error('sales.document.shipments.load', { err });
-      setShippedTotals(new Map());
     }
   }, [documentId, kind]);
 
@@ -439,6 +468,7 @@ export function SalesDocumentItemsSection({
     if (kind !== "order") {
       shipmentsLoadedForDocument.current = null;
       setShippedTotals(new Map());
+      setShippedTotalsResolved(true);
       return;
     }
     const key = `${kind}:${documentId}`;
@@ -964,6 +994,7 @@ export function SalesDocumentItemsSection({
             ? Math.max(0, shippedTotals.get(lineForEdit.id) ?? 0)
             : 0
         }
+        shippedQuantityResolved={shippedTotalsResolved}
         onSaved={async () => {
           await loadItems();
           emitSalesDocumentTotalsRefresh({ documentId, kind });

package/src/modules/sales/components/documents/LineItemDialog.tsx

@@ -50,6 +50,7 @@ import { useT } from "@open-mercato/shared/lib/i18n/context";
 import { useOrganizationScopeDetail } from "@open-mercato/shared/lib/frontend/useOrganizationScope";
 import { formatMoney, normalizeNumber } from "./lineItemUtils";
 import type { SalesLineRecord } from "./lineItemTypes";
+import { prepareShippedLineUpdatePayload } from "./lineItemShipmentLock";
 import {
   normalizeCustomFieldSubmitValue,
   extractCustomFieldValues,
@@ -279,6 +280,13 @@ type SalesLineDialogProps = {
   tenantId: string | null;
   initialLine?: SalesLineRecord | null;
   shippedQuantity?: number;
+  /**
+   * Whether `shippedQuantity` reflects a fully resolved shipment state. Defaults
+   * to `true` so callers that genuinely know the value keep working; pass `false`
+   * while the host is still loading shipments or after the load failed, and the
+   * dialog locks pricing instead of assuming the line is unshipped.
+   */
+  shippedQuantityResolved?: boolean;
   onOpenChange: (open: boolean) => void;
   onSaved?: () => Promise<void> | void;
   onDraftSaved?: (payload: Record<string, unknown>, lineId: string | null) => Promise<void> | void;
@@ -475,6 +483,7 @@ export function LineItemDialog({
   tenantId,
   initialLine,
   shippedQuantity = 0,
+  shippedQuantityResolved = true,
   onOpenChange,
   onSaved,
   onDraftSaved,
@@ -513,6 +522,23 @@ export function LineItemDialog({
     () => (kind === "order" ? "sales/order-lines" : "sales/quote-lines"),
     [kind],
   );
+  // A line the caller has not resolved shipment state for is treated as shipped:
+  // the server rejects pricing changes on shipped lines, so guessing "unshipped"
+  // from a pending or failed shipments load hands the user an edit that cannot
+  // be saved. A brand-new line has no shipments by construction.
+  const hasExistingLine = Boolean(initialLine);
+  const shipmentStateUnknown = kind === "order" && hasExistingLine && !shippedQuantityResolved;
+  const isShippedOrderLine =
+    kind === "order" &&
+    hasExistingLine &&
+    (shipmentStateUnknown || shippedQuantity > 0);
+  // While the shipments read is unresolved the shipped quantity is unknown, so the
+  // only safe floor for a quantity edit is the quantity already stored on the line:
+  // whatever turns out to be shipped can never exceed it. Raising stays allowed,
+  // exactly as it is once the state resolves.
+  const storedQuantity = Number(initialLine?.quantity ?? 0);
+  const safeStoredQuantity = Number.isFinite(storedQuantity) ? storedQuantity : 0;
+  const quantityFloor = shipmentStateUnknown ? safeStoredQuantity : shippedQuantity;
   const documentKey = kind === "order" ? "orderId" : "quoteId";
   const customFieldEntityId =
     kind === "order" ? E.sales.sales_order_line : E.sales.sales_quote_line;
@@ -1330,12 +1356,17 @@ export function LineItemDialog({
           },
         );
       }
-      if (shippedQuantity > 0 && qtyNumber < shippedQuantity) {
-        const message = t(
-          "sales.documents.items.errorQuantityBelowShipped",
-          "You cannot lower the quantity below the {{shipped}} already shipped.",
-          { shipped: shippedQuantity },
-        );
+      if (quantityFloor > 0 && qtyNumber < quantityFloor) {
+        const message = shipmentStateUnknown
+          ? t(
+              "sales.documents.items.errorQuantityShipmentsUnknown",
+              "The quantity cannot be lowered until this order's shipments have been read. Reopen the order to try again.",
+            )
+          : t(
+              "sales.documents.items.errorQuantityBelowShipped",
+              "You cannot lower the quantity below the {{shipped}} already shipped.",
+              { shipped: shippedQuantity },
+            );
         throw createCrudFormError(message, { quantity: message });
       }
       const resolvedQuantityUnit = (() => {
@@ -1509,9 +1540,20 @@ export function LineItemDialog({
       }
       if (resolvedName) payload.name = resolvedName;
 
+      const submittedPayload = prepareShippedLineUpdatePayload(
+        payload,
+        isShippedOrderLine && initialLine
+          ? {
+              quantity: initialLine.quantity,
+              totalNetAmount: initialLine.totalNet,
+              totalGrossAmount: initialLine.totalGross,
+            }
+          : null,
+      );
+
       try {
         if (onDraftSaved) {
-          await onDraftSaved(payload, editingId);
+          await onDraftSaved(submittedPayload, editingId);
           closeDialog();
           return;
         }
@@ -1521,7 +1563,9 @@ export function LineItemDialog({
           () =>
             action(
               resourcePath,
-              editingId ? { id: editingId, ...payload } : payload,
+              editingId
+                ? { id: editingId, ...submittedPayload }
+                : submittedPayload,
               {
                 errorMessage: t(
                   "sales.documents.items.errorSave",
@@ -1552,10 +1596,15 @@ export function LineItemDialog({
       documentKey,
       documentUpdatedAt,
       editingId,
+      initialLine,
+      isShippedOrderLine,
       onDraftSaved,
       priceOptions,
       productOption,
+      quantityFloor,
       resourcePath,
+      shipmentStateUnknown,
+      shippedQuantity,
       t,
       variantOption,
       onSaved,
@@ -1613,6 +1662,7 @@ export function LineItemDialog({
                   type="button"
                   size="sm"
                   variant={mode === "catalog" ? "default" : "ghost"}
+                  disabled={isShippedOrderLine}
                   onClick={() => switchMode("catalog")}
                 >
                   {t("sales.documents.items.lineMode.catalog", "Catalog item")}
@@ -1621,6 +1671,7 @@ export function LineItemDialog({
                   type="button"
                   size="sm"
                   variant={mode === "custom" ? "default" : "ghost"}
+                  disabled={isShippedOrderLine}
                   onClick={() => switchMode("custom")}
                 >
                   {t("sales.documents.items.lineMode.custom", "Custom line")}
@@ -1801,6 +1852,7 @@ export function LineItemDialog({
                       },
                     )
                   }
+                  disabled={isShippedOrderLine}
                 />
               ),
             } satisfies CrudField,
@@ -1960,7 +2012,7 @@ export function LineItemDialog({
                         },
                       )
                     }
-                    disabled={!productId}
+                    disabled={isShippedOrderLine || !productId}
                   />
                 );
               },
@@ -1984,6 +2036,51 @@ export function LineItemDialog({
                   typeof values?.variantId === "string"
                     ? values.variantId
                     : null;
+                const selectedPriceId =
+                  typeof value === "string" ? value : null;
+                const selectedPrice = selectedPriceId
+                  ? (priceOptions.find(
+                      (entry) => entry.id === selectedPriceId,
+                    ) ?? null)
+                  : null;
+                if (isShippedOrderLine) {
+                  const lockedAmount = normalizeNumber(
+                    values?.unitPrice,
+                    Number.NaN,
+                  );
+                  const lockedCurrency =
+                    selectedPrice?.currencyCode ??
+                    (typeof values?.currencyCode === "string"
+                      ? values.currencyCode
+                      : currencyCode) ??
+                    undefined;
+                  const lockedModeLabel =
+                    values?.priceMode === "net"
+                      ? t("sales.documents.items.priceNet", "Net")
+                      : t("sales.documents.items.priceGross", "Gross");
+                  const lockedAmountLabel = Number.isFinite(lockedAmount)
+                    ? `${formatMoney(lockedAmount, lockedCurrency)} — ${lockedModeLabel}`
+                    : lockedModeLabel;
+                  const lockedPriceDetail =
+                    selectedPrice?.priceKindTitle ??
+                    selectedPrice?.priceKindCode ??
+                    null;
+                  return (
+                    <div className="space-y-2">
+                      <Input
+                        readOnly
+                        disabled
+                        value={lockedAmountLabel}
+                        aria-label={t("sales.documents.items.price", "Price")}
+                      />
+                      {lockedPriceDetail ? (
+                        <p className="text-xs text-muted-foreground">
+                          {lockedPriceDetail}
+                        </p>
+                      ) : null}
+                    </div>
+                  );
+                }
                 return (
                   <LookupSelect
                     key={
@@ -1991,7 +2088,7 @@ export function LineItemDialog({
                         ? `${productId}-${variantId ?? "no-variant"}`
                         : "price"
                     }
-                    value={typeof value === "string" ? value : null}
+                    value={selectedPriceId}
                     onChange={(next) => {
                       setValue(next ?? null);
                       const selected = next
@@ -2133,9 +2230,11 @@ export function LineItemDialog({
                   }
                   onChange={(event) => setValue(event.target.value)}
                   placeholder="0.00"
+                  disabled={isShippedOrderLine}
                 />
                 <Select
                   value={mode}
+                  disabled={isShippedOrderLine}
                   onValueChange={(value) => {
                     const nextMode = value === "net" ? "net" : "gross";
                     setFormValue?.("priceMode", nextMode);
@@ -2222,7 +2321,7 @@ export function LineItemDialog({
               <Select
                 value={resolvedValue || undefined}
                 onValueChange={(value) => handleChange({ target: { value } } as React.ChangeEvent<HTMLSelectElement>)}
-                disabled={!taxRates.length}
+                disabled={isShippedOrderLine || !taxRates.length}
               >
                 <SelectTrigger>
                   <SelectValue
@@ -2292,6 +2391,7 @@ export function LineItemDialog({
               <Input
                 value={typeof value === "string" ? value : ""}
                 onChange={(event) => setValue(event.target.value || null)}
+                disabled={isShippedOrderLine}
                 placeholder={t(
                   "sales.documents.items.quantityUnitPlaceholder",
                   "e.g. pc",
@@ -2349,7 +2449,7 @@ export function LineItemDialog({
                   });
                 }
               }}
-              disabled={!productId}
+              disabled={isShippedOrderLine || !productId}
             >
               <SelectTrigger>
                 <SelectValue
@@ -2394,7 +2494,7 @@ export function LineItemDialog({
                 typeof values?.quantityUnit === "string"
                   ? values.quantityUnit
                   : null;
-              if (productId) {
+              if (productId && !isShippedOrderLine) {
                 const selectedPriceId =
                   typeof values?.priceId === "string" ? values.priceId : null;
                 const selectedPriceKindId =
@@ -2549,6 +2649,7 @@ export function LineItemDialog({
     resolveTaxSelection,
     selectPriceAfterRefresh,
     hasTaxMetadata,
+    isShippedOrderLine,
   ]);
 
   const groups = React.useMemo<CrudFormGroup[]>(() => {
@@ -2914,6 +3015,21 @@ export function LineItemDialog({
               : t("sales.documents.items.addTitle", "Add line")}
           </DialogTitle>
         </DialogHeader>
+        {isShippedOrderLine ? (
+          <Alert status="information" style="lighter">
+            <AlertDescription>
+              {shipmentStateUnknown
+                ? t(
+                    "sales.documents.items.shippedLineLockPending",
+                    "Pricing is locked until this order's shipments have been read. Reopen the order to try again — you can still edit the name and raise the quantity.",
+                  )
+                : t(
+                    "sales.documents.items.shippedLineLocked",
+                    "Pricing is locked on this line because it already has shipped items. You can still edit the name and quantity.",
+                  )}
+            </AlertDescription>
+          </Alert>
+        ) : null}
         <CrudForm<LineFormState>
           key={formResetKey}
           embedded

package/src/modules/sales/components/documents/lineItemShipmentLock.ts

@@ -0,0 +1,74 @@
+type ShippedLineSnapshot = {
+  quantity: number;
+  totalNetAmount?: number | null;
+  totalGrossAmount?: number | null;
+};
+
+const SHIPPED_LINE_IMMUTABLE_PAYLOAD_FIELDS = [
+  "kind",
+  "productId",
+  "productVariantId",
+  "quantityUnit",
+  "unitPriceNet",
+  "unitPriceGross",
+  "priceId",
+  "priceMode",
+  "taxRateId",
+  "taxRate",
+  "taxAmount",
+  "discountAmount",
+  "discountPercent",
+  "catalogSnapshot",
+  "metadata",
+] as const;
+
+function scaleTotal(
+  total: number | null | undefined,
+  previousQuantity: number,
+  nextQuantity: number,
+): number | undefined {
+  if (
+    !Number.isFinite(total) ||
+    !Number.isFinite(previousQuantity) ||
+    previousQuantity <= 0
+  ) {
+    return undefined;
+  }
+  return (total as number) * (nextQuantity / previousQuantity);
+}
+
+export function prepareShippedLineUpdatePayload(
+  payload: Record<string, unknown>,
+  currentLine: ShippedLineSnapshot | null,
+): Record<string, unknown> {
+  if (!currentLine) return payload;
+
+  const nextPayload = { ...payload };
+  for (const field of SHIPPED_LINE_IMMUTABLE_PAYLOAD_FIELDS) {
+    delete nextPayload[field];
+  }
+
+  delete nextPayload.totalNetAmount;
+  delete nextPayload.totalGrossAmount;
+
+  const nextQuantity = Number(nextPayload.quantity);
+  if (!Number.isFinite(nextQuantity) || nextQuantity === currentLine.quantity) {
+    return nextPayload;
+  }
+
+  const scaledNetTotal = scaleTotal(
+    currentLine.totalNetAmount,
+    currentLine.quantity,
+    nextQuantity,
+  );
+  const scaledGrossTotal = scaleTotal(
+    currentLine.totalGrossAmount,
+    currentLine.quantity,
+    nextQuantity,
+  );
+  if (scaledNetTotal !== undefined) nextPayload.totalNetAmount = scaledNetTotal;
+  if (scaledGrossTotal !== undefined)
+    nextPayload.totalGrossAmount = scaledGrossTotal;
+
+  return nextPayload;
+}

package/src/modules/sales/i18n/de.json

@@ -979,6 +979,7 @@
   "sales.documents.items.errorProductRequired": "Wähle ein Produkt aus, um fortzufahren.",
   "sales.documents.items.errorQuantity": "Die Menge muss größer als 0 sein.",
   "sales.documents.items.errorQuantityBelowShipped": "Die Menge kann nicht unter die bereits versandten {{shipped}} gesenkt werden.",
+  "sales.documents.items.errorQuantityShipmentsUnknown": "Die Menge kann erst gesenkt werden, wenn die Sendungen dieses Auftrags geladen wurden. Öffnen Sie den Auftrag erneut, um es noch einmal zu versuchen.",
   "sales.documents.items.errorSave": "Position konnte nicht gespeichert werden.",
   "sales.documents.items.errorScope": "Organisation und Mandant sind erforderlich.",
   "sales.documents.items.errorUnitPrice": "Der Stückpreis muss größer als 0 sein.",
@@ -1022,6 +1023,8 @@
   "sales.documents.items.save": "Änderungen speichern",
   "sales.documents.items.selectedProduct": "Ausgewählt {{id}}",
   "sales.documents.items.selectedVariant": "Ausgewählt {{id}}",
+  "sales.documents.items.shippedLineLockPending": "Die Preisangaben sind gesperrt, bis die Sendungen dieses Auftrags geladen wurden. Öffnen Sie den Auftrag erneut, um es noch einmal zu versuchen — Name und eine Erhöhung der Menge können weiterhin bearbeitet werden.",
+  "sales.documents.items.shippedLineLocked": "Die Preisangaben dieser Position sind gesperrt, da bereits Artikel versandt wurden. Name und Menge können weiterhin bearbeitet werden.",
   "sales.documents.items.status": "Status",
   "sales.documents.items.statusEmpty": "Kein Status",
   "sales.documents.items.statusLoading": "Status werden geladen…",

package/src/modules/sales/i18n/en.json

@@ -979,6 +979,7 @@
   "sales.documents.items.errorProductRequired": "Select a product to continue.",
   "sales.documents.items.errorQuantity": "Quantity must be greater than 0.",
   "sales.documents.items.errorQuantityBelowShipped": "You cannot lower the quantity below the {{shipped}} already shipped.",
+  "sales.documents.items.errorQuantityShipmentsUnknown": "The quantity cannot be lowered until this order's shipments have been read. Reopen the order to try again.",
   "sales.documents.items.errorSave": "Failed to save line.",
   "sales.documents.items.errorScope": "Organization and tenant are required.",
   "sales.documents.items.errorUnitPrice": "Unit price must be greater than 0.",
@@ -1022,6 +1023,8 @@
   "sales.documents.items.save": "Save changes",
   "sales.documents.items.selectedProduct": "Selected {{id}}",
   "sales.documents.items.selectedVariant": "Selected {{id}}",
+  "sales.documents.items.shippedLineLockPending": "Pricing is locked until this order's shipments have been read. Reopen the order to try again — you can still edit the name and raise the quantity.",
+  "sales.documents.items.shippedLineLocked": "Pricing is locked on this line because it already has shipped items. You can still edit the name and quantity.",
   "sales.documents.items.status": "Status",
   "sales.documents.items.statusEmpty": "No status",
   "sales.documents.items.statusLoading": "Loading statuses…",

package/src/modules/sales/i18n/es.json

@@ -979,6 +979,7 @@
   "sales.documents.items.errorProductRequired": "Selecciona un producto para continuar.",
   "sales.documents.items.errorQuantity": "La cantidad debe ser mayor que 0.",
   "sales.documents.items.errorQuantityBelowShipped": "No puedes reducir la cantidad por debajo de las {{shipped}} ya enviadas.",
+  "sales.documents.items.errorQuantityShipmentsUnknown": "La cantidad no se puede reducir hasta que se carguen los envíos de este pedido. Vuelve a abrir el pedido para intentarlo de nuevo.",
   "sales.documents.items.errorSave": "No se pudo guardar la línea.",
   "sales.documents.items.errorScope": "Se requieren organización e inquilino.",
   "sales.documents.items.errorUnitPrice": "El precio unitario debe ser mayor que 0.",
@@ -1022,6 +1023,8 @@
   "sales.documents.items.save": "Guardar cambios",
   "sales.documents.items.selectedProduct": "Seleccionado {{id}}",
   "sales.documents.items.selectedVariant": "Seleccionado {{id}}",
+  "sales.documents.items.shippedLineLockPending": "Los precios están bloqueados hasta que se carguen los envíos de este pedido. Vuelve a abrir el pedido para intentarlo de nuevo — todavía puedes editar el nombre y aumentar la cantidad.",
+  "sales.documents.items.shippedLineLocked": "Los precios de esta línea están bloqueados porque ya tiene envíos. Todavía puedes editar el nombre y la cantidad.",
   "sales.documents.items.status": "Estado",
   "sales.documents.items.statusEmpty": "Sin estado",
   "sales.documents.items.statusLoading": "Cargando estados…",

package/src/modules/sales/i18n/ko.json

@@ -979,6 +979,7 @@
   "sales.documents.items.errorProductRequired": "계속하려면 상품을 선택하세요.",
   "sales.documents.items.errorQuantity": "수량은 0보다 커야 합니다.",
   "sales.documents.items.errorQuantityBelowShipped": "이미 배송된 {{shipped}} 이하로 수량을 줄일 수 없습니다.",
+  "sales.documents.items.errorQuantityShipmentsUnknown": "이 주문의 배송 정보를 불러올 때까지 수량을 줄일 수 없습니다. 주문을 다시 열어 재시도하세요.",
   "sales.documents.items.errorSave": "품목을 저장하지 못했습니다.",
   "sales.documents.items.errorScope": "조직 및 테넌트 정보가 필요합니다.",
   "sales.documents.items.errorUnitPrice": "단가는 0보다 커야 합니다.",
@@ -1022,6 +1023,8 @@
   "sales.documents.items.save": "변경사항 저장",
   "sales.documents.items.selectedProduct": "선택됨 {{id}}",
   "sales.documents.items.selectedVariant": "선택됨 {{id}}",
+  "sales.documents.items.shippedLineLockPending": "이 주문의 선적 정보를 불러올 때까지 가격 정보가 잠깁니다. 주문을 다시 열어 재시도하세요 — 이름 수정과 수량 증가는 계속 가능합니다.",
+  "sales.documents.items.shippedLineLocked": "이 라인은 이미 선적된 품목이 있어 가격 정보가 잠겨 있습니다. 이름과 수량은 계속 수정할 수 있습니다.",
   "sales.documents.items.status": "상태",
   "sales.documents.items.statusEmpty": "상태 없음",
   "sales.documents.items.statusLoading": "상태 목록을 불러오는 중…",