@sixtyninecommerce/admin 0.10.0 → 0.12.0

package/dist/purchasing/suppliers.d.ts

@@ -0,0 +1,476 @@
+import { type Page, type Transport } from '@sixtyninecommerce/core';
+import type { Call, ListOptions } from '../types.js';
+/** A supplier's postal address. Every part may be null. */
+export interface SupplierAddress {
+    streetLine1: string | null;
+    streetLine2: string | null;
+    postalCode: string | null;
+    city: string | null;
+    province: string | null;
+    /** Upper-case ISO 3166-1 alpha-2. */
+    countryCode: string | null;
+}
+/** A person at a supplier: the merchant's business contact, never a customer. */
+export interface SupplierContact {
+    id: string;
+    supplierId: string;
+    name: string;
+    email: string | null;
+    phone: string | null;
+    /** What the person does for the supplier (`Sales`, `Accounts`). */
+    role: string | null;
+    /** Whether purchase orders go to this person: at most one per supplier, marking one clears the others. */
+    isOrderContact: boolean;
+    /** ISO-8601 UTC. */
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * A supplier of the active store's PURCHASING SCOPE: its legal entity, shared by every store of
+ * that entity, or a sandbox store's own scope (purchase-orders spec §7.1). Archived, never
+ * deleted.
+ */
+export interface Supplier {
+    id: string;
+    /** The legal entity's id, or `sandbox:<channelId>` for a sandbox store, which purchases alone. */
+    scopeId: string;
+    /** The legal entity (Seller) id; null for a sandbox store's own scope. */
+    legalEntityId: string | null;
+    /** The store that created the supplier; its `supplier.changed` events are filed under it. */
+    originChannelId: string;
+    /** Unique in the purchasing scope. */
+    code: string;
+    name: string;
+    legalName: string | null;
+    vatNumber: string | null;
+    /** How purchases from it are taxed. A string on the wire: more values may come. */
+    vatTreatment: 'domestic' | 'intra_eu' | 'import' | 'exempt' | (string & {});
+    /** Upper-case ISO 3166-1 alpha-2. */
+    countryCode: string | null;
+    /** ISO 4217: what the supplier invoices in. */
+    currencyCode: string;
+    /** The terms as the supplier states them. */
+    paymentTerms: string | null;
+    paymentTermsDays: number | null;
+    /** An Incoterms 2020 rule (`EXW`, `DAP`, …). */
+    incoterm: string | null;
+    defaultLeadTimeDays: number | null;
+    /** Null: the purchasing default (`settings.defaultOverReceiptTolerancePct`) applies. */
+    overReceiptTolerancePct: number | null;
+    /** The supplier ships no backorders: a short delivery cancels the rest of the line. */
+    noBackorders: boolean;
+    orderEmail: string | null;
+    address: SupplierAddress | null;
+    notes: string | null;
+    /** `active` or `archived`. A string on the wire: more values may come. */
+    status: 'active' | 'archived' | (string & {});
+    /** The purchasing provider that manages it; null in Standalone mode. */
+    managedBy: string | null;
+    contacts: SupplierContact[];
+    /** ISO-8601 UTC. */
+    createdAt: string;
+    updatedAt: string;
+}
+/** The address as a write takes it: it replaces the whole address, a part left out is cleared. */
+export type SupplierAddressInput = Partial<SupplierAddress>;
+/**
+ * The supplier fields a write may set. Values are trimmed by the engine; an optional one sent
+ * `null` or empty is cleared.
+ */
+export interface SupplierFields {
+    legalName?: string | null;
+    vatNumber?: string | null;
+    vatTreatment?: 'domestic' | 'intra_eu' | 'import' | 'exempt';
+    /** Upper-case ISO 3166-1 alpha-2. */
+    countryCode?: string | null;
+    /** ISO 4217, upper case. */
+    currencyCode?: string;
+    paymentTerms?: string | null;
+    /** 0 to 365. */
+    paymentTermsDays?: number | null;
+    /** An Incoterms 2020 rule. */
+    incoterm?: string | null;
+    /** 0 to 365. */
+    defaultLeadTimeDays?: number | null;
+    /** 0 to 100, at most two decimals; null for the purchasing default. */
+    overReceiptTolerancePct?: number | null;
+    noBackorders?: boolean;
+    orderEmail?: string | null;
+    address?: SupplierAddressInput | null;
+    /** At most 5000 characters. */
+    notes?: string | null;
+}
+export interface CreateSupplierInput extends SupplierFields {
+    /** Unique in the purchasing scope; at most 64 characters. */
+    code: string;
+    name: string;
+}
+/** A PATCH: a field left out is kept; `null` clears an optional field. */
+export interface UpdateSupplierInput extends SupplierFields {
+    code?: string;
+    name?: string;
+}
+export interface SupplierContactFields {
+    email?: string | null;
+    phone?: string | null;
+    role?: string | null;
+    isOrderContact?: boolean;
+}
+export interface CreateSupplierContactInput extends SupplierContactFields {
+    name: string;
+}
+/** A PATCH: a field left out is kept; `null` clears an optional field. */
+export interface UpdateSupplierContactInput extends SupplierContactFields {
+    name?: string;
+}
+export interface SupplierListOptions extends ListOptions {
+    /** Only `active` or only `archived` suppliers; both when left out. */
+    status?: 'active' | 'archived';
+    /** Matches the name, case-insensitively, as typed. */
+    name?: string;
+    /** The exact code. */
+    code?: string;
+    /** Matches the name, code or legal name, case-insensitively, as typed. */
+    term?: string;
+}
+/** An archive or restore, with the staff's reason kept in the supplier's status history. */
+export interface SupplierStatusOptions extends Call {
+    reason?: string;
+}
+export declare const SUPPLIER_CONTACT_FIELDS = "\n  id\n  supplierId\n  name\n  email\n  phone\n  role\n  isOrderContact\n  createdAt\n  updatedAt\n";
+export declare const SUPPLIER_FIELDS = "\n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  name\n  legalName\n  vatNumber\n  vatTreatment\n  countryCode\n  currencyCode\n  paymentTerms\n  paymentTermsDays\n  incoterm\n  defaultLeadTimeDays\n  overReceiptTolerancePct\n  noBackorders\n  orderEmail\n  address { streetLine1 streetLine2 postalCode city province countryCode }\n  notes\n  status\n  managedBy\n  contacts { \n  id\n  supplierId\n  name\n  email\n  phone\n  role\n  isOrderContact\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n";
+export declare const SUPPLIERS_QUERY = "\n  query Suppliers($options: SupplierListOptions) {\n    suppliers(options: $options) {\n      totalItems\n      items { \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  name\n  legalName\n  vatNumber\n  vatTreatment\n  countryCode\n  currencyCode\n  paymentTerms\n  paymentTermsDays\n  incoterm\n  defaultLeadTimeDays\n  overReceiptTolerancePct\n  noBackorders\n  orderEmail\n  address { streetLine1 streetLine2 postalCode city province countryCode }\n  notes\n  status\n  managedBy\n  contacts { \n  id\n  supplierId\n  name\n  email\n  phone\n  role\n  isOrderContact\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n }\n    }\n  }\n";
+export declare const SUPPLIER_QUERY = "\n  query Supplier($id: ID!) {\n    supplier(id: $id) { \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  name\n  legalName\n  vatNumber\n  vatTreatment\n  countryCode\n  currencyCode\n  paymentTerms\n  paymentTermsDays\n  incoterm\n  defaultLeadTimeDays\n  overReceiptTolerancePct\n  noBackorders\n  orderEmail\n  address { streetLine1 streetLine2 postalCode city province countryCode }\n  notes\n  status\n  managedBy\n  contacts { \n  id\n  supplierId\n  name\n  email\n  phone\n  role\n  isOrderContact\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n }\n  }\n";
+export declare const CREATE_SUPPLIER_MUTATION = "\n  mutation CreateSupplier($input: CreateSupplierInput!, $idempotencyKey: String) {\n    createSupplier(input: $input, idempotencyKey: $idempotencyKey) { \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  name\n  legalName\n  vatNumber\n  vatTreatment\n  countryCode\n  currencyCode\n  paymentTerms\n  paymentTermsDays\n  incoterm\n  defaultLeadTimeDays\n  overReceiptTolerancePct\n  noBackorders\n  orderEmail\n  address { streetLine1 streetLine2 postalCode city province countryCode }\n  notes\n  status\n  managedBy\n  contacts { \n  id\n  supplierId\n  name\n  email\n  phone\n  role\n  isOrderContact\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n }\n  }\n";
+export declare const UPDATE_SUPPLIER_MUTATION = "\n  mutation UpdateSupplier($input: UpdateSupplierInput!, $idempotencyKey: String) {\n    updateSupplier(input: $input, idempotencyKey: $idempotencyKey) { \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  name\n  legalName\n  vatNumber\n  vatTreatment\n  countryCode\n  currencyCode\n  paymentTerms\n  paymentTermsDays\n  incoterm\n  defaultLeadTimeDays\n  overReceiptTolerancePct\n  noBackorders\n  orderEmail\n  address { streetLine1 streetLine2 postalCode city province countryCode }\n  notes\n  status\n  managedBy\n  contacts { \n  id\n  supplierId\n  name\n  email\n  phone\n  role\n  isOrderContact\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n }\n  }\n";
+export declare const ARCHIVE_SUPPLIER_MUTATION = "\n  mutation ArchiveSupplier($id: ID!, $reason: String, $idempotencyKey: String) {\n    archiveSupplier(id: $id, reason: $reason, idempotencyKey: $idempotencyKey) {\n      \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  name\n  legalName\n  vatNumber\n  vatTreatment\n  countryCode\n  currencyCode\n  paymentTerms\n  paymentTermsDays\n  incoterm\n  defaultLeadTimeDays\n  overReceiptTolerancePct\n  noBackorders\n  orderEmail\n  address { streetLine1 streetLine2 postalCode city province countryCode }\n  notes\n  status\n  managedBy\n  contacts { \n  id\n  supplierId\n  name\n  email\n  phone\n  role\n  isOrderContact\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n    }\n  }\n";
+export declare const RESTORE_SUPPLIER_MUTATION = "\n  mutation RestoreSupplier($id: ID!, $reason: String, $idempotencyKey: String) {\n    restoreSupplier(id: $id, reason: $reason, idempotencyKey: $idempotencyKey) {\n      \n  id\n  scopeId\n  legalEntityId\n  originChannelId\n  code\n  name\n  legalName\n  vatNumber\n  vatTreatment\n  countryCode\n  currencyCode\n  paymentTerms\n  paymentTermsDays\n  incoterm\n  defaultLeadTimeDays\n  overReceiptTolerancePct\n  noBackorders\n  orderEmail\n  address { streetLine1 streetLine2 postalCode city province countryCode }\n  notes\n  status\n  managedBy\n  contacts { \n  id\n  supplierId\n  name\n  email\n  phone\n  role\n  isOrderContact\n  createdAt\n  updatedAt\n }\n  createdAt\n  updatedAt\n\n    }\n  }\n";
+export declare const CREATE_SUPPLIER_CONTACT_MUTATION = "\n  mutation CreateSupplierContact($input: CreateSupplierContactInput!, $idempotencyKey: String) {\n    createSupplierContact(input: $input, idempotencyKey: $idempotencyKey) {\n      \n  id\n  supplierId\n  name\n  email\n  phone\n  role\n  isOrderContact\n  createdAt\n  updatedAt\n\n    }\n  }\n";
+export declare const UPDATE_SUPPLIER_CONTACT_MUTATION = "\n  mutation UpdateSupplierContact($input: UpdateSupplierContactInput!, $idempotencyKey: String) {\n    updateSupplierContact(input: $input, idempotencyKey: $idempotencyKey) {\n      \n  id\n  supplierId\n  name\n  email\n  phone\n  role\n  isOrderContact\n  createdAt\n  updatedAt\n\n    }\n  }\n";
+export declare const DELETE_SUPPLIER_CONTACT_MUTATION = "\n  mutation DeleteSupplierContact($id: ID!, $idempotencyKey: String) {\n    deleteSupplierContact(id: $id, idempotencyKey: $idempotencyKey)\n  }\n";
+/** One price break of a supplier item: from `minQuantity` purchase units on, `unitPrice` each. */
+export interface SupplierItemPrice {
+    id: string;
+    /** ISO 4217. */
+    currencyCode: string;
+    /** From how many purchase units on the price applies; at least 1. */
+    minQuantity: number;
+    /** Integer minor units of `currencyCode` per purchase unit. */
+    unitPrice: number;
+    /** The first day the price applies (`YYYY-MM-DD`, inclusive); null: from the start. */
+    validFrom: string | null;
+    /** The last day the price applies (`YYYY-MM-DD`, inclusive); null: no end. */
+    validUntil: string | null;
+}
+/** The supplier of an item, as an item answers it. */
+export type SupplierItemSupplier = Pick<Supplier, 'id' | 'code' | 'name' | 'status' | 'currencyCode'>;
+/** The variant of an item as the active store sees it. */
+export interface SupplierItemVariant {
+    id: string;
+    sku: string;
+    name: string;
+}
+/**
+ * What one supplier sells of one product variant, and how (purchase-orders spec §7.1): one per
+ * supplier and variant, in the supplier's purchasing scope.
+ */
+export interface SupplierItem {
+    id: string;
+    supplierId: string;
+    supplier: SupplierItemSupplier;
+    /** The supplier's purchasing scope. */
+    scopeId: string;
+    legalEntityId: string | null;
+    productVariantId: string;
+    /**
+     * Null when the active store does not hold the variant (another store of the legal entity
+     * added the item) or it was deleted.
+     */
+    productVariant: SupplierItemVariant | null;
+    /** The supplier's own article number for the variant. */
+    supplierSku: string | null;
+    supplierBarcode: string | null;
+    /** How the purchase unit is called on the order (`box of 12`); null: the variant's own unit. */
+    purchaseUnitLabel: string | null;
+    /** Base units (the variant's stock units) per purchase unit. */
+    purchaseUnitFactor: number;
+    /** The least an order line may order, in purchase units. */
+    minimumQuantity: number;
+    /** An order line orders a multiple of this, in purchase units. */
+    orderMultiple: number;
+    /** Null: the supplier's `defaultLeadTimeDays` applies. */
+    leadTimeDays: number | null;
+    /** The supplier the variant is reordered from: at most one item per variant in the scope. */
+    preferred: boolean;
+    /** Whether the supplier ships the variant straight to the buyer. A string on the wire. */
+    dropShip: 'never' | 'always' | 'optional' | (string & {});
+    /** The purchasing provider that manages the item; null in Standalone mode. */
+    managedBy: string | null;
+    /** By currency, then minimum quantity, then the window's start. */
+    prices: SupplierItemPrice[];
+    /** ISO-8601 UTC. */
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * The item fields an upsert may set. A PATCH of an existing item: a field left out is kept,
+ * `null` clears an optional one. A new item buys one by one, never drop-ships, is not preferred.
+ */
+export interface SupplierItemFields {
+    /** At most 128 characters. */
+    supplierSku?: string | null;
+    /** At most 64 characters. */
+    supplierBarcode?: string | null;
+    /** At most 64 characters. */
+    purchaseUnitLabel?: string | null;
+    /** 1 to 1000000. */
+    purchaseUnitFactor?: number;
+    /** 1 to 1000000, in purchase units. */
+    minimumQuantity?: number;
+    /** 1 to 1000000, in purchase units. */
+    orderMultiple?: number;
+    /** 0 to 365; null for the supplier's default. */
+    leadTimeDays?: number | null;
+    /** `true` clears `preferred` on the variant's other items of the purchasing scope. */
+    preferred?: boolean;
+    dropShip?: 'never' | 'always' | 'optional';
+}
+/** One price break as `prices.set` takes it. */
+export interface SupplierItemPriceInput {
+    /** ISO 4217, upper case. */
+    currencyCode: string;
+    /** 1 to 1000000; default 1. */
+    minQuantity?: number;
+    /** Whole minor units per purchase unit, 0 or more. */
+    unitPrice: number;
+    /** `YYYY-MM-DD`, inclusive. */
+    validFrom?: string | null;
+    /** `YYYY-MM-DD`, inclusive, not before `validFrom`. */
+    validUntil?: string | null;
+}
+export interface SupplierItemListOptions extends ListOptions {
+    /** Matches the supplier SKU or barcode, case-insensitively, as typed. */
+    term?: string;
+}
+/** A price replacement: the whole set, or with `currencyCode` that currency's breaks only. */
+export interface SupplierItemPricesOptions extends Call {
+    currencyCode?: string;
+}
+/**
+ * One row of a supplier price list (purchase-orders D70): the supplier's item for one variant and
+ * at most one of its price breaks. Rows naming the same supplier and SKU are ONE item; a value
+ * left out (or `null`) keeps what the item has (a new item buys one by one, never drop-ships, is
+ * not preferred), and two rows of one item may not give one field two values.
+ */
+export interface SupplierItemRow {
+    /** The supplier's code. May be left out when the call names the supplier (`supplierId`). */
+    supplierCode?: string | null;
+    /** The variant's SKU in the active store (exact). */
+    sku: string;
+    supplierSku?: string | null;
+    supplierBarcode?: string | null;
+    purchaseUnitLabel?: string | null;
+    purchaseUnitFactor?: number | null;
+    minimumQuantity?: number | null;
+    orderMultiple?: number | null;
+    leadTimeDays?: number | null;
+    preferred?: boolean | null;
+    dropShip?: 'never' | 'always' | 'optional' | null;
+    /** The break's currency (ISO 4217); the supplier's currency when left out. */
+    currencyCode?: string | null;
+    /** From how many purchase units on the break applies; default 1. */
+    minQuantity?: number | null;
+    /**
+     * Whole minor units per purchase unit. A row without it carries no price break (and may not
+     * give `currencyCode`, `minQuantity`, `validFrom` or `validUntil`).
+     */
+    unitPrice?: number | null;
+    /** `YYYY-MM-DD`, inclusive. */
+    validFrom?: string | null;
+    /** `YYYY-MM-DD`, inclusive, not before `validFrom`. */
+    validUntil?: string | null;
+}
+/** What happened to one row of a price list or a bulk upsert. */
+export interface SupplierItemImportRowResult {
+    /** The row's line in the CSV file (the header is line 1), or its position (from 1) in `rows`. */
+    row: number;
+    supplierCode: string | null;
+    sku: string | null;
+    /**
+     * `created`: the row's item is new. `updated`: the item or one of its currencies' price breaks
+     * changed. `unchanged`: the row's item already says it all. `failed`: nothing of the row's
+     * item was written; `errorCode` and `message` say why. A string on the wire.
+     */
+    outcome: 'created' | 'updated' | 'unchanged' | 'failed' | (string & {});
+    /** The item written or found; null when the row failed before one was found. */
+    supplierItemId: string | null;
+    /** The refusal's code when `failed` (`SUPPLIER_INVALID`, `SUPPLIER_NOT_FOUND`, …). */
+    errorCode: string | null;
+    message: string | null;
+}
+/** The answer to a price list import or a bulk upsert, row by row. */
+export interface SupplierItemImportResult {
+    /** True when nothing was written: every row was checked exactly as the write would. */
+    dryRun: boolean;
+    /**
+     * `sha256` (hex) of the price list as read (byte-order mark dropped, line endings unified), so
+     * a caller can recognise a file it already sent; null for a bulk upsert.
+     */
+    contentHash: string | null;
+    /** 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: SupplierItemImportRowResult[];
+}
+/** `items.import`: a supplier price list as CSV text (D70 columns, header row first). */
+export interface SupplierPriceListImportInput {
+    /**
+     * The file's text. A header row naming the columns (any case; `supplier_code` and
+     * `Supplier Code` read as `supplierCode`), then one row per price break. `unitPrice` is a
+     * decimal in the row's currency with at most two decimals (`12.50`; `12,50` too when the
+     * separator is `;` or a tab).
+     * Comma, semicolon or tab separated. At most 5000 rows.
+     */
+    content: string;
+    /** The supplier the list is for: its rows may leave `supplierCode` out, and may not name another. */
+    supplierId?: string;
+    /** Check every row as the import would, write nothing. */
+    dryRun?: boolean;
+}
+/** `items.bulkUpsert`: price list rows as data. */
+export interface SupplierItemsBulkUpsertInput {
+    /** At most 5000. */
+    rows: SupplierItemRow[];
+    /** Only this supplier's rows: they may leave `supplierCode` out, and may not name another. */
+    supplierId?: string;
+    /** Check every row as the write would, write nothing. */
+    dryRun?: boolean;
+}
+export declare const SUPPLIER_ITEM_FIELDS = "\n  id\n  supplierId\n  supplier { id code name status currencyCode }\n  scopeId\n  legalEntityId\n  productVariantId\n  productVariant { id sku name }\n  supplierSku\n  supplierBarcode\n  purchaseUnitLabel\n  purchaseUnitFactor\n  minimumQuantity\n  orderMultiple\n  leadTimeDays\n  preferred\n  dropShip\n  managedBy\n  prices { id currencyCode minQuantity unitPrice validFrom validUntil }\n  createdAt\n  updatedAt\n";
+export declare const SUPPLIER_ITEMS_QUERY = "\n  query SupplierItems($supplierId: ID!, $options: SupplierItemListOptions) {\n    supplierItems(supplierId: $supplierId, options: $options) {\n      totalItems\n      items { \n  id\n  supplierId\n  supplier { id code name status currencyCode }\n  scopeId\n  legalEntityId\n  productVariantId\n  productVariant { id sku name }\n  supplierSku\n  supplierBarcode\n  purchaseUnitLabel\n  purchaseUnitFactor\n  minimumQuantity\n  orderMultiple\n  leadTimeDays\n  preferred\n  dropShip\n  managedBy\n  prices { id currencyCode minQuantity unitPrice validFrom validUntil }\n  createdAt\n  updatedAt\n }\n    }\n  }\n";
+export declare const VARIANT_SUPPLIER_ITEMS_QUERY = "\n  query VariantSupplierItems($productVariantId: ID!) {\n    variantSupplierItems(productVariantId: $productVariantId) { \n  id\n  supplierId\n  supplier { id code name status currencyCode }\n  scopeId\n  legalEntityId\n  productVariantId\n  productVariant { id sku name }\n  supplierSku\n  supplierBarcode\n  purchaseUnitLabel\n  purchaseUnitFactor\n  minimumQuantity\n  orderMultiple\n  leadTimeDays\n  preferred\n  dropShip\n  managedBy\n  prices { id currencyCode minQuantity unitPrice validFrom validUntil }\n  createdAt\n  updatedAt\n }\n  }\n";
+export declare const UPSERT_SUPPLIER_ITEM_MUTATION = "\n  mutation UpsertSupplierItem($input: UpsertSupplierItemInput!, $idempotencyKey: String) {\n    upsertSupplierItem(input: $input, idempotencyKey: $idempotencyKey) { \n  id\n  supplierId\n  supplier { id code name status currencyCode }\n  scopeId\n  legalEntityId\n  productVariantId\n  productVariant { id sku name }\n  supplierSku\n  supplierBarcode\n  purchaseUnitLabel\n  purchaseUnitFactor\n  minimumQuantity\n  orderMultiple\n  leadTimeDays\n  preferred\n  dropShip\n  managedBy\n  prices { id currencyCode minQuantity unitPrice validFrom validUntil }\n  createdAt\n  updatedAt\n }\n  }\n";
+export declare const DELETE_SUPPLIER_ITEM_MUTATION = "\n  mutation DeleteSupplierItem($id: ID!, $idempotencyKey: String) {\n    deleteSupplierItem(id: $id, idempotencyKey: $idempotencyKey)\n  }\n";
+export declare const SET_SUPPLIER_ITEM_PRICES_MUTATION = "\n  mutation SetSupplierItemPrices(\n    $supplierItemId: ID!\n    $prices: [SupplierItemPriceInput!]!\n    $currencyCode: CurrencyCode\n    $idempotencyKey: String\n  ) {\n    setSupplierItemPrices(\n      supplierItemId: $supplierItemId\n      prices: $prices\n      currencyCode: $currencyCode\n      idempotencyKey: $idempotencyKey\n    ) { \n  id\n  supplierId\n  supplier { id code name status currencyCode }\n  scopeId\n  legalEntityId\n  productVariantId\n  productVariant { id sku name }\n  supplierSku\n  supplierBarcode\n  purchaseUnitLabel\n  purchaseUnitFactor\n  minimumQuantity\n  orderMultiple\n  leadTimeDays\n  preferred\n  dropShip\n  managedBy\n  prices { id currencyCode minQuantity unitPrice validFrom validUntil }\n  createdAt\n  updatedAt\n }\n  }\n";
+export declare const SUPPLIER_ITEM_IMPORT_RESULT_FIELDS = "\n  dryRun\n  contentHash\n  ignoredColumns\n  totalRows\n  created\n  updated\n  unchanged\n  failed\n  rows { row supplierCode sku outcome supplierItemId errorCode message }\n";
+export declare const IMPORT_SUPPLIER_PRICE_LIST_MUTATION = "\n  mutation ImportSupplierPriceList(\n    $input: ImportSupplierPriceListInput!\n    $idempotencyKey: String\n  ) {\n    importSupplierPriceList(input: $input, idempotencyKey: $idempotencyKey) {\n      \n  dryRun\n  contentHash\n  ignoredColumns\n  totalRows\n  created\n  updated\n  unchanged\n  failed\n  rows { row supplierCode sku outcome supplierItemId errorCode message }\n\n    }\n  }\n";
+export declare const BULK_UPSERT_SUPPLIER_ITEMS_MUTATION = "\n  mutation BulkUpsertSupplierItems(\n    $input: BulkUpsertSupplierItemsInput!\n    $idempotencyKey: String\n  ) {\n    bulkUpsertSupplierItems(input: $input, idempotencyKey: $idempotencyKey) {\n      \n  dryRun\n  contentHash\n  ignoredColumns\n  totalRows\n  created\n  updated\n  unchanged\n  failed\n  rows { row supplierCode sku outcome supplierItemId errorCode message }\n\n    }\n  }\n";
+/** A supplier's contacts. Each write needs `UpdateSupplier` on every store of the legal entity. */
+export interface SupplierContactsModule {
+    /** Refusals: `SUPPLIER_NOT_FOUND` (404), `MANAGED_BY_PROVIDER` (422), `SUPPLIER_INVALID` (400). */
+    create(supplierId: string, input: CreateSupplierContactInput, call?: Call): Promise<SupplierContact>;
+    /** Refusals: `SUPPLIER_CONTACT_NOT_FOUND` (404), `MANAGED_BY_PROVIDER` (422), `SUPPLIER_INVALID` (400). */
+    update(id: string, input: UpdateSupplierContactInput, call?: Call): Promise<SupplierContact>;
+    /** True once removed. Refusals: `SUPPLIER_CONTACT_NOT_FOUND` (404), `MANAGED_BY_PROVIDER` (422). */
+    delete(id: string, call?: Call): Promise<boolean>;
+}
+/** An item's price breaks. Needs `UpdateSupplier` on every store of the legal entity. */
+export interface SupplierItemPricesModule {
+    /**
+     * Replaces the item's price breaks: all of them, or with `currencyCode` that currency's only
+     * (every break given must be in it). An empty list clears what it replaces. Refusals:
+     * `SUPPLIER_ITEM_NOT_FOUND` (404), `SUPPLIER_ARCHIVED` and `MANAGED_BY_PROVIDER` (422),
+     * `SUPPLIER_INVALID` (400: two breaks of one currency and minimum on a shared day, a day that
+     * is no calendar day, more than 100 breaks).
+     */
+    set(supplierItemId: string, prices: SupplierItemPriceInput[], options?: SupplierItemPricesOptions): Promise<SupplierItem>;
+}
+/**
+ * A supplier's catalog: what it sells of which variant, and its price breaks. Reads need
+ * `ReadSupplier`; writes `UpdateSupplier` on every store of the legal entity.
+ */
+export interface SupplierItemsModule {
+    /**
+     * The supplier's items by supplier SKU. Pages default to 50; walking on with `.next()` or
+     * `for await` reaches every one. Refusals: `SUPPLIER_NOT_FOUND` (404).
+     */
+    list(supplierId: string, options?: SupplierItemListOptions): Promise<Page<SupplierItem>>;
+    /**
+     * Every item of the purchasing scope for one variant the active store holds, the preferred one
+     * first, then by supplier name. Refusals: `SUPPLIER_ITEM_VARIANT_NOT_FOUND` (404).
+     */
+    forVariant(productVariantId: string, call?: Call): Promise<SupplierItem[]>;
+    /**
+     * Creates the supplier's item for the variant, or changes the one it has (a PATCH). Refusals:
+     * `SUPPLIER_NOT_FOUND` and `SUPPLIER_ITEM_VARIANT_NOT_FOUND` (404), `SUPPLIER_ARCHIVED` and
+     * `MANAGED_BY_PROVIDER` (422), `SUPPLIER_INVALID` (400).
+     */
+    upsert(supplierId: string, productVariantId: string, input?: SupplierItemFields, call?: Call): Promise<SupplierItem>;
+    /** True once removed, with its price breaks. Refusals: `SUPPLIER_ITEM_NOT_FOUND` (404), `SUPPLIER_ARCHIVED` (422). */
+    delete(id: string, call?: Call): Promise<boolean>;
+    prices: SupplierItemPricesModule;
+    /**
+     * Imports a supplier price list (CSV, purchase-orders D70): upserts each (supplier, SKU) item
+     * and replaces, per currency the file gives, that item's price breaks with the file's. A row
+     * that cannot be applied is answered `failed` with its reason and takes the other rows of its
+     * item with it; every other item is still written. Re-importing the same file answers every
+     * row `unchanged` and writes nothing. With `dryRun` nothing is written.
+     *
+     * Refusals of the whole file: `SUPPLIER_INVALID` (400: no header row, a required column
+     * missing, a column twice, no data rows, more than 5000 rows, unreadable CSV),
+     * `SUPPLIER_NOT_FOUND` (404) for `supplierId`. Row reasons: `SUPPLIER_INVALID`,
+     * `SUPPLIER_NOT_FOUND`, `SUPPLIER_ITEM_VARIANT_NOT_FOUND`, `SUPPLIER_ARCHIVED`,
+     * `MANAGED_BY_PROVIDER`.
+     */
+    import(input: SupplierPriceListImportInput, call?: Call): Promise<SupplierItemImportResult>;
+    /**
+     * The same engine as `import`, for rows as data (`unitPrice` in whole minor units). Refusals:
+     * `SUPPLIER_INVALID` (400: no rows or more than 5000), `SUPPLIER_NOT_FOUND` (404) for
+     * `supplierId`; row reasons as `import`.
+     */
+    bulkUpsert(input: SupplierItemsBulkUpsertInput, call?: Call): Promise<SupplierItemImportResult>;
+}
+/**
+ * `admin.purchasing.suppliers` (purchase-orders spec §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 `ReadSupplier`. The suppliers 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): `CreateSupplier` to create, `UpdateSupplier` to change a supplier, its
+ * contacts or its catalog (`items`), `DeleteSupplier` to archive or restore one. There is no
+ * hard delete.
+ *
+ * Every write takes `{ idempotencyKey?, tenant? }`: a repeat under one key answers the first
+ * call's result, a different body under it `IDEMPOTENCY_CONFLICT` (409).
+ */
+export interface PurchasingSuppliersModule {
+    /**
+     * The scope's suppliers by name. Pages default to 50; a `limit` above 100 is refused
+     * `SUPPLIER_INVALID` (400); walking on with `.next()` or `for await` reaches every one.
+     */
+    list(options?: SupplierListOptions): Promise<Page<Supplier>>;
+    /** Null when the scope has no supplier with that id (another legal entity's included). */
+    get(id: string, call?: Call): Promise<Supplier | null>;
+    /**
+     * Creates an active supplier. The currency defaults to the purchasing currency; the VAT
+     * treatment, when left out, is derived from the countries (domestic in the legal entity's own
+     * country, intra_eu for another EU state with a VAT number, import from outside the EU).
+     * Refusals: `SUPPLIER_CODE_TAKEN` (409), `SUPPLIER_INVALID` (400).
+     */
+    create(input: CreateSupplierInput, call?: Call): Promise<Supplier>;
+    /**
+     * Changes the fields given. A change that changes nothing writes nothing. Refusals:
+     * `SUPPLIER_NOT_FOUND` (404), `SUPPLIER_CODE_TAKEN` (409), `MANAGED_BY_PROVIDER` (422),
+     * `SUPPLIER_INVALID` (400).
+     */
+    update(id: string, input: UpdateSupplierInput, call?: Call): Promise<Supplier>;
+    /**
+     * Archives a supplier: it stays, hidden from pickers and replenishment. An archived one is
+     * answered as it is. Refusals: `SUPPLIER_NOT_FOUND` (404), `SUPPLIER_HAS_OPEN_DOCUMENTS` and
+     * `MANAGED_BY_PROVIDER` (422).
+     */
+    archive(id: string, options?: SupplierStatusOptions): Promise<Supplier>;
+    /** Makes an archived supplier active again; an active one is answered as it is. */
+    restore(id: string, options?: SupplierStatusOptions): Promise<Supplier>;
+    contacts: SupplierContactsModule;
+    /** What each supplier sells of which variant, with its price breaks. */
+    items: SupplierItemsModule;
+}
+export declare function createPurchasingSuppliersModule(transport: Transport): PurchasingSuppliersModule;