@sixtyninecommerce/admin 0.13.0 → 0.14.0

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

package/dist/pricing/index.js

@@ -1,6 +1,7 @@
 import { ConflictError, createPage, errorFromErrorResult, isErrorResult, NotFoundError, UpstreamError, ValidationError, } from '@sixtyninecommerce/core';
 import { fieldOf, vendureListPage, } from '../catalog/types.js';
 import { createPricingBulkCouponsModule } from './bulk-coupons.js';
+import { createPricingExchangeRatesModule, } from './exchange-rates.js';
 import { createPricingPriceListsModule } from './price-lists.js';
 import { createPricingVouchersModule } from './vouchers.js';
 /**
@@ -491,6 +492,7 @@ export function createPricingModule(transport) {
         },
         vouchers: createPricingVouchersModule(transport),
         priceLists: createPricingPriceListsModule(transport),
+        exchangeRates: createPricingExchangeRatesModule(transport),
         coupons: {
             bulk: createPricingBulkCouponsModule(transport),
             async apply(orderId, couponCode, options) {

package/dist/purchasing/index.d.ts

@@ -13,7 +13,7 @@ export type { PurchasingAlert, PurchasingAlertRecipients, PurchasingAlertRecipie
 export type { BackorderReadyLine, BackordersReadyOptions, PurchasingBackordersModule, } from './backorders.js';
 export type { OverrideVariantCostInput, PurchasingCostModule, VariantCost, VariantCostCause, VariantCostEntry, VariantCostEntryList, VariantCostHistoryOptions, } from './cost.js';
 export type { BackToBackLinkQuantities, BackToBackLinkResult, CreateBackToBackLinkInput, DropShipShipmentFulfillment, DropShipShipmentResult, PurchaseOrderDropShip, PurchaseOrderDropShipLine, PurchaseOrderLink, PurchaseOrderLinkKind, PurchaseOrderLinkReleaseReason, PurchaseOrderLinkStatus, PurchasingBackToBackLinksModule, PurchasingDropShipLinksModule, PurchasingLinksModule, RecordDropShipShipmentInput, } from './links.js';
-export type { CreatePurchaseOrderInput, PurchaseOrder, PurchaseOrderCancelOptions, PurchaseOrderConfirmation, PurchaseOrderConfirmationInput, PurchaseOrderDocumentOptions, PurchaseOrderDocumentUrl, PurchaseOrderHeaderFields, PurchaseOrderKeyedCall, PurchaseOrderLine, PurchaseOrderLineConfirmationInput, PurchaseOrderLineImportOptions, PurchaseOrderLineImportResult, PurchaseOrderLineImportRow, PurchaseOrderLineInput, PurchaseOrderLinesModule, PurchaseOrderListOptions, PurchaseOrderLocation, PurchaseOrderReasonOptions, PurchaseOrderRevision, PurchaseOrderRevisionInput, PurchaseOrderRevisionsModule, PurchaseOrderSendVia, PurchaseOrderStatus, PurchaseOrderStatusEntry, PurchaseOrderSupplier, PurchasingPurchaseOrdersModule, UpdatePurchaseOrderInput, UpdatePurchaseOrderLineInput, } from './purchase-orders.js';
+export type { CreatePurchaseOrderInput, PurchaseOrder, PurchaseOrderCancelOptions, PurchaseOrderConfirmation, PurchaseOrderConfirmationInput, PurchaseOrderDocumentOptions, PurchaseOrderDocumentUrl, PurchaseOrderHeaderFields, PurchaseOrderKeyedCall, PurchaseOrderLine, PurchaseOrderLineConfirmationInput, PurchaseOrderLineImportOptions, PurchaseOrderLineImportResult, PurchaseOrderLineImportRow, PurchaseOrderLineInput, PurchaseOrderLinesModule, PurchaseOrderListOptions, PurchaseOrderLocation, PurchaseOrderReasonOptions, PurchaseOrderRevision, PurchaseOrderRevisionInput, PurchaseOrderRevisionsModule, PurchaseOrderSendCall, PurchaseOrderSendVia, PurchaseOrderStatus, PurchaseOrderStatusEntry, PurchaseOrderSupplier, PurchasingPurchaseOrdersModule, UpdatePurchaseOrderInput, UpdatePurchaseOrderLineInput, } from './purchase-orders.js';
 export type { AddGoodsReceiptChargeInput, GoodsReceipt, GoodsReceiptChargesModule, GoodsReceiptDetail, GoodsReceiptKeyedCall, GoodsReceiptKind, GoodsReceiptLine, GoodsReceiptListOptions, GoodsReceiptReference, GoodsReceiptTraceability, GoodsReceiptTraceabilityInput, LandedCharge, LandedChargeAllocation, LandedChargeAllocationBasis, LandedChargeKind, PostGoodsReceiptInput, PostGoodsReceiptLineInput, PurchasingReceiptsModule, ReceivablePurchaseOrderLine, ReceivablePurchaseOrderLinesOptions, RemoveGoodsReceiptChargeInput, ReverseGoodsReceiptInput, } from './receipts.js';
 export type { PurchasingReplenishmentModule, ReplenishmentComputeResult, ReplenishmentDraftLine, ReplenishmentDrafts, ReplenishmentLocation, ReplenishmentRule, ReplenishmentRuleFields, ReplenishmentRuleImportInput, ReplenishmentRuleImportResult, ReplenishmentRuleImportRow, ReplenishmentRuleListOptions, ReplenishmentRulesModule, ReplenishmentSuggestion, ReplenishmentSuggestionListOptions, ReplenishmentSuggestionsModule, ReplenishmentSupplier, ReplenishmentVariant, } from './replenishment.js';
 export type { CreateSupplierReturnInput, PurchasingReturnsModule, ResolveSupplierReturnLineInput, ShipSupplierReturnInput, SupplierReturn, SupplierReturnCancelOptions, SupplierReturnDocumentUrl, SupplierReturnKeyedCall, SupplierReturnLine, SupplierReturnLineInput, SupplierReturnListOptions, SupplierReturnOrigin, SupplierReturnOutcome, SupplierReturnResolution, SupplierReturnStatus, SupplierReturnStatusEntry, UpdateSupplierReturnInput, } from './returns.js';
@@ -51,4 +51,4 @@ export interface PurchasingModule {
     /** Customer order lines bought on purchase order lines: "Order from supplier" and its reads. */
     links: PurchasingLinksModule;
 }
-export declare function createPurchasingModule(transport: Transport): PurchasingModule;
+export declare function createPurchasingModule(baseTransport: Transport): PurchasingModule;

package/dist/purchasing/index.js

@@ -2,13 +2,16 @@ import { createPurchasingAlertsModule } from './alerts.js';
 import { createPurchasingBackordersModule } from './backorders.js';
 import { createPurchasingCostModule } from './cost.js';
 import { createPurchasingLinksModule } from './links.js';
