@sixtyninecommerce/admin 0.10.0 → 0.11.0

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

@@ -0,0 +1,548 @@
+import { type Page, type Transport } from '@sixtyninecommerce/core';
+import type { Call, ListOptions } from '../types.js';
+/**
+ * A purchase order's status (purchase-orders spec §7.3). The transitions are served by the meta
+ * catalog (`admin.meta.catalog()` → `transitions.purchase_order`). A string on the wire: more
+ * values may come.
+ */
+export type PurchaseOrderStatus = 'draft' | 'pending_approval' | 'approved' | 'sent' | 'handed_off' | 'closed' | 'cancelled' | (string & {});
+/**
+ * How far the supplier confirmed a purchase order (spec §7.3), derived from its lines:
+ * `confirmed` when every line still ordering anything is confirmed in full, `unconfirmed` when
+ * none is, `partial` between. A string on the wire: more values may come.
+ */
+export type PurchaseOrderConfirmation = 'unconfirmed' | 'partial' | 'confirmed' | (string & {});
+/** The supplier a purchase order is raised to, as it is now. */
+export interface PurchaseOrderSupplier {
+    id: string;
+    code: string;
+    name: string;
+    status: 'active' | 'archived' | (string & {});
+}
+/** The stock location a purchase order delivers to. */
+export interface PurchaseOrderLocation {
+    id: string;
+    name: string;
+}
+/**
+ * One line of a purchase order: a variant in purchase units. `sku` and `name` are snapshots
+ * taken when the line was added. Amounts are minor units of the order's currency, net of VAT.
+ */
+export interface PurchaseOrderLine {
+    id: string;
+    purchaseOrderId: string;
+    /** 1-based order on the document; a removed line leaves a gap. */
+    position: number;
+    productVariantId: string;
+    /** The supplier item the line buys from; null for an off-catalog line. */
+    supplierItemId: string | null;
+    sku: string;
+    name: string;
+    supplierSku: string | null;
+    /** The unit the supplier sells in (a carton); null for the base unit. */
+    purchaseUnitLabel: string | null;
+    /** Base (stock) units per purchase unit. */
+    purchaseUnitFactor: number;
+    /** In purchase units. */
+    orderedQuantity: number;
+    /** In base units: `orderedQuantity × purchaseUnitFactor`. */
+    orderedBaseQuantity: number;
+    cancelledBaseQuantity: number;
+    receivedBaseQuantity: number;
+    returnedForReplacementBaseQuantity: number;
+    /** Per purchase unit; null until the line is priced. */
+    unitPrice: number | null;
+    /** Basis points (100 = 1%). */
+    discountBps: number;
+    /** `catalog` or `manual`; null while the line has no price. */
+    priceSource: 'catalog' | 'manual' | (string & {}) | null;
+    /** Informational VAT in basis points; null when none applies here (import VAT, unknown). */
+    vatRateBps: number | null;
+    /** Net: quantity × unit price less the discount, rounded once; null while unpriced. */
+    lineTotal: number | null;
+    /** `YYYY-MM-DD` in the destination location's time zone. */
+    requestedOn: string | null;
+    /** Base units the supplier confirmed (`confirm`); null until it confirms the line. */
+    confirmedBaseQuantity: number | null;
+    /** The day the supplier confirmed, `YYYY-MM-DD` in the destination location's time zone. */
+    confirmedOn: string | null;
+    /** ISO-8601 UTC: when the line's confirmation was last recorded. */
+    confirmedAt: string | null;
+    externalLineId: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** One move of a purchase order's status, oldest first. */
+export interface PurchaseOrderStatusEntry {
+    id: string;
+    /** Null on the entry that records the order's creation. */
+    fromStatus: PurchaseOrderStatus | null;
+    status: PurchaseOrderStatus;
+    /** Who made the move: `<kind>:<id>` (`user:…`, `api_token:…`). */
+    actorRef: string | null;
+    /** Staff's reason: a rejection's (always), a cancellation's. */
+    reason: string | null;
+    /** The facts the move was decided on: a submit's total, threshold and exchange rate. */
+    metadata: Record<string, unknown> | null;
+    /** ISO-8601 UTC. */
+    createdAt: string;
+}
+/** How a purchase order reaches its supplier (D74): emailed by the platform, or by staff. */
+export type PurchaseOrderSendVia = 'email' | 'manual';
+/**
+ * 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.
+ */
+export interface PurchaseOrderRevision {
+    id: string;
+    /** The number the order carries once it is applied; 0 is the original. */
+    revision: number;
+    state: 'staged' | 'pending_approval' | 'applied' | 'discarded' | (string & {});
+    /**
+     * The change set: `header` (each field `{ from, to }`), `lines.added` / `changed` / `removed`,
+     * `totalBefore`, the `approval` it was decided on, and `approved` / `discarded` (who, when).
+     * Empty for revision 0.
+     */
+    diff: Record<string, unknown>;
+    /** Net, minor units of the order's currency, once applied. */
+    totalAfter: number | null;
+    createdByRef: string | null;
+    /** ISO-8601 UTC. */
+    createdAt: string;
+    appliedAt: string | null;
+    /** When its document went to the supplier; null until sent. */
+    sentAt: string | null;
+    sentVia: PurchaseOrderSendVia | (string & {}) | null;
+}
+/** A five-minute link to a purchase order's PDF. */
+export interface PurchaseOrderDocumentUrl {
+    url: string;
+    /** ISO-8601 UTC. */
+    expiresAt: string;
+    filename: string;
+    /** The revision the document shows. */
+    revision: number;
+}
+/**
+ * A purchase order of the active store's PURCHASING SCOPE (purchase-orders spec §7.1): its legal
+ * entity, shared by every store of that entity, or a sandbox store's own scope. Cancelled, never
+ * deleted.
+ */
+export interface PurchaseOrder {
+    id: string;
+    /** The legal entity's id, or `sandbox:<channelId>` for a sandbox store. */
+    scopeId: string;
+    /** The legal entity (Seller) id; null for a sandbox store's own scope. */
+    legalEntityId: string | null;
+    /** The store that raised it; its `purchase_order.*` events are filed under it. */
+    originChannelId: string;
+    /** The purchase-order number, unique in the legal entity (`PO-2026-0001`). */
+    code: string;
+    /** `standard` or `drop_ship`. */
+    kind: 'standard' | 'drop_ship' | (string & {});
+    status: PurchaseOrderStatus;
+    supplierId: string;
+    /** The supplier as it is now. */
+    supplier: PurchaseOrderSupplier | null;
+    destinationStockLocationId: string | null;
+    /** The destination as it is now; null for a drop-ship order or a location since removed. */
+    destinationStockLocation: PurchaseOrderLocation | null;
+    /** ISO 4217: what the supplier is paid in; the unit prices are stated in it. */
+    currencyCode: string;
+    /** Applied revisions; 0 for the original. */
+    revision: number;
+    approvedRevision: number | null;
+    /** The net total last approved, minor units; null until approved. */
+    approvedAmount: number | null;
+    /** `YYYY-MM-DD` in the destination location's time zone. */
+    requestedDeliveryOn: string | null;
+    supplierReference: string | null;
+    /** Printed on the purchase order the supplier receives. */
+    notesToSupplier: string | null;
+    /** Staff only; never sent to the supplier. */
+    internalNotes: string | null;
+    /** The purchasing provider that manages it; null in Standalone mode. */
+    managedBy: string | null;
+    externalId: string | null;
+    externalNumber: string | null;
+    externalApprovalStatus: string | null;
+    sentAt: string | null;
+    closedAt: string | null;
+    closeReason: string | null;
+    /** Who raised it: `<kind>:<id>`. */
+    createdByRef: string | null;
+    /** Net, minor units: the sum of the priced lines. */
+    total: number;
+    lineCount: number;
+    /** How far the supplier confirmed it. */
+    confirmation: PurchaseOrderConfirmation;
+    lines: PurchaseOrderLine[];
+    /** Every move of its status, oldest first. */
+    statusHistory: PurchaseOrderStatusEntry[];
+    /** Its revisions, oldest first (empty in a list page: read one with `get`). */
+    revisions: PurchaseOrderRevision[];
+    /** ISO-8601 UTC. */
+    createdAt: string;
+    updatedAt: string;
+}
+/** A line to add. The quantity is in purchase units. */
+export interface PurchaseOrderLineInput {
+    productVariantId: string;
+    /** 1 to 1,000,000 purchase units. */
+    orderedQuantity: number;
+    /**
+     * Minor units per purchase unit (`priceSource: 'manual'`). Left out: the supplier catalogue's
+     * price applies when it has one, else the line starts unpriced and must be priced before submit.
+     */
+    unitPrice?: number;
+    /** 0 to 10,000 basis points; 0 when left out. */
+    discountBps?: number;
+    /** `YYYY-MM-DD`. */
+    requestedOn?: string;
+}
+export interface PurchaseOrderHeaderFields {
+    /** `YYYY-MM-DD` in the destination location's time zone; `null` clears it. */
+    requestedDeliveryOn?: string | null;
+    /** At most 255 characters; `null` clears it. */
+    supplierReference?: string | null;
+    /** At most 5000 characters; `null` clears it. */
+    notesToSupplier?: string | null;
+    /** At most 5000 characters; `null` clears it. */
+    internalNotes?: string | null;
+}
+export interface CreatePurchaseOrderInput extends PurchaseOrderHeaderFields {
+    /** An active supplier of the purchasing scope. */
+    supplierId: string;
+    /**
+     * A stock location of this store owned by its legal entity. Left out: the call's
+     * `tenant.location` (`x-location`), else the store's only stock location.
+     */
+    destinationStockLocationId?: string;
+    /** Defaults to the supplier's currency. Fixed once created. */
+    currencyCode?: string;
+    /** At most 100 lines in one call, 500 on one order. */
+    lines?: PurchaseOrderLineInput[];
+}
+/** A PATCH of a draft's header. The supplier and the currency are fixed when it is created. */
+export interface UpdatePurchaseOrderInput extends PurchaseOrderHeaderFields {
+    destinationStockLocationId?: string;
+}
+/** A PATCH of a draft's line. `unitPrice: null` takes the price away again. */
+export interface UpdatePurchaseOrderLineInput {
+    orderedQuantity?: number;
+    unitPrice?: number | null;
+    discountBps?: number;
+    requestedOn?: string | null;
+}
+export interface PurchaseOrderListOptions extends ListOptions {
+    /** Any of these statuses; every status when left out. */
+    statuses?: PurchaseOrderStatus[];
+    supplierId?: string;
+    destinationStockLocationId?: string;
+    /** Matches the number or the supplier's reference, case-insensitively, as typed. */
+    term?: string;
+}
+/** A cancellation, with the staff's reason kept in the order's status history. */
+export interface PurchaseOrderCancelOptions extends Call {
+    reason?: string;
+    /**
+     * `true` emails a SENT order's supplier the cancellation ("Purchase Order Cancelled", to the
+     * order contact, else the order email); left out or `false`, nothing is emailed (tell the
+     * supplier yourself). A draft or an approved order never reached the supplier, so nothing is
+     * emailed for it either way. Needs an engine with purchase-order cancellation emails when given.
+     */
+    notifySupplier?: boolean;
+}
+/** A reopen or a revision's discard, with the staff's optional reason. */
+export interface PurchaseOrderReasonOptions extends Call {
+    reason?: string;
+}
+/** Which revision's document (`document`); the latest sent one when left out. */
+export interface PurchaseOrderDocumentOptions extends Call {
+    revision?: number;
+}
+/**
+ * A revision of a SENT purchase order (spec §8.4.4), as one change set. A field left out is kept.
+ * The supplier, the currency and staff's own fields (`supplierReference`, `internalNotes`) are not
+ * revised.
+ */
+export interface PurchaseOrderRevisionInput {
+    destinationStockLocationId?: string;
+    /** `YYYY-MM-DD`; `null` clears it. */
+    requestedDeliveryOn?: string | null;
+    /** `null` clears it. */
+    notesToSupplier?: string | null;
+    /** New lines; each must state its `unitPrice` (a sent order has no unpriced line). */
+    addLines?: PurchaseOrderLineInput[];
+    /** A PATCH per line, by its id; `unitPrice` may not be cleared. */
+    updateLines?: Array<UpdatePurchaseOrderLineInput & {
+        id: string;
+    }>;
+    /** Lines to take off the order (refused for a line with receipts). */
+    removeLineIds?: string[];
+}
+/** One line of a supplier's confirmation (spec §8.5). */
+export interface PurchaseOrderLineConfirmationInput {
+    lineId: string;
+    /**
+     * Base units the supplier confirmed, 0 included (it cannot deliver it now), at most what the
+     * line still orders; `null` withdraws the line's confirmation.
+     */
+    confirmedBaseQuantity: number | null;
+    /** `YYYY-MM-DD`; left out: the supplier gave no day. */
+    confirmedOn?: string | null;
+}
+/**
+ * A supplier's confirmation of a SENT order. A line named is confirmed whole (its quantity and day
+ * replace what it had); a line not named keeps its confirmation.
+ */
+export interface PurchaseOrderConfirmationInput {
+    /** The supplier's own reference (its order number), at most 255 characters; `null` clears it. */
+    supplierReference?: string | null;
+    lines?: PurchaseOrderLineConfirmationInput[];
+}
+/** A line import (`lines.import`): `dryRun` answers what it would do and writes nothing. */
+export interface PurchaseOrderLineImportOptions extends Call {
+    dryRun?: boolean;
+}
+/** What one row of a line import did. */
+export interface PurchaseOrderLineImportRow {
+    /** The row's line in the file (the header is line 1). */
+    row: number;
+    sku: string | null;
+    supplierSku: string | null;
+    outcome: 'created' | 'updated' | 'unchanged' | 'failed' | (string & {});
+    /** The line the row created or matched; null for a failed row, and a created one on a dry run. */
+    lineId: string | null;
+    /** Why the row failed: `PURCHASE_ORDER_INVALID`, `PURCHASING_VARIANT_NOT_FOUND`. */
+    errorCode: string | null;
+    message: string | null;
+}
+/** What a line import did, row by row, and the order after it. */
+export interface PurchaseOrderLineImportResult {
+    dryRun: boolean;
+    /** sha256 of the file as read: the same file imported again changes nothing. */
+    contentHash: string;
+    /** Header cells the import does not know, as the file spells them. */
+    ignoredColumns: string[];
+    totalRows: number;
+    created: number;
+    updated: number;
+    unchanged: number;
+    failed: number;
+    rows: PurchaseOrderLineImportRow[];
+    purchaseOrder: PurchaseOrder;
+}
+/** A call that must carry its idempotency key (spec §10.1: `approve` requires one). */
+export type PurchaseOrderKeyedCall = Call & {
+    idempotencyKey: 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
+ * list selects, so a page stays one round of reads.
+ */
+export declare const PURCHASE_ORDER_SUMMARY_FIELDS = "\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";
+/**
+ * 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_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";
+/**
+ * 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 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";
+/** A draft's lines. Each write needs `UpdatePurchaseOrder` on every store of the legal entity. */
+export interface PurchaseOrderLinesModule {
+    /**
+     * Adds lines after the last one (at most 100 per call, 500 on an order) and answers the order.
+     * Refusals: `PURCHASE_ORDER_NOT_FOUND` (404), `PURCHASING_VARIANT_NOT_FOUND` (404, a variant
+     * not in this store), `PURCHASE_ORDER_NOT_EDITABLE` (422, not a draft),
+     * `PURCHASE_ORDER_INVALID` (400).
+     */
+    add(purchaseOrderId: string, lines: PurchaseOrderLineInput[], call?: Call): Promise<PurchaseOrder>;
+    /**
+     * Changes one line (a PATCH) and answers the order. Refusals: `PURCHASE_ORDER_LINE_NOT_FOUND`
+     * (404), `PURCHASE_ORDER_NOT_EDITABLE` (422), `PURCHASE_ORDER_INVALID` (400).
+     */
+    update(lineId: string, input: UpdatePurchaseOrderLineInput, call?: Call): Promise<PurchaseOrder>;
+    /**
+     * Removes one line and answers the order. Refusals: `PURCHASE_ORDER_LINE_NOT_FOUND` (404),
+     * `PURCHASE_ORDER_NOT_EDITABLE` (422).
+     */
+    remove(lineId: string, call?: Call): Promise<PurchaseOrder>;
+    /**
+     * Imports lines into a draft from CSV (spec §8.2): a header row names the columns, `sku` or
+     * `supplierSku` (the supplier's, through its catalog) per row, `quantity` in purchase units, and
+     * optionally `unitPrice` (a decimal of the order's currency per purchase unit; `12,50` reads in a
+     * `;` or tab file) and `requestedOn`. Each row adds the line for its variant, or changes the
+     * order's line for it, so the same file imported again changes nothing (every row
+     * `unchanged`). A bad row fails alone (`rows[].errorCode`); the rest apply. Refused whole,
+     * `PURCHASE_ORDER_INVALID` (400): a file that is no line list, or one taking the order past
+     * 500 lines; `PURCHASE_ORDER_NOT_EDITABLE` (422) for an order no longer a draft.
+     */
+    import(purchaseOrderId: string, content: string, options?: PurchaseOrderLineImportOptions): Promise<PurchaseOrderLineImportResult>;
+}
+/**
+ * A sent order's revision waiting for approval (spec §8.3). Each write answers the order.
+ */
+export interface PurchaseOrderRevisionsModule {
+    /**
+     * Approves the revision waiting for approval and applies it; its total becomes the approved
+     * amount (`ApprovePurchaseOrder` on every store of the legal entity). Refusals:
+     * `PURCHASE_ORDER_REVISION_NOT_FOUND` (404, none waits), `LINE_BELOW_RECEIVED` (422, goods
+     * arrived meanwhile).
+     */
+    approve(purchaseOrderId: string, call?: Call): Promise<PurchaseOrder>;
+    /**
+     * Discards the revision waiting for approval: an approver rejecting it or staff withdrawing it
+     * (`UpdatePurchaseOrder` or `ApprovePurchaseOrder`). The order keeps its last applied revision.
+     * Refusal: `PURCHASE_ORDER_REVISION_NOT_FOUND` (404).
+     */
+    discard(purchaseOrderId: string, options?: PurchaseOrderReasonOptions): Promise<PurchaseOrder>;
+}
+/**
+ * `admin.purchasing.purchaseOrders` (purchase-orders spec §7.3, §8.2, §8.3, §10.1). Every method
+ * needs the Purchasing plugin on the store AND purchasing switched on for its legal entity
+ * (`PURCHASING_NOT_ENABLED`, 422; `PLUGIN_ACCESS_DENIED`, 403, for an ordinary caller without the
+ * plugin), and a store that purchases (`HUB_HAS_NO_PURCHASING`, `LEGAL_ENTITY_REQUIRED`, 422).
+ *
+ * Reads need `ReadPurchaseOrder`. The purchase orders are every store's of the legal entity, so
+ * every write needs its permission on EVERY store of it (`SHARED_SELLER_NOT_ALLOWED`, 403; a
+ * sandbox store is its own scope): `CreatePurchaseOrder` to create, `UpdatePurchaseOrder` to
+ * change a draft and submit it, `ApprovePurchaseOrder` to approve or reject, `DeletePurchaseOrder`
+ * to cancel. There is no hard delete.
+ *
+ * Every write takes `{ idempotencyKey?, tenant? }` (`approve` requires the key): a repeat under
+ * one key answers the first call's result, a different body under it `IDEMPOTENCY_CONFLICT`
+ * (409). An intent the order's status does not allow is `PURCHASE_ORDER_INVALID_TRANSITION`
+ * (422); `details[0]` (`field: 'status'`, `code: 'INVALID_TRANSITION'`) names the intents the
+ * status does allow (the meta catalog's `transitions.purchase_order` is the machine).
+ */
+export interface PurchasingPurchaseOrdersModule {
+    /**
+     * The scope's purchase orders, newest first, without their status history (`statusHistory` is
+     * empty: read one with `get`). Pages default to 50; a `limit` above 100 is refused
+     * `PURCHASE_ORDER_INVALID` (400); walking on with `.next()` or `for await` reaches every one.
+     */
+    list(options?: PurchaseOrderListOptions): Promise<Page<PurchaseOrder>>;
+    /** Null when the scope has no purchase order with that id (another legal entity's included). */
+    get(id: string, call?: Call): Promise<PurchaseOrder | null>;
+    /**
+     * Creates a draft numbered from the scope's `purchase_order` series. Refusals:
+     * `SUPPLIER_NOT_FOUND` (404), `SUPPLIER_ARCHIVED` (422),
+     * `LOCATION_NOT_IN_CHANNEL` (400), `STOCK_LOCATION_REQUIRED` (422, several locations and none
+     * named), `LOCATION_NOT_ALLOWED` (403, a credential restricted away from it),
+     * `LOCATION_NOT_OWNED_BY_ENTITY`, `LOCATION_OWNER_AMBIGUOUS` (422),
+     * `PURCHASING_VARIANT_NOT_FOUND` (404), `PURCHASE_ORDER_INVALID` (400).
+     */
+    create(input: CreatePurchaseOrderInput, call?: Call): Promise<PurchaseOrder>;
+    /** Changes a draft's header (a PATCH). Refusals as `create`, plus `PURCHASE_ORDER_NOT_EDITABLE`. */
+    update(id: string, input: UpdatePurchaseOrderInput, call?: Call): Promise<PurchaseOrder>;
+    lines: PurchaseOrderLinesModule;
+    /**
+     * Submits a draft: with an approval threshold (`settings.approvalThreshold`) a net total above
+     * it, in the purchasing currency at the platform rate of the submit day, waits for an approver
+     * (`pending_approval`); at or below it, or with approval off, it is `approved`. Refusals:
+     * `PURCHASE_ORDER_INCOMPLETE` (422: no lines, or lines without a price; `details` has one entry
+     * per unpriced line, `field: 'lines/<lineId>'`, `code: 'UNPRICED'`),
+     * `FX_RATE_UNAVAILABLE` (422: no rate for a foreign currency).
+     */
+    submit(id: string, call?: Call): Promise<PurchaseOrder>;
+    /** Approves an order waiting for approval (`ApprovePurchaseOrder`); its creator may approve it. */
+    approve(id: string, call: PurchaseOrderKeyedCall): Promise<PurchaseOrder>;
+    /** Sends an order waiting for approval back to draft, with the reason (required). */
+    reject(id: string, reason: string, call?: Call): Promise<PurchaseOrder>;
+    /**
+     * Cancels a draft, an approved order, or a sent one with nothing received
+     * (`DeletePurchaseOrder`); it stays, with its history. A sent order with receipts is refused
+     * `PURCHASE_ORDER_HAS_RECEIPTS` (422): `close` it instead. With `notifySupplier: true` a sent
+     * order's supplier is emailed the cancellation; that email is checked before anything changes,
+     * as `send`'s is: `SUPPLIER_HAS_NO_ORDER_EMAIL` or `SUPPLIER_EMAIL_UNDELIVERABLE` (422,
+     * `details[0]` with `field: 'notifySupplier'`).
+     */
+    cancel(id: string, options?: PurchaseOrderCancelOptions): Promise<PurchaseOrder>;
+    /**
+     * 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:
+     * `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>;
+    /**
+     * 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
+     * platform rate of the day) and above the threshold it waits (`revisions[].state
+     * 'pending_approval'`) for `revisions.approve`. Applied revisions reach the supplier through
+     * `send`. Refusals: `PURCHASE_ORDER_REVISION_PENDING` (422, one already waits),
+     * `LINE_BELOW_RECEIVED` (422; `details` names each line), `PURCHASE_ORDER_LINE_NOT_FOUND`
+     * (404), `FX_RATE_UNAVAILABLE` (422), `PURCHASE_ORDER_INVALID` (400, a revision that changes
+     * nothing included).
+     */
+    revise(id: string, input: PurchaseOrderRevisionInput, call?: Call): Promise<PurchaseOrder>;
+    revisions: PurchaseOrderRevisionsModule;
+    /**
+     * Records the supplier's confirmation of a SENT order (`UpdatePurchaseOrder`; spec §8.5): its
+     * reference, and per named line the base units and the day it confirmed (a re-confirmation
+     * replaces the line's; `confirmedBaseQuantity: null` withdraws it). Only confirmed quantities
+     * still to come are incoming stock; each change publishes `purchase_order.confirmed`, and a
+     * confirmation restating what is stored changes nothing. Refusals: `CONFIRMED_ABOVE_ORDERED`
+     * (422, a line confirmed above what it still orders; `details` names each),
+     * `PURCHASE_ORDER_LINE_NOT_FOUND` (404), `PURCHASE_ORDER_INVALID_TRANSITION` (422, not sent),
+     * `PURCHASE_ORDER_INVALID` (400).
+     */
+    confirm(id: string, input: PurchaseOrderConfirmationInput, call?: Call): Promise<PurchaseOrder>;
+    /**
+     * Duplicates an order, in any status, into a new draft (`CreatePurchaseOrder`): the same
+     * supplier, destination, currency, notes to the supplier and lines; a manual price is kept, a
+     * catalogue one taken again on today's break. A line whose variant the store no longer holds is
+     * left out (the copy's creation entry in `statusHistory` names it). Refusals:
+     * `PURCHASE_ORDER_NOT_FOUND` (404), `SUPPLIER_ARCHIVED` (422), the destination's location
+     * refusals.
+     */
+    duplicate(id: string, call?: Call): Promise<PurchaseOrder>;
+    /**
+     * Closes a sent order short (`UpdatePurchaseOrder`; spec §8.8): every remainder is cancelled,
+     * the order is `closed` with the reason (required).
+     */
+    close(id: string, reason: string, call?: Call): Promise<PurchaseOrder>;
+    /**
+     * Reopens a closed order that is not fully received (`UpdatePurchaseOrder`; spec §7.3): what
+     * the close cancelled is open again. A fully received order is refused
+     * `PURCHASE_ORDER_INVALID_TRANSITION` (`details[0].code: 'RECEIPT_COMPLETE'`).
+     */
+    reopen(id: string, options?: PurchaseOrderReasonOptions): Promise<PurchaseOrder>;
+    /**
+     * A five-minute link to a sent revision's PDF (`ReadPurchaseOrder`), the latest sent one when
+     * `revision` is left out. Refusal: `PURCHASE_ORDER_DOCUMENT_NOT_FOUND` (404, never sent).
+     */
+    document(id: string, options?: PurchaseOrderDocumentOptions): Promise<PurchaseOrderDocumentUrl>;
+}
+export declare function createPurchasingPurchaseOrdersModule(transport: Transport): PurchasingPurchaseOrdersModule;