@vindentech/api-client 0.3.0-next.23 → 0.3.0-next.25

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

@@ -373,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). */
@@ -514,8 +439,23 @@ 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;
 }
+export interface AssignOrderWarehouseDto {
+    /**
+     * The warehouse the job belongs to; null clears the assignment. Placement infers this from the booked transport service's origin warehouse when the booked legs name exactly one — services configured for any warehouse, and legs running from different sites, leave it unset for this command to fill in.
+     * @nullable
+     */
+    warehouseId: string | null;
+}
 /**
  * Opaque line metadata. Accepted but not persisted — sales_order_product carries no metadata column.
  */
@@ -2139,10 +2079,15 @@ export interface QuoteLineDto {
     reference: string | null;
     description: string;
     quantity: number;
-    /** Unit price ex-VAT, integer minor units of the quote currency */
+    /** Unit price ex-VAT, integer minor units of the quote currency. This is the catalogue price BEFORE any binding discount — with one applied it no longer multiplies out to `lineTotalExVatMinor` (a 100% start-fee waiver leaves a priced unit against a zero line). Sum `lineTotalExVatMinor`, never unit × quantity, or the result contradicts `totals`. */
     unitPriceExVatMinor: number;
-    /** Line total ex-VAT, integer minor units */
+    /** Line total ex-VAT, integer minor units, AFTER any binding discount — the amount that reaches `totals` */
     lineTotalExVatMinor: number;
+    /**
+     * How much the binding plan took off this line, integer minor units. Null when no discount applied.
+     * @nullable
+     */
+    discountExVatMinor: number | null;
     /** VAT rate as a percentage, per the platform-wide NUMERIC(6,4) convention (25 = 25%) */
     vatRate: number;
     /** Whether this line qualifies for the RUT labour deduction */
@@ -2177,18 +2122,22 @@ export interface QuoteDiscountDto {
     /** binding_period | campaign | contract | ... */
     ruleType: string;
     /**
-     * Article code the rate applies to; null = every article
+     * Article code the rule applies to; null = every article priced on this quote
      * @nullable
      */
     articleCode: string | null;
+    /** percentage | fixed_amount | replacement_price */
+    discountType: string;
     /**
-     * Basis points (1000 = 10.00%)
+     * Basis points (1000 = 10.00%); null for a money-valued rule
      * @nullable
      */
     discountPercentBps: number | null;
+    /** What this rule took off, ex-VAT, integer minor units */
+    discountExVatMinor: number;
 }
 export interface QuoteTotalsDto {
-    /** Sum of line totals ex-VAT, minor units */
+    /** Sum of line totals ex-VAT after binding discounts, minor units */
     exVatMinor: number;
     /** Total VAT, minor units */
     vatMinor: number;
@@ -2196,6 +2145,25 @@ export interface QuoteTotalsDto {
     incVatMinor: number;
     /** What the customer pays: incVat − coupon discount − RUT deduction, minor units */
     payableMinor: number;
+    /** What the binding plan took off, ex-VAT, minor units. The number to compare options by: `payableMinor` also carries the coupon and the RUT deduction, both of which floor at zero and can make two options look identical. */
+    discountExVatMinor: number;
+}
+export interface QuoteBindingOptionDto {
+    bindingPlanId: string;
+    code: string;
+    displayName: string;
+    /**
+     * Null or 0 = flexible, no binding
+     * @nullable
+     */
+    durationMonths: number | null;
+    /** The plan a customer who picks nothing gets */
+    isDefault: boolean;
+    /** True for the plan this quote's own `lines` and `totals` are priced against. Nothing is selected when `binding` is null. */
+    selected: boolean;
+    discounts: QuoteDiscountDto[];
+    /** This cart, priced under this plan */
+    totals: QuoteTotalsDto;
 }
 /**
  * @nullable
@@ -2220,15 +2188,19 @@ export interface QuoteResponseDto {
      * @nullable
      */
     binding: QuoteResponseDtoBinding;
-    /** The in-force binding plan's rate matrix — display data, NOT reflected in `totals` (see QuoteDiscountDto and the BINDING_DISCOUNT entry in `deferred`) */
+    /** The in-force binding plan's discounts, as applied to `lines` and `totals`. Empty when no plan is in force. */
     discounts: QuoteDiscountDto[];
+    /** Every active binding plan of the tenant, each priced against this cart — the duration step's options. Always present; see `bindingOptionsSelectable` for whether picking one would change anything. */
+    bindingOptions: QuoteBindingOptionDto[];
+    /** Whether setting `bindingId` on this cart would change the plan in force. False when the organization already holds a contract, because placement never rewrites an in-force binding — the options are then informational only. */
+    bindingOptionsSelectable: boolean;
     /**
      * Total RUT labour deduction in minor units. Null when RUT does not apply, and also when every RUT-eligible line was priced from a source that carries no post-deduction price to derive it from (see TRANSPORT_RUT in `deferred`) — null means 'not computed', never 'zero saving'.
      * @nullable
      */
     rutDeductionMinor: number | null;
     totals: QuoteTotalsDto;
-    /** Components present on the cart that this quote did not price, or reductions it did not apply. Their absence from `totals` is intentional, never a zero charge. Values: GOODS, SERVICE, START_FEE, TRANSPORT (no configured article, price row, or computable rate — no line is emitted at all), INSURANCE (no plan catalogue exists yet), TRANSPORT_PARTIAL (a transport line IS priced from the rate card but excludes a component the cart carries no quantity for — a per-hour rate with no `estimatedHours`, or a per-unit rate with no shipment manifest — so the transport amount is a floor, not the final charge), TRANSPORT_RUT (the line is RUT-eligible but its price source carries no post-deduction price to derive the amount from), BINDING_DISCOUNT (the plan carries rates in `discounts` that invoicing does not yet honour, so the totals exclude them), MATERIAL_DELIVERY (the cart holds a material:delivery timeslot; its underlying slot may carry a real price, but materials pricing is not yet designed, so it is excluded from `totals` rather than priced as ordinary transport). */
+    /** Components present on the cart that this quote did not price, or reductions it did not apply. Their absence from `totals` is intentional, never a zero charge. Values: GOODS, SERVICE, START_FEE, TRANSPORT (no configured article, price row, or computable rate — no line is emitted at all), INSURANCE (no plan catalogue exists yet), TRANSPORT_PARTIAL (a transport line IS priced from the rate card but excludes a component the cart carries no quantity for — a per-hour rate with no `estimatedHours`, or a per-unit rate with no shipment manifest — so the transport amount is a floor, not the final charge), TRANSPORT_RUT (the line is RUT-eligible but its price source carries no post-deduction price to derive the amount from), MATERIAL_DELIVERY (the cart holds a material:delivery timeslot; its underlying slot may carry a real price, but materials pricing is not yet designed, so it is excluded from `totals` rather than priced as ordinary transport). */
     deferred: string[];
 }
 /**
@@ -2714,6 +2686,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";
@@ -2735,6 +2740,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
  */
@@ -2758,6 +2771,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 */
@@ -2765,29 +2780,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[];
@@ -2851,6 +2843,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";
@@ -2872,6 +2873,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
  */
@@ -2895,6 +2904,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 */
@@ -2903,6 +2914,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;
@@ -2945,6 +2958,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";
@@ -2966,6 +2983,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;
 };
