@epilot/sdk 2.18.2 → 2.18.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (126) hide show
  1. package/definitions/integration-toolkit-runtime.json +1 -1
  2. package/definitions/integration-toolkit.json +89 -6
  3. package/dist/apis/access-token.cjs +6 -6
  4. package/dist/apis/access-token.js +1 -1
  5. package/dist/apis/address-suggestions.cjs +6 -6
  6. package/dist/apis/address-suggestions.js +1 -1
  7. package/dist/apis/address.cjs +6 -6
  8. package/dist/apis/address.js +1 -1
  9. package/dist/apis/ai-agents.cjs +6 -6
  10. package/dist/apis/ai-agents.js +1 -1
  11. package/dist/apis/app.cjs +6 -6
  12. package/dist/apis/app.js +1 -1
  13. package/dist/apis/audit-logs.cjs +6 -6
  14. package/dist/apis/audit-logs.js +1 -1
  15. package/dist/apis/automation.cjs +6 -6
  16. package/dist/apis/automation.js +1 -1
  17. package/dist/apis/billing.cjs +6 -6
  18. package/dist/apis/billing.js +1 -1
  19. package/dist/apis/blueprint-manifest.cjs +6 -6
  20. package/dist/apis/blueprint-manifest.js +1 -1
  21. package/dist/apis/calendar.cjs +6 -6
  22. package/dist/apis/calendar.js +1 -1
  23. package/dist/apis/configuration-hub.cjs +6 -6
  24. package/dist/apis/configuration-hub.js +1 -1
  25. package/dist/apis/consent.cjs +6 -6
  26. package/dist/apis/consent.js +1 -1
  27. package/dist/apis/customer-portal.cjs +6 -6
  28. package/dist/apis/customer-portal.js +1 -1
  29. package/dist/apis/dashboard.cjs +6 -6
  30. package/dist/apis/dashboard.js +1 -1
  31. package/dist/apis/data-governance.cjs +6 -6
  32. package/dist/apis/data-governance.js +1 -1
  33. package/dist/apis/deduplication.cjs +6 -6
  34. package/dist/apis/deduplication.js +1 -1
  35. package/dist/apis/design.cjs +6 -6
  36. package/dist/apis/design.js +1 -1
  37. package/dist/apis/document.cjs +6 -6
  38. package/dist/apis/document.js +1 -1
  39. package/dist/apis/email-settings.cjs +6 -6
  40. package/dist/apis/email-settings.js +1 -1
  41. package/dist/apis/email-template.cjs +6 -6
  42. package/dist/apis/email-template.js +1 -1
  43. package/dist/apis/entity-mapping.cjs +6 -6
  44. package/dist/apis/entity-mapping.js +1 -1
  45. package/dist/apis/entity.cjs +6 -6
  46. package/dist/apis/entity.js +1 -1
  47. package/dist/apis/environments.cjs +6 -6
  48. package/dist/apis/environments.js +1 -1
  49. package/dist/apis/event-catalog.cjs +6 -6
  50. package/dist/apis/event-catalog.js +1 -1
  51. package/dist/apis/file.cjs +6 -6
  52. package/dist/apis/file.js +1 -1
  53. package/dist/apis/iban.cjs +6 -6
  54. package/dist/apis/iban.js +1 -1
  55. package/dist/apis/integration-toolkit.cjs +8 -8
  56. package/dist/apis/integration-toolkit.d.cts +2 -2
  57. package/dist/apis/integration-toolkit.d.ts +2 -2
  58. package/dist/apis/integration-toolkit.js +2 -2
  59. package/dist/apis/journey.cjs +6 -6
  60. package/dist/apis/journey.js +1 -1
  61. package/dist/apis/kanban.cjs +6 -6
  62. package/dist/apis/kanban.js +1 -1
  63. package/dist/apis/message.cjs +6 -6
  64. package/dist/apis/message.js +1 -1
  65. package/dist/apis/metering.cjs +6 -6
  66. package/dist/apis/metering.js +1 -1
  67. package/dist/apis/notes.cjs +6 -6
  68. package/dist/apis/notes.js +1 -1
  69. package/dist/apis/notification.cjs +6 -6
  70. package/dist/apis/notification.js +1 -1
  71. package/dist/apis/organization.cjs +6 -6
  72. package/dist/apis/organization.js +1 -1
  73. package/dist/apis/partner-directory.cjs +6 -6
  74. package/dist/apis/partner-directory.js +1 -1
  75. package/dist/apis/permissions.cjs +6 -6
  76. package/dist/apis/permissions.js +1 -1
  77. package/dist/apis/pricing-tier.cjs +6 -6
  78. package/dist/apis/pricing-tier.js +1 -1
  79. package/dist/apis/pricing.cjs +6 -6
  80. package/dist/apis/pricing.js +1 -1
  81. package/dist/apis/purpose.cjs +6 -6
  82. package/dist/apis/purpose.js +1 -1
  83. package/dist/apis/query.cjs +6 -6
  84. package/dist/apis/query.js +1 -1
  85. package/dist/apis/sandbox.cjs +6 -6
  86. package/dist/apis/sandbox.js +1 -1
  87. package/dist/apis/sharing.cjs +6 -6
  88. package/dist/apis/sharing.js +1 -1
  89. package/dist/apis/snapshot.cjs +6 -6
  90. package/dist/apis/snapshot.js +1 -1
  91. package/dist/apis/submission.cjs +6 -6
  92. package/dist/apis/submission.js +1 -1
  93. package/dist/apis/target.cjs +6 -6
  94. package/dist/apis/target.js +1 -1
  95. package/dist/apis/targeting.cjs +6 -6
  96. package/dist/apis/targeting.js +1 -1
  97. package/dist/apis/template-variables.cjs +6 -6
  98. package/dist/apis/template-variables.js +1 -1
  99. package/dist/apis/user.cjs +6 -6
  100. package/dist/apis/user.js +1 -1
  101. package/dist/apis/validation-rules.cjs +6 -6
  102. package/dist/apis/validation-rules.js +1 -1
  103. package/dist/apis/webhooks.cjs +6 -6
  104. package/dist/apis/webhooks.js +1 -1
  105. package/dist/apis/workflow-definition.cjs +6 -6
  106. package/dist/apis/workflow-definition.js +1 -1
  107. package/dist/apis/workflow.cjs +6 -6
  108. package/dist/apis/workflow.js +1 -1
  109. package/dist/{chunk-RJHXXGJ3.js → chunk-5OOGTDF2.js} +1 -1
  110. package/dist/{chunk-TFHLWZHW.cjs → chunk-5RAQKW2K.cjs} +2 -2
  111. package/dist/{chunk-DEAWSP6H.js → chunk-6XCKLP3T.js} +2 -2
  112. package/dist/{chunk-QXKCYTF3.cjs → chunk-RXFXAZK3.cjs} +1 -1
  113. package/dist/index.cjs +10 -10
  114. package/dist/index.d.cts +1 -1
  115. package/dist/index.d.ts +1 -1
  116. package/dist/index.js +2 -2
  117. package/dist/integration-toolkit-63NIMAHB.js +7 -0
  118. package/dist/integration-toolkit-7NCK7Z5G.cjs +7 -0
  119. package/dist/{integration-toolkit-runtime-VUOXZ6HU.js → integration-toolkit-runtime-2MBB4EOE.js} +1 -1
  120. package/dist/{integration-toolkit-runtime-PI5G3OXL.cjs → integration-toolkit-runtime-VUI4NCRJ.cjs} +2 -2
  121. package/dist/{integration-toolkit.d-D5HZSNUf.d.cts → integration-toolkit.d-E2nrIdIM.d.cts} +43 -6
  122. package/dist/{integration-toolkit.d-D5HZSNUf.d.ts → integration-toolkit.d-E2nrIdIM.d.ts} +43 -6
  123. package/docs/integration-toolkit.md +79 -12
  124. package/package.json +1 -1
  125. package/dist/integration-toolkit-XGP4BIWX.js +0 -7
  126. package/dist/integration-toolkit-ZVBMKUWM.cjs +0 -7
