@sixtyninecommerce/admin 0.11.0 → 0.13.0

package/dist/integrations/exact-online.d.ts

@@ -1,6 +1,7 @@
-import { type Transport } from '@sixtyninecommerce/core';
-import type { Call } from '../types.js';
-import type { ExactAccountStructure, ExactCatalogueStructure, ExactOnlineAccountPreview, ExactOnlineConfig, ExactOnlineItemPreview, ExactPricingStructure, ExactSyncEstimate, ExactSyncScheduleInput, ExactWebhookStatus, SetExactOnlineCredentialsInput, UpdateExactOnlineConfigInput } from './exact-online-types.js';
+import { type Page, type Transport } from '@sixtyninecommerce/core';
+import type { AuditCall, AuditEvent } from '../audit/index.js';
+import type { Call, ListOptions } from '../types.js';
+import type { ConvertExactShippingMethodInput, ExactAccountStructure, ExactCatalogueStructure, ExactCustomerDeliveryTerms, ExactCustomerPaymentTerms, ExactCustomerPriceList, ExactDeliveryTermsDiagnostics, ExactDeliveryTermsDryRun, ExactIncoterm, ExactOnlineAccountPreview, ExactOnlineConfig, ExactOnlineConnectionLogCallFilter, ExactOnlineConnectionLogEventFilter, ExactOnlineConnectionLogExportFilter, ExactOnlineConnectionLogKind, ExactOnlineItemPreview, ExactOnlineSyncHealth, ExactOnlineSyncLogEntry, ExactOnlineSyncLogOptions, ExactOrderPushResult, ExactOrderRepriceAllResult, ExactOrderRepriceResult, ExactOrderState, ExactOrderSyncState, ExactPaymentCondition, ExactPaymentTermsDiagnostics, ExactPaymentTermsDryRun, ExactPricingStructure, ExactProductStatus, ExactShippingMethodMapping, ExactShippingMethodsView, ExactSyncCursor, ExactSyncEstimate, ExactSyncScheduleInput, ExactWarehouseLink, ExactWebhookStatus, SetExactOnlineCredentialsInput, SetExactShippingMethodMappingInput, UpdateExactOnlineConfigInput } from './exact-online-types.js';
 /**
  * The store's Exact Online connection itself (`admin.integrations.exactOnline.config`).
  */
@@ -145,6 +146,470 @@ export interface ExactOnlineWebhooksModule {
      */
     sync(options?: Call): Promise<boolean>;
 }
