@epilot/sdk 2.20.56 → 2.20.57

package/dist/{integration-toolkit.d-CLlaZx6b.d.cts → integration-toolkit.d-DWslwG3c.d.cts}

@@ -2990,8 +2990,23 @@ declare namespace Components {
          * 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.
+         * deliberately no message to display. Each code appears at most once (once per
+         * `expected` for `VALUE_FORMAT_INVALID`), with everything it has to say aggregated
+         * into that one entry.
+         *
+         * `VALUE_FORMAT_INVALID` — the mapping produces values in a format the entity schema
+         * does not store; `expected` says which format, and `columns` names every column
+         * (or, for a value built by an expression, the attribute) that holds one.
+         *
+         * `MAPPING_EXPRESSION_FAILED` (a warning) — a mapping expression failed for some rows,
+         * including `$number()` on a value it cannot convert such as `12,50` or on a blank cell,
+         * so importing anyway leaves those values out; `attributes` names the attribute it fills.
+         *
+         * `FROM_ROWS_EXPRESSION_FAILED` — an expression in a `conditional.from_rows` item failed
+         * for some rows. Blocking, unlike a field: the import would skip every entry of that
+         * target built in the same chunk, not one value; `attributes` names the list attribute.
+         *
+         * `lines` points at up to five file lines an issue was seen on, as examples.
          *
          * The conditional codes describe a file that cannot be written as variants:
          *
@@ -3019,7 +3034,7 @@ declare namespace Components {
              * 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" | "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_SORT_COLUMN" | "CONDITIONAL_TARGET_MODE_UNSUPPORTED";
+            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_SORT_COLUMN" | "CONDITIONAL_TARGET_MODE_UNSUPPORTED" | "VALUE_FORMAT_INVALID" | "MAPPING_EXPRESSION_FAILED" | "FROM_ROWS_EXPRESSION_FAILED";
             severity: "warning" | "blocking";
             /**
              * The columns this issue is about, at most one entry per column per entity.
@@ -3035,14 +3050,33 @@ declare namespace Components {
                  */
                 entity?: string;
             }[];
+            /**
+             * The mapping fields this issue is about, where the value is not a file column as it is: an expression builds it, or the expression fails. VALUE_FORMAT_INVALID (beside `columns`, which holds the values taken from a column as they are), MAPPING_EXPRESSION_FAILED and FROM_ROWS_EXPRESSION_FAILED.
+             */
+            attributes?: {
+                /**
+                 * The attribute the mapping writes, like `unit_amount_decimal`.
+                 */
+                name: string;
+            }[];
+            /**
+             * Up to five lines of the file this issue was seen on, as examples rather than the full list. The header is line 1. BLANK_ROWS_SKIPPED, VALUE_FORMAT_INVALID, MAPPING_EXPRESSION_FAILED, FROM_ROWS_EXPRESSION_FAILED, TIER_ROWS_NOT_GROUPED (where a variant's rows start again), TIER_BANDS_CONFLICT and VARIANT_VALUE_CONFLICT (the row at odds with the first).
+             */
+            lines?: number[];
             /**
              * 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.
+             * The offending row's line in the file, the header being line 1 — the number a spreadsheet or text editor shows, and the same numbering as `lines`. MALFORMED_ROW only.
              */
             row?: number;
+            /**
+             * The format the values should have had. VALUE_FORMAT_INVALID only.
+             * - `number` — a JSON number; the mapping produces text (wrap the column in `$number()`). - `text` — text; the mapping produces a number. - `decimal` — a plain number with a dot as text, like `12.50`. - `date` — a date like `2026-01-01`, optionally with a time and offset like
+             *   `2026-01-01T08:00:00Z`.
+             */
+            expected?: "number" | "text" | "decimal" | "date";
         }
         export interface ErpImportJob {
             /**
@@ -3158,8 +3192,23 @@ declare namespace Components {
              * 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.
+             * deliberately no message to display. Each code appears at most once (once per
+             * `expected` for `VALUE_FORMAT_INVALID`), with everything it has to say aggregated
+             * into that one entry.
+             *
+             * `VALUE_FORMAT_INVALID` — the mapping produces values in a format the entity schema
+             * does not store; `expected` says which format, and `columns` names every column
+             * (or, for a value built by an expression, the attribute) that holds one.
+             *
+             * `MAPPING_EXPRESSION_FAILED` (a warning) — a mapping expression failed for some rows,
+             * including `$number()` on a value it cannot convert such as `12,50` or on a blank cell,
+             * so importing anyway leaves those values out; `attributes` names the attribute it fills.
+             *
+             * `FROM_ROWS_EXPRESSION_FAILED` — an expression in a `conditional.from_rows` item failed
+             * for some rows. Blocking, unlike a field: the import would skip every entry of that
+             * target built in the same chunk, not one value; `attributes` names the list attribute.
+             *
+             * `lines` points at up to five file lines an issue was seen on, as examples.
              *
              * The conditional codes describe a file that cannot be written as variants:
              *
@@ -8940,6 +8989,7 @@ declare namespace Paths {
             export type $200 = Components.Responses.GetAssociatedMonitoringEventsResponse;
             export type $400 = Components.Responses.BadRequest;
             export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
             export type $500 = Components.Responses.InternalServerError;
         }
     }
@@ -9049,6 +9099,7 @@ declare namespace Paths {
             export type $200 = Components.Responses.GetMonitoringStatsResponse;
             export type $400 = Components.Responses.BadRequest;
             export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
             export type $404 = Components.Responses.NotFound;
             export type $500 = Components.Responses.InternalServerError;
         }
@@ -9065,6 +9116,7 @@ declare namespace Paths {
             export type $200 = Components.Responses.GetMonitoringStatsV2Response;
             export type $400 = Components.Responses.BadRequest;
             export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
             export type $404 = Components.Responses.NotFound;
             export type $500 = Components.Responses.InternalServerError;
         }
@@ -9081,6 +9133,7 @@ declare namespace Paths {
             export type $200 = Components.Responses.GetMonitoringTimeSeriesResponse;
             export type $400 = Components.Responses.BadRequest;
             export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
             export type $404 = Components.Responses.NotFound;
             export type $500 = Components.Responses.InternalServerError;
         }
@@ -9097,6 +9150,7 @@ declare namespace Paths {
             export type $200 = Components.Responses.GetMonitoringTimeSeriesV2Response;
             export type $400 = Components.Responses.BadRequest;
             export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
             export type $404 = Components.Responses.NotFound;
             export type $500 = Components.Responses.InternalServerError;
         }
@@ -9148,6 +9202,7 @@ declare namespace Paths {
         namespace Responses {
             export type $200 = Components.Schemas.OutboundStatusResponse;
             export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
             export type $404 = Components.Responses.NotFound;
             export type $500 = Components.Responses.InternalServerError;
         }
@@ -9501,6 +9556,7 @@ declare namespace Paths {
             export type $200 = Components.Responses.QueryAccessLogsResponse;
             export type $400 = Components.Responses.BadRequest;
             export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
             export type $404 = Components.Responses.NotFound;
             export type $500 = Components.Responses.InternalServerError;
         }
@@ -9533,6 +9589,7 @@ declare namespace Paths {
             export type $200 = Components.Responses.QueryInboundMonitoringEventsResponse;
             export type $400 = Components.Responses.BadRequest;
             export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
             export type $404 = Components.Responses.NotFound;
             export type $500 = Components.Responses.InternalServerError;
         }
@@ -9549,6 +9606,7 @@ declare namespace Paths {
             export type $200 = Components.Responses.QueryMonitoringEventsV2Response;
             export type $400 = Components.Responses.BadRequest;
             export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
             export type $404 = Components.Responses.NotFound;
             export type $500 = Components.Responses.InternalServerError;
         }
@@ -9565,6 +9623,7 @@ declare namespace Paths {
             export type $200 = Components.Responses.QueryOutboundMonitoringEventsResponse;
             export type $400 = Components.Responses.BadRequest;
             export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
             export type $404 = Components.Responses.NotFound;
             export type $500 = Components.Responses.InternalServerError;
         }
@@ -10602,6 +10661,9 @@ interface OperationMethods {
    * Query monitoring events from the unified erp_monitoring_v2 table.
    * Returns all event types (inbound, outbound, file_proxy, etc.) in a single list.
    * Replaces the separate v1 inbound-events and outbound-events endpoints.
+   * Requires the `integration:view` grant for the integration: event
+   * details can carry customer data (a mapped poll message's delivered
+   * payload, for example).
    * 
    */
   'queryMonitoringEventsV2'(
@@ -11658,6 +11720,9 @@ interface PathsDictionary {
      * Query monitoring events from the unified erp_monitoring_v2 table.
      * Returns all event types (inbound, outbound, file_proxy, etc.) in a single list.
      * Replaces the separate v1 inbound-events and outbound-events endpoints.
+     * Requires the `integration:view` grant for the integration: event
+     * details can carry customer data (a mapped poll message's delivered
+     * payload, for example).
      * 
      */
     'post'(

package/dist/{integration-toolkit.d-CLlaZx6b.d.ts → integration-toolkit.d-DWslwG3c.d.ts}

@@ -2990,8 +2990,23 @@ declare namespace Components {
          * 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.
+         * deliberately no message to display. Each code appears at most once (once per
+         * `expected` for `VALUE_FORMAT_INVALID`), with everything it has to say aggregated
+         * into that one entry.
+         *
+         * `VALUE_FORMAT_INVALID` — the mapping produces values in a format the entity schema
+         * does not store; `expected` says which format, and `columns` names every column
+         * (or, for a value built by an expression, the attribute) that holds one.
+         *
+         * `MAPPING_EXPRESSION_FAILED` (a warning) — a mapping expression failed for some rows,
+         * including `$number()` on a value it cannot convert such as `12,50` or on a blank cell,
+         * so importing anyway leaves those values out; `attributes` names the attribute it fills.
+         *
+         * `FROM_ROWS_EXPRESSION_FAILED` — an expression in a `conditional.from_rows` item failed
+         * for some rows. Blocking, unlike a field: the import would skip every entry of that
+         * target built in the same chunk, not one value; `attributes` names the list attribute.
+         *
+         * `lines` points at up to five file lines an issue was seen on, as examples.
          *
          * The conditional codes describe a file that cannot be written as variants:
          *
@@ -3019,7 +3034,7 @@ declare namespace Components {
              * 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" | "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_SORT_COLUMN" | "CONDITIONAL_TARGET_MODE_UNSUPPORTED";
+            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_SORT_COLUMN" | "CONDITIONAL_TARGET_MODE_UNSUPPORTED" | "VALUE_FORMAT_INVALID" | "MAPPING_EXPRESSION_FAILED" | "FROM_ROWS_EXPRESSION_FAILED";
             severity: "warning" | "blocking";
             /**
              * The columns this issue is about, at most one entry per column per entity.
@@ -3035,14 +3050,33 @@ declare namespace Components {
                  */
                 entity?: string;
             }[];
+            /**
+             * The mapping fields this issue is about, where the value is not a file column as it is: an expression builds it, or the expression fails. VALUE_FORMAT_INVALID (beside `columns`, which holds the values taken from a column as they are), MAPPING_EXPRESSION_FAILED and FROM_ROWS_EXPRESSION_FAILED.
+             */
+            attributes?: {
+                /**
+                 * The attribute the mapping writes, like `unit_amount_decimal`.
+                 */
+                name: string;
+            }[];
+            /**
+             * Up to five lines of the file this issue was seen on, as examples rather than the full list. The header is line 1. BLANK_ROWS_SKIPPED, VALUE_FORMAT_INVALID, MAPPING_EXPRESSION_FAILED, FROM_ROWS_EXPRESSION_FAILED, TIER_ROWS_NOT_GROUPED (where a variant's rows start again), TIER_BANDS_CONFLICT and VARIANT_VALUE_CONFLICT (the row at odds with the first).
+             */
+            lines?: number[];
             /**
              * 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.
+             * The offending row's line in the file, the header being line 1 — the number a spreadsheet or text editor shows, and the same numbering as `lines`. MALFORMED_ROW only.
              */
             row?: number;
+            /**
+             * The format the values should have had. VALUE_FORMAT_INVALID only.
+             * - `number` — a JSON number; the mapping produces text (wrap the column in `$number()`). - `text` — text; the mapping produces a number. - `decimal` — a plain number with a dot as text, like `12.50`. - `date` — a date like `2026-01-01`, optionally with a time and offset like
+             *   `2026-01-01T08:00:00Z`.
+             */
+            expected?: "number" | "text" | "decimal" | "date";
         }
         export interface ErpImportJob {
             /**
@@ -3158,8 +3192,23 @@ declare namespace Components {
              * 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.
+             * deliberately no message to display. Each code appears at most once (once per
+             * `expected` for `VALUE_FORMAT_INVALID`), with everything it has to say aggregated
+             * into that one entry.
+             *
+             * `VALUE_FORMAT_INVALID` — the mapping produces values in a format the entity schema
+             * does not store; `expected` says which format, and `columns` names every column
+             * (or, for a value built by an expression, the attribute) that holds one.
+             *
+             * `MAPPING_EXPRESSION_FAILED` (a warning) — a mapping expression failed for some rows,
+             * including `$number()` on a value it cannot convert such as `12,50` or on a blank cell,
+             * so importing anyway leaves those values out; `attributes` names the attribute it fills.
+             *
+             * `FROM_ROWS_EXPRESSION_FAILED` — an expression in a `conditional.from_rows` item failed
+             * for some rows. Blocking, unlike a field: the import would skip every entry of that
+             * target built in the same chunk, not one value; `attributes` names the list attribute.
+             *
+             * `lines` points at up to five file lines an issue was seen on, as examples.
              *
              * The conditional codes describe a file that cannot be written as variants:
              *
@@ -8940,6 +8989,7 @@ declare namespace Paths {
             export type $200 = Components.Responses.GetAssociatedMonitoringEventsResponse;
             export type $400 = Components.Responses.BadRequest;
             export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
             export type $500 = Components.Responses.InternalServerError;
         }
     }
@@ -9049,6 +9099,7 @@ declare namespace Paths {
             export type $200 = Components.Responses.GetMonitoringStatsResponse;
             export type $400 = Components.Responses.BadRequest;
             export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
             export type $404 = Components.Responses.NotFound;
             export type $500 = Components.Responses.InternalServerError;
         }
@@ -9065,6 +9116,7 @@ declare namespace Paths {
             export type $200 = Components.Responses.GetMonitoringStatsV2Response;
             export type $400 = Components.Responses.BadRequest;
             export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
             export type $404 = Components.Responses.NotFound;
             export type $500 = Components.Responses.InternalServerError;
         }
@@ -9081,6 +9133,7 @@ declare namespace Paths {
             export type $200 = Components.Responses.GetMonitoringTimeSeriesResponse;
             export type $400 = Components.Responses.BadRequest;
             export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
             export type $404 = Components.Responses.NotFound;
             export type $500 = Components.Responses.InternalServerError;
         }
@@ -9097,6 +9150,7 @@ declare namespace Paths {
             export type $200 = Components.Responses.GetMonitoringTimeSeriesV2Response;
             export type $400 = Components.Responses.BadRequest;
             export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
             export type $404 = Components.Responses.NotFound;
             export type $500 = Components.Responses.InternalServerError;
         }
@@ -9148,6 +9202,7 @@ declare namespace Paths {
         namespace Responses {
             export type $200 = Components.Schemas.OutboundStatusResponse;
             export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
             export type $404 = Components.Responses.NotFound;
             export type $500 = Components.Responses.InternalServerError;
         }
@@ -9501,6 +9556,7 @@ declare namespace Paths {
             export type $200 = Components.Responses.QueryAccessLogsResponse;
             export type $400 = Components.Responses.BadRequest;
             export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
             export type $404 = Components.Responses.NotFound;
             export type $500 = Components.Responses.InternalServerError;
         }
@@ -9533,6 +9589,7 @@ declare namespace Paths {
             export type $200 = Components.Responses.QueryInboundMonitoringEventsResponse;
             export type $400 = Components.Responses.BadRequest;
             export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
             export type $404 = Components.Responses.NotFound;
             export type $500 = Components.Responses.InternalServerError;
         }
@@ -9549,6 +9606,7 @@ declare namespace Paths {
             export type $200 = Components.Responses.QueryMonitoringEventsV2Response;
             export type $400 = Components.Responses.BadRequest;
             export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
             export type $404 = Components.Responses.NotFound;
             export type $500 = Components.Responses.InternalServerError;
         }
@@ -9565,6 +9623,7 @@ declare namespace Paths {
             export type $200 = Components.Responses.QueryOutboundMonitoringEventsResponse;
             export type $400 = Components.Responses.BadRequest;
             export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
             export type $404 = Components.Responses.NotFound;
             export type $500 = Components.Responses.InternalServerError;
         }
@@ -10602,6 +10661,9 @@ interface OperationMethods {
    * Query monitoring events from the unified erp_monitoring_v2 table.
    * Returns all event types (inbound, outbound, file_proxy, etc.) in a single list.
    * Replaces the separate v1 inbound-events and outbound-events endpoints.
+   * Requires the `integration:view` grant for the integration: event
+   * details can carry customer data (a mapped poll message's delivered
+   * payload, for example).
    * 
    */
   'queryMonitoringEventsV2'(
@@ -11658,6 +11720,9 @@ interface PathsDictionary {
      * Query monitoring events from the unified erp_monitoring_v2 table.
      * Returns all event types (inbound, outbound, file_proxy, etc.) in a single list.
      * Replaces the separate v1 inbound-events and outbound-events endpoints.
+     * Requires the `integration:view` grant for the integration: event
+     * details can carry customer data (a mapped poll message's delivered
+     * payload, for example).
      * 
      */
     'post'(

package/docs/integration-toolkit.md

@@ -3722,8 +3722,15 @@ const { data } = await client.createErpImport(
               "entity": "string"
             }
           ],
+          "attributes": [
+            {
+              "name": "string"
+            }
+          ],
+          "lines": [0],
           "subject": "string",
-          "row": 0
+          "row": 0,
+          "expected": "number"
         }
       ]
     },
@@ -3812,8 +3819,15 @@ const { data } = await client.listErpImports({
                 "entity": "string"
               }
             ],
+            "attributes": [
+              {
+                "name": "string"
+              }
+            ],
+            "lines": [0],
             "subject": "string",
-            "row": 0
+            "row": 0,
+            "expected": "number"
           }
         ]
       },
@@ -3895,8 +3909,15 @@ const { data } = await client.getErpImport({
             "entity": "string"
           }
         ],
+        "attributes": [
+          {
+            "name": "string"
+          }
+        ],
+        "lines": [0],
         "subject": "string",
-        "row": 0
+        "row": 0,
+        "expected": "number"
       }
     ]
   },
