@sixtyninecommerce/admin 0.12.0 → 0.14.0

package/README.md

@@ -3953,7 +3953,7 @@ const page = await admin.customers.groups.list({
   include: ['memberCount'],
   take: 50,
 });
-page.items[0]; // { id, name, createdAt, updatedAt, canViewIncomingStock, canBackorder, memberCount }
+page.items[0]; // { id, name, createdAt, updatedAt, canViewIncomingStock, canBackorder, viewOnly, memberCount }
 
 const vip = await admin.customers.groups.create({ name: 'VIP', canBackorder: true });
 await admin.customers.groups.add(vip.id, [customerId]);
@@ -3981,7 +3981,7 @@ await admin.customers.groups.b2b.set([...trade.map((group) => group.id), wholesa
   group holds. Anything else, and a `take` outside 1 to 1000, is refused
   `INVALID_CUSTOMER_GROUP_LIST_OPTIONS` (`ValidationError`) before anything is sent. To search by
   text, take ids from `search.index('customer_groups', …)` and list them with `filter: { ids }`.
-- **`get`** answers the group, its two flags and whose it is (`catalogueOwnership`), or `null` for a
+- **`get`** answers the group, its three flags and whose it is (`catalogueOwnership`), or `null` for a
   group the store does not hold. With `members` it adds one page of the group's members in this
   store and their count, in one fixed order (by id, so pages never overlap);
   `members.filter.ids` narrows the page to those customers, so the answer says which of them are
@@ -3995,8 +3995,11 @@ await admin.customers.groups.b2b.set([...trade.map((group) => group.id), wholesa
   small the page. Ask for `memberCount` only where you show it, and expect a large group to be
   slow.
 - **`create` and `update`** send only what you name: a flag left out is not touched. The flags are
-  `canViewIncomingStock` (members see incoming stock on the storefront) and `canBackorder` (members
-  may order more than is in stock, within the store's backorder policy).
+  `canViewIncomingStock` (members see incoming stock on the storefront), `canBackorder` (members
+  may order more than is in stock, within the store's backorder policy) and `viewOnly` (signed-in
+  members see the store's retail prices incl. VAT and fill a basket, but checkout, payments and
+  quote requests are refused `VIEW_ONLY_ACCOUNT`; staff can still order for them). `viewOnly` needs
+  a platform release that has it: an older engine refuses the whole document.
 - **A group is one row for every store that holds it.** `update`, `delete` and `deleteMany` are
   refused `MANAGED_BY_ORGANIZATION` (`BusinessRuleError`) for a group the store holds from its
   organization, and `SHARED_CUSTOMER_GROUP_NOT_ALLOWED` (`PermissionDeniedError`) for one other
@@ -7178,7 +7181,7 @@ reads it by id:
 
 ```ts
 const group = await admin.customers.groups.get(groupId);
-// { id, createdAt, updatedAt, name, externalKey, canViewIncomingStock, canBackorder,
+// { id, createdAt, updatedAt, name, externalKey, canViewIncomingStock, canBackorder, viewOnly,
 //   catalogueOwnership }, or null
 ```
 

package/dist/customers/groups.d.ts

@@ -25,6 +25,13 @@ export interface CustomerGroup {
     canViewIncomingStock: boolean;
     /** Members may order more than is in stock, within the store's or the variant's backorder policy. */
     canBackorder: boolean;
+    /**
+     * "View only": signed-in members see the store's retail prices including VAT (the prices an
+     * anonymous shopper sees, never a price list's) and can fill a basket on the storefront, but
+     * checkout, payments and quote requests are refused (`VIEW_ONLY_ACCOUNT`). Staff can still
+     * place orders for them. The Exact customer import never links a customer to such a group.
+     */
+    viewOnly: boolean;
     /**
      * The store's own group, or its organization's (shared while the organization shares
      * `customer_groups`); see {@link CatalogueOwnership}. `editableHere` false: rename it, change
@@ -91,6 +98,7 @@ export interface CustomerGroupListItem {
     name: string;
     canViewIncomingStock: boolean;
     canBackorder: boolean;
+    viewOnly: boolean;
     /**
      * How many of the store's customers are in the group, present only when the call asked for
      * `include: ['memberCount']`.
@@ -134,12 +142,15 @@ export interface CreateCustomerGroupInput {
     canViewIncomingStock?: boolean;
     /** See {@link CustomerGroup.canBackorder}. Off when omitted. */
     canBackorder?: boolean;
+    /** See {@link CustomerGroup.viewOnly}. Off when omitted. */
+    viewOnly?: boolean;
 }
 /** A PATCH: an absent field keeps what the group has. */
 export interface UpdateCustomerGroupInput {
     name?: string;
     canViewIncomingStock?: boolean;
     canBackorder?: boolean;
+    viewOnly?: boolean;
 }
 /** A group by id and name. */
 export interface CustomerGroupRef {
@@ -168,9 +179,9 @@ export interface CustomerB2BGroupsModule {
     set(groupIds: readonly string[], options?: Call): Promise<CustomerGroupRef[]>;
 }
 /** A customer group as `get`, `create` and `update` read it. */
-export declare const CUSTOMER_GROUP_FIELDS = "\n  id\n  createdAt\n  updatedAt\n  name\n  externalKey\n  \n  customFields {\n    canViewIncomingStock\n    canBackorder\n  }\n\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n";
-export declare const CUSTOMER_GROUP_QUERY = "\n  query CustomerGroup($id: ID!) {\n    customerGroup(id: $id) { \n  id\n  createdAt\n  updatedAt\n  name\n  externalKey\n  \n  customFields {\n    canViewIncomingStock\n    canBackorder\n  }\n\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n }\n  }\n";
-export declare const CUSTOMER_GROUP_MEMBERS_QUERY = "\n  query CustomerGroupWithMembers($id: ID!, $members: CustomerListOptions) {\n    customerGroup(id: $id) {\n      \n  id\n  createdAt\n  updatedAt\n  name\n  externalKey\n  \n  customFields {\n    canViewIncomingStock\n    canBackorder\n  }\n\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n\n      customers(options: $members) {\n        items {\n          id\n          createdAt\n          firstName\n          lastName\n          emailAddress\n          addresses {\n            company\n            defaultBillingAddress\n            defaultShippingAddress\n          }\n        }\n        totalItems\n      }\n    }\n  }\n";
+export declare const CUSTOMER_GROUP_FIELDS = "\n  id\n  createdAt\n  updatedAt\n  name\n  externalKey\n  \n  customFields {\n    canViewIncomingStock\n    canBackorder\n    viewOnly\n  }\n\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n";
+export declare const CUSTOMER_GROUP_QUERY = "\n  query CustomerGroup($id: ID!) {\n    customerGroup(id: $id) { \n  id\n  createdAt\n  updatedAt\n  name\n  externalKey\n  \n  customFields {\n    canViewIncomingStock\n    canBackorder\n    viewOnly\n  }\n\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n }\n  }\n";
+export declare const CUSTOMER_GROUP_MEMBERS_QUERY = "\n  query CustomerGroupWithMembers($id: ID!, $members: CustomerListOptions) {\n    customerGroup(id: $id) {\n      \n  id\n  createdAt\n  updatedAt\n  name\n  externalKey\n  \n  customFields {\n    canViewIncomingStock\n    canBackorder\n    viewOnly\n  }\n\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n\n      customers(options: $members) {\n        items {\n          id\n          createdAt\n          firstName\n          lastName\n          emailAddress\n          addresses {\n            company\n            defaultBillingAddress\n            defaultShippingAddress\n          }\n        }\n        totalItems\n      }\n    }\n  }\n";
 /**
  * The list document for a set of blocks. The member count is the `totalItems` of a one-row page
  * of the group's customers: a `take` of 0 would make that page every member.
@@ -184,8 +195,8 @@ export declare const CUSTOMER_GROUP_MEMBERS_QUERY = "\n  query CustomerGroupWith
  * fix is `omit: ['customers']` on those two resolvers, which this package cannot make.
  */
 export declare function customerGroupListQuery(include: readonly CustomerGroupListInclude[]): string;
-export declare const CREATE_CUSTOMER_GROUP_MUTATION = "\n  mutation CreateCustomerGroup($input: CreateCustomerGroupInput!) {\n    createCustomerGroup(input: $input) { \n  id\n  createdAt\n  updatedAt\n  name\n  externalKey\n  \n  customFields {\n    canViewIncomingStock\n    canBackorder\n  }\n\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n }\n  }\n";
-export declare const UPDATE_CUSTOMER_GROUP_MUTATION = "\n  mutation UpdateCustomerGroup($input: UpdateCustomerGroupInput!) {\n    updateCustomerGroup(input: $input) { \n  id\n  createdAt\n  updatedAt\n  name\n  externalKey\n  \n  customFields {\n    canViewIncomingStock\n    canBackorder\n  }\n\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n }\n  }\n";
+export declare const CREATE_CUSTOMER_GROUP_MUTATION = "\n  mutation CreateCustomerGroup($input: CreateCustomerGroupInput!) {\n    createCustomerGroup(input: $input) { \n  id\n  createdAt\n  updatedAt\n  name\n  externalKey\n  \n  customFields {\n    canViewIncomingStock\n    canBackorder\n    viewOnly\n  }\n\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n }\n  }\n";
+export declare const UPDATE_CUSTOMER_GROUP_MUTATION = "\n  mutation UpdateCustomerGroup($input: UpdateCustomerGroupInput!) {\n    updateCustomerGroup(input: $input) { \n  id\n  createdAt\n  updatedAt\n  name\n  externalKey\n  \n  customFields {\n    canViewIncomingStock\n    canBackorder\n    viewOnly\n  }\n\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n }\n  }\n";
 export declare const DELETE_CUSTOMER_GROUP_MUTATION = "\n  mutation DeleteCustomerGroup($id: ID!) {\n    deleteCustomerGroup(id: $id) { \n  result\n  message\n }\n  }\n";
 export declare const DELETE_CUSTOMER_GROUPS_MUTATION = "\n  mutation DeleteCustomerGroups($ids: [ID!]!) {\n    deleteCustomerGroups(ids: $ids) { \n  result\n  message\n }\n  }\n";
 export declare const B2B_CUSTOMER_GROUPS_QUERY = "\n  query CustomerGroupRefs {\n    b2bCustomerGroups {\n      id\n      name\n    }\n  }\n";

package/dist/customers/groups.js

@@ -16,10 +16,13 @@ export const MAX_CUSTOMER_GROUP_LIST_TAKE = 1000;
 export const CUSTOMER_GROUP_LIST_SORT_FIELDS = ['name', 'createdAt', 'updatedAt'];
 /** The blocks a list row can add: `memberCount`, how many of the store's customers are in it. */
 export const CUSTOMER_GROUP_LIST_INCLUDES = ['memberCount'];
+/** The group's boolean flags, each a `CustomerGroup.customFields` field of the same name. */
+const GROUP_FLAGS = ['canViewIncomingStock', 'canBackorder', 'viewOnly'];
 const GROUP_FLAG_FIELDS = /* GraphQL */ `
   customFields {
     canViewIncomingStock
     canBackorder
+    viewOnly
   }
 `;
 /** A customer group as `get`, `create` and `update` read it. */
@@ -144,11 +147,12 @@ const isPageSize = (take) => typeof take === 'number' &&
     take >= 1 &&
     take <= MAX_CUSTOMER_GROUP_LIST_TAKE;
 const isOffset = (skip) => typeof skip === 'number' && Number.isInteger(skip) && skip >= 0;
-/** Both flags are `false` unless the engine answers `true`: a group has no third state. */
+/** Every flag is `false` unless the engine answers `true`: a group has no third state. */
 function flagsOf(wire) {
     return {
         canViewIncomingStock: wire.customFields?.canViewIncomingStock === true,
         canBackorder: wire.customFields?.canBackorder === true,
+        viewOnly: wire.customFields?.viewOnly === true,
     };
 }
 function toCustomerGroup(wire) {
@@ -341,7 +345,7 @@ export async function listCustomerGroups(transport, options) {
 /** Only the flags the caller set travel: an omitted flag is never sent as `null`. */
 function flagFields(input) {
     const customFields = {};
-    for (const flag of ['canViewIncomingStock', 'canBackorder']) {
+    for (const flag of GROUP_FLAGS) {
         const value = input[flag];
         if (value === undefined)
             continue;

package/dist/documents/emails.d.ts

@@ -32,7 +32,11 @@ export interface EmailDelivery {
     attempt: number;
     /** The mail provider's message id, when it took the email. */
     messageId: string | null;
-    /** Why the last attempt failed, as the provider or the mail server said it. */
+    /**
+     * Why the last attempt failed, as a coded sentence: `CODE: not sent (facts). Plain sentence.`
+     * (`SMTP_SEND_FAILED: not sent (code=EAUTH step=AUTH PLAIN reply=535). …`). Never the
+     * provider's or the mail server's own words, which can quote the gateway's user name or hosts.
+     */
     error: string | null;
     durationMs: number | null;
     /** The ids the email was rendered from (`orderId`, `invoiceId`, …) and other send facts. */

package/dist/fulfillments/create.d.ts

@@ -162,6 +162,6 @@ export interface FulfillmentCreateMethods {
      */
     profileChargePreview(input: FulfillmentProfileChargePreviewInput, options?: Call): Promise<FulfillmentProfileChargePreview>;
 }
-export declare const CREATE_WAREHOUSE_FULFILLMENTS_MUTATION = "\n  mutation CreateWarehouseFulfillments(\n    $input: CreateWarehouseFulfillmentsInput!\n    $idempotencyKey: String\n  ) {\n    createWarehouseFulfillments(input: $input, idempotencyKey: $idempotencyKey) {\n      __typename\n      ... on WarehouseCreateResult {\n        created\n        failed\n        results {\n          index\n          fulfillment {\n            \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n          }\n          error {\n            code\n            message\n            field\n          }\n          claimError {\n            code\n            message\n            field\n          }\n        }\n      }\n      ... on WarehouseError {\n        errorCode\n        code\n        message\n        field\n      }\n    }\n  }\n";
+export declare const CREATE_WAREHOUSE_FULFILLMENTS_MUTATION = "\n  mutation CreateWarehouseFulfillments(\n    $input: CreateWarehouseFulfillmentsInput!\n    $idempotencyKey: String\n  ) {\n    createWarehouseFulfillments(input: $input, idempotencyKey: $idempotencyKey) {\n      __typename\n      ... on WarehouseCreateResult {\n        created\n        failed\n        results {\n          index\n          fulfillment {\n            \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  dropShipSupplierName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n          }\n          error {\n            code\n            message\n            field\n          }\n          claimError {\n            code\n            message\n            field\n          }\n        }\n      }\n      ... on WarehouseError {\n        errorCode\n        code\n        message\n        field\n      }\n    }\n  }\n";
 export declare const FULFILLMENT_PROFILE_CHARGE_PREVIEW_QUERY = "\n  query FulfillmentProfileChargePreview($input: FulfillmentProfileChargePreviewInput!) {\n    fulfillmentProfileChargePreview(input: $input) {\n      profileName\n      currencyCode\n      minOrder\n      selectedNet\n      shortfall\n      deliveryCharge\n      deliveryChargeIncludesTax\n      settled\n      handedOver\n    }\n  }\n";
 export declare function createFulfillmentCreateMethods(transport: Transport): FulfillmentCreateMethods;

package/dist/fulfillments/create.js

@@ -9,7 +9,7 @@
  * 400, never a 422). Each group's own refusal is data in `results[].error`.
  */
 import { idempotencyKey as mintIdempotencyKey, ValidationError, } from '@sixtyninecommerce/core';
-import { assertId, FULFILLMENT_FIELDS, invalid, isWarehouseErrorMember, toFulfillment, toRefusal, warehouseRefusalError, withAttemptKey, } from './warehouse.js';
+import { assertId, dropShipSupplierAware, FULFILLMENT_FIELDS, invalid, isWarehouseErrorMember, toFulfillment, toRefusal, warehouseRefusalError, withAttemptKey, } from './warehouse.js';
 export const CREATE_WAREHOUSE_FULFILLMENTS_MUTATION = /* GraphQL */ `
   mutation CreateWarehouseFulfillments(
     $input: CreateWarehouseFulfillmentsInput!
@@ -134,12 +134,15 @@ function assertPreviewInput(input) {
     }
 }
 export function createFulfillmentCreateMethods(transport) {
+    // The create answers the warehouse's fulfilment fields, `dropShipSupplierName` among them: an
+    // engine before purchase-orders step 5.5 refuses that field before the mutation runs.
+    const engine = dropShipSupplierAware(transport);
     return {
         async create(input, options) {
             assertCreateInput(input);
             const key = options?.idempotencyKey ?? mintIdempotencyKey();
             try {
-                const data = await transport.graphql({
+                const data = await engine.graphql({
                     api: 'admin',
                     query: CREATE_WAREHOUSE_FULFILLMENTS_MUTATION,
                     variables: {

package/dist/fulfillments/warehouse.d.ts

@@ -237,6 +237,12 @@ export interface WarehouseFulfillment {
     /** Null for a legacy fulfillment whose warehouse was never recorded (office staff only). */
     stockLocationId: string | null;
     stockLocationName: string | null;
+    /**
+     * The supplier that shipped a drop-ship fulfilment (`handlerCode: 'drop-ship'`) straight to the
+     * customer: show it where a warehouse fulfilment shows its warehouse. Null otherwise, and against
+     * an engine before purchase-orders step 5.5.
+     */
+    dropShipSupplierName: string | null;
     /** ISO-8601. */
     createdAt: string;
     /** ISO-8601: when its current stage began. */
@@ -668,30 +674,30 @@ export interface WarehouseFulfillmentsModule {
  * named fragment: `orders-coverage.spec.ts` reads each document's root field with every
  * interpolation replaced, which a fragment spread at the top level would not survive.
  */
-export declare const FULFILLMENT_FIELDS = "\n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n";
+export declare const FULFILLMENT_FIELDS = "\n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  dropShipSupplierName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n";
 export declare const MY_WAREHOUSES_QUERY = "\n  query MyWarehouses {\n    myWarehouses {\n      id\n      name\n    }\n  }\n";
 export declare const WAREHOUSE_COUNTS_QUERY = "\n  query WarehouseCounts($stockLocationId: ID!) {\n    warehouseCounts(stockLocationId: $stockLocationId) {\n      toShip\n      toPick\n      picking\n      packed\n      overdue\n      shippedToday\n      outsourced\n    }\n  }\n";
 export declare const WAREHOUSE_DEMAND_QUERY = "\n  query WarehouseDemand($input: WarehouseDemandInput!) {\n    warehouseDemand(input: $input) {\n      totalItems\n      truncated\n      items {\n        \n  orderId\n  orderCode\n  poNumber\n  orderNotes\n  requestedDeliveryDate\n  deliveryDue\n  orderPlacedAt\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  consolidationKey\n  suggestedHandlerCode\n  paymentBadge\n  hold {\n    reason\n    note\n  }\n  queueExclusions\n  externalPlatform\n  externalOrderId\n  sourceFulfillmentHandedOff\n  sourceFulfilled\n  sourceFulfilledReason\n  chargedParcelCount\n  lines {\n    orderLineId\n    productVariantId\n    sku\n    name\n    featuredAsset {\n      id\n      preview\n    }\n    openQty\n    routing\n    routedLocationId\n    onHandAtLocation\n  }\n\n      }\n    }\n  }\n";
-export declare const WAREHOUSE_FULFILLMENTS_QUERY = "\n  query WarehouseFulfillments($input: WarehouseFulfillmentListInput) {\n    warehouseFulfillments(input: $input) {\n      totalItems\n      items {\n        \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n      }\n    }\n  }\n";
-export declare const WAREHOUSE_FULFILLMENT_QUERY = "\n  query WarehouseFulfillment($id: ID!) {\n    warehouseFulfillment(id: $id) {\n      \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n      lines {\n        orderLineId\n        orderId\n        orderCode\n        productVariantId\n        sku\n        name\n        featuredAsset {\n          id\n          preview\n        }\n        quantity\n      }\n    }\n  }\n";
+export declare const WAREHOUSE_FULFILLMENTS_QUERY = "\n  query WarehouseFulfillments($input: WarehouseFulfillmentListInput) {\n    warehouseFulfillments(input: $input) {\n      totalItems\n      items {\n        \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  dropShipSupplierName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n      }\n    }\n  }\n";
+export declare const WAREHOUSE_FULFILLMENT_QUERY = "\n  query WarehouseFulfillment($id: ID!) {\n    warehouseFulfillment(id: $id) {\n      \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  dropShipSupplierName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n      lines {\n        orderLineId\n        orderId\n        orderCode\n        productVariantId\n        sku\n        name\n        featuredAsset {\n          id\n          preview\n        }\n        quantity\n      }\n    }\n  }\n";
 export declare const WAREHOUSE_FULFILLMENT_HANDLERS_QUERY = "\n  query WarehouseFulfillmentHandlers {\n    warehouseFulfillmentHandlers {\n      code\n      description\n      mode\n      argsRequiredForCreate\n      args {\n        name\n        type\n        list\n        required\n        defaultValue\n        label\n        description\n        ui\n      }\n    }\n  }\n";
 export declare const WAREHOUSE_PICK_LIST_QUERY = "\n  query WarehousePickList($fulfillmentIds: [ID!]!) {\n    warehousePickList(fulfillmentIds: $fulfillmentIds) {\n      generatedAt\n      timeZone\n      warehouseNames\n      lineCount\n      unitCount\n      printedBy {\n        id\n        name\n      }\n      fulfillments {\n        id\n        reference\n        state\n        orderCodes\n        stockLocationName\n        lineCount\n        unitCount\n      }\n      lines {\n        sku\n        name\n        productVariantId\n        quantity\n        fulfillments {\n          fulfillmentId\n          reference\n          orderCodes\n          quantity\n        }\n      }\n    }\n  }\n";
 export declare const WAREHOUSE_APPEND_CANDIDATES_QUERY = "\n  query WarehouseAppendCandidates($fulfillmentId: ID!) {\n    warehouseAppendCandidates(fulfillmentId: $fulfillmentId) {\n      \n  orderId\n  orderCode\n  poNumber\n  orderNotes\n  requestedDeliveryDate\n  deliveryDue\n  orderPlacedAt\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  consolidationKey\n  suggestedHandlerCode\n  paymentBadge\n  hold {\n    reason\n    note\n  }\n  queueExclusions\n  externalPlatform\n  externalOrderId\n  sourceFulfillmentHandedOff\n  sourceFulfilled\n  sourceFulfilledReason\n  chargedParcelCount\n  lines {\n    orderLineId\n    productVariantId\n    sku\n    name\n    featuredAsset {\n      id\n      preview\n    }\n    openQty\n    routing\n    routedLocationId\n    onHandAtLocation\n  }\n\n    }\n  }\n";
 /** The order API, not the warehouse one: it names money (`ReadOrder`). */
 export declare const FULFILLMENT_DETACH_PREVIEW_QUERY = "\n  query FulfillmentDetachPreview($fulfillmentId: ID!, $orderId: ID!) {\n    fulfillmentDetachPreview(fulfillmentId: $fulfillmentId, orderId: $orderId) {\n      deliveryChargeApplies\n      profileName\n      profileMinimum\n      currencyCode\n      priceIncludesTax\n      currentIncludesTax\n      currentCharge\n      newCharge\n      orders {\n        orderId\n        code\n        currentCharge\n        newCharge\n      }\n      remainingNet\n      belowProfileMinimum\n      refusal {\n        code\n        message\n      }\n    }\n  }\n";
-export declare const CLAIM_FULFILLMENT_MUTATION = "\n  mutation ClaimFulfillment($id: ID!) {\n    claimFulfillment(id: $id) {\n      \n  __typename\n  ... on WarehouseFulfillment {\n    \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
-export declare const UNCLAIM_FULFILLMENT_MUTATION = "\n  mutation UnclaimFulfillment($id: ID!) {\n    unclaimFulfillment(id: $id) {\n      \n  __typename\n  ... on WarehouseFulfillment {\n    \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
-export declare const REOPEN_FULFILLMENT_MUTATION = "\n  mutation ReopenFulfillment($id: ID!) {\n    reopenFulfillment(id: $id) {\n      \n  __typename\n  ... on WarehouseFulfillment {\n    \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
-export declare const PACK_FULFILLMENT_MUTATION = "\n  mutation PackFulfillment($id: ID!, $parcels: [WarehouseParcelInput!]) {\n    packFulfillment(id: $id, parcels: $parcels) {\n      \n  __typename\n  ... on WarehouseFulfillment {\n    \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
-export declare const BOOK_FULFILLMENT_MUTATION = "\n  mutation BookFulfillment($id: ID!) {\n    bookFulfillment(id: $id) {\n      \n  __typename\n  ... on WarehouseFulfillment {\n    \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
-export declare const UNBOOK_FULFILLMENT_MUTATION = "\n  mutation UnbookFulfillment($id: ID!) {\n    unbookFulfillment(id: $id) {\n      \n  __typename\n  ... on WarehouseFulfillment {\n    \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
-export declare const SET_FULFILLMENT_HANDLER_MUTATION = "\n  mutation SetFulfillmentHandler(\n    $id: ID!\n    $handlerCode: String!\n    $handlerArgs: [WarehouseHandlerArgInput!]\n  ) {\n    setFulfillmentHandler(id: $id, handlerCode: $handlerCode, handlerArgs: $handlerArgs) {\n      \n  __typename\n  ... on WarehouseFulfillment {\n    \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
-export declare const SET_FULFILLMENT_WAREHOUSE_MUTATION = "\n  mutation SetFulfillmentWarehouse($id: ID!, $stockLocationId: ID!) {\n    setFulfillmentWarehouse(id: $id, stockLocationId: $stockLocationId) {\n      \n  __typename\n  ... on WarehouseFulfillment {\n    \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
-export declare const CORRECT_FULFILLMENT_QUANTITIES_MUTATION = "\n  mutation CorrectFulfillmentQuantities(\n    $fulfillmentId: ID!\n    $lines: [WarehouseQuantityCorrectionLineInput!]!\n    $disposition: FulfillmentUnitDisposition!\n    $reason: String\n  ) {\n    correctFulfillmentQuantities(\n      fulfillmentId: $fulfillmentId\n      lines: $lines\n      disposition: $disposition\n      reason: $reason\n    ) {\n      \n  __typename\n  ... on WarehouseFulfillment {\n    \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
-export declare const SHIP_FULFILLMENTS_MUTATION = "\n  mutation ShipFulfillments($ids: [ID!]!, $trackingCode: String) {\n    shipFulfillments(ids: $ids, trackingCode: $trackingCode) {\n      \n  __typename\n  ... on WarehouseBulkResult {\n    succeeded\n    failed\n    results {\n      fulfillmentId\n      fulfillment {\n        \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n      }\n      error {\n        code\n        message\n        field\n      }\n    }\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
-export declare const DELIVER_FULFILLMENTS_MUTATION = "\n  mutation DeliverFulfillments($ids: [ID!]!) {\n    deliverFulfillments(ids: $ids) {\n      \n  __typename\n  ... on WarehouseBulkResult {\n    succeeded\n    failed\n    results {\n      fulfillmentId\n      fulfillment {\n        \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n      }\n      error {\n        code\n        message\n        field\n      }\n    }\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
-export declare const APPEND_TO_FULFILLMENT_MUTATION = "\n  mutation AppendToFulfillment(\n    $id: ID!\n    $lines: [WarehouseFulfillmentLineInput!]!\n    $idempotencyKey: String\n  ) {\n    appendToFulfillment(id: $id, lines: $lines, idempotencyKey: $idempotencyKey) {\n      \n  __typename\n  ... on WarehouseFulfillment {\n    \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
-export declare const DETACH_ORDER_FROM_FULFILLMENT_MUTATION = "\n  mutation DetachOrderFromFulfillment($id: ID!, $orderId: ID!) {\n    detachOrderFromFulfillment(id: $id, orderId: $orderId) {\n      \n  __typename\n  ... on WarehouseFulfillment {\n    \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
+export declare const CLAIM_FULFILLMENT_MUTATION = "\n  mutation ClaimFulfillment($id: ID!) {\n    claimFulfillment(id: $id) {\n      \n  __typename\n  ... on WarehouseFulfillment {\n    \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  dropShipSupplierName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
+export declare const UNCLAIM_FULFILLMENT_MUTATION = "\n  mutation UnclaimFulfillment($id: ID!) {\n    unclaimFulfillment(id: $id) {\n      \n  __typename\n  ... on WarehouseFulfillment {\n    \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  dropShipSupplierName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
+export declare const REOPEN_FULFILLMENT_MUTATION = "\n  mutation ReopenFulfillment($id: ID!) {\n    reopenFulfillment(id: $id) {\n      \n  __typename\n  ... on WarehouseFulfillment {\n    \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  dropShipSupplierName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
+export declare const PACK_FULFILLMENT_MUTATION = "\n  mutation PackFulfillment($id: ID!, $parcels: [WarehouseParcelInput!]) {\n    packFulfillment(id: $id, parcels: $parcels) {\n      \n  __typename\n  ... on WarehouseFulfillment {\n    \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  dropShipSupplierName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
+export declare const BOOK_FULFILLMENT_MUTATION = "\n  mutation BookFulfillment($id: ID!) {\n    bookFulfillment(id: $id) {\n      \n  __typename\n  ... on WarehouseFulfillment {\n    \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  dropShipSupplierName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
+export declare const UNBOOK_FULFILLMENT_MUTATION = "\n  mutation UnbookFulfillment($id: ID!) {\n    unbookFulfillment(id: $id) {\n      \n  __typename\n  ... on WarehouseFulfillment {\n    \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  dropShipSupplierName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
+export declare const SET_FULFILLMENT_HANDLER_MUTATION = "\n  mutation SetFulfillmentHandler(\n    $id: ID!\n    $handlerCode: String!\n    $handlerArgs: [WarehouseHandlerArgInput!]\n  ) {\n    setFulfillmentHandler(id: $id, handlerCode: $handlerCode, handlerArgs: $handlerArgs) {\n      \n  __typename\n  ... on WarehouseFulfillment {\n    \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  dropShipSupplierName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
+export declare const SET_FULFILLMENT_WAREHOUSE_MUTATION = "\n  mutation SetFulfillmentWarehouse($id: ID!, $stockLocationId: ID!) {\n    setFulfillmentWarehouse(id: $id, stockLocationId: $stockLocationId) {\n      \n  __typename\n  ... on WarehouseFulfillment {\n    \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  dropShipSupplierName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
+export declare const CORRECT_FULFILLMENT_QUANTITIES_MUTATION = "\n  mutation CorrectFulfillmentQuantities(\n    $fulfillmentId: ID!\n    $lines: [WarehouseQuantityCorrectionLineInput!]!\n    $disposition: FulfillmentUnitDisposition!\n    $reason: String\n  ) {\n    correctFulfillmentQuantities(\n      fulfillmentId: $fulfillmentId\n      lines: $lines\n      disposition: $disposition\n      reason: $reason\n    ) {\n      \n  __typename\n  ... on WarehouseFulfillment {\n    \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  dropShipSupplierName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
+export declare const SHIP_FULFILLMENTS_MUTATION = "\n  mutation ShipFulfillments($ids: [ID!]!, $trackingCode: String) {\n    shipFulfillments(ids: $ids, trackingCode: $trackingCode) {\n      \n  __typename\n  ... on WarehouseBulkResult {\n    succeeded\n    failed\n    results {\n      fulfillmentId\n      fulfillment {\n        \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  dropShipSupplierName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n      }\n      error {\n        code\n        message\n        field\n      }\n    }\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
+export declare const DELIVER_FULFILLMENTS_MUTATION = "\n  mutation DeliverFulfillments($ids: [ID!]!) {\n    deliverFulfillments(ids: $ids) {\n      \n  __typename\n  ... on WarehouseBulkResult {\n    succeeded\n    failed\n    results {\n      fulfillmentId\n      fulfillment {\n        \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  dropShipSupplierName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n      }\n      error {\n        code\n        message\n        field\n      }\n    }\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
+export declare const APPEND_TO_FULFILLMENT_MUTATION = "\n  mutation AppendToFulfillment(\n    $id: ID!\n    $lines: [WarehouseFulfillmentLineInput!]!\n    $idempotencyKey: String\n  ) {\n    appendToFulfillment(id: $id, lines: $lines, idempotencyKey: $idempotencyKey) {\n      \n  __typename\n  ... on WarehouseFulfillment {\n    \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  dropShipSupplierName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
+export declare const DETACH_ORDER_FROM_FULFILLMENT_MUTATION = "\n  mutation DetachOrderFromFulfillment($id: ID!, $orderId: ID!) {\n    detachOrderFromFulfillment(id: $id, orderId: $orderId) {\n      \n  __typename\n  ... on WarehouseFulfillment {\n    \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  dropShipSupplierName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n  }\n  \n  ... on WarehouseError {\n    errorCode\n    code\n    message\n    field\n  }\n\n\n    }\n  }\n";
 /** The key a caller retries under, on an error of a call whose key it did not choose. */
 export declare function withAttemptKey(error: unknown, key: string): unknown;
 export interface RawRefusal {
@@ -721,4 +727,10 @@ export type RawFulfillment = WarehouseFulfillment & {
 };
 export declare function toFulfillment(raw: RawFulfillment): WarehouseFulfillment;
 export declare function toRefusal(raw: RawRefusal | null | undefined): WarehouseRefusal | null;
-export declare function createWarehouseFulfillmentsModule(transport: Transport): WarehouseFulfillmentsModule;
+/**
+ * The transport, sending a document that names `dropShipSupplierName` once more without it when the
+ * engine refused it as unknown (an engine before purchase-orders step 5.5): the field then reads
+ * null. Safe for a mutation too: a refused document never ran.
+ */
+export declare function dropShipSupplierAware(transport: Transport): Transport;
+export declare function createWarehouseFulfillmentsModule(engineTransport: Transport): WarehouseFulfillmentsModule;

package/dist/fulfillments/warehouse.js

@@ -48,6 +48,7 @@
  * `orders.drafts.place` does).
  */
 import { errorFromGraphQLErrors, idempotencyKey as mintIdempotencyKey, pageFromVendureList, readOffsetCursor, ValidationError, } from '@sixtyninecommerce/core';
+import { isUnknownFieldRejection } from '../payments/store-credit-fields.js';
 /** The most fulfillments one `ship`, `deliver` or `pickList` call takes. */
 export const MAX_WAREHOUSE_BULK_IDS = 100;
 const ADDRESS_FIELDS = /* GraphQL */ `
@@ -74,6 +75,7 @@ export const FULFILLMENT_FIELDS = /* GraphQL */ `
   trackingCode
   stockLocationId
   stockLocationName
+  dropShipSupplierName
   createdAt
   stateChangedAt
   overdue
@@ -552,6 +554,7 @@ export function toFulfillment(raw) {
         trackingCode: raw.trackingCode ?? null,
         stockLocationId: raw.stockLocationId ?? null,
         stockLocationName: raw.stockLocationName ?? null,
+        dropShipSupplierName: raw.dropShipSupplierName ?? null,
         createdAt: raw.createdAt,
         stateChangedAt: raw.stateChangedAt ?? null,
         overdue: raw.overdue,
@@ -653,7 +656,35 @@ function bulkOrThrow(result) {
     };
 }
 const DEFAULT_TAKE = 50;
-export function createWarehouseFulfillmentsModule(transport) {
+/**
+ * The transport, sending a document that names `dropShipSupplierName` once more without it when the
+ * engine refused it as unknown (an engine before purchase-orders step 5.5): the field then reads
+ * null. Safe for a mutation too: a refused document never ran.
+ */
+export function dropShipSupplierAware(transport) {
+    return {
+        async graphql(call, options) {
+            try {
+                return await transport.graphql(call, options);
+            }
+            catch (error) {
+                const legacy = call.query.replace(/\bdropShipSupplierName\b/g, '');
+                if (legacy === call.query || !isUnknownFieldRejection(error))
+                    throw error;
+                return transport.graphql({ ...call, query: legacy }, options);
+            }
+        },
+        // Delegated one by one: a transport is a class instance, whose members a spread would drop.
+        rest: (service, call, options) => transport.rest(service, call, options),
+        get rateLimit() {
+            return transport.rateLimit;
+        },
+        tenant: () => transport.tenant(),
+        channel: () => transport.channel(),
+    };
+}
+export function createWarehouseFulfillmentsModule(engineTransport) {
+    const transport = dropShipSupplierAware(engineTransport);
     const single = async (query, field, variables, options) => {
         const data = await transport.graphql({ api: 'admin', query, variables }, options);
         return fulfillmentOrThrow(data[field]);

package/dist/index.d.ts

@@ -212,13 +212,14 @@ export type { PosReportCashier, PosReportCashierActivity, PosReportCashiers, Pos
 export { POS_REPORT_PRODUCTS_DEFAULT_PAGE, POS_REPORT_PRODUCTS_MAX_PAGE, } from './pos/reports.js';
 export type { PosOnlineOrder, PosOnlineOrderRef, PosOnlineReturnInput, PosOnlineReturnQuote, PosReturnCreateInput, PosReturnKind, PosReturnLeg, PosReturnLineInput, PosReturnPayout, PosReturnQuote, PosReturnQuoteInput, PosReturnQuoteLine, PosReturnRefund, PosReturnResult, PosReturnStoredValueCredit, PosReturnStoredValuePayout, PosReturnsModule, PosVoidInput, } from './pos/returns.js';
 export type { BulkCouponCode, BulkCouponGroup, GenerateBulkCouponsInput, PricingBulkCouponsModule, } from './pricing/bulk-coupons.js';
+export type { PricingExchangeRatesModule, StoreExchangeRate, StoreExchangeRateSource, } from './pricing/exchange-rates.js';
 export type { ActivePromotion, ActivePromotionsFilter, CreatePromotionInput, DiscountedOrderLine, LocalTime, OrderDiscount, OrderDiscounts, OrderPackage, PricingCouponsModule, PricingModule, PricingPromotion, PricingPromotionsModule, PromotionDetail, PromotionListItem, PromotionListOptions, PromotionOperationSummary, PromotionSortField, PromotionTranslationInput, SetComponent, UpdatePromotionInput, Weekday, } from './pricing/index.js';
 export { PROMOTION_SORT_FIELDS, promotionActions, promotionConditions, } from './pricing/index.js';
 export { type AssignPriceListTarget, type CreatePriceListInput, type CustomerPriceList, type CustomerPriceListAssignmentType, type CustomerPriceListsOptions, MAX_BULK_PRICE_LISTS, MAX_CUSTOMER_PRICE_LIST_ENTRIES, MAX_PRICE_LIST_ENTRY_EXPORT, MAX_PRICE_LIST_ENTRY_TAKE, MAX_PRICE_LIST_LIST_TAKE, PRICE_LIST_BULK_ACTIONS, PRICE_LIST_ENTRY_SEARCH_MODES, PRICE_LIST_SEARCH_MIN_TERM_LENGTH, PRICE_LIST_SEARCH_MODES, type PriceList, type PriceListAssignedTo, type PriceListAssignment, type PriceListAssignmentCustomer, type PriceListAssignmentGroup, type PriceListAssignmentRef, type PriceListBulkAction, type PriceListBulkInput, type PriceListBulkOutcome, type PriceListDiscountType, type PriceListEntry, type PriceListEntryFacetCount, type PriceListEntryFacets, type PriceListEntryFilter, type PriceListEntryListOptions, type PriceListEntrySearchMode, type PriceListEntryWrite, type PriceListFields, type PriceListListItem, type PriceListListOptions, type PriceListMinOrderAmountBasis, type PriceListOrderRule, type PriceListOrderRuleConditionType, type PriceListOrderRuleDiscountType, type PriceListSearchMatch, type PriceListSearchMode, type PriceListTargetType, type PricingPriceListEntriesModule, type PricingPriceListOrderRulesModule, type PricingPriceListsModule, type SetPriceListEntryInput, type SetPriceListOrderRuleInput, type UpdatePriceListInput, } from './pricing/price-lists.js';
 export type { IssuedVoucher, IssueVoucherInput, IssueVouchersInput, IssueVouchersItem, PricingVouchersModule, Voucher, VoucherCustomer, VoucherStatus, VoucherTemplate, } from './pricing/vouchers.js';
 export type { EntityProvenance, ProvenanceActor, ProvenanceEntityType, ProvenanceFieldGroup, ProvenanceManagedBy, ProvenanceModule, } from './provenance/index.js';
 export { PROVENANCE_MAX_IDS } from './provenance/index.js';
-export type { AddGoodsReceiptChargeInput, BackorderReadyLine, BackordersReadyOptions, BackToBackLinkQuantities, BackToBackLinkResult, CreateBackToBackLinkInput, CreatePurchaseOrderInput, CreateSupplierContactInput, CreateSupplierInput, CreateSupplierReturnInput, DropShipShipmentFulfillment, DropShipShipmentResult, GoodsReceipt, GoodsReceiptChargesModule, GoodsReceiptDetail, GoodsReceiptKeyedCall, GoodsReceiptKind, GoodsReceiptLine, GoodsReceiptListOptions, GoodsReceiptReference, GoodsReceiptTraceability, GoodsReceiptTraceabilityInput, LandedCharge, LandedChargeAllocation, LandedChargeAllocationBasis, LandedChargeKind, OverrideVariantCostInput, PostGoodsReceiptInput, PostGoodsReceiptLineInput, PurchaseOrder, PurchaseOrderCancelOptions, PurchaseOrderConfirmation, PurchaseOrderConfirmationInput, PurchaseOrderDocumentOptions, PurchaseOrderDocumentUrl, PurchaseOrderDropShip, PurchaseOrderDropShipLine, PurchaseOrderHeaderFields, PurchaseOrderKeyedCall, PurchaseOrderLine, PurchaseOrderLineConfirmationInput, PurchaseOrderLineImportOptions, PurchaseOrderLineImportResult, PurchaseOrderLineImportRow, PurchaseOrderLineInput, PurchaseOrderLinesModule, PurchaseOrderLink, PurchaseOrderLinkKind, PurchaseOrderLinkReleaseReason, PurchaseOrderLinkStatus, PurchaseOrderListOptions, PurchaseOrderLocation, PurchaseOrderReasonOptions, PurchaseOrderRevision, PurchaseOrderRevisionInput, PurchaseOrderRevisionsModule, PurchaseOrderSendVia, PurchaseOrderStatus, PurchaseOrderStatusEntry, PurchaseOrderSupplier, PurchasingAlert, PurchasingAlertRecipients, PurchasingAlertRecipientsInput, PurchasingAlertRecipientsModule, PurchasingAlertSummary, PurchasingAlertsModule, PurchasingBackordersModule, PurchasingBackToBackLinksModule, PurchasingCostModule, PurchasingDropShipLinksModule, PurchasingLinksModule, PurchasingModule, PurchasingNumbering, PurchasingNumberingKind, PurchasingNumberingModule, PurchasingPurchaseOrdersModule, PurchasingReceiptsModule, PurchasingReplenishmentModule, PurchasingReturnsModule, PurchasingSettings, PurchasingSettingsModule, PurchasingSuppliersModule, ReceivablePurchaseOrderLine, ReceivablePurchaseOrderLinesOptions, RecordDropShipShipmentInput, RemoveGoodsReceiptChargeInput, ReplenishmentComputeResult, ReplenishmentDraftLine, ReplenishmentDrafts, ReplenishmentLocation, ReplenishmentRule, ReplenishmentRuleFields, ReplenishmentRuleImportInput, ReplenishmentRuleImportResult, ReplenishmentRuleImportRow, ReplenishmentRuleListOptions, ReplenishmentRulesModule, ReplenishmentSuggestion, ReplenishmentSuggestionListOptions, ReplenishmentSuggestionsModule, ReplenishmentSupplier, ReplenishmentVariant, ResolveSupplierReturnLineInput, ReverseGoodsReceiptInput, ShipSupplierReturnInput, Supplier, SupplierAddress, SupplierAddressInput, SupplierContact, SupplierContactFields, SupplierContactsModule, SupplierFields, SupplierItem, SupplierItemFields, SupplierItemImportResult, SupplierItemImportRowResult, SupplierItemListOptions, SupplierItemPrice, SupplierItemPriceInput, SupplierItemPricesModule, SupplierItemPricesOptions, SupplierItemRow, SupplierItemSupplier, SupplierItemsBulkUpsertInput, SupplierItemsModule, SupplierItemVariant, SupplierListOptions, SupplierPriceListImportInput, SupplierReturn, SupplierReturnCancelOptions, SupplierReturnDocumentUrl, SupplierReturnKeyedCall, SupplierReturnLine, SupplierReturnLineInput, SupplierReturnListOptions, SupplierReturnOrigin, SupplierReturnOutcome, SupplierReturnResolution, SupplierReturnStatus, SupplierReturnStatusEntry, SupplierStatusOptions, UpdatePurchaseOrderInput, UpdatePurchaseOrderLineInput, UpdatePurchasingNumberingInput, UpdatePurchasingSettingsInput, UpdateSupplierContactInput, UpdateSupplierInput, UpdateSupplierReturnInput, VariantCost, VariantCostCause, VariantCostEntry, VariantCostEntryList, VariantCostHistoryOptions, } from './purchasing/index.js';
+export type { AddGoodsReceiptChargeInput, BackorderReadyLine, BackordersReadyOptions, BackToBackLinkQuantities, BackToBackLinkResult, CreateBackToBackLinkInput, CreatePurchaseOrderInput, CreateSupplierContactInput, CreateSupplierInput, CreateSupplierReturnInput, DropShipShipmentFulfillment, DropShipShipmentResult, GoodsReceipt, GoodsReceiptChargesModule, GoodsReceiptDetail, GoodsReceiptKeyedCall, GoodsReceiptKind, GoodsReceiptLine, GoodsReceiptListOptions, GoodsReceiptReference, GoodsReceiptTraceability, GoodsReceiptTraceabilityInput, LandedCharge, LandedChargeAllocation, LandedChargeAllocationBasis, LandedChargeKind, OverrideVariantCostInput, PostGoodsReceiptInput, PostGoodsReceiptLineInput, PurchaseOrder, PurchaseOrderCancelOptions, PurchaseOrderConfirmation, PurchaseOrderConfirmationInput, PurchaseOrderDocumentOptions, PurchaseOrderDocumentUrl, PurchaseOrderDropShip, PurchaseOrderDropShipLine, PurchaseOrderHeaderFields, PurchaseOrderKeyedCall, PurchaseOrderLine, PurchaseOrderLineConfirmationInput, PurchaseOrderLineImportOptions, PurchaseOrderLineImportResult, PurchaseOrderLineImportRow, PurchaseOrderLineInput, PurchaseOrderLinesModule, PurchaseOrderLink, PurchaseOrderLinkKind, PurchaseOrderLinkReleaseReason, PurchaseOrderLinkStatus, PurchaseOrderListOptions, PurchaseOrderLocation, PurchaseOrderReasonOptions, PurchaseOrderRevision, PurchaseOrderRevisionInput, PurchaseOrderRevisionsModule, PurchaseOrderSendCall, PurchaseOrderSendVia, PurchaseOrderStatus, PurchaseOrderStatusEntry, PurchaseOrderSupplier, PurchasingAlert, PurchasingAlertRecipients, PurchasingAlertRecipientsInput, PurchasingAlertRecipientsModule, PurchasingAlertSummary, PurchasingAlertsModule, PurchasingBackordersModule, PurchasingBackToBackLinksModule, PurchasingCostModule, PurchasingDropShipLinksModule, PurchasingLinksModule, PurchasingModule, PurchasingNumbering, PurchasingNumberingKind, PurchasingNumberingModule, PurchasingPurchaseOrdersModule, PurchasingReceiptsModule, PurchasingReplenishmentModule, PurchasingReturnsModule, PurchasingSettings, PurchasingSettingsModule, PurchasingSuppliersModule, ReceivablePurchaseOrderLine, ReceivablePurchaseOrderLinesOptions, RecordDropShipShipmentInput, RemoveGoodsReceiptChargeInput, ReplenishmentComputeResult, ReplenishmentDraftLine, ReplenishmentDrafts, ReplenishmentLocation, ReplenishmentRule, ReplenishmentRuleFields, ReplenishmentRuleImportInput, ReplenishmentRuleImportResult, ReplenishmentRuleImportRow, ReplenishmentRuleListOptions, ReplenishmentRulesModule, ReplenishmentSuggestion, ReplenishmentSuggestionListOptions, ReplenishmentSuggestionsModule, ReplenishmentSupplier, ReplenishmentVariant, ResolveSupplierReturnLineInput, ReverseGoodsReceiptInput, ShipSupplierReturnInput, Supplier, SupplierAddress, SupplierAddressInput, SupplierContact, SupplierContactFields, SupplierContactsModule, SupplierFields, SupplierItem, SupplierItemFields, SupplierItemImportResult, SupplierItemImportRowResult, SupplierItemListOptions, SupplierItemPrice, SupplierItemPriceInput, SupplierItemPricesModule, SupplierItemPricesOptions, SupplierItemRow, SupplierItemSupplier, SupplierItemsBulkUpsertInput, SupplierItemsModule, SupplierItemVariant, SupplierListOptions, SupplierPriceListImportInput, SupplierReturn, SupplierReturnCancelOptions, SupplierReturnDocumentUrl, SupplierReturnKeyedCall, SupplierReturnLine, SupplierReturnLineInput, SupplierReturnListOptions, SupplierReturnOrigin, SupplierReturnOutcome, SupplierReturnResolution, SupplierReturnStatus, SupplierReturnStatusEntry, SupplierStatusOptions, UpdatePurchaseOrderInput, UpdatePurchaseOrderLineInput, UpdatePurchasingNumberingInput, UpdatePurchasingSettingsInput, UpdateSupplierContactInput, UpdateSupplierInput, UpdateSupplierReturnInput, VariantCost, VariantCostCause, VariantCostEntry, VariantCostEntryList, VariantCostHistoryOptions, } from './purchasing/index.js';
 export type { AddQuoteLineInput, ConvertedQuoteOrder, CreateDraftQuoteInput, ExtendQuoteValidityInput, KeyedQuoteCall, Quote, QuoteConfig, QuoteConfigModule, QuoteDocument, QuoteLine, QuoteLineDiscountType, QuoteLinesModule, QuoteLineVariant, QuoteList, QuoteListOptions, QuoteSalesRepresentative, QuoteSettings, QuoteSettingsModule, QuoteStatus, QuoteStatusLogEntry, QuotesModule, SetQuotePricingInput, UpdateQuoteConfigInput, UpdateQuoteLineInput, } from './quotes/index.js';
 export { QUOTE_STATUSES } from './quotes/index.js';
 export type { ArAgingRow, LowStockInput, LowStockVariant, PopularVariant, PopularVariantsInput, ReportDay, ReportExport, ReportExportFilter, ReportExportKind, ReportLastDays, ReportOverview, ReportOverviewInput, ReportPeriod, ReportsModule, ReportTotals, } from './reports/index.js';

package/dist/pricing/exchange-rates.d.ts

@@ -0,0 +1,91 @@
+import { type Transport } from '@sixtyninecommerce/core';
+import type { Call } from '../types.js';
+/** Where a currency's effective rate comes from. */
+export type StoreExchangeRateSource = 'OVERRIDE' | 'SYNCED' | 'NONE';
+/**
+ * One currency the active store sells besides its default, as the engine reads it.
+ *
+ * Every rate is FROM the store's default currency TO `currencyCode` (1 unit of the default buys
+ * `rate` units of the currency), written as an exact decimal STRING, never a float. Parse it only
+ * to convert: `Number(effectiveRate)` is exactly the number the engine converts with. On a store
+ * whose default is EUR an override or a synced rate comes back as stored; on any other store a
+ * rate is the converters' cross rate, the shortest string that reads back as that number, so it
+ * may carry up to 17 significant digits (an override `"1.47"` can read `"1.4700000000000002"`).
+ */
+export interface StoreExchangeRate {
+    /** ISO 4217, upper case. */
+    currencyCode: string;
+    /**
+     * The store's default currency every rate of this row is quoted FROM. A client that keeps rows
+     * (a cache) prices only with a row quoted from the default it prices from now: after the store's
+     * default changes, an older row is no rate.
+     */
+    fromCurrencyCode: string;
+    /** The synced market rate; null when the feed has none for this currency or the default. */
+    syncedRate: string | null;
+    /** The store's override as stored, whether or not it applies; null when none is stored. */
+    override: string | null;
+    /**
+     * The stored override is what this currency converts at. False for an override written before
+     * the write rule that is not a usable rate, and for EUR (the base every rate is quoted against,
+     * never overridden): those convert at the synced rate. False too for every override on a store
+     * whose default currency has no synced rate: the engine cannot convert there at all
+     * (`effectiveRate` null).
+     */
+    honoured: boolean;
+    /**
+     * The rate this currency converts at TODAY, everywhere the store converts money (prices,
+     * checkout, minimums, shipping, promotions, feeds), read from the converters themselves: from
+     * the honoured override, else the synced rate; null when the store cannot convert the currency.
+     * A placed order keeps the rate it was placed at.
+     */
+    effectiveRate: string | null;
+    source: StoreExchangeRateSource;
+    /** ISO-8601 UTC as-of of the synced rate (the older of its two legs for a cross rate). */
+    rateDate: string | null;
+    /** The synced rate's provider (`ecb`, `fixer`, …). */
+    provider: string | null;
+}
+/**
+ * The ACTIVE store's exchange rates (`admin.pricing.exchangeRates`). Reading needs staff access
+ * to the store (any permission there); writing needs `UpdateChannel` (overrides are stored on the
+ * channel and written through core `updateChannel`).
+ *
+ * The engine owns the rule: which override applies and what rate a currency converts at are never
+ * worked out in the client.
+ */
+export interface PricingExchangeRatesModule {
+    /**
+     * One row per currency the store sells besides its default, in the store's own order.
+     *
+     * @effect read
+     */
+    list(options?: Call): Promise<StoreExchangeRate[]>;
+    /**
+     * Replace ALL of the store's overrides with `overrides` (currency code → rate), and answer the
+     * rates as the engine now reads them. An empty map clears every override. Read with
+     * {@link list}, change what you mean to, send the whole map back.
+     *
+     * An override changes what customers are charged in that currency from the moment it is saved.
+     *
+     * Refused, with nothing written, `EXCHANGE_RATE_OVERRIDE_INVALID` (`ValidationError`, 400), one
+     * `details[]` entry per refused currency, `field` = `exchangeRateOverrides.<CODE>` and `code`
+     * one of:
+     * - `INVALID_RATE`: not a positive decimal written with a dot and at most 8 decimals
+     *   (`"1.2500"`; never `1e2`, `-1`, `0`);
+     * - `INVALID_CURRENCY_CODE`: not a three-letter upper-case code;
+     * - `NOT_OFFERED`: a currency the store does not sell;
+     * - `DEFAULT_CURRENCY`: the store's default (every rate is quoted from it);
+     * - `BASE_CURRENCY`: EUR, the base every rate is quoted against.
+     *
+     * `FORBIDDEN` without `UpdateChannel`.
+     *
+     * @effect money
+     */
+    setOverrides(overrides: Readonly<Record<string, string>>, options?: Call): Promise<StoreExchangeRate[]>;
+}
+export declare const STORE_EXCHANGE_RATES_QUERY = "\n  query StoreExchangeRates {\n    storeExchangeRates {\n      currencyCode\n      fromCurrencyCode\n      syncedRate\n      override\n      honoured\n      effectiveRate\n      source\n      rateDate\n      provider\n    }\n  }\n";
+/** The save's first step: the channel `updateChannel` must be given, in the save's own call. */
+export declare const EXCHANGE_RATE_OVERRIDES_TARGET_QUERY = "\n  query ExchangeRateOverridesTarget {\n    activeChannel { id }\n  }\n";
+export declare const SET_EXCHANGE_RATE_OVERRIDES_MUTATION = "\n  mutation SetExchangeRateOverrides($input: UpdateChannelInput!) {\n    updateChannel(input: $input) {\n      ... on Channel { id }\n      ... on ErrorResult { errorCode message }\n    }\n  }\n";
+export declare function createPricingExchangeRatesModule(transport: Transport): PricingExchangeRatesModule;

package/dist/pricing/exchange-rates.js

@@ -0,0 +1,60 @@
+import { errorFromErrorResult, isErrorResult, } from '@sixtyninecommerce/core';
+export const STORE_EXCHANGE_RATES_QUERY = /* GraphQL */ `
+  query StoreExchangeRates {
+    storeExchangeRates {
+      currencyCode
+      fromCurrencyCode
+      syncedRate
+      override
+      honoured
+      effectiveRate
+      source
+      rateDate
+      provider
+    }
+  }
+`;
+/** The save's first step: the channel `updateChannel` must be given, in the save's own call. */
+export const EXCHANGE_RATE_OVERRIDES_TARGET_QUERY = /* GraphQL */ `
+  query ExchangeRateOverridesTarget {
+    activeChannel { id }
+  }
+`;
+export const SET_EXCHANGE_RATE_OVERRIDES_MUTATION = /* GraphQL */ `
+  mutation SetExchangeRateOverrides($input: UpdateChannelInput!) {
+    updateChannel(input: $input) {
+      ... on Channel { id }
+      ... on ErrorResult { errorCode message }
+    }
+  }
+`;
+export function createPricingExchangeRatesModule(transport) {
+    const list = async (options) => {
+        const data = await transport.graphql({ api: 'admin', query: STORE_EXCHANGE_RATES_QUERY }, options);
+        return data.storeExchangeRates;
+    };
+    return {
+        list,
+        async setOverrides(overrides, options) {
+            // Sent as given: the engine judges every entry and names each one it refuses.
+            const entries = Object.entries(overrides);
+            const target = await transport.graphql({ api: 'admin', query: EXCHANGE_RATE_OVERRIDES_TARGET_QUERY }, options);
+            const data = await transport.graphql({
+                api: 'admin',
+                query: SET_EXCHANGE_RATE_OVERRIDES_MUTATION,
+                variables: {
+                    input: {
+                        id: target.activeChannel.id,
+                        customFields: {
+                            // `null` is the column's "none"; the engine reads `{}` the same way.
+                            exchangeRateOverrides: entries.length === 0 ? null : JSON.stringify(Object.fromEntries(entries)),
+                        },
+                    },
+                },
+            }, options);
+            if (isErrorResult(data.updateChannel))
+                throw errorFromErrorResult(data.updateChannel);
+            return list(options);
+        },
+    };
+}

package/dist/pricing/index.d.ts

@@ -2,6 +2,7 @@ import { type Page, type Transport } from '@sixtyninecommerce/core';
 import { type ConfigurableOperation, type ConfigurableOperationInput, type LanguageCode } from '../catalog/types.js';
 import type { Call, ConfigurableOperationDefinition, ListOptions } from '../types.js';
 import { type PricingBulkCouponsModule } from './bulk-coupons.js';
+import { type PricingExchangeRatesModule } from './exchange-rates.js';
 import { type PricingPriceListsModule } from './price-lists.js';
 import { type PricingVouchersModule } from './vouchers.js';
 /**
@@ -43,6 +44,11 @@ export interface PricingModule {
      * bulk enable/disable/delete (`./price-lists.ts`).
      */
     priceLists: PricingPriceListsModule;
+    /**
+     * The store's exchange rates and its overrides, as the engine reads them
+     * (`./exchange-rates.ts`).
+     */
+    exchangeRates: PricingExchangeRatesModule;
     /**
      * The order's discounts as they stand: its coupon codes, the order-level
      * discounts, and each line's discounts, every one naming the promotion it came