@epilot/erp-integration-client 0.17.0 → 0.19.0

package/dist/definition.js

@@ -1 +1 @@
-(()=>{"use strict";var e={330:function(e,t,n){var r=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(t,"__esModule",{value:!0});var o=r(n(466));t.default=o.default},466:e=>{e.exports=JSON.parse('{"openapi":"3.0.3","info":{"title":"","version":""},"servers":[{"url":"https://erp-integration-api.sls.epilot.io"}],"paths":{"/v1/erp/tracking/acknowledgement":{"post":{"operationId":"acknowledgeTracking","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/erp/trigger":{"post":{"operationId":"triggerErp","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/erp/updates/events":{"post":{"operationId":"processErpUpdatesEvents","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v2/erp/updates/events":{"post":{"operationId":"processErpUpdatesEventsV2","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v2/erp/updates/mapping_simulation":{"post":{"operationId":"simulateMappingV2","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/erp/updates/mapping_simulation":{"post":{"operationId":"simulateMapping","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations":{"get":{"operationId":"listIntegrations","responses":{}},"post":{"operationId":"createIntegration","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}":{"get":{"operationId":"getIntegration","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}},"put":{"operationId":"updateIntegration","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteIntegration","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/events":{"post":{"operationId":"queryEvents","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/events/replay":{"post":{"operationId":"replayEvents","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/use-cases":{"get":{"operationId":"listUseCases","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}},"post":{"operationId":"createUseCase","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/use-cases/{useCaseId}":{"get":{"operationId":"getUseCase","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true}],"responses":{}},"put":{"operationId":"updateUseCase","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteUseCase","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/use-cases/{useCaseId}/history":{"get":{"operationId":"listUseCaseHistory","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true},{"name":"cursor","in":"query","required":false}],"responses":{}}},"/v2/integrations":{"get":{"operationId":"listIntegrationsV2","responses":{}},"post":{"operationId":"createIntegrationV2","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v2/integrations/{integrationId}":{"get":{"operationId":"getIntegrationV2","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}},"put":{"operationId":"updateIntegrationV2","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteIntegrationV2","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/app-mapping":{"put":{"operationId":"setIntegrationAppMapping","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteIntegrationAppMapping","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/monitoring/inbound-events":{"post":{"operationId":"queryInboundMonitoringEvents","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/monitoring/stats":{"post":{"operationId":"getMonitoringStats","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/outbound-status":{"get":{"operationId":"getOutboundStatus","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/monitoring/access-logs":{"post":{"operationId":"queryAccessLogs","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/monitoring/outbound-events":{"post":{"operationId":"queryOutboundMonitoringEvents","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}}},"components":{"responses":{"BadRequest":{"content":{"application/json":{}}},"NotFound":{"content":{"application/json":{}}},"Unauthorized":{"content":{"application/json":{}}},"InternalServerError":{"content":{"application/json":{}}},"QueryInboundMonitoringEventsResponse":{"content":{"application/json":{}}},"GetMonitoringStatsResponse":{"content":{"application/json":{}}},"QueryAccessLogsResponse":{"content":{"application/json":{}}},"QueryOutboundMonitoringEventsResponse":{"content":{"application/json":{}}},"ReplayEventsResponse":{"content":{"application/json":{}}},"ERPUpdatesResponse":{"content":{"application/json":{}}},"TriggerWebhookResponse":{"content":{"application/json":{}}},"QueryEventsResponse":{"content":{"application/json":{}}}}}}')}},t={},n=function n(r){var o=t[r];if(void 0!==o)return o.exports;var i=t[r]={exports:{}};return e[r].call(i.exports,i,i.exports,n),i.exports}(330),r=exports;for(var o in n)r[o]=n[o];n.__esModule&&Object.defineProperty(r,"__esModule",{value:!0})})();
+(()=>{"use strict";var e={330:function(e,t,n){var r=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(t,"__esModule",{value:!0});var o=r(n(466));t.default=o.default},466:e=>{e.exports=JSON.parse('{"openapi":"3.0.3","info":{"title":"","version":""},"servers":[{"url":"https://erp-integration-api.sls.epilot.io"}],"paths":{"/v1/erp/tracking/acknowledgement":{"post":{"operationId":"acknowledgeTracking","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/erp/trigger":{"post":{"operationId":"triggerErp","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/erp/updates/events":{"post":{"deprecated":true,"operationId":"processErpUpdatesEvents","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v2/erp/updates/events":{"post":{"deprecated":true,"operationId":"processErpUpdatesEventsV2","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v3/erp/updates/events":{"post":{"operationId":"processErpUpdatesEventsV3","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v2/erp/updates/mapping_simulation":{"post":{"operationId":"simulateMappingV2","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/erp/updates/mapping_simulation":{"post":{"operationId":"simulateMapping","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations":{"get":{"operationId":"listIntegrations","responses":{}},"post":{"operationId":"createIntegration","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}":{"get":{"operationId":"getIntegration","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}},"put":{"operationId":"updateIntegration","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteIntegration","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/events":{"post":{"operationId":"queryEvents","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/events/replay":{"post":{"operationId":"replayEvents","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/use-cases":{"get":{"operationId":"listUseCases","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}},"post":{"operationId":"createUseCase","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/use-cases/{useCaseId}":{"get":{"operationId":"getUseCase","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true}],"responses":{}},"put":{"operationId":"updateUseCase","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteUseCase","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/use-cases/{useCaseId}/history":{"get":{"operationId":"listUseCaseHistory","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true},{"name":"cursor","in":"query","required":false}],"responses":{}}},"/v2/integrations":{"get":{"operationId":"listIntegrationsV2","responses":{}},"post":{"operationId":"createIntegrationV2","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v2/integrations/{integrationId}":{"get":{"operationId":"getIntegrationV2","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}},"put":{"operationId":"updateIntegrationV2","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteIntegrationV2","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/app-mapping":{"put":{"operationId":"setIntegrationAppMapping","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteIntegrationAppMapping","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/monitoring/inbound-events":{"post":{"operationId":"queryInboundMonitoringEvents","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/monitoring/stats":{"post":{"operationId":"getMonitoringStats","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/outbound-status":{"get":{"operationId":"getOutboundStatus","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/monitoring/access-logs":{"post":{"operationId":"queryAccessLogs","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/monitoring/outbound-events":{"post":{"operationId":"queryOutboundMonitoringEvents","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}}},"components":{"responses":{"BadRequest":{"content":{"application/json":{}}},"NotFound":{"content":{"application/json":{}}},"Unauthorized":{"content":{"application/json":{}}},"InternalServerError":{"content":{"application/json":{}}},"QueryInboundMonitoringEventsResponse":{"content":{"application/json":{}}},"GetMonitoringStatsResponse":{"content":{"application/json":{}}},"QueryAccessLogsResponse":{"content":{"application/json":{}}},"QueryOutboundMonitoringEventsResponse":{"content":{"application/json":{}}},"ReplayEventsResponse":{"content":{"application/json":{}}},"ERPUpdatesResponse":{"content":{"application/json":{}}},"TriggerWebhookResponse":{"content":{"application/json":{}}},"QueryEventsResponse":{"content":{"application/json":{}}}}}}')}},t={},n=function n(r){var o=t[r];if(void 0!==o)return o.exports;var i=t[r]={exports:{}};return e[r].call(i.exports,i,i.exports,n),i.exports}(330),r=exports;for(var o in n)r[o]=n[o];n.__esModule&&Object.defineProperty(r,"__esModule",{value:!0})})();

