@epilot/erp-integration-client 0.26.3 → 0.27.1

package/dist/openapi.d.ts

@@ -209,7 +209,7 @@ declare namespace Components {
              * URL-safe identifier for the use case. Recommended for portable cross-environment referencing. Must be unique per integration. Immutable after creation. Lowercase alphanumeric, hyphens, and underscores only.
              *
              */
-            slug: string; // ^[a-z0-9][a-z0-9_-]*$
+            slug?: string; // ^[a-z0-9][a-z0-9_-]*$
             /**
              * Whether the use case is enabled
              */
@@ -237,7 +237,7 @@ declare namespace Components {
              * URL-safe identifier for the use case. Recommended for portable cross-environment referencing. Must be unique per integration. Immutable after creation. Lowercase alphanumeric, hyphens, and underscores only.
              *
              */
-            slug: string; // ^[a-z0-9][a-z0-9_-]*$
+            slug?: string; // ^[a-z0-9][a-z0-9_-]*$
             /**
              * Whether the use case is enabled
              */
@@ -280,7 +280,7 @@ declare namespace Components {
              * URL-safe identifier for the use case. Recommended for portable cross-environment referencing. Must be unique per integration. Immutable after creation. Lowercase alphanumeric, hyphens, and underscores only.
              *
              */
-            slug: string; // ^[a-z0-9][a-z0-9_-]*$
+            slug?: string; // ^[a-z0-9][a-z0-9_-]*$
             /**
              * Whether the use case is enabled
              */
@@ -301,7 +301,7 @@ declare namespace Components {
              * URL-safe identifier for the use case. Recommended for portable cross-environment referencing. Must be unique per integration. Immutable after creation. Lowercase alphanumeric, hyphens, and underscores only.
              *
              */
-            slug: string; // ^[a-z0-9][a-z0-9_-]*$
+            slug?: string; // ^[a-z0-9][a-z0-9_-]*$
             /**
              * Whether the use case is enabled
              */
@@ -505,9 +505,10 @@ declare namespace Components {
              */
             deduplication_id?: string; // ^[a-zA-Z0-9_-]+$
         }
-        export interface ErpEventV3 {
+        export type 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 from integration mapping (e.g., business_partner, contract_account). Required when use_case_slug is not provided.
+             *
              */
             event_name: string;
             /**
@@ -536,7 +537,39 @@ declare namespace Components {
              * evt-2025-05-01-12345-bp
              */
             deduplication_id?: string; // ^[a-zA-Z0-9_-]+$
-        }
+        } | {
+            /**
+             * Event name from integration mapping (e.g., business_partner, contract_account). Required when use_case_slug is not provided.
+             *
+             */
+            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;
+            };
+            /**
+             * Recommended. Use case slug for routing this event to the correct use case configuration. If provided, takes precedence over event_name for use case lookup. Preferred over event_name-based routing as slugs are portable across environments.
+             *
+             */
+            use_case_slug: string; // ^[a-z0-9][a-z0-9_-]*$
+            /**
+             * 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
@@ -596,6 +629,32 @@ declare namespace Components {
              * Optional OAuth2 scope
              */
             scope?: string;
+            /**
+             * Handlebars template for the OAuth2 audience parameter
+             */
+            audience?: string;
+            /**
+             * Handlebars template for the OAuth2 resource parameter
+             */
+            resource?: string;
+            /**
+             * Additional key-value pairs to include in the token request body. Values support Handlebars templates.
+             */
+            body_params?: {
+                [name: string]: string;
+            };
+            /**
+             * Additional headers to include in the token request. Values support Handlebars templates.
+             */
+            headers?: {
+                [name: string]: string;
+            };
+            /**
+             * Additional query parameters to append to the token URL. Values support Handlebars templates.
+             */
+            query_params?: {
+                [name: string]: string;
+            };
         }
         export interface FileProxyParam {
             /**

package/dist/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "ERP Integration API",
-    "version": "0.44.0",
+    "version": "0.45.0",
     "description": "API for integrating with ERP systems, handling tracking acknowledgments, triggering ERP processes, and processing ERP updates."
   },
   "tags": [
@@ -2364,15 +2364,26 @@
       "ErpEventV3": {
         "type": "object",
         "required": [
-          "event_name",
           "timestamp",
           "format",
           "payload"
         ],
+        "anyOf": [
+          {
+            "required": [
+              "event_name"
+            ]
+          },
+          {
+            "required": [
+              "use_case_slug"
+            ]
+          }
+        ],
         "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."
+            "description": "Event name from integration mapping (e.g., business_partner, contract_account). Required when use_case_slug is not provided.\n"
           },
           "timestamp": {
             "type": "string",
@@ -3432,7 +3443,6 @@
         "type": "object",
         "required": [
           "name",
-          "slug",
           "type",
           "enabled"
         ],
@@ -3871,6 +3881,35 @@
           "scope": {
             "type": "string",
             "description": "Optional OAuth2 scope"
+          },
+          "audience": {
+            "type": "string",
+            "description": "Handlebars template for the OAuth2 audience parameter"
+          },
+          "resource": {
+            "type": "string",
+            "description": "Handlebars template for the OAuth2 resource parameter"
+          },
+          "body_params": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            },
+            "description": "Additional key-value pairs to include in the token request body. Values support Handlebars templates."
+          },
+          "headers": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            },
+            "description": "Additional headers to include in the token request. Values support Handlebars templates."
+          },
+          "query_params": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            },
+            "description": "Additional query parameters to append to the token URL. Values support Handlebars templates."
           }
         }
       },

package/package.json

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