@epilot/erp-integration-client 0.23.0 → 0.24.0

package/dist/definition.js

@@ -1 +1 @@
-(()=>{"use strict";var e={390: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}(390),r=exports;for(var o in n)r[o]=n[o];n.__esModule&&Object.defineProperty(r,"__esModule",{value:!0})})();
+(()=>{"use strict";var e={390: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}/monitoring/timeseries":{"post":{"operationId":"getMonitoringTimeSeries","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":{}}},"GetMonitoringTimeSeriesResponse":{"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}(390),r=exports;for(var o in n)r[o]=n[o];n.__esModule&&Object.defineProperty(r,"__esModule",{value:!0})})();

package/dist/openapi-runtime.json

@@ -427,6 +427,25 @@
         "responses": {}
       }
     },
+    "/v1/integrations/{integrationId}/monitoring/timeseries": {
+      "post": {
+        "operationId": "getMonitoringTimeSeries",
+        "parameters": [
+          {
+            "name": "integrationId",
+            "in": "path",
+            "required": true
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {}
+          }
+        },
+        "responses": {}
+      }
+    },
     "/v1/integrations/{integrationId}/outbound-status": {
       "get": {
         "operationId": "getOutboundStatus",
@@ -511,6 +530,11 @@
           "application/json": {}
         }
       },
+      "GetMonitoringTimeSeriesResponse": {
+        "content": {
+          "application/json": {}
+        }
+      },
       "QueryAccessLogsResponse": {
         "content": {
           "application/json": {}

package/dist/openapi.d.ts

@@ -18,13 +18,31 @@ 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;
             }[];
         }
         export type GetMonitoringStatsResponse = Schemas.MonitoringStats;
+        export interface GetMonitoringTimeSeriesResponse {
+            /**
+             * The time bucket interval used for aggregation
+             */
+            interval: "5m" | "10m" | "30m" | "1h" | "3h" | "1d";
+            /**
+             * Start date of the time series
+             */
+            from_date: string; // date-time
+            /**
+             * End date of the time series
+             */
+            to_date: string; // date-time
+            /**
+             * List of time-series buckets with event counts
+             */
+            buckets: Schemas.TimeSeriesBucket[];
+        }
         export type InternalServerError = Schemas.ErrorResponseBase;
         export type NotFound = Schemas.ErrorResponseBase;
         export interface QueryAccessLogsResponse {
@@ -197,6 +215,10 @@ declare namespace Components {
              * List of access token IDs to associate with this integration
              */
             access_token_ids?: string[];
+            /**
+             * Configuration defining environment variables needed by this integration
+             */
+            environment_config?: EnvironmentFieldConfig[];
         }
         export interface CreateOutboundUseCaseRequest {
             /**
@@ -350,6 +372,32 @@ declare namespace Components {
                 [name: string]: any;
             };
         }
+        export interface EnvironmentFieldConfig {
+            /**
+             * Environment variable key, used to look up the value in the Environments API.
+             */
+            key: string; // ^[a-z0-9][a-z0-9_.\-]{0,127}$
+            /**
+             * Display label for the field in the UI
+             */
+            label: string;
+            /**
+             * Whether the value is a plain string or an encrypted secret
+             */
+            type: "String" | "SecretString";
+            /**
+             * Help text shown below the field
+             */
+            description?: string;
+            /**
+             * Whether this field must be filled before the integration can be used
+             */
+            required?: boolean;
+            /**
+             * Sort order for display and drag-to-reorder
+             */
+            order?: number;
+        }
         export interface ErpEvent {
             /**
              * Type of event (create, update, delete)
@@ -478,6 +526,32 @@ declare namespace Components {
              */
             outbound_group_by?: ("event_name" | "status" | "webhook_config_id" | "date")[];
         }
+        export interface GetMonitoringTimeSeriesRequest {
+            /**
+             * Start date for the time series (inclusive)
+             * example:
+             * 2025-01-01T00:00:00Z
+             */
+            from_date: string; // date-time
+            /**
+             * End date for the time series (inclusive). Defaults to current time if not specified.
+             * example:
+             * 2025-01-31T23:59:59Z
+             */
+            to_date?: string; // date-time
+            /**
+             * The time bucket interval for aggregation
+             * example:
+             * 1h
+             */
+            interval: "5m" | "10m" | "30m" | "1h" | "3h" | "1d";
+            /**
+             * Filter by event direction. Defaults to both.
+             * example:
+             * both
+             */
+            direction?: "inbound" | "outbound" | "both";
+        }
         /**
          * Configuration for inbound use cases (ERP to epilot)
          */
@@ -649,6 +723,10 @@ declare namespace Components {
              * List of access token IDs associated with this integration
              */
             access_token_ids?: string[];
+            /**
+             * Configuration defining environment variables needed by this integration. Values are stored in the Environments API.
+             */
+            environment_config?: EnvironmentFieldConfig[];
             /**
              * ISO-8601 timestamp when the integration was created
              */
@@ -922,7 +1000,7 @@ declare namespace Components {
                 };
             };
             /**
-             * Meter reading attributes (external_id, timestamp, source, value, etc.)
+             * Meter reading attributes. Required: external_id, timestamp, source, value. `source` must be one of: ECP, ERP, 360, journey-submission. `reason` (optional) must be one of: regular, irregular, last, first, meter_change, contract_change, meter_adjustment (or empty/null).
              */
             attributes: {
                 [name: string]: any;
@@ -1777,6 +1855,31 @@ declare namespace Components {
              */
             overwrite?: boolean;
         }
+        export interface TimeSeriesBucket {
+            /**
+             * The start timestamp of the bucket
+             */
+            timestamp: string; // date-time
+            /**
+             * Inbound event counts for this bucket. Null when direction is outbound.
+             */
+            inbound?: {
+                success_count?: number;
+                error_count?: number;
+                warning_count?: number;
+                skipped_count?: number;
+                total_count?: number;
+            } | null;
+            /**
+             * Outbound event counts for this bucket. Null when direction is inbound.
+             */
+            outbound?: {
+                success_count?: number;
+                error_count?: number;
+                pending_count?: number;
+                total_count?: number;
+            } | null;
+        }
         export interface TriggerErpActionRequest {
             /**
              * Unique identifier of the current automation execution
@@ -1863,6 +1966,10 @@ declare namespace Components {
              * List of access token IDs to associate with this integration
              */
             access_token_ids?: string[];
+            /**
+             * Configuration defining environment variables needed by this integration
+             */
+            environment_config?: EnvironmentFieldConfig[];
         }
         export interface UpdateOutboundUseCaseRequest {
             /**
@@ -2192,6 +2299,22 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace GetMonitoringTimeSeries {
+        namespace Parameters {
+            export type IntegrationId = string; // uuid
+        }
+        export interface PathParameters {
+            integrationId: Parameters.IntegrationId /* uuid */;
+        }
+        export type RequestBody = Components.Schemas.GetMonitoringTimeSeriesRequest;
+        namespace Responses {
+            export type $200 = Components.Responses.GetMonitoringTimeSeriesResponse;
+            export type $400 = Components.Responses.BadRequest;
+            export type $401 = Components.Responses.Unauthorized;
+            export type $404 = Components.Responses.NotFound;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
     namespace GetOutboundStatus {
         namespace Parameters {
             export type IntegrationId = string; // uuid
@@ -2315,7 +2438,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;
         }
     }
@@ -2325,7 +2447,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;
         }
     }
@@ -2335,7 +2456,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;
         }
     }
