@sixtyninecommerce/admin 0.11.0 → 0.13.0

package/dist/fulfillments/index.d.ts

@@ -1,4 +1,4 @@
-import { type Transport } from '@sixtyninecommerce/core';
+import { type PlatformError, type Transport } from '@sixtyninecommerce/core';
 import type { OrderOverpaymentChoice, OverpaymentOption } from '../orders/surcharges.js';
 import type { Call } from '../types.js';
 import { type FulfillmentCreateMethods } from './create.js';
@@ -182,6 +182,15 @@ export interface FulfillmentCancelPreview {
 export interface FulfillmentCancelChoice {
     orderId: string;
     choice: OrderOverpaymentChoice;
+    /**
+     * With `ACCOUNT_CREDIT` in a store whose book is store credit (`cancelPreview`'s
+     * `accountCredit.book` `STORE_CREDIT`): whether THIS order's customer expressly agreed to store
+     * credit instead of a refund to their payment (EU consumer law, CRD art. 13(1)), as staff
+     * recorded it. The settlement's move records it on its ledger entries
+     * (`StoredValueEntry.customerAgreed`); never a condition, nothing is refused for it. Sent only
+     * when given; an engine before the field (incentives sprint 8 PR 6a) refuses a call that gives it.
+     */
+    customerAgreed?: boolean;
 }
 /** What `cancel` sends besides the fulfillment. */
 export interface CancelFulfillmentInput {
@@ -265,6 +274,35 @@ export interface OrderFulfillmentCoverage {
 }
 /** The longest override reason the engine stores. */
 export declare const FULFILLMENT_COVERAGE_REASON_MAX_LENGTH = 500;
+/** A fulfillment as `transition` leaves it. */
+export interface FulfillmentStateChange {
+    id: string;
+    /** The state it is in now (`Shipped`, `Delivered`, …). */
+    state: string;
+    /** The states it may move to next, as the store's fulfillment process allows. */
+    nextStates: string[];
+}
+/**
+ * The facts a refused `transition` carries on `PlatformError.extensions`, beside its code:
+ * the move that was asked for and the refusing step's own words.
+ */
+export interface FulfillmentTransitionRefusalFacts {
+    /** Core's code for every refused move: `FULFILLMENT_STATE_TRANSITION_ERROR`. */
+    errorCode: string;
+    fromState: string;
+    toState: string;
+    /** The refusing step's text, `[CODE]` prefix included when it had one. */
+    transitionError: string;
+}
+/**
+ * What re-sending a fulfillment's label to the store's 3PL came to (`resendLabelHandoff`):
+ * - `QUEUED`: the email with the label is queued for the 3PL recipient;
+ * - `NOT_READY`: the fulfillment has no ready MyParcel label yet, so nothing was sent;
+ * - `DISABLED`: the store has the label hand-off notification switched off;
+ * - `NO_RECIPIENT`: it is on, but names no recipient;
+ * - `UNAVAILABLE`: the platform's email delivery is not installed.
+ */
+export type LabelHandoffOutcome = 'QUEUED' | 'DISABLED' | 'NO_RECIPIENT' | 'NOT_READY' | 'UNAVAILABLE';
 /**
  * Fulfillment parcels (multi-parcel shipments). Each method is its own request
  * on purpose: a caller deployed ahead of an engine without these fields sees
@@ -412,6 +450,66 @@ export interface FulfillmentsModule extends FulfillmentCreateMethods {
     allowUncovered(orderId: string, reason: string, options?: Call & {
         idempotencyKey?: string;
     }): Promise<FulfillmentCoverageOverride>;
+    /**
+     * Move a fulfillment to one of its `nextStates` (the order page's "Mark as Shipped" and "Mark as
+     * Delivered"). Needs `UpdateOrder`. The move runs the store's own fulfillment process, so the
+     * order's state follows and whatever the store does on a shipped or delivered fulfillment (its
+     * events, its notifications: the customer gets the shipped e-mail) happens; the process has no
+     * way back to an earlier state. Shipping an order's last open lines moves the ORDER to
+     * `Shipped`, which on a store that pushes orders to its ERP when they ship (Exact Online's
+     * "fulfilled" auto-push) sends the order there, where it cannot be taken back.
+     *
+     * A move into `Cancelled` is a cancel: it ends the fulfillment for good and has its carrier let
+     * go of the shipment, and the delivery charge it added comes off what each of its orders bills.
+     * It is refused, before the carrier is told, while the customer has PAID such a charge
+     * (`FULFILLMENT_CANCEL_OVERPAYMENT_CHOICE_REQUIRED`): {@link FulfillmentsModule.cancel} takes the
+     * choice of how that money goes back. An unpaid charge simply leaves the bill.
+     *
+     * Tagged `money`, its strongest effect: a cancel changes what a placed order bills.
+     *
+     * Refused, with nothing moved:
+     * - a step of the store's process that refuses the move answers ITS OWN code, which the engine
+     *   prefixes to its text as `[CODE]`, with the text after it as the message, classed as the
+     *   warehouse API classes the same code: `ORDER_NOT_COVERED` (the store requires full payment
+     *   and an order is not paid in full: `coverage` reads what it owes, `allowUncovered` records
+     *   an override), `ORDER_ON_HOLD` (release the order's fulfilment hold first),
+     *   `BOOKING_REQUIRED`, `PARCELS_REQUIRED`, `CONSOLIDATION_ADDRESS_DIVERGED`, …;
+     * - any other refusal of the process, an edge it does not have included, is
+     *   `FULFILLMENT_STATE_TRANSITION_ERROR` (`BusinessRuleError`, 422) with the refusing step's
+     *   text as the message;
+     * - both carry {@link FulfillmentTransitionRefusalFacts} on `extensions`;
+     * - another store's or a missing fulfillment is `ENTITY_NOT_FOUND` (`NotFoundError`); a
+     *   credential restricted to stock locations (an API token or app installation with
+     *   `locationIds`) moves only a fulfillment that ships from one of them
+     *   (`LOCATION_OUT_OF_SCOPE`, 422);
+     * - a blank id or state is refused before any request (`FULFILLMENT_TRANSITION_INVALID`,
+     *   `ValidationError`).
+     *
+     * Takes no idempotency key: repeating a move that went through asks for an edge the process no
+     * longer has, and is refused as above, never moved twice.
+     *
+     * @effect money
+     * @permission UpdateOrder
+     */
+    transition(fulfillmentId: string, state: string, options?: Call): Promise<FulfillmentStateChange>;
+    /**
+     * E-mail the fulfillment's ready MyParcel label again to the store's 3PL recipient (the
+     * `fulfillment_label_handoff` notification), whatever the store's automatic hand-off setting.
+     * Answers what came of it ({@link LabelHandoffOutcome}): only `QUEUED` sent anything; the
+     * others say why nothing was sent. Every outcome leaves an audit row. Needs `UpdateOrder`.
+     *
+     * Takes no idempotency key: a repeat sends the e-mail again.
+     *
+     * Refused: another store's or a missing fulfillment is `ENTITY_NOT_FOUND` (`NotFoundError`); a
+     * store without the MyParcel plugin `PLUGIN_ACCESS_DENIED` (`PermissionDeniedError`, 403) for
+     * an ordinary caller; a credential restricted to other stock locations `LOCATION_OUT_OF_SCOPE`
+     * (422). A blank id is refused before any request (`MYPARCEL_LABEL_INPUT_INVALID`,
+     * `ValidationError`).
+     *
+     * @effect irreversible
+     * @permission UpdateOrder
+     */
+    resendLabelHandoff(fulfillmentId: string, options?: Call): Promise<LabelHandoffOutcome>;
     /**
      * The store's fulfilment payment policy (`fulfillmentPaymentPolicy`): whether a fulfilment of
      * an order not paid in full is refused `ORDER_NOT_COVERED`, and which payment methods are
@@ -431,6 +529,12 @@ export interface FulfillmentsModule extends FulfillmentCreateMethods {
 export declare const FULFILLMENT_CANCEL_PREVIEW_QUERY = "\n  query FulfillmentCancelPreview($fulfillmentId: ID!) {\n    fulfillmentCancelPreview(fulfillmentId: $fulfillmentId) {\n      fulfillmentId\n      overpayments {\n        orderId\n        orderCode\n        amount\n        currencyCode\n        refund { \n  available\n  code\n  message\n  book\n }\n        accountCredit { \n  available\n  code\n  message\n  book\n }\n      }\n    }\n  }\n";
 /** `$overpayment` and `$idempotencyKey` are optional and left out of the variables when not given. */
 export declare const CANCEL_FULFILLMENT_MUTATION = "\n  mutation CancelFulfillment(\n    $fulfillmentId: ID!\n    $overpayment: [FulfillmentCancelOverpaymentInput!]\n    $idempotencyKey: String\n  ) {\n    cancelFulfillment(\n      fulfillmentId: $fulfillmentId\n      overpayment: $overpayment\n      idempotencyKey: $idempotencyKey\n    ) {\n      fulfillment {\n        id\n        state\n      }\n      settlements {\n        orderId\n        orderCode\n        amount\n        currencyCode\n        choice\n        book\n      }\n    }\n  }\n";
+/**
+ * The refusal member is selected for its facts: `message` is core's per-code template ("Cannot
+ * transition Fulfillment from X to Y"), and the refusing step's reason is `transitionError` alone.
+ */
+export declare const TRANSITION_FULFILLMENT_MUTATION = "\n  mutation TransitionFulfillment($id: ID!, $state: String!) {\n    transitionFulfillmentToState(id: $id, state: $state) {\n      __typename\n      ... on Fulfillment {\n        id\n        state\n        nextStates\n      }\n      ... on FulfillmentStateTransitionError {\n        errorCode\n        message\n        fromState\n        toState\n        transitionError\n      }\n    }\n  }\n";
+export declare const RESEND_FULFILLMENT_LABEL_HANDOFF_MUTATION = "\n  mutation ResendFulfillmentLabelHandoff($fulfillmentId: ID!) {\n    resendFulfillmentLabelHandoff(fulfillmentId: $fulfillmentId)\n  }\n";
 /** Its own document: on an engine without the query this call alone fails validation. */
 export declare const ORDER_FULFILLMENT_COVERAGE_QUERY = "\n  query OrderFulfillmentCoverage($orderId: ID!) {\n    orderFulfillmentCoverage(orderId: $orderId) {\n      orderId\n      orderCode\n      currencyCode\n      policyActive\n      covered\n      outstanding\n      exempt\n      exemptReason\n      allowed\n      override { \n  id\n  orderId\n  reason\n  actorKind\n  actorId\n  outstandingAtGrant\n  currencyCode\n  createdAt\n  active\n }\n    }\n  }\n";
 /** `$idempotencyKey` is optional and left out of the variables when not given. */
@@ -468,4 +572,18 @@ export declare const MYPARCEL_LABEL_TIMEOUT_MS = 55000;
 export declare function toUnretractedShipments(raw: readonly MyparcelUnretractedShipment[] | null | undefined): MyparcelUnretractedShipment[];
 /** The bytes of a base64 label document (`atob`: no Node `Buffer`, it ships to browsers). */
 export declare function decodeBase64(base64: string): Uint8Array;
+interface RawTransitionRefusal {
+    errorCode: string;
+    message: string;
+    fromState?: string | null;
+    toState?: string | null;
+    transitionError?: string | null;
+}
+/**
+ * A refused move as the coded error it is. Core carries a step's refusal only as text, so the
+ * step's own code is read off its `[CODE]` prefix and classed through the GraphQL dialect, as the
+ * warehouse API's refusals of the same codes are (`warehouseRefusalError`): one code, one class,
+ * whichever door answered it.
+ */
+export declare function fulfillmentTransitionRefusal(result: RawTransitionRefusal): PlatformError;
 export declare function createFulfillmentsModule(transport: Transport): FulfillmentsModule;

package/dist/fulfillments/index.js

@@ -1,4 +1,5 @@
-import { errorFromErrorResult, isErrorResult, NotFoundError, ValidationError, } from '@sixtyninecommerce/core';
+import { errorForStatus, errorFromErrorResult, errorFromGraphQLErrors, isErrorResult, NotFoundError, ValidationError, } from '@sixtyninecommerce/core';
+import { customerAgreedVariable, statedCustomerAgreed } from '../payments/customer-consent.js';
 import { storeCreditAware } from '../payments/store-credit-fields.js';
 import { createFulfillmentCreateMethods } from './create.js';
 import { createFulfillmentPaymentPolicyModule, } from './payment-policy.js';
@@ -58,6 +59,34 @@ export const CANCEL_FULFILLMENT_MUTATION = /* GraphQL */ `
     }
   }
 `;
+/**
+ * The refusal member is selected for its facts: `message` is core's per-code template ("Cannot
+ * transition Fulfillment from X to Y"), and the refusing step's reason is `transitionError` alone.
+ */
+export const TRANSITION_FULFILLMENT_MUTATION = /* GraphQL */ `
+  mutation TransitionFulfillment($id: ID!, $state: String!) {
+    transitionFulfillmentToState(id: $id, state: $state) {
+      __typename
+      ... on Fulfillment {
+        id
+        state
+        nextStates
+      }
+      ... on FulfillmentStateTransitionError {
+        errorCode
+        message
+        fromState
+        toState
+        transitionError
+      }
+    }
+  }
+`;
+export const RESEND_FULFILLMENT_LABEL_HANDOFF_MUTATION = /* GraphQL */ `
+  mutation ResendFulfillmentLabelHandoff($fulfillmentId: ID!) {
+    resendFulfillmentLabelHandoff(fulfillmentId: $fulfillmentId)
+  }
+`;
 /** Every field of `OrderFulfillmentCoverageOverride`. */
 const COVERAGE_OVERRIDE_FIELDS = /* GraphQL */ `
   id
@@ -160,15 +189,27 @@ function assertCancelRequest(fulfillmentId, input) {
         if (!OVERPAYMENT_CHOICES.has(entry.choice)) {
             throw invalidCancel(`overpayment[${String(index)}].choice`, `The choice for order ${orderId} must be REFUND or ACCOUNT_CREDIT; got ${JSON.stringify(entry.choice)}.`);
         }
+        if (entry.customerAgreed != null &&
+            customerAgreedVariable(entry.customerAgreed) === undefined) {
+            throw invalidCancel(`overpayment[${String(index)}].customerAgreed`, `The customer's answer for order ${orderId} must be true or false; got ${JSON.stringify(entry.customerAgreed)}.`);
+        }
         if (seen.has(orderId)) {
             throw invalidCancel(`overpayment[${String(index)}].orderId`, `Order ${orderId} is named twice: give one choice per order.`);
         }
         seen.add(orderId);
     }
 }