+/** The most sync-log rows one {@link ExactOnlineSyncModule.logs} read answers. */
+export declare const EXACT_ONLINE_SYNC_LOG_LIMIT = 100;
+/**
+ * The inbound (Exact → platform) sync of the store: how its runs went, and running one by hand
+ * (`admin.integrations.exactOnline.sync`). A run is QUEUED: the call answers once the work is on
+ * the worker's queue, and its outcome arrives in {@link logs} and {@link health}.
+ *
+ * Every manual run is refused, with nothing queued:
+ * - `FIELD_GROUP_LOCKED` (`BusinessRuleError`, 422) while an app or API token owns a field group
+ *   of the store (prices, stock levels, product or customer details), a suspended one included:
+ *   Exact writes all four. The sentence names each owner and where to release it, and
+ *   `error.details[]` holds one entry per owned group, its message naming the owner;
+ * - `PLUGIN_ACCESS_DENIED` (`PermissionDeniedError`, 403): the store has no Exact Online plugin
+ *   (never for a SuperAdmin).
+ *
+ * A run does not check that the store is connected or switched on: on a store that is not
+ * connected it is queued, and fails on the worker (a `failed` row in {@link logs}). The engine
+ * queues a run whatever `enabled` says, so a connected division that is switched off is still
+ * written to.
+ */
+export interface ExactOnlineSyncModule {
+    /**
+     * The store's newest sync runs, newest first, across every entity or one (`entity`). Not a
+     * page: the newest `limit` runs (20 unless said), never a way to walk the whole log. A store
+     * with no connected division answers `[]`.
+     *
+     * Refused before sending, `INVALID_EXACT_ONLINE_INPUT` (`ValidationError`, 400): a `limit`
+     * that is not a whole number from 1 to {@link EXACT_ONLINE_SYNC_LOG_LIMIT} (the engine would
+     * otherwise answer fewer rows than asked, unsaid), or an `entity` that is not a non-blank
+     * string. `PLUGIN_ACCESS_DENIED` (403).
+     *
+     * @effect read
+     * @permission ReadSettings
+     */
+    logs(options?: ExactOnlineSyncLogOptions & Call): Promise<ExactOnlineSyncLogEntry[]>;
+    /**
+     * How the newest real run of each inbound area (customers, catalogue, orders) ended. An area
+     * that never ran, or every area of a store with no connected division, is null.
+     * `PLUGIN_ACCESS_DENIED` (403).
+     *
+     * @effect read
+     * @permission ReadSettings
+     */
+    health(options?: Call): Promise<ExactOnlineSyncHealth>;
+    /**
+     * "Sync now": queue the whole inbound sync of the store: the catalogue (warehouses, items,
+     * prices, stock), the customers, the sales orders and the purchase orders, each on its own
+     * queue. It overwrites what Exact owns (prices customers pay, stock levels, product and
+     * customer details, customer price lists and terms) with Exact's values, which the platform
+     * cannot take back, and the order import books Exact's new and changed sales orders as placed
+     * orders with a settled payment: it records money. Answers `true` once queued. Refusals: see
+     * {@link ExactOnlineSyncModule}.
+     *
+     * @effect money
+     * @permission UpdateSettings
+     */
+    runCatalogue(options?: Call): Promise<boolean>;
+    /**
+     * "Import customers": queue a full customer synchronization (Exact Accounts → customers),
+     * whatever the customer sync switch says. It overwrites customer details per the store's
+     * overwrite policy and assigns the Exact price lists and payment and delivery terms, which the
+     * platform cannot take back. Answers `true` once queued. Refusals: see
+     * {@link ExactOnlineSyncModule}.
+     *
+     * @effect irreversible
+     * @permission UpdateSettings
+     */
+    runCustomers(options?: Call): Promise<boolean>;
+    /**
+     * Queue the price-list reconcile (Exact customer price agreements and named price lists → the
+     * store's price lists), which changes what customers pay and cannot be taken back. Answers
+     * `false`, queuing nothing, when one is already waiting or running for the store: that run
+     * reads Exact fresh when it starts. Refusals: see {@link ExactOnlineSyncModule}.
+     *
+     * @effect irreversible
+     * @permission UpdateSettings
+     */
+    runPriceLists(options?: Call): Promise<boolean>;
+    /**
+     * "Re-import pictures": mark every picture the store imported from Exact for import again,
+     * and queue a catalogue sweep (the pictures ride it, a capped number per run, so they arrive
+     * over the next runs). The sweep writes the whole catalogue, prices and stock included (not
+     * the customers or orders {@link runCatalogue} also queues). Answers how many pictures were
+     * marked (0 when none was imported yet). Refusals: see {@link ExactOnlineSyncModule}.
+     *
+     * @effect irreversible
+     * @permission UpdateSettings
+     */
+    reimportPictures(options?: Call): Promise<number>;
+    /**
+     * The store's persisted Exact Sync API cursors, one per entity stream; `[]` when it has none
+     * or is not connected. `PLUGIN_ACCESS_DENIED` (403).
+     *
+     * @effect read
+     * @permission ReadSettings
+     */
+    cursors(options?: Call): Promise<ExactSyncCursor[]>;
+    /**
+     * Drop one entity stream's cursor, so the next sweep of it reads Exact from the beginning
+     * (slower, more Exact calls; the writes are idempotent). Answers `true`, also when no cursor
+     * was stored under `entity`. Refused before sending, `INVALID_EXACT_ONLINE_INPUT` (400): an
+     * `entity` that is not a non-blank string. `PLUGIN_ACCESS_DENIED` (403).
+     *
+     * @effect write
+     * @permission UpdateSettings
+     */
+    resetCursor(entity: string, options?: Call): Promise<boolean>;
+}
+/**
+ * The store's shipping methods mapped to Exact's (`admin.integrations.exactOnline.shipping`).
+ * Orders pushed to Exact carry the mapped Exact method. A method Exact defines reaches checkout
+ * only when it is deliberately activated ({@link import}) or mapped; a catalogue refresh never
+ * adds one.
+ *
+ * The engine's refusals here are not all coded yet: the ones it raises as an input error arrive
+ * as `USER_INPUT_ERROR` (`ValidationError`, 400), the others as an uncoded error
+ * (`GRAPHQL_ERROR`, 500). Every method is refused `PLUGIN_ACCESS_DENIED` (403) for a store
+ * without the Exact Online plugin.
+ */
+export interface ExactOnlineShippingModule {
+    /**
+     * The store's shipping methods (up to 500), each with its Exact mapping and its status live
+     * against the synchronized Exact catalogue, and that catalogue. Reads no Exact API.
+     *
+     * @effect read
+     * @permission ReadSettings
+     */
+    methods(options?: Call): Promise<ExactShippingMethodsView>;
+    /**
+     * "Refresh Exact catalog": queue a shipping-method synchronization. It refreshes the store's
+     * Exact catalogue (a new Exact method stays out of checkout) and re-applies Exact's rate, with
+     * its calculator and checker, to every method already activated from Exact, which changes what
+     * checkout charges and cannot be taken back. A name the merchant gave an activated method
+     * stays: only {@link import} takes Exact's description back. Answers `true` once queued.
+     *
+     * @effect irreversible
+     * @permission UpdateSettings
+     */
+    runSync(options?: Call): Promise<boolean>;
+    /**
+     * "Activate" (and "Re-apply Exact name"): create, or update, the checkout method of one Exact
+     * method from Exact's description and rate, and map it. On an already activated method it
+     * takes Exact's description back over a rename. Answers the mapping.
+     *
+     * Refused, uncoded (`GRAPHQL_ERROR`, 500): the Exact method is not active and current in the
+     * store's synchronized catalogue (refresh it first; a store that is not connected has none),
+     * or it has no rate (map it to a method of your own instead: a missing rate never becomes free
+     * shipping).
+     *
+     * @effect write
+     * @permission UpdateSettings
+     */
+    import(exactShippingMethodId: string, options?: Call): Promise<ExactShippingMethodMapping>;
+    /**
+     * Map a shipping method of the store to an Exact method, or clear its mapping
+     * (`exactShippingMethodId: null`). A method shared with other stores is mapped for this store
+     * only and stays the store's own (never Exact-managed). Answers the mapping.
+     *
+     * Clearing the mapping of an Activated method leaves that method in checkout: retire it
+     * ({@link retireImported}) or move it ({@link convertToMapping}) instead.
+     *
+     * Refused before sending, `INVALID_EXACT_ONLINE_INPUT` (400): `exactShippingMethodId` left
+     * out, blank, or neither a string nor `null`. The engine would read each as `null` and clear
+     * the mapping: a clear is only ever an explicit `null`.
+     *
+     * Refused, uncoded (`GRAPHQL_ERROR`, 500): the store is not connected to Exact, the shipping
+     * method is not the store's, the Exact method is not active and current in the synchronized
+     * catalogue, or it is already mapped to another of the store's methods.
+     *
+     * @effect write
+     * @permission UpdateSettings
+     */
+    setMapping(input: SetExactShippingMethodMappingInput, options?: Call): Promise<ExactShippingMethodMapping>;
+    /**
+     * [deletes] Move an Activated Exact method onto one of the store's own methods, in one
+     * transaction: the mapping now names `vendureShippingMethodId`, and the method Exact created is
+     * retired (soft-deleted; orders already shipped on it keep their shipping line). Answers the
+     * new mapping.
+     *
+     * Refused `USER_INPUT_ERROR` (`ValidationError`, 400): the Exact method is not activated in
+     * the store, or the target is not a method of the store that Exact does not manage.
+     *
+     * Needs `DeleteSettings` or `DeleteShippingMethod`, as deleting a shipping method does (either
+     * one, so no `@permission` tag: the tag can only say "all of these"); `UpdateSettings` alone
+     * is refused `FORBIDDEN` (403).
+     *
+     * @effect destructive
+     */
+    convertToMapping(input: ConvertExactShippingMethodInput, options?: Call): Promise<ExactShippingMethodMapping>;
+    /**
+     * [deletes] Retire one Activated Exact method: its checkout method is soft-deleted and its
+     * mapping released (an order placed on it still pushes under the Exact method it was sold
+     * under). Answers `true`, also when it was already retired. Activating the Exact method again
+     * brings it back.
+     *
+     * Refused `USER_INPUT_ERROR` (`ValidationError`, 400): the store is not connected to Exact,
+     * the Exact method is unknown to the store's catalogue, or it was never activated here.
+     *
+     * Needs `DeleteSettings` or `DeleteShippingMethod` (either one, so no `@permission` tag);
+     * `UpdateSettings` alone is refused `FORBIDDEN` (403).
+     *
+     * @effect destructive
+     */
+    retireImported(exactShippingMethodId: string, options?: Call): Promise<boolean>;
+}
+/**
+ * The store's Exact connection logs (`admin.integrations.exactOnline.connectionLogs`): every API
+ * call between the store and Exact (`calls`), and the Exact sync and lifecycle events (`events`),
+ * from the platform's audit trail, newest first. Always the client's own store; a store without
+ * the Exact Online plugin reads none (refused `PermissionDeniedError`, 403).
+ *
+ * The rows are the audit trail's own ({@link AuditCall}, {@link AuditEvent}). An app installation
+ * below `customerData: full` reads them with every field that can carry customer data null (the
+ * bodies, the error text, the endpoint, the labels, `metadata`), and a text search (`q`) is
+ * refused `CUSTOMER_DATA_NOT_GRANTED` (403).
+ *
+ * A filter the service cannot read (a date that is not ISO-8601, a status that is not a whole
+ * number, a cursor it did not hand out) is refused `VALIDATION_ERROR` (`ValidationError`, 400).
+ * `limit` is 1 to 200 (50 unless said): the service reads a larger one as 200, and `hasNext`
+ * still says whether more follow.
+ */
+export interface ExactOnlineConnectionLogsModule {
+    /**
+     * The store's Exact API calls, newest first, a page at a time (`.next()`, `for await`).
+     *
+     * @effect read
+     * @permission ReadSettings
+     */
+    calls(filter?: ExactOnlineConnectionLogCallFilter & ListOptions): Promise<Page<AuditCall>>;
+    /**
+     * The store's Exact sync and lifecycle events (every `exact.*` action), newest first, a page at
+     * a time.
+     *
+     * @effect read
+     * @permission ReadSettings
+     */
+    events(filter?: ExactOnlineConnectionLogEventFilter & ListOptions): Promise<Page<AuditEvent>>;
+    /**
+     * One log, filtered, over a bounded date range, as CSV text (a header line, then a line per
+     * row, newest first). Both dates are required and the range is at most 366 days; the service
+     * refuses a missing, reversed or wider range `VALIDATION_ERROR` (400). Refused before sending,
+     * `INVALID_EXACT_ONLINE_INPUT` (400): a `kind` that is not `calls` or `events`.
+     *
+     * @effect read
+     * @permission ReadSettings
+     */
+    export(kind: ExactOnlineConnectionLogKind, filter: ExactOnlineConnectionLogExportFilter, options?: Call): Promise<string>;
+}
+/**
+ * The store's Exact payment and delivery terms: the catalogues mirrored from the connected
+ * division, how far the customers' assignments reach, and a live check against Exact
+ * (`admin.integrations.exactOnline.terms`). Every method reads; none writes, here or in Exact.
+ * Each is refused `PLUGIN_ACCESS_DENIED` (`PermissionDeniedError`, 403) for a store without the
+ * Exact Online plugin (never for a SuperAdmin).
+ */
+export interface ExactOnlineTermsModule {
+    /**
+     * The ACTIVE payment conditions mirrored from the connected division, by code. `[]` for a store
+     * with no connected division. A local read; it calls no Exact.
+     *
+     * @effect read
+     * @permission ReadSettings
+     */
+    paymentConditions(options?: Call): Promise<ExactPaymentCondition[]>;
+    /**
+     * How far the customers' Exact payment conditions reach: how many customers hold one, which
+     * codes the catalogue does not know, and how the newest reconcile went. Every count 0 for a
+     * store with no connected division. A local read.
+     *
+     * @effect read
+     * @permission ReadSettings
+     */
+    paymentDiagnostics(options?: Call): Promise<ExactPaymentTermsDiagnostics>;
+    /**
+     * A live check of the division's payment conditions: reads every condition and every Exact
+     * Account (sales Accounts only, unless the customer sync takes all) and answers what taking
+     * them over would assign, writing nothing, here or in Exact, also while payment-terms
+     * synchronization is off. Slow on a large division. A read Exact refuses is named in
+     * `resources` (`complete: false`), not thrown.
+     *
+     * Refused `EXACT_ONLINE_NOT_CONNECTED` (`BusinessRuleError`, 422) for a store that is not
+     * connected to a division, before any Exact call; `PLUGIN_ACCESS_DENIED` (403).
+     *
+     * @effect read
+     * @permission ReadSettings
+     */
+    paymentDryRun(options?: Call): Promise<ExactPaymentTermsDryRun>;
+    /**
+     * The Incoterms mirrored from the connected division, by code and version. `[]` for a store
+     * with no connected division. A local read.
+     *
+     * @effect read
+     * @permission ReadSettings
+     */
+    incoterms(options?: Call): Promise<ExactIncoterm[]>;
+    /**
+     * How far the customers' Exact delivery assignments reach, and how the store's shipping
+     * methods map onto Exact's. Every count 0 for a store with no connected division. A local read.
+     *
+     * @effect read
+     * @permission ReadSettings
+     */
+    deliveryDiagnostics(options?: Call): Promise<ExactDeliveryTermsDiagnostics>;
+    /**
+     * A live check of the division's delivery assignments: reads Exact's shipping methods,
+     * Incoterms and Accounts and answers what taking them over would assign, writing nothing. As
+     * {@link paymentDryRun}: slow on a large division, a refused read is in `resources`.
+     *
+     * Refused `EXACT_ONLINE_NOT_CONNECTED` (`BusinessRuleError`, 422) for a store that is not
+     * connected to a division, before any Exact call; `PLUGIN_ACCESS_DENIED` (403).
+     *
+     * @effect read
+     * @permission ReadSettings
+     */
+    deliveryDryRun(options?: Call): Promise<ExactDeliveryTermsDryRun>;
+}
+/**
+ * What Exact holds for one customer of the store (`admin.integrations.exactOnline.customers`):
+ * the customer page's Exact cards. Local reads of what the sync last wrote; none calls Exact.
+ * Read on any store, with or without the Exact Online plugin.
+ */
+export interface ExactOnlineCustomersModule {
+    /**
+     * The customer's Exact payment terms, staged ones included (`managedExternally: false` while
+     * the mirror only shadows the store's own terms), with the linked Account. `null` for a store
+     * with no connected division, or a customer Exact holds no terms for. The provider-neutral
+     * terms an order takes are `customers.credit.paymentTerms`.
+     *
+     * @effect read
+     * @permission ReadCustomer
+     */
+    paymentTerms(customerId: string, options?: Call): Promise<ExactCustomerPaymentTerms | null>;
+    /**
+     * The customer's Exact delivery assignment, staged ones included, with the linked Account.
+     * `null` when Exact holds none for the customer. The provider-neutral terms an order takes are
+     * `customers.deliveryTerms`.
+     *
+     * @effect read
+     * @permission ReadCustomer
+     */
+    deliveryTerms(customerId: string, options?: Call): Promise<ExactCustomerDeliveryTerms | null>;
+    /**
+     * The customer's Exact price list against the group and price list the store reconciled for
+     * it (see `ExactCustomerPriceListStatus`). A customer the store does not hold, or one not
+     * linked to Exact, reads `unlinked`; never `null`.
+     *
+     * @effect read
+     * @permission ReadCustomer
+     */
+    priceList(customerId: string, options?: Call): Promise<ExactCustomerPriceList>;
+}
+/**
+ * The store's orders in Exact (`admin.integrations.exactOnline.orders`): an order's place there,
+ * pushing one, and the inbound order import. Every method is refused `PLUGIN_ACCESS_DENIED`
+ * (`PermissionDeniedError`, 403) for a store without the Exact Online plugin (never for a
+ * SuperAdmin).
+ *
+ * Exact is the source of truth for an Exact store's figures: nothing here recomputes what an
+ * order bills from the platform's side; {@link reprice} and {@link repriceAll} take Exact's VAT
+ * rates as they are.
+ */
+export interface ExactOnlineOrdersModule {
+    /**
+     * The order's place in Exact (pushed from here, imported from Exact, or neither), what blocks a
+     * push (a guest order, lines not linked to an Exact item) and how Exact's sales order differs
+     * from the order. An order the store does not hold reads as not in Exact, with no customer.
+     * A local read. An engine that predates `warnings` is asked again without it, and the answer
+     * carries `warnings: []`.
+     *
+     * @effect read
+     * @permission ReadOrder
+     */
+    state(orderId: string, options?: Call): Promise<ExactOrderState>;
+    /**
+     * An order imported from Exact: its revision, when it was last synced, whether Exact's order
+     * drifted from it and whether Exact deleted it. `null` for an order that was never imported,
+     * or a store with no connected division. A local read.
+     *
+     * @effect read
+     * @permission ReadOrder
+     */
+    syncState(orderId: string, options?: Call): Promise<ExactOrderSyncState | null>;
+    /**
+     * Push the order to Exact as a sales order, linking the customer to their Exact Account and
+     * creating one when needed. This writes into the store's Exact division and cannot be undone
+     * from the platform. Write-once: an order already in Exact (pushed, or imported from it)
+     * answers `alreadyPushed: true` and writes nothing.
+     *
+     * A refusal is an answer, not a throw: `success: false` with the reason in `error` (and
+     * `errorCode` when it has one). Refused that way, with nothing sent to Exact: a guest order,
+     * lines not linked to an Exact item, a sandbox store, a store with no active Exact connection,
+     * or an order linked to a sales order of another division. What Exact itself refuses arrives
+     * the same way. A sales order that came out different from the order (Exact derives each line's
+     * VAT itself) answers `success: true` with the differences in `warnings`. An engine that
+     * predates `warnings` refuses the document before running it; it is then sent once more
+     * without the field, and the answer carries `warnings: null`.
+     *
+     * The engine takes no idempotency key for it yet, so `options.idempotencyKey` is not sent; the
+     * write-once rule above is what keeps a repeat from writing twice.
+     *
+     * @effect irreversible
+     * @permission UpdateOrder
+     */
+    push(orderId: string, options?: Call): Promise<ExactOrderPushResult>;
+    /**
+     * Re-split an order imported from Exact at Exact's own per-line VAT rates, read live from its
+     * sales order: each line's tax changes, while the order's gross total, code, payment and
+     * fulfilment stay. It changes what the order bills, line by line.
+     *
+     * A refusal is `success: false` with the reason in `error`, not a throw: an order that was not
+     * imported from Exact, a store with no connected division, an import link of another division,
+     * a sales order Exact no longer holds. `changed: false` when every line already matched.
+     *
+     * @effect money
+     * @permission UpdateOrder
+     */
+    reprice(orderId: string, options?: Call): Promise<ExactOrderRepriceResult>;
+    /**
+     * {@link reprice} every order the store imported from the connected division, one by one,
+     * reading each sales order from Exact (slow, and Exact calls, on a large history). Answers the
+     * counts; one order's failure is counted, never thrown. All zero for a store with no connected
+     * division.
+     *
+     * @effect money
+     * @permission UpdateSettings
+     */
+    repriceAll(options?: Call): Promise<ExactOrderRepriceAllResult>;
+    /**
+     * Queue an inbound order sync: Exact's new and changed sales orders since the last run are
+     * booked as placed orders with a settled payment (it records money). Answers `true` once queued;
+     * the outcome arrives in `sync.logs`. Queued on a store that is not connected too, where the
+     * run fails on the worker.
+     *
+     * Refused, with nothing queued: `FIELD_GROUP_LOCKED` (`BusinessRuleError`, 422) while an app or
+     * API token owns a field group of the store (the import fills an existing customer's empty name
+     * and phone), `error.details[]` naming each owner; `PLUGIN_ACCESS_DENIED` (403).
+     *
+     * @effect money
+     * @permission UpdateSettings
+     */
+    runSync(options?: Call): Promise<boolean>;
+    /**
+     * Queue a full order backfill: the order cursor is reset and the whole order history of the
+     * division is read again. Orders already imported are skipped by their fingerprint, so it also
+     * recovers orders a run failed on; any it had not imported are booked as placed, paid orders.
+     * Answers `true`, also for a store that is not connected, where it does nothing. Refusals as
+     * {@link runSync}.
+     *
+     * @effect money
+     * @permission UpdateSettings
+     */
+    runBackfill(options?: Call): Promise<boolean>;
+}
+/** What Exact holds for one product of the store (`admin.integrations.exactOnline.products`). */
+export interface ExactOnlineProductsModule {
+    /**
+     * Whether Exact owns the product's catalogue data, its Exact item and item group, and whether
+     * the catalogue sync switched it off. `null` for a product the store does not hold. Read on any
+     * store, with or without the Exact Online plugin. Needs `ReadCatalog` (or `ReadProduct`).
+     *
+     * @effect read
+     */
+    status(productId: string, options?: Call): Promise<ExactProductStatus | null>;
+}
 /**
  * The store's Exact Online connection, its settings and its import structure
  * (`admin.integrations.exactOnline`). Always the store the client is scoped to; a SuperAdmin acts
@@ -154,8 +619,10 @@ export interface ExactOnlineWebhooksModule {
  * The connection is OAuth: `authorizationUrl` gives the consent page of the region's Exact host,
  * and Exact's callback stores the division. A store without the Exact Online plugin is refused
  * every method but `config.get` and `disconnect` (`PLUGIN_ACCESS_DENIED`, 403; never for a
- * SuperAdmin). The sync runs, the logs and the shipping-method mapping follow in their own
- * modules.
+ * SuperAdmin). The inbound sync ({@link sync}), the shipping-method mapping ({@link shipping}),
+ * the connection logs ({@link connectionLogs}), the payment and delivery terms ({@link terms})
+ * and what Exact holds for a customer, an order or a product ({@link customers},
+ * {@link orders}, {@link products}) are here too.
  */
 export interface ExactOnlineModule {
     /** The connection's settings. See {@link ExactOnlineConfigModule}. */
@@ -211,6 +678,28 @@ export interface ExactOnlineModule {
      * @permission ReadSettings
      */
     syncEstimate(schedule: ExactSyncScheduleInput, options?: Call): Promise<ExactSyncEstimate>;
+    /** The inbound sync: its runs, its health, its cursors. See {@link ExactOnlineSyncModule}. */
+    sync: ExactOnlineSyncModule;
+    /**
+     * The store's stock locations and the Exact warehouse each mirrors. Read-only: the catalogue
+     * sweep links them. `PLUGIN_ACCESS_DENIED` (403).
+     *
+     * @effect read
+     * @permission ReadSettings
+     */
+    warehouseLinks(options?: Call): Promise<ExactWarehouseLink[]>;
+    /** The shipping-method mapping. See {@link ExactOnlineShippingModule}. */
+    shipping: ExactOnlineShippingModule;
+    /** The API calls and events between the store and Exact. See {@link ExactOnlineConnectionLogsModule}. */
+    connectionLogs: ExactOnlineConnectionLogsModule;
+    /** The payment and delivery terms. See {@link ExactOnlineTermsModule}. */
+    terms: ExactOnlineTermsModule;
+    /** What Exact holds for one customer. See {@link ExactOnlineCustomersModule}. */
+    customers: ExactOnlineCustomersModule;
+    /** The store's orders in Exact. See {@link ExactOnlineOrdersModule}. */
+    orders: ExactOnlineOrdersModule;
+    /** What Exact holds for one product. See {@link ExactOnlineProductsModule}. */
+    products: ExactOnlineProductsModule;
 }
 /**
  * `updateExactOnlineConfig`'s inline arguments, each with its GraphQL type: the SDK takes one
@@ -245,4 +734,51 @@ export declare const EXACT_ONLINE_PRICING_STRUCTURE_QUERY = "\n  query ExactOnli
 export declare const EXACT_ONLINE_WEBHOOK_STATUS_QUERY = "\n  query ExactOnlineWebhookStatus {\n    exactOnlineWebhookStatus {\n      supported\n      registered\n      subscriptions { topic subscriptionId callbackUrl }\n      checkedAt\n      error\n    }\n  }\n";
 export declare const SYNC_EXACT_ONLINE_WEBHOOKS_MUTATION = "\n  mutation SyncExactOnlineWebhooks {\n    syncExactOnlineWebhooks\n  }\n";
 export declare const EXACT_ONLINE_SYNC_ESTIMATE_QUERY = "\n  query ExactOnlineSyncEstimate($schedule: ExactSyncScheduleInput!) {\n    exactOnlineSyncEstimate(schedule: $schedule) {\n      delta { \n  enabled\n  intervalMinutes\n  minIntervalMinutes\n  maxIntervalMinutes\n  callsPerRun\n  runsPerDay\n  callsPerDay\n }\n      full { \n  enabled\n  intervalMinutes\n  minIntervalMinutes\n  maxIntervalMinutes\n  callsPerRun\n  runsPerDay\n  callsPerDay\n }\n      order { \n  enabled\n  intervalMinutes\n  minIntervalMinutes\n  maxIntervalMinutes\n  callsPerRun\n  runsPerDay\n  callsPerDay\n }\n      purchaseOrders { \n  enabled\n  intervalMinutes\n  minIntervalMinutes\n  maxIntervalMinutes\n  callsPerRun\n  runsPerDay\n  callsPerDay\n }\n      purchaseOrdersReconcile { \n  enabled\n  intervalMinutes\n  minIntervalMinutes\n  maxIntervalMinutes\n  callsPerRun\n  runsPerDay\n  callsPerDay\n }\n      customers { \n  enabled\n  intervalMinutes\n  minIntervalMinutes\n  maxIntervalMinutes\n  callsPerRun\n  runsPerDay\n  callsPerDay\n }\n      priceLists { \n  enabled\n  intervalMinutes\n  minIntervalMinutes\n  maxIntervalMinutes\n  callsPerRun\n  runsPerDay\n  callsPerDay\n }\n      total\n      dailyCallBudget\n      overBudget\n    }\n  }\n";
+export declare const EXACT_ONLINE_SYNC_LOGS_QUERY = "\n  query ExactOnlineSyncLogs($limit: Int, $entity: String) {\n    exactOnlineSyncLogs(limit: $limit, entity: $entity) { \n  id\n  entity\n  mode\n  status\n  createdCount\n  updatedCount\n  skippedCount\n  failedCount\n  detachedCount\n  error\n  durationMs\n  createdAt\n  catalogueExclusions { inactive notWebshop nonStock unpriced total absent }\n }\n  }\n";
+export declare const EXACT_ONLINE_SYNC_HEALTH_QUERY = "\n  query ExactOnlineSyncHealth {\n    exactOnlineSyncHealth {\n      customers { lastRunAt status error lastSuccessAt }\n      catalogue { lastRunAt status error lastSuccessAt }\n      orders { lastRunAt status error lastSuccessAt }\n    }\n  }\n";
+export declare const RUN_EXACT_ONLINE_CATALOGUE_SYNC_MUTATION = "\n  mutation RunExactOnlineCatalogueSync {\n    runExactOnlineCatalogueSync\n  }\n";
+export declare const RUN_EXACT_ONLINE_CUSTOMER_SYNC_MUTATION = "\n  mutation RunExactOnlineCustomerSync {\n    runExactOnlineCustomerSync\n  }\n";
+export declare const RUN_EXACT_ONLINE_PRICE_LIST_SYNC_MUTATION = "\n  mutation RunExactOnlinePriceListSync {\n    runExactOnlinePriceListSync\n  }\n";
+export declare const REIMPORT_EXACT_ONLINE_ITEM_PICTURES_MUTATION = "\n  mutation ReimportExactOnlineItemPictures {\n    reimportExactOnlineItemPictures\n  }\n";
+export declare const EXACT_ONLINE_SYNC_CURSORS_QUERY = "\n  query ExactOnlineSyncCursors {\n    exactOnlineSyncCursors { entity cursor }\n  }\n";
+export declare const RESET_EXACT_ONLINE_SYNC_CURSOR_MUTATION = "\n  mutation ResetExactOnlineSyncCursor($entity: String!) {\n    resetExactOnlineSyncCursor(entity: $entity)\n  }\n";
+export declare const EXACT_ONLINE_WAREHOUSE_LINKS_QUERY = "\n  query ExactOnlineWarehouseLinks {\n    exactOnlineWarehouseLinks { stockLocationId stockLocationName exactWarehouseId }\n  }\n";
+export declare const EXACT_ONLINE_SHIPPING_METHODS_QUERY = "\n  query ExactOnlineShippingMethods {\n    exactOnlineShippingMethods {\n      mappings { \n  vendureShippingMethodId\n  vendureCode\n  vendureName\n  exactShippingMethodId\n  exactManaged\n  status\n }\n      exact { id code description active amount linked }\n    }\n  }\n";
+export declare const RUN_EXACT_ONLINE_SHIPPING_METHOD_SYNC_MUTATION = "\n  mutation RunExactOnlineShippingMethodSync {\n    runExactOnlineShippingMethodSync\n  }\n";
+export declare const IMPORT_EXACT_ONLINE_SHIPPING_METHOD_MUTATION = "\n  mutation ImportExactOnlineShippingMethod($exactShippingMethodId: String!) {\n    importExactOnlineShippingMethod(exactShippingMethodId: $exactShippingMethodId) {\n      \n  vendureShippingMethodId\n  vendureCode\n  vendureName\n  exactShippingMethodId\n  exactManaged\n  status\n\n    }\n  }\n";
+export declare const SET_EXACT_ONLINE_SHIPPING_METHOD_MAPPING_MUTATION = "\n  mutation SetExactOnlineShippingMethodMapping(\n    $vendureShippingMethodId: ID!\n    $exactShippingMethodId: String\n  ) {\n    setExactOnlineShippingMethodMapping(\n      vendureShippingMethodId: $vendureShippingMethodId\n      exactShippingMethodId: $exactShippingMethodId\n    ) {\n      \n  vendureShippingMethodId\n  vendureCode\n  vendureName\n  exactShippingMethodId\n  exactManaged\n  status\n\n    }\n  }\n";
+export declare const CONVERT_EXACT_ONLINE_SHIPPING_METHOD_TO_MAPPING_MUTATION = "\n  mutation ConvertExactOnlineShippingMethodToMapping(\n    $exactShippingMethodId: String!\n    $vendureShippingMethodId: ID!\n  ) {\n    convertExactOnlineShippingMethodToMapping(\n      exactShippingMethodId: $exactShippingMethodId\n      vendureShippingMethodId: $vendureShippingMethodId\n    ) {\n      \n  vendureShippingMethodId\n  vendureCode\n  vendureName\n  exactShippingMethodId\n  exactManaged\n  status\n\n    }\n  }\n";
+export declare const RETIRE_EXACT_ONLINE_IMPORTED_SHIPPING_METHOD_MUTATION = "\n  mutation RetireExactOnlineImportedShippingMethod($exactShippingMethodId: String!) {\n    retireExactOnlineImportedShippingMethod(exactShippingMethodId: $exactShippingMethodId)\n  }\n";
+export declare const EXACT_ONLINE_PAYMENT_CONDITIONS_QUERY = "\n  query ExactOnlinePaymentConditions {\n    exactOnlinePaymentConditions {\n      exactId\n      code\n      description\n      summary\n      classification\n      paymentDays\n      paymentEndOfMonths\n      paymentMethod\n      percentage\n      discountPaymentDays\n      discountPercentage\n      paymentDiscountType\n      active\n      syncedAt\n    }\n  }\n";
+export declare const EXACT_ONLINE_PAYMENT_TERMS_DIAGNOSTICS_QUERY = "\n  query ExactOnlinePaymentTermsDiagnostics {\n    exactOnlinePaymentTermsDiagnostics {\n      totalCustomers\n      assignedCount\n      unassignedCount\n      unresolvedCount\n      staleCount\n      lastSyncedAt\n      error\n      permissionWarning\n      distribution { code description customerCount }\n      unresolvedCodes { code customerCount }\n      lastReconciliation {\n        mode\n        status\n        createdCount\n        updatedCount\n        deactivatedCount\n        failedCount\n        at\n        error\n      }\n    }\n  }\n";
+export declare const EXACT_ONLINE_PAYMENT_TERMS_DRY_RUN_QUERY = "\n  query ExactOnlinePaymentTermsDryRun {\n    exactOnlinePaymentTermsDryRun {\n      division\n      generatedAt\n      complete\n      permissionWarning\n      catalogRowCount\n      catalogCodeCount\n      accountCount\n      assignedCount\n      unassignedCount\n      unresolvedCount\n      uncheckedCount\n      distribution { code description customerCount }\n      duplicateConditions { code description summary classification scheduleCount }\n      complexConditions { code description summary classification scheduleCount }\n      unresolvedCodes { code customerCount }\n      assignmentIssues { accountId accountCode conditionCode conditionDescription status }\n      resources { resource ok permissionWarning error }\n    }\n  }\n";
+export declare const EXACT_ONLINE_INCOTERMS_QUERY = "\n  query ExactOnlineIncoterms {\n    exactOnlineIncoterms {\n      exactId\n      code\n      version\n      description\n      catalogAvailable\n      stale\n      lastSyncedAt\n      error\n    }\n  }\n";
+export declare const EXACT_ONLINE_DELIVERY_TERMS_DIAGNOSTICS_QUERY = "\n  query ExactOnlineDeliveryTermsDiagnostics {\n    exactOnlineDeliveryTermsDiagnostics {\n      reconciliationRequired\n      accountSyncStatus\n      totalCustomers\n      assignedCount\n      unassignedCount\n      unresolvedCount\n      staleCount\n      mappedMethodCount\n      usableShippingMappingCount\n      unmappedMethodCount\n      inactiveMethodCount\n      unavailableMethodCount\n      nullAmountCount\n      invalidIncotermCount\n      lastSyncedAt\n      error\n      permissionWarning\n      shippingMethodDistribution { exactId code description customerCount }\n      incotermDistribution { code version description customerCount }\n      warnings\n    }\n  }\n";
+export declare const EXACT_ONLINE_DELIVERY_TERMS_DRY_RUN_QUERY = "\n  query ExactOnlineDeliveryTermsDryRun {\n    exactOnlineDeliveryTermsDryRun {\n      division\n      generatedAt\n      complete\n      permissionWarning\n      shippingMethodCount\n      activeShippingMethodCount\n      mappingCount\n      unmappedCatalogMethodCount\n      nullAmountCount\n      zeroAmountCount\n      incotermCount\n      accountCount\n      assignedShippingMethodCount\n      mappedAssignedShippingMethodCount\n      unmappedAssignedShippingMethodCount\n      unassignedShippingMethodCount\n      unresolvedShippingMethodCount\n      assignedIncotermCount\n      unassignedIncotermCount\n      unresolvedIncotermCount\n      invalidPolicyCount\n      shippingMethodDistribution { exactId customerCount }\n      incotermDistribution { code version customerCount }\n      assignmentIssues {\n        accountId\n        accountCode\n        shippingMethodId\n        incotermCode\n        incotermVersion\n        status\n        message\n      }\n      resources { resource ok permissionWarning error }\n    }\n  }\n";
+export declare const EXACT_ONLINE_CUSTOMER_PAYMENT_TERMS_QUERY = "\n  query ExactOnlineCustomerPaymentTerms($customerId: ID!) {\n    exactOnlineCustomerPaymentTerms(customerId: $customerId) {\n      customerId\n      source\n      managedExternally\n      linkedExternally\n      status\n      stale\n      exactAccountId\n      exactAccountCode\n      conditionCode\n      conditionDescription\n      summary\n      classification\n      paymentDays\n      paymentEndOfMonths\n      paymentMethod\n      percentage\n      discountPaymentDays\n      discountPercentage\n      paymentDiscountType\n      syncedAt\n      lastCheckedAt\n      error\n    }\n  }\n";
+export declare const EXACT_ONLINE_CUSTOMER_DELIVERY_TERMS_QUERY = "\n  query ExactOnlineCustomerDeliveryTerms($customerId: ID!) {\n    exactOnlineCustomerDeliveryTerms(customerId: $customerId) {\n      customerId\n      source\n      managedExternally\n      linkedExternally\n      status\n      shippingMethodStatus\n      policyStatus\n      summary\n      exactAccountId\n      exactAccountCode\n      preferredShippingMethodId\n      preferredShippingMethodCode\n      preferredShippingMethodName\n      preferredShippingMethodAvailable\n      eligibleShippingMethodIds\n      incotermStatus\n      incotermCode\n      incotermVersion\n      incotermAddress\n      incotermDescription\n      shippingLeadDays\n      deliveryAdvice\n      stale\n      syncedAt\n      lastCheckedAt\n      error\n    }\n  }\n";
+export declare const EXACT_ONLINE_CUSTOMER_PRICE_LIST_QUERY = "\n  query ExactOnlineCustomerPriceList($customerId: ID!) {\n    exactOnlineCustomerPriceList(customerId: $customerId) {\n      customerId\n      exactAccountId\n      exactAccountCode\n      exactPriceListId\n      groupId\n      groupName\n      priceListId\n      priceListName\n      status\n      lastReconciledAt\n      lastError\n    }\n  }\n";
+export declare const EXACT_ONLINE_ORDER_STATE_QUERY = "\n  query ExactOnlineOrderState($orderId: ID!) {\n    exactOnlineOrderState(orderId: $orderId) {\n      pushed\n      origin\n      salesOrderId\n      salesOrderNumber\n      pushedAt\n      hasCustomer\n      customerLinked\n      unmappedSkus\n      warnings\n    }\n  }\n";
+export declare const EXACT_ONLINE_ORDER_SYNC_STATE_QUERY = "\n  query ExactOnlineOrderSyncState($orderId: ID!) {\n    exactOnlineOrderSyncState(orderId: $orderId) {\n      exactSalesOrderId\n      exactOrderNumber\n      revision\n      lastSyncedAt\n      driftDetected\n      exactDeletedAt\n      unmappedSkus\n    }\n  }\n";
+export declare const PUSH_ORDER_TO_EXACT_ONLINE_MUTATION = "\n  mutation PushOrderToExactOnline($orderId: ID!) {\n    pushOrderToExactOnline(orderId: $orderId) {\n      success\n      alreadyPushed\n      salesOrderId\n      salesOrderNumber\n      error\n      errorCode\n      warnings\n    }\n  }\n";
+/**
+ * {@link EXACT_ONLINE_ORDER_STATE_QUERY} without `warnings`, for an engine that predates the field
+ * (#1925): services deploy separately, and GraphQL refuses the whole document over one unknown
+ * field. Drop it once every engine serves `warnings` (orchestrator probe 2026-10-16: production
+ * did not yet).
+ */
+export declare const EXACT_ONLINE_ORDER_STATE_LEGACY_QUERY = "\n  query ExactOnlineOrderState($orderId: ID!) {\n    exactOnlineOrderState(orderId: $orderId) {\n      pushed\n      origin\n      salesOrderId\n      salesOrderNumber\n      pushedAt\n      hasCustomer\n      customerLinked\n      unmappedSkus\n    }\n  }\n";
+/**
+ * {@link PUSH_ORDER_TO_EXACT_ONLINE_MUTATION} without `warnings`, for an engine that predates the
+ * field. Safe to send after the current document was refused: an unknown field fails validation,
+ * before the push runs, so nothing reached Exact. Drop it with the state read's.
+ */
+export declare const PUSH_ORDER_TO_EXACT_ONLINE_LEGACY_MUTATION = "\n  mutation PushOrderToExactOnline($orderId: ID!) {\n    pushOrderToExactOnline(orderId: $orderId) {\n      success\n      alreadyPushed\n      salesOrderId\n      salesOrderNumber\n      error\n      errorCode\n    }\n  }\n";
+export declare const REPRICE_EXACT_ONLINE_ORDER_MUTATION = "\n  mutation RepriceExactOnlineOrder($orderId: ID!) {\n    repriceExactOnlineOrder(orderId: $orderId) {\n      success\n      changed\n      linesRepriced\n      error\n    }\n  }\n";
+export declare const REPRICE_ALL_EXACT_ONLINE_IMPORTED_ORDERS_MUTATION = "\n  mutation RepriceAllExactOnlineImportedOrders {\n    repriceAllExactOnlineImportedOrders {\n      total\n      repriced\n      skipped\n      failed\n    }\n  }\n";
+export declare const RUN_EXACT_ONLINE_ORDER_SYNC_MUTATION = "\n  mutation RunExactOnlineOrderSync {\n    runExactOnlineOrderSync\n  }\n";
+export declare const RUN_EXACT_ONLINE_ORDER_BACKFILL_MUTATION = "\n  mutation RunExactOnlineOrderBackfill {\n    runExactOnlineOrderBackfill\n  }\n";
+export declare const EXACT_PRODUCT_STATUS_QUERY = "\n  query ExactProductStatus($id: ID!) {\n    product(id: $id) {\n      id\n      customFields {\n        exactManaged\n        exactItemId\n        exactItemGroupId\n        exactDisabledReason\n      }\n    }\n  }\n";
+/** How long a connection-log export may stream before the call gives up, unless said otherwise. */
+export declare const EXACT_ONLINE_LOG_EXPORT_TIMEOUT_MS = 120000;
 export declare function createExactOnlineModule(transport: Transport): ExactOnlineModule;