POST /v2/erp/imports no longer accepts integration_id and use_case_slug — the import determines its use case itself (breaking)
New POST /v2/erp/imports/{importId}:validate endpoint added for validating an import before executing it, and POST /v2/erp/imports/{importId}:suggest-use-cases for suggesting matching use cases — the suggestion response reports file_columns once for the whole import rather than per suggestion, and every suggestion carries the entity_types it would create
POST /v2/erp/imports/{importId}:execute now accepts an optional request body and answers with 202 instead of 200, or with 422 when the import cannot be executed; POST /v2/erp/imports answers with 201 instead of 202 and accepts a new optional include_preview field for returning a preview of the import along with it (breaking)
Import error reporting changed: error.type was replaced by a required error.code, integration_id is no longer guaranteed, and a new optional validation.issues list reports individual validation problems — each issue names the affected columns as objects with a required name and an optional entity, may point at a specific row, and no longer always carries a message — affecting GET /v2/erp/imports, GET /v2/erp/imports/{importId}, and the validate, execute, and abort endpoints (breaking)
Use case configuration gained a set of new optional fields — direction, constants, lookups, fan_out, file_source, upload, params_mapping, required_params, ack_tracking, and event_filter — response is no longer required, request steps now also allow the PUT and PATCH methods, and a new file_proxy delivery type was added for forwarding files to an external system; use cases additionally report an optional changed_by, and GET /v1/integrations/{integrationId}/outbound-status reports an optional file_proxy status
Mapping simulation (POST /v1/erp/updates/mapping_simulation and POST /v2/erp/updates/mapping_simulation) now always reports a mode for each entity update and meter reading update, and adds optional pricing, prune_scope_updates, and meter_readings_prune_scope_updates details