-/** An option as the SDK types it: `code` and `message` are null when it is open. */
+/**
+ * An option as the SDK types it: `code` and `message` are null when it is open; `book` (the
+ * account credit's, incentives sprint 8) null on the refund and from an engine before it.
+ */
 function toOption(raw) {
-    return { available: raw.available, code: raw.code ?? null, message: raw.message ?? null };
+    return {
+        available: raw.available,
+        code: raw.code ?? null,
+        message: raw.message ?? null,
+        book: raw.book ?? null,
+    };
 }
 export const REPORT_APP_FULFILLMENT_MUTATION = /* GraphQL */ `
   mutation ReportAppFulfillment(
@@ -364,6 +405,50 @@ function assertLabelRequest(fulfillmentId, format) {
         throw invalidLabelRequest('format', `format must be 'A4' or 'A6', or left out to label every parcel still missing one; got ${JSON.stringify(format)}.`);
     }
 }
+function invalidTransition(field, message) {
+    return new ValidationError({
+        code: 'FULFILLMENT_TRANSITION_INVALID',
+        message,
+        status: 400,
+        service: 'vendure',
+        details: [{ field, code: 'FULFILLMENT_TRANSITION_INVALID', message }],
+    });
+}
+/** The `[CODE]` a step of the fulfillment process prefixes its refusal text with. */
+const STEP_CODE = /^\s*\[([A-Z][A-Z0-9_]*)\]\s*/;
+/**
+ * A refused move as the coded error it is. Core carries a step's refusal only as text, so the
+ * step's own code is read off its `[CODE]` prefix and classed through the GraphQL dialect, as the
+ * warehouse API's refusals of the same codes are (`warehouseRefusalError`): one code, one class,
+ * whichever door answered it.
+ */
+export function fulfillmentTransitionRefusal(result) {
+    const text = typeof result.transitionError === 'string' ? result.transitionError.trim() : '';
+    const facts = {
+        errorCode: result.errorCode,
+        fromState: result.fromState ?? '',
+        toState: result.toState ?? '',
+        transitionError: text,
+    };
+    const step = STEP_CODE.exec(text);
+    const sentence = step ? text.slice(step[0].length).trim() : text;
+    // Core's `message` is a per-code template, untranslated on some engines
+    // ("errorResult.FULFILLMENT_STATE_TRANSITION_ERROR"): said only when the move is unknown too.
+    const message = sentence ||
+        (facts.fromState && facts.toState
+            ? `The fulfillment cannot move from ${facts.fromState} to ${facts.toState}.`
+            : result.message);
+    if (step?.[1]) {
+        return errorFromGraphQLErrors([{ message, extensions: { ...facts, code: step[1] } }]);
+    }
+    const base = errorFromErrorResult({ errorCode: result.errorCode, message });
+    return errorForStatus(base.status, {
+        code: base.code,
+        message,
+        service: 'vendure',
+        extensions: { ...facts },
+    });
+}
 export function createFulfillmentsModule(transport) {
     return {
         ...createFulfillmentCreateMethods(transport),
@@ -475,7 +560,14 @@ export function createFulfillmentsModule(transport) {
                 variables: {
                     fulfillmentId,
                     ...(overpayment.length > 0
-                        ? { overpayment: overpayment.map(({ orderId, choice }) => ({ orderId, choice })) }
+                        ? {
+                            overpayment: overpayment.map(({ orderId, choice, customerAgreed }) => ({
+                                orderId,
+                                choice,
+                                // Named only when stated: an engine before the field takes the rest.
+                                ...statedCustomerAgreed(customerAgreed),
+                            })),
+                        }
                         : {}),
                     ...(options?.idempotencyKey ? { idempotencyKey: options.idempotencyKey } : {}),
                 },
@@ -489,6 +581,7 @@ export function createFulfillmentsModule(transport) {
                     amount: entry.amount,
                     currencyCode: entry.currencyCode,
                     choice: entry.choice,
+                    book: entry.book ?? null,
                 })),
             };
         },
@@ -524,6 +617,33 @@ export function createFulfillmentsModule(transport) {
             }, options);
             return toCoverageOverride(data.allowUncoveredFulfillment);
         },
+        async transition(fulfillmentId, state, options) {
+            if (typeof fulfillmentId !== 'string' || fulfillmentId.trim() === '') {
+                throw invalidTransition('fulfillmentId', 'A fulfillment id is required.');
+            }
+            if (typeof state !== 'string' || state.trim() === '') {
+                throw invalidTransition('state', 'Name the state to move the fulfillment to.');
+            }
+            const data = await transport.graphql({
+                api: 'admin',
+                query: TRANSITION_FULFILLMENT_MUTATION,
+                variables: { id: fulfillmentId, state },
+            }, options);
+            const result = data.transitionFulfillmentToState;
+            if (isErrorResult(result))
+                throw fulfillmentTransitionRefusal(result);
+            const moved = result;
+            return { id: moved.id, state: moved.state, nextStates: [...(moved.nextStates ?? [])] };
+        },
+        async resendLabelHandoff(fulfillmentId, options) {
+            assertLabelRequest(fulfillmentId, undefined);
+            const data = await transport.graphql({
+                api: 'admin',
+                query: RESEND_FULFILLMENT_LABEL_HANDOFF_MUTATION,
+                variables: { fulfillmentId },
+            }, options);
+            return data.resendFulfillmentLabelHandoff;
+        },
         async reportAppFulfillment(fulfillmentId, input, options) {
             const data = await transport.graphql({
                 api: 'admin',

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]);