@sixtyninecommerce/admin 0.10.0 → 0.12.0

package/dist/purchasing/receipts.js

@@ -0,0 +1,287 @@
+import { pageFromVendureList, readOffsetCursor, } from '@sixtyninecommerce/core';
+export const GOODS_RECEIPT_LINE_FIELDS = /* GraphQL */ `
+  id
+  goodsReceiptId
+  purchaseOrderId
+  purchaseOrderCode
+  purchaseOrderLineId
+  reversesLineId
+  productVariantId
+  sku
+  name
+  supplierSku
+  purchaseUnitLabel
+  purchaseUnitFactor
+  acceptedBaseQuantity
+  rejectedBaseQuantity
+  rejectReason
+  overReceiptReason
+  cancelledBaseQuantity
+  reversedBaseQuantity
+  returnedBaseQuantity
+  returnedRejectedBaseQuantity
+  supplierCurrencyCode
+  unitCostSupplierCurrency
+  fxRate
+  fxRateSource
+  fxRateDate
+  unitCostEntityCurrency
+  landedUnitCost
+  traceability { lot expiresOn serials }
+  stockMovementId
+  externalLineId
+  createdAt
+`;
+export const GOODS_RECEIPT_FIELDS = /* GraphQL */ `
+  id
+  scopeId
+  legalEntityId
+  originChannelId
+  code
+  kind
+  reversesReceiptId
+  reversesReceiptCode
+  supplierId
+  supplier { id code name status }
+  stockLocationId
+  stockLocation { id name }
+  receivedOn
+  receivedAt
+  currencyCode
+  supplierDeliveryRef
+  reason
+  managedBy
+  externalId
+  externalNumber
+  actorRef
+  createdByRef
+  reversals { id code createdAt }
+  lines { ${GOODS_RECEIPT_LINE_FIELDS} }
+  createdAt
+`;
+export const LANDED_CHARGE_FIELDS = /* GraphQL */ `
+  id
+  goodsReceiptId
+  purchaseOrderId
+  kind
+  label
+  payeeSupplierId
+  payeeSupplier { id code name status }
+  payeeName
+  currencyCode
+  amount
+  allocation
+  incurredOn
+  fxRate
+  fxRateSource
+  fxRateDate
+  amountEntityCurrency
+  allocations { goodsReceiptLineId productVariantId baseQuantity basis amount unitCostDelta }
+  appliedAt
+  removedAt
+  removeReason
+  removedByRef
+  createdByRef
+  createdAt
+`;
+/** A receipt with its landed charges: `get` and the charge writes. */
+export const GOODS_RECEIPT_DETAIL_FIELDS = /* GraphQL */ `
+  ${GOODS_RECEIPT_FIELDS}
+  charges { ${LANDED_CHARGE_FIELDS} }
+`;
+export const RECEIVABLE_LINE_FIELDS = /* GraphQL */ `
+  purchaseOrderId
+  purchaseOrderCode
+  purchaseOrderLineId
+  position
+  supplierId
+  supplier { id code name status }
+  stockLocationId
+  productVariantId
+  sku
+  name
+  supplierSku
+  supplierBarcode
+  gtin
+  purchaseUnitLabel
+  purchaseUnitFactor
+  orderedBaseQuantity
+  cancelledBaseQuantity
+  receivedBaseQuantity
+  returnedForReplacementBaseQuantity
+  remainingBaseQuantity
+  toleranceBaseQuantity
+  maxAcceptedBaseQuantity
+  confirmedBaseQuantity
+  expectedOn
+`;
+export const GOODS_RECEIPTS_QUERY = /* GraphQL */ `
+  query GoodsReceipts($options: GoodsReceiptListOptions) {
+    goodsReceipts(options: $options) {
+      items { ${GOODS_RECEIPT_FIELDS} }
+      totalItems
+    }
+  }
+`;
+export const GOODS_RECEIPT_QUERY = /* GraphQL */ `
+  query GoodsReceipt($id: ID!) {
+    goodsReceipt(id: $id) { ${GOODS_RECEIPT_DETAIL_FIELDS} }
+  }
+`;
+export const RECEIVABLE_PURCHASE_ORDER_LINES_QUERY = /* GraphQL */ `
+  query ReceivablePurchaseOrderLines($options: ReceivablePurchaseOrderLinesOptions) {
+    receivablePurchaseOrderLines(options: $options) { ${RECEIVABLE_LINE_FIELDS} }
+  }
+`;
+export const POST_GOODS_RECEIPT_MUTATION = /* GraphQL */ `
+  mutation PostGoodsReceipt($input: PostGoodsReceiptInput!, $idempotencyKey: String!) {
+    postGoodsReceipt(input: $input, idempotencyKey: $idempotencyKey) { ${GOODS_RECEIPT_FIELDS} }
+  }
+`;
+export const REVERSE_GOODS_RECEIPT_MUTATION = /* GraphQL */ `
+  mutation ReverseGoodsReceipt($input: ReverseGoodsReceiptInput!, $idempotencyKey: String!) {
+    reverseGoodsReceipt(input: $input, idempotencyKey: $idempotencyKey) {
+      ${GOODS_RECEIPT_FIELDS}
+    }
+  }
+`;
+export const ADD_GOODS_RECEIPT_CHARGE_MUTATION = /* GraphQL */ `
+  mutation AddGoodsReceiptCharge($input: AddGoodsReceiptChargeInput!, $idempotencyKey: String) {
+    addGoodsReceiptCharge(input: $input, idempotencyKey: $idempotencyKey) {
+      ${GOODS_RECEIPT_DETAIL_FIELDS}
+    }
+  }
+`;
+export const REMOVE_GOODS_RECEIPT_CHARGE_MUTATION = /* GraphQL */ `
+  mutation RemoveGoodsReceiptCharge(
+    $input: RemoveGoodsReceiptChargeInput!
+    $idempotencyKey: String
+  ) {
+    removeGoodsReceiptCharge(input: $input, idempotencyKey: $idempotencyKey) {
+      ${GOODS_RECEIPT_DETAIL_FIELDS}
+    }
+  }
+`;
+const DEFAULT_PAGE_SIZE = 25;
+const LIST_FILTERS = ['purchaseOrderId', 'supplierId', 'stockLocationId', 'kind', 'term'];
+const RECEIVABLE_FILTERS = ['supplierId', 'stockLocationId', 'purchaseOrderId'];
+const LINE_INPUT_FIELDS = [
+    'purchaseOrderLineId',
+    'acceptedBaseQuantity',
+    'rejectedBaseQuantity',
+    'rejectReason',
+    'overReceiptReason',
+    'traceability',
+];
+const CHARGE_INPUT_FIELDS = [
+    'goodsReceiptId',
+    'kind',
+    'label',
+    'payeeSupplierId',
+    'payeeName',
+    'currencyCode',
+    'amount',
+    'allocation',
+    'incurredOn',
+    'fxRate',
+];
+const POST_INPUT_FIELDS = [
+    'supplierId',
+    'stockLocationId',
+    'receivedOn',
+    'supplierDeliveryRef',
+    'fxRates',
+];
+function picked(input, fields) {
+    const out = {};
+    for (const field of fields) {
+        const value = input[field];
+        if (value !== undefined)
+            out[field] = value;
+    }
+    return out;
+}
+export function createPurchasingReceiptsModule(transport) {
+    const listPage = async (skip, take, options) => {
+        const filters = options ? picked(options, LIST_FILTERS) : {};
+        const data = await transport.graphql({
+            api: 'admin',
+            query: GOODS_RECEIPTS_QUERY,
+            variables: { options: { skip, take, ...filters } },
+        }, options);
+        return pageFromVendureList(data.goodsReceipts, skip, take, (cursor) => listPage(readOffsetCursor(cursor), take, options));
+    };
+    return {
+        async list(options) {
+            const take = options?.limit ?? DEFAULT_PAGE_SIZE;
+            const skip = options?.after === undefined ? 0 : readOffsetCursor(options.after);
+            return listPage(skip, take, options);
+        },
+        async get(id, call) {
+            const data = await transport.graphql({ api: 'admin', query: GOODS_RECEIPT_QUERY, variables: { id } }, call);
+            return data.goodsReceipt;
+        },
+        async receivable(options) {
+            const filters = options ? picked(options, RECEIVABLE_FILTERS) : {};
+            const data = await transport.graphql({
+                api: 'admin',
+                query: RECEIVABLE_PURCHASE_ORDER_LINES_QUERY,
+                variables: Object.keys(filters).length > 0 ? { options: filters } : {},
+            }, options);
+            return data.receivablePurchaseOrderLines;
+        },
+        async post(input, call) {
+            const data = await transport.graphql({
+                api: 'admin',
+                query: POST_GOODS_RECEIPT_MUTATION,
+                variables: {
+                    input: {
+                        ...picked(input, POST_INPUT_FIELDS),
+                        lines: input.lines.map((line) => picked(line, LINE_INPUT_FIELDS)),
+                    },
+                    idempotencyKey: call.idempotencyKey,
+                },
+            }, call);
+            return data.postGoodsReceipt;
+        },
+        async reverse(input, call) {
+            const data = await transport.graphql({
+                api: 'admin',
+                query: REVERSE_GOODS_RECEIPT_MUTATION,
+                variables: {
+                    input: {
+                        goodsReceiptId: input.goodsReceiptId,
+                        reason: input.reason,
+                        ...(input.lines === undefined ? {} : { lines: input.lines }),
+                    },
+                    idempotencyKey: call.idempotencyKey,
+                },
+            }, call);
+            return data.reverseGoodsReceipt;
+        },
+        charges: {
+            async add(input, call) {
+                const data = await transport.graphql({
+                    api: 'admin',
+                    query: ADD_GOODS_RECEIPT_CHARGE_MUTATION,
+                    variables: {
+                        input: picked(input, CHARGE_INPUT_FIELDS),
+                        idempotencyKey: call?.idempotencyKey,
+                    },
+                }, call);
+                return data.addGoodsReceiptCharge;
+            },
+            async remove(input, call) {
+                const data = await transport.graphql({
+                    api: 'admin',
+                    query: REMOVE_GOODS_RECEIPT_CHARGE_MUTATION,
+                    variables: {
+                        input: { chargeId: input.chargeId, reason: input.reason },
+                        idempotencyKey: call?.idempotencyKey,
+                    },
+                }, call);
+                return data.removeGoodsReceiptCharge;
+            },
+        },
+    };
+}