@@ -2031,14 +2031,34 @@ declare namespace Components {
2031
2031
  */
2032
2032
  export interface ErpImportError {
2033
2033
  /**
2034
- * VALIDATION_BLOCKED = blocking row issues (see `validation`); PROCESSING_ERROR = a named, deterministic failure — retrying the same file cannot help; INTERNAL_ERROR = crashed or never started, so retry.
2034
+ * Enum of possible error codes.
2035
+ *
2035
2036
  */
2036
- type: "VALIDATION_BLOCKED" | "PROCESSING_ERROR" | "INTERNAL_ERROR";
2037
+ code: "VALIDATION_BLOCKED" | "FILE_FORMAT_UNSUPPORTED" | "FILE_UNAVAILABLE" | "VALIDATE_TIMEOUT" | "IMPORT_TIMEOUT" | "USE_CASE_NOT_USABLE" | "IMPORT_NO_PROGRESS" | "INTERNAL_ERROR";
2037
2038
  /**
2038
2039
  * User-facing explanation of `type`.
2039
2040
  */
2040
2041
  message: string;
2041
2042
  }
2043
+ /**
2044
+ * A problem found during validation, scoped to the file as a whole rather than to individual rows. See `code` for the kinds reported.
2045
+ */
2046
+ export interface ErpImportIssue {
2047
+ /**
2048
+ * Enum of possible issue codes.
2049
+ *
2050
+ */
2051
+ code: "UNIQUE_ID_COLUMN_MISSING" | "MAPPED_COLUMN_MISSING" | "MALFORMED_ROW" | "INVALID_ENCODING" | "EMPTY_FILE" | "TOO_MANY_ROWS";
2052
+ severity: "warning" | "blocking";
2053
+ /**
2054
+ * User-facing explanation. Lists at most 10 column names; `columns` has all of them.
2055
+ */
2056
+ message: string;
2057
+ /**
2058
+ * The columns this issue is about, so clients render names rather than parsing the message.
2059
+ */
2060
+ columns?: string[];
2061
+ }
2042
2062
  export interface ErpImportJob {
2043
2063
  /**
2044
2064
  * `imp_{ULID}` — time-ordered, also used as the job's correlation_id.
@@ -2054,7 +2074,7 @@ declare namespace Components {
2054
2074
  format: "csv" | "xlsx";
2055
2075
  /**
2056
2076
  * PENDING → VALIDATING → READY → PROCESSING → IMPORTED, with FAILED reachable from any working status, and CANCELLING → CANCELLED reachable from VALIDATING or PROCESSING via :abort. IMPORTED, FAILED and CANCELLED are terminal and final.
2057
- * IMPORTED means every row was handed to the platform, not that the platform finished — per-row outcomes live in monitoring, filtered by correlation_id. A file that fails validation is FAILED with error.type = VALIDATION_BLOCKED.
2077
+ * IMPORTED means every row was handed to the platform, not that the platform finished — per-row outcomes live in monitoring, filtered by correlation_id. A file that fails validation is FAILED with error.code = VALIDATION_BLOCKED.
2058
2078
  * READY is legitimately idle for as long as the user takes to confirm, so it carries no running work and never goes stale.
2059
2079
  * CANCELLING is transient and cooperative: the abort has been recorded but the worker only notices at its next batch boundary. Rows already published stay published — a stop is not a rollback.
2060
2080
  */
@@ -2112,6 +2132,10 @@ declare namespace Components {
2112
2132
  entities: {
2113
2133
  [name: string]: number;
2114
2134
  };
2135
+ /**
2136
+ * Whole-file issues. At most 20 are kept; the count of everything found is in blocking and warnings. Warnings here are what `ack_warnings` on `:execute` acknowledges.
2137
+ */
2138
+ issues?: /* A problem found during validation, scoped to the file as a whole rather than to individual rows. See `code` for the kinds reported. */ ErpImportIssue[];
2115
2139
  }
2116
2140
  export interface ErpUpdatesEventsV2Request {
2117
2141
  /**
@@ -2178,6 +2202,15 @@ declare namespace Components {
2178
2202
  */
2179
2203
  message?: string;
2180
2204
  }
2205
+ /**
2206
+ * Confirmation options. Required only when the verdict carries warnings — a clean import needs no body at all.
2207
+ */
2208
+ export interface ExecuteErpImportRequest {
2209
+ /**
2210
+ * The caller has seen `validation.issues` and accepts them. Required when `validation.warnings` is greater than 0; ignored otherwise.
2211
+ */
2212
+ ack_warnings?: boolean;
2213
+ }
2181
2214
  /**
2182
2215
  * A single monitoring span produced by an external system. `correlation_id`, `level`, `use_case_slug`, `occurred_at` and `message` are all required and `level` must be one of success|error|warning|info — but these are validated PER SPAN at ingest and reported in the per-item `results[]`, so one malformed span never fails the whole batch (the fields are intentionally not marked `required`/`enum` at the schema level to preserve that partial-acceptance behavior). The client does NOT send a `code` (server-assigned from `level`), a `source` (origin is the EXTERNAL_* code prefix), or span/event ids (the external system owns its own identity and dedup).
2183
2216
  *
@@ -6926,11 +6959,13 @@ declare namespace Paths {
6926
6959
  export interface PathParameters {
6927
6960
  importId: Parameters.ImportId;
6928
6961
  }
6962
+ export type RequestBody = /* Confirmation options. Required only when the verdict carries warnings — a clean import needs no body at all. */ Components.Schemas.ExecuteErpImportRequest;
6929
6963
  namespace Responses {
6930
6964
  export type $200 = Components.Schemas.ErpImportJob;
6931
6965
  export type $403 = Components.Responses.Forbidden;
6932
6966
  export type $404 = Components.Responses.NotFound;
6933
6967
  export type $409 = Components.Responses.Conflict;
6968
+ export type $422 = Components.Schemas.ErrorResponseBase;
6934
6969
  export type $500 = Components.Responses.InternalServerError;
6935
6970
  }
6936
6971
  }
@@ -8538,7 +8573,7 @@ interface OperationMethods {
8538
8573
  */
8539
8574
  'executeErpImport'(
8540
8575
  parameters?: Parameters<Paths.ExecuteErpImport.PathParameters> | null,
8541
- data?: any,
8576
+ data?: Paths.ExecuteErpImport.RequestBody,
8542
8577
  config?: AxiosRequestConfig
8543
8578
  ): OperationResponse<Paths.ExecuteErpImport.Responses.$200>
8544
8579
  /**
@@ -9420,7 +9455,7 @@ interface PathsDictionary {
9420
9455
  */
9421
9456
  'post'(
9422
9457
  parameters?: Parameters<Paths.ExecuteErpImport.PathParameters> | null,
9423
- data?: any,
9458
+ data?: Paths.ExecuteErpImport.RequestBody,
9424
9459
  config?: AxiosRequestConfig
9425
9460
  ): OperationResponse<Paths.ExecuteErpImport.Responses.$200>
9426
9461
  }
@@ -9477,6 +9512,7 @@ type EnvironmentFieldConfig = Components.Schemas.EnvironmentFieldConfig;
9477
9512
  type ErpEvent = Components.Schemas.ErpEvent;
9478
9513
  type ErpEventV3 = Components.Schemas.ErpEventV3;
9479
9514
  type ErpImportError = Components.Schemas.ErpImportError;
9515
+ type ErpImportIssue = Components.Schemas.ErpImportIssue;
9480
9516
  type ErpImportJob = Components.Schemas.ErpImportJob;
9481
9517
  type ErpImportList = Components.Schemas.ErpImportList;
9482
9518
  type ErpImportProgress = Components.Schemas.ErpImportProgress;
@@ -9484,6 +9520,7 @@ type ErpImportValidation = Components.Schemas.ErpImportValidation;
9484
9520
  type ErpUpdatesEventsV2Request = Components.Schemas.ErpUpdatesEventsV2Request;
9485
9521
  type ErpUpdatesEventsV3Request = Components.Schemas.ErpUpdatesEventsV3Request;
9486
9522
  type ErrorResponseBase = Components.Schemas.ErrorResponseBase;
9523
+ type ExecuteErpImportRequest = Components.Schemas.ExecuteErpImportRequest;
9487
9524
  type ExternalMonitoringSpan = Components.Schemas.ExternalMonitoringSpan;
9488
9525
  type FileProxyAuth = Components.Schemas.FileProxyAuth;
9489
9526
  type FileProxyParam = Components.Schemas.FileProxyParam;
@@ -9626,4 +9663,4 @@ type UseCaseTypePreview = Components.Schemas.UseCaseTypePreview;
9626
9663
  type WebhookDeliveryConfig = Components.Schemas.WebhookDeliveryConfig;
9627
9664
  type WebhookStatus = Components.Schemas.WebhookStatus;
9628
9665
 
9629
- export { type FileProxyUrlParam as $, type AccessLogEntry as A, type EntityPruneScopeUpdate as B, type Client as C, type DeleteIntegrationAppMappingRequest as D, type EmbeddedFileProxyUseCaseRequest as E, type EntityUpdate as F, type EnvVarRefConfig as G, type EnvironmentFieldConfig as H, type ErpEvent as I, type ErpEventV3 as J, type ErpImportError as K, type ErpImportJob as L, type ErpImportList as M, type ErpImportProgress as N, type OperationMethods as O, Paths as P, type ErpImportValidation as Q, type ErpUpdatesEventsV2Request as R, type ErpUpdatesEventsV3Request as S, type ErrorResponseBase as T, type ExternalMonitoringSpan as U, type FileProxyAuth as V, type FileProxyParam as W, type FileProxyResponseConfig as X, type FileProxySecureProxyAttachment as Y, type FileProxyStep as Z, type FileProxyUrlConfig as _, Components as a, type OutboundMessage as a$, type FileProxyUrlParams as a0, type FileProxyUseCase as a1, type FileProxyUseCaseConfiguration as a2, type FileProxyUseCaseHistoryEntry as a3, type GenerateTypesPreviewResponse as a4, type GenerateTypesRequest as a5, type GenerateTypesResponse as a6, type GetMonitoringStatsRequest as a7, type GetMonitoringStatsV2Request as a8, type GetMonitoringTimeSeriesRequest as a9, type ManagedCallUseCase as aA, type ManagedCallUseCaseHistoryEntry as aB, type MappingSimulationRequest as aC, type MappingSimulationResponse as aD, type MappingSimulationV2Request as aE, type MappingSimulationWarning as aF, type MeterReadingPruneScopeConfig as aG, type MeterReadingPruneScopeUpdate as aH, type MeterReadingUpdate as aI, type MeterUniqueIdsConfig as aJ, type MonitoringEventV2 as aK, type MonitoringStats as aL, type MonitoringStatsV2 as aM, type MonitoringTraceResponse as aN, type NotificationChannelSet as aO, type NotificationDigestConfig as aP, type NotificationHistoryItem as aQ, type NotificationHistoryResponse as aR, type NotificationRecipient as aS, type NotificationRule as aT, type NotificationRuleStatus as aU, type NotificationStatusResponse as aV, type OutboundConflict as aW, type OutboundDlqListResponse as aX, type OutboundDlqMessage as aY, type OutboundIntegrationEventConfiguration as aZ, type OutboundMapping as a_, type GetMonitoringTimeSeriesV2Request as aa, type InboundIntegrationEventConfiguration as ab, type InboundMonitoringEvent as ac, type InboundUseCase as ad, type InboundUseCaseHistoryEntry as ae, type IngestExternalMonitoringEventsRequest as af, type IngestExternalMonitoringEventsResponse as ag, type Integration as ah, type IntegrationAppMapping as ai, type IntegrationConfigurationV1 as aj, type IntegrationConfigurationV2 as ak, type IntegrationEditableFields as al, type IntegrationEntity as am, type IntegrationEntityField as an, type IntegrationFieldV1 as ao, type IntegrationMeterReading as ap, type IntegrationNotificationConfig as aq, type IntegrationObjectV1 as ar, type IntegrationSettings as as, type IntegrationWithUseCases as at, type ManagedCallAuth as au, type ManagedCallErrorResponse as av, type ManagedCallExecuteRequest as aw, type ManagedCallExecuteResponse as ax, type ManagedCallOperation as ay, type ManagedCallOperationConfig as az, type PathsDictionary as b, type UseCaseBase as b$, type OutboundMonitoringEvent as b0, type OutboundPollStatus as b1, type OutboundStatusResponse as b2, type OutboundUseCase as b3, type OutboundUseCaseHistoryEntry as b4, type OutboundUseCaseStatus as b5, type PollDeliveryConfig as b6, type PollOutboundMessagesRequest as b7, type PollOutboundMessagesResponse as b8, type PortalOrigin as b9, type SecureProxyUseCase as bA, type SecureProxyUseCaseConfiguration as bB, type SecureProxyUseCaseHistoryEntry as bC, type SecureProxyWhitelist as bD, type SecureProxyWhitelistUpdate as bE, type SetIntegrationAppMappingRequest as bF, type TestNotificationRequest as bG, type TestNotificationResponse as bH, type TimeSeriesBreakdownItemV2 as bI, type TimeSeriesBucket as bJ, type TimeSeriesBucketV2 as bK, type TriggerErpActionRequest as bL, type TriggerWebhookResp as bM, type TypeAnnotations as bN, type TypeDescriptor as bO, type UnblockOutboundStreamRequest as bP, type UnblockOutboundStreamResponse as bQ, type UpdateFileProxyUseCaseRequest as bR, type UpdateInboundUseCaseRequest as bS, type UpdateIntegrationRequest as bT, type UpdateManagedCallUseCaseRequest as bU, type UpdateOutboundUseCaseRequest as bV, type UpdateSecureProxyUseCaseRequest as bW, type UpdateUseCaseRequest as bX, type UpdateUseCaseRequestBase as bY, type UpsertIntegrationWithUseCasesRequest as bZ, type UseCase as b_, type PortalRefConfig as ba, type PortalRefFilter as bb, type PruneScopeConfig as bc, type QueryAccessLogsRequest as bd, type QueryEventsRequest as be, type QueryInboundMonitoringEventsRequest as bf, type QueryMonitoringEventsV2Request as bg, type QueryOutboundMonitoringEventsRequest as bh, type RedriveOutboundDlqRequest as bi, type RedriveOutboundDlqResponse as bj, type RedriveOutboundDlqResult as bk, type RelationConfig as bl, type RelationItemConfig as bm, type RelationRefItemConfig as bn, type RelationRefValueConfig as bo, type RelationRefsConfig as bp, type RelationUniqueIdField as bq, type RepeatableFieldType as br, type ReplayEventsRequest as bs, type RuleBaselineBucket as bt, type RuleBaselineStatus as bu, type S3Reference as bv, type SecureProxyRequest as bw, type SecureProxyResponse as bx, type SecureProxySummary as by, type SecureProxyUpstreamError as bz, type AckOutboundMessagesRequest as c, type UseCaseHistoryEntry as c0, type UseCaseHistoryEntryBase as c1, type UseCaseTypePreview as c2, type WebhookDeliveryConfig as c3, type WebhookStatus as c4, 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 EmbeddedInboundUseCaseRequest as u, type EmbeddedManagedCallUseCaseRequest as v, type EmbeddedOutboundUseCaseRequest as w, type EmbeddedSecureProxyUseCaseRequest as x, type EmbeddedUseCaseRequest as y, type EmbeddedUseCaseRequestBase as z };
9666
+ export { type FileProxyStep as $, type AccessLogEntry as A, type EntityPruneScopeUpdate as B, type Client as C, type DeleteIntegrationAppMappingRequest as D, type EmbeddedFileProxyUseCaseRequest as E, type EntityUpdate as F, type EnvVarRefConfig as G, type EnvironmentFieldConfig as H, type ErpEvent as I, type ErpEventV3 as J, type ErpImportError as K, type ErpImportIssue as L, type ErpImportJob as M, type ErpImportList as N, type OperationMethods as O, Paths as P, type ErpImportProgress as Q, type ErpImportValidation as R, type ErpUpdatesEventsV2Request as S, type ErpUpdatesEventsV3Request as T, type ErrorResponseBase as U, type ExecuteErpImportRequest as V, type ExternalMonitoringSpan as W, type FileProxyAuth as X, type FileProxyParam as Y, type FileProxyResponseConfig as Z, type FileProxySecureProxyAttachment as _, Components as a, type OutboundIntegrationEventConfiguration as a$, type FileProxyUrlConfig as a0, type FileProxyUrlParam as a1, type FileProxyUrlParams as a2, type FileProxyUseCase as a3, type FileProxyUseCaseConfiguration as a4, type FileProxyUseCaseHistoryEntry as a5, type GenerateTypesPreviewResponse as a6, type GenerateTypesRequest as a7, type GenerateTypesResponse as a8, type GetMonitoringStatsRequest as a9, type ManagedCallOperation as aA, type ManagedCallOperationConfig as aB, type ManagedCallUseCase as aC, type ManagedCallUseCaseHistoryEntry as aD, type MappingSimulationRequest as aE, type MappingSimulationResponse as aF, type MappingSimulationV2Request as aG, type MappingSimulationWarning as aH, type MeterReadingPruneScopeConfig as aI, type MeterReadingPruneScopeUpdate as aJ, type MeterReadingUpdate as aK, type MeterUniqueIdsConfig as aL, type MonitoringEventV2 as aM, type MonitoringStats as aN, type MonitoringStatsV2 as aO, type MonitoringTraceResponse as aP, type NotificationChannelSet as aQ, type NotificationDigestConfig as aR, type NotificationHistoryItem as aS, type NotificationHistoryResponse as aT, type NotificationRecipient as aU, type NotificationRule as aV, type NotificationRuleStatus as aW, type NotificationStatusResponse as aX, type OutboundConflict as aY, type OutboundDlqListResponse as aZ, type OutboundDlqMessage as a_, type GetMonitoringStatsV2Request as aa, type GetMonitoringTimeSeriesRequest as ab, type GetMonitoringTimeSeriesV2Request as ac, type InboundIntegrationEventConfiguration as ad, type InboundMonitoringEvent as ae, type InboundUseCase as af, type InboundUseCaseHistoryEntry as ag, type IngestExternalMonitoringEventsRequest as ah, type IngestExternalMonitoringEventsResponse as ai, type Integration as aj, type IntegrationAppMapping as ak, type IntegrationConfigurationV1 as al, type IntegrationConfigurationV2 as am, type IntegrationEditableFields as an, type IntegrationEntity as ao, type IntegrationEntityField as ap, type IntegrationFieldV1 as aq, type IntegrationMeterReading as ar, type IntegrationNotificationConfig as as, type IntegrationObjectV1 as at, type IntegrationSettings as au, type IntegrationWithUseCases as av, type ManagedCallAuth as aw, type ManagedCallErrorResponse as ax, type ManagedCallExecuteRequest as ay, type ManagedCallExecuteResponse as az, type PathsDictionary as b, type UpsertIntegrationWithUseCasesRequest as b$, type OutboundMapping as b0, type OutboundMessage as b1, type OutboundMonitoringEvent as b2, type OutboundPollStatus as b3, type OutboundStatusResponse as b4, type OutboundUseCase as b5, type OutboundUseCaseHistoryEntry as b6, type OutboundUseCaseStatus as b7, type PollDeliveryConfig as b8, type PollOutboundMessagesRequest as b9, type SecureProxySummary as bA, type SecureProxyUpstreamError as bB, type SecureProxyUseCase as bC, type SecureProxyUseCaseConfiguration as bD, type SecureProxyUseCaseHistoryEntry as bE, type SecureProxyWhitelist as bF, type SecureProxyWhitelistUpdate as bG, type SetIntegrationAppMappingRequest as bH, type TestNotificationRequest as bI, type TestNotificationResponse as bJ, type TimeSeriesBreakdownItemV2 as bK, type TimeSeriesBucket as bL, type TimeSeriesBucketV2 as bM, type TriggerErpActionRequest as bN, type TriggerWebhookResp as bO, type TypeAnnotations as bP, type TypeDescriptor as bQ, type UnblockOutboundStreamRequest as bR, type UnblockOutboundStreamResponse as bS, type UpdateFileProxyUseCaseRequest as bT, type UpdateInboundUseCaseRequest as bU, type UpdateIntegrationRequest as bV, type UpdateManagedCallUseCaseRequest as bW, type UpdateOutboundUseCaseRequest as bX, type UpdateSecureProxyUseCaseRequest as bY, type UpdateUseCaseRequest as bZ, type UpdateUseCaseRequestBase as b_, type PollOutboundMessagesResponse as ba, type PortalOrigin as bb, type PortalRefConfig as bc, type PortalRefFilter as bd, type PruneScopeConfig as be, type QueryAccessLogsRequest as bf, type QueryEventsRequest as bg, type QueryInboundMonitoringEventsRequest as bh, type QueryMonitoringEventsV2Request as bi, type QueryOutboundMonitoringEventsRequest as bj, type RedriveOutboundDlqRequest as bk, type RedriveOutboundDlqResponse as bl, type RedriveOutboundDlqResult as bm, type RelationConfig as bn, type RelationItemConfig as bo, type RelationRefItemConfig as bp, type RelationRefValueConfig as bq, type RelationRefsConfig as br, type RelationUniqueIdField as bs, type RepeatableFieldType as bt, type ReplayEventsRequest as bu, type RuleBaselineBucket as bv, type RuleBaselineStatus as bw, type S3Reference as bx, type SecureProxyRequest as by, type SecureProxyResponse as bz, type AckOutboundMessagesRequest as c, type UseCase as c0, type UseCaseBase as c1, type UseCaseHistoryEntry as c2, type UseCaseHistoryEntryBase as c3, type UseCaseTypePreview as c4, type WebhookDeliveryConfig as c5, type WebhookStatus as c6, 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 EmbeddedInboundUseCaseRequest as u, type EmbeddedManagedCallUseCaseRequest as v, type EmbeddedOutboundUseCaseRequest as w, type EmbeddedSecureProxyUseCaseRequest as x, type EmbeddedUseCaseRequest as y, type EmbeddedUseCaseRequestBase as z };
@@ -2031,14 +2031,34 @@ declare namespace Components {
2031
2031
  */
2032
2032
  export interface ErpImportError {
2033
2033
  /**
2034
- * VALIDATION_BLOCKED = blocking row issues (see `validation`); PROCESSING_ERROR = a named, deterministic failure — retrying the same file cannot help; INTERNAL_ERROR = crashed or never started, so retry.
2034
+ * Enum of possible error codes.
2035
+ *
2035
2036
  */
2036
- type: "VALIDATION_BLOCKED" | "PROCESSING_ERROR" | "INTERNAL_ERROR";
2037
+ code: "VALIDATION_BLOCKED" | "FILE_FORMAT_UNSUPPORTED" | "FILE_UNAVAILABLE" | "VALIDATE_TIMEOUT" | "IMPORT_TIMEOUT" | "USE_CASE_NOT_USABLE" | "IMPORT_NO_PROGRESS" | "INTERNAL_ERROR";
2037
2038
  /**
2038
2039
  * User-facing explanation of `type`.
2039
2040
  */
2040
2041
  message: string;
2041
2042
  }
2043
+ /**
2044
+ * A problem found during validation, scoped to the file as a whole rather than to individual rows. See `code` for the kinds reported.
2045
+ */
2046
+ export interface ErpImportIssue {
2047
+ /**
2048
+ * Enum of possible issue codes.
2049
+ *
2050
+ */
2051
+ code: "UNIQUE_ID_COLUMN_MISSING" | "MAPPED_COLUMN_MISSING" | "MALFORMED_ROW" | "INVALID_ENCODING" | "EMPTY_FILE" | "TOO_MANY_ROWS";
2052
+ severity: "warning" | "blocking";
2053
+ /**
2054
+ * User-facing explanation. Lists at most 10 column names; `columns` has all of them.
2055
+ */
2056
+ message: string;
2057
+ /**
2058
+ * The columns this issue is about, so clients render names rather than parsing the message.
2059
+ */
2060
+ columns?: string[];
2061
+ }
2042
2062
  export interface ErpImportJob {
2043
2063
  /**
2044
2064
  * `imp_{ULID}` — time-ordered, also used as the job's correlation_id.
@@ -2054,7 +2074,7 @@ declare namespace Components {
2054
2074
  format: "csv" | "xlsx";
2055
2075
  /**
2056
2076
  * PENDING → VALIDATING → READY → PROCESSING → IMPORTED, with FAILED reachable from any working status, and CANCELLING → CANCELLED reachable from VALIDATING or PROCESSING via :abort. IMPORTED, FAILED and CANCELLED are terminal and final.
2057
- * IMPORTED means every row was handed to the platform, not that the platform finished — per-row outcomes live in monitoring, filtered by correlation_id. A file that fails validation is FAILED with error.type = VALIDATION_BLOCKED.
2077
+ * IMPORTED means every row was handed to the platform, not that the platform finished — per-row outcomes live in monitoring, filtered by correlation_id. A file that fails validation is FAILED with error.code = VALIDATION_BLOCKED.
2058
2078
  * READY is legitimately idle for as long as the user takes to confirm, so it carries no running work and never goes stale.
2059
2079
  * CANCELLING is transient and cooperative: the abort has been recorded but the worker only notices at its next batch boundary. Rows already published stay published — a stop is not a rollback.
2060
2080
  */
@@ -2112,6 +2132,10 @@ declare namespace Components {
2112
2132
  entities: {
2113
2133
  [name: string]: number;
2114
2134
  };
2135
+ /**
2136
+ * Whole-file issues. At most 20 are kept; the count of everything found is in blocking and warnings. Warnings here are what `ack_warnings` on `:execute` acknowledges.
2137
+ */
2138
+ issues?: /* A problem found during validation, scoped to the file as a whole rather than to individual rows. See `code` for the kinds reported. */ ErpImportIssue[];
2115
2139
  }
2116
2140
  export interface ErpUpdatesEventsV2Request {
2117
2141
  /**
@@ -2178,6 +2202,15 @@ declare namespace Components {
2178
2202
  */
2179
2203
  message?: string;
2180
2204
  }
2205
+ /**
2206
+ * Confirmation options. Required only when the verdict carries warnings — a clean import needs no body at all.
2207
+ */
2208
+ export interface ExecuteErpImportRequest {
2209
+ /**
2210
+ * The caller has seen `validation.issues` and accepts them. Required when `validation.warnings` is greater than 0; ignored otherwise.
2211
+ */
2212
+ ack_warnings?: boolean;
2213
+ }
2181
2214
  /**
2182
2215
  * A single monitoring span produced by an external system. `correlation_id`, `level`, `use_case_slug`, `occurred_at` and `message` are all required and `level` must be one of success|error|warning|info — but these are validated PER SPAN at ingest and reported in the per-item `results[]`, so one malformed span never fails the whole batch (the fields are intentionally not marked `required`/`enum` at the schema level to preserve that partial-acceptance behavior). The client does NOT send a `code` (server-assigned from `level`), a `source` (origin is the EXTERNAL_* code prefix), or span/event ids (the external system owns its own identity and dedup).
2183
2216
  *
@@ -6926,11 +6959,13 @@ declare namespace Paths {
6926
6959
  export interface PathParameters {
6927
6960
  importId: Parameters.ImportId;
6928
6961
  }
6962
+ export type RequestBody = /* Confirmation options. Required only when the verdict carries warnings — a clean import needs no body at all. */ Components.Schemas.ExecuteErpImportRequest;
6929
6963
  namespace Responses {
6930
6964
  export type $200 = Components.Schemas.ErpImportJob;
6931
6965
  export type $403 = Components.Responses.Forbidden;
6932
6966
  export type $404 = Components.Responses.NotFound;
6933
6967
  export type $409 = Components.Responses.Conflict;
6968
+ export type $422 = Components.Schemas.ErrorResponseBase;
6934
6969
  export type $500 = Components.Responses.InternalServerError;
6935
6970
  }
6936
6971
  }
@@ -8538,7 +8573,7 @@ interface OperationMethods {
8538
8573
  */
8539
8574
  'executeErpImport'(
8540
8575
  parameters?: Parameters<Paths.ExecuteErpImport.PathParameters> | null,
8541
- data?: any,
8576
+ data?: Paths.ExecuteErpImport.RequestBody,
8542
8577
  config?: AxiosRequestConfig
8543
8578
  ): OperationResponse<Paths.ExecuteErpImport.Responses.$200>
8544
8579
  /**
@@ -9420,7 +9455,7 @@ interface PathsDictionary {
9420
9455
  */
9421
9456
  'post'(
9422
9457
  parameters?: Parameters<Paths.ExecuteErpImport.PathParameters> | null,
9423
- data?: any,
9458
+ data?: Paths.ExecuteErpImport.RequestBody,
9424
9459
  config?: AxiosRequestConfig
9425
9460
  ): OperationResponse<Paths.ExecuteErpImport.Responses.$200>
9426
9461
  }
@@ -9477,6 +9512,7 @@ type EnvironmentFieldConfig = Components.Schemas.EnvironmentFieldConfig;
9477
9512
  type ErpEvent = Components.Schemas.ErpEvent;
9478
9513
  type ErpEventV3 = Components.Schemas.ErpEventV3;
9479
9514
  type ErpImportError = Components.Schemas.ErpImportError;
9515
+ type ErpImportIssue = Components.Schemas.ErpImportIssue;
9480
9516
  type ErpImportJob = Components.Schemas.ErpImportJob;
9481
9517
  type ErpImportList = Components.Schemas.ErpImportList;
9482
9518
  type ErpImportProgress = Components.Schemas.ErpImportProgress;
@@ -9484,6 +9520,7 @@ type ErpImportValidation = Components.Schemas.ErpImportValidation;
9484
9520
  type ErpUpdatesEventsV2Request = Components.Schemas.ErpUpdatesEventsV2Request;
9485
9521
  type ErpUpdatesEventsV3Request = Components.Schemas.ErpUpdatesEventsV3Request;
9486
9522
  type ErrorResponseBase = Components.Schemas.ErrorResponseBase;
9523
+ type ExecuteErpImportRequest = Components.Schemas.ExecuteErpImportRequest;
9487
9524
  type ExternalMonitoringSpan = Components.Schemas.ExternalMonitoringSpan;
9488
9525
  type FileProxyAuth = Components.Schemas.FileProxyAuth;
9489
9526
  type FileProxyParam = Components.Schemas.FileProxyParam;
@@ -9626,4 +9663,4 @@ type UseCaseTypePreview = Components.Schemas.UseCaseTypePreview;
9626
9663
  type WebhookDeliveryConfig = Components.Schemas.WebhookDeliveryConfig;
9627
9664
  type WebhookStatus = Components.Schemas.WebhookStatus;
9628
9665
 
9629
- export { type FileProxyUrlParam as $, type AccessLogEntry as A, type EntityPruneScopeUpdate as B, type Client as C, type DeleteIntegrationAppMappingRequest as D, type EmbeddedFileProxyUseCaseRequest as E, type EntityUpdate as F, type EnvVarRefConfig as G, type EnvironmentFieldConfig as H, type ErpEvent as I, type ErpEventV3 as J, type ErpImportError as K, type ErpImportJob as L, type ErpImportList as M, type ErpImportProgress as N, type OperationMethods as O, Paths as P, type ErpImportValidation as Q, type ErpUpdatesEventsV2Request as R, type ErpUpdatesEventsV3Request as S, type ErrorResponseBase as T, type ExternalMonitoringSpan as U, type FileProxyAuth as V, type FileProxyParam as W, type FileProxyResponseConfig as X, type FileProxySecureProxyAttachment as Y, type FileProxyStep as Z, type FileProxyUrlConfig as _, Components as a, type OutboundMessage as a$, type FileProxyUrlParams as a0, type FileProxyUseCase as a1, type FileProxyUseCaseConfiguration as a2, type FileProxyUseCaseHistoryEntry as a3, type GenerateTypesPreviewResponse as a4, type GenerateTypesRequest as a5, type GenerateTypesResponse as a6, type GetMonitoringStatsRequest as a7, type GetMonitoringStatsV2Request as a8, type GetMonitoringTimeSeriesRequest as a9, type ManagedCallUseCase as aA, type ManagedCallUseCaseHistoryEntry as aB, type MappingSimulationRequest as aC, type MappingSimulationResponse as aD, type MappingSimulationV2Request as aE, type MappingSimulationWarning as aF, type MeterReadingPruneScopeConfig as aG, type MeterReadingPruneScopeUpdate as aH, type MeterReadingUpdate as aI, type MeterUniqueIdsConfig as aJ, type MonitoringEventV2 as aK, type MonitoringStats as aL, type MonitoringStatsV2 as aM, type MonitoringTraceResponse as aN, type NotificationChannelSet as aO, type NotificationDigestConfig as aP, type NotificationHistoryItem as aQ, type NotificationHistoryResponse as aR, type NotificationRecipient as aS, type NotificationRule as aT, type NotificationRuleStatus as aU, type NotificationStatusResponse as aV, type OutboundConflict as aW, type OutboundDlqListResponse as aX, type OutboundDlqMessage as aY, type OutboundIntegrationEventConfiguration as aZ, type OutboundMapping as a_, type GetMonitoringTimeSeriesV2Request as aa, type InboundIntegrationEventConfiguration as ab, type InboundMonitoringEvent as ac, type InboundUseCase as ad, type InboundUseCaseHistoryEntry as ae, type IngestExternalMonitoringEventsRequest as af, type IngestExternalMonitoringEventsResponse as ag, type Integration as ah, type IntegrationAppMapping as ai, type IntegrationConfigurationV1 as aj, type IntegrationConfigurationV2 as ak, type IntegrationEditableFields as al, type IntegrationEntity as am, type IntegrationEntityField as an, type IntegrationFieldV1 as ao, type IntegrationMeterReading as ap, type IntegrationNotificationConfig as aq, type IntegrationObjectV1 as ar, type IntegrationSettings as as, type IntegrationWithUseCases as at, type ManagedCallAuth as au, type ManagedCallErrorResponse as av, type ManagedCallExecuteRequest as aw, type ManagedCallExecuteResponse as ax, type ManagedCallOperation as ay, type ManagedCallOperationConfig as az, type PathsDictionary as b, type UseCaseBase as b$, type OutboundMonitoringEvent as b0, type OutboundPollStatus as b1, type OutboundStatusResponse as b2, type OutboundUseCase as b3, type OutboundUseCaseHistoryEntry as b4, type OutboundUseCaseStatus as b5, type PollDeliveryConfig as b6, type PollOutboundMessagesRequest as b7, type PollOutboundMessagesResponse as b8, type PortalOrigin as b9, type SecureProxyUseCase as bA, type SecureProxyUseCaseConfiguration as bB, type SecureProxyUseCaseHistoryEntry as bC, type SecureProxyWhitelist as bD, type SecureProxyWhitelistUpdate as bE, type SetIntegrationAppMappingRequest as bF, type TestNotificationRequest as bG, type TestNotificationResponse as bH, type TimeSeriesBreakdownItemV2 as bI, type TimeSeriesBucket as bJ, type TimeSeriesBucketV2 as bK, type TriggerErpActionRequest as bL, type TriggerWebhookResp as bM, type TypeAnnotations as bN, type TypeDescriptor as bO, type UnblockOutboundStreamRequest as bP, type UnblockOutboundStreamResponse as bQ, type UpdateFileProxyUseCaseRequest as bR, type UpdateInboundUseCaseRequest as bS, type UpdateIntegrationRequest as bT, type UpdateManagedCallUseCaseRequest as bU, type UpdateOutboundUseCaseRequest as bV, type UpdateSecureProxyUseCaseRequest as bW, type UpdateUseCaseRequest as bX, type UpdateUseCaseRequestBase as bY, type UpsertIntegrationWithUseCasesRequest as bZ, type UseCase as b_, type PortalRefConfig as ba, type PortalRefFilter as bb, type PruneScopeConfig as bc, type QueryAccessLogsRequest as bd, type QueryEventsRequest as be, type QueryInboundMonitoringEventsRequest as bf, type QueryMonitoringEventsV2Request as bg, type QueryOutboundMonitoringEventsRequest as bh, type RedriveOutboundDlqRequest as bi, type RedriveOutboundDlqResponse as bj, type RedriveOutboundDlqResult as bk, type RelationConfig as bl, type RelationItemConfig as bm, type RelationRefItemConfig as bn, type RelationRefValueConfig as bo, type RelationRefsConfig as bp, type RelationUniqueIdField as bq, type RepeatableFieldType as br, type ReplayEventsRequest as bs, type RuleBaselineBucket as bt, type RuleBaselineStatus as bu, type S3Reference as bv, type SecureProxyRequest as bw, type SecureProxyResponse as bx, type SecureProxySummary as by, type SecureProxyUpstreamError as bz, type AckOutboundMessagesRequest as c, type UseCaseHistoryEntry as c0, type UseCaseHistoryEntryBase as c1, type UseCaseTypePreview as c2, type WebhookDeliveryConfig as c3, type WebhookStatus as c4, 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 EmbeddedInboundUseCaseRequest as u, type EmbeddedManagedCallUseCaseRequest as v, type EmbeddedOutboundUseCaseRequest as w, type EmbeddedSecureProxyUseCaseRequest as x, type EmbeddedUseCaseRequest as y, type EmbeddedUseCaseRequestBase as z };
9666
+ export { type FileProxyStep as $, type AccessLogEntry as A, type EntityPruneScopeUpdate as B, type Client as C, type DeleteIntegrationAppMappingRequest as D, type EmbeddedFileProxyUseCaseRequest as E, type EntityUpdate as F, type EnvVarRefConfig as G, type EnvironmentFieldConfig as H, type ErpEvent as I, type ErpEventV3 as J, type ErpImportError as K, type ErpImportIssue as L, type ErpImportJob as M, type ErpImportList as N, type OperationMethods as O, Paths as P, type ErpImportProgress as Q, type ErpImportValidation as R, type ErpUpdatesEventsV2Request as S, type ErpUpdatesEventsV3Request as T, type ErrorResponseBase as U, type ExecuteErpImportRequest as V, type ExternalMonitoringSpan as W, type FileProxyAuth as X, type FileProxyParam as Y, type FileProxyResponseConfig as Z, type FileProxySecureProxyAttachment as _, Components as a, type OutboundIntegrationEventConfiguration as a$, type FileProxyUrlConfig as a0, type FileProxyUrlParam as a1, type FileProxyUrlParams as a2, type FileProxyUseCase as a3, type FileProxyUseCaseConfiguration as a4, type FileProxyUseCaseHistoryEntry as a5, type GenerateTypesPreviewResponse as a6, type GenerateTypesRequest as a7, type GenerateTypesResponse as a8, type GetMonitoringStatsRequest as a9, type ManagedCallOperation as aA, type ManagedCallOperationConfig as aB, type ManagedCallUseCase as aC, type ManagedCallUseCaseHistoryEntry as aD, type MappingSimulationRequest as aE, type MappingSimulationResponse as aF, type MappingSimulationV2Request as aG, type MappingSimulationWarning as aH, type MeterReadingPruneScopeConfig as aI, type MeterReadingPruneScopeUpdate as aJ, type MeterReadingUpdate as aK, type MeterUniqueIdsConfig as aL, type MonitoringEventV2 as aM, type MonitoringStats as aN, type MonitoringStatsV2 as aO, type MonitoringTraceResponse as aP, type NotificationChannelSet as aQ, type NotificationDigestConfig as aR, type NotificationHistoryItem as aS, type NotificationHistoryResponse as aT, type NotificationRecipient as aU, type NotificationRule as aV, type NotificationRuleStatus as aW, type NotificationStatusResponse as aX, type OutboundConflict as aY, type OutboundDlqListResponse as aZ, type OutboundDlqMessage as a_, type GetMonitoringStatsV2Request as aa, type GetMonitoringTimeSeriesRequest as ab, type GetMonitoringTimeSeriesV2Request as ac, type InboundIntegrationEventConfiguration as ad, type InboundMonitoringEvent as ae, type InboundUseCase as af, type InboundUseCaseHistoryEntry as ag, type IngestExternalMonitoringEventsRequest as ah, type IngestExternalMonitoringEventsResponse as ai, type Integration as aj, type IntegrationAppMapping as ak, type IntegrationConfigurationV1 as al, type IntegrationConfigurationV2 as am, type IntegrationEditableFields as an, type IntegrationEntity as ao, type IntegrationEntityField as ap, type IntegrationFieldV1 as aq, type IntegrationMeterReading as ar, type IntegrationNotificationConfig as as, type IntegrationObjectV1 as at, type IntegrationSettings as au, type IntegrationWithUseCases as av, type ManagedCallAuth as aw, type ManagedCallErrorResponse as ax, type ManagedCallExecuteRequest as ay, type ManagedCallExecuteResponse as az, type PathsDictionary as b, type UpsertIntegrationWithUseCasesRequest as b$, type OutboundMapping as b0, type OutboundMessage as b1, type OutboundMonitoringEvent as b2, type OutboundPollStatus as b3, type OutboundStatusResponse as b4, type OutboundUseCase as b5, type OutboundUseCaseHistoryEntry as b6, type OutboundUseCaseStatus as b7, type PollDeliveryConfig as b8, type PollOutboundMessagesRequest as b9, type SecureProxySummary as bA, type SecureProxyUpstreamError as bB, type SecureProxyUseCase as bC, type SecureProxyUseCaseConfiguration as bD, type SecureProxyUseCaseHistoryEntry as bE, type SecureProxyWhitelist as bF, type SecureProxyWhitelistUpdate as bG, type SetIntegrationAppMappingRequest as bH, type TestNotificationRequest as bI, type TestNotificationResponse as bJ, type TimeSeriesBreakdownItemV2 as bK, type TimeSeriesBucket as bL, type TimeSeriesBucketV2 as bM, type TriggerErpActionRequest as bN, type TriggerWebhookResp as bO, type TypeAnnotations as bP, type TypeDescriptor as bQ, type UnblockOutboundStreamRequest as bR, type UnblockOutboundStreamResponse as bS, type UpdateFileProxyUseCaseRequest as bT, type UpdateInboundUseCaseRequest as bU, type UpdateIntegrationRequest as bV, type UpdateManagedCallUseCaseRequest as bW, type UpdateOutboundUseCaseRequest as bX, type UpdateSecureProxyUseCaseRequest as bY, type UpdateUseCaseRequest as bZ, type UpdateUseCaseRequestBase as b_, type PollOutboundMessagesResponse as ba, type PortalOrigin as bb, type PortalRefConfig as bc, type PortalRefFilter as bd, type PruneScopeConfig as be, type QueryAccessLogsRequest as bf, type QueryEventsRequest as bg, type QueryInboundMonitoringEventsRequest as bh, type QueryMonitoringEventsV2Request as bi, type QueryOutboundMonitoringEventsRequest as bj, type RedriveOutboundDlqRequest as bk, type RedriveOutboundDlqResponse as bl, type RedriveOutboundDlqResult as bm, type RelationConfig as bn, type RelationItemConfig as bo, type RelationRefItemConfig as bp, type RelationRefValueConfig as bq, type RelationRefsConfig as br, type RelationUniqueIdField as bs, type RepeatableFieldType as bt, type ReplayEventsRequest as bu, type RuleBaselineBucket as bv, type RuleBaselineStatus as bw, type S3Reference as bx, type SecureProxyRequest as by, type SecureProxyResponse as bz, type AckOutboundMessagesRequest as c, type UseCase as c0, type UseCaseBase as c1, type UseCaseHistoryEntry as c2, type UseCaseHistoryEntryBase as c3, type UseCaseTypePreview as c4, type WebhookDeliveryConfig as c5, type WebhookStatus as c6, 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 EmbeddedInboundUseCaseRequest as u, type EmbeddedManagedCallUseCaseRequest as v, type EmbeddedOutboundUseCaseRequest as w, type EmbeddedSecureProxyUseCaseRequest as x, type EmbeddedUseCaseRequest as y, type EmbeddedUseCaseRequestBase as z };
@@ -98,6 +98,8 @@ const { data } = await integrationToolkitClient.acknowledgeTracking(...)
98
98
  **Schemas**
99
99
  - [`S3Reference`](#s3reference)
100
100
  - [`CreateErpImportRequest`](#createerpimportrequest)
101
+ - [`ExecuteErpImportRequest`](#executeerpimportrequest)
102
+ - [`ErpImportIssue`](#erpimportissue)
101
103
  - [`ErpImportValidation`](#erpimportvalidation)
102
104
  - [`ErpImportProgress`](#erpimportprogress)
103
105
  - [`ErpImportError`](#erpimporterror)
@@ -3245,14 +3247,22 @@ const { data } = await client.listErpImports({
3245
3247
  "total_rows": 0,
3246
3248
  "blocking": 0,
3247
3249
  "warnings": 0,
3248
- "entities": {}
3250
+ "entities": {},
3251
+ "issues": [
3252
+ {
3253
+ "code": "UNIQUE_ID_COLUMN_MISSING",
3254
+ "severity": "warning",
3255
+ "message": "string",
3256
+ "columns": ["string"]
3257
+ }
3258
+ ]
3249
3259
  },
3250
3260
  "progress": {
3251
3261
  "processed_rows": 0,
3252
3262
  "total_rows": 0
3253
3263
  },
3254
3264
  "error": {
3255
- "type": "VALIDATION_BLOCKED",
3265
+ "code": "VALIDATION_BLOCKED",
3256
3266
  "message": "string"
3257
3267
  },
3258
3268
  "correlation_id": "string",
@@ -3301,14 +3311,22 @@ const { data } = await client.getErpImport({
3301
3311
  "total_rows": 0,
3302
3312
  "blocking": 0,
3303
3313
  "warnings": 0,
3304
- "entities": {}
3314
+ "entities": {},
3315
+ "issues": [
3316
+ {
3317
+ "code": "UNIQUE_ID_COLUMN_MISSING",
3318
+ "severity": "warning",
3319
+ "message": "string",
3320
+ "columns": ["string"]
3321
+ }
3322
+ ]
3305
3323
  },
3306
3324
  "progress": {
3307
3325
  "processed_rows": 0,
3308
3326
  "total_rows": 0
3309
3327
  },
3310
3328
  "error": {
3311
- "type": "VALIDATION_BLOCKED",
3329
+ "code": "VALIDATION_BLOCKED",
3312
3330
  "message": "string"
3313
3331
  },
3314
3332
  "correlation_id": "string",
@@ -3329,9 +3347,14 @@ Confirm and run the write phase of a validated import. Only a READY job may be e
3329
3347
  `POST /v2/erp/imports/{importId}:execute`
3330
3348
 
3331
3349
  ```ts
3332
- const { data } = await client.executeErpImport({
3333
- importId: 'example',
3334
- })
3350
+ const { data } = await client.executeErpImport(
3351
+ {
3352
+ importId: 'example',
3353
+ },
3354
+ {
3355
+ ack_warnings: true
3356
+ },
3357
+ )
3335
3358
  ```
3336
3359
 
3337
3360
  <details>
@@ -3354,14 +3377,22 @@ const { data } = await client.executeErpImport({
3354
3377
  "total_rows": 0,
3355
3378
  "blocking": 0,
3356
3379
  "warnings": 0,
3357
- "entities": {}
3380
+ "entities": {},
3381
+ "issues": [
3382
+ {
3383
+ "code": "UNIQUE_ID_COLUMN_MISSING",
3384
+ "severity": "warning",
3385
+ "message": "string",
3386
+ "columns": ["string"]
3387
+ }
3388
+ ]
3358
3389
  },
3359
3390
  "progress": {
3360
3391
  "processed_rows": 0,
3361
3392
  "total_rows": 0
3362
3393
  },
3363
3394
  "error": {
3364
- "type": "VALIDATION_BLOCKED",
3395
+ "code": "VALIDATION_BLOCKED",
3365
3396
  "message": "string"
3366
3397
  },
3367
3398
  "correlation_id": "string",
@@ -3414,6 +3445,29 @@ type CreateErpImportRequest = {
3414
3445
  }
3415
3446
  ```
3416
3447
 
3448
+ ### `ExecuteErpImportRequest`
3449
+
3450
+ Confirmation options. Required only when the verdict carries warnings — a clean import needs no body at all.
3451
+
3452
+ ```ts
3453
+ type ExecuteErpImportRequest = {
3454
+ ack_warnings?: boolean
3455
+ }
3456
+ ```
3457
+
3458
+ ### `ErpImportIssue`
3459
+
3460
+ A problem found during validation, scoped to the file as a whole rather than to individual rows. See `code` for the kinds reported.
3461
+
3462
+ ```ts
3463
+ type ErpImportIssue = {
3464
+ code: "UNIQUE_ID_COLUMN_MISSING" | "MAPPED_COLUMN_MISSING" | "MALFORMED_ROW" | "INVALID_ENCODING" | "EMPTY_FILE" | "TOO_MANY_ROWS"
3465
+ severity: "warning" | "blocking"
3466
+ message: string
3467
+ columns?: string[]
3468
+ }
3469
+ ```
3470
+
3417
3471
  ### `ErpImportValidation`
3418
3472
 
3419
3473
  Validate-phase summary: what the file will create, and whether it may be confirmed. Absent until the validate phase completes. No per-row detail is kept — a rejected file is corrected and imported again.
@@ -3424,6 +3478,12 @@ type ErpImportValidation = {
3424
3478
  blocking: number
3425
3479
  warnings: number
3426
3480
  entities: Record<string, number>
3481
+ issues?: Array<{
3482
+ code: "UNIQUE_ID_COLUMN_MISSING" | "MAPPED_COLUMN_MISSING" | "MALFORMED_ROW" | "INVALID_ENCODING" | "EMPTY_FILE" | "TOO_MANY_ROWS"
3483
+ severity: "warning" | "blocking"
3484
+ message: string
3485
+ columns?: string[]
3486
+ }>
3427
3487
  }
3428
3488
  ```
3429
3489
 
@@ -3445,7 +3505,7 @@ Why the import failed — present if and only if status = FAILED.
3445
3505
 
3446
3506
  ```ts
3447
3507
  type ErpImportError = {
3448
- type: "VALIDATION_BLOCKED" | "PROCESSING_ERROR" | "INTERNAL_ERROR"
3508
+ code: "VALIDATION_BLOCKED" | "FILE_FORMAT_UNSUPPORTED" | "FILE_UNAVAILABLE" | "VALIDATE_TIMEOUT" | "IMPORT_TIMEOUT" | "USE_CASE_NOT_USABLE" | "IMPORT_NO_PROGRESS" | "INTERNAL_ERROR"
3449
3509
  message: string
3450
3510
  }
3451
3511
  ```
@@ -3478,13 +3538,19 @@ type ErpImportJob = {
3478
3538
  blocking: number
3479
3539
  warnings: number
3480
3540
  entities: Record<string, number>
3541
+ issues?: Array<{
3542
+ code: { ... }
3543
+ severity: { ... }
3544
+ message: { ... }
3545
+ columns?: { ... }
3546
+ }>
3481
3547
  }
3482
3548
  progress?: {
3483
3549
  processed_rows: number
3484
3550
  total_rows?: number
3485
3551
  }
3486
3552
  error?: {
3487
- type: "VALIDATION_BLOCKED" | "PROCESSING_ERROR" | "INTERNAL_ERROR"
3553
+ code: "VALIDATION_BLOCKED" | "FILE_FORMAT_UNSUPPORTED" | "FILE_UNAVAILABLE" | "VALIDATE_TIMEOUT" | "IMPORT_TIMEOUT" | "USE_CASE_NOT_USABLE" | "IMPORT_NO_PROGRESS" | "INTERNAL_ERROR"
3488
3554
  message: string
3489
3555
  }
3490
3556
  correlation_id?: string
@@ -3515,13 +3581,14 @@ type ErpImportList = {
3515
3581
  blocking: { ... }
3516
3582
  warnings: { ... }
3517
3583
  entities: { ... }
3584
+ issues?: { ... }
3518
3585
  }
3519
3586
  progress?: {
3520
3587
  processed_rows: { ... }
3521
3588
  total_rows?: { ... }
3522
3589
  }
3523
3590
  error?: {
3524
- type: { ... }
3591
+ code: { ... }
3525
3592
  message: { ... }
3526
3593
  }
3527
3594
  correlation_id?: string
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@epilot/sdk",
3
- "version": "2.18.2",
3
+ "version": "2.18.3",
4
4
  "description": "JavaScript/TypeScript SDK for epilot APIs",
5
5
  "type": "module",
6
6
  "main": "./dist/index.cjs",