@@ -4159,19 +4180,24 @@ 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 on
+deliberately no message to display. Each code appears at most once (once per
+`expected` for `VALUE_FORMAT_INVALID`), with
 
 ```ts
 type ErpImportIssue = {
-  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_SORT_COLUMN" | "CONDITIONAL_TARGET_MODE_UNSUPPORTED"
+  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_SORT_COLUMN" | "CONDITIONAL_TARGET_MODE_UNSUPPORTED" | "VALUE_FORMAT_INVALID" | "MAPPING_EXPRESSION_FAILED" | "FROM_ROWS_EXPRESSION_FAILED"
   severity: "warning" | "blocking"
   columns?: Array<{
     name: string
     entity?: string
   }>
+  attributes?: Array<{
+    name: string
+  }>
+  lines?: number[]
   subject?: string
   row?: number
+  expected?: "number" | "text" | "decimal" | "date"
 }
 ```
 
@@ -4195,14 +4221,19 @@ type ErpImportValidation = {
     version_attribute?: string
   }>
   issues?: Array<{
-    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_SORT_COLUMN" | "CONDITIONAL_TARGET_MODE_UNSUPPORTED"
+    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_SORT_COLUMN" | "CONDITIONAL_TARGET_MODE_UNSUPPORTED" | "VALUE_FORMAT_INVALID" | "MAPPING_EXPRESSION_FAILED" | "FROM_ROWS_EXPRESSION_FAILED"
     severity: "warning" | "blocking"
     columns?: Array<{
       name: { ... }
       entity?: { ... }
     }>
+    attributes?: Array<{
+      name: { ... }
+    }>
+    lines?: number[]
     subject?: string
     row?: number
+    expected?: "number" | "text" | "decimal" | "date"
   }>
 }
 ```
@@ -4348,8 +4379,11 @@ type ErpImportJob = {
       code: { ... }
       severity: { ... }
       columns?: { ... }
+      attributes?: { ... }
+      lines?: { ... }
       subject?: { ... }
       row?: { ... }
+      expected?: { ... }
     }>
   }
   progress?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/sdk",
-  "version": "2.20.56",
+  "version": "2.20.57",
   "description": "JavaScript/TypeScript SDK for epilot APIs",
   "type": "module",
   "main": "./dist/index.cjs",