package/dist/openapi-runtime.json

@@ -35,6 +35,7 @@
     },
     "/v1/erp/updates/events": {
       "post": {
+        "deprecated": true,
         "operationId": "processErpUpdatesEvents",
         "requestBody": {
           "content": {
@@ -46,6 +47,7 @@
     },
     "/v2/erp/updates/events": {
       "post": {
+        "deprecated": true,
         "operationId": "processErpUpdatesEventsV2",
         "requestBody": {
           "content": {
@@ -55,6 +57,17 @@
         "responses": {}
       }
     },
+    "/v3/erp/updates/events": {
+      "post": {
+        "operationId": "processErpUpdatesEventsV3",
+        "requestBody": {
+          "content": {
+            "application/json": {}
+          }
+        },
+        "responses": {}
+      }
+    },
     "/v2/erp/updates/mapping_simulation": {
       "post": {
         "operationId": "simulateMappingV2",

package/dist/openapi.d.ts

@@ -18,9 +18,9 @@ declare namespace Components {
                  */
                 event_id: string;
                 /**
-                 * Processing status for the event (skipped indicates duplicate deduplication_id)
+                 * Processing status for the event (skipped indicates duplicate deduplication_id, ignored indicates unconfigured event)
                  */
-                status: "success" | "error" | "skipped";
+                status: "success" | "error" | "skipped" | "ignored";
                 message?: string;
             }[];
         }
@@ -381,6 +381,33 @@ declare namespace Components {
              */
             deduplication_id?: string; // ^[a-zA-Z0-9_-]+$
         }
+        export interface ErpEventV3 {
+            /**
+             * Name of the event (e.g., business_partner, contract_account). Corresponds to the "Event Name" from the integration UI. Replaces object_type from V2.
+             */
+            event_name: string;
+            /**
+             * Timestamp when the event occurred
+             */
+            timestamp: string; // date-time
+            /**
+             * Format of the payload data
+             */
+            format: "json" | "xml";
+            /**
+             * The object data payload - can be either a serialized string or a direct JSON object
+             */
+            payload: /* The object data payload - can be either a serialized string or a direct JSON object */ string | {
+                [name: string]: any;
+            };
+            /**
+             * Optional unique identifier for idempotency - prevents duplicate processing of the same event within 24 hours in context of the same integration. Must contain only alphanumeric characters, hyphens, and underscores.
+             *
+             * example:
+             * evt-2025-05-01-12345-bp
+             */
+            deduplication_id?: string; // ^[a-zA-Z0-9_-]+$
+        }
         export interface ErpUpdatesEventsV2Request {
             /**
              * UUID that identifies the integration configuration to use
@@ -395,6 +422,20 @@ declare namespace Components {
              */
             events: ErpEvent[];
         }
+        export interface ErpUpdatesEventsV3Request {
+            /**
+             * UUID that identifies the integration configuration to use
+             */
+            integration_id: string; // uuid
+            /**
+             * Optional ID that identifies the specific request for debugging purposes
+             */
+            correlation_id?: string;
+            /**
+             * List of ERP events to process
+             */
+            events: ErpEventV3[];
+        }
         export interface ErrorResponseBase {
             /**
              * Computer-readable error code
@@ -426,7 +467,7 @@ declare namespace Components {
              *   "status"
              * ]
              */
-            inbound_group_by?: ("use_case_id" | "sync_type" | "status" | "error_category" | "object_type" | "date")[];
+            inbound_group_by?: ("use_case_id" | "sync_type" | "status" | "error_category" | "object_type" | "event_name" | "date")[];
             /**
              * Fields to group outbound statistics by
              * example:
@@ -472,9 +513,9 @@ declare namespace Components {
              */
             use_case_id?: string | null;
             /**
-             * Type of event
+             * Type of event (optional for V3 events)
              */
-            event_type: "CREATE" | "UPDATE" | "DELETE" | "TRIGGER";
+            event_type?: "CREATE" | "UPDATE" | "DELETE" | "TRIGGER";
             /**
              * Type of object being synced (e.g., 'contract', 'meter')
              */
@@ -482,11 +523,11 @@ declare namespace Components {
             /**
              * Type of sync operation
              */
-            sync_type: "entity" | "meter_reading";
+            sync_type: "entity" | "meter_reading" | "webhook" | "api_deprecation";
             /**
              * Processing status
              */
-            status: "success" | "error" | "skipped";
+            status: "success" | "error" | "skipped" | "warning";
             /**
              * Error code (when status=error)
              */
@@ -921,6 +962,10 @@ declare namespace Components {
                  * Number of skipped events
                  */
                 skipped_count: number;
+                /**
+                 * Number of warning events
+                 */
+                warning_count?: number;
                 /**
                  * Success rate as percentage (0-100)
                  */
@@ -1334,6 +1379,10 @@ declare namespace Components {
              * Filter by object type
              */
             object_type?: string;
+            /**
+             * Filter by event name (alias for object_type)
+             */
+            event_name?: string;
             /**
              * Maximum number of results to return
              * example:
@@ -1370,11 +1419,11 @@ declare namespace Components {
             /**
              * Filter by sync type
              */
-            sync_type?: "entity" | "meter_reading";
+            sync_type?: "entity" | "meter_reading" | "webhook" | "api_deprecation";
             /**
              * Filter by processing status
              */
-            status?: "success" | "error" | "skipped";
+            status?: "success" | "error" | "skipped" | "warning";
             /**
              * Filter by error category (only applicable when status=error)
              */
@@ -1387,6 +1436,10 @@ declare namespace Components {
              * Filter by object type (e.g., 'contract', 'meter')
              */
             object_type?: string;
+            /**
+             * Filter by event name (alias for object_type)
+             */
+            event_name?: string;
             /**
              * Filter by event ID to find a specific event
              */
@@ -2262,7 +2315,6 @@ declare namespace Paths {
             export type $200 = Components.Responses.ERPUpdatesResponse;
             export type $400 = Components.Responses.BadRequest;
             export type $401 = Components.Responses.Unauthorized;
-            export type $422 = Components.Responses.ERPUpdatesResponse;
             export type $500 = Components.Responses.InternalServerError;
         }
     }
@@ -2272,7 +2324,15 @@ declare namespace Paths {
             export type $200 = Components.Responses.ERPUpdatesResponse;
             export type $400 = Components.Responses.BadRequest;
             export type $401 = Components.Responses.Unauthorized;
-            export type $422 = Components.Responses.ERPUpdatesResponse;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
+    namespace ProcessErpUpdatesEventsV3 {
+        export type RequestBody = Components.Schemas.ErpUpdatesEventsV3Request;
+        namespace Responses {
+            export type $200 = Components.Responses.ERPUpdatesResponse;
+            export type $400 = Components.Responses.BadRequest;
+            export type $401 = Components.Responses.Unauthorized;
             export type $500 = Components.Responses.InternalServerError;
         }
     }
@@ -2516,6 +2576,19 @@ export interface OperationMethods {
     data?: Paths.ProcessErpUpdatesEventsV2.RequestBody,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.ProcessErpUpdatesEventsV2.Responses.$200>
+  /**
+   * processErpUpdatesEventsV3 - processErpUpdatesEventsV3
+   * 
+   * Handles updates from ERP systems using integration_id directly.
+   * This is the v3 version that removes the unused event_type field and renames object_type to event_name
+   * to align with the integration UI naming.
+   * 
+   */
+  'processErpUpdatesEventsV3'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: Paths.ProcessErpUpdatesEventsV3.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.ProcessErpUpdatesEventsV3.Responses.$200>
   /**
    * simulateMappingV2 - simulateMappingV2
    * 
@@ -2878,6 +2951,21 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.ProcessErpUpdatesEventsV2.Responses.$200>
   }
+  ['/v3/erp/updates/events']: {
+    /**
+     * processErpUpdatesEventsV3 - processErpUpdatesEventsV3
+     * 
+     * Handles updates from ERP systems using integration_id directly.
+     * This is the v3 version that removes the unused event_type field and renames object_type to event_name
+     * to align with the integration UI naming.
+     * 
+     */
+    'post'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: Paths.ProcessErpUpdatesEventsV3.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.ProcessErpUpdatesEventsV3.Responses.$200>
+  }
   ['/v2/erp/updates/mapping_simulation']: {
     /**
      * simulateMappingV2 - simulateMappingV2
@@ -3239,7 +3327,9 @@ export type EmbeddedUseCaseRequest = Components.Schemas.EmbeddedUseCaseRequest;
 export type EmbeddedUseCaseRequestBase = Components.Schemas.EmbeddedUseCaseRequestBase;
 export type EntityUpdate = Components.Schemas.EntityUpdate;
 export type ErpEvent = Components.Schemas.ErpEvent;
+export type ErpEventV3 = Components.Schemas.ErpEventV3;
 export type ErpUpdatesEventsV2Request = Components.Schemas.ErpUpdatesEventsV2Request;
+export type ErpUpdatesEventsV3Request = Components.Schemas.ErpUpdatesEventsV3Request;
 export type ErrorResponseBase = Components.Schemas.ErrorResponseBase;
 export type GetMonitoringStatsRequest = Components.Schemas.GetMonitoringStatsRequest;
 export type InboundIntegrationEventConfiguration = Components.Schemas.InboundIntegrationEventConfiguration;

package/dist/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "ERP Integration API",
-    "version": "0.30.0",
+    "version": "0.33.0",
     "description": "API for integrating with ERP systems, handling tracking acknowledgments, triggering ERP processes, and processing ERP updates."
   },
   "tags": [
@@ -128,6 +128,7 @@
     },
     "/v1/erp/updates/events": {
       "post": {
+        "deprecated": true,
         "operationId": "processErpUpdatesEvents",
         "summary": "processErpUpdatesEvents",
         "description": "Handles updates from ERP systems and tracks them appropriately",
@@ -214,9 +215,6 @@
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
-          "422": {
-            "$ref": "#/components/responses/ERPUpdatesResponse"
-          },
           "500": {
             "$ref": "#/components/responses/InternalServerError"
           }
@@ -225,6 +223,7 @@
     },
     "/v2/erp/updates/events": {
       "post": {
+        "deprecated": true,
         "operationId": "processErpUpdatesEventsV2",
         "summary": "processErpUpdatesEventsV2",
         "description": "Handles updates from ERP systems using integration_id directly.\nThis is the v2 version that simplifies the API by accepting integration_id\ninstead of app_id and component_id.\n",
@@ -272,9 +271,59 @@
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
-          "422": {
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
+    },
+    "/v3/erp/updates/events": {
+      "post": {
+        "operationId": "processErpUpdatesEventsV3",
+        "summary": "processErpUpdatesEventsV3",
+        "description": "Handles updates from ERP systems using integration_id directly.\nThis is the v3 version that removes the unused event_type field and renames object_type to event_name\nto align with the integration UI naming.\n",
+        "tags": [
+          "erp"
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ErpUpdatesEventsV3Request"
+              },
+              "example": {
+                "integration_id": "123e4567-e89b-12d3-a456-426614174000",
+                "correlation_id": "req-789e4567-e89b-12d3-a456-426614174000",
+                "events": [
+                  {
+                    "event_name": "business_partner",
+                    "timestamp": "2025-05-01T08:30:00Z",
+                    "format": "json",
+                    "payload": "{\"id\":\"BP10001\",\"name\":\"Acme Corporation\",\"type\":\"organization\",\"tax_id\":\"DE123456789\",\"status\":\"active\"}",
+                    "deduplication_id": "bp-create-20250501-083000-001"
+                  },
+                  {
+                    "event_name": "contract_account",
+                    "timestamp": "2025-05-01T08:35:00Z",
+                    "format": "json",
+                    "payload": "{\"id\":\"CA20001\",\"business_partner_id\":\"BP10001\",\"status\":\"active\",\"payment_method\":\"direct_debit\"}",
+                    "deduplication_id": "ca-update-20250501-083500-001"
+                  }
+                ]
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
             "$ref": "#/components/responses/ERPUpdatesResponse"
           },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
           "500": {
             "$ref": "#/components/responses/InternalServerError"
           }
@@ -2260,6 +2309,82 @@
           }
         }
       },
+      "ErpEventV3": {
+        "type": "object",
+        "required": [
+          "event_name",
+          "timestamp",
+          "format",
+          "payload"
+        ],
+        "properties": {
+          "event_name": {
+            "type": "string",
+            "description": "Name of the event (e.g., business_partner, contract_account). Corresponds to the \"Event Name\" from the integration UI. Replaces object_type from V2."
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Timestamp when the event occurred"
+          },
+          "format": {
+            "type": "string",
+            "enum": [
+              "json",
+              "xml"
+            ],
+            "default": "json",
+            "description": "Format of the payload data"
+          },
+          "payload": {
+            "oneOf": [
+              {
+                "type": "string",
+                "description": "The serialized object data payload (JSON, XML, etc.) as a string"
+              },
+              {
+                "type": "object",
+                "description": "Direct JSON object (will be automatically serialized)",
+                "additionalProperties": true
+              }
+            ],
+            "description": "The object data payload - can be either a serialized string or a direct JSON object"
+          },
+          "deduplication_id": {
+            "type": "string",
+            "pattern": "^[a-zA-Z0-9_-]+$",
+            "minLength": 1,
+            "maxLength": 255,
+            "description": "Optional unique identifier for idempotency - prevents duplicate processing of the same event within 24 hours in context of the same integration. Must contain only alphanumeric characters, hyphens, and underscores.\n",
+            "example": "evt-2025-05-01-12345-bp"
+          }
+        }
+      },
+      "ErpUpdatesEventsV3Request": {
+        "type": "object",
+        "required": [
+          "integration_id",
+          "events"
+        ],
+        "properties": {
+          "integration_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "UUID that identifies the integration configuration to use"
+          },
+          "correlation_id": {
+            "type": "string",
+            "description": "Optional ID that identifies the specific request for debugging purposes"
+          },
+          "events": {
+            "type": "array",
+            "description": "List of ERP events to process",
+            "items": {
+              "$ref": "#/components/schemas/ErpEventV3"
+            }
+          }
+        }
+      },
       "TriggerErpActionRequest": {
         "type": "object",
         "required": [
@@ -4038,6 +4163,10 @@
             "type": "string",
             "description": "Filter by object type"
           },
+          "event_name": {
+            "type": "string",
+            "description": "Filter by event name (alias for object_type)"
+          },
           "limit": {
             "type": "integer",
             "description": "Maximum number of results to return",
@@ -4087,7 +4216,9 @@
             "type": "string",
             "enum": [
               "entity",
-              "meter_reading"
+              "meter_reading",
+              "webhook",
+              "api_deprecation"
             ],
             "description": "Filter by sync type"
           },
@@ -4096,7 +4227,8 @@
             "enum": [
               "success",
               "error",
-              "skipped"
+              "skipped",
+              "warning"
             ],
             "description": "Filter by processing status"
           },
@@ -4119,6 +4251,10 @@
             "type": "string",
             "description": "Filter by object type (e.g., 'contract', 'meter')"
           },
+          "event_name": {
+            "type": "string",
+            "description": "Filter by event name (alias for object_type)"
+          },
           "event_id": {
             "type": "string",
             "description": "Filter by event ID to find a specific event"
@@ -4316,6 +4452,7 @@
                 "status",
                 "error_category",
                 "object_type",
+                "event_name",
                 "date"
               ]
             },
@@ -4514,6 +4651,10 @@
                 "type": "integer",
                 "description": "Number of skipped events"
               },
+              "warning_count": {
+                "type": "integer",
+                "description": "Number of warning events"
+              },
               "success_rate": {
                 "type": "number",
                 "format": "float",
@@ -4588,7 +4729,6 @@
         "required": [
           "org_id",
           "event_id",
-          "event_type",
           "object_type",
           "sync_type",
           "status",
@@ -4627,7 +4767,7 @@
               "DELETE",
               "TRIGGER"
             ],
-            "description": "Type of event"
+            "description": "Type of event (optional for V3 events)"
           },
           "object_type": {
             "type": "string",
@@ -4637,7 +4777,9 @@
             "type": "string",
             "enum": [
               "entity",
-              "meter_reading"
+              "meter_reading",
+              "webhook",
+              "api_deprecation"
             ],
             "description": "Type of sync operation"
           },
@@ -4646,7 +4788,8 @@
             "enum": [
               "success",
               "error",
-              "skipped"
+              "skipped",
+              "warning"
             ],
             "description": "Processing status"
           },
@@ -4900,9 +5043,10 @@
                         "enum": [
                           "success",
                           "error",
-                          "skipped"
+                          "skipped",
+                          "ignored"
                         ],
-                        "description": "Processing status for the event (skipped indicates duplicate deduplication_id)"
+                        "description": "Processing status for the event (skipped indicates duplicate deduplication_id, ignored indicates unconfigured event)"
                       },
                       "message": {
                         "type": "string"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/erp-integration-client",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "description": "Client library for ePilot ERP Integration API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",