@@ -2986,11 +3011,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: {
@@ -3013,6 +3042,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;
 };
@@ -3035,11 +3072,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. */
@@ -4157,6 +4198,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).
@@ -4192,6 +4243,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 */
@@ -4566,7 +4619,7 @@ export interface UpdateItemDto {
     /** 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;
@@ -4595,10 +4648,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). */
@@ -4642,6 +4720,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;
@@ -4675,6 +4813,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 {
@@ -5538,14 +5680,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;
@@ -7719,6 +7853,21 @@ export interface PaymentInstrumentDto {
     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;
@@ -8446,12 +8595,6 @@ export interface UpdateNotificationTemplateDto {
     /** The only mutable field: event, channel, locale and organization are the template's identity. */
     name: string;
 }
-export interface CreateTemplateVersionDto {
-    /** Start from this version's content. Cloning an ARCHIVED version is the rollback-with-edits path; the archived row itself is never mutated. */
-    cloneFromVersionId?: string;
-    /** The contract version to author against. Defaults to the cloned version's, else the event's active version. */
-    eventVersion?: number;
-}
 export type TemplateVersionDtoLifecycleStatus = typeof TemplateVersionDtoLifecycleStatus[keyof typeof TemplateVersionDtoLifecycleStatus];
 export declare const TemplateVersionDtoLifecycleStatus: {
     readonly draft: "draft";
@@ -8491,6 +8634,12 @@ export interface TemplateVersionDto {
     /** @nullable */
     replyTo: string | null;
 }
+export interface CreateTemplateVersionDto {
+    /** Start from this version's content. Cloning an ARCHIVED version is the rollback-with-edits path; the archived row itself is never mutated. */
+    cloneFromVersionId?: string;
+    /** The contract version to author against. Defaults to the cloned version's, else the event's active version. */
+    eventVersion?: number;
+}
 /**
  * Sample payload for preview and test-send — contract-validated against eventVersion.
  */
@@ -9862,6 +10011,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 = {
     /**
@@ -9880,6 +10033,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 = {
     /**
@@ -10237,9 +10394,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;
     /**
@@ -10262,9 +10419,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;
     /**
@@ -10283,6 +10440,7 @@ export type ContainersControllerListV1Params = {
     /**
      * Exact per-tenant label-number lookup.
      * @minimum 1
+     * @maximum 9007199254740991
      */
     labelNumber?: number;
 };