-import { createPurchasingPurchaseOrdersModule, } from './purchase-orders.js';
+import { createPurchasingPurchaseOrdersModule, sentReferenceAware, } from './purchase-orders.js';
 import { createPurchasingReceiptsModule } from './receipts.js';
 import { createPurchasingReplenishmentModule, } from './replenishment.js';
 import { createPurchasingReturnsModule } from './returns.js';
 import { createPurchasingSettingsModule } from './settings.js';
 import { createPurchasingSuppliersModule } from './suppliers.js';
-export function createPurchasingModule(transport) {
+export function createPurchasingModule(baseTransport) {
+    // One transport for every purchasing module: a document embedding PURCHASE_ORDER_FIELDS, in
+    // whichever module, is asked once more without `sentReference` by an engine before it.
+    const transport = sentReferenceAware(baseTransport);
     return {
         settings: createPurchasingSettingsModule(transport),
         suppliers: createPurchasingSuppliersModule(transport),

package/dist/purchasing/links.d.ts

@@ -175,10 +175,10 @@ export declare const PURCHASE_ORDER_LINK_FIELDS = "\n  id\n  kind\n  status\n  o
 export declare const ORDER_PURCHASE_ORDER_LINKS_QUERY = "\n  query OrderPurchaseOrderLinks($orderId: ID!) {\n    orderPurchaseOrderLinks(orderId: $orderId) { \n  id\n  kind\n  status\n  orderId\n  orderCode\n  orderLineId\n  productVariantId\n  sku\n  purchaseOrderId\n  purchaseOrderCode\n  purchaseOrderStatus\n  purchaseOrderLineId\n  supplierId\n  supplierName\n  stockLocationId\n  baseQuantity\n  allocatedBaseQuantity\n  shippedBaseQuantity\n  expectedOn\n  expectedOnConfirmed\n  releasedAt\n  releaseReason\n  createdAt\n }\n  }\n";
 export declare const PURCHASE_ORDER_LINKS_QUERY = "\n  query PurchaseOrderLinks($purchaseOrderId: ID!) {\n    purchaseOrderLinks(purchaseOrderId: $purchaseOrderId) { \n  id\n  kind\n  status\n  orderId\n  orderCode\n  orderLineId\n  productVariantId\n  sku\n  purchaseOrderId\n  purchaseOrderCode\n  purchaseOrderStatus\n  purchaseOrderLineId\n  supplierId\n  supplierName\n  stockLocationId\n  baseQuantity\n  allocatedBaseQuantity\n  shippedBaseQuantity\n  expectedOn\n  expectedOnConfirmed\n  releasedAt\n  releaseReason\n  createdAt\n }\n  }\n";
 export declare const BACK_TO_BACK_LINK_QUANTITIES_QUERY = "\n  query PurchaseOrderBackToBackLinkQuantities($orderLineId: ID!) {\n    purchaseOrderBackToBackLinkQuantities(orderLineId: $orderLineId) {\n      orderLineId\n      openBaseQuantity\n      linkedBaseQuantity\n      maxBaseQuantity\n      suggestedBaseQuantity\n    }\n  }\n";
-export declare const CREATE_BACK_TO_BACK_LINK_MUTATION = "\n  mutation CreatePurchaseOrderBackToBackLink(\n    $input: CreatePurchaseOrderBackToBackLinkInput!\n    $idempotencyKey: String\n  ) {\n    createPurchaseOrderBackToBackLink(input: $input, idempotencyKey: $idempotencyKey) {\n      link { \n  id\n  kind\n  status\n  orderId\n  orderCode\n  orderLineId\n  productVariantId\n  sku\n  purchaseOrderId\n  purchaseOrderCode\n  purchaseOrderStatus\n  purchaseOrderLineId\n  supplierId\n  supplierName\n  stockLocationId\n  baseQuantity\n  allocatedBaseQuantity\n  shippedBaseQuantity\n  expectedOn\n  expectedOnConfirmed\n  releasedAt\n  releaseReason\n  createdAt\n }\n      purchaseOrder { \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n }\n      createdPurchaseOrder\n    }\n  }\n";
+export declare const CREATE_BACK_TO_BACK_LINK_MUTATION = "\n  mutation CreatePurchaseOrderBackToBackLink(\n    $input: CreatePurchaseOrderBackToBackLinkInput!\n    $idempotencyKey: String\n  ) {\n    createPurchaseOrderBackToBackLink(input: $input, idempotencyKey: $idempotencyKey) {\n      link { \n  id\n  kind\n  status\n  orderId\n  orderCode\n  orderLineId\n  productVariantId\n  sku\n  purchaseOrderId\n  purchaseOrderCode\n  purchaseOrderStatus\n  purchaseOrderLineId\n  supplierId\n  supplierName\n  stockLocationId\n  baseQuantity\n  allocatedBaseQuantity\n  shippedBaseQuantity\n  expectedOn\n  expectedOnConfirmed\n  releasedAt\n  releaseReason\n  createdAt\n }\n      purchaseOrder { \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n }\n      createdPurchaseOrder\n    }\n  }\n";
 export declare const REMOVE_BACK_TO_BACK_LINK_MUTATION = "\n  mutation RemovePurchaseOrderBackToBackLink($id: ID!, $idempotencyKey: String) {\n    removePurchaseOrderBackToBackLink(id: $id, idempotencyKey: $idempotencyKey) {\n      \n  id\n  kind\n  status\n  orderId\n  orderCode\n  orderLineId\n  productVariantId\n  sku\n  purchaseOrderId\n  purchaseOrderCode\n  purchaseOrderStatus\n  purchaseOrderLineId\n  supplierId\n  supplierName\n  stockLocationId\n  baseQuantity\n  allocatedBaseQuantity\n  shippedBaseQuantity\n  expectedOn\n  expectedOnConfirmed\n  releasedAt\n  releaseReason\n  createdAt\n\n    }\n  }\n";
 export declare const PURCHASE_ORDER_DROP_SHIP_QUERY = "\n  query PurchaseOrderDropShip($purchaseOrderId: ID!) {\n    purchaseOrderDropShip(purchaseOrderId: $purchaseOrderId) {\n      purchaseOrderId\n      purchaseOrderCode\n      orderId\n      orderCode\n      address {\n        fullName\n        company\n        streetLine1\n        streetLine2\n        city\n        province\n        postalCode\n        country\n        countryCode\n        phoneNumber\n      }\n      lines {\n        purchaseOrderLineId\n        orderLineId\n        sku\n        orderedBaseQuantity\n        shippedBaseQuantity\n        toShipBaseQuantity\n      }\n    }\n  }\n";
-export declare const RECORD_DROP_SHIP_SHIPMENT_MUTATION = "\n  mutation RecordPurchaseOrderDropShipShipment(\n    $input: RecordDropShipShipmentInput!\n    $idempotencyKey: String!\n  ) {\n    recordPurchaseOrderDropShipShipment(input: $input, idempotencyKey: $idempotencyKey) {\n      purchaseOrder { \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n }\n      links { \n  id\n  kind\n  status\n  orderId\n  orderCode\n  orderLineId\n  productVariantId\n  sku\n  purchaseOrderId\n  purchaseOrderCode\n  purchaseOrderStatus\n  purchaseOrderLineId\n  supplierId\n  supplierName\n  stockLocationId\n  baseQuantity\n  allocatedBaseQuantity\n  shippedBaseQuantity\n  expectedOn\n  expectedOnConfirmed\n  releasedAt\n  releaseReason\n  createdAt\n }\n      fulfillment {\n        id\n        state\n        method\n        trackingCode\n      }\n      closedPurchaseOrder\n    }\n  }\n";
+export declare const RECORD_DROP_SHIP_SHIPMENT_MUTATION = "\n  mutation RecordPurchaseOrderDropShipShipment(\n    $input: RecordDropShipShipmentInput!\n    $idempotencyKey: String!\n  ) {\n    recordPurchaseOrderDropShipShipment(input: $input, idempotencyKey: $idempotencyKey) {\n      purchaseOrder { \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n }\n      links { \n  id\n  kind\n  status\n  orderId\n  orderCode\n  orderLineId\n  productVariantId\n  sku\n  purchaseOrderId\n  purchaseOrderCode\n  purchaseOrderStatus\n  purchaseOrderLineId\n  supplierId\n  supplierName\n  stockLocationId\n  baseQuantity\n  allocatedBaseQuantity\n  shippedBaseQuantity\n  expectedOn\n  expectedOnConfirmed\n  releasedAt\n  releaseReason\n  createdAt\n }\n      fulfillment {\n        id\n        state\n        method\n        trackingCode\n      }\n      closedPurchaseOrder\n    }\n  }\n";
 /**
  * `admin.purchasing.links.backToBack` (purchase-orders spec §8.12.1, §10.1): "Order from supplier"
  * on a customer order line. The received goods are allocated to the line first, at the purchase
@@ -260,4 +260,4 @@ export interface PurchasingLinksModule {
     /** The links of a purchase order, oldest first, ended ones included. */
     forPurchaseOrder(purchaseOrderId: string, call?: Call): Promise<PurchaseOrderLink[]>;
 }
-export declare function createPurchasingLinksModule(transport: Transport): PurchasingLinksModule;
+export declare function createPurchasingLinksModule(baseTransport: Transport): PurchasingLinksModule;

package/dist/purchasing/links.js

@@ -1,4 +1,4 @@
-import { PURCHASE_ORDER_FIELDS, } from './purchase-orders.js';
+import { PURCHASE_ORDER_FIELDS, sentReferenceAware, withSentReferences, } from './purchase-orders.js';
 export const PURCHASE_ORDER_LINK_FIELDS = /* GraphQL */ `
   id
   kind
@@ -136,7 +136,10 @@ function picked(input, fields) {
     }
     return out;
 }
-export function createPurchasingLinksModule(transport) {
+export function createPurchasingLinksModule(baseTransport) {
+    // `backToBack.create` and `dropShip.recordShipment` answer their purchase order through
+    // PURCHASE_ORDER_FIELDS (`sentReference`).
+    const transport = sentReferenceAware(baseTransport);
     return {
         backToBack: {
             async create(input, call) {
@@ -148,7 +151,8 @@ export function createPurchasingLinksModule(transport) {
                         idempotencyKey: call?.idempotencyKey,
                     },
                 }, call);
-                return data.createPurchaseOrderBackToBackLink;
+                const result = data.createPurchaseOrderBackToBackLink;
+                return { ...result, purchaseOrder: withSentReferences(result.purchaseOrder) };
             },
             async quantities(orderLineId, call) {
                 const data = await transport.graphql({ api: 'admin', query: BACK_TO_BACK_LINK_QUANTITIES_QUERY, variables: { orderLineId } }, call);
@@ -177,7 +181,8 @@ export function createPurchasingLinksModule(transport) {
                         idempotencyKey: call.idempotencyKey,
                     },
                 }, call);
-                return data.recordPurchaseOrderDropShipShipment;
+                const result = data.recordPurchaseOrderDropShipShipment;
+                return { ...result, purchaseOrder: withSentReferences(result.purchaseOrder) };
             },
         },
         async forOrder(orderId, call) {

package/dist/purchasing/purchase-orders.d.ts

@@ -88,7 +88,11 @@ export interface PurchaseOrderStatusEntry {
     createdAt: string;
 }
 /** How a purchase order reaches its supplier (D74): emailed by the platform, or by staff. */
-export type PurchaseOrderSendVia = 'email' | 'manual';
+/**
+ * How the order reaches its supplier: `email` (the platform mails the PDF), `manual` (staff send
+ * it) or `external` (an integration transmitted the order in the supplier's own format).
+ */
+export type PurchaseOrderSendVia = 'email' | 'manual' | 'external';
 /**
  * A numbered revision of a purchase order (purchase-orders spec §8.4.4). Revision 0 is the
  * original as first sent; each later one is a change set of the sent order.
@@ -113,6 +117,12 @@ export interface PurchaseOrderRevision {
     /** When its document went to the supplier; null until sent. */
     sentAt: string | null;
     sentVia: PurchaseOrderSendVia | (string & {}) | null;
+    /**
+     * The reference the integration stated when it sent THIS revision externally (`send(id,
+     * 'external', { externalReference })`, e.g. the lab's order number); null for an email or
+     * manual send, an external one that stated none, and on an engine before the field.
+     */
+    sentReference: string | null;
 }
 /** A five-minute link to a purchase order's PDF. */
 export interface PurchaseOrderDocumentUrl {
@@ -337,6 +347,17 @@ export interface PurchaseOrderLineImportResult {
 export type PurchaseOrderKeyedCall = Call & {
     idempotencyKey: string;
 };
+/**
+ * `send`'s call. With `via: 'external'` it may also state what the integration knows of the
+ * transmission: the supplier's (or the integration's) reference, kept as the sent revision's
+ * `sentReference` and becoming the order's `supplierReference` while it has none, and when it was
+ * handed over (default now; never in the future), the revision's `sentAt` (and on the first send
+ * the order's). Both are refused for `email` and `manual`.
+ */
+export type PurchaseOrderSendCall = PurchaseOrderKeyedCall & {
+    externalReference?: string;
+    transmittedAt?: Date | string;
+};
 export declare const PURCHASE_ORDER_LINE_FIELDS = "\n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n";
 /**
  * The header and lines, without the status history, which the engine reads per order: what the
@@ -347,33 +368,52 @@ export declare const PURCHASE_ORDER_SUMMARY_FIELDS = "\n  id\n  scopeId\n  legal
  * A whole purchase order, its status history and revisions included: what `get` and every write
  * answer.
  */
-export declare const PURCHASE_ORDER_FIELDS = "\n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n";
+export declare const PURCHASE_ORDER_FIELDS = "\n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n";
+/**
+ * The transport, sending a document that names `sentReference` once more without it when the
+ * engine refused it as unknown, and only then: any other refusal, or a document that does not name
+ * it, is thrown as it came. Safe for a mutation too: a refused document never ran.
+ * `createPurchasingModule` hands this transport to every purchasing module, so any document that
+ * embeds {@link PURCHASE_ORDER_FIELDS} (purchase orders, back-to-back links, replenishment drafts)
+ * gets the one retry; each factory that embeds it wraps again, which is a no-op on a wrapped one.
+ */
+export declare function sentReferenceAware(transport: Transport): Transport;
+/**
+ * An order as answered, every revision with its `sentReference` (null from an older engine). Every
+ * method answering an order read through {@link PURCHASE_ORDER_FIELDS} passes it through this.
+ */
+export declare function withSentReferences(order: PurchaseOrder): PurchaseOrder;
 export declare const PURCHASE_ORDERS_QUERY = "\n  query PurchaseOrders($options: PurchaseOrderListOptions) {\n    purchaseOrders(options: $options) {\n      totalItems\n      items { \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n }\n    }\n  }\n";
-export declare const PURCHASE_ORDER_QUERY = "\n  query PurchaseOrder($id: ID!) {\n    purchaseOrder(id: $id) { \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n }\n  }\n";
-export declare const CREATE_PURCHASE_ORDER_MUTATION = "\n  mutation CreatePurchaseOrder($input: CreatePurchaseOrderInput!, $idempotencyKey: String) {\n    createPurchaseOrder(input: $input, idempotencyKey: $idempotencyKey) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n\n    }\n  }\n";
-export declare const UPDATE_PURCHASE_ORDER_MUTATION = "\n  mutation UpdatePurchaseOrder($input: UpdatePurchaseOrderInput!, $idempotencyKey: String) {\n    updatePurchaseOrder(input: $input, idempotencyKey: $idempotencyKey) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n\n    }\n  }\n";
-export declare const ADD_PURCHASE_ORDER_LINES_MUTATION = "\n  mutation AddPurchaseOrderLines(\n    $purchaseOrderId: ID!\n    $lines: [PurchaseOrderLineInput!]!\n    $idempotencyKey: String\n  ) {\n    addPurchaseOrderLines(\n      purchaseOrderId: $purchaseOrderId\n      lines: $lines\n      idempotencyKey: $idempotencyKey\n    ) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n\n    }\n  }\n";
-export declare const UPDATE_PURCHASE_ORDER_LINE_MUTATION = "\n  mutation UpdatePurchaseOrderLine(\n    $input: UpdatePurchaseOrderLineInput!\n    $idempotencyKey: String\n  ) {\n    updatePurchaseOrderLine(input: $input, idempotencyKey: $idempotencyKey) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n\n    }\n  }\n";
-export declare const REMOVE_PURCHASE_ORDER_LINE_MUTATION = "\n  mutation RemovePurchaseOrderLine($id: ID!, $idempotencyKey: String) {\n    removePurchaseOrderLine(id: $id, idempotencyKey: $idempotencyKey) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n\n    }\n  }\n";
-export declare const SUBMIT_PURCHASE_ORDER_MUTATION = "\n  mutation SubmitPurchaseOrder($id: ID!, $idempotencyKey: String) {\n    submitPurchaseOrder(id: $id, idempotencyKey: $idempotencyKey) { \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n }\n  }\n";
-export declare const APPROVE_PURCHASE_ORDER_MUTATION = "\n  mutation ApprovePurchaseOrder($id: ID!, $idempotencyKey: String) {\n    approvePurchaseOrder(id: $id, idempotencyKey: $idempotencyKey) { \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n }\n  }\n";
-export declare const REJECT_PURCHASE_ORDER_MUTATION = "\n  mutation RejectPurchaseOrder($id: ID!, $reason: String!, $idempotencyKey: String) {\n    rejectPurchaseOrder(id: $id, reason: $reason, idempotencyKey: $idempotencyKey) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n\n    }\n  }\n";
-export declare const CANCEL_PURCHASE_ORDER_MUTATION = "\n  mutation CancelPurchaseOrder($id: ID!, $reason: String, $idempotencyKey: String) {\n    cancelPurchaseOrder(id: $id, reason: $reason, idempotencyKey: $idempotencyKey) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n\n    }\n  }\n";
+export declare const PURCHASE_ORDER_QUERY = "\n  query PurchaseOrder($id: ID!) {\n    purchaseOrder(id: $id) { \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n }\n  }\n";
+export declare const CREATE_PURCHASE_ORDER_MUTATION = "\n  mutation CreatePurchaseOrder($input: CreatePurchaseOrderInput!, $idempotencyKey: String) {\n    createPurchaseOrder(input: $input, idempotencyKey: $idempotencyKey) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n\n    }\n  }\n";
+export declare const UPDATE_PURCHASE_ORDER_MUTATION = "\n  mutation UpdatePurchaseOrder($input: UpdatePurchaseOrderInput!, $idempotencyKey: String) {\n    updatePurchaseOrder(input: $input, idempotencyKey: $idempotencyKey) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n\n    }\n  }\n";
+export declare const ADD_PURCHASE_ORDER_LINES_MUTATION = "\n  mutation AddPurchaseOrderLines(\n    $purchaseOrderId: ID!\n    $lines: [PurchaseOrderLineInput!]!\n    $idempotencyKey: String\n  ) {\n    addPurchaseOrderLines(\n      purchaseOrderId: $purchaseOrderId\n      lines: $lines\n      idempotencyKey: $idempotencyKey\n    ) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n\n    }\n  }\n";
+export declare const UPDATE_PURCHASE_ORDER_LINE_MUTATION = "\n  mutation UpdatePurchaseOrderLine(\n    $input: UpdatePurchaseOrderLineInput!\n    $idempotencyKey: String\n  ) {\n    updatePurchaseOrderLine(input: $input, idempotencyKey: $idempotencyKey) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n\n    }\n  }\n";
+export declare const REMOVE_PURCHASE_ORDER_LINE_MUTATION = "\n  mutation RemovePurchaseOrderLine($id: ID!, $idempotencyKey: String) {\n    removePurchaseOrderLine(id: $id, idempotencyKey: $idempotencyKey) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n\n    }\n  }\n";
+export declare const SUBMIT_PURCHASE_ORDER_MUTATION = "\n  mutation SubmitPurchaseOrder($id: ID!, $idempotencyKey: String) {\n    submitPurchaseOrder(id: $id, idempotencyKey: $idempotencyKey) { \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n }\n  }\n";
+export declare const APPROVE_PURCHASE_ORDER_MUTATION = "\n  mutation ApprovePurchaseOrder($id: ID!, $idempotencyKey: String) {\n    approvePurchaseOrder(id: $id, idempotencyKey: $idempotencyKey) { \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n }\n  }\n";
+export declare const REJECT_PURCHASE_ORDER_MUTATION = "\n  mutation RejectPurchaseOrder($id: ID!, $reason: String!, $idempotencyKey: String) {\n    rejectPurchaseOrder(id: $id, reason: $reason, idempotencyKey: $idempotencyKey) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n\n    }\n  }\n";
+export declare const CANCEL_PURCHASE_ORDER_MUTATION = "\n  mutation CancelPurchaseOrder($id: ID!, $reason: String, $idempotencyKey: String) {\n    cancelPurchaseOrder(id: $id, reason: $reason, idempotencyKey: $idempotencyKey) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n\n    }\n  }\n";
 /**
  * The cancel that states whether the supplier is emailed: sent only when `notifySupplier` is
  * given, so a cancel without it still reaches an engine from before the cancellation email.
  */
-export declare const CANCEL_PURCHASE_ORDER_NOTIFYING_MUTATION = "\n  mutation CancelPurchaseOrderNotifying(\n    $id: ID!\n    $reason: String\n    $notifySupplier: Boolean\n    $idempotencyKey: String\n  ) {\n    cancelPurchaseOrder(\n      id: $id\n      reason: $reason\n      notifySupplier: $notifySupplier\n      idempotencyKey: $idempotencyKey\n    ) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n\n    }\n  }\n";
-export declare const SEND_PURCHASE_ORDER_MUTATION = "\n  mutation SendPurchaseOrder($id: ID!, $via: String!, $idempotencyKey: String) {\n    sendPurchaseOrder(id: $id, via: $via, idempotencyKey: $idempotencyKey) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n\n    }\n  }\n";
-export declare const REVISE_PURCHASE_ORDER_MUTATION = "\n  mutation RevisePurchaseOrder($input: RevisePurchaseOrderInput!, $idempotencyKey: String) {\n    revisePurchaseOrder(input: $input, idempotencyKey: $idempotencyKey) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n\n    }\n  }\n";
-export declare const APPROVE_PURCHASE_ORDER_REVISION_MUTATION = "\n  mutation ApprovePurchaseOrderRevision($purchaseOrderId: ID!, $idempotencyKey: String) {\n    approvePurchaseOrderRevision(\n      purchaseOrderId: $purchaseOrderId\n      idempotencyKey: $idempotencyKey\n    ) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n\n    }\n  }\n";
-export declare const DISCARD_PURCHASE_ORDER_REVISION_MUTATION = "\n  mutation DiscardPurchaseOrderRevision(\n    $purchaseOrderId: ID!\n    $reason: String\n    $idempotencyKey: String\n  ) {\n    discardPurchaseOrderRevision(\n      purchaseOrderId: $purchaseOrderId\n      reason: $reason\n      idempotencyKey: $idempotencyKey\n    ) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n\n    }\n  }\n";
-export declare const CLOSE_PURCHASE_ORDER_MUTATION = "\n  mutation ClosePurchaseOrder($id: ID!, $reason: String!, $idempotencyKey: String) {\n    closePurchaseOrder(id: $id, reason: $reason, idempotencyKey: $idempotencyKey) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n\n    }\n  }\n";
-export declare const REOPEN_PURCHASE_ORDER_MUTATION = "\n  mutation ReopenPurchaseOrder($id: ID!, $reason: String, $idempotencyKey: String) {\n    reopenPurchaseOrder(id: $id, reason: $reason, idempotencyKey: $idempotencyKey) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n\n    }\n  }\n";
+export declare const CANCEL_PURCHASE_ORDER_NOTIFYING_MUTATION = "\n  mutation CancelPurchaseOrderNotifying(\n    $id: ID!\n    $reason: String\n    $notifySupplier: Boolean\n    $idempotencyKey: String\n  ) {\n    cancelPurchaseOrder(\n      id: $id\n      reason: $reason\n      notifySupplier: $notifySupplier\n      idempotencyKey: $idempotencyKey\n    ) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n\n    }\n  }\n";
+export declare const SEND_PURCHASE_ORDER_MUTATION = "\n  mutation SendPurchaseOrder($id: ID!, $via: String!, $idempotencyKey: String) {\n    sendPurchaseOrder(id: $id, via: $via, idempotencyKey: $idempotencyKey) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n\n    }\n  }\n";
+/**
+ * The external send with what the integration knows (engine with `via: 'external'`); sent only
+ * when the caller states one, so a plain send keeps working against an older engine.
+ */
+export declare const SEND_PURCHASE_ORDER_EXTERNAL_MUTATION = "\n  mutation SendPurchaseOrderExternal(\n    $id: ID!\n    $via: String!\n    $idempotencyKey: String\n    $externalReference: String\n    $transmittedAt: DateTime\n  ) {\n    sendPurchaseOrder(\n      id: $id\n      via: $via\n      idempotencyKey: $idempotencyKey\n      externalReference: $externalReference\n      transmittedAt: $transmittedAt\n    ) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n\n    }\n  }\n";
+export declare const REVISE_PURCHASE_ORDER_MUTATION = "\n  mutation RevisePurchaseOrder($input: RevisePurchaseOrderInput!, $idempotencyKey: String) {\n    revisePurchaseOrder(input: $input, idempotencyKey: $idempotencyKey) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n\n    }\n  }\n";
+export declare const APPROVE_PURCHASE_ORDER_REVISION_MUTATION = "\n  mutation ApprovePurchaseOrderRevision($purchaseOrderId: ID!, $idempotencyKey: String) {\n    approvePurchaseOrderRevision(\n      purchaseOrderId: $purchaseOrderId\n      idempotencyKey: $idempotencyKey\n    ) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n\n    }\n  }\n";
+export declare const DISCARD_PURCHASE_ORDER_REVISION_MUTATION = "\n  mutation DiscardPurchaseOrderRevision(\n    $purchaseOrderId: ID!\n    $reason: String\n    $idempotencyKey: String\n  ) {\n    discardPurchaseOrderRevision(\n      purchaseOrderId: $purchaseOrderId\n      reason: $reason\n      idempotencyKey: $idempotencyKey\n    ) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n\n    }\n  }\n";
+export declare const CLOSE_PURCHASE_ORDER_MUTATION = "\n  mutation ClosePurchaseOrder($id: ID!, $reason: String!, $idempotencyKey: String) {\n    closePurchaseOrder(id: $id, reason: $reason, idempotencyKey: $idempotencyKey) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n\n    }\n  }\n";
+export declare const REOPEN_PURCHASE_ORDER_MUTATION = "\n  mutation ReopenPurchaseOrder($id: ID!, $reason: String, $idempotencyKey: String) {\n    reopenPurchaseOrder(id: $id, reason: $reason, idempotencyKey: $idempotencyKey) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n\n    }\n  }\n";
 export declare const CREATE_PURCHASE_ORDER_DOCUMENT_URL_MUTATION = "\n  mutation CreatePurchaseOrderDocumentUrl($purchaseOrderId: ID!, $revision: Int) {\n    createPurchaseOrderDocumentUrl(purchaseOrderId: $purchaseOrderId, revision: $revision) {\n      url\n      expiresAt\n      filename\n      revision\n    }\n  }\n";
-export declare const CONFIRM_PURCHASE_ORDER_MUTATION = "\n  mutation ConfirmPurchaseOrder($input: ConfirmPurchaseOrderInput!, $idempotencyKey: String) {\n    confirmPurchaseOrder(input: $input, idempotencyKey: $idempotencyKey) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n\n    }\n  }\n";
-export declare const DUPLICATE_PURCHASE_ORDER_MUTATION = "\n  mutation DuplicatePurchaseOrder($id: ID!, $idempotencyKey: String) {\n    duplicatePurchaseOrder(id: $id, idempotencyKey: $idempotencyKey) { \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n }\n  }\n";
-export declare const IMPORT_PURCHASE_ORDER_LINES_MUTATION = "\n  mutation ImportPurchaseOrderLines(\n    $input: ImportPurchaseOrderLinesInput!\n    $idempotencyKey: String\n  ) {\n    importPurchaseOrderLines(input: $input, idempotencyKey: $idempotencyKey) {\n      dryRun\n      contentHash\n      ignoredColumns\n      totalRows\n      created\n      updated\n      unchanged\n      failed\n      rows { row sku supplierSku outcome lineId errorCode message }\n      purchaseOrder { \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n }\n    }\n  }\n";
+export declare const CONFIRM_PURCHASE_ORDER_MUTATION = "\n  mutation ConfirmPurchaseOrder($input: ConfirmPurchaseOrderInput!, $idempotencyKey: String) {\n    confirmPurchaseOrder(input: $input, idempotencyKey: $idempotencyKey) {\n      \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n\n    }\n  }\n";
+export declare const DUPLICATE_PURCHASE_ORDER_MUTATION = "\n  mutation DuplicatePurchaseOrder($id: ID!, $idempotencyKey: String) {\n    duplicatePurchaseOrder(id: $id, idempotencyKey: $idempotencyKey) { \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n }\n  }\n";
+export declare const IMPORT_PURCHASE_ORDER_LINES_MUTATION = "\n  mutation ImportPurchaseOrderLines(\n    $input: ImportPurchaseOrderLinesInput!\n    $idempotencyKey: String\n  ) {\n    importPurchaseOrderLines(input: $input, idempotencyKey: $idempotencyKey) {\n      dryRun\n      contentHash\n      ignoredColumns\n      totalRows\n      created\n      updated\n      unchanged\n      failed\n      rows { row sku supplierSku outcome lineId errorCode message }\n      purchaseOrder { \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n }\n    }\n  }\n";
 /** A draft's lines. Each write needs `UpdatePurchaseOrder` on every store of the legal entity. */
 export interface PurchaseOrderLinesModule {
     /**
@@ -487,15 +527,19 @@ export interface PurchasingPurchaseOrdersModule {
     /**
      * Sends the order to its supplier (`UpdatePurchaseOrder`; spec §8.4.1, D74, D75). `email`: the
      * platform emails the PDF to the supplier's order contact, else its order email; `manual`:
-     * marked sent without email, staff send the PDF themselves (`document`). An approved order
-     * moves to `sent`; on a sent order it sends the revision applied since the last send, or
-     * emails the current one again. Refusals, before anything changes:
+     * marked sent without email, staff send the PDF themselves (`document`); `external`: an
+     * integration transmitted the order in the supplier's own format, nothing is mailed and the PDF
+     * is only the order's record (`call.externalReference` and `call.transmittedAt` record what the
+     * integration knows; an engine before `external` answers `PURCHASE_ORDER_INVALID`). An approved
+     * order moves to `sent`; on a sent order it sends the revision applied since the last send, or
+     * emails the current one again (`manual` and `external` then change nothing). Refusals, before
+     * anything changes:
      * `SUPPLIER_HAS_NO_ORDER_EMAIL` and `SUPPLIER_EMAIL_UNDELIVERABLE` (422, by email: the store's
      * "Purchase Order Sent" email is off or has no recipient), `PRIVATE_STORAGE_UNCONFIGURED`
      * (422, the deployment cannot store the PDF), `PURCHASE_ORDER_INVALID_TRANSITION` (422).
      * The key is required (spec §10.1).
      */
-    send(id: string, via: PurchaseOrderSendVia, call: PurchaseOrderKeyedCall): Promise<PurchaseOrder>;
+    send(id: string, via: PurchaseOrderSendVia, call: PurchaseOrderSendCall): Promise<PurchaseOrder>;
     /**
      * Revises a SENT order (`UpdatePurchaseOrder`; spec §8.3, §8.4.4): within the approved amount
      * the revision applies at once; above it the threshold decides again (a foreign currency at the
@@ -548,4 +592,4 @@ export interface PurchasingPurchaseOrdersModule {
      */
     document(id: string, options?: PurchaseOrderDocumentOptions): Promise<PurchaseOrderDocumentUrl>;
 }
-export declare function createPurchasingPurchaseOrdersModule(transport: Transport): PurchasingPurchaseOrdersModule;
+export declare function createPurchasingPurchaseOrdersModule(baseTransport: Transport): PurchasingPurchaseOrdersModule;

package/dist/purchasing/purchase-orders.js

@@ -1,4 +1,5 @@
 import { pageFromVendureList, readOffsetCursor, } from '@sixtyninecommerce/core';
+import { isUnknownFieldRejection } from '../payments/store-credit-fields.js';
 export const PURCHASE_ORDER_LINE_FIELDS = /* GraphQL */ `
   id
   purchaseOrderId
@@ -85,8 +86,67 @@ export const PURCHASE_ORDER_FIELDS = /* GraphQL */ `
     appliedAt
     sentAt
     sentVia
+    sentReference
   }
 `;
+/**
+ * `PurchaseOrderRevision.sentReference` (the external send's reference, per revision): an engine
+ * before it refuses every document naming it, before it runs. The same document without it reads
+ * as it did then, and each revision answers `sentReference: null`.
+ */
+function withoutSentReference(document) {
+    return document.replace(/\bsentReference\b/g, '');
+}
+/** The transports {@link sentReferenceAware} made, so wrapping one again never retries twice. */
+const SENT_REFERENCE_AWARE = new WeakSet();
+/**
+ * The transport, sending a document that names `sentReference` once more without it when the
+ * engine refused it as unknown, and only then: any other refusal, or a document that does not name
+ * it, is thrown as it came. Safe for a mutation too: a refused document never ran.
+ * `createPurchasingModule` hands this transport to every purchasing module, so any document that
+ * embeds {@link PURCHASE_ORDER_FIELDS} (purchase orders, back-to-back links, replenishment drafts)
+ * gets the one retry; each factory that embeds it wraps again, which is a no-op on a wrapped one.
+ */
+export function sentReferenceAware(transport) {
+    if (SENT_REFERENCE_AWARE.has(transport))
+        return transport;
+    const aware = {
+        async graphql(call, options) {
+            try {
+                return await transport.graphql(call, options);
+            }
+            catch (error) {
+                const legacy = withoutSentReference(call.query);
+                if (legacy === call.query || !isUnknownFieldRejection(error))
+                    throw error;
+                return transport.graphql({ ...call, query: legacy }, options);
+            }
+        },
+        rest: (service, call, options) => transport.rest(service, call, options),
+        get rateLimit() {
+            return transport.rateLimit;
+        },
+        tenant: () => transport.tenant(),
+        channel: () => transport.channel(),
+    };
+    SENT_REFERENCE_AWARE.add(aware);
+    return aware;
+}
+/**
+ * An order as answered, every revision with its `sentReference` (null from an older engine). Every
+ * method answering an order read through {@link PURCHASE_ORDER_FIELDS} passes it through this.
+ */
+export function withSentReferences(order) {
+    if (!Array.isArray(order?.revisions))
+        return order;
+    return {
+        ...order,
+        revisions: order.revisions.map((revision) => ({
+            ...revision,
+            sentReference: revision.sentReference ?? null,
+        })),
+    };
+}
 export const PURCHASE_ORDERS_QUERY = /* GraphQL */ `
   query PurchaseOrders($options: PurchaseOrderListOptions) {
     purchaseOrders(options: $options) {
@@ -198,6 +258,29 @@ export const SEND_PURCHASE_ORDER_MUTATION = /* GraphQL */ `
     }
   }
 `;
+/**
+ * The external send with what the integration knows (engine with `via: 'external'`); sent only
+ * when the caller states one, so a plain send keeps working against an older engine.
+ */
+export const SEND_PURCHASE_ORDER_EXTERNAL_MUTATION = /* GraphQL */ `
+  mutation SendPurchaseOrderExternal(
+    $id: ID!
+    $via: String!
+    $idempotencyKey: String
+    $externalReference: String
+    $transmittedAt: DateTime
+  ) {
+    sendPurchaseOrder(
+      id: $id
+      via: $via
+      idempotencyKey: $idempotencyKey
+      externalReference: $externalReference
+      transmittedAt: $transmittedAt
+    ) {
+      ${PURCHASE_ORDER_FIELDS}
+    }
+  }
+`;
 export const REVISE_PURCHASE_ORDER_MUTATION = /* GraphQL */ `
   mutation RevisePurchaseOrder($input: RevisePurchaseOrderInput!, $idempotencyKey: String) {
     revisePurchaseOrder(input: $input, idempotencyKey: $idempotencyKey) {
@@ -334,7 +417,8 @@ function picked(input, fields) {
 function linesOf(lines) {
     return lines.map((line) => picked(line, LINE_INPUT_FIELDS));
 }
-export function createPurchasingPurchaseOrdersModule(transport) {
+export function createPurchasingPurchaseOrdersModule(baseTransport) {
+    const transport = sentReferenceAware(baseTransport);
     const listPage = async (skip, take, options) => {
         const filters = options ? picked(options, LIST_FILTERS) : {};
         const data = await transport.graphql({
@@ -351,7 +435,7 @@ export function createPurchasingPurchaseOrdersModule(transport) {
     };
     const mutate = async (field, query, variables, call) => {
         const data = await transport.graphql({ api: 'admin', query, variables: { ...variables, idempotencyKey: call?.idempotencyKey } }, call);
-        return data[field];
+        return withSentReferences(data[field]);
     };
     return {
         async list(options) {
@@ -361,7 +445,7 @@ export function createPurchasingPurchaseOrdersModule(transport) {
         },
         async get(id, call) {
             const data = await transport.graphql({ api: 'admin', query: PURCHASE_ORDER_QUERY, variables: { id } }, call);
-            return data.purchaseOrder;
+            return data.purchaseOrder && withSentReferences(data.purchaseOrder);
         },
         create(input, call) {
             const fields = {
@@ -407,7 +491,8 @@ export function createPurchasingPurchaseOrdersModule(transport) {
                         idempotencyKey: options?.idempotencyKey,
                     },
                 }, options);
-                return data.importPurchaseOrderLines;
+                const result = data.importPurchaseOrderLines;
+                return { ...result, purchaseOrder: withSentReferences(result.purchaseOrder) };
             },
         },
         submit(id, call) {
@@ -428,7 +513,16 @@ export function createPurchasingPurchaseOrdersModule(transport) {
             }, options);
         },
         send(id, via, call) {
-            return mutate('sendPurchaseOrder', SEND_PURCHASE_ORDER_MUTATION, { id, via }, call);
+            const { externalReference, transmittedAt, ...rest } = call;
+            if (externalReference === undefined && transmittedAt === undefined) {
+                return mutate('sendPurchaseOrder', SEND_PURCHASE_ORDER_MUTATION, { id, via }, rest);
+            }
+            return mutate('sendPurchaseOrder', SEND_PURCHASE_ORDER_EXTERNAL_MUTATION, {
+                id,
+                via,
+                externalReference: externalReference ?? null,
+                transmittedAt: transmittedAt instanceof Date ? transmittedAt.toISOString() : (transmittedAt ?? null),
+            }, rest);
         },
         revise(id, input, call) {
             const fields = {

package/dist/purchasing/replenishment.d.ts

@@ -205,7 +205,7 @@ export declare const DELETE_REPLENISHMENT_RULE_MUTATION = "\n  mutation DeleteRe
 export declare const REPLENISHMENT_SUGGESTIONS_QUERY = "\n  query ReplenishmentSuggestions($options: ReplenishmentSuggestionListOptions) {\n    replenishmentSuggestions(options: $options) {\n      totalItems\n      items { \n  id\n  scopeId\n  legalEntityId\n  stockLocationId\n  stockLocation { id name }\n  productVariantId\n  productVariant { id sku name }\n  supplierId\n  supplier { id code name status currencyCode }\n  supplierItemId\n  method\n  available\n  onOrder\n  backordered\n  inDraft\n  target\n  suggestedBaseQuantity\n  suggestedPurchaseQuantity\n  explanation\n  isNew\n  computedAt\n  dismissedUntil\n }\n    }\n  }\n";
 export declare const COMPUTE_REPLENISHMENT_SUGGESTIONS_MUTATION = "\n  mutation ComputeReplenishmentSuggestions($idempotencyKey: String) {\n    computeReplenishmentSuggestions(idempotencyKey: $idempotencyKey) {\n      computedAt\n      localDay\n      timeZone\n      locations\n      suggestions\n      newSuggestions\n      dismissed\n      skippedLocations { stockLocationId reason }\n    }\n  }\n";
 export declare const DISMISS_REPLENISHMENT_SUGGESTION_MUTATION = "\n  mutation DismissReplenishmentSuggestion($id: ID!, $until: String, $idempotencyKey: String) {\n    dismissReplenishmentSuggestion(id: $id, until: $until, idempotencyKey: $idempotencyKey) {\n      \n  id\n  scopeId\n  legalEntityId\n  stockLocationId\n  stockLocation { id name }\n  productVariantId\n  productVariant { id sku name }\n  supplierId\n  supplier { id code name status currencyCode }\n  supplierItemId\n  method\n  available\n  onOrder\n  backordered\n  inDraft\n  target\n  suggestedBaseQuantity\n  suggestedPurchaseQuantity\n  explanation\n  isNew\n  computedAt\n  dismissedUntil\n\n    }\n  }\n";
-export declare const CREATE_REPLENISHMENT_DRAFTS_MUTATION = "\n  mutation CreateReplenishmentDrafts(\n    $input: CreateReplenishmentDraftsInput!\n    $idempotencyKey: String\n  ) {\n    createReplenishmentDrafts(input: $input, idempotencyKey: $idempotencyKey) {\n      lines\n      purchaseOrders { \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n  }\n }\n    }\n  }\n";
+export declare const CREATE_REPLENISHMENT_DRAFTS_MUTATION = "\n  mutation CreateReplenishmentDrafts(\n    $input: CreateReplenishmentDraftsInput!\n    $idempotencyKey: String\n  ) {\n    createReplenishmentDrafts(input: $input, idempotencyKey: $idempotencyKey) {\n      lines\n      purchaseOrders { \n  \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  kind\n  status\n  supplierId\n  supplier { id code name status }\n  destinationStockLocationId\n  destinationStockLocation { id name }\n  currencyCode\n  revision\n  approvedRevision\n  approvedAmount\n  requestedDeliveryOn\n  supplierReference\n  notesToSupplier\n  internalNotes\n  managedBy\n  externalId\n  externalNumber\n  externalApprovalStatus\n  sentAt\n  closedAt\n  closeReason\n  createdByRef\n  total\n  lineCount\n  confirmation\n  lines { \n  id\n  purchaseOrderId\n  position\n  productVariantId\n  supplierItemId\n  sku\n  name\n  supplierSku\n  purchaseUnitLabel\n  purchaseUnitFactor\n  orderedQuantity\n  orderedBaseQuantity\n  cancelledBaseQuantity\n  receivedBaseQuantity\n  returnedForReplacementBaseQuantity\n  unitPrice\n  discountBps\n  priceSource\n  vatRateBps\n  lineTotal\n  requestedOn\n  confirmedBaseQuantity\n  confirmedOn\n  confirmedAt\n  externalLineId\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n  statusHistory { id fromStatus status actorRef reason metadata createdAt }\n  revisions {\n    id\n    revision\n    state\n    diff\n    totalAfter\n    createdByRef\n    createdAt\n    appliedAt\n    sentAt\n    sentVia\n    sentReference\n  }\n }\n    }\n  }\n";
 export declare const IMPORT_REPLENISHMENT_RULES_MUTATION = "\n  mutation ImportReplenishmentRules(\n    $input: ImportReplenishmentRulesInput!\n    $idempotencyKey: String\n  ) {\n    importReplenishmentRules(input: $input, idempotencyKey: $idempotencyKey) {\n      dryRun\n      contentHash\n      ignoredColumns\n      totalRows\n      created\n      updated\n      unchanged\n      failed\n      rows { row sku location outcome ruleId errorCode message }\n    }\n  }\n";
 export interface ReplenishmentRulesModule {
     /**
@@ -278,4 +278,4 @@ export interface PurchasingReplenishmentModule {
     rules: ReplenishmentRulesModule;
     suggestions: ReplenishmentSuggestionsModule;
 }
-export declare function createPurchasingReplenishmentModule(transport: Transport): PurchasingReplenishmentModule;
+export declare function createPurchasingReplenishmentModule(baseTransport: Transport): PurchasingReplenishmentModule;

package/dist/purchasing/replenishment.js

@@ -1,5 +1,5 @@
 import { pageFromVendureList, readOffsetCursor, } from '@sixtyninecommerce/core';
-import { PURCHASE_ORDER_FIELDS } from './purchase-orders.js';
+import { PURCHASE_ORDER_FIELDS, sentReferenceAware, withSentReferences, } from './purchase-orders.js';
 export const REPLENISHMENT_RULE_FIELDS = /* GraphQL */ `
   id
   scopeId
@@ -135,7 +135,9 @@ function picked(input, fields) {
     }
     return out;
 }
-export function createPurchasingReplenishmentModule(transport) {
+export function createPurchasingReplenishmentModule(baseTransport) {
+    // `suggestions.createDrafts` answers its drafts through PURCHASE_ORDER_FIELDS (`sentReference`).
+    const transport = sentReferenceAware(baseTransport);
     const rulesPage = async (skip, take, options) => {
         const filters = options ? picked(options, RULE_FILTERS) : {};
         const data = await transport.graphql({
@@ -233,7 +235,8 @@ export function createPurchasingReplenishmentModule(transport) {
                         idempotencyKey: call?.idempotencyKey,
                     },
                 }, call);
-                return data.createReplenishmentDrafts;
+                const drafts = data.createReplenishmentDrafts;
+                return { ...drafts, purchaseOrders: drafts.purchaseOrders.map(withSentReferences) };
             },
         },
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sixtyninecommerce/admin",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Back-office SDK for sixtynine-commerce: every capability of the platform as a method",
   "homepage": "https://github.com/SIXTYNINE-digital/sixtynine-commerce-engine/tree/main/packages/admin-client#readme",
   "repository": {