@@ -2862,6 +2982,19 @@ export interface OperationMethods {
     data?: Paths.GetMonitoringStats.RequestBody,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetMonitoringStats.Responses.$200>
+  /**
+   * getMonitoringTimeSeries - getMonitoringTimeSeries
+   * 
+   * Get time-series aggregated event counts for monitoring charts.
+   * Returns pre-bucketed counts at configurable intervals for both inbound and outbound events.
+   * Maximum of 200 buckets per request. Returns 400 if the time range and interval would exceed this limit.
+   * 
+   */
+  'getMonitoringTimeSeries'(
+    parameters?: Parameters<Paths.GetMonitoringTimeSeries.PathParameters> | null,
+    data?: Paths.GetMonitoringTimeSeries.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetMonitoringTimeSeries.Responses.$200>
   /**
    * getOutboundStatus - getOutboundStatus
    * 
@@ -3267,6 +3400,21 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetMonitoringStats.Responses.$200>
   }
+  ['/v1/integrations/{integrationId}/monitoring/timeseries']: {
+    /**
+     * getMonitoringTimeSeries - getMonitoringTimeSeries
+     * 
+     * Get time-series aggregated event counts for monitoring charts.
+     * Returns pre-bucketed counts at configurable intervals for both inbound and outbound events.
+     * Maximum of 200 buckets per request. Returns 400 if the time range and interval would exceed this limit.
+     * 
+     */
+    'post'(
+      parameters?: Parameters<Paths.GetMonitoringTimeSeries.PathParameters> | null,
+      data?: Paths.GetMonitoringTimeSeries.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetMonitoringTimeSeries.Responses.$200>
+  }
   ['/v1/integrations/{integrationId}/outbound-status']: {
     /**
      * getOutboundStatus - getOutboundStatus
@@ -3329,12 +3477,14 @@ export type EmbeddedOutboundUseCaseRequest = Components.Schemas.EmbeddedOutbound
 export type EmbeddedUseCaseRequest = Components.Schemas.EmbeddedUseCaseRequest;
 export type EmbeddedUseCaseRequestBase = Components.Schemas.EmbeddedUseCaseRequestBase;
 export type EntityUpdate = Components.Schemas.EntityUpdate;
+export type EnvironmentFieldConfig = Components.Schemas.EnvironmentFieldConfig;
 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 GetMonitoringTimeSeriesRequest = Components.Schemas.GetMonitoringTimeSeriesRequest;
 export type InboundIntegrationEventConfiguration = Components.Schemas.InboundIntegrationEventConfiguration;
 export type InboundMonitoringEvent = Components.Schemas.InboundMonitoringEvent;
 export type InboundUseCase = Components.Schemas.InboundUseCase;
@@ -3377,6 +3527,7 @@ export type RelationUniqueIdField = Components.Schemas.RelationUniqueIdField;
 export type RepeatableFieldType = Components.Schemas.RepeatableFieldType;
 export type ReplayEventsRequest = Components.Schemas.ReplayEventsRequest;
 export type SetIntegrationAppMappingRequest = Components.Schemas.SetIntegrationAppMappingRequest;
+export type TimeSeriesBucket = Components.Schemas.TimeSeriesBucket;
 export type TriggerErpActionRequest = Components.Schemas.TriggerErpActionRequest;
 export type TriggerWebhookResp = Components.Schemas.TriggerWebhookResp;
 export type UpdateInboundUseCaseRequest = Components.Schemas.UpdateInboundUseCaseRequest;

package/dist/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "ERP Integration API",
-    "version": "0.32.0",
+    "version": "0.36.0",
     "description": "API for integrating with ERP systems, handling tracking acknowledgments, triggering ERP processes, and processing ERP updates."
   },
   "tags": [
@@ -215,9 +215,6 @@
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
-          "422": {
-            "$ref": "#/components/responses/ERPUpdatesResponse"
-          },
           "500": {
             "$ref": "#/components/responses/InternalServerError"
           }
@@ -274,9 +271,6 @@
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
-          "422": {
-            "$ref": "#/components/responses/ERPUpdatesResponse"
-          },
           "500": {
             "$ref": "#/components/responses/InternalServerError"
           }
@@ -330,9 +324,6 @@
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
-          "422": {
-            "$ref": "#/components/responses/ERPUpdatesResponse"
-          },
           "500": {
             "$ref": "#/components/responses/InternalServerError"
           }
@@ -2065,6 +2056,56 @@
         }
       }
     },
+    "/v1/integrations/{integrationId}/monitoring/timeseries": {
+      "post": {
+        "operationId": "getMonitoringTimeSeries",
+        "summary": "getMonitoringTimeSeries",
+        "description": "Get time-series aggregated event counts for monitoring charts.\nReturns pre-bucketed counts at configurable intervals for both inbound and outbound events.\nMaximum of 200 buckets per request. Returns 400 if the time range and interval would exceed this limit.\n",
+        "tags": [
+          "monitoring",
+          "integrations"
+        ],
+        "parameters": [
+          {
+            "name": "integrationId",
+            "in": "path",
+            "required": true,
+            "description": "The integration ID",
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/GetMonitoringTimeSeriesRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/GetMonitoringTimeSeriesResponse"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
+    },
     "/v1/integrations/{integrationId}/outbound-status": {
       "get": {
         "operationId": "getOutboundStatus",
@@ -2519,6 +2560,13 @@
               "type": "string"
             }
           },
+          "environment_config": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/EnvironmentFieldConfig"
+            },
+            "description": "Configuration defining environment variables needed by this integration. Values are stored in the Environments API."
+          },
           "created_at": {
             "type": "string",
             "format": "date-time",
@@ -2554,6 +2602,13 @@
             "items": {
               "type": "string"
             }
+          },
+          "environment_config": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/EnvironmentFieldConfig"
+            },
+            "description": "Configuration defining environment variables needed by this integration"
           }
         }
       },
@@ -2577,6 +2632,57 @@
             "items": {
               "type": "string"
             }
+          },
+          "environment_config": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/EnvironmentFieldConfig"
+            },
+            "description": "Configuration defining environment variables needed by this integration"
+          }
+        }
+      },
+      "EnvironmentFieldConfig": {
+        "type": "object",
+        "required": [
+          "key",
+          "label",
+          "type"
+        ],
+        "properties": {
+          "key": {
+            "type": "string",
+            "description": "Environment variable key, used to look up the value in the Environments API.",
+            "pattern": "^[a-z0-9][a-z0-9_.\\-]{0,127}$"
+          },
+          "label": {
+            "type": "string",
+            "description": "Display label for the field in the UI",
+            "minLength": 1,
+            "maxLength": 255
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "String",
+              "SecretString"
+            ],
+            "description": "Whether the value is a plain string or an encrypted secret"
+          },
+          "description": {
+            "type": "string",
+            "description": "Help text shown below the field",
+            "maxLength": 1000
+          },
+          "required": {
+            "type": "boolean",
+            "default": false,
+            "description": "Whether this field must be filled before the integration can be used"
+          },
+          "order": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Sort order for display and drag-to-reorder"
           }
         }
       },
@@ -3212,7 +3318,7 @@
           "attributes": {
             "type": "object",
             "additionalProperties": true,
-            "description": "Meter reading attributes (external_id, timestamp, source, value, etc.)"
+            "description": "Meter reading attributes. Required: external_id, timestamp, source, value. `source` must be one of: ECP, ERP, 360, journey-submission. `reason` (optional) must be one of: regular, irregular, last, first, meter_change, contract_change, meter_adjustment (or empty/null)."
           }
         }
       },
@@ -4490,6 +4596,105 @@
           }
         }
       },
+      "GetMonitoringTimeSeriesRequest": {
+        "type": "object",
+        "required": [
+          "from_date",
+          "interval"
+        ],
+        "properties": {
+          "from_date": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Start date for the time series (inclusive)",
+            "example": "2025-01-01T00:00:00Z"
+          },
+          "to_date": {
+            "type": "string",
+            "format": "date-time",
+            "description": "End date for the time series (inclusive). Defaults to current time if not specified.",
+            "example": "2025-01-31T23:59:59Z"
+          },
+          "interval": {
+            "type": "string",
+            "enum": [
+              "5m",
+              "10m",
+              "30m",
+              "1h",
+              "3h",
+              "1d"
+            ],
+            "description": "The time bucket interval for aggregation",
+            "example": "1h"
+          },
+          "direction": {
+            "type": "string",
+            "enum": [
+              "inbound",
+              "outbound",
+              "both"
+            ],
+            "default": "both",
+            "description": "Filter by event direction. Defaults to both.",
+            "example": "both"
+          }
+        }
+      },
+      "TimeSeriesBucket": {
+        "type": "object",
+        "required": [
+          "timestamp"
+        ],
+        "properties": {
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "The start timestamp of the bucket"
+          },
+          "inbound": {
+            "type": "object",
+            "nullable": true,
+            "description": "Inbound event counts for this bucket. Null when direction is outbound.",
+            "properties": {
+              "success_count": {
+                "type": "integer"
+              },
+              "error_count": {
+                "type": "integer"
+              },
+              "warning_count": {
+                "type": "integer"
+              },
+              "skipped_count": {
+                "type": "integer"
+              },
+              "total_count": {
+                "type": "integer"
+              }
+            }
+          },
+          "outbound": {
+            "type": "object",
+            "nullable": true,
+            "description": "Outbound event counts for this bucket. Null when direction is inbound.",
+            "properties": {
+              "success_count": {
+                "type": "integer"
+              },
+              "error_count": {
+                "type": "integer"
+              },
+              "pending_count": {
+                "type": "integer"
+              },
+              "total_count": {
+                "type": "integer"
+              }
+            }
+          }
+        }
+      },
       "QueryOutboundMonitoringEventsRequest": {
         "type": "object",
         "properties": {
@@ -4930,6 +5135,53 @@
           }
         }
       },
+      "GetMonitoringTimeSeriesResponse": {
+        "description": "Time-series aggregated event counts retrieved successfully",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "required": [
+                "interval",
+                "from_date",
+                "to_date",
+                "buckets"
+              ],
+              "properties": {
+                "interval": {
+                  "type": "string",
+                  "enum": [
+                    "5m",
+                    "10m",
+                    "30m",
+                    "1h",
+                    "3h",
+                    "1d"
+                  ],
+                  "description": "The time bucket interval used for aggregation"
+                },
+                "from_date": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "Start date of the time series"
+                },
+                "to_date": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "End date of the time series"
+                },
+                "buckets": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/TimeSeriesBucket"
+                  },
+                  "description": "List of time-series buckets with event counts"
+                }
+              }
+            }
+          }
+        }
+      },
       "QueryAccessLogsResponse": {
         "description": "Access logs queried successfully",
         "content": {
@@ -5052,9 +5304,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.23.0",
+  "version": "0.24.0",
   "description": "Client library for ePilot ERP Integration API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",