@epilot/sdk 2.20.5 → 2.20.7-alpha.0

package/dist/{integration-toolkit-runtime-AL7GHT6B.cjs → integration-toolkit-runtime-57I2O6DI.cjs}

@@ -1,5 +1,5 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunk2WGN6U22cjs = require('./chunk-2WGN6U22.cjs');
+var _chunk4DTTVPUMcjs = require('./chunk-4DTTVPUM.cjs');
 require('./chunk-NJK5F5TF.cjs');
-exports. default = _chunk2WGN6U22cjs.require_integration_toolkit_runtime.call(void 0, );
+exports. default = _chunk4DTTVPUMcjs.require_integration_toolkit_runtime.call(void 0, );

package/dist/{integration-toolkit-runtime-M3GLLRLF.js → integration-toolkit-runtime-TNDJH6HK.js}

@@ -1,5 +1,5 @@
 import {
   require_integration_toolkit_runtime
-} from "./chunk-ECZ337CC.js";
+} from "./chunk-WE4C7GER.js";
 import "./chunk-YPSWSI3M.js";
 export default require_integration_toolkit_runtime();

package/dist/{integration-toolkit.d-CLVwmd8s.d.cts → integration-toolkit.d-rpj1kvB_.d.cts}

@@ -1349,7 +1349,7 @@ declare namespace Components {
             include_preview?: boolean;
             /**
              * Repoint an EXISTING import at this file instead of registering a new one — same row, same id, so iterating on which file to import leaves one entry in the history rather than one per attempt.
-             * Only a PENDING import may be repointed; any other status returns 409 with code `IMPORT_NOT_REPLACEABLE`. Past the first check the previous verdict is what tells the user what to fix, and a job that reached the execute phase may already have published rows under `correlation_id`.
+             * Repointing is allowed exactly while the import has written nothing: from PENDING and READY, and from FAILED when `error.code` is one of `VALIDATION_BLOCKED`, `VALIDATE_TIMEOUT` or `FILE_FORMAT_UNSUPPORTED`. Anything else returns 409 with code `IMPORT_NOT_REPLACEABLE`. The repoint clears any verdict the import had.
              * An id that names nothing returns 404. It never falls back to registering a new import: a stale id must fail loudly rather than quietly produce a second one.
              */
             import_id?: string;
@@ -1464,6 +1464,15 @@ declare namespace Components {
              * Configuration defining environment variables needed by this integration. Values are stored in the Environments API.
              */
             environment_config?: EnvironmentFieldConfig[];
+            /**
+             * Re-usable key/value maps (e.g. salutation codes) declared by this integration (max 50). Each map is synced to the Environments API as a non-secret variable of type `JSON` and is available in JSONata mappings as `$env.<key>`, together with the `$mapValue(map, key, default)` and `$mapKey(map, value, default)` helpers.
+             *
+             */
+            maps?: /**
+             * A flat key/value map stored as an Environments API variable of type `JSON`. Values must be strings, numbers, booleans or null; the serialised map must not exceed 32 KB.
+             *
+             */
+            IntegrationMap[];
             settings?: /* Settings for the integration */ IntegrationSettings;
             /**
              * Type of integration. "erp" is the ERP integration with inbound/outbound use cases. "connector" is for complex proxy integrations with external APIs.
@@ -1774,10 +1783,10 @@ declare namespace Components {
          * entity verbatim (except `$relation` / `$relation_ref` envelopes, which are validated and
          * resolved).
          *
-         * One event lands as one queue message, so the whole event (including this payload) must
-         * stay within the 256 KiB message budget. Identical consecutive payloads within 5 minutes
-         * can be deduplicated by the queue - use the event's `deduplication_id` deliberately when
-         * re-sending identical data.
+         * One event lands as one queue message, so the whole serialized event (including this
+         * payload and its internal envelope) must stay within the 1 MiB message budget. Identical
+         * consecutive payloads within 5 minutes can be deduplicated by the queue - use the event's
+         * `deduplication_id` deliberately when re-sending identical data.
          *
          */
         export interface DirectPayload {
@@ -2029,10 +2038,10 @@ declare namespace Components {
              * entity verbatim (except `$relation` / `$relation_ref` envelopes, which are validated and
              * resolved).
              *
-             * One event lands as one queue message, so the whole event (including this payload) must
-             * stay within the 256 KiB message budget. Identical consecutive payloads within 5 minutes
-             * can be deduplicated by the queue - use the event's `deduplication_id` deliberately when
-             * re-sending identical data.
+             * One event lands as one queue message, so the whole serialized event (including this
+             * payload and its internal envelope) must stay within the 1 MiB message budget. Identical
+             * consecutive payloads within 5 minutes can be deduplicated by the queue - use the event's
+             * `deduplication_id` deliberately when re-sending identical data.
              *
              */
             DirectPayload;
@@ -2887,6 +2896,30 @@ declare namespace Components {
              */
             correlation_id?: string;
         };
+        /**
+         * One entity instance the import will write, attributed to the mapping target that produces it.
+         */
+        export interface ErpImportEntityDetail {
+            /**
+             * Which `config.entities[]` target produced this entity — the join key back to the mapping.
+             */
+            mapping_index: number;
+            entity_schema: string;
+            /**
+             * The entity's identity: its `unique_ids` as the mapping resolved them, keyed by attribute name in the order the target declares them. Values are strings, as they arrive from CSV.
+             */
+            business_key: {
+                [name: string]: string;
+            };
+            /**
+             * Distinct condition tuples. Absent when the entity is not conditional.
+             */
+            variants?: number;
+            /**
+             * Version writes — one per variant per effective date. Absent when the entity is not conditional.
+             */
+            versions?: number;
+        }
         /**
          * Why the import failed — present if and only if status = FAILED. `code` is the translation key; for VALIDATION_BLOCKED the specifics are in `validation`.
          */
@@ -2895,7 +2928,7 @@ declare namespace Components {
              * Enum of possible error codes.
              *
              */
-            code: "VALIDATION_BLOCKED" | "FILE_FORMAT_UNSUPPORTED" | "FILE_UNAVAILABLE" | "VALIDATE_TIMEOUT" | "IMPORT_TIMEOUT" | "USE_CASE_NOT_USABLE" | "IMPORT_NO_PROGRESS" | "INTERNAL_ERROR";
+            code: "VALIDATION_BLOCKED" | "FILE_FORMAT_UNSUPPORTED" | "FILE_UNAVAILABLE" | "VALIDATE_TIMEOUT" | "IMPORT_TIMEOUT" | "USE_CASE_NOT_USABLE" | "IMPORT_NO_PROGRESS" | "TIER_ROWS_NOT_GROUPED" | "INTERNAL_ERROR";
             /**
              * One English sentence, derived from `code` so the two always agree. A fallback for a client that has no translation for this code — prefer translating `code`, and never parse this. It deliberately does NOT restate `validation.issues`.
              */
@@ -2915,15 +2948,36 @@ declare namespace Components {
             rows: string[][];
         }
         /**
-         * A problem found during validation, scoped to the file as a whole rather than to individual rows.
-         * `code` is the translation key and the other fields are its parameters — there is deliberately no message to display. Each code appears at most once, with everything it has to say aggregated into that one entry.
+         * A problem found during validation, scoped to the file as a whole rather than to
+         * individual rows.
+         *
+         * `code` is the translation key and the other fields are its parameters — there is
+         * deliberately no message to display. Each code appears at most once, with
+         * everything it has to say aggregated into that one entry.
+         *
+         * The conditional codes describe a file that cannot be written as variants:
+         *
+         * - `TIER_ROWS_NOT_GROUPED` — rows of one variant are spread through the file;
+         *   `columns` names what to group by.
+         * - `TIER_BANDS_CONFLICT` — two rows of one variant claim the same band.
+         * - `CONDITION_VALUE_MISSING` — a condition column is blank in every row.
+         * - `VARIANT_VALUE_CONFLICT` — rows of one variant disagree on a value that is not
+         *   the one being folded; the first row's value is what would be written.
+         * - `ATTRIBUTE_NOT_OVERRIDABLE` — the schema does not let a variant override this
+         *   attribute, so the mapped value would be discarded.
+         * - `ATTRIBUTE_NOT_IN_SCHEMA` — the schema does not have the attribute at all.
+         *
+         * The rest reject the mapping against the entity schemas, before the file is read, and
+         * name the thing at fault in `subject`: `IS_CONDITIONAL_NOT_CONSTANT`,
+         * `SCHEMA_NOT_CONDITIONABLE`, `SCHEMA_NOT_FOUND`, `SCHEMA_DECLARES_NO_CONDITIONS`,
+         * `GROUPING_KEY_NOT_A_COLUMN`, `GROUPING_KEY_IS_FOLD_COLUMN`.
          */
         export interface ErpImportIssue {
             /**
              * Enum of possible issue codes.
              *
              */
-            code: "UNIQUE_ID_COLUMN_MISSING" | "MAPPED_COLUMN_MISSING" | "MALFORMED_ROW" | "INVALID_ENCODING" | "EMPTY_FILE" | "TOO_MANY_ROWS" | "BLANK_ROWS_SKIPPED";
+            code: "UNIQUE_ID_COLUMN_MISSING" | "MAPPED_COLUMN_MISSING" | "MALFORMED_ROW" | "INVALID_ENCODING" | "EMPTY_FILE" | "TOO_MANY_ROWS" | "BLANK_ROWS_SKIPPED" | "TIER_ROWS_NOT_GROUPED" | "TIER_BANDS_CONFLICT" | "CONDITION_VALUE_MISSING" | "VARIANT_VALUE_CONFLICT" | "ATTRIBUTE_NOT_OVERRIDABLE" | "ATTRIBUTE_NOT_IN_SCHEMA" | "IS_CONDITIONAL_NOT_CONSTANT" | "SCHEMA_NOT_CONDITIONABLE" | "SCHEMA_NOT_FOUND" | "SCHEMA_DECLARES_NO_CONDITIONS" | "GROUPING_KEY_NOT_A_COLUMN" | "GROUPING_KEY_IS_FOLD_COLUMN";
             severity: "warning" | "blocking";
             /**
              * The columns this issue is about, at most one entry per column per entity.
@@ -2939,6 +2993,10 @@ declare namespace Components {
                  */
                 entity?: string;
             }[];
+            /**
+             * What the issue is about — an attribute, an entity type slug, or an "attribute reads column" pair — to substitute into the client's copy for the code. Independent of `columns`; a code can carry both.
+             */
+            subject?: string;
             /**
              * The offending data row, 1-based as the user counts rows. MALFORMED_ROW only.
              */
@@ -3032,8 +3090,9 @@ declare namespace Components {
         export interface ErpImportValidation {
             /**
              * Data rows the import will act on. Rows with no value in any column are dropped before they are counted, and reported as BLANK_ROWS_SKIPPED — so this can be lower than the line count of the file.
+             * ABSENT when the verdict was reached without reading the file, as a mapping refused against the entity schemas alone is. Do not default it to zero.
              */
-            total_rows: number;
+            total_rows?: number;
             /**
              * Blocking problems found, counting per-row ones that are not listed in `issues`.
              */
@@ -3045,12 +3104,41 @@ declare namespace Components {
             entities: {
                 [name: string]: number;
             };
+            /**
+             * What this import will write, one entry per entity instance, capped at 20 in first-appearance order. `entities` stays exact regardless.
+             */
+            entity_details?: /* One entity instance the import will write, attributed to the mapping target that produces it. */ ErpImportEntityDetail[];
+            /**
+             * More entities exist than `entity_details` lists.
+             */
+            entity_details_truncated?: boolean;
             /**
              * Whole-file issues, at most one per `code`. Do not expect the length to match blocking + warnings: those also count per-row problems, which are recorded for support but never listed here. Warnings here are what `ack_warnings` on `:execute` acknowledges.
              */
             issues?: /**
-             * A problem found during validation, scoped to the file as a whole rather than to individual rows.
-             * `code` is the translation key and the other fields are its parameters — there is deliberately no message to display. Each code appears at most once, with everything it has to say aggregated into that one entry.
+             * A problem found during validation, scoped to the file as a whole rather than to
+             * individual rows.
+             *
+             * `code` is the translation key and the other fields are its parameters — there is
+             * deliberately no message to display. Each code appears at most once, with
+             * everything it has to say aggregated into that one entry.
+             *
+             * The conditional codes describe a file that cannot be written as variants:
+             *
+             * - `TIER_ROWS_NOT_GROUPED` — rows of one variant are spread through the file;
+             *   `columns` names what to group by.
+             * - `TIER_BANDS_CONFLICT` — two rows of one variant claim the same band.
+             * - `CONDITION_VALUE_MISSING` — a condition column is blank in every row.
+             * - `VARIANT_VALUE_CONFLICT` — rows of one variant disagree on a value that is not
+             *   the one being folded; the first row's value is what would be written.
+             * - `ATTRIBUTE_NOT_OVERRIDABLE` — the schema does not let a variant override this
+             *   attribute, so the mapped value would be discarded.
+             * - `ATTRIBUTE_NOT_IN_SCHEMA` — the schema does not have the attribute at all.
+             *
+             * The rest reject the mapping against the entity schemas, before the file is read, and
+             * name the thing at fault in `subject`: `IS_CONDITIONAL_NOT_CONSTANT`,
+             * `SCHEMA_NOT_CONDITIONABLE`, `SCHEMA_NOT_FOUND`, `SCHEMA_DECLARES_NO_CONDITIONS`,
+             * `GROUPING_KEY_NOT_A_COLUMN`, `GROUPING_KEY_IS_FOLD_COLUMN`.
              */
             ErpImportIssue[];
         }
@@ -4770,6 +4858,15 @@ declare namespace Components {
              * Configuration defining environment variables needed by this integration. Values are stored in the Environments API.
              */
             environment_config?: EnvironmentFieldConfig[];
+            /**
+             * Re-usable key/value maps (e.g. salutation codes) declared by this integration (max 50). Each map is synced to the Environments API as a non-secret variable of type `JSON` and is available in JSONata mappings as `$env.<key>`, together with the `$mapValue(map, key, default)` and `$mapKey(map, value, default)` helpers.
+             *
+             */
+            maps?: /**
+             * A flat key/value map stored as an Environments API variable of type `JSON`. Values must be strings, numbers, booleans or null; the serialised map must not exceed 32 KB.
+             *
+             */
+            IntegrationMap[];
             settings?: /* Settings for the integration */ IntegrationSettings;
             /**
              * Type of integration. "erp" is the ERP integration with inbound/outbound use cases. "connector" is for complex proxy integrations with external APIs.
@@ -4841,6 +4938,15 @@ declare namespace Components {
              * Configuration defining environment variables needed by this integration. Values are stored in the Environments API.
              */
             environment_config?: EnvironmentFieldConfig[];
+            /**
+             * Re-usable key/value maps (e.g. salutation codes) declared by this integration (max 50). Each map is synced to the Environments API as a non-secret variable of type `JSON` and is available in JSONata mappings as `$env.<key>`, together with the `$mapValue(map, key, default)` and `$mapKey(map, value, default)` helpers.
+             *
+             */
+            maps?: /**
+             * A flat key/value map stored as an Environments API variable of type `JSON`. Values must be strings, numbers, booleans or null; the serialised map must not exceed 32 KB.
+             *
+             */
+            IntegrationMap[];
             settings?: /* Settings for the integration */ IntegrationSettings;
             /**
              * Type of integration. "erp" is the ERP integration with inbound/outbound use cases. "connector" is for complex proxy integrations with external APIs.
@@ -4900,6 +5006,18 @@ declare namespace Components {
              *
              */
             fields?: IntegrationEntityField[];
+            conditional?: /* Conditional Pricing extras for this target, used when it writes a conditional entity (a Product, Price or Coupon carrying context-dependent variants). The conditions themselves are declared on the entity schema, not here. */ IntegrationEntityConditional;
+        }
+        /**
+         * Conditional Pricing extras for this target, used when it writes a conditional entity (a Product, Price or Coupon carrying context-dependent variants). The conditions themselves are declared on the entity schema, not here.
+         */
+        export interface IntegrationEntityConditional {
+            /**
+             * Row folds for this target. Exactly one is supported; the array is the shape for later, not a capability claim.
+             */
+            folds: [
+                /* Collapse the rows of one variant-version into a single array attribute, ordered by a column. A commodity file carries one row per consumption band, while a variant-version holds exactly one `tiers` array. */ IntegrationEntityFold
+            ];
         }
         export interface IntegrationEntityField {
             /**
@@ -4952,6 +5070,40 @@ declare namespace Components {
              */
             EnvVarRefConfig;
         }
+        /**
+         * Collapse the rows of one variant-version into a single array attribute, ordered by a column. A commodity file carries one row per consumption band, while a variant-version holds exactly one `tiers` array.
+         */
+        export interface IntegrationEntityFold {
+            /**
+             * The array attribute this fold builds, e.g. `tiers`.
+             */
+            attribute: string;
+            /**
+             * Orders the group's rows. Coerced to a number, so `10000` sorts after `5000` rather than before it as strings.
+             */
+            sort_by: /* Orders the group's rows. Coerced to a number, so `10000` sorts after `5000` rather than before it as strings. */ {
+                /**
+                 * Source column name, or a JSONPath expression when it starts with $
+                 */
+                field: string;
+            } | {
+                /**
+                 * Constant value, of any type
+                 */
+                constant: any;
+            } | {
+                /**
+                 * JSONata expression evaluated against the row
+                 */
+                jsonataExpression: string;
+            };
+            /**
+             * Attribute name to field value, shaping one array item from one row. `jsonataExpression` is often needed here: German ERP exports carry decimal commas (`31,25`) that `Number()` cannot parse.
+             */
+            item: {
+                [name: string]: /* One mapped value. Exactly one of field, constant or jsonataExpression must be set — the same three forms `IntegrationEntityField` accepts. */ MappedFieldValue;
+            };
+        }
         export interface IntegrationFieldV1 {
             /**
              * Target entity slug
@@ -4970,6 +5122,30 @@ declare namespace Components {
              */
             jsonataExpression?: string;
         }
+        /**
+         * A flat key/value map stored as an Environments API variable of type `JSON`. Values must be strings, numbers, booleans or null; the serialised map must not exceed 32 KB.
+         *
+         */
+        export interface IntegrationMap {
+            /**
+             * Environment variable key the map is synced to (`$env.<key>` in JSONata).
+             */
+            key: string; // ^[a-z0-9][a-z0-9_.\-]{0,127}$
+            /**
+             * Display label for the map in the UI
+             */
+            label: string;
+            /**
+             * Help text shown for the map
+             */
+            description?: string;
+            /**
+             * The map itself, e.g. `{"Mr.": 1, "Ms. / Mrs.": 2}`
+             */
+            value: {
+                [name: string]: any;
+            };
+        }
         export interface IntegrationMeterReading {
             /**
              * Optional JSONata expression to extract meter reading items from the event data.
@@ -5099,6 +5275,15 @@ declare namespace Components {
              * Configuration defining environment variables needed by this integration. Values are stored in the Environments API.
              */
             environment_config?: EnvironmentFieldConfig[];
+            /**
+             * Re-usable key/value maps (e.g. salutation codes) declared by this integration (max 50). Each map is synced to the Environments API as a non-secret variable of type `JSON` and is available in JSONata mappings as `$env.<key>`, together with the `$mapValue(map, key, default)` and `$mapKey(map, value, default)` helpers.
+             *
+             */
+            maps?: /**
+             * A flat key/value map stored as an Environments API variable of type `JSON`. Values must be strings, numbers, booleans or null; the serialised map must not exceed 32 KB.
+             *
+             */
+            IntegrationMap[];
             settings?: /* Settings for the integration */ IntegrationSettings;
             /**
              * Type of integration. "erp" is the ERP integration with inbound/outbound use cases. "connector" is for complex proxy integrations with external APIs.
@@ -5374,6 +5559,25 @@ declare namespace Components {
              */
             types_locked?: boolean;
         }
+        /**
+         * One mapped value. Exactly one of field, constant or jsonataExpression must be set — the same three forms `IntegrationEntityField` accepts.
+         */
+        export type MappedFieldValue = /* One mapped value. Exactly one of field, constant or jsonataExpression must be set — the same three forms `IntegrationEntityField` accepts. */ {
+            /**
+             * Source column name, or a JSONPath expression when it starts with $
+             */
+            field: string;
+        } | {
+            /**
+             * Constant value, of any type
+             */
+            constant: any;
+        } | {
+            /**
+             * JSONata expression evaluated against the row
+             */
+            jsonataExpression: string;
+        };
         export interface MappingSimulationRequest {
             mapping_configuration: IntegrationConfigurationV1 | IntegrationConfigurationV2;
             /**
@@ -8027,6 +8231,15 @@ declare namespace Components {
              * Configuration defining environment variables needed by this integration. Values are stored in the Environments API.
              */
             environment_config?: EnvironmentFieldConfig[];
+            /**
+             * Re-usable key/value maps (e.g. salutation codes) declared by this integration (max 50). Each map is synced to the Environments API as a non-secret variable of type `JSON` and is available in JSONata mappings as `$env.<key>`, together with the `$mapValue(map, key, default)` and `$mapKey(map, value, default)` helpers.
+             *
+             */
+            maps?: /**
+             * A flat key/value map stored as an Environments API variable of type `JSON`. Values must be strings, numbers, booleans or null; the serialised map must not exceed 32 KB.
+             *
+             */
+            IntegrationMap[];
             settings?: /* Settings for the integration */ IntegrationSettings;
             /**
              * Type of integration. "erp" is the ERP integration with inbound/outbound use cases. "connector" is for complex proxy integrations with external APIs.
@@ -8436,7 +8649,7 @@ declare namespace Paths {
             export type $202 = Components.Schemas.ErpImportJob;
             export type $403 = Components.Responses.Forbidden;
             export type $404 = Components.Responses.NotFound;
-            export type $409 = Components.Responses.Conflict;
+            export type $409 = Components.Schemas.ErrorResponseBase;
             export type $422 = Components.Schemas.ErrorResponseBase;
             export type $500 = Components.Responses.InternalServerError;
         }
@@ -9935,6 +10148,10 @@ interface OperationMethods {
    * the ERP. Returns an empty list for entities no inbound use case has
    * processed. Org-scoped via the caller's token.
    * 
+   * Deprecated alias: `GET /v1/entities/{entityId}/sync-status` is still
+   * served (rewritten to this path in the API handler) but will be removed —
+   * migrate callers to this path.
+   * 
    */
   'getEntitySyncStatus'(
     parameters?: Parameters<Paths.GetEntitySyncStatus.QueryParameters & Paths.GetEntitySyncStatus.PathParameters> | null,
@@ -10235,7 +10452,7 @@ interface OperationMethods {
    * createErpImport - createErpImport
    * 
    * Register an already-uploaded file (S3 ref) as a pricing-file import job. Returns the job and a file preview. Nothing runs yet: no use case is chosen and no validation starts here. Optionally rank candidates with POST /v2/erp/imports/{importId}:suggest-use-cases, then start validation with POST /v2/erp/imports/{importId}:validate.
-   * Pass `import_id` to repoint an existing PENDING import at a different file instead, keeping its id and its place in the history.
+   * Pass `import_id` to repoint an existing import at a different file instead, keeping its id and its place in the history — allowed while the import has written nothing.
    */
   'createErpImport'(
     parameters?: Parameters<UnknownParamsObject> | null,
@@ -10289,6 +10506,7 @@ interface OperationMethods {
    * executeErpImport - executeErpImport
    * 
    * Confirm and run the write phase of a validated import. Only a READY job may be executed; any other status returns 409.
+   * The verdict is re-checked against live inputs first: if the mapping or an entity schema changed since the check, this returns 409 `VALIDATION_STALE` and leaves the verdict untouched for `:validate` to re-form.
    */
   'executeErpImport'(
     parameters?: Parameters<Paths.ExecuteErpImport.PathParameters> | null,
@@ -10890,7 +11108,7 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetOutboundStatus.Responses.$200>
   }
-  ['/v1/entities/{entityId}/sync-status']: {
+  ['/v1/integrations/entities/{entityId}/sync-status']: {
     /**
      * getEntitySyncStatus - getEntitySyncStatus
      * 
@@ -10903,6 +11121,10 @@ interface PathsDictionary {
      * the ERP. Returns an empty list for entities no inbound use case has
      * processed. Org-scoped via the caller's token.
      * 
+     * Deprecated alias: `GET /v1/entities/{entityId}/sync-status` is still
+     * served (rewritten to this path in the API handler) but will be removed —
+     * migrate callers to this path.
+     * 
      */
     'get'(
       parameters?: Parameters<Paths.GetEntitySyncStatus.QueryParameters & Paths.GetEntitySyncStatus.PathParameters> | null,
@@ -11228,7 +11450,7 @@ interface PathsDictionary {
      * createErpImport - createErpImport
      * 
      * Register an already-uploaded file (S3 ref) as a pricing-file import job. Returns the job and a file preview. Nothing runs yet: no use case is chosen and no validation starts here. Optionally rank candidates with POST /v2/erp/imports/{importId}:suggest-use-cases, then start validation with POST /v2/erp/imports/{importId}:validate.
-     * Pass `import_id` to repoint an existing PENDING import at a different file instead, keeping its id and its place in the history.
+     * Pass `import_id` to repoint an existing import at a different file instead, keeping its id and its place in the history — allowed while the import has written nothing.
      */
     'post'(
       parameters?: Parameters<UnknownParamsObject> | null,
@@ -11305,6 +11527,7 @@ interface PathsDictionary {
      * executeErpImport - executeErpImport
      * 
      * Confirm and run the write phase of a validated import. Only a READY job may be executed; any other status returns 409.
+     * The verdict is re-checked against live inputs first: if the mapping or an entity schema changed since the check, this returns 409 `VALIDATION_STALE` and leaves the verdict untouched for `:validate` to re-form.
      */
     'post'(
       parameters?: Parameters<Paths.ExecuteErpImport.PathParameters> | null,
@@ -11378,6 +11601,7 @@ type EnvVarRefConfig = Components.Schemas.EnvVarRefConfig;
 type EnvironmentFieldConfig = Components.Schemas.EnvironmentFieldConfig;
 type ErpEvent = Components.Schemas.ErpEvent;
 type ErpEventV3 = Components.Schemas.ErpEventV3;
+type ErpImportEntityDetail = Components.Schemas.ErpImportEntityDetail;
 type ErpImportError = Components.Schemas.ErpImportError;
 type ErpImportFilePreview = Components.Schemas.ErpImportFilePreview;
 type ErpImportIssue = Components.Schemas.ErpImportIssue;
@@ -11424,8 +11648,11 @@ type IntegrationConfigurationV1 = Components.Schemas.IntegrationConfigurationV1;
 type IntegrationConfigurationV2 = Components.Schemas.IntegrationConfigurationV2;
 type IntegrationEditableFields = Components.Schemas.IntegrationEditableFields;
 type IntegrationEntity = Components.Schemas.IntegrationEntity;
+type IntegrationEntityConditional = Components.Schemas.IntegrationEntityConditional;
 type IntegrationEntityField = Components.Schemas.IntegrationEntityField;
+type IntegrationEntityFold = Components.Schemas.IntegrationEntityFold;
 type IntegrationFieldV1 = Components.Schemas.IntegrationFieldV1;
+type IntegrationMap = Components.Schemas.IntegrationMap;
 type IntegrationMeterReading = Components.Schemas.IntegrationMeterReading;
 type IntegrationNotificationConfig = Components.Schemas.IntegrationNotificationConfig;
 type IntegrationObjectV1 = Components.Schemas.IntegrationObjectV1;
@@ -11439,6 +11666,7 @@ type ManagedCallOperation = Components.Schemas.ManagedCallOperation;
 type ManagedCallOperationConfig = Components.Schemas.ManagedCallOperationConfig;
 type ManagedCallUseCase = Components.Schemas.ManagedCallUseCase;
 type ManagedCallUseCaseHistoryEntry = Components.Schemas.ManagedCallUseCaseHistoryEntry;
+type MappedFieldValue = Components.Schemas.MappedFieldValue;
 type MappingSimulationRequest = Components.Schemas.MappingSimulationRequest;
 type MappingSimulationResponse = Components.Schemas.MappingSimulationResponse;
 type MappingSimulationV2Request = Components.Schemas.MappingSimulationV2Request;
@@ -11539,4 +11767,4 @@ type ValidateErpImportRequest = Components.Schemas.ValidateErpImportRequest;
 type WebhookDeliveryConfig = Components.Schemas.WebhookDeliveryConfig;
 type WebhookStatus = Components.Schemas.WebhookStatus;
 
-export { type ErpImportFilePreview as $, type AccessLogEntry as A, type DirectRelationValue as B, type Client as C, type DeleteIntegrationAppMappingRequest as D, type DirectSimulationError as E, type DirectSimulationRequest as F, type DirectSimulationResponse as G, type DocumentationPage as H, type DocumentationPageSummary as I, type EmbeddedFileProxyUseCaseRequest as J, type EmbeddedInboundUseCaseRequest as K, type EmbeddedManagedCallUseCaseRequest as L, type EmbeddedOutboundUseCaseRequest as M, type EmbeddedSecureProxyUseCaseRequest as N, type OperationMethods as O, Paths as P, type EmbeddedUseCaseRequest as Q, type EmbeddedUseCaseRequestBase as R, type EntityPruneScopeUpdate as S, type EntitySyncState as T, type EntitySyncStatusResponse as U, type EntityUpdate as V, type EnvVarRefConfig as W, type EnvironmentFieldConfig as X, type ErpEvent as Y, type ErpEventV3 as Z, type ErpImportError as _, Components as a, type MeterReadingPruneScopeConfig as a$, type ErpImportIssue as a0, type ErpImportJob as a1, type ErpImportList as a2, type ErpImportProgress as a3, type ErpImportUseCaseSuggestion as a4, type ErpImportValidation as a5, type ErpUpdatesEventsV2Request as a6, type ErpUpdatesEventsV3Request as a7, type ErrorResponseBase as a8, type ExecuteErpImportRequest as a9, type IngestExternalMonitoringEventsRequest as aA, type IngestExternalMonitoringEventsResponse as aB, type Integration as aC, type IntegrationAppMapping as aD, type IntegrationConfigurationV1 as aE, type IntegrationConfigurationV2 as aF, type IntegrationEditableFields as aG, type IntegrationEntity as aH, type IntegrationEntityField as aI, type IntegrationFieldV1 as aJ, type IntegrationMeterReading as aK, type IntegrationNotificationConfig as aL, type IntegrationObjectV1 as aM, type IntegrationSettings as aN, type IntegrationWithUseCases as aO, type ManagedCallAuth as aP, type ManagedCallErrorResponse as aQ, type ManagedCallExecuteRequest as aR, type ManagedCallExecuteResponse as aS, type ManagedCallOperation as aT, type ManagedCallOperationConfig as aU, type ManagedCallUseCase as aV, type ManagedCallUseCaseHistoryEntry as aW, type MappingSimulationRequest as aX, type MappingSimulationResponse as aY, type MappingSimulationV2Request as aZ, type MappingSimulationWarning as a_, type ExternalMonitoringSpan as aa, type FileProxyAuth as ab, type FileProxyDeliveryConfig as ac, type FileProxyFanOutConfig as ad, type FileProxyParam as ae, type FileProxyResponseConfig as af, type FileProxySecureProxyAttachment as ag, type FileProxyStep as ah, type FileProxyUploadConfig as ai, type FileProxyUrlConfig as aj, type FileProxyUrlParam as ak, type FileProxyUrlParams as al, type FileProxyUseCase as am, type FileProxyUseCaseConfiguration as an, type FileProxyUseCaseHistoryEntry as ao, type GenerateTypesPreviewResponse as ap, type GenerateTypesRequest as aq, type GenerateTypesResponse as ar, type GetMonitoringStatsRequest as as, type GetMonitoringStatsV2Request as at, type GetMonitoringTimeSeriesRequest as au, type GetMonitoringTimeSeriesV2Request as av, type InboundIntegrationEventConfiguration as aw, type InboundMonitoringEvent as ax, type InboundUseCase as ay, type InboundUseCaseHistoryEntry as az, type PathsDictionary as b, type SetIntegrationAppMappingRequest as b$, type MeterReadingPruneScopeUpdate as b0, type MeterReadingUpdate as b1, type MeterUniqueIdsConfig as b2, type MonitoringEventV2 as b3, type MonitoringStats as b4, type MonitoringStatsV2 as b5, type MonitoringTraceResponse as b6, type NotificationChannelSet as b7, type NotificationDigestConfig as b8, type NotificationHistoryItem as b9, type QueryEventsRequest as bA, type QueryInboundMonitoringEventsRequest as bB, type QueryMonitoringEventsV2Request as bC, type QueryOutboundMonitoringEventsRequest as bD, type RedriveOutboundDlqRequest as bE, type RedriveOutboundDlqResponse as bF, type RedriveOutboundDlqResult as bG, type RelationConfig as bH, type RelationItemConfig as bI, type RelationRefItemConfig as bJ, type RelationRefValueConfig as bK, type RelationRefsConfig as bL, type RelationUniqueIdField as bM, type RepeatableFieldType as bN, type ReplayEventsRequest as bO, type RuleBaselineBucket as bP, type RuleBaselineStatus as bQ, type S3Reference as bR, type SecureProxyRequest as bS, type SecureProxyResponse as bT, type SecureProxySummary as bU, type SecureProxyUpstreamError as bV, type SecureProxyUseCase as bW, type SecureProxyUseCaseConfiguration as bX, type SecureProxyUseCaseHistoryEntry as bY, type SecureProxyWhitelist as bZ, type SecureProxyWhitelistUpdate as b_, type NotificationHistoryResponse as ba, type NotificationRecipient as bb, type NotificationRule as bc, type NotificationRuleStatus as bd, type NotificationStatusResponse as be, type OutboundConflict as bf, type OutboundDlqListResponse as bg, type OutboundDlqMessage as bh, type OutboundFileProxyTargetStatus as bi, type OutboundIntegrationEventConfiguration as bj, type OutboundMapping as bk, type OutboundMessage as bl, type OutboundMonitoringEvent as bm, type OutboundPollStatus as bn, type OutboundStatusResponse as bo, type OutboundUseCase as bp, type OutboundUseCaseHistoryEntry as bq, type OutboundUseCaseStatus as br, type PollDeliveryConfig as bs, type PollOutboundMessagesRequest as bt, type PollOutboundMessagesResponse as bu, type PortalOrigin as bv, type PortalRefConfig as bw, type PortalRefFilter as bx, type PruneScopeConfig as by, type QueryAccessLogsRequest as bz, type AckOutboundMessagesRequest as c, type SuggestErpImportUseCasesResponse as c0, type TestNotificationRequest as c1, type TestNotificationResponse as c2, type TimeSeriesBreakdownItemV2 as c3, type TimeSeriesBucket as c4, type TimeSeriesBucketV2 as c5, type TriggerErpActionRequest as c6, type TriggerWebhookResp as c7, type TypeAnnotations as c8, type TypeDescriptor as c9, type UnblockOutboundStreamRequest as ca, type UnblockOutboundStreamResponse as cb, type UpdateFileProxyUseCaseRequest as cc, type UpdateInboundUseCaseRequest as cd, type UpdateIntegrationRequest as ce, type UpdateManagedCallUseCaseRequest as cf, type UpdateOutboundUseCaseRequest as cg, type UpdateSecureProxyUseCaseRequest as ch, type UpdateUseCaseRequest as ci, type UpdateUseCaseRequestBase as cj, type UpsertDocumentationPageRequest as ck, type UpsertIntegrationWithUseCasesRequest as cl, type UseCase as cm, type UseCaseBase as cn, type UseCaseHistoryEntry as co, type UseCaseHistoryEntryBase as cp, type UseCaseTypePreview as cq, type ValidateErpImportRequest as cr, type WebhookDeliveryConfig as cs, type WebhookStatus as ct, type AckOutboundMessagesResponse as d, type AckResult as e, type AutoRefreshSettings as f, type CommitTypesRequest as g, type CommitTypesResponse as h, type ConnectorConfig as i, type CreateErpImportRequest as j, type CreateErpImportResponse as k, type CreateFileProxyUseCaseRequest as l, type CreateInboundUseCaseRequest as m, type CreateIntegrationRequest as n, type CreateManagedCallUseCaseRequest as o, type CreateOutboundUseCaseRequest as p, type CreateSecureProxyUseCaseRequest as q, type CreateUseCaseRequest as r, type CreateUseCaseRequestBase as s, type DeliveryConfig as t, type DirectEntityOperation as u, type DirectMeterReadingOperation as v, type DirectPayload as w, type DirectRelationItem as x, type DirectRelationRefItem as y, type DirectRelationRefValue as z };
+export { type ErpImportError as $, type AccessLogEntry as A, type DirectRelationValue as B, type Client as C, type DeleteIntegrationAppMappingRequest as D, type DirectSimulationError as E, type DirectSimulationRequest as F, type DirectSimulationResponse as G, type DocumentationPage as H, type DocumentationPageSummary as I, type EmbeddedFileProxyUseCaseRequest as J, type EmbeddedInboundUseCaseRequest as K, type EmbeddedManagedCallUseCaseRequest as L, type EmbeddedOutboundUseCaseRequest as M, type EmbeddedSecureProxyUseCaseRequest as N, type OperationMethods as O, Paths as P, type EmbeddedUseCaseRequest as Q, type EmbeddedUseCaseRequestBase as R, type EntityPruneScopeUpdate as S, type EntitySyncState as T, type EntitySyncStatusResponse as U, type EntityUpdate as V, type EnvVarRefConfig as W, type EnvironmentFieldConfig as X, type ErpEvent as Y, type ErpEventV3 as Z, type ErpImportEntityDetail as _, Components as a, type MappedFieldValue as a$, type ErpImportFilePreview as a0, type ErpImportIssue as a1, type ErpImportJob as a2, type ErpImportList as a3, type ErpImportProgress as a4, type ErpImportUseCaseSuggestion as a5, type ErpImportValidation as a6, type ErpUpdatesEventsV2Request as a7, type ErpUpdatesEventsV3Request as a8, type ErrorResponseBase as a9, type InboundUseCaseHistoryEntry as aA, type IngestExternalMonitoringEventsRequest as aB, type IngestExternalMonitoringEventsResponse as aC, type Integration as aD, type IntegrationAppMapping as aE, type IntegrationConfigurationV1 as aF, type IntegrationConfigurationV2 as aG, type IntegrationEditableFields as aH, type IntegrationEntity as aI, type IntegrationEntityConditional as aJ, type IntegrationEntityField as aK, type IntegrationEntityFold as aL, type IntegrationFieldV1 as aM, type IntegrationMap as aN, type IntegrationMeterReading as aO, type IntegrationNotificationConfig as aP, type IntegrationObjectV1 as aQ, type IntegrationSettings as aR, type IntegrationWithUseCases as aS, type ManagedCallAuth as aT, type ManagedCallErrorResponse as aU, type ManagedCallExecuteRequest as aV, type ManagedCallExecuteResponse as aW, type ManagedCallOperation as aX, type ManagedCallOperationConfig as aY, type ManagedCallUseCase as aZ, type ManagedCallUseCaseHistoryEntry as a_, type ExecuteErpImportRequest as aa, type ExternalMonitoringSpan as ab, type FileProxyAuth as ac, type FileProxyDeliveryConfig as ad, type FileProxyFanOutConfig as ae, type FileProxyParam as af, type FileProxyResponseConfig as ag, type FileProxySecureProxyAttachment as ah, type FileProxyStep as ai, type FileProxyUploadConfig as aj, type FileProxyUrlConfig as ak, type FileProxyUrlParam as al, type FileProxyUrlParams as am, type FileProxyUseCase as an, type FileProxyUseCaseConfiguration as ao, type FileProxyUseCaseHistoryEntry as ap, type GenerateTypesPreviewResponse as aq, type GenerateTypesRequest as ar, type GenerateTypesResponse as as, type GetMonitoringStatsRequest as at, type GetMonitoringStatsV2Request as au, type GetMonitoringTimeSeriesRequest as av, type GetMonitoringTimeSeriesV2Request as aw, type InboundIntegrationEventConfiguration as ax, type InboundMonitoringEvent as ay, type InboundUseCase as az, type PathsDictionary as b, type SecureProxyUseCase as b$, type MappingSimulationRequest as b0, type MappingSimulationResponse as b1, type MappingSimulationV2Request as b2, type MappingSimulationWarning as b3, type MeterReadingPruneScopeConfig as b4, type MeterReadingPruneScopeUpdate as b5, type MeterReadingUpdate as b6, type MeterUniqueIdsConfig as b7, type MonitoringEventV2 as b8, type MonitoringStats as b9, type PortalOrigin as bA, type PortalRefConfig as bB, type PortalRefFilter as bC, type PruneScopeConfig as bD, type QueryAccessLogsRequest as bE, type QueryEventsRequest as bF, type QueryInboundMonitoringEventsRequest as bG, type QueryMonitoringEventsV2Request as bH, type QueryOutboundMonitoringEventsRequest as bI, type RedriveOutboundDlqRequest as bJ, type RedriveOutboundDlqResponse as bK, type RedriveOutboundDlqResult as bL, type RelationConfig as bM, type RelationItemConfig as bN, type RelationRefItemConfig as bO, type RelationRefValueConfig as bP, type RelationRefsConfig as bQ, type RelationUniqueIdField as bR, type RepeatableFieldType as bS, type ReplayEventsRequest as bT, type RuleBaselineBucket as bU, type RuleBaselineStatus as bV, type S3Reference as bW, type SecureProxyRequest as bX, type SecureProxyResponse as bY, type SecureProxySummary as bZ, type SecureProxyUpstreamError as b_, type MonitoringStatsV2 as ba, type MonitoringTraceResponse as bb, type NotificationChannelSet as bc, type NotificationDigestConfig as bd, type NotificationHistoryItem as be, type NotificationHistoryResponse as bf, type NotificationRecipient as bg, type NotificationRule as bh, type NotificationRuleStatus as bi, type NotificationStatusResponse as bj, type OutboundConflict as bk, type OutboundDlqListResponse as bl, type OutboundDlqMessage as bm, type OutboundFileProxyTargetStatus as bn, type OutboundIntegrationEventConfiguration as bo, type OutboundMapping as bp, type OutboundMessage as bq, type OutboundMonitoringEvent as br, type OutboundPollStatus as bs, type OutboundStatusResponse as bt, type OutboundUseCase as bu, type OutboundUseCaseHistoryEntry as bv, type OutboundUseCaseStatus as bw, type PollDeliveryConfig as bx, type PollOutboundMessagesRequest as by, type PollOutboundMessagesResponse as bz, type AckOutboundMessagesRequest as c, type SecureProxyUseCaseConfiguration as c0, type SecureProxyUseCaseHistoryEntry as c1, type SecureProxyWhitelist as c2, type SecureProxyWhitelistUpdate as c3, type SetIntegrationAppMappingRequest as c4, type SuggestErpImportUseCasesResponse as c5, type TestNotificationRequest as c6, type TestNotificationResponse as c7, type TimeSeriesBreakdownItemV2 as c8, type TimeSeriesBucket as c9, type TimeSeriesBucketV2 as ca, type TriggerErpActionRequest as cb, type TriggerWebhookResp as cc, type TypeAnnotations as cd, type TypeDescriptor as ce, type UnblockOutboundStreamRequest as cf, type UnblockOutboundStreamResponse as cg, type UpdateFileProxyUseCaseRequest as ch, type UpdateInboundUseCaseRequest as ci, type UpdateIntegrationRequest as cj, type UpdateManagedCallUseCaseRequest as ck, type UpdateOutboundUseCaseRequest as cl, type UpdateSecureProxyUseCaseRequest as cm, type UpdateUseCaseRequest as cn, type UpdateUseCaseRequestBase as co, type UpsertDocumentationPageRequest as cp, type UpsertIntegrationWithUseCasesRequest as cq, type UseCase as cr, type UseCaseBase as cs, type UseCaseHistoryEntry as ct, type UseCaseHistoryEntryBase as cu, type UseCaseTypePreview as cv, type ValidateErpImportRequest as cw, type WebhookDeliveryConfig as cx, type WebhookStatus as cy, type AckOutboundMessagesResponse as d, type AckResult as e, type AutoRefreshSettings as f, type CommitTypesRequest as g, type CommitTypesResponse as h, type ConnectorConfig as i, type CreateErpImportRequest as j, type CreateErpImportResponse as k, type CreateFileProxyUseCaseRequest as l, type CreateInboundUseCaseRequest as m, type CreateIntegrationRequest as n, type CreateManagedCallUseCaseRequest as o, type CreateOutboundUseCaseRequest as p, type CreateSecureProxyUseCaseRequest as q, type CreateUseCaseRequest as r, type CreateUseCaseRequestBase as s, type DeliveryConfig as t, type DirectEntityOperation as u, type DirectMeterReadingOperation as v, type DirectPayload as w, type DirectRelationItem as x, type DirectRelationRefItem as y, type DirectRelationRefValue as z };