@vindentech/api-client 0.3.0-next.22 → 0.3.0-next.24

package/dist/generated/index.schemas.d.ts

@@ -24,6 +24,15 @@ export interface OrderSummaryDto {
     /** Per-job operational number (tenant sequence). */
     jobNumber: number;
     orderGroupId: string;
+    /** The customer this job belongs to (public.organization). */
+    organizationId: string;
+    /**
+     * Recipient name from the order's primary transport leg — the same snapshot `PATCH /v1/orders/:id` corrects. Null when the leg carries no name, or when the caller's leg scope does not reach it (a carrier reaches only its own booked legs; warehouse staff only legs on an assigned warehouse).
+     * @nullable
+     */
+    recipientName: string | null;
+    /** Live product lines on the job (voided and deleted lines excluded). Scoped by the caller's own row visibility, so it matches what `GET /v1/orders/{id}` would show them. */
+    productCount: number;
     /**
      * Dispatch warehouse (NULL for service-only / field jobs).
      * @nullable
@@ -60,6 +69,35 @@ export interface PaginatedOrdersDto {
     /** Effective rows skipped applied. */
     offset: number;
 }
+export interface OrderStatusCountDto {
+    /** sales_order status value. */
+    status: string;
+    /** Matching orders in this status. */
+    count: number;
+}
+export type OrderTypeCountDtoType = typeof OrderTypeCountDtoType[keyof typeof OrderTypeCountDtoType];
+export declare const OrderTypeCountDtoType: {
+    readonly PICKUP: "PICKUP";
+    readonly DELIVERY: "DELIVERY";
+    readonly MOVE: "MOVE";
+    readonly DROP_OFF: "DROP_OFF";
+    readonly TRANSFER: "TRANSFER";
+    readonly PICKING: "PICKING";
+    readonly MERCHANDISE_SALE: "MERCHANDISE_SALE";
+};
+export interface OrderTypeCountDto {
+    type: OrderTypeCountDtoType;
+    /** Matching orders of this type. */
+    count: number;
+}
+export interface OrderStatsDto {
+    /** Orders matching the filter, RLS-scoped. Equals the sum of `byStatus`, and the `total` an identically filtered GET /v1/orders would report. */
+    total: number;
+    /** Matching orders grouped by status, in alphabetical status order. A status with no matching order is absent rather than zero. */
+    byStatus: OrderStatusCountDto[];
+    /** Matching orders grouped by job type, in the `sales_order_type` enum's own declaration order (PICKUP, DELIVERY, MOVE, …), not alphabetical. A type with no matching order is absent rather than zero. */
+    byType: OrderTypeCountDto[];
+}
 export interface OrderWarehouseDto {
     warehouseId: string;
     name: string;
@@ -223,6 +261,15 @@ export interface OrderDetailDto {
     /** Per-job operational number (tenant sequence). */
     jobNumber: number;
     orderGroupId: string;
+    /** The customer this job belongs to (public.organization). */
+    organizationId: string;
+    /**
+     * Recipient name from the order's primary transport leg — the same snapshot `PATCH /v1/orders/:id` corrects. Null when the leg carries no name, or when the caller's leg scope does not reach it (a carrier reaches only its own booked legs; warehouse staff only legs on an assigned warehouse).
+     * @nullable
+     */
+    recipientName: string | null;
+    /** Live product lines on the job (voided and deleted lines excluded). Scoped by the caller's own row visibility, so it matches what `GET /v1/orders/{id}` would show them. */
+    productCount: number;
     /**
      * Dispatch warehouse (NULL for service-only / field jobs).
      * @nullable
@@ -326,133 +373,58 @@ export interface OrderTimelineDto {
      */
     estimatedCompletion: string | null;
 }
-/**
- * @nullable
- */
-export type EditOrderRecipientDtoName = {
-    [key: string]: unknown;
-} | null;
-/**
- * @nullable
- */
-export type EditOrderRecipientDtoPhone = {
-    [key: string]: unknown;
-} | null;
-/**
- * @nullable
- */
-export type EditOrderRecipientDtoEmail = {
-    [key: string]: unknown;
-} | null;
-/**
- * @nullable
- */
-export type EditOrderRecipientDtoCompanyName = {
-    [key: string]: unknown;
-} | null;
 export interface EditOrderRecipientDto {
     /** @nullable */
-    name?: EditOrderRecipientDtoName;
+    name?: string | null;
     /** @nullable */
-    phone?: EditOrderRecipientDtoPhone;
+    phone?: string | null;
     /** @nullable */
-    email?: EditOrderRecipientDtoEmail;
+    email?: string | null;
     /** @nullable */
-    companyName?: EditOrderRecipientDtoCompanyName;
+    companyName?: string | null;
 }
 /**
+ * Which kind of elevator the address has (`public.elevator_type`). Distinct from `elevator`, which only says whether there is one: crews plan a move differently for a SMALL cabin than a LARGE or FREIGHT one. Null clears it.
  * @nullable
  */
-export type EditOrderAddressDtoAddressLine1 = {
-    [key: string]: unknown;
-} | null;
-/**
- * @nullable
- */
-export type EditOrderAddressDtoAddressLine2 = {
-    [key: string]: unknown;
-} | null;
-/**
- * @nullable
- */
-export type EditOrderAddressDtoZipCode = {
-    [key: string]: unknown;
-} | null;
-/**
- * @nullable
- */
-export type EditOrderAddressDtoCity = {
-    [key: string]: unknown;
-} | null;
-/**
- * @nullable
- */
-export type EditOrderAddressDtoState = {
-    [key: string]: unknown;
-} | null;
-/**
- * @nullable
- */
-export type EditOrderAddressDtoCounty = {
-    [key: string]: unknown;
-} | null;
-/**
- * ISO 3166-1 alpha-2
- * @nullable
- */
-export type EditOrderAddressDtoCountryCode = {
-    [key: string]: unknown;
-} | null;
-/**
- * @nullable
- */
-export type EditOrderAddressDtoFloorLevel = {
-    [key: string]: unknown;
-} | null;
-/**
- * @nullable
- */
-export type EditOrderAddressDtoElevator = {
-    [key: string]: unknown;
-} | null;
-/**
- * @nullable
- */
-export type EditOrderAddressDtoDoorCode = {
-    [key: string]: unknown;
-} | null;
-/**
- * @nullable
- */
-export type EditOrderAddressDtoTransportInstructions = {
-    [key: string]: unknown;
-} | null;
+export type EditOrderAddressDtoElevatorType = typeof EditOrderAddressDtoElevatorType[keyof typeof EditOrderAddressDtoElevatorType] | null;
+export declare const EditOrderAddressDtoElevatorType: {
+    readonly NONE: "NONE";
+    readonly SMALL: "SMALL";
+    readonly LARGE: "LARGE";
+    readonly FREIGHT: "FREIGHT";
+};
 export interface EditOrderAddressDto {
     /** @nullable */
-    addressLine1?: EditOrderAddressDtoAddressLine1;
+    addressLine1?: string | null;
     /** @nullable */
-    addressLine2?: EditOrderAddressDtoAddressLine2;
+    addressLine2?: string | null;
     /** @nullable */
-    zipCode?: EditOrderAddressDtoZipCode;
+    zipCode?: string | null;
     /** @nullable */
-    city?: EditOrderAddressDtoCity;
+    city?: string | null;
     /** @nullable */
-    state?: EditOrderAddressDtoState;
+    state?: string | null;
     /** @nullable */
-    county?: EditOrderAddressDtoCounty;
+    county?: string | null;
     /**
      * ISO 3166-1 alpha-2
      * @nullable
      */
-    countryCode?: EditOrderAddressDtoCountryCode;
+    countryCode?: string | null;
     /** @nullable */
-    floorLevel?: EditOrderAddressDtoFloorLevel;
+    floorLevel?: number | null;
     /** @nullable */
-    elevator?: EditOrderAddressDtoElevator;
+    elevator?: boolean | null;
+    /**
+     * Which kind of elevator the address has (`public.elevator_type`). Distinct from `elevator`, which only says whether there is one: crews plan a move differently for a SMALL cabin than a LARGE or FREIGHT one. Null clears it.
+     * @nullable
+     */
+    elevatorType?: EditOrderAddressDtoElevatorType;
     /** @nullable */
-    doorCode?: EditOrderAddressDtoDoorCode;
+    doorCode?: string | null;
     /** @nullable */
-    transportInstructions?: EditOrderAddressDtoTransportInstructions;
+    transportInstructions?: string | null;
 }
 export interface RescheduleOrderDto {
     /** The cart_component_key of the leg to re-plan (e.g. move:pickup, move:delivery). */
@@ -467,6 +439,14 @@ export interface EditOrderDto {
     address?: EditOrderAddressDto;
     /** New preferred transport date (does not re-plan capacity by itself). */
     preferredTransportDate?: string;
+    /**
+     * Discount code carried on the order; null removes it. Stored as a label, not redeemed here — the code is resolved against the coupon catalogue when the order is priced, and one that is unknown or out of its window simply yields no discount. An unchanged code may therefore be re-sent on every save without the edit failing.
+     * @maxLength 100
+     * @nullable
+     */
+    couponCode?: string | null;
+    /** Whether the order claims a RUT deduction. The identity number the claim is filed against is frozen at placement and has no edit path, so enabling RUT on an order placed without one leaves the claim without an identity number; disabling it leaves any stored number in place (removal belongs to the personal-data erasure path, not to this toggle). */
+    rutDeduction?: boolean;
     reschedule?: RescheduleOrderDto;
 }
 /**
@@ -2667,6 +2647,39 @@ export interface PlaceOrderResultDto {
     orderNumber: number;
     salesOrders: PlacedSalesOrderDto[];
 }
+export interface CheckoutTransportServiceDto {
+    transportServiceId: string;
+    name: string;
+    /** PICKUP | DELIVERY | MOVE | DROP_OFF | TRANSFER | PICKING | MERCHANDISE_SALE */
+    salesOrderType: string;
+    /** DELIVERY_TIMESLOT | DISPATCH_SLOT | BOOKED */
+    fulfilmentMode: string;
+    /** The zone that matched the queried zip code */
+    serviceZoneId: string;
+}
+export interface TransportSlotDto {
+    slotId: string;
+    slotDate: string;
+    windowStart: string;
+    windowEnd: string;
+    /** @nullable */
+    orderCutoffAt: string | null;
+    /** @nullable */
+    priceExVat: string | null;
+    /** @nullable */
+    priceIncRut: string | null;
+    /** @nullable */
+    vatRate: string | null;
+    /** @nullable */
+    expressSurchargeExVat: string | null;
+    /**
+     * Orders still bookable in this slot; null = unlimited
+     * @nullable
+     */
+    remainingOrders: number | null;
+    /** ACTIVE | CLOSED */
+    status: string;
+}
 export type TransportServiceDtoSalesOrderType = typeof TransportServiceDtoSalesOrderType[keyof typeof TransportServiceDtoSalesOrderType];
 export declare const TransportServiceDtoSalesOrderType: {
     readonly PICKUP: "PICKUP";
@@ -2688,6 +2701,14 @@ export declare const TransportServiceDtoCustomerTypesItem: {
     readonly business: "business";
     readonly personal: "personal";
 };
+/**
+ * Who may be offered this service at checkout. PUBLIC (the default) = every caller, including guest sessions. RESTRICTED = only organizations listed in orgGrants. A RESTRICTED service with no grants is offered to NOBODY — a valid but easily unintended state. Gates booking admission only: revoking access never hides an order already placed.
+ */
+export type TransportServiceDtoVisibility = typeof TransportServiceDtoVisibility[keyof typeof TransportServiceDtoVisibility];
+export declare const TransportServiceDtoVisibility: {
+    readonly PUBLIC: "PUBLIC";
+    readonly RESTRICTED: "RESTRICTED";
+};
 /**
  * @nullable
  */
@@ -2711,6 +2732,8 @@ export interface TransportServiceDto {
     customerTypes: TransportServiceDtoCustomerTypesItem[];
     minLeadTimeHours: number;
     customerSelectable: boolean;
+    /** Who may be offered this service at checkout. PUBLIC (the default) = every caller, including guest sessions. RESTRICTED = only organizations listed in orgGrants. A RESTRICTED service with no grants is offered to NOBODY — a valid but easily unintended state. Gates booking admission only: revoking access never hides an order already placed. */
+    visibility: TransportServiceDtoVisibility;
     isActive: boolean;
     displayOrder: number;
     /** @nullable */
@@ -2718,29 +2741,6 @@ export interface TransportServiceDto {
     createdAt: string;
     updatedAt: string;
 }
-export interface TransportSlotDto {
-    slotId: string;
-    slotDate: string;
-    windowStart: string;
-    windowEnd: string;
-    /** @nullable */
-    orderCutoffAt: string | null;
-    /** @nullable */
-    priceExVat: string | null;
-    /** @nullable */
-    priceIncRut: string | null;
-    /** @nullable */
-    vatRate: string | null;
-    /** @nullable */
-    expressSurchargeExVat: string | null;
-    /**
-     * Orders still bookable in this slot; null = unlimited
-     * @nullable
-     */
-    remainingOrders: number | null;
-    /** ACTIVE | CLOSED */
-    status: string;
-}
 export interface PaginatedTransportServicesDto {
     /** The page of rows. */
     items: TransportServiceDto[];
@@ -2804,6 +2804,15 @@ export interface TransportServicePriceDto {
     isActive: boolean;
     createdAt: string;
 }
+export interface TransportServiceOrgGrantDto {
+    transportServiceOrgGrantId: string;
+    organizationId: string;
+    /** The granted organization's display name */
+    organizationName: string;
+    createdAt: string;
+    /** Last change to the grant — including when a revoked grant was re-granted. */
+    updatedAt: string;
+}
 export type TransportServiceDetailDtoSalesOrderType = typeof TransportServiceDetailDtoSalesOrderType[keyof typeof TransportServiceDetailDtoSalesOrderType];
 export declare const TransportServiceDetailDtoSalesOrderType: {
     readonly PICKUP: "PICKUP";
@@ -2825,6 +2834,14 @@ export declare const TransportServiceDetailDtoCustomerTypesItem: {
     readonly business: "business";
     readonly personal: "personal";
 };
+/**
+ * Who may be offered this service at checkout. PUBLIC (the default) = every caller, including guest sessions. RESTRICTED = only organizations listed in orgGrants. A RESTRICTED service with no grants is offered to NOBODY — a valid but easily unintended state. Gates booking admission only: revoking access never hides an order already placed.
+ */
+export type TransportServiceDetailDtoVisibility = typeof TransportServiceDetailDtoVisibility[keyof typeof TransportServiceDetailDtoVisibility];
+export declare const TransportServiceDetailDtoVisibility: {
+    readonly PUBLIC: "PUBLIC";
+    readonly RESTRICTED: "RESTRICTED";
+};
 /**
  * @nullable
  */
@@ -2848,6 +2865,8 @@ export interface TransportServiceDetailDto {
     customerTypes: TransportServiceDetailDtoCustomerTypesItem[];
     minLeadTimeHours: number;
     customerSelectable: boolean;
+    /** Who may be offered this service at checkout. PUBLIC (the default) = every caller, including guest sessions. RESTRICTED = only organizations listed in orgGrants. A RESTRICTED service with no grants is offered to NOBODY — a valid but easily unintended state. Gates booking admission only: revoking access never hides an order already placed. */
+    visibility: TransportServiceDetailDtoVisibility;
     isActive: boolean;
     displayOrder: number;
     /** @nullable */
@@ -2856,6 +2875,8 @@ export interface TransportServiceDetailDto {
     updatedAt: string;
     zones: TransportServiceZoneDto[];
     activePrices: TransportServicePriceDto[];
+    /** Organizations that may be offered this service. Meaningful only when visibility is RESTRICTED; always empty for a PUBLIC service unless grants were authored ahead of the flip. */
+    orgGrants: TransportServiceOrgGrantDto[];
 }
 export interface TransportServiceZoneInputDto {
     transportServiceZoneId?: string;
@@ -2898,6 +2919,10 @@ export interface TransportServicePriceInputDto {
     effectiveUntil?: string;
     isActive?: boolean;
 }
+export interface TransportServiceOrgGrantInputDto {
+    /** The organization to grant this service to. */
+    organizationId: string;
+}
 export type CreateTransportServiceDtoSalesOrderType = typeof CreateTransportServiceDtoSalesOrderType[keyof typeof CreateTransportServiceDtoSalesOrderType];
 export declare const CreateTransportServiceDtoSalesOrderType: {
     readonly PICKUP: "PICKUP";
@@ -2919,6 +2944,14 @@ export declare const CreateTransportServiceDtoCustomerTypesItem: {
     readonly business: "business";
     readonly personal: "personal";
 };
+/**
+ * Who may be offered this service at checkout. PUBLIC (the default) = every caller, including guest sessions. RESTRICTED = only organizations listed in orgGrants. A RESTRICTED service with no grants is offered to NOBODY — a valid but easily unintended state. Gates booking admission only: revoking access never hides an order already placed.
+ */
+export type CreateTransportServiceDtoVisibility = typeof CreateTransportServiceDtoVisibility[keyof typeof CreateTransportServiceDtoVisibility];
+export declare const CreateTransportServiceDtoVisibility: {
+    readonly PUBLIC: "PUBLIC";
+    readonly RESTRICTED: "RESTRICTED";
+};
 export type CreateTransportServiceDtoMetadata = {
     [key: string]: unknown;
 };
@@ -2939,11 +2972,15 @@ export interface CreateTransportServiceDto {
     customerTypes?: CreateTransportServiceDtoCustomerTypesItem[];
     minLeadTimeHours?: number;
     customerSelectable?: boolean;
+    /** Who may be offered this service at checkout. PUBLIC (the default) = every caller, including guest sessions. RESTRICTED = only organizations listed in orgGrants. A RESTRICTED service with no grants is offered to NOBODY — a valid but easily unintended state. Gates booking admission only: revoking access never hides an order already placed. */
+    visibility?: CreateTransportServiceDtoVisibility;
     isActive?: boolean;
     displayOrder?: number;
     metadata?: CreateTransportServiceDtoMetadata;
     zones?: TransportServiceZoneInputDto[];
     prices?: TransportServicePriceInputDto[];
+    /** Organizations that may be offered this service when visibility is RESTRICTED. Reconciled like zones[]/prices[]: omit to leave the set unchanged, [] to revoke every grant, or supply the exact set. */
+    orgGrants?: TransportServiceOrgGrantInputDto[];
 }
 export type UpdateTransportServiceDtoSalesOrderType = typeof UpdateTransportServiceDtoSalesOrderType[keyof typeof UpdateTransportServiceDtoSalesOrderType];
 export declare const UpdateTransportServiceDtoSalesOrderType: {
@@ -2966,6 +3003,14 @@ export declare const UpdateTransportServiceDtoCustomerTypesItem: {
     readonly business: "business";
     readonly personal: "personal";
 };
+/**
+ * Who may be offered this service at checkout. PUBLIC (the default) = every caller, including guest sessions. RESTRICTED = only organizations listed in orgGrants. A RESTRICTED service with no grants is offered to NOBODY — a valid but easily unintended state. Gates booking admission only: revoking access never hides an order already placed.
+ */
+export type UpdateTransportServiceDtoVisibility = typeof UpdateTransportServiceDtoVisibility[keyof typeof UpdateTransportServiceDtoVisibility];
+export declare const UpdateTransportServiceDtoVisibility: {
+    readonly PUBLIC: "PUBLIC";
+    readonly RESTRICTED: "RESTRICTED";
+};
 export type UpdateTransportServiceDtoMetadata = {
     [key: string]: unknown;
 };
@@ -2988,11 +3033,15 @@ export interface UpdateTransportServiceDto {
     customerTypes?: UpdateTransportServiceDtoCustomerTypesItem[];
     minLeadTimeHours?: number;
     customerSelectable?: boolean;
+    /** Who may be offered this service at checkout. PUBLIC (the default) = every caller, including guest sessions. RESTRICTED = only organizations listed in orgGrants. A RESTRICTED service with no grants is offered to NOBODY — a valid but easily unintended state. Gates booking admission only: revoking access never hides an order already placed. */
+    visibility?: UpdateTransportServiceDtoVisibility;
     isActive?: boolean;
     displayOrder?: number;
     metadata?: UpdateTransportServiceDtoMetadata;
     zones?: TransportServiceZoneInputDto[];
     prices?: TransportServicePriceInputDto[];
+    /** Organizations that may be offered this service when visibility is RESTRICTED. Omit to leave the set unchanged; [] revokes every grant; a supplied array is reconciled to exactly that set. */
+    orgGrants?: TransportServiceOrgGrantInputDto[];
 }
 export interface PaginatedTransportServicePricesDto {
     /** The page of rows. */
@@ -4110,6 +4159,16 @@ export interface FailLegDto {
     /** When the event occurred (client clock). */
     occurredAt?: string;
 }
+/**
+ * Which kind of elevator the address has (`public.elevator_type`). Distinct from `elevator`, which only says whether there is one.
+ */
+export type PatchLegSnapshotDtoElevatorType = typeof PatchLegSnapshotDtoElevatorType[keyof typeof PatchLegSnapshotDtoElevatorType];
+export declare const PatchLegSnapshotDtoElevatorType: {
+    readonly NONE: "NONE";
+    readonly SMALL: "SMALL";
+    readonly LARGE: "LARGE";
+    readonly FREIGHT: "FREIGHT";
+};
 export interface PatchLegSnapshotDto {
     /**
      * Why the snapshot is being corrected (audited).
@@ -4145,6 +4204,8 @@ export interface PatchLegSnapshotDto {
     doorCode?: string;
     floorLevel?: number;
     elevator?: boolean;
+    /** Which kind of elevator the address has (`public.elevator_type`). Distinct from `elevator`, which only says whether there is one. */
+    elevatorType?: PatchLegSnapshotDtoElevatorType;
     latitude?: number;
     longitude?: number;
     /** @maxLength 2000 */
@@ -4374,6 +4435,40 @@ export interface PaginatedProductsDto {
     /** Effective rows skipped applied. */
     offset: number;
 }
+export interface CreateProductDto {
+    /** The owning organization (server validates the caller's scope over it). */
+    organizationId: string;
+    /**
+     * Catalogued product name
+     * @maxLength 255
+     */
+    name: string;
+    categoryId?: number;
+    /** Place the product in this folder of the same organization; omit for the root. */
+    folderId?: string;
+    /** Measured unit width (mm) */
+    unitWidthMm?: number;
+    unitHeightMm?: number;
+    unitDepthMm?: number;
+    unitWeightG?: number;
+    /** Customer-estimated width (mm) */
+    userEstimatedWidthMm?: number;
+    userEstimatedHeightMm?: number;
+    userEstimatedDepthMm?: number;
+    /** Measured parcel count */
+    parcelQuantity?: number;
+    /** Customer-estimated parcel count */
+    userParcelQuantity?: number;
+    /** GTIN (per-org unique) */
+    globalTradeItemNumber?: number;
+    /** Storage key of the primary image */
+    primaryImageStorageKey?: string;
+    /** Per-org unique external reference */
+    externalReference?: string;
+    deliveryFrequency?: string;
+    /** Customer-facing note on the item. */
+    comment?: string;
+}
 export interface UpdateProductDto {
     /** Catalogued product name */
     name?: string;
@@ -4474,15 +4569,18 @@ export interface PaginatedItemsDto {
     offset: number;
 }
 export interface UpdateItemDto {
+    /** Damage/condition flag. Staff-only — 403 for organization callers */
     condition?: string;
     /** Supplier/manufacturing batch id */
     batchId?: string;
     /** Expiry date (ISO date) */
     expiryDate?: string;
+    /** Quarantine flag — blocked units are excluded from picking. Staff-only — 403 for organization callers */
     blocked?: boolean;
+    /** Why the unit is quarantined. Staff-only — 403 for organization callers */
     blockReason?: string;
 }
-export interface PodDto {
+export interface PodDetailDto {
     podId: string;
     organizationId: string;
     itemId: string;
@@ -4511,10 +4609,35 @@ export interface PodDto {
     volumeCm3: number | null;
     createdAt: string;
     updatedAt: string;
+    /**
+     * The catalogue product these goods belong to, via the pod's item
+     * @nullable
+     */
+    productId: string | null;
+    /**
+     * Catalogue name (null on placeholders)
+     * @nullable
+     */
+    productName: string | null;
+    /**
+     * Name captured before identification, when the product has no catalogue name
+     * @nullable
+     */
+    productPlaceholderName: string | null;
+    /**
+     * Primary image storage key
+     * @nullable
+     */
+    productImageStorageKey: string | null;
+    /**
+     * product_status value
+     * @nullable
+     */
+    productStatus: string | null;
 }
 export interface PaginatedPodsDto {
     /** The page of rows. */
-    items: PodDto[];
+    items: PodDetailDto[];
     /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
     total: number;
     /** Effective max rows applied (after defaults/clamp). */
@@ -4558,6 +4681,66 @@ export interface UpdatePodDto {
      */
     labelId?: string;
 }
+export interface PodDto {
+    podId: string;
+    organizationId: string;
+    itemId: string;
+    /** @nullable */
+    containerId: string | null;
+    /** @nullable */
+    warehouseOrderId: string | null;
+    /** @nullable */
+    salesOrderId: string | null;
+    /**
+     * Physical label id (barcode)
+     * @nullable
+     */
+    labelId: string | null;
+    /** pod_status value */
+    status: string;
+    /** Unit width (mm) */
+    unitWidthMm: number;
+    unitHeightMm: number;
+    unitDepthMm: number;
+    quantity: number;
+    /**
+     * Volume in cm³ (generated projection)
+     * @nullable
+     */
+    volumeCm3: number | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface MarkDamagedDto {
+    /**
+     * Units lost to damage.
+     * @minimum 1
+     */
+    quantity: number;
+    /**
+     * Mandatory reason recorded on the movement.
+     * @minLength 3
+     */
+    reason: string;
+}
+export interface AdjustedPodDto {
+    podId: string;
+    /** Units on the pod after the adjustment. */
+    quantity: number;
+    /** Units on the pod before the adjustment. */
+    previousQuantity: number;
+    status: string;
+}
+export interface MarkDamagedResultDto {
+    /** The DAMAGE ledger movement. */
+    movementId: string;
+    /** The pod after the write-off. `quantity` is 0 when the whole pod was lost — the pod row is then retired (soft-deleted), because pod.quantity has a CHECK (> 0) and cannot hold zero. */
+    pod: AdjustedPodDto;
+    /** Units written off. */
+    quantityDamaged: number;
+    /** True when this response replays a previous run of the key. */
+    idempotent: boolean;
+}
 export interface PositionDto {
     positionId: string;
     warehouseId: string;
@@ -4591,6 +4774,10 @@ export interface PositionDto {
     checkNumber: number | null;
     /** True when an active position_blocked row exists */
     isBlocked: boolean;
+    /** Live containers currently sitting on this slot (occupancy) */
+    containerCount: number;
+    /** Live pods inside those containers — distinguishes an occupied-but-empty slot from a full one. RLS-scoped, so a caller who cannot see the goods reads 0. */
+    podCount: number;
     createdAt: string;
 }
 export interface PaginatedPositionsDto {
@@ -4779,6 +4966,16 @@ export interface WarehouseOrderSummaryDto {
     status: string;
     /** @nullable */
     externalReference: string | null;
+    /**
+     * Carrier the SUPPLIER used to ship the inbound goods, as transcribed off the advice note. Not a tenantCarrierId — nobody booked this movement through us.
+     * @nullable
+     */
+    shipmentProvider: string | null;
+    /**
+     * The supplier's waybill / tracking number for the inbound shipment. Opaque text; not resolvable to a tracking URL.
+     * @nullable
+     */
+    shipmentTrackingCode: string | null;
     /**
      * Human-readable order name
      * @nullable
@@ -4875,6 +5072,16 @@ export interface WarehouseOrderDetailDto {
     status: string;
     /** @nullable */
     externalReference: string | null;
+    /**
+     * Carrier the SUPPLIER used to ship the inbound goods, as transcribed off the advice note. Not a tenantCarrierId — nobody booked this movement through us.
+     * @nullable
+     */
+    shipmentProvider: string | null;
+    /**
+     * The supplier's waybill / tracking number for the inbound shipment. Opaque text; not resolvable to a tracking URL.
+     * @nullable
+     */
+    shipmentTrackingCode: string | null;
     /**
      * Human-readable order name
      * @nullable
@@ -4892,7 +5099,7 @@ export interface WarehouseOrderDetailDto {
     containers: WarehouseOrderContainerDto[];
     statusHistory: WarehouseOrderStatusChangeDto[];
 }
-export interface WarehouseOrderProductLineDto {
+export interface InboundWarehouseOrderProductLineDto {
     productId: string;
     /**
      * Expected quantity.
@@ -4901,6 +5108,8 @@ export interface WarehouseOrderProductLineDto {
     requestedQuantity: number;
     /** @maxLength 500 */
     comment?: string;
+    /** Per-line ship-to address (public.address). Valid only on a RECEIVE_AND_DISTRIBUTE order — 400 on any other type. Same-tenant; a destination may legitimately belong to another organization of the tenant. */
+    destinationAddressId?: string;
 }
 export type CreateWarehouseOrderDtoType = typeof CreateWarehouseOrderDtoType[keyof typeof CreateWarehouseOrderDtoType];
 export declare const CreateWarehouseOrderDtoType: {
@@ -4927,8 +5136,18 @@ export interface CreateWarehouseOrderDto {
     plannedArrivalDate?: string;
     /** @maxLength 255 */
     externalReference?: string;
+    /**
+     * Carrier the supplier shipped with, off the advice note. Set at authoring; there is no update path for it yet.
+     * @maxLength 255
+     */
+    shipmentProvider?: string;
+    /**
+     * The supplier's waybill / tracking number. Set at authoring; there is no update path for it yet.
+     * @maxLength 255
+     */
+    shipmentTrackingCode?: string;
     /** Non-TRANSFER only. */
-    products?: WarehouseOrderProductLineDto[];
+    products?: InboundWarehouseOrderProductLineDto[];
     /** TRANSFER only — containers to move. */
     containerIds?: string[];
 }
@@ -4963,6 +5182,16 @@ export interface WarehouseOrderCommandResultDto {
     status: string;
     /** @nullable */
     externalReference: string | null;
+    /**
+     * Carrier the SUPPLIER used to ship the inbound goods, as transcribed off the advice note. Not a tenantCarrierId — nobody booked this movement through us.
+     * @nullable
+     */
+    shipmentProvider: string | null;
+    /**
+     * The supplier's waybill / tracking number for the inbound shipment. Opaque text; not resolvable to a tracking URL.
+     * @nullable
+     */
+    shipmentTrackingCode: string | null;
     /**
      * Human-readable order name
      * @nullable
@@ -4982,6 +5211,16 @@ export interface WarehouseOrderCommandResultDto {
     /** True when this response replays a previous run of the key. */
     idempotent: boolean;
 }
+export interface WarehouseOrderProductLineDto {
+    productId: string;
+    /**
+     * Expected quantity.
+     * @minimum 1
+     */
+    requestedQuantity: number;
+    /** @maxLength 500 */
+    comment?: string;
+}
 export type CreateDisposalRequestDtoType = typeof CreateDisposalRequestDtoType[keyof typeof CreateDisposalRequestDtoType];
 export declare const CreateDisposalRequestDtoType: {
     readonly RECYCLE: "RECYCLE";
@@ -5067,6 +5306,8 @@ export interface AddWarehouseOrderProductDto {
     productId: string;
     /** @minimum 1 */
     requestedQuantity: number;
+    /** Per-line ship-to address (public.address). Valid only when the parent order is RECEIVE_AND_DISTRIBUTE — 409 otherwise. Same-tenant; a destination may legitimately belong to another organization of the tenant. */
+    destinationAddressId?: string;
     /** @maxLength 500 */
     comment?: string;
 }
@@ -5074,6 +5315,11 @@ export interface AddedWarehouseOrderProductDto {
     warehouseOrderProductId: string;
     warehouseOrderId: string;
     productId: string;
+    /**
+     * The per-line ship-to address as persisted; null on a plain inbound line.
+     * @nullable
+     */
+    destinationAddressId: string | null;
     requestedQuantity: number;
     quantity: number;
     status: string;
@@ -5395,14 +5641,6 @@ export interface AdjustCommandDto {
      */
     reason: string;
 }
-export interface AdjustedPodDto {
-    podId: string;
-    /** Units on the pod after the adjustment. */
-    quantity: number;
-    /** Units on the pod before the adjustment. */
-    previousQuantity: number;
-    status: string;
-}
 export interface AdjustResultDto {
     /** The ADJUST ledger movement. */
     movementId: string;
@@ -7546,12 +7784,93 @@ export interface BillableEventTypeDto {
     pricingTarget: boolean;
     description: string;
 }
+export interface PaymentInstrumentDto {
+    paymentInstrumentId: string;
+    /** Payment provider holding the instrument. */
+    provider: string;
+    /** The provider's own id for the instrument — Stripe's `pm_…` payment method. */
+    providerInstrumentId: string;
+    /**
+     * Card network as reported by the provider (visa, mastercard, …).
+     * @nullable
+     */
+    brand: string | null;
+    /**
+     * Last four digits of the card.
+     * @nullable
+     */
+    lastFour: string | null;
+    /**
+     * Expiry month, 1-12.
+     * @nullable
+     */
+    expMonth: number | null;
+    /**
+     * Expiry year, four digits.
+     * @nullable
+     */
+    expYear: number | null;
+    /** The card the auto-charge path uses. At most one live instrument per billing account is the default. */
+    isDefault: boolean;
+    createdAt: string;
+}
+export interface PaymentDetailsRequirementDto {
+    /** True when the checkout should collect card details: the resolved payment method charges automatically and the organization has no live payment instrument. */
+    detailsRequired: boolean;
+    /**
+     * Code of the resolved payment method — the account's own, or the tenant default it inherits when it pins none. Null when neither resolves.
+     * @nullable
+     */
+    paymentMethodCode: string | null;
+    /** Whether the resolved payment method charges the customer automatically. */
+    isAutoChargeable: boolean;
+    /** Whether the organization has at least one payment instrument that has not been removed. Card expiry is deliberately not considered — the provider keeps charging a card past its printed expiry once its updater has refreshed it. */
+    hasPaymentInstrument: boolean;
+    /** False means the organization has no billing account, which is an anomaly (one is provisioned on organization sync) rather than a normal state. Reported rather than raised: a 404 here would send the caller to setup-intent, which fails on the same missing row. */
+    hasBillingAccount: boolean;
+}
 export interface SetupIntentResponseDto {
     /** Stripe SetupIntent client secret — confirm the card with Stripe.js (PaymentElement). */
     clientSecret: string;
     /** The Stripe Customer (cus_…) the saved card will be attached to. */
     stripeCustomerId: string;
 }
+export interface InvoiceDetailsDto {
+    billingAccountId: string;
+    organizationId: string;
+    /**
+     * Primary invoice recipient.
+     * @nullable
+     */
+    invoiceEmail: string | null;
+    /** @nullable */
+    invoiceEmailCc: string | null;
+    /** @nullable */
+    invoiceEmailBcc: string | null;
+    /** @nullable */
+    invoiceAddressLine1: string | null;
+    /** @nullable */
+    invoiceAddressLine2: string | null;
+    /** @nullable */
+    invoiceZipCode: string | null;
+    /** @nullable */
+    invoiceCity: string | null;
+    /**
+     * ISO 3166-1 alpha-2.
+     * @nullable
+     */
+    countryCode: string | null;
+    /**
+     * Days from invoice date to due date, resolved from the account's payment term or the tenant default. Null when neither is configured.
+     * @nullable
+     */
+    daysToDue: number | null;
+    /**
+     * Display name of the resolved payment method (account override, else tenant default). Null when neither is configured.
+     * @nullable
+     */
+    paymentMethodName: string | null;
+}
 export interface StripeWebhookAckDto {
     /** Always true once the event was accepted. */
     received: boolean;
@@ -9416,6 +9735,11 @@ export type OrdersControllerListV1Params = {
      * created_at upper bound, inclusive (ISO-8601).
      */
     toDate?: string;
+    /**
+     * Free-text order search, matching any of: job number (exact, digits only), order-group booking number (exact, digits only), external reference (case-insensitive substring), or a transport leg's recipient name (case-insensitive substring, accelerated by the pg_trgm GIN indexes). Only ever narrows what the caller could already see. Two families see less than they can list: the booking-number match needs order-group visibility, which warehouse and carrier staff do not have, and the recipient match needs leg visibility, which is narrower than order visibility for both.
+     * @maxLength 200
+     */
+    search?: string;
 };
 export type OrdersControllerListV1Type = typeof OrdersControllerListV1Type[keyof typeof OrdersControllerListV1Type];
 export declare const OrdersControllerListV1Type: {
@@ -9427,6 +9751,40 @@ export declare const OrdersControllerListV1Type: {
     readonly PICKING: "PICKING";
     readonly MERCHANDISE_SALE: "MERCHANDISE_SALE";
 };
+export type OrdersControllerStatsV1Params = {
+    /**
+     * Filter by sales_order status. Repeatable — pass ?status=A&status=B for a set; a single value is accepted too.
+     */
+    status?: string[];
+    type?: OrdersControllerStatsV1Type;
+    /**
+     * Narrow to one organization (within the caller's RLS scope).
+     */
+    organizationId?: string;
+    /**
+     * created_at lower bound, inclusive (ISO-8601).
+     */
+    fromDate?: string;
+    /**
+     * created_at upper bound, inclusive (ISO-8601).
+     */
+    toDate?: string;
+    /**
+     * Free-text order search, matching any of: job number (exact, digits only), order-group booking number (exact, digits only), external reference (case-insensitive substring), or a transport leg's recipient name (case-insensitive substring, accelerated by the pg_trgm GIN indexes). Only ever narrows what the caller could already see. Two families see less than they can list: the booking-number match needs order-group visibility, which warehouse and carrier staff do not have, and the recipient match needs leg visibility, which is narrower than order visibility for both.
+     * @maxLength 200
+     */
+    search?: string;
+};
+export type OrdersControllerStatsV1Type = typeof OrdersControllerStatsV1Type[keyof typeof OrdersControllerStatsV1Type];
+export declare const OrdersControllerStatsV1Type: {
+    readonly PICKUP: "PICKUP";
+    readonly DELIVERY: "DELIVERY";
+    readonly MOVE: "MOVE";
+    readonly DROP_OFF: "DROP_OFF";
+    readonly TRANSFER: "TRANSFER";
+    readonly PICKING: "PICKING";
+    readonly MERCHANDISE_SALE: "MERCHANDISE_SALE";
+};
 export type OrderGroupsControllerListV1Params = {
     /**
      * Max rows to return (1–100).
@@ -9614,6 +9972,10 @@ export type CheckoutControllerAvailableServicesV1Params = {
      * ISO 3166-1 alpha-2; defaults to the tenant's country
      */
     countryCode?: string;
+    /**
+     * Staff-only: scope the result to this customer's visibility grants instead of the caller's. Ignored when it equals the caller's own organization; 403 for a non-staff caller naming any other organization.
+     */
+    organizationId?: string;
 };
 export type CheckoutControllerAvailableSlotsV1Params = {
     /**
@@ -9632,6 +9994,10 @@ export type CheckoutControllerAvailableSlotsV1Params = {
      * The recipient's service zone (from GET /available-services). The v1 checkout flow ALWAYS passes this: slots are then resolved most-specific-wins — an exact-zone slot overrides the pooled (zone-agnostic) slot for the same window (even if full), so callers get one deduped row per window. Omitting it is back-compat only: every slot for the service is listed unfiltered and both pooled + per-zone rows may appear.
      */
     serviceZoneId?: string;
+    /**
+     * Staff-only: scope the result to this customer's visibility grants instead of the caller's. Ignored when it equals the caller's own organization; 403 for a non-staff caller naming any other organization.
+     */
+    organizationId?: string;
 };
 export type TransportServicesControllerListV1Params = {
     /**
@@ -9989,9 +10355,9 @@ export type PodsControllerGetPickStateV1Params = {
 };
 export type PositionsControllerListV1Params = {
     /**
-     * Max rows to return (1–100).
+     * Max rows to return (1–500).
      * @minimum 1
-     * @maximum 100
+     * @maximum 500
      */
     limit?: number;
     /**
@@ -10014,9 +10380,9 @@ export type PositionsControllerListV1Params = {
 };
 export type ContainersControllerListV1Params = {
     /**
-     * Max rows to return (1–100).
+     * Max rows to return (1–500).
      * @minimum 1
-     * @maximum 100
+     * @maximum 500
      */
     limit?: number;
     /**
@@ -10035,6 +10401,7 @@ export type ContainersControllerListV1Params = {
     /**
      * Exact per-tenant label-number lookup.
      * @minimum 1
+     * @maximum 9007199254740991
      */
     labelNumber?: number;
 };