u

src/index.js

@@ -185,6 +185,10 @@ import shippingCreate from './store/shipping/create.js';
 import shippingUpdate from './store/shipping/update.js';
 import shippingListByManifestId from './store/shipping/listByManifestId.js';
 import shippingDelete from './store/shipping/delete.js';
+import shipmentCreate from './store/shipment/create.js';
+import shipmentGetById from './store/shipment/getById.js';
+import shipmentListByOrderId from './store/shipment/listByOrderId.js';
+import shipmentDelete from './store/shipment/delete.js';
 import packageCreate from './store/package/create.js';
 import packageListByShippingId from './store/package/listByShippingId.js';
 import packageDelete from './store/package/delete.js';
@@ -457,6 +461,13 @@ export default class LibDashStore {
       delete: shippingDelete(provider),
     };
 
+    this.shipment = {
+      create: shipmentCreate(provider),
+      getById: shipmentGetById(provider),
+      listByOrderId: shipmentListByOrderId(provider),
+      delete: shipmentDelete(provider),
+    };
+
     this.package = {
       create: packageCreate(provider),
       listByShippingId: packageListByShippingId(provider),

src/providers/mssql/queries/logistics.js

@@ -57,13 +57,13 @@ WHERE id = @id
 `;
 
 export const SHIPPING_CREATE = `
-INSERT INTO shipping (manifest_id, [number], [type], [state])
-OUTPUT INSERTED.id, INSERTED.manifest_id, INSERTED.[number], INSERTED.[type], INSERTED.[state]
-VALUES (@manifestId, @number, @type, @state)
+INSERT INTO shipping (manifest_id, [number], tracking_code, carrier, [type], [state])
+OUTPUT INSERTED.id, INSERTED.manifest_id, INSERTED.[number], INSERTED.tracking_code, INSERTED.carrier, INSERTED.[type], INSERTED.[state]
+VALUES (@manifestId, @number, @trackingCode, @carrier, @type, @state)
 `;
 
 export const SHIPPING_LIST_BY_MANIFEST = `
-SELECT id, manifest_id, [number], [type], [state]
+SELECT id, manifest_id, [number], tracking_code, carrier, [type], [state]
 FROM shipping
 WHERE manifest_id = @manifestId
 ORDER BY id ASC
@@ -76,7 +76,7 @@ WHERE id = @id
 `;
 
 export const GET_SHIPPING_BY_ID = `
-SELECT s.id, s.manifest_id AS manifestId, s.[number], s.[type], s.[state]
+SELECT s.id, s.manifest_id AS manifestId, s.[number], s.tracking_code, s.carrier, s.[type], s.[state]
 FROM shipping s
 INNER JOIN manifest m ON m.id = s.manifest_id
 WHERE s.id = @id AND m.company_id = @companyId;
@@ -84,8 +84,8 @@ WHERE s.id = @id AND m.company_id = @companyId;
 
 export const SHIPPING_UPDATE = `
 UPDATE shipping
-SET [type] = @type, [state] = @state
-OUTPUT INSERTED.id, INSERTED.manifest_id, INSERTED.[number], INSERTED.[type], INSERTED.[state]
+SET [type] = @type, [state] = @state, tracking_code = @trackingCode, carrier = @carrier
+OUTPUT INSERTED.id, INSERTED.manifest_id, INSERTED.[number], INSERTED.tracking_code, INSERTED.carrier, INSERTED.[type], INSERTED.[state]
 WHERE id = @id;
 `;
 

src/providers/mssql/queries/numbers.js

@@ -5,8 +5,8 @@ IF NOT EXISTS (
     WHERE company_id = @companyId AND [type] = @type
 )
 BEGIN
-    INSERT INTO numbers (company_id, [type])
-    VALUES (@companyId, @type);
+    INSERT INTO numbers (company_id, [type], prefix)
+    VALUES (@companyId, @type, ISNULL(@prefix, ''));
 END
 `;
 

src/providers/mssql/queries/shipment.js

@@ -0,0 +1,57 @@
+export const SHIPMENT_TYPE = 'shipment';
+
+export const GET_ORDER_HEADER = `
+SELECT id, company_id AS companyId, [number], [type], entity_id AS entityId, external_number AS externalNumber, [date]
+FROM manifest
+WHERE id = @orderId AND company_id = @companyId AND [type] = 'order';
+`;
+
+export const GET_ORDER_LINES = `
+SELECT id, sku, name, pu, amount, net, rebate, taxrate, comment
+FROM manifestarticle
+WHERE manifest_id = @orderId
+ORDER BY id ASC;
+`;
+
+export const GET_SHIPMENT_PREFIX = `
+SELECT prefix
+FROM numbers
+WHERE company_id = @companyId AND [type] = 'shipment';
+`;
+
+export const LIST_SHIPMENTS_BY_ORDER_NUMBER_PATTERN = `
+SELECT m.id, m.[number], m.[type], m.entity_id AS entityId, m.external_number AS externalNumber, m.[date], m.created_at AS createdAt
+FROM manifest m
+WHERE m.company_id = @companyId
+  AND m.[type] = 'shipment'
+  AND m.[number] LIKE @pattern
+ORDER BY m.id ASC;
+`;
+
+export const GET_SHIPPED_AMOUNTS_BY_ORDER_PATTERN = `
+SELECT ma.sku, SUM(ma.amount) AS shippedAmount
+FROM manifest m
+INNER JOIN manifestarticle ma ON ma.manifest_id = m.id
+WHERE m.company_id = @companyId
+  AND m.[type] = 'shipment'
+  AND m.[number] LIKE @pattern
+  AND (@excludeShipmentId IS NULL OR m.id != @excludeShipmentId)
+GROUP BY ma.sku;
+`;
+
+export const GET_SHIPMENT_HEADER = `
+SELECT m.id, m.[number], m.[type], m.entity_id AS entityId, m.external_number AS externalNumber, m.[date], m.created_at AS createdAt
+FROM manifest m
+WHERE m.id = @id AND m.company_id = @companyId AND m.[type] = 'shipment';
+`;
+
+export const CHECK_SHIPMENT_PACKAGES_SHIPPED = `
+SELECT TOP 1 id
+FROM shipping
+WHERE manifest_id = @id AND LOWER([state]) = 'shipped';
+`;
+
+export const DELETE_SHIPMENT = `
+DELETE FROM manifest
+WHERE id = @id AND company_id = @companyId AND [type] = 'shipment';
+`;

src/providers/mssql/schema.js

@@ -1151,6 +1151,8 @@ BEGIN
         id INT IDENTITY(1,1) PRIMARY KEY,
         manifest_id INT NOT NULL,
         [number] NVARCHAR(100) NOT NULL,
+        tracking_code NVARCHAR(255) NULL,
+        carrier NVARCHAR(100) NULL,
         [type] NVARCHAR(100) NOT NULL,
         [state] NVARCHAR(100) NOT NULL,
         CONSTRAINT FK_shipping_manifest FOREIGN KEY (manifest_id) REFERENCES manifest(id) ON DELETE CASCADE

src/providers/sqlite3/queries/numbers.js

@@ -5,8 +5,8 @@ const queries = translateQueries(source, 'numbers');
 export const { GET_BY_COMPANY_AND_ID, LIST_BY_COMPANY, UPDATE_BY_COMPANY_AND_ID } = queries;
 
 export const ENSURE_TYPE = `
-INSERT INTO numbers (company_id, "type")
-VALUES (@companyId, @type)
+INSERT INTO numbers (company_id, "type", prefix)
+VALUES (@companyId, @type, COALESCE(@prefix, ''))
 ON CONFLICT (company_id, "type") DO NOTHING
 `;
 

src/providers/sqlite3/queries/shipment.js

@@ -0,0 +1,15 @@
+import * as source from '../../mssql/queries/shipment.js';
+import { translateQueries } from './translate.js';
+
+const queries = translateQueries(source, 'shipment');
+export const {
+  SHIPMENT_TYPE,
+  GET_ORDER_HEADER,
+  GET_ORDER_LINES,
+  GET_SHIPMENT_PREFIX,
+  LIST_SHIPMENTS_BY_ORDER_NUMBER_PATTERN,
+  GET_SHIPPED_AMOUNTS_BY_ORDER_PATTERN,
+  GET_SHIPMENT_HEADER,
+  CHECK_SHIPMENT_PACKAGES_SHIPPED,
+  DELETE_SHIPMENT,
+} = queries;

src/providers/sqlite3/schema.js

@@ -823,6 +823,8 @@ CREATE TABLE IF NOT EXISTS shipping (
     id INTEGER PRIMARY KEY AUTOINCREMENT,
     manifest_id INTEGER NOT NULL,
     "number" TEXT NOT NULL,
+    tracking_code TEXT NULL,
+    carrier TEXT NULL,
     "type" TEXT NOT NULL,
     "state" TEXT NOT NULL,
     FOREIGN KEY (manifest_id) REFERENCES manifest(id) ON DELETE CASCADE

src/store/numbers/list.js

@@ -9,7 +9,13 @@ import {
 import resolveSelectedCompanyAccess from '../companyuser/resolveSelectedCompanyAccess.js';
 import makeRunner from '../runner.js';
 
-const DEFAULT_TYPES = ['sku', 'entity', 'delivery', 'adjustment'];
+const DEFAULT_TYPES = [
+  { type: 'sku', prefix: '' },
+  { type: 'entity', prefix: '' },
+  { type: 'delivery', prefix: '' },
+  { type: 'adjustment', prefix: '' },
+  { type: 'shipment', prefix: '-L-' },
+];
 
 function shape(row) {
   return {
@@ -30,7 +36,7 @@ export default function list(provider) {
 
   /**
    * Lists the number sequences of the user's selected company.
-   * Ensures that default sequences ('sku', 'entity', 'delivery') exist.
+   * Ensures that default sequences ('sku', 'entity', 'delivery', 'adjustment', 'shipment') exist.
    *
    * @param {number} googleAuthId - The id of the Google auth user.
    * @param {object} [tx] - Optional transaction to run within.
@@ -44,8 +50,10 @@ export default function list(provider) {
     const { companyId } = await access(googleAuthId, tx);
     const runner = makeRunner(provider, tx);
 
-    for (const type of DEFAULT_TYPES) {
-      await runner.query(ensureSql, { companyId, type });
+    for (const item of DEFAULT_TYPES) {
+      const type = typeof item === 'string' ? item : item.type;
+      const prefix = typeof item === 'string' ? (type === 'shipment' ? '-L-' : '') : item.prefix;
+      await runner.query(ensureSql, { companyId, type, prefix });
     }
 
     const result = await runner.query(sql, { companyId });

src/store/numbers/nextNumber.js

@@ -37,7 +37,8 @@ export default function nextNumber(provider) {
    */
   return async (companyId, type, tx) => {
     const doAlloc = async (runner) => {
-      await runner.query(ensureSql, { companyId, type });
+      const prefix = type === 'shipment' ? '-L-' : '';
+      await runner.query(ensureSql, { companyId, type, prefix });
       const res = await runner.query(getSql, { companyId, type });
       const row = res.rows[0];
       if (!row) {

src/store/shipment/create.js

@@ -0,0 +1,195 @@
+import resolveSelectedCompanyAccess from '../companyuser/resolveSelectedCompanyAccess.js';
+import taxEnsure from '../tax/ensure.js';
+import { insertLines, parseDate } from '../manifestLines.js';
+import makeRunner from '../runner.js';
+import { loadShipment, queriesFor } from './helpers.js';
+
+function requireId(val, name) {
+  const n = Number(val);
+  if (!Number.isInteger(n) || n <= 0) {
+    throw new Error(`${name} is required`);
+  }
+  return n;
+}
+
+/**
+ * Creates a new shipment manifest for an order.
+ * Validates that all article positions belong to the order and do not exceed remaining ordered quantities.
+ *
+ * @param {import('../../providers/provider.js').DatabaseProvider} provider
+ */
+export default function create(provider) {
+  const access = resolveSelectedCompanyAccess(provider);
+  const ensureTax = taxEnsure(provider);
+  const q = queriesFor(provider);
+
+  /**
+   * Creates a shipment manifest for an order.
+   *
+   * @param {number} googleAuthId - The id of the Google auth user.
+   * @param {object} input - The shipment input.
+   * @param {number} input.orderId - The parent order manifest id.
+   * @param {string|Date} [input.date] - Optional shipment date (defaults to current date).
+   * @param {string} [input.externalNumber] - Optional external delivery note number.
+   * @param {Array<{sku: string, amount: number, name?: string, pu?: number, net?: number, rebate?: number, taxrate?: number, comment?: string}>} input.lines - The shipment positions.
+   * @param {object} [tx] - Optional transaction.
+   * @returns {Promise<object>} The created shipment manifest.
+   * @throws {Error} If order not found, invalid lines, or article ceiling invariant exceeded.
+   *
+   * @example
+   * const shipment = await store.shipment.create(googleAuthId, {
+   *   orderId: 10,
+   *   lines: [{ sku: 'ITEM-A', amount: 5 }]
+   * });
+   */
+  return async (googleAuthId, input = {}, tx) => {
+    const orderId = requireId(input.orderId, 'Order');
+
+    if (!Array.isArray(input.lines) || input.lines.length === 0) {
+      throw new Error('Invalid lines');
+    }
+
+    const shipmentDate = parseDate(input.date) || new Date();
+    const externalNumber = input.externalNumber?.trim?.()
+      ? input.externalNumber.trim()
+      : null;
+
+    const run = async (runner, innerTx) => {
+      const { companyId } = await access(googleAuthId, runner);
+
+      // 1. Retrieve parent order header
+      const orderRes = await runner.query(q.GET_ORDER_HEADER, {
+        orderId,
+        companyId,
+      });
+      const order = orderRes.rows[0];
+      if (!order) {
+        throw new Error('Order not found');
+      }
+
+      // 2. Retrieve parent order lines
+      const orderLinesRes = await runner.query(q.GET_ORDER_LINES, {
+        orderId,
+      });
+      const orderLines = orderLinesRes.rows ?? [];
+      const orderAmountBySku = new Map();
+      const orderLineBySku = new Map();
+
+      for (const ol of orderLines) {
+        const sku = String(ol.sku ?? '').trim();
+        if (!sku) continue;
+        orderAmountBySku.set(sku, (orderAmountBySku.get(sku) || 0) + Number(ol.amount || 0));
+        if (!orderLineBySku.has(sku)) {
+          orderLineBySku.set(sku, ol);
+        }
+      }
+
+      // 3. Validate proposed lines SKUs and amounts
+      const proposedBySku = new Map();
+      for (const line of input.lines) {
+        const sku = String(line?.sku ?? '').trim();
+        const amount = Number(line?.amount);
+
+        if (!sku || !orderAmountBySku.has(sku)) {
+          throw new Error(`Article (${sku}) is not part of order (${order.number})`);
+        }
+        if (!Number.isFinite(amount) || amount <= 0) {
+          throw new Error('Invalid lines');
+        }
+
+        proposedBySku.set(sku, (proposedBySku.get(sku) || 0) + amount);
+      }
+
+      // 4. Retrieve shipment prefix from numbers table
+      const prefixRes = await runner.query(q.GET_SHIPMENT_PREFIX, { companyId });
+      const shipmentPrefix = prefixRes.rows[0]?.prefix?.trim?.() || '-L-';
+
+      // 5. Retrieve already shipped amounts across existing shipment manifests of this order
+      const pattern = `${order.number}${shipmentPrefix}%`;
+      const shippedRes = await runner.query(q.GET_SHIPPED_AMOUNTS_BY_ORDER_PATTERN, {
+        companyId,
+        pattern,
+        excludeShipmentId: null,
+      });
+      const shippedAmountBySku = new Map();
+      for (const row of shippedRes.rows ?? []) {
+        const sku = String(row.sku ?? '').trim();
+        shippedAmountBySku.set(sku, Number(row.shippedAmount || 0));
+      }
+
+      // 6. Quantity ceiling check
+      for (const [sku, proposedAmount] of proposedBySku.entries()) {
+        const alreadyShipped = shippedAmountBySku.get(sku) || 0;
+        const ordered = orderAmountBySku.get(sku) || 0;
+        if (alreadyShipped + proposedAmount > ordered) {
+          throw new Error(`Shipment amount exceeds ordered amount for article (${sku})`);
+        }
+      }
+
+      // 7. Resolve next index <y>
+      const existingShipmentsRes = await runner.query(q.LIST_SHIPMENTS_BY_ORDER_NUMBER_PATTERN, {
+        companyId,
+        pattern,
+      });
+      const existingShipments = existingShipmentsRes.rows ?? [];
+
+      let maxY = 0;
+      const prefixExact = `${order.number}${shipmentPrefix}`;
+      for (const s of existingShipments) {
+        const num = String(s.number || '');
+        if (num.startsWith(prefixExact)) {
+          const suffix = parseInt(num.slice(prefixExact.length), 10);
+          if (Number.isInteger(suffix) && suffix > maxY) {
+            maxY = suffix;
+          }
+        }
+      }
+      const nextY = Math.max(existingShipments.length + 1, maxY + 1);
+      const shipmentNumber = `${order.number}${shipmentPrefix}${nextY}`;
+
+      // 8. Create shipment manifest header
+      const createdRes = await runner.query(q.CREATE_MANIFEST, {
+        companyId,
+        number: shipmentNumber,
+        type: 'shipment',
+        entityId: order.entityId ?? null,
+        externalNumber,
+        date: shipmentDate,
+        createdAt: new Date(),
+      });
+      const manifestId = createdRes.rows[0]?.id ?? createdRes.insertId;
+
+      // 9. Prepare lines copying defaults from order lines
+      const linesToInsert = input.lines.map((line) => {
+        const sku = String(line.sku).trim();
+        const ol = orderLineBySku.get(sku);
+        return {
+          sku,
+          name: line.name ?? ol?.name ?? sku,
+          pu: line.pu !== undefined ? line.pu : (ol?.pu ?? 1),
+          amount: Number(line.amount),
+          net: line.net !== undefined ? Number(line.net) : Number(ol?.net ?? 0),
+          rebate: line.rebate !== undefined ? Number(line.rebate) : Number(ol?.rebate ?? 0),
+          taxrate: line.taxrate !== undefined ? Number(line.taxrate) : Number(ol?.taxrate ?? 0),
+          comment: line.comment !== undefined ? (line.comment ? String(line.comment) : null) : (ol?.comment ?? null),
+        };
+      });
+
+      await insertLines(runner, {
+        manifestId,
+        lines: linesToInsert,
+        ensureTax,
+      });
+
+      return loadShipment(runner, q, companyId, manifestId);
+    };
+
+    if (tx) {
+      return run(makeRunner(provider, tx), tx);
+    }
+    if (typeof provider?.transaction === 'function') {
+      return provider.transaction((runner, innerTx) => run(runner, innerTx));
+    }
+    return run(makeRunner(provider));
+  };
+}

src/store/shipment/delete.js

@@ -0,0 +1,60 @@
+import resolveSelectedCompanyAccess from '../companyuser/resolveSelectedCompanyAccess.js';
+import makeRunner from '../runner.js';
+import { queriesFor } from './helpers.js';
+
+function requireId(val, name) {
+  const n = Number(val);
+  if (!Number.isInteger(n) || n <= 0) {
+    throw new Error(`${name} is required`);
+  }
+  return n;
+}
+
+/**
+ * Deletes a shipment manifest of the selected company.
+ * Shipped shipments (with packages in 'shipped' state) cannot be deleted.
+ *
+ * @param {import('../../providers/provider.js').DatabaseProvider} provider
+ */
+export default function del(provider) {
+  const access = resolveSelectedCompanyAccess(provider);
+  const q = queriesFor(provider);
+
+  /**
+   * Deletes a shipment manifest.
+   *
+   * @param {number} googleAuthId - The id of the Google auth user.
+   * @param {number} id - The shipment manifest ID.
+   * @param {object} [tx] - Optional transaction.
+   * @returns {Promise<void>}
+   * @throws {Error} If shipment not found or already has shipped packages.
+   *
+   * @example
+   * await store.shipment.delete(googleAuthId, 42);
+   */
+  return async (googleAuthId, id, tx) => {
+    const shipmentId = requireId(id, 'Shipment');
+    const runner = makeRunner(provider, tx);
+    const { companyId } = await access(googleAuthId, runner);
+
+    const check = await runner.query(q.GET_SHIPMENT_HEADER, {
+      id: shipmentId,
+      companyId,
+    });
+    if (!check.rows[0]) {
+      throw new Error('Shipment not found');
+    }
+
+    const shippedCheck = await runner.query(q.CHECK_SHIPMENT_PACKAGES_SHIPPED, {
+      id: shipmentId,
+    });
+    if (shippedCheck.rows[0]) {
+      throw new Error('Shipped shipment cannot be deleted');
+    }
+
+    await runner.query(q.DELETE_SHIPMENT, {
+      id: shipmentId,
+      companyId,
+    });
+  };
+}

src/store/shipment/getById.js

@@ -0,0 +1,46 @@
+import resolveSelectedCompanyAccess from '../companyuser/resolveSelectedCompanyAccess.js';
+import makeRunner from '../runner.js';
+import { loadShipment, queriesFor } from './helpers.js';
+
+function requireId(val, name) {
+  const n = Number(val);
+  if (!Number.isInteger(n) || n <= 0) {
+    throw new Error(`${name} is required`);
+  }
+  return n;
+}
+
+/**
+ * Retrieves a shipment manifest by ID for the selected company, including lines and packages.
+ *
+ * @param {import('../../providers/provider.js').DatabaseProvider} provider
+ */
+export default function getById(provider) {
+  const access = resolveSelectedCompanyAccess(provider);
+  const q = queriesFor(provider);
+
+  /**
+   * Retrieves a shipment manifest by ID.
+   *
+   * @param {number} googleAuthId - The id of the Google auth user.
+   * @param {number} id - The shipment manifest ID.
+   * @param {object} [tx] - Optional transaction.
+   * @returns {Promise<object>} The shipment manifest.
+   * @throws {Error} If shipment not found.
+   *
+   * @example
+   * const shipment = await store.shipment.getById(googleAuthId, 42);
+   */
+  return async (googleAuthId, id, tx) => {
+    const shipmentId = requireId(id, 'Shipment');
+    const runner = makeRunner(provider, tx);
+    const { companyId } = await access(googleAuthId, runner);
+
+    const shipment = await loadShipment(runner, q, companyId, shipmentId);
+    if (!shipment) {
+      throw new Error('Shipment not found');
+    }
+
+    return shipment;
+  };
+}

src/store/shipment/helpers.js

@@ -0,0 +1,63 @@
+import * as mssqlShipmentQueries from '../../providers/mssql/queries/shipment.js';
+import * as sqliteShipmentQueries from '../../providers/sqlite3/queries/shipment.js';
+import * as mssqlDocQueries from '../../providers/mssql/queries/manifestDoc.js';
+import * as sqliteDocQueries from '../../providers/sqlite3/queries/manifestDoc.js';
+import * as mssqlLogisticsQueries from '../../providers/mssql/queries/logistics.js';
+import * as sqliteLogisticsQueries from '../../providers/sqlite3/queries/logistics.js';
+import { shapeLine } from '../manifestLines.js';
+
+export function queriesFor(provider) {
+  const isSqlite = provider?.dialect === 'sqlite3';
+  return {
+    ...(isSqlite ? sqliteShipmentQueries : mssqlShipmentQueries),
+    CREATE_MANIFEST: isSqlite
+      ? sqliteDocQueries.CREATE_MANIFEST
+      : mssqlDocQueries.CREATE_MANIFEST,
+    GET_MANIFEST_LINES: isSqlite
+      ? sqliteDocQueries.GET_MANIFEST_LINES
+      : mssqlDocQueries.GET_MANIFEST_LINES,
+    SHIPPING_LIST_BY_MANIFEST: isSqlite
+      ? sqliteLogisticsQueries.SHIPPING_LIST_BY_MANIFEST
+      : mssqlLogisticsQueries.SHIPPING_LIST_BY_MANIFEST,
+  };
+}
+
+export function shapeShipping(row) {
+  return {
+    id: row.id,
+    manifestId: row.manifest_id ?? row.manifestId,
+    number: row.number,
+    trackingCode: row.tracking_code ?? row.trackingCode ?? null,
+    carrier: row.carrier ?? null,
+    type: row.type,
+    state: row.state,
+  };
+}
+
+export async function loadShipment(runner, q, companyId, id) {
+  const headerRes = await runner.query(q.GET_SHIPMENT_HEADER, { id, companyId });
+  const row = headerRes.rows[0];
+  if (!row) return null;
+
+  const [linesRes, shippingsRes] = await Promise.all([
+    runner.query(q.GET_MANIFEST_LINES, { manifestId: id }),
+    runner.query(q.SHIPPING_LIST_BY_MANIFEST, { manifestId: id }),
+  ]);
+
+  const lines = linesRes.rows.map(shapeLine);
+  const shippings = shippingsRes.rows.map(shapeShipping);
+
+  return {
+    id: row.id,
+    number: row.number,
+    type: 'shipment',
+    entityId: row.entityId ?? null,
+    externalNumber: row.externalNumber ?? null,
+    date: row.date,
+    createdAt: row.createdAt ?? null,
+    lineCount: lines.length,
+    packageCount: shippings.length,
+    lines,
+    shippings,
+  };
+}

src/store/shipment/listByOrderId.js

@@ -0,0 +1,64 @@
+import resolveSelectedCompanyAccess from '../companyuser/resolveSelectedCompanyAccess.js';
+import makeRunner from '../runner.js';
+import { loadShipment, queriesFor } from './helpers.js';
+
+function requireId(val, name) {
+  const n = Number(val);
+  if (!Number.isInteger(n) || n <= 0) {
+    throw new Error(`${name} is required`);
+  }
+  return n;
+}
+
+/**
+ * Lists all shipment manifests belonging to an order.
+ *
+ * @param {import('../../providers/provider.js').DatabaseProvider} provider
+ */
+export default function listByOrderId(provider) {
+  const access = resolveSelectedCompanyAccess(provider);
+  const q = queriesFor(provider);
+
+  /**
+   * Lists shipments of an order.
+   *
+   * @param {number} googleAuthId - The id of the Google auth user.
+   * @param {number} orderId - The parent order manifest id.
+   * @param {object} [tx] - Optional transaction.
+   * @returns {Promise<Array<object>>} The shipment manifests with lines and packages.
+   * @throws {Error} If order not found.
+   *
+   * @example
+   * const shipments = await store.shipment.listByOrderId(googleAuthId, 10);
+   */
+  return async (googleAuthId, orderIdInput, tx) => {
+    const orderId = requireId(orderIdInput, 'Order');
+    const runner = makeRunner(provider, tx);
+    const { companyId } = await access(googleAuthId, runner);
+
+    const orderRes = await runner.query(q.GET_ORDER_HEADER, {
+      orderId,
+      companyId,
+    });
+    const order = orderRes.rows[0];
+    if (!order) {
+      throw new Error('Order not found');
+    }
+
+    const prefixRes = await runner.query(q.GET_SHIPMENT_PREFIX, { companyId });
+    const shipmentPrefix = prefixRes.rows[0]?.prefix?.trim?.() || '-L-';
+
+    const pattern = `${order.number}${shipmentPrefix}%`;
+    const shipmentsRes = await runner.query(q.LIST_SHIPMENTS_BY_ORDER_NUMBER_PATTERN, {
+      companyId,
+      pattern,
+    });
+
+    const rows = shipmentsRes.rows ?? [];
+    const shipments = await Promise.all(
+      rows.map((row) => loadShipment(runner, q, companyId, row.id))
+    );
+
+    return shipments.filter(Boolean);
+  };
+}

src/store/shipping/create.js

@@ -7,8 +7,10 @@ import makeRunner from '../runner.js';
 function shape(row) {
   return {
     id: row.id,
-    manifestId: row.manifest_id,
+    manifestId: row.manifest_id ?? row.manifestId,
     number: row.number,
+    trackingCode: row.tracking_code ?? row.trackingCode ?? null,
+    carrier: row.carrier ?? null,
     type: row.type,
     state: row.state,
   };
@@ -21,34 +23,38 @@ export default function create(provider) {
   const q = queriesFor(provider);
 
   /**
-   * Creates a shipping for a manifest (order). The number is allocated from the
+   * Creates a shipping (package) for a shipment manifest. The number is allocated from the
    * `shipping` numbers sequence (own prefix + counter). If state is 'shipped',
-   * adjusts stock by appending negative ledger movements for tracked order lines,
-   * writes article history for all items, and ensures the order was not already shipped.
+   * adjusts stock by appending negative ledger movements for tracked shipment lines,
+   * writes article history for all items, and ensures stock is deducted once.
    *
    * @param {number} googleAuthId - The id of the Google auth user.
    * @param {object} input - Shipping input.
-   * @param {number} input.manifestId - The manifest (order) id.
+   * @param {number} input.manifestId - The shipment manifest id.
    * @param {string} input.type - Shipping type.
    * @param {string} input.state - Shipping state ('shipped' or other).
+   * @param {string} [input.trackingCode] - Carrier tracking code.
+   * @param {string} [input.carrier] - Carrier name.
    * @param {number} [input.warehouseId] - Optional warehouse ID for stock deduction (defaults to company's first warehouse).
    * @param {object} [tx] - Optional transaction to run within.
-   * @returns {Promise<{id: number, manifestId: number, number: string, type: string, state: string}>}
-   * @throws {Error} If manifest is not found, order already shipped, or input is invalid.
+   * @returns {Promise<{id: number, manifestId: number, number: string, trackingCode: string|null, carrier: string|null, type: string, state: string}>}
+   * @throws {Error} If manifest is not found, manifest is not a shipment, or input is invalid.
    *
    * @example
-   * await store.shipping.create(googleAuthId, { manifestId: 42, type: 'parcel', state: 'shipped' });
+   * await store.shipping.create(googleAuthId, { manifestId: 42, type: 'parcel', state: 'shipped', trackingCode: '1Z999', carrier: 'UPS' });
    */
   return async (googleAuthId, input = {}, tx) => {
     const manifestId = requireId(input.manifestId, 'Manifest');
     const type = requireText(input.type, 'Shipping type');
     const state = requireText(input.state, 'Shipping state');
+    const trackingCode = input.trackingCode ? String(input.trackingCode).trim() : null;
+    const carrier = input.carrier ? String(input.carrier).trim() : null;
     const isShipped = state.trim().toLowerCase() === 'shipped';
 
     const run = async (runner, innerTx) => {
       const { companyId, companyuserId } = await access(googleAuthId, runner);
 
-      // Verify manifest exists and belongs to company
+      // Verify manifest exists, belongs to company, and is a shipment
       const manifestRes = await runner.query(q.GET_MANIFEST_HEADER_BY_ID, {
         manifestId,
         companyId,
@@ -57,15 +63,17 @@ export default function create(provider) {
       if (!manifest) {
         throw new Error('Manifest not found');
       }
+      if (manifest.type !== 'shipment') {
+        throw new Error('Manifest is not a shipment');
+      }
 
+      let alreadyShipped = false;
       if (isShipped) {
-        // Check if order was already shipped
+        // Check if shipment was already marked shipped by an existing package
         const shippedCheck = await runner.query(q.CHECK_ORDER_SHIPPED, {
           manifestId,
         });
-        if (shippedCheck.rows[0]) {
-          throw new Error('Order already shipped');
-        }
+        alreadyShipped = Boolean(shippedCheck.rows[0]);
       }
 
       // Allocate shipping number and insert shipping record
@@ -73,6 +81,8 @@ export default function create(provider) {
       const result = await runner.query(q.SHIPPING_CREATE, {
         manifestId,
         number,
+        trackingCode,
+        carrier,
         type,
         state,
       });
@@ -80,12 +90,14 @@ export default function create(provider) {
         id: result.insertId,
         manifest_id: manifestId,
         number,
+        tracking_code: trackingCode,
+        carrier,
         type,
         state,
       };
 
-      if (isShipped) {
-        // Load order lines
+      if (isShipped && !alreadyShipped) {
+        // Load shipment manifest lines
         const linesRes = await runner.query(q.GET_ORDER_LINES_FOR_SHIPPING, {
           manifestId,
         });
@@ -156,7 +168,7 @@ export default function create(provider) {
                 warehouse_id: warehouseId,
                 transaction_type: 'SHIPPING',
                 amount: -line.amount,
-                transaction_text: `Versand Auftrag ${manifestNumber}`,
+                transaction_text: `Versand Lieferschein ${manifestNumber}`,
               },
               innerTx,
             );

src/store/shipping/listByManifestId.js

@@ -30,6 +30,8 @@ export default function listByManifestId(provider) {
       id: row.id,
       manifestId: row.manifest_id,
       number: row.number,
+      trackingCode: row.tracking_code ?? null,
+      carrier: row.carrier ?? null,
       type: row.type,
       state: row.state,
     }));

src/store/shipping/update.js

@@ -6,8 +6,10 @@ import makeRunner from '../runner.js';
 function shape(row) {
   return {
     id: row.id,
-    manifestId: row.manifest_id,
+    manifestId: row.manifest_id ?? row.manifestId,
     number: row.number,
+    trackingCode: row.tracking_code ?? row.trackingCode ?? null,
+    carrier: row.carrier ?? null,
     type: row.type,
     state: row.state,
   };
@@ -33,10 +35,12 @@ export default function update(provider) {
    * @param {object} patch - Shipping patch fields.
    * @param {string} [patch.type] - Shipping type.
    * @param {string} [patch.state] - Shipping state.
+   * @param {string} [patch.trackingCode] - Carrier tracking code.
+   * @param {string} [patch.carrier] - Carrier name.
    * @param {number} [patch.warehouseId] - Warehouse ID if transitioning to 'shipped'.
    * @param {object} [tx] - Optional transaction to run within.
-   * @returns {Promise<{id: number, manifestId: number, number: string, type: string, state: string}>}
-   * @throws {Error} If shipping is not found, cannot be undone, or order already shipped.
+   * @returns {Promise<{id: number, manifestId: number, number: string, trackingCode: string|null, carrier: string|null, type: string, state: string}>}
+   * @throws {Error} If shipping is not found, cannot be undone, or manifest not found.
    */
   return async (googleAuthId, id, patch = {}, tx) => {
     const shippingId = requireId(id, 'Shipping');
@@ -57,6 +61,8 @@ export default function update(provider) {
         String(current.state || '').trim().toLowerCase() === 'shipped';
       const hasState = Object.prototype.hasOwnProperty.call(patch, 'state');
       const hasType = Object.prototype.hasOwnProperty.call(patch, 'type');
+      const hasTrackingCode = Object.prototype.hasOwnProperty.call(patch, 'trackingCode');
+      const hasCarrier = Object.prototype.hasOwnProperty.call(patch, 'carrier');
 
       if (isCurrentlyShipped) {
         if (
@@ -73,6 +79,12 @@ export default function update(provider) {
       const nextState = hasState
         ? requireText(patch.state, 'Shipping state')
         : current.state;
+      const nextTrackingCode = hasTrackingCode
+        ? (patch.trackingCode ? String(patch.trackingCode).trim() : null)
+        : (current.tracking_code ?? current.trackingCode ?? null);
+      const nextCarrier = hasCarrier
+        ? (patch.carrier ? String(patch.carrier).trim() : null)
+        : (current.carrier ?? null);
       const willBeShipped =
         !isCurrentlyShipped &&
         String(nextState).trim().toLowerCase() === 'shipped';
@@ -82,86 +94,86 @@ export default function update(provider) {
         const shippedCheck = await runner.query(q.CHECK_ORDER_SHIPPED, {
           manifestId,
         });
-        if (shippedCheck.rows[0]) {
-          throw new Error('Order already shipped');
-        }
+        const alreadyShipped = Boolean(shippedCheck.rows[0]);
 
-        const manifestRes = await runner.query(q.GET_MANIFEST_HEADER_BY_ID, {
-          manifestId,
-          companyId,
-        });
-        const manifest = manifestRes.rows[0] ?? { number: String(manifestId) };
-
-        // Load lines & book ledger
-        const linesRes = await runner.query(q.GET_ORDER_LINES_FOR_SHIPPING, {
-          manifestId,
-        });
-        const lines = linesRes.rows ?? [];
-        const trackedLines = [];
-        const untrackedLines = [];
-        for (const line of lines) {
-          const sku = line.sku ? String(line.sku).trim() : '';
-          const amount = Number(line.amount);
-          if (!sku || !Number.isFinite(amount) || amount <= 0) continue;
-
-          const trackRes = await runner.query(q.CHECK_ARTICLE_TRACK_STOCK, {
+        if (!alreadyShipped) {
+          const manifestRes = await runner.query(q.GET_MANIFEST_HEADER_BY_ID, {
+            manifestId,
             companyId,
-            sku,
           });
-          const isUntracked = (trackRes.rows ?? []).some(
-            (r) => Number(r.track_stock ?? 1) === 0
-          );
-          if (isUntracked) {
-            untrackedLines.push({ ...line, amount });
-          } else if ((trackRes.rows ?? []).length > 0) {
-            trackedLines.push({ ...line, amount });
-          }
-        }
+          const manifest = manifestRes.rows[0] ?? { number: String(manifestId) };
 
-        const manifestNumber = manifest.number || String(manifestId);
-
-        let customerName = null;
-        if (manifest.entityId) {
-          const entRes = await runner.query('SELECT name FROM entity WHERE id = @entityId', {
-            entityId: manifest.entityId,
+          // Load lines & book ledger
+          const linesRes = await runner.query(q.GET_ORDER_LINES_FOR_SHIPPING, {
+            manifestId,
           });
-          customerName = entRes.rows[0]?.name ?? null;
-        }
+          const lines = linesRes.rows ?? [];
+          const trackedLines = [];
+          const untrackedLines = [];
+          for (const line of lines) {
+            const sku = line.sku ? String(line.sku).trim() : '';
+            const amount = Number(line.amount);
+            if (!sku || !Number.isFinite(amount) || amount <= 0) continue;
 
-        if (trackedLines.length > 0) {
-          let warehouseId = null;
-          if (patch.warehouseId != null) {
-            const requestedWhId = requireId(patch.warehouseId, 'Warehouse');
-            const whCheck = await runner.query(q.CHECK_WAREHOUSE, {
-              warehouseId: requestedWhId,
+            const trackRes = await runner.query(q.CHECK_ARTICLE_TRACK_STOCK, {
               companyId,
+              sku,
             });
-            if (!whCheck.rows[0]) {
-              throw new Error('Warehouse not found');
-            }
-            warehouseId = requestedWhId;
-          } else {
-            const defaultWh = await runner.query(q.GET_DEFAULT_WAREHOUSE, {
-              companyId,
-            });
-            if (!defaultWh.rows[0]) {
-              throw new Error('Warehouse not found');
-            }
-            warehouseId = defaultWh.rows[0].id;
-          }
-
-          for (const line of trackedLines) {
-            await addLedger(
-              googleAuthId,
-              {
-                manifestarticle_id: line.id,
-                warehouse_id: warehouseId,
-                transaction_type: 'SHIPPING',
-                amount: -line.amount,
-                transaction_text: `Versand Auftrag ${manifestNumber}`,
-              },
-              innerTx,
+            const isUntracked = (trackRes.rows ?? []).some(
+              (r) => Number(r.track_stock ?? 1) === 0
             );
+            if (isUntracked) {
+              untrackedLines.push({ ...line, amount });
+            } else if ((trackRes.rows ?? []).length > 0) {
+              trackedLines.push({ ...line, amount });
+            }
+          }
+
+          const manifestNumber = manifest.number || String(manifestId);
+
+          let customerName = null;
+          if (manifest.entityId) {
+            const entRes = await runner.query('SELECT name FROM entity WHERE id = @entityId', {
+              entityId: manifest.entityId,
+            });
+            customerName = entRes.rows[0]?.name ?? null;
+          }
+
+          if (trackedLines.length > 0) {
+            let warehouseId = null;
+            if (patch.warehouseId != null) {
+              const requestedWhId = requireId(patch.warehouseId, 'Warehouse');
+              const whCheck = await runner.query(q.CHECK_WAREHOUSE, {
+                warehouseId: requestedWhId,
+                companyId,
+              });
+              if (!whCheck.rows[0]) {
+                throw new Error('Warehouse not found');
+              }
+              warehouseId = requestedWhId;
+            } else {
+              const defaultWh = await runner.query(q.GET_DEFAULT_WAREHOUSE, {
+                companyId,
+              });
+              if (!defaultWh.rows[0]) {
+                throw new Error('Warehouse not found');
+              }
+              warehouseId = defaultWh.rows[0].id;
+            }
+
+            for (const line of trackedLines) {
+              await addLedger(
+                googleAuthId,
+                {
+                  manifestarticle_id: line.id,
+                  warehouse_id: warehouseId,
+                  transaction_type: 'SHIPPING',
+                  amount: -line.amount,
+                  transaction_text: `Versand Lieferschein ${manifestNumber}`,
+                },
+                innerTx,
+              );
+            }
           }
         }
       }
@@ -170,12 +182,16 @@ export default function update(provider) {
         id: shippingId,
         type: nextType,
         state: nextState,
+        trackingCode: nextTrackingCode,
+        carrier: nextCarrier,
       });
 
       const updatedRow = updateRes.rows[0] ?? {
         id: shippingId,
         manifest_id: current.manifestId,
         number: current.number,
+        tracking_code: nextTrackingCode,
+        carrier: nextCarrier,
         type: nextType,
         state: nextState,
       };