package/dist/purchasing/replenishment.d.ts

@@ -0,0 +1,281 @@
+import { type Page, type Transport } from '@sixtyninecommerce/core';
+import type { Call, ListOptions } from '../types.js';
+import { type PurchaseOrder } from './purchase-orders.js';
+/** The variant a rule or suggestion names, as the active store sees it. */
+export interface ReplenishmentVariant {
+    id: string;
+    sku: string;
+    name: string;
+}
+/** The stock location a rule or suggestion names. */
+export interface ReplenishmentLocation {
+    id: string;
+    name: string;
+}
+/**
+ * A reorder rule for one variant at one stock location of the legal entity (purchase-orders spec
+ * §8.13): a reorder point and an order-up-to level, or only the days of demand a sales-velocity
+ * suggestion covers. Quantities in base units (the variant's stock units).
+ */
+export interface ReplenishmentRule {
+    id: string;
+    /** The legal entity's id, or `sandbox:<channelId>` for a sandbox store, which purchases alone. */
+    scopeId: string;
+    legalEntityId: string | null;
+    productVariantId: string;
+    /** Null when the active store does not hold the variant (another store of the entity set it). */
+    productVariant: ReplenishmentVariant | null;
+    stockLocationId: string;
+    /** Null when the location has been removed since. */
+    stockLocation: ReplenishmentLocation | null;
+    /** At or below it the pair is reordered up to `maxQuantity`. */
+    minQuantity: number | null;
+    maxQuantity: number | null;
+    /** Days of demand a velocity suggestion covers; ignored when the min/max pair is set. */
+    coverDays: number | null;
+    /** A switched-off rule is computed as if there were none (the sales-velocity fallback). */
+    enabled: boolean;
+    /** ISO-8601 UTC. */
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * A rule's terms (a PUT): the quantities given replace the rule's, one left out or null is unset,
+ * `enabled` is true unless given. `minQuantity` and `maxQuantity` go together.
+ */
+export interface ReplenishmentRuleFields {
+    minQuantity?: number | null;
+    maxQuantity?: number | null;
+    coverDays?: number | null;
+    enabled?: boolean;
+}
+export interface ReplenishmentRuleListOptions extends ListOptions {
+    productVariantId?: string;
+    stockLocationId?: string;
+    enabled?: boolean;
+}
+/** The preferred supplier of a suggestion. */
+export interface ReplenishmentSupplier {
+    id: string;
+    code: string;
+    name: string;
+    status: string;
+    currencyCode: string;
+}
+/**
+ * A reorder suggestion: what the last compute found short at one stock location for one variant,
+ * grouped by the preferred supplier (`supplierId` null: choose one) and the location.
+ */
+export interface ReplenishmentSuggestion {
+    id: string;
+    scopeId: string;
+    legalEntityId: string | null;
+    stockLocationId: string;
+    /** Null when the location has been removed since. */
+    stockLocation: ReplenishmentLocation | null;
+    productVariantId: string;
+    productVariant: ReplenishmentVariant | null;
+    supplierId: string | null;
+    supplier: ReplenishmentSupplier | null;
+    supplierItemId: string | null;
+    /** `min_max` or `velocity`. A string on the wire: more methods may come. */
+    method: 'min_max' | 'velocity' | (string & {});
+    /** On hand minus allocated at the location. */
+    available: number;
+    /**
+     * On order at the location: every sent purchase order's remainder, confirmed or not, and the
+     * open lines an ERP mirrors (`stock.position`'s `onOrder`).
+     */
+    onOrder: number;
+    /** Open backorders attributed to the location. */
+    backordered: number;
+    /**
+     * Base units already on this legal entity's purchase orders for the pair that are not with the
+     * supplier yet (draft, awaiting approval, approved): shown, never subtracted. Read when the
+     * suggestion is answered.
+     */
+    inDraft: number;
+    target: number;
+    /** What the suggested order brings in: the purchase quantity times the purchase unit. */
+    suggestedBaseQuantity: number;
+    /** In the preferred supplier item's purchase units, rounded up to its minimum and multiple. */
+    suggestedPurchaseQuantity: number;
+    /**
+     * Every input of the maths (`version` 1): `stock`, `demand`, `rule`, `velocity`, `leadTime`,
+     * `reorderPoint`, `target`, `need`, `supplier`, `purchaseUnit`, `rounding`.
+     */
+    explanation: Record<string, unknown>;
+    /** Not suggested by the previous compute, or its quantity rose since. */
+    isNew: boolean;
+    /** ISO-8601 UTC. */
+    computedAt: string;
+    /** `YYYY-MM-DD` in the legal entity's zone: dismissed through that day; null when not. */
+    dismissedUntil: string | null;
+}
+export interface ReplenishmentSuggestionListOptions extends ListOptions {
+    stockLocationId?: string;
+    supplierId?: string;
+    /** Only the suggestions without a supplier (the "Choose supplier" group). */
+    withoutSupplier?: boolean;
+    productVariantId?: string;
+    /** Dismissed suggestions too; they are left out by default. */
+    includeDismissed?: boolean;
+}
+/** What a compute found. */
+export interface ReplenishmentComputeResult {
+    /** ISO-8601 UTC. */
+    computedAt: string;
+    /** `YYYY-MM-DD` in the legal entity's zone. */
+    localDay: string;
+    timeZone: string;
+    locations: number;
+    suggestions: number;
+    newSuggestions: number;
+    dismissed: number;
+    /** Locations the compute could not plan for (`LOCATION_OWNER_AMBIGUOUS`). */
+    skippedLocations: Array<{
+        stockLocationId: string;
+        reason: string;
+    }>;
+}
+/** One suggestion to order, with the quantity that replaces the suggested one. */
+export interface ReplenishmentDraftLine {
+    suggestionId: string;
+    /** Purchase units of the suggestion's supplier item; the suggested quantity when left out. */
+    purchaseQuantity?: number;
+}
+/** What `suggestions.createDrafts` raised. */
+export interface ReplenishmentDrafts {
+    /**
+     * The draft purchase orders, one per supplier and stock location, in the supplier's currency,
+     * each line priced from its supplier item's break for the quantity (unpriced when none
+     * applies). They stay drafts.
+     */
+    purchaseOrders: PurchaseOrder[];
+    /** How many suggestions they order (one line each). */
+    lines: number;
+}
+/** `rules.import`: reorder rules as CSV text (purchase-orders D100). */
+export interface ReplenishmentRuleImportInput {
+    /**
+     * The file's text: a header row naming the columns `sku`, `location`, `minQuantity`,
+     * `maxQuantity`, `coverDays`, `enabled` (any case; `min_quantity` and `Min Quantity` read as
+     * `minQuantity`), then one rule per row, the whole rule of a variant at a stock location.
+     * `location` is a stock location's id or name. Comma, semicolon or tab separated. At most 5000
+     * rows.
+     */
+    content: string;
+    /** Check every row as the import would, write nothing. */
+    dryRun?: boolean;
+}
+/** One row of a reorder-rule import. */
+export interface ReplenishmentRuleImportRow {
+    /** The row's line in the file; the header is line 1. */
+    row: number;
+    sku: string | null;
+    location: string | null;
+    /** A string on the wire: more outcomes may come. */
+    outcome: 'created' | 'updated' | 'unchanged' | 'failed' | (string & {});
+    /** The rule the row set; null when it failed before one existed. */
+    ruleId: string | null;
+    /** Why the row failed: a refusal code (`REPLENISHMENT_INVALID`, `REPLENISHMENT_VARIANT_NOT_FOUND`, …). */
+    errorCode: string | null;
+    message: string | null;
+}
+/** What a reorder-rule import did, row by row. */
+export interface ReplenishmentRuleImportResult {
+    dryRun: boolean;
+    /** `sha256` (hex) of the file as read, so a caller can recognise one it already sent. */
+    contentHash: string;
+    /** Header columns the import does not know and did not read (a typo shows up here). */
+    ignoredColumns: string[];
+    totalRows: number;
+    created: number;
+    updated: number;
+    unchanged: number;
+    failed: number;
+    /** Every row, in file order. */
+    rows: ReplenishmentRuleImportRow[];
+}
+export declare const REPLENISHMENT_RULE_FIELDS = "\n  id\n  scopeId\n  legalEntityId\n  productVariantId\n  productVariant { id sku name }\n  stockLocationId\n  stockLocation { id name }\n  minQuantity\n  maxQuantity\n  coverDays\n  enabled\n  createdAt\n  updatedAt\n";
+export declare const REPLENISHMENT_SUGGESTION_FIELDS = "\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";
+export declare const REPLENISHMENT_RULES_QUERY = "\n  query ReplenishmentRules($options: ReplenishmentRuleListOptions) {\n    replenishmentRules(options: $options) {\n      totalItems\n      items { \n  id\n  scopeId\n  legalEntityId\n  productVariantId\n  productVariant { id sku name }\n  stockLocationId\n  stockLocation { id name }\n  minQuantity\n  maxQuantity\n  coverDays\n  enabled\n  createdAt\n  updatedAt\n }\n    }\n  }\n";
+export declare const UPSERT_REPLENISHMENT_RULE_MUTATION = "\n  mutation UpsertReplenishmentRule($input: UpsertReplenishmentRuleInput!, $idempotencyKey: String) {\n    upsertReplenishmentRule(input: $input, idempotencyKey: $idempotencyKey) { \n  id\n  scopeId\n  legalEntityId\n  productVariantId\n  productVariant { id sku name }\n  stockLocationId\n  stockLocation { id name }\n  minQuantity\n  maxQuantity\n  coverDays\n  enabled\n  createdAt\n  updatedAt\n }\n  }\n";
+export declare const DELETE_REPLENISHMENT_RULE_MUTATION = "\n  mutation DeleteReplenishmentRule($id: ID!, $idempotencyKey: String) {\n    deleteReplenishmentRule(id: $id, idempotencyKey: $idempotencyKey)\n  }\n";
+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 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 {
+    /**
+     * The legal entity's reorder rules, by location then variant SKU. Pages default to 50; walking
+     * on with `.next()` or `for await` reaches every one. A credential restricted to locations sees
+     * only theirs.
+     */
+    list(options?: ReplenishmentRuleListOptions): Promise<Page<ReplenishmentRule>>;
+    /**
+     * Sets the rule of one variant at one stock location (a PUT). Refusals:
+     * `REPLENISHMENT_VARIANT_NOT_FOUND` and `REPLENISHMENT_LOCATION_NOT_FOUND` (404),
+     * `REPLENISHMENT_INVALID` (400), `LOCATION_OWNER_AMBIGUOUS` (422), `LOCATION_NOT_ALLOWED` and
+     * `SHARED_SELLER_NOT_ALLOWED` (403).
+     */
+    upsert(productVariantId: string, stockLocationId: string, fields: ReplenishmentRuleFields, call?: Call): Promise<ReplenishmentRule>;
+    /** True once removed. Refusals: `REPLENISHMENT_RULE_NOT_FOUND` (404). */
+    delete(id: string, call?: Call): Promise<boolean>;
+    /**
+     * Sets reorder rules from a CSV file (purchase-orders D100), each row the whole rule of a
+     * variant at a stock location, through the same rules as `upsert`. Every row is answered
+     * `created`, `updated`, `unchanged` or `failed` with its code (`REPLENISHMENT_VARIANT_NOT_FOUND`,
+     * `REPLENISHMENT_LOCATION_NOT_FOUND`, `REPLENISHMENT_INVALID`, `LOCATION_OWNER_AMBIGUOUS`,
+     * `LOCATION_NOT_ALLOWED`); a failed row fails alone. Importing the same file again answers every
+     * row `unchanged` and writes nothing. Refusals of the whole file: `REPLENISHMENT_INVALID` (400:
+     * not CSV, no `sku` or `location` column, a column twice, no rows, more than 5000 rows).
+     */
+    import(input: ReplenishmentRuleImportInput, call?: Call): Promise<ReplenishmentRuleImportResult>;
+}
+export interface ReplenishmentSuggestionsModule {
+    /**
+     * The legal entity's reorder suggestions from its last compute, grouped by supplier (the
+     * "Choose supplier" group last) then location. Dismissed ones are left out unless
+     * `includeDismissed`. Pages default to 50.
+     */
+    list(options?: ReplenishmentSuggestionListOptions): Promise<Page<ReplenishmentSuggestion>>;
+    /** Computes the suggestions now, replacing the last compute's (the nightly run does the same). */
+    compute(call?: Call): Promise<ReplenishmentComputeResult>;
+    /**
+     * Dismisses a suggestion through a day (`YYYY-MM-DD` in the legal entity's zone, today to a year
+     * ahead); later computes keep it. `null` undoes it. Refusals: `REPLENISHMENT_SUGGESTION_NOT_FOUND`
+     * (404), `REPLENISHMENT_INVALID` (400).
+     */
+    dismiss(id: string, until: string | null, call?: Call): Promise<ReplenishmentSuggestion>;
+    /**
+     * Raises draft purchase orders from suggestions (purchase-orders D101): one per supplier and
+     * stock location of the active store, each line the suggestion's purchase quantity (or the one
+     * given) in its supplier item's unit, priced from the item's price break for that quantity in
+     * the supplier's currency (unpriced when no break applies). The drafts stay drafts; the
+     * suggestions now show the quantities as `inDraft`. Needs `CreatePurchaseOrder`.
+     *
+     * Without `idempotencyKey` the selection itself is the key: sending the same suggestions with
+     * the same quantities again (in any order) answers the same drafts instead of raising more, for
+     * 24 hours or until the next compute, even when those drafts were cancelled since; a refused
+     * selection is not kept (fix the cause and send it again). To raise a selection again on
+     * purpose, send a key of your own per attempt.
+     *
+     * Refusals: `REPLENISHMENT_SUGGESTION_NOT_FOUND` (404: a compute replaced it; list again),
+     * `REPLENISHMENT_INVALID` (400: a suggestion in the Choose supplier group, no lines, more than
+     * 500, a quantity out of range), `LOCATION_NOT_IN_CHANNEL` (400: a location the active store
+     * does not hold; draft it from a store that does), `LOCATION_NOT_ALLOWED` and
+     * `SHARED_SELLER_NOT_ALLOWED` (403), `SUPPLIER_ARCHIVED` (422).
+     */
+    createDrafts(lines: ReplenishmentDraftLine[], call?: Call): Promise<ReplenishmentDrafts>;
+}
+/**
+ * `admin.purchasing.replenishment`: the legal entity's reorder rules (with the CSV import) and
+ * its reorder suggestions (with the draft purchase orders they raise).
+ */
+export interface PurchasingReplenishmentModule {
+    rules: ReplenishmentRulesModule;
+    suggestions: ReplenishmentSuggestionsModule;
+}
+export declare function createPurchasingReplenishmentModule(transport: Transport): PurchasingReplenishmentModule;