Files
dashlibstorage/API.shipment.md
2026-10-15 20:14:51 +02:00

3.1 KiB

shipment

This document is auto-generated from the JSDoc comments in src/store by running npm run api-doc.

shipment.create

Source: src/store/shipment/create.js

Creates a new shipment manifest for an order. Validates that all article positions belong to the order and do not exceed remaining ordered quantities.

Parameters

Name Type Description
provider import('../../providers/provider.js').DatabaseProvider

shipment.delete

Source: src/store/shipment/delete.js

Deletes a shipment manifest of the selected company. Shipped shipments (with packages in 'shipped' state) cannot be deleted.

Parameters

Name Type Description
provider import('../../providers/provider.js').DatabaseProvider

shipment.getById

Source: src/store/shipment/getById.js

Retrieves a shipment manifest by ID for the selected company, including lines and packages.

Parameters

Name Type Description
provider import('../../providers/provider.js').DatabaseProvider

shipment.list

Source: src/store/shipment/list.js

Lists the shipments of the user's selected company.

Parameters

Name Type Description
googleAuthId number The id of the Google auth user.
[opts] object Optional pagination and filter options.
[opts.offset=0] number Number of shipments to skip.
[opts.limit=50] number Number of shipments to return.
[opts.search] string Free-text search matching shipment number, order number, external number, tracking code, or customer name.
[opts.state] `'new' 'delivered'
[opts.seekMonths] number Negative integer for cutoff months ago (e.g. -1).
[opts.orderId] number Optional filter for parent order manifest id.
[tx] object Optional transaction.

Returns

Promise<{shipments: Array<object>, total: number, unfilteredTotal: number, offset: number, limit: number}|Array<object>>

shipment.listByOrderId

Source: src/store/shipment/listByOrderId.js

Lists all shipment manifests belonging to an order.

Parameters

Name Type Description
provider import('../../providers/provider.js').DatabaseProvider

shipment.rebuildSummaries

Source: src/store/shipment/rebuildSummaries.js

Rebuilds the shipmentsummary table for the user's selected company.

Parameters

Name Type Description
googleAuthId number The id of the Google auth user.
[tx] object Optional transaction.

Returns

Promise<void>

shipment.syncSummary

Source: src/store/shipment/syncSummary.js

Centralized sync and rebuild logic for the materialized shipmentsummary table.

shipment.update

Source: src/store/shipment/update.js

Updates a shipment's state or metadata.

Parameters

Name Type Description
provider import('../../providers/provider.js').DatabaseProvider