@epilot/sdk 2.14.6 → 2.15.0

package/docs/metering.md

@@ -37,6 +37,7 @@ const { data } = await meteringClient.getCustomerMeters(...)
 - [`createMeterReading`](#createmeterreading)
 - [`createMeterReadings`](#createmeterreadings)
 - [`batchWriteMeterReadings`](#batchwritemeterreadings)
+- [`pruneMeterReadings`](#prunemeterreadings)
 - [`createMeterReadingFromSubmission`](#createmeterreadingfromsubmission)
 - [`getAllowedReadingForMeter`](#getallowedreadingformeter)
 - [`createReadingWithMeter`](#createreadingwithmeter)
@@ -73,6 +74,7 @@ const { data } = await meteringClient.getCustomerMeters(...)
 - [`CreateOrUpdateBatchReading`](#createorupdatebatchreading)
 - [`DeleteBatchReading`](#deletebatchreading)
 - [`BatchReading`](#batchreading)
+- [`PruneMeterReadingsPayload`](#prunemeterreadingspayload)
 - [`UpdateMeterReading`](#updatemeterreading)
 - [`MeterCounter`](#metercounter)
 - [`CounterReadingOnSubmission`](#counterreadingonsubmission)
@@ -135,7 +137,7 @@ const { data } = await client.getCustomerMeters({
       ],
       "used_for": "Domestic Usage",
       "manufacturer": "Energy One",
-      "calibration_date": "2022-10-10T00:00:00.000Z",
+      "calibration_date": "2022-10-10",
       "contract": {
         "$relation": [
           {
@@ -167,7 +169,7 @@ const { data } = await client.getCustomerMeters({
           }
         ]
       },
-      "last_reading": "2022-10-10T00:00:00.000Z",
+      "last_reading": "2022-10-10",
       "current_consumption": 100.5
     }
   ]
@@ -223,7 +225,7 @@ const { data } = await client.getMetersByContractId({
       ],
       "used_for": "Domestic Usage",
       "manufacturer": "Energy One",
-      "calibration_date": "2022-10-10T00:00:00.000Z",
+      "calibration_date": "2022-10-10",
       "contract": {
         "$relation": [
           {
@@ -296,7 +298,7 @@ const { data } = await client.updateMeter(
     ],
     "used_for": "Domestic Usage",
     "manufacturer": "Energy One",
-    "calibration_date": "2022-10-10T00:00:00.000Z",
+    "calibration_date": "2022-10-10",
     "contract": {
       "$relation": [
         {
@@ -366,7 +368,7 @@ const { data } = await client.getMeter({
       ],
       "used_for": "Domestic Usage",
       "manufacturer": "Energy One",
-      "calibration_date": "2022-10-10T00:00:00.000Z",
+      "calibration_date": "2022-10-10",
       "contract": {
         "$relation": [
           {
@@ -448,9 +450,9 @@ const { data } = await client.getMeterCounters({
       "transformer_ratio": 70,
       "unit": "string",
       "forecast_reading_value": 270,
-      "forecast_as_of": "2022-12-10T00:00:00.000Z",
+      "forecast_as_of": "2022-12-10",
       "current_consumption": 240,
-      "last_reading": "2022-10-10T00:00:00.000Z",
+      "last_reading": "2022-10-10",
       "conversion_factor": 3,
       "tariff_type": "ht"
     }
@@ -492,9 +494,9 @@ const { data } = await client.getCounterDetails({
     "transformer_ratio": 70,
     "unit": "string",
     "forecast_reading_value": 270,
-    "forecast_as_of": "2022-12-10T00:00:00.000Z",
+    "forecast_as_of": "2022-12-10",
     "current_consumption": 240,
-    "last_reading": "2022-10-10T00:00:00.000Z",
+    "last_reading": "2022-10-10",
     "conversion_factor": 3,
     "tariff_type": "ht"
   }
@@ -523,7 +525,7 @@ const { data } = await client.createMeterReading(
     meter_id: '3fa85f64-5717-4562-b3fc-2c963f66afa6',
     counter_id: '3fa85f64-5717-4562-b3fc-2c963f66afa6',
     direction: 'feed-in',
-    timestamp: '2022-10-10T00:00:00.000Z',
+    timestamp: '2022-10-10',
     source: 'ECP',
     status: 'valid',
     external_id: 'string',
@@ -550,7 +552,7 @@ const { data } = await client.createMeterReading(
     "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
     "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
     "direction": "feed-in",
-    "timestamp": "2022-10-10T00:00:00.000Z",
+    "timestamp": "2022-10-10",
     "source": "ECP",
     "status": "valid",
     "external_id": "string",
@@ -593,7 +595,7 @@ const { data } = await client.createMeterReadings(
         meter_id: '3fa85f64-5717-4562-b3fc-2c963f66afa6',
         counter_id: '3fa85f64-5717-4562-b3fc-2c963f66afa6',
         direction: 'feed-in',
-        timestamp: '2022-10-10T00:00:00.000Z',
+        timestamp: '2022-10-10',
         source: 'ECP',
         status: 'valid',
         external_id: 'string',
@@ -623,7 +625,7 @@ const { data } = await client.createMeterReadings(
       "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
       "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
       "direction": "feed-in",
-      "timestamp": "2022-10-10T00:00:00.000Z",
+      "timestamp": "2022-10-10",
       "source": "ECP",
       "status": "valid",
       "external_id": "string",
@@ -665,7 +667,7 @@ const { data } = await client.createPortalMeterReadings(
         meter_id: '3fa85f64-5717-4562-b3fc-2c963f66afa6',
         counter_id: '3fa85f64-5717-4562-b3fc-2c963f66afa6',
         direction: 'feed-in',
-        timestamp: '2022-10-10T00:00:00.000Z',
+        timestamp: '2022-10-10',
         source: 'ECP',
         status: 'valid',
         external_id: 'string',
@@ -695,7 +697,7 @@ const { data } = await client.createPortalMeterReadings(
       "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
       "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
       "direction": "feed-in",
-      "timestamp": "2022-10-10T00:00:00.000Z",
+      "timestamp": "2022-10-10",
       "source": "ECP",
       "status": "valid",
       "external_id": "string",
@@ -771,7 +773,7 @@ const { data } = await client.batchWriteMeterReadings(
       "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
       "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
       "direction": "feed-in",
-      "timestamp": "2022-10-10T00:00:00.000Z",
+      "timestamp": "2022-10-10",
       "source": "ECP",
       "status": "valid",
       "external_id": "string",
@@ -791,6 +793,45 @@ const { data } = await client.batchWriteMeterReadings(
 
 ---
 
+### `pruneMeterReadings`
+
+Deletes every reading of a meter whose `external_id` is NOT in the provided keep list — in a single request.
+
+`POST /v2/metering/readings/prune`
+
+```ts
+const { data } = await client.pruneMeterReadings(
+  {
+    async: true,
+    activity_id: 'example',
+    create_ticket: true,
+    dry_run: true,
+  },
+  {
+    meter_id: '3fa85f64-5717-4562-b3fc-2c963f66afa6',
+    counter_id: '3fa85f64-5717-4562-b3fc-2c963f66afa6',
+    source: 'ECP',
+    keep_external_ids: ['erp-reading-1', 'erp-reading-2']
+  },
+)
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "data": {
+    "deleted_count": 42,
+    "kept_count": 12
+  }
+}
+```
+
+</details>
+
+---
+
 ### `createMeterReadingFromSubmission`
 
 Creates meter readings from a journey submission payload.
@@ -916,7 +957,7 @@ const { data } = await client.createReadingWithMeter(
     "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
     "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
     "direction": "feed-in",
-    "timestamp": "2022-10-10T00:00:00.000Z",
+    "timestamp": "2022-10-10",
     "source": "ECP",
     "status": "valid",
     "external_id": "string",
@@ -971,7 +1012,7 @@ const { data } = await client.getReadingsByInterval({
       "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
       "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
       "direction": "feed-in",
-      "timestamp": "2022-10-10T00:00:00.000Z",
+      "timestamp": "2022-10-10",
       "source": "ECP",
       "status": "valid",
       "external_id": "string",
@@ -1013,7 +1054,7 @@ const { data } = await client.updateMeterReading(
     meter_id: '3fa85f64-5717-4562-b3fc-2c963f66afa6',
     counter_id: '3fa85f64-5717-4562-b3fc-2c963f66afa6',
     direction: 'feed-in',
-    timestamp: '2022-10-10T00:00:00.000Z',
+    timestamp: '2022-10-10',
     source: 'ECP',
     status: 'valid',
     external_id: 'string',
@@ -1038,7 +1079,7 @@ const { data } = await client.updateMeterReading(
     "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
     "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
     "direction": "feed-in",
-    "timestamp": "2022-10-10T00:00:00.000Z",
+    "timestamp": "2022-10-10",
     "source": "ECP",
     "status": "valid",
     "external_id": "string",
@@ -1181,7 +1222,7 @@ const { data } = await client.applyReadingChangeset({
     "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
     "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
     "direction": "feed-in",
-    "timestamp": "2022-10-10T00:00:00.000Z",
+    "timestamp": "2022-10-10",
     "source": "ECP",
     "status": "valid",
     "external_id": "string",
@@ -1692,6 +1733,17 @@ type BatchReading = {
 }
 ```
 
+### `PruneMeterReadingsPayload`
+
+```ts
+type PruneMeterReadingsPayload = {
+  meter_id: string // uuid
+  counter_id?: string // uuid
+  source?: "ECP" | "ERP" | "360" | "journey-submission"
+  keep_external_ids: string[]
+}
+```
+
 ### `UpdateMeterReading`
 
 ```ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/sdk",
-  "version": "2.14.6",
+  "version": "2.15.0",
   "description": "JavaScript/TypeScript SDK for epilot APIs",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -322,6 +322,16 @@
     },
     "./workflow-definition/openapi.json": "./definitions/workflow-definition.json"
   },
+  "scripts": {
+    "generate": "tsx ../../scripts/generate-sdk-v2.ts && pnpm lint:fix",
+    "build": "tsup",
+    "build:watch": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "biome check src",
+    "lint:fix": "biome check src --fix",
+    "prepublishOnly": "npm run build"
+  },
   "keywords": [
     "epilot",
     "sdk",
@@ -515,14 +525,5 @@
         "./dist/apis/workflow-definition.d.ts"
       ]
     }
-  },
-  "scripts": {
-    "generate": "tsx ../../scripts/generate-sdk-v2.ts && pnpm lint:fix",
-    "build": "tsup",
-    "build:watch": "tsup --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "biome check src",
-    "lint:fix": "biome check src --fix"
   }
-}
+}

package/dist/chunk-2KZBLHTS.cjs

@@ -1,14 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-var _chunkNJK5F5TFcjs = require('./chunk-NJK5F5TF.cjs');
-
-// src/definitions/metering-runtime.json
-var require_metering_runtime = _chunkNJK5F5TFcjs.__commonJS.call(void 0, {
-  "src/definitions/metering-runtime.json"(exports, module) {
-    module.exports = { s: "https://metering.sls.epilot.io", o: [["getCustomerMeters", "get", "/v1/metering/meter", [["IncludePendingChangesetsQueryParam"]]], ["getMetersByContractId", "get", "/v1/metering/contract/meters/{contract_id}", [["contract_id", "p", true]]], ["updateMeter", "patch", "/v1/metering/meter/{id}", [["id", "p", true]], 1], ["getMeter", "get", "/v1/metering/meter/{id}", [["id", "p", true]]], ["getMeterCounters", "get", "/v1/metering/counter", [["meter_id", "q", true]]], ["getCounterDetails", "get", "/v1/metering/counter/{counter_id}", [["counter_id", "p", true]]], ["createMeterReading", "post", "/v1/metering/reading", [["DirectQueryParam"]], 1], ["createMeterReadings", "post", "/v1/metering/readings", [["async", "q"], ["ActivityIdQueryParam"], ["SkipValidationQueryParam"], ["DirectQueryParam"], ["CreateTicketQueryParam"]], 1], ["createPortalMeterReadings", "post", "/v1/metering/readings/{meter_id}", [["meter_id", "p", true], ["DirectQueryParam"]], 1], ["batchWriteMeterReadings", "post", "/v2/metering/readings", [["async", "q"], ["SkipValidationQueryParam"], ["ActivityIdQueryParam"], ["DirectQueryParam"], ["CreateTicketQueryParam"]], 1], ["createMeterReadingFromSubmission", "post", "/v1/metering/reading/submission", null, 1], ["getAllowedReadingForMeter", "get", "/v1/metering/allowed/reading/{meter_id}", [["meter_id", "p", true], ["timestamp", "q"]]], ["createReadingWithMeter", "post", "/v1/metering/reading/with-meter", null, 1], ["getReadingsByInterval", "get", "/v1/metering/reading/{meter_id}/{counter_id}", [["meter_id", "p", true], ["counter_id", "p", true], ["start_date", "q"], ["end_date", "q"], ["direction", "q"], ["size", "q"], ["from", "q"], ["type", "q", true], ["sort", "q"], ["IncludePendingChangesetsQueryParam"]]], ["updateMeterReading", "put", "/v1/metering/reading/{meter_id}/{counter_id}", [["meter_id", "p", true], ["counter_id", "p", true], ["timestamp", "q", true]], 1], ["deleteMeterReading", "delete", "/v1/metering/reading/{meter_id}/{counter_id}", [["meter_id", "p", true], ["counter_id", "p", true], ["timestamp", "q", true]]], ["getReadingChangesets", "get", "/v1/metering/reading/{meter_id}/{counter_id}/changesets", [["MeterIdParam"], ["CounterIdParam"]]], ["applyReadingChangeset", "post", "/v1/metering/reading/{meter_id}/{counter_id}/changesets/{changeset_id}:apply", [["MeterIdParam"], ["CounterIdParam"], ["changeset_id", "p", true]]], ["dismissReadingChangeset", "post", "/v1/metering/reading/{meter_id}/{counter_id}/changesets/{changeset_id}:dismiss", [["MeterIdParam"], ["CounterIdParam"], ["changeset_id", "p", true]], 1], ["updateReadingChangeset", "patch", "/v1/metering/reading/{meter_id}/{counter_id}/changesets/{changeset_id}", [["MeterIdParam"], ["CounterIdParam"], ["changeset_id", "p", true]], 1]], v: "3.0.3", cp: { MeterIdParam: ["meter_id", "p", true], CounterIdParam: ["counter_id", "p", true], DirectQueryParam: ["direct", "q"], IncludePendingChangesetsQueryParam: ["include_pending_changesets", "q"], ActivityIdQueryParam: ["activity_id", "q"], CreateTicketQueryParam: ["create_ticket", "q"], SkipValidationQueryParam: ["skip_validation", "q"] } };
-  }
-});
-
-
-
-exports.require_metering_runtime = require_metering_runtime;

package/dist/chunk-K2F255B3.js

@@ -1,14 +0,0 @@
-import {
-  __commonJS
-} from "./chunk-YPSWSI3M.js";
-
-// src/definitions/metering-runtime.json
-var require_metering_runtime = __commonJS({
-  "src/definitions/metering-runtime.json"(exports, module) {
-    module.exports = { s: "https://metering.sls.epilot.io", o: [["getCustomerMeters", "get", "/v1/metering/meter", [["IncludePendingChangesetsQueryParam"]]], ["getMetersByContractId", "get", "/v1/metering/contract/meters/{contract_id}", [["contract_id", "p", true]]], ["updateMeter", "patch", "/v1/metering/meter/{id}", [["id", "p", true]], 1], ["getMeter", "get", "/v1/metering/meter/{id}", [["id", "p", true]]], ["getMeterCounters", "get", "/v1/metering/counter", [["meter_id", "q", true]]], ["getCounterDetails", "get", "/v1/metering/counter/{counter_id}", [["counter_id", "p", true]]], ["createMeterReading", "post", "/v1/metering/reading", [["DirectQueryParam"]], 1], ["createMeterReadings", "post", "/v1/metering/readings", [["async", "q"], ["ActivityIdQueryParam"], ["SkipValidationQueryParam"], ["DirectQueryParam"], ["CreateTicketQueryParam"]], 1], ["createPortalMeterReadings", "post", "/v1/metering/readings/{meter_id}", [["meter_id", "p", true], ["DirectQueryParam"]], 1], ["batchWriteMeterReadings", "post", "/v2/metering/readings", [["async", "q"], ["SkipValidationQueryParam"], ["ActivityIdQueryParam"], ["DirectQueryParam"], ["CreateTicketQueryParam"]], 1], ["createMeterReadingFromSubmission", "post", "/v1/metering/reading/submission", null, 1], ["getAllowedReadingForMeter", "get", "/v1/metering/allowed/reading/{meter_id}", [["meter_id", "p", true], ["timestamp", "q"]]], ["createReadingWithMeter", "post", "/v1/metering/reading/with-meter", null, 1], ["getReadingsByInterval", "get", "/v1/metering/reading/{meter_id}/{counter_id}", [["meter_id", "p", true], ["counter_id", "p", true], ["start_date", "q"], ["end_date", "q"], ["direction", "q"], ["size", "q"], ["from", "q"], ["type", "q", true], ["sort", "q"], ["IncludePendingChangesetsQueryParam"]]], ["updateMeterReading", "put", "/v1/metering/reading/{meter_id}/{counter_id}", [["meter_id", "p", true], ["counter_id", "p", true], ["timestamp", "q", true]], 1], ["deleteMeterReading", "delete", "/v1/metering/reading/{meter_id}/{counter_id}", [["meter_id", "p", true], ["counter_id", "p", true], ["timestamp", "q", true]]], ["getReadingChangesets", "get", "/v1/metering/reading/{meter_id}/{counter_id}/changesets", [["MeterIdParam"], ["CounterIdParam"]]], ["applyReadingChangeset", "post", "/v1/metering/reading/{meter_id}/{counter_id}/changesets/{changeset_id}:apply", [["MeterIdParam"], ["CounterIdParam"], ["changeset_id", "p", true]]], ["dismissReadingChangeset", "post", "/v1/metering/reading/{meter_id}/{counter_id}/changesets/{changeset_id}:dismiss", [["MeterIdParam"], ["CounterIdParam"], ["changeset_id", "p", true]], 1], ["updateReadingChangeset", "patch", "/v1/metering/reading/{meter_id}/{counter_id}/changesets/{changeset_id}", [["MeterIdParam"], ["CounterIdParam"], ["changeset_id", "p", true]], 1]], v: "3.0.3", cp: { MeterIdParam: ["meter_id", "p", true], CounterIdParam: ["counter_id", "p", true], DirectQueryParam: ["direct", "q"], IncludePendingChangesetsQueryParam: ["include_pending_changesets", "q"], ActivityIdQueryParam: ["activity_id", "q"], CreateTicketQueryParam: ["create_ticket", "q"], SkipValidationQueryParam: ["skip_validation", "q"] } };
-  }
-});
-
-export {
-  require_metering_runtime
-};

package/dist/metering-3K36TQ5Z.cjs

@@ -1,7 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-NJK5F5TF.cjs');
-
-// src/docs/metering.json
-var metering_default = '# Metering API\n\n- **Base URL:** `https://metering.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/metering](https://docs.epilot.io/api/metering)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.metering.getCustomerMeters(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/metering\'\n\nconst meteringClient = getClient()\nauthorize(meteringClient, () => \'<token>\')\nconst { data } = await meteringClient.getCustomerMeters(...)\n```\n\n## Operations\n\n**ECP**\n- [`getCustomerMeters`](#getcustomermeters)\n- [`getMetersByContractId`](#getmetersbycontractid)\n- [`updateMeter`](#updatemeter)\n- [`getMeter`](#getmeter)\n- [`getMeterCounters`](#getmetercounters)\n- [`getCounterDetails`](#getcounterdetails)\n- [`createPortalMeterReadings`](#createportalmeterreadings)\n\n**ECP Admin**\n- [`createMeterReading`](#createmeterreading)\n- [`createMeterReadings`](#createmeterreadings)\n- [`batchWriteMeterReadings`](#batchwritemeterreadings)\n- [`createMeterReadingFromSubmission`](#createmeterreadingfromsubmission)\n- [`getAllowedReadingForMeter`](#getallowedreadingformeter)\n- [`createReadingWithMeter`](#createreadingwithmeter)\n- [`getReadingsByInterval`](#getreadingsbyinterval)\n- [`updateMeterReading`](#updatemeterreading)\n- [`deleteMeterReading`](#deletemeterreading)\n\n**Metering**\n- [`getReadingChangesets`](#getreadingchangesets)\n- [`applyReadingChangeset`](#applyreadingchangeset)\n- [`dismissReadingChangeset`](#dismissreadingchangeset)\n- [`updateReadingChangeset`](#updatereadingchangeset)\n\n**Schemas**\n- [`ErrorResp`](#errorresp)\n- [`EntityId`](#entityid)\n- [`EntitySlug`](#entityslug)\n- [`BaseEntity`](#baseentity)\n- [`Entity`](#entity)\n- [`EntityItem`](#entityitem)\n- [`Id`](#id)\n- [`EntityRelation`](#entityrelation)\n- [`Meter`](#meter)\n- [`Direction`](#direction)\n- [`TariffType`](#tarifftype)\n- [`Reason`](#reason)\n- [`ReasonString`](#reasonstring)\n- [`ReadBy`](#readby)\n- [`ReadingStatus`](#readingstatus)\n- [`Reading`](#reading)\n- [`MeterReading`](#meterreading)\n- [`PortalMeterReading`](#portalmeterreading)\n- [`BatchReadingBase`](#batchreadingbase)\n- [`CreateOrUpdateBatchReading`](#createorupdatebatchreading)\n- [`DeleteBatchReading`](#deletebatchreading)\n- [`BatchReading`](#batchreading)\n- [`UpdateMeterReading`](#updatemeterreading)\n- [`MeterCounter`](#metercounter)\n- [`CounterReadingOnSubmission`](#counterreadingonsubmission)\n- [`SubmissionMeterReading`](#submissionmeterreading)\n- [`Unit`](#unit)\n- [`Source`](#source)\n- [`ActionLabel`](#actionlabel)\n- [`Rule`](#rule)\n- [`JourneyActions`](#journeyactions)\n- [`ReadingWithMeter`](#readingwithmeter)\n- [`MeterReadingChangeset`](#meterreadingchangeset)\n- [`FuzzyConfig`](#fuzzyconfig)\n- [`ProposedReading`](#proposedreading)\n- [`ChangesetCreator`](#changesetcreator)\n- [`TimestampTolerance`](#timestamptolerance)\n- [`ActivityId`](#activityid)\n\n### `getCustomerMeters`\n\nRetrieves all meters associated with the authenticated portal customer.\n\n`GET /v1/metering/meter`\n\n```ts\nconst { data } = await client.getCustomerMeters({\n  include_pending_changesets: true,\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": [\n    {\n      "_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "_title": "Example Entity",\n      "_org": "123",\n      "_tags": ["example", "mock"],\n      "_created_at": "2021-02-09T12:41:43.662Z",\n      "_updated_at": "2021-02-09T12:41:43.662Z",\n      "_schema": "meter",\n      "ma_lo_id": "A09-123",\n      "status": "active",\n      "meter_type": "three-phase-meter",\n      "tariff_type": "Peak load tariff",\n      "meter_number": "J-1093-1AK",\n      "sector": "power",\n      "location": [\n        {\n          "country": "Germany",\n          "city": "Koln",\n          "postal_code": 81475,\n          "street": "Melateng\xFCrtel",\n          "street_number": 71,\n          "additional_info": "5. Etage",\n          "_tags": ["billing", "delivery"]\n        }\n      ],\n      "used_for": "Domestic Usage",\n      "manufacturer": "Energy One",\n      "calibration_date": "2022-10-10T00:00:00.000Z",\n      "contract": {\n        "$relation": [\n          {\n            "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n            "_slug": "contact"\n          }\n        ]\n      },\n      "customer": {\n        "$relation": [\n          {\n            "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n            "_slug": "contact"\n          }\n        ]\n      },\n      "journey_actions": {\n        "journey_id": "string",\n        "action_label": {\n          "en": "string",\n          "de": "string"\n        },\n        "slug": "string",\n        "rules": [\n          {\n            "entity": "string",\n            "attribute": "string",\n            "attribute_value": "string"\n          }\n        ]\n      },\n      "last_reading": "2022-10-10T00:00:00.000Z",\n      "current_consumption": 100.5\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getMetersByContractId`\n\nRetrieves all meters associated with a given contract entity.\n\n`GET /v1/metering/contract/meters/{contract_id}`\n\n```ts\nconst { data } = await client.getMetersByContractId({\n  contract_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": [\n    {\n      "_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "_title": "Example Entity",\n      "_org": "123",\n      "_tags": ["example", "mock"],\n      "_created_at": "2021-02-09T12:41:43.662Z",\n      "_updated_at": "2021-02-09T12:41:43.662Z",\n      "_schema": "meter",\n      "ma_lo_id": "A09-123",\n      "status": "active",\n      "meter_type": "three-phase-meter",\n      "tariff_type": "Peak load tariff",\n      "meter_number": "J-1093-1AK",\n      "sector": "power",\n      "location": [\n        {\n          "country": "Germany",\n          "city": "Koln",\n          "postal_code": 81475,\n          "street": "Melateng\xFCrtel",\n          "street_number": 71,\n          "additional_info": "5. Etage",\n          "_tags": ["billing", "delivery"]\n        }\n      ],\n      "used_for": "Domestic Usage",\n      "manufacturer": "Energy One",\n      "calibration_date": "2022-10-10T00:00:00.000Z",\n      "contract": {\n        "$relation": [\n          {\n            "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n            "_slug": "contact"\n          }\n        ]\n      },\n      "customer": {\n        "$relation": [\n          {\n            "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n            "_slug": "contact"\n          }\n        ]\n      }\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `updateMeter`\n\nPartially updates the details of a meter entity by ID.\n\n`PATCH /v1/metering/meter/{id}`\n\n```ts\nconst { data } = await client.updateMeter(\n  {\n    id: \'123e4567-e89b-12d3-a456-426614174000\',\n  },\n  {},\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": {\n    "_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "_title": "Example Entity",\n    "_org": "123",\n    "_tags": ["example", "mock"],\n    "_created_at": "2021-02-09T12:41:43.662Z",\n    "_updated_at": "2021-02-09T12:41:43.662Z",\n    "_schema": "meter",\n    "ma_lo_id": "A09-123",\n    "status": "active",\n    "meter_type": "three-phase-meter",\n    "tariff_type": "Peak load tariff",\n    "meter_number": "J-1093-1AK",\n    "sector": "power",\n    "location": [\n      {\n        "country": "Germany",\n        "city": "Koln",\n        "postal_code": 81475,\n        "street": "Melateng\xFCrtel",\n        "street_number": 71,\n        "additional_info": "5. Etage",\n        "_tags": ["billing", "delivery"]\n      }\n    ],\n    "used_for": "Domestic Usage",\n    "manufacturer": "Energy One",\n    "calibration_date": "2022-10-10T00:00:00.000Z",\n    "contract": {\n      "$relation": [\n        {\n          "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n          "_slug": "contact"\n        }\n      ]\n    },\n    "customer": {\n      "$relation": [\n        {\n          "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n          "_slug": "contact"\n        }\n      ]\n    }\n  }\n}\n```\n\n</details>\n\n---\n\n### `getMeter`\n\nRetrieves the full details of a specific meter by ID, including related entities and available journey actions.\n\n`GET /v1/metering/meter/{id}`\n\n```ts\nconst { data } = await client.getMeter({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": {\n    "entity": {\n      "_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "_title": "Example Entity",\n      "_org": "123",\n      "_tags": ["example", "mock"],\n      "_created_at": "2021-02-09T12:41:43.662Z",\n      "_updated_at": "2021-02-09T12:41:43.662Z",\n      "_schema": "meter",\n      "ma_lo_id": "A09-123",\n      "status": "active",\n      "meter_type": "three-phase-meter",\n      "tariff_type": "Peak load tariff",\n      "meter_number": "J-1093-1AK",\n      "sector": "power",\n      "location": [\n        {\n          "country": "Germany",\n          "city": "Koln",\n          "postal_code": 81475,\n          "street": "Melateng\xFCrtel",\n          "street_number": 71,\n          "additional_info": "5. Etage",\n          "_tags": ["billing", "delivery"]\n        }\n      ],\n      "used_for": "Domestic Usage",\n      "manufacturer": "Energy One",\n      "calibration_date": "2022-10-10T00:00:00.000Z",\n      "contract": {\n        "$relation": [\n          {\n            "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n            "_slug": "contact"\n          }\n        ]\n      },\n      "customer": {\n        "$relation": [\n          {\n            "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n            "_slug": "contact"\n          }\n        ]\n      }\n    },\n    "journey_actions": {\n      "journey_id": "string",\n      "action_label": {\n        "en": "string",\n        "de": "string"\n      },\n      "slug": "string",\n      "rules": [\n        {\n          "entity": "string",\n          "attribute": "string",\n          "attribute_value": "string"\n        }\n      ]\n    },\n    "relations": [\n      {\n        "_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n        "_title": "Example Entity",\n        "_org": "123",\n        "_tags": ["example", "mock"],\n        "_created_at": "2021-02-09T12:41:43.662Z",\n        "_updated_at": "2021-02-09T12:41:43.662Z"\n      }\n    ]\n  }\n}\n```\n\n</details>\n\n---\n\n### `getMeterCounters`\n\nRetrieves all meter counters associated with a given meter.\n\n`GET /v1/metering/counter`\n\n```ts\nconst { data } = await client.getMeterCounters({\n  meter_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": [\n    {\n      "_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "_title": "Example Entity",\n      "_org": "123",\n      "_tags": ["example", "mock"],\n      "_created_at": "2021-02-09T12:41:43.662Z",\n      "_updated_at": "2021-02-09T12:41:43.662Z",\n      "_schema": "meter_counter",\n      "obis_number": "A-34",\n      "direction": "feed-in",\n      "transformer_ratio": 70,\n      "unit": "string",\n      "forecast_reading_value": 270,\n      "forecast_as_of": "2022-12-10T00:00:00.000Z",\n      "current_consumption": 240,\n      "last_reading": "2022-10-10T00:00:00.000Z",\n      "conversion_factor": 3,\n      "tariff_type": "ht"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getCounterDetails`\n\nRetrieves the full details of a single meter counter by its ID.\n\n`GET /v1/metering/counter/{counter_id}`\n\n```ts\nconst { data } = await client.getCounterDetails({\n  counter_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": {\n    "_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "_title": "Example Entity",\n    "_org": "123",\n    "_tags": ["example", "mock"],\n    "_created_at": "2021-02-09T12:41:43.662Z",\n    "_updated_at": "2021-02-09T12:41:43.662Z",\n    "_schema": "meter_counter",\n    "obis_number": "A-34",\n    "direction": "feed-in",\n    "transformer_ratio": 70,\n    "unit": "string",\n    "forecast_reading_value": 270,\n    "forecast_as_of": "2022-12-10T00:00:00.000Z",\n    "current_consumption": 240,\n    "last_reading": "2022-10-10T00:00:00.000Z",\n    "conversion_factor": 3,\n    "tariff_type": "ht"\n  }\n}\n```\n\n</details>\n\n---\n\n### `createMeterReading`\n\nInserts a new meter reading.\n\n`POST /v1/metering/reading`\n\n```ts\nconst { data } = await client.createMeterReading(\n  {\n    direct: true,\n  },\n  {\n    value: 240,\n    read_by: \'John Doe\',\n    reason: \'\',\n    meter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n    counter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n    direction: \'feed-in\',\n    timestamp: \'2022-10-10T00:00:00.000Z\',\n    source: \'ECP\',\n    status: \'valid\',\n    external_id: \'string\',\n    remark: \'Customer reported unusual consumption\',\n    metadata: {\n      registration_id: \'1234567890\',\n      business_unit: \'ABC\'\n    },\n    note: \'string\',\n    unit: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": {\n    "value": 240,\n    "read_by": "John Doe",\n    "reason": "",\n    "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "direction": "feed-in",\n    "timestamp": "2022-10-10T00:00:00.000Z",\n    "source": "ECP",\n    "status": "valid",\n    "external_id": "string",\n    "remark": "Customer reported unusual consumption",\n    "metadata": {\n      "registration_id": "1234567890",\n      "business_unit": "ABC"\n    },\n    "note": "string",\n    "unit": "string"\n  }\n}\n```\n\n</details>\n\n---\n\n### `createMeterReadings`\n\nInserts multiple meter readings at once. Limited to 100 readings per request.\n\n`POST /v1/metering/readings`\n\n```ts\nconst { data } = await client.createMeterReadings(\n  {\n    async: true,\n    activity_id: \'example\',\n    skip_validation: true,\n    direct: true,\n    create_ticket: true,\n  },\n  {\n    readings: [\n      {\n        value: 240,\n        read_by: \'John Doe\',\n        reason: \'\',\n        meter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n        counter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n        direction: \'feed-in\',\n        timestamp: \'2022-10-10T00:00:00.000Z\',\n        source: \'ECP\',\n        status: \'valid\',\n        external_id: \'string\',\n        remark: \'Customer reported unusual consumption\',\n        metadata: {\n          registration_id: \'1234567890\',\n          business_unit: \'ABC\'\n        },\n        note: \'string\',\n        unit: \'string\'\n      }\n    ]\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": [\n    {\n      "value": 240,\n      "read_by": "John Doe",\n      "reason": "",\n      "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "direction": "feed-in",\n      "timestamp": "2022-10-10T00:00:00.000Z",\n      "source": "ECP",\n      "status": "valid",\n      "external_id": "string",\n      "remark": "Customer reported unusual consumption",\n      "metadata": {\n        "registration_id": "1234567890",\n        "business_unit": "ABC"\n      },\n      "note": "string",\n      "unit": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `createPortalMeterReadings`\n\nInserts multiple meter readings at once for a given meter via the end customer portal.\nLimited to 100 readings per request.\n\n`POST /v1/metering/readings/{meter_id}`\n\n```ts\nconst { data } = await client.createPortalMeterReadings(\n  {\n    meter_id: \'example\',\n    direct: true,\n  },\n  {\n    readings: [\n      {\n        value: 240,\n        read_by: \'John Doe\',\n        reason: \'\',\n        meter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n        counter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n        direction: \'feed-in\',\n        timestamp: \'2022-10-10T00:00:00.000Z\',\n        source: \'ECP\',\n        status: \'valid\',\n        external_id: \'string\',\n        remark: \'Customer reported unusual consumption\',\n        metadata: {\n          registration_id: \'1234567890\',\n          business_unit: \'ABC\'\n        },\n        note: \'string\',\n        unit: \'string\'\n      }\n    ]\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": [\n    {\n      "value": 240,\n      "read_by": "John Doe",\n      "reason": "",\n      "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "direction": "feed-in",\n      "timestamp": "2022-10-10T00:00:00.000Z",\n      "source": "ECP",\n      "status": "valid",\n      "external_id": "string",\n      "remark": "Customer reported unusual consumption",\n      "metadata": {\n        "registration_id": "1234567890",\n        "business_unit": "ABC"\n      },\n      "note": "string",\n      "unit": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `batchWriteMeterReadings`\n\nUpserts or deletes multiple meter readings at once. Limited to 100 readings per request.\n\n`POST /v2/metering/readings`\n\n```ts\nconst { data } = await client.batchWriteMeterReadings(\n  {\n    async: true,\n    skip_validation: true,\n    activity_id: \'example\',\n    direct: true,\n    create_ticket: true,\n  },\n  {\n    identifiers: [\'string\'],\n    readings: [\n      {\n        meter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n        counter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n        direction: \'feed-in\',\n        timestamp: \'2022-10-10T10:00:00Z\',\n        external_id: \'string\',\n        metadata: {\n          registration_id: \'1234567890\',\n          business_unit: \'ABC\'\n        },\n        operation: \'create\',\n        value: 240,\n        source: \'ECP\',\n        read_by: \'John Doe\',\n        reason: \'\',\n        status: \'valid\',\n        remark: \'Customer reported unusual consumption\',\n        note: \'string\',\n        unit: \'string\'\n      }\n    ]\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": [\n    {\n      "value": 240,\n      "read_by": "John Doe",\n      "reason": "",\n      "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "direction": "feed-in",\n      "timestamp": "2022-10-10T00:00:00.000Z",\n      "source": "ECP",\n      "status": "valid",\n      "external_id": "string",\n      "remark": "Customer reported unusual consumption",\n      "metadata": {\n        "registration_id": "1234567890",\n        "business_unit": "ABC"\n      },\n      "note": "string",\n      "unit": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `createMeterReadingFromSubmission`\n\nCreates meter readings from a journey submission payload.\n\n`POST /v1/metering/reading/submission`\n\n```ts\nconst { data } = await client.createMeterReadingFromSubmission(\n  null,\n  {\n    org_id: \'123\',\n    entity: {\n      _org: \'123\',\n      meterReadings: [\n        {\n          meterId: \'string\',\n          readings: [\n            {\n              counterId: \'string\',\n              direction: \'feed-in\',\n              unit: \'string\',\n              value: 240\n            }\n          ],\n          readingValue: 240,\n          readingDate: \'2022-10-10T10:10:00.000Z\',\n          readBy: \'John Doe\',\n          reason: \'\',\n          maloId: \'A09-123\',\n          obisNumber: \'A-34\',\n          readingUnit: \'string\',\n          meterType: \'one_tariff\',\n          feedInValue: 240,\n          feedOutValue: 240,\n          htValue: 240,\n          ntValue: 240\n        }\n      ]\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "message": "Successfully Processed"\n}\n```\n\n</details>\n\n---\n\n### `getAllowedReadingForMeter`\n\nReturns the allowed min/max reading range for each counter of the given meter.\n\n`GET /v1/metering/allowed/reading/{meter_id}`\n\n```ts\nconst { data } = await client.getAllowedReadingForMeter({\n  meter_id: \'example\',\n  timestamp: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": [\n    {\n      "counter_id": "string",\n      "min_value": 0,\n      "max_value": 0\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `createReadingWithMeter`\n\nCreates a meter reading along with meter lookup or creation by MA-LO ID and OBIS number.\n\n`POST /v1/metering/reading/with-meter`\n\n```ts\nconst { data } = await client.createReadingWithMeter(\n  null,\n  {\n    ma_lo_id: \'A09-123\',\n    meter_id: \'string\',\n    obis_number: \'A-34\',\n    unit: \'string\',\n    direction: \'feed-in\',\n    tariff_type: \'ht\',\n    value: 240,\n    read_by: \'John Doe\',\n    reason: \'\',\n    timestamp: \'2022-10-10T10:10:00.000Z\',\n    source: \'ECP\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": {\n    "value": 240,\n    "read_by": "John Doe",\n    "reason": "",\n    "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "direction": "feed-in",\n    "timestamp": "2022-10-10T00:00:00.000Z",\n    "source": "ECP",\n    "status": "valid",\n    "external_id": "string",\n    "remark": "Customer reported unusual consumption",\n    "metadata": {\n      "registration_id": "1234567890",\n      "business_unit": "ABC"\n    },\n    "note": "string",\n    "unit": "string"\n  }\n}\n```\n\n</details>\n\n---\n\n### `getReadingsByInterval`\n\nRetrieves all readings specified in an interval.\nIf the start_date and end_date are equal, then it returns the readings of the specified date.\nThe start_date should be less than or equal to the end_da\n\n`GET /v1/metering/reading/{meter_id}/{counter_id}`\n\n```ts\nconst { data } = await client.getReadingsByInterval({\n  meter_id: \'example\',\n  counter_id: \'example\',\n  start_date: \'example\',\n  end_date: \'example\',\n  direction: \'example\',\n  size: 1,\n  from: 1,\n  type: \'example\',\n  sort: \'example\',\n  include_pending_changesets: true,\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "results": [\n    {\n      "value": 240,\n      "read_by": "John Doe",\n      "reason": "",\n      "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "direction": "feed-in",\n      "timestamp": "2022-10-10T00:00:00.000Z",\n      "source": "ECP",\n      "status": "valid",\n      "external_id": "string",\n      "remark": "Customer reported unusual consumption",\n      "metadata": {\n        "registration_id": "1234567890",\n        "business_unit": "ABC"\n      },\n      "note": "string",\n      "unit": "string"\n    }\n  ],\n  "hits": 120,\n  "firstRecordCreatedAt": "2022-10-01T20:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `updateMeterReading`\n\nUpdates an existing meter reading identified by meter ID, counter ID, and timestamp.\n\n`PUT /v1/metering/reading/{meter_id}/{counter_id}`\n\n```ts\nconst { data } = await client.updateMeterReading(\n  {\n    meter_id: \'example\',\n    counter_id: \'example\',\n    timestamp: \'example\',\n  },\n  {\n    value: 240,\n    read_by: \'John Doe\',\n    reason: \'string\',\n    meter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n    counter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n    direction: \'feed-in\',\n    timestamp: \'2022-10-10T00:00:00.000Z\',\n    source: \'ECP\',\n    status: \'valid\',\n    external_id: \'string\',\n    remark: \'Customer reported unusual consumption\',\n    metadata: {\n      registration_id: \'1234567890\',\n      business_unit: \'ABC\'\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": {\n    "value": 240,\n    "read_by": "John Doe",\n    "reason": "",\n    "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "direction": "feed-in",\n    "timestamp": "2022-10-10T00:00:00.000Z",\n    "source": "ECP",\n    "status": "valid",\n    "external_id": "string",\n    "remark": "Customer reported unusual consumption",\n    "metadata": {\n      "registration_id": "1234567890",\n      "business_unit": "ABC"\n    },\n    "note": "string",\n    "unit": "string"\n  }\n}\n```\n\n</details>\n\n---\n\n### `deleteMeterReading`\n\nPermanently deletes a meter reading identified by meter ID, counter ID, and timestamp.\n\n`DELETE /v1/metering/reading/{meter_id}/{counter_id}`\n\n```ts\nconst { data } = await client.deleteMeterReading({\n  meter_id: \'example\',\n  counter_id: \'example\',\n  timestamp: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": {\n    "meterId": "string",\n    "counterId": "string",\n    "timestamp": "2022-10-01T20:00:00.000Z"\n  }\n}\n```\n\n</details>\n\n---\n\n### `getReadingChangesets`\n\nList pending reading changesets for a counter\n\n`GET /v1/metering/reading/{meter_id}/{counter_id}/changesets`\n\n```ts\nconst { data } = await client.getReadingChangesets({\n  meter_id: \'example\',\n  counter_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "changesets": [\n    {\n      "changeset_id": "string",\n      "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "proposed": {\n        "value": 0,\n        "direction": "feed-in",\n        "timestamp": "1970-01-01T00:00:00.000Z",\n        "reason": "string",\n        "remark": "string",\n        "read_by": "string",\n        "status": "valid",\n        "external_id": "string"\n      },\n      "previous": {\n        "value": 0,\n        "direction": "feed-in",\n        "timestamp": "1970-01-01T00:00:00.000Z",\n        "reason": "string",\n        "remark": "string",\n        "read_by": "string",\n        "status": "valid",\n        "external_id": "string"\n      },\n      "edit_mode": "external",\n      "match_strategy": "exact",\n      "timestamp_tolerance": "exact",\n      "created_at": "1970-01-01T00:00:00.000Z",\n      "created_by": {\n        "type": "user",\n        "id": "string"\n      },\n      "source": "360",\n      "fuzzy_config": {\n        "percentage_threshold": 0.01,\n        "absolute_threshold": 0\n      },\n      "dismissed_reason": "string",\n      "dismissed_at": "1970-01-01T00:00:00.000Z"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `applyReadingChangeset`\n\nApply (approve) a pending reading changeset\n\n`POST /v1/metering/reading/{meter_id}/{counter_id}/changesets/{changeset_id}:apply`\n\n```ts\nconst { data } = await client.applyReadingChangeset({\n  meter_id: \'example\',\n  counter_id: \'example\',\n  changeset_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "reading": {\n    "value": 240,\n    "read_by": "John Doe",\n    "reason": "",\n    "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "direction": "feed-in",\n    "timestamp": "2022-10-10T00:00:00.000Z",\n    "source": "ECP",\n    "status": "valid",\n    "external_id": "string",\n    "remark": "Customer reported unusual consumption",\n    "metadata": {\n      "registration_id": "1234567890",\n      "business_unit": "ABC"\n    },\n    "note": "string",\n    "unit": "string"\n  },\n  "changeset": {\n    "changeset_id": "string",\n    "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "proposed": {\n      "value": 0,\n      "direction": "feed-in",\n      "timestamp": "1970-01-01T00:00:00.000Z",\n      "reason": "string",\n      "remark": "string",\n      "read_by": "string",\n      "status": "valid",\n      "external_id": "string"\n    },\n    "previous": {\n      "value": 0,\n      "direction": "feed-in",\n      "timestamp": "1970-01-01T00:00:00.000Z",\n      "reason": "string",\n      "remark": "string",\n      "read_by": "string",\n      "status": "valid",\n      "external_id": "string"\n    },\n    "edit_mode": "external",\n    "match_strategy": "exact",\n    "timestamp_tolerance": "exact",\n    "created_at": "1970-01-01T00:00:00.000Z",\n    "created_by": {\n      "type": "user",\n      "id": "string"\n    },\n    "source": "360",\n    "fuzzy_config": {\n      "percentage_threshold": 0.01,\n      "absolute_threshold": 0\n    },\n    "dismissed_reason": "string",\n    "dismissed_at": "1970-01-01T00:00:00.000Z"\n  }\n}\n```\n\n</details>\n\n---\n\n### `dismissReadingChangeset`\n\nDismiss (reject) a pending reading changeset\n\n`POST /v1/metering/reading/{meter_id}/{counter_id}/changesets/{changeset_id}:dismiss`\n\n```ts\nconst { data } = await client.dismissReadingChangeset(\n  {\n    meter_id: \'example\',\n    counter_id: \'example\',\n    changeset_id: \'example\',\n  },\n  {\n    reason: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "changeset_id": "string",\n  "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n  "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n  "proposed": {\n    "value": 0,\n    "direction": "feed-in",\n    "timestamp": "1970-01-01T00:00:00.000Z",\n    "reason": "string",\n    "remark": "string",\n    "read_by": "string",\n    "status": "valid",\n    "external_id": "string"\n  },\n  "previous": {\n    "value": 0,\n    "direction": "feed-in",\n    "timestamp": "1970-01-01T00:00:00.000Z",\n    "reason": "string",\n    "remark": "string",\n    "read_by": "string",\n    "status": "valid",\n    "external_id": "string"\n  },\n  "edit_mode": "external",\n  "match_strategy": "exact",\n  "timestamp_tolerance": "exact",\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "created_by": {\n    "type": "user",\n    "id": "string"\n  },\n  "source": "360",\n  "fuzzy_config": {\n    "percentage_threshold": 0.01,\n    "absolute_threshold": 0\n  },\n  "dismissed_reason": "string",\n  "dismissed_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `updateReadingChangeset`\n\nEdit a pending reading changeset\n\n`PATCH /v1/metering/reading/{meter_id}/{counter_id}/changesets/{changeset_id}`\n\n```ts\nconst { data } = await client.updateReadingChangeset(\n  {\n    meter_id: \'example\',\n    counter_id: \'example\',\n    changeset_id: \'example\',\n  },\n  {\n    proposed: {\n      value: 0,\n      direction: \'feed-in\',\n      timestamp: \'1970-01-01T00:00:00.000Z\',\n      reason: \'string\',\n      remark: \'string\',\n      read_by: \'string\',\n      status: \'valid\',\n      external_id: \'string\'\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "changeset_id": "string",\n  "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n  "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n  "proposed": {\n    "value": 0,\n    "direction": "feed-in",\n    "timestamp": "1970-01-01T00:00:00.000Z",\n    "reason": "string",\n    "remark": "string",\n    "read_by": "string",\n    "status": "valid",\n    "external_id": "string"\n  },\n  "previous": {\n    "value": 0,\n    "direction": "feed-in",\n    "timestamp": "1970-01-01T00:00:00.000Z",\n    "reason": "string",\n    "remark": "string",\n    "read_by": "string",\n    "status": "valid",\n    "external_id": "string"\n  },\n  "edit_mode": "external",\n  "match_strategy": "exact",\n  "timestamp_tolerance": "exact",\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "created_by": {\n    "type": "user",\n    "id": "string"\n  },\n  "source": "360",\n  "fuzzy_config": {\n    "percentage_threshold": 0.01,\n    "absolute_threshold": 0\n  },\n  "dismissed_reason": "string",\n  "dismissed_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n## Schemas\n\n### `ErrorResp`\n\n```ts\ntype ErrorResp = {\n  message?: string\n}\n```\n\n### `EntityId`\n\n```ts\ntype EntityId = string // uuid\n```\n\n### `EntitySlug`\n\nURL-friendly identifier for the entity schema\n\n```ts\ntype EntitySlug = string\n```\n\n### `BaseEntity`\n\n```ts\ntype BaseEntity = {\n  _id: string // uuid\n  _title: string\n  _org: string\n  _tags?: string[]\n  _created_at: string // date-time\n  _updated_at: string // date-time\n}\n```\n\n### `Entity`\n\n```ts\ntype Entity = Record<string, unknown>\n```\n\n### `EntityItem`\n\n```ts\ntype EntityItem = {\n  _id: string // uuid\n  _title: string\n  _org: string\n  _tags?: string[]\n  _created_at: string // date-time\n  _updated_at: string // date-time\n}\n```\n\n### `Id`\n\n```ts\ntype Id = string\n```\n\n### `EntityRelation`\n\n```ts\ntype EntityRelation = {\n  entity_id?: string // uuid\n  _slug?: "contact" | "contract"\n}\n```\n\n### `Meter`\n\n```ts\ntype Meter = {\n  _id: string // uuid\n  _title: string\n  _org: string\n  _tags?: string[]\n  _created_at: string // date-time\n  _updated_at: string // date-time\n  _schema: "meter"\n  ma_lo_id?: string\n  status?: "active" | "decommissioned"\n  meter_type?: "three-phase-meter" | "bellow-gas-meter" | "rotary-piston-meter" | "smart-meter" | "performance-meter" | "maximum-meter" | "turbine-gas-meter" | "ultrasonic-gas-meter" | "alternating-current-meter" | "modern-metering-system" | "intelligent-measuring-system" | "electronic-meter"\n  tariff_type?: string\n  meter_number?: string\n  sector?: "power" | "water" | "gas" | "district_heating" | "waste_water"\n  location?: object\n  used_for?: string\n  manufacturer?: string\n  calibration_date?: string\n  contract?: {\n    $relation?: Array<{\n      entity_id?: { ... }\n      _slug?: { ... }\n    }>\n  }\n  customer?: {\n    $relation?: Array<{\n      entity_id?: { ... }\n      _slug?: { ... }\n    }>\n  }\n}\n```\n\n### `Direction`\n\n```ts\ntype Direction = "feed-in" | "feed-out"\n```\n\n### `TariffType`\n\n```ts\ntype TariffType = "ht" | "nt"\n```\n\n### `Reason`\n\nThe reason for recording the reading\nIf no reason is specified or left empty, the Epilot UI will show \'Regular\' as the default display text\n\n\n```ts\ntype Reason = "" | "regular" | "irregular" | "last" | "first" | "meter_change" | "contract_change" | "meter_adjustment"\n```\n\n### `ReasonString`\n\nThis field is deprecated. Please use the Reason enum instead.\n\n\n```ts\ntype ReasonString = string\n```\n\n### `ReadBy`\n\nThe person who recorded the reading\n\n```ts\ntype ReadBy = string\n```\n\n### `ReadingStatus`\n\n```ts\ntype ReadingStatus = "valid" | "in-validation" | "implausible" | null | ""\n```\n\n### `Reading`\n\n```ts\ntype Reading = {\n  value: number\n  read_by?: string\n  reason?: "" | "regular" | "irregular" | "last" | "first" | "meter_change" | "contract_change" | "meter_adjustment"\n  meter_id?: string // uuid\n  counter_id?: string // uuid\n  direction?: "feed-in" | "feed-out"\n  timestamp?: string // date-time\n  source: "ECP" | "ERP" | "360" | "journey-submission"\n  status?: "valid" | "in-validation" | "implausible" | null | ""\n  external_id?: string\n  remark?: string\n  metadata?: Record<string, string>\n  note?: string\n  unit?: string\n}\n```\n\n### `MeterReading`\n\n```ts\ntype MeterReading = {\n  value: number\n  read_by?: string\n  reason?: "" | "regular" | "irregular" | "last" | "first" | "meter_change" | "contract_change" | "meter_adjustment"\n  meter_id: string // uuid\n  counter_id?: string // uuid\n  direction?: "feed-in" | "feed-out"\n  timestamp?: string // date-time\n  source: "ECP" | "ERP" | "360" | "journey-submission"\n  status?: "valid" | "in-validation" | "implausible" | null | ""\n  external_id?: string\n  remark?: string\n  metadata?: Record<string, string>\n  note?: string\n  unit?: string\n}\n```\n\n### `PortalMeterReading`\n\n```ts\ntype PortalMeterReading = {\n  value: number\n  read_by?: string\n  reason?: "" | "regular" | "irregular" | "last" | "first" | "meter_change" | "contract_change" | "meter_adjustment"\n  meter_id?: string // uuid\n  counter_id: string // uuid\n  direction?: "feed-in" | "feed-out"\n  timestamp?: string // date-time\n  source: "ECP" | "ERP" | "360" | "journey-submission"\n  status?: "valid" | "in-validation" | "implausible" | null | ""\n  external_id?: string\n  remark?: string\n  metadata?: Record<string, string>\n  note?: string\n  unit?: string\n}\n```\n\n### `BatchReadingBase`\n\nBase properties shared by all batch reading operations\n\n```ts\ntype BatchReadingBase = {\n  meter_id?: string // uuid\n  counter_id?: string // uuid\n  direction?: "feed-in" | "feed-out"\n  timestamp?: string // date-time\n  external_id?: string\n  metadata?: Record<string, string>\n}\n```\n\n### `CreateOrUpdateBatchReading`\n\nSchema for create or update operations - requires value, source, and meter_id\n\n```ts\ntype CreateOrUpdateBatchReading = {\n  meter_id: string // uuid\n  counter_id?: string // uuid\n  direction?: "feed-in" | "feed-out"\n  timestamp?: string // date-time\n  external_id?: string\n  metadata?: Record<string, string>\n  operation?: "create" | "update"\n  value: number\n  source: "ECP" | "ERP" | "360" | "journey-submission"\n  read_by?: string\n  reason?: "" | "regular" | "irregular" | "last" | "first" | "meter_change" | "contract_change" | "meter_adjustment"\n  status?: "valid" | "in-validation" | "implausible" | null | ""\n  remark?: string\n  note?: string\n  unit?: string\n}\n```\n\n### `DeleteBatchReading`\n\nSchema for delete operations - only requires identifier fields specified in the identifiers parameter\n\n```ts\ntype DeleteBatchReading = {\n  meter_id?: string // uuid\n  counter_id?: string // uuid\n  direction?: "feed-in" | "feed-out"\n  timestamp?: string // date-time\n  external_id?: string\n  metadata?: Record<string, string>\n  operation: "delete"\n}\n```\n\n### `BatchReading`\n\nA meter reading for batch operations. The required fields depend on the operation:\n- create/update: requires value, source, and meter_id\n- delete: only requires the fields specified in the identifiers parameter\n\n\n```ts\ntype BatchReading = {\n  meter_id: string // uuid\n  counter_id?: string // uuid\n  direction?: "feed-in" | "feed-out"\n  timestamp?: string // date-time\n  external_id?: string\n  metadata?: Record<string, string>\n  operation?: "create" | "update"\n  value: number\n  source: "ECP" | "ERP" | "360" | "journey-submission"\n  read_by?: string\n  reason?: "" | "regular" | "irregular" | "last" | "first" | "meter_change" | "contract_change" | "meter_adjustment"\n  status?: "valid" | "in-validation" | "implausible" | null | ""\n  remark?: string\n  note?: string\n  unit?: string\n} | {\n  meter_id?: string // uuid\n  counter_id?: string // uuid\n  direction?: "feed-in" | "feed-out"\n  timestamp?: string // date-time\n  external_id?: string\n  metadata?: Record<string, string>\n  operation: "delete"\n}\n```\n\n### `UpdateMeterReading`\n\n```ts\ntype UpdateMeterReading = {\n  value: number\n  read_by?: string\n  reason?: string\n  meter_id: string // uuid\n  counter_id?: string // uuid\n  direction?: "feed-in" | "feed-out"\n  timestamp?: string // date-time\n  source: "ECP" | "ERP" | "360" | "journey-submission"\n  status?: "valid" | "in-validation" | "implausible" | null | ""\n  external_id?: string\n  remark?: string\n  metadata?: Record<string, string>\n}\n```\n\n### `MeterCounter`\n\n```ts\ntype MeterCounter = {\n  _id: string // uuid\n  _title: string\n  _org: string\n  _tags?: string[]\n  _created_at: string // date-time\n  _updated_at: string // date-time\n  _schema: "meter_counter"\n  obis_number?: string\n  direction?: "feed-in" | "feed-out"\n  transformer_ratio?: number\n  unit?: string\n  forecast_reading_value?: string\n  forecast_as_of?: string\n  current_consumption?: number\n  last_reading?: string\n  conversion_factor?: number\n  tariff_type?: "ht" | "nt"\n}\n```\n\n### `CounterReadingOnSubmission`\n\n```ts\ntype CounterReadingOnSubmission = {\n  counterId: string\n  direction: "feed-in" | "feed-out"\n  unit?: string\n  value: number\n}\n```\n\n### `SubmissionMeterReading`\n\n```ts\ntype SubmissionMeterReading = {\n  meterId: string\n  readings?: Array<{\n    counterId: string\n    direction: "feed-in" | "feed-out"\n    unit?: string\n    value: number\n  }>\n  readingValue?: number\n  readingDate?: string\n  readBy?: string\n  reason?: "" | "regular" | "irregular" | "last" | "first" | "meter_change" | "contract_change" | "meter_adjustment"\n  maloId?: string\n  obisNumber?: string\n  readingUnit?: string\n  meterType?: "one_tariff" | "two_tariff" | "bi_directional"\n  feedInValue?: number\n  feedOutValue?: number\n  htValue?: number\n  ntValue?: number\n}\n```\n\n### `Unit`\n\n```ts\ntype Unit = string\n```\n\n### `Source`\n\n```ts\ntype Source = "ECP" | "ERP" | "360" | "journey-submission"\n```\n\n### `ActionLabel`\n\n```ts\ntype ActionLabel = {\n  en?: string\n  de?: string\n}\n```\n\n### `Rule`\n\n```ts\ntype Rule = {\n  entity?: string\n  attribute?: string\n  attribute_value?: string\n}\n```\n\n### `JourneyActions`\n\n```ts\ntype JourneyActions = {\n  journey_id?: string\n  action_label?: {\n    en?: string\n    de?: string\n  }\n  slug?: string\n  rules?: Array<{\n    entity?: string\n    attribute?: string\n    attribute_value?: string\n  }>\n}\n```\n\n### `ReadingWithMeter`\n\n```ts\ntype ReadingWithMeter = {\n  ma_lo_id?: string\n  meter_id?: string\n  obis_number?: string\n  unit?: string\n  direction?: "feed-in" | "feed-out"\n  tariff_type?: "ht" | "nt"\n  value?: number\n  read_by?: string\n  reason?: "" | "regular" | "irregular" | "last" | "first" | "meter_change" | "contract_change" | "meter_adjustment"\n  timestamp?: string\n  source?: "ECP" | "ERP" | "360" | "journey-submission"\n}\n```\n\n### `MeterReadingChangeset`\n\n```ts\ntype MeterReadingChangeset = {\n  changeset_id: string\n  meter_id?: string // uuid\n  counter_id?: string // uuid\n  proposed: {\n    value: number\n    direction?: "feed-in" | "feed-out"\n    timestamp?: string // date-time\n    reason?: string\n    remark?: string\n    read_by?: string\n    status?: "valid" | "in-validation" | "implausible"\n    external_id?: string\n  }\n  previous?: {\n    value: number\n    direction?: "feed-in" | "feed-out"\n    timestamp?: string // date-time\n    reason?: string\n    remark?: string\n    read_by?: string\n    status?: "valid" | "in-validation" | "implausible"\n    external_id?: string\n  }\n  edit_mode: "external" | "approval"\n  match_strategy?: "exact" | "fuzzy"\n  timestamp_tolerance?: "exact" | {\n    type: "same-day"\n    timezone?: string\n  } | {\n    type: "within-seconds"\n    seconds: number\n  }\n  created_at: string // date-time\n  created_by?: {\n    type?: "user" | "portal_user" | "api_client" | "automation"\n    id?: string\n  }\n  source?: "360" | "ECP" | "ERP" | "journey-submission"\n  fuzzy_config?: {\n    percentage_threshold?: number\n    absolute_threshold?: number\n  }\n  dismissed_reason?: string\n  dismissed_at?: string // date-time\n}\n```\n\n### `FuzzyConfig`\n\nNumeric-threshold fuzzy matching for meter reading auto-clear.\n\nNOTE: This is intentionally different from entity-api\'s FuzzyConfig. Entity-api\'s\nfuzzy strategies (suffix, digits_only, normalize_phone, ignore_fields,\ncontains_entry, regex) are designed for strings and structured objects (IBAN, phone\n\n```ts\ntype FuzzyConfig = {\n  percentage_threshold?: number\n  absolute_threshold?: number\n}\n```\n\n### `ProposedReading`\n\n```ts\ntype ProposedReading = {\n  value: number\n  direction?: "feed-in" | "feed-out"\n  timestamp?: string // date-time\n  reason?: string\n  remark?: string\n  read_by?: string\n  status?: "valid" | "in-validation" | "implausible"\n  external_id?: string\n}\n```\n\n### `ChangesetCreator`\n\n```ts\ntype ChangesetCreator = {\n  type?: "user" | "portal_user" | "api_client" | "automation"\n  id?: string\n}\n```\n\n### `TimestampTolerance`\n\nSlack on `reading.timestamp` when auto-clear matches an incoming reading\nagainst a pending changeset. Both sides reference the SAME physical\nmeter-read event \u2014 one as stored when the user submitted, the other as\nechoed back by the ERP. The tolerance accommodates round-trip format\ndrift between the t\n\n```ts\ntype TimestampTolerance = "exact" | {\n  type: "same-day"\n  timezone?: string\n} | {\n  type: "within-seconds"\n  seconds: number\n}\n```\n\n### `ActivityId`\n\nSee https://github.com/ulid/spec\n\n```ts\ntype ActivityId = string // ulid\n```\n';
-
-
-exports.default = metering_default;

package/dist/metering-7T6NJRHT.js

@@ -1,7 +0,0 @@
-import "./chunk-YPSWSI3M.js";
-
-// src/docs/metering.json
-var metering_default = '# Metering API\n\n- **Base URL:** `https://metering.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/metering](https://docs.epilot.io/api/metering)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.metering.getCustomerMeters(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/metering\'\n\nconst meteringClient = getClient()\nauthorize(meteringClient, () => \'<token>\')\nconst { data } = await meteringClient.getCustomerMeters(...)\n```\n\n## Operations\n\n**ECP**\n- [`getCustomerMeters`](#getcustomermeters)\n- [`getMetersByContractId`](#getmetersbycontractid)\n- [`updateMeter`](#updatemeter)\n- [`getMeter`](#getmeter)\n- [`getMeterCounters`](#getmetercounters)\n- [`getCounterDetails`](#getcounterdetails)\n- [`createPortalMeterReadings`](#createportalmeterreadings)\n\n**ECP Admin**\n- [`createMeterReading`](#createmeterreading)\n- [`createMeterReadings`](#createmeterreadings)\n- [`batchWriteMeterReadings`](#batchwritemeterreadings)\n- [`createMeterReadingFromSubmission`](#createmeterreadingfromsubmission)\n- [`getAllowedReadingForMeter`](#getallowedreadingformeter)\n- [`createReadingWithMeter`](#createreadingwithmeter)\n- [`getReadingsByInterval`](#getreadingsbyinterval)\n- [`updateMeterReading`](#updatemeterreading)\n- [`deleteMeterReading`](#deletemeterreading)\n\n**Metering**\n- [`getReadingChangesets`](#getreadingchangesets)\n- [`applyReadingChangeset`](#applyreadingchangeset)\n- [`dismissReadingChangeset`](#dismissreadingchangeset)\n- [`updateReadingChangeset`](#updatereadingchangeset)\n\n**Schemas**\n- [`ErrorResp`](#errorresp)\n- [`EntityId`](#entityid)\n- [`EntitySlug`](#entityslug)\n- [`BaseEntity`](#baseentity)\n- [`Entity`](#entity)\n- [`EntityItem`](#entityitem)\n- [`Id`](#id)\n- [`EntityRelation`](#entityrelation)\n- [`Meter`](#meter)\n- [`Direction`](#direction)\n- [`TariffType`](#tarifftype)\n- [`Reason`](#reason)\n- [`ReasonString`](#reasonstring)\n- [`ReadBy`](#readby)\n- [`ReadingStatus`](#readingstatus)\n- [`Reading`](#reading)\n- [`MeterReading`](#meterreading)\n- [`PortalMeterReading`](#portalmeterreading)\n- [`BatchReadingBase`](#batchreadingbase)\n- [`CreateOrUpdateBatchReading`](#createorupdatebatchreading)\n- [`DeleteBatchReading`](#deletebatchreading)\n- [`BatchReading`](#batchreading)\n- [`UpdateMeterReading`](#updatemeterreading)\n- [`MeterCounter`](#metercounter)\n- [`CounterReadingOnSubmission`](#counterreadingonsubmission)\n- [`SubmissionMeterReading`](#submissionmeterreading)\n- [`Unit`](#unit)\n- [`Source`](#source)\n- [`ActionLabel`](#actionlabel)\n- [`Rule`](#rule)\n- [`JourneyActions`](#journeyactions)\n- [`ReadingWithMeter`](#readingwithmeter)\n- [`MeterReadingChangeset`](#meterreadingchangeset)\n- [`FuzzyConfig`](#fuzzyconfig)\n- [`ProposedReading`](#proposedreading)\n- [`ChangesetCreator`](#changesetcreator)\n- [`TimestampTolerance`](#timestamptolerance)\n- [`ActivityId`](#activityid)\n\n### `getCustomerMeters`\n\nRetrieves all meters associated with the authenticated portal customer.\n\n`GET /v1/metering/meter`\n\n```ts\nconst { data } = await client.getCustomerMeters({\n  include_pending_changesets: true,\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": [\n    {\n      "_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "_title": "Example Entity",\n      "_org": "123",\n      "_tags": ["example", "mock"],\n      "_created_at": "2021-02-09T12:41:43.662Z",\n      "_updated_at": "2021-02-09T12:41:43.662Z",\n      "_schema": "meter",\n      "ma_lo_id": "A09-123",\n      "status": "active",\n      "meter_type": "three-phase-meter",\n      "tariff_type": "Peak load tariff",\n      "meter_number": "J-1093-1AK",\n      "sector": "power",\n      "location": [\n        {\n          "country": "Germany",\n          "city": "Koln",\n          "postal_code": 81475,\n          "street": "Melateng\xFCrtel",\n          "street_number": 71,\n          "additional_info": "5. Etage",\n          "_tags": ["billing", "delivery"]\n        }\n      ],\n      "used_for": "Domestic Usage",\n      "manufacturer": "Energy One",\n      "calibration_date": "2022-10-10T00:00:00.000Z",\n      "contract": {\n        "$relation": [\n          {\n            "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n            "_slug": "contact"\n          }\n        ]\n      },\n      "customer": {\n        "$relation": [\n          {\n            "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n            "_slug": "contact"\n          }\n        ]\n      },\n      "journey_actions": {\n        "journey_id": "string",\n        "action_label": {\n          "en": "string",\n          "de": "string"\n        },\n        "slug": "string",\n        "rules": [\n          {\n            "entity": "string",\n            "attribute": "string",\n            "attribute_value": "string"\n          }\n        ]\n      },\n      "last_reading": "2022-10-10T00:00:00.000Z",\n      "current_consumption": 100.5\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getMetersByContractId`\n\nRetrieves all meters associated with a given contract entity.\n\n`GET /v1/metering/contract/meters/{contract_id}`\n\n```ts\nconst { data } = await client.getMetersByContractId({\n  contract_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": [\n    {\n      "_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "_title": "Example Entity",\n      "_org": "123",\n      "_tags": ["example", "mock"],\n      "_created_at": "2021-02-09T12:41:43.662Z",\n      "_updated_at": "2021-02-09T12:41:43.662Z",\n      "_schema": "meter",\n      "ma_lo_id": "A09-123",\n      "status": "active",\n      "meter_type": "three-phase-meter",\n      "tariff_type": "Peak load tariff",\n      "meter_number": "J-1093-1AK",\n      "sector": "power",\n      "location": [\n        {\n          "country": "Germany",\n          "city": "Koln",\n          "postal_code": 81475,\n          "street": "Melateng\xFCrtel",\n          "street_number": 71,\n          "additional_info": "5. Etage",\n          "_tags": ["billing", "delivery"]\n        }\n      ],\n      "used_for": "Domestic Usage",\n      "manufacturer": "Energy One",\n      "calibration_date": "2022-10-10T00:00:00.000Z",\n      "contract": {\n        "$relation": [\n          {\n            "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n            "_slug": "contact"\n          }\n        ]\n      },\n      "customer": {\n        "$relation": [\n          {\n            "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n            "_slug": "contact"\n          }\n        ]\n      }\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `updateMeter`\n\nPartially updates the details of a meter entity by ID.\n\n`PATCH /v1/metering/meter/{id}`\n\n```ts\nconst { data } = await client.updateMeter(\n  {\n    id: \'123e4567-e89b-12d3-a456-426614174000\',\n  },\n  {},\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": {\n    "_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "_title": "Example Entity",\n    "_org": "123",\n    "_tags": ["example", "mock"],\n    "_created_at": "2021-02-09T12:41:43.662Z",\n    "_updated_at": "2021-02-09T12:41:43.662Z",\n    "_schema": "meter",\n    "ma_lo_id": "A09-123",\n    "status": "active",\n    "meter_type": "three-phase-meter",\n    "tariff_type": "Peak load tariff",\n    "meter_number": "J-1093-1AK",\n    "sector": "power",\n    "location": [\n      {\n        "country": "Germany",\n        "city": "Koln",\n        "postal_code": 81475,\n        "street": "Melateng\xFCrtel",\n        "street_number": 71,\n        "additional_info": "5. Etage",\n        "_tags": ["billing", "delivery"]\n      }\n    ],\n    "used_for": "Domestic Usage",\n    "manufacturer": "Energy One",\n    "calibration_date": "2022-10-10T00:00:00.000Z",\n    "contract": {\n      "$relation": [\n        {\n          "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n          "_slug": "contact"\n        }\n      ]\n    },\n    "customer": {\n      "$relation": [\n        {\n          "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n          "_slug": "contact"\n        }\n      ]\n    }\n  }\n}\n```\n\n</details>\n\n---\n\n### `getMeter`\n\nRetrieves the full details of a specific meter by ID, including related entities and available journey actions.\n\n`GET /v1/metering/meter/{id}`\n\n```ts\nconst { data } = await client.getMeter({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": {\n    "entity": {\n      "_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "_title": "Example Entity",\n      "_org": "123",\n      "_tags": ["example", "mock"],\n      "_created_at": "2021-02-09T12:41:43.662Z",\n      "_updated_at": "2021-02-09T12:41:43.662Z",\n      "_schema": "meter",\n      "ma_lo_id": "A09-123",\n      "status": "active",\n      "meter_type": "three-phase-meter",\n      "tariff_type": "Peak load tariff",\n      "meter_number": "J-1093-1AK",\n      "sector": "power",\n      "location": [\n        {\n          "country": "Germany",\n          "city": "Koln",\n          "postal_code": 81475,\n          "street": "Melateng\xFCrtel",\n          "street_number": 71,\n          "additional_info": "5. Etage",\n          "_tags": ["billing", "delivery"]\n        }\n      ],\n      "used_for": "Domestic Usage",\n      "manufacturer": "Energy One",\n      "calibration_date": "2022-10-10T00:00:00.000Z",\n      "contract": {\n        "$relation": [\n          {\n            "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n            "_slug": "contact"\n          }\n        ]\n      },\n      "customer": {\n        "$relation": [\n          {\n            "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n            "_slug": "contact"\n          }\n        ]\n      }\n    },\n    "journey_actions": {\n      "journey_id": "string",\n      "action_label": {\n        "en": "string",\n        "de": "string"\n      },\n      "slug": "string",\n      "rules": [\n        {\n          "entity": "string",\n          "attribute": "string",\n          "attribute_value": "string"\n        }\n      ]\n    },\n    "relations": [\n      {\n        "_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n        "_title": "Example Entity",\n        "_org": "123",\n        "_tags": ["example", "mock"],\n        "_created_at": "2021-02-09T12:41:43.662Z",\n        "_updated_at": "2021-02-09T12:41:43.662Z"\n      }\n    ]\n  }\n}\n```\n\n</details>\n\n---\n\n### `getMeterCounters`\n\nRetrieves all meter counters associated with a given meter.\n\n`GET /v1/metering/counter`\n\n```ts\nconst { data } = await client.getMeterCounters({\n  meter_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": [\n    {\n      "_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "_title": "Example Entity",\n      "_org": "123",\n      "_tags": ["example", "mock"],\n      "_created_at": "2021-02-09T12:41:43.662Z",\n      "_updated_at": "2021-02-09T12:41:43.662Z",\n      "_schema": "meter_counter",\n      "obis_number": "A-34",\n      "direction": "feed-in",\n      "transformer_ratio": 70,\n      "unit": "string",\n      "forecast_reading_value": 270,\n      "forecast_as_of": "2022-12-10T00:00:00.000Z",\n      "current_consumption": 240,\n      "last_reading": "2022-10-10T00:00:00.000Z",\n      "conversion_factor": 3,\n      "tariff_type": "ht"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getCounterDetails`\n\nRetrieves the full details of a single meter counter by its ID.\n\n`GET /v1/metering/counter/{counter_id}`\n\n```ts\nconst { data } = await client.getCounterDetails({\n  counter_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": {\n    "_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "_title": "Example Entity",\n    "_org": "123",\n    "_tags": ["example", "mock"],\n    "_created_at": "2021-02-09T12:41:43.662Z",\n    "_updated_at": "2021-02-09T12:41:43.662Z",\n    "_schema": "meter_counter",\n    "obis_number": "A-34",\n    "direction": "feed-in",\n    "transformer_ratio": 70,\n    "unit": "string",\n    "forecast_reading_value": 270,\n    "forecast_as_of": "2022-12-10T00:00:00.000Z",\n    "current_consumption": 240,\n    "last_reading": "2022-10-10T00:00:00.000Z",\n    "conversion_factor": 3,\n    "tariff_type": "ht"\n  }\n}\n```\n\n</details>\n\n---\n\n### `createMeterReading`\n\nInserts a new meter reading.\n\n`POST /v1/metering/reading`\n\n```ts\nconst { data } = await client.createMeterReading(\n  {\n    direct: true,\n  },\n  {\n    value: 240,\n    read_by: \'John Doe\',\n    reason: \'\',\n    meter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n    counter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n    direction: \'feed-in\',\n    timestamp: \'2022-10-10T00:00:00.000Z\',\n    source: \'ECP\',\n    status: \'valid\',\n    external_id: \'string\',\n    remark: \'Customer reported unusual consumption\',\n    metadata: {\n      registration_id: \'1234567890\',\n      business_unit: \'ABC\'\n    },\n    note: \'string\',\n    unit: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": {\n    "value": 240,\n    "read_by": "John Doe",\n    "reason": "",\n    "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "direction": "feed-in",\n    "timestamp": "2022-10-10T00:00:00.000Z",\n    "source": "ECP",\n    "status": "valid",\n    "external_id": "string",\n    "remark": "Customer reported unusual consumption",\n    "metadata": {\n      "registration_id": "1234567890",\n      "business_unit": "ABC"\n    },\n    "note": "string",\n    "unit": "string"\n  }\n}\n```\n\n</details>\n\n---\n\n### `createMeterReadings`\n\nInserts multiple meter readings at once. Limited to 100 readings per request.\n\n`POST /v1/metering/readings`\n\n```ts\nconst { data } = await client.createMeterReadings(\n  {\n    async: true,\n    activity_id: \'example\',\n    skip_validation: true,\n    direct: true,\n    create_ticket: true,\n  },\n  {\n    readings: [\n      {\n        value: 240,\n        read_by: \'John Doe\',\n        reason: \'\',\n        meter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n        counter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n        direction: \'feed-in\',\n        timestamp: \'2022-10-10T00:00:00.000Z\',\n        source: \'ECP\',\n        status: \'valid\',\n        external_id: \'string\',\n        remark: \'Customer reported unusual consumption\',\n        metadata: {\n          registration_id: \'1234567890\',\n          business_unit: \'ABC\'\n        },\n        note: \'string\',\n        unit: \'string\'\n      }\n    ]\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": [\n    {\n      "value": 240,\n      "read_by": "John Doe",\n      "reason": "",\n      "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "direction": "feed-in",\n      "timestamp": "2022-10-10T00:00:00.000Z",\n      "source": "ECP",\n      "status": "valid",\n      "external_id": "string",\n      "remark": "Customer reported unusual consumption",\n      "metadata": {\n        "registration_id": "1234567890",\n        "business_unit": "ABC"\n      },\n      "note": "string",\n      "unit": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `createPortalMeterReadings`\n\nInserts multiple meter readings at once for a given meter via the end customer portal.\nLimited to 100 readings per request.\n\n`POST /v1/metering/readings/{meter_id}`\n\n```ts\nconst { data } = await client.createPortalMeterReadings(\n  {\n    meter_id: \'example\',\n    direct: true,\n  },\n  {\n    readings: [\n      {\n        value: 240,\n        read_by: \'John Doe\',\n        reason: \'\',\n        meter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n        counter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n        direction: \'feed-in\',\n        timestamp: \'2022-10-10T00:00:00.000Z\',\n        source: \'ECP\',\n        status: \'valid\',\n        external_id: \'string\',\n        remark: \'Customer reported unusual consumption\',\n        metadata: {\n          registration_id: \'1234567890\',\n          business_unit: \'ABC\'\n        },\n        note: \'string\',\n        unit: \'string\'\n      }\n    ]\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": [\n    {\n      "value": 240,\n      "read_by": "John Doe",\n      "reason": "",\n      "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "direction": "feed-in",\n      "timestamp": "2022-10-10T00:00:00.000Z",\n      "source": "ECP",\n      "status": "valid",\n      "external_id": "string",\n      "remark": "Customer reported unusual consumption",\n      "metadata": {\n        "registration_id": "1234567890",\n        "business_unit": "ABC"\n      },\n      "note": "string",\n      "unit": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `batchWriteMeterReadings`\n\nUpserts or deletes multiple meter readings at once. Limited to 100 readings per request.\n\n`POST /v2/metering/readings`\n\n```ts\nconst { data } = await client.batchWriteMeterReadings(\n  {\n    async: true,\n    skip_validation: true,\n    activity_id: \'example\',\n    direct: true,\n    create_ticket: true,\n  },\n  {\n    identifiers: [\'string\'],\n    readings: [\n      {\n        meter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n        counter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n        direction: \'feed-in\',\n        timestamp: \'2022-10-10T10:00:00Z\',\n        external_id: \'string\',\n        metadata: {\n          registration_id: \'1234567890\',\n          business_unit: \'ABC\'\n        },\n        operation: \'create\',\n        value: 240,\n        source: \'ECP\',\n        read_by: \'John Doe\',\n        reason: \'\',\n        status: \'valid\',\n        remark: \'Customer reported unusual consumption\',\n        note: \'string\',\n        unit: \'string\'\n      }\n    ]\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": [\n    {\n      "value": 240,\n      "read_by": "John Doe",\n      "reason": "",\n      "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "direction": "feed-in",\n      "timestamp": "2022-10-10T00:00:00.000Z",\n      "source": "ECP",\n      "status": "valid",\n      "external_id": "string",\n      "remark": "Customer reported unusual consumption",\n      "metadata": {\n        "registration_id": "1234567890",\n        "business_unit": "ABC"\n      },\n      "note": "string",\n      "unit": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `createMeterReadingFromSubmission`\n\nCreates meter readings from a journey submission payload.\n\n`POST /v1/metering/reading/submission`\n\n```ts\nconst { data } = await client.createMeterReadingFromSubmission(\n  null,\n  {\n    org_id: \'123\',\n    entity: {\n      _org: \'123\',\n      meterReadings: [\n        {\n          meterId: \'string\',\n          readings: [\n            {\n              counterId: \'string\',\n              direction: \'feed-in\',\n              unit: \'string\',\n              value: 240\n            }\n          ],\n          readingValue: 240,\n          readingDate: \'2022-10-10T10:10:00.000Z\',\n          readBy: \'John Doe\',\n          reason: \'\',\n          maloId: \'A09-123\',\n          obisNumber: \'A-34\',\n          readingUnit: \'string\',\n          meterType: \'one_tariff\',\n          feedInValue: 240,\n          feedOutValue: 240,\n          htValue: 240,\n          ntValue: 240\n        }\n      ]\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "message": "Successfully Processed"\n}\n```\n\n</details>\n\n---\n\n### `getAllowedReadingForMeter`\n\nReturns the allowed min/max reading range for each counter of the given meter.\n\n`GET /v1/metering/allowed/reading/{meter_id}`\n\n```ts\nconst { data } = await client.getAllowedReadingForMeter({\n  meter_id: \'example\',\n  timestamp: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": [\n    {\n      "counter_id": "string",\n      "min_value": 0,\n      "max_value": 0\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `createReadingWithMeter`\n\nCreates a meter reading along with meter lookup or creation by MA-LO ID and OBIS number.\n\n`POST /v1/metering/reading/with-meter`\n\n```ts\nconst { data } = await client.createReadingWithMeter(\n  null,\n  {\n    ma_lo_id: \'A09-123\',\n    meter_id: \'string\',\n    obis_number: \'A-34\',\n    unit: \'string\',\n    direction: \'feed-in\',\n    tariff_type: \'ht\',\n    value: 240,\n    read_by: \'John Doe\',\n    reason: \'\',\n    timestamp: \'2022-10-10T10:10:00.000Z\',\n    source: \'ECP\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": {\n    "value": 240,\n    "read_by": "John Doe",\n    "reason": "",\n    "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "direction": "feed-in",\n    "timestamp": "2022-10-10T00:00:00.000Z",\n    "source": "ECP",\n    "status": "valid",\n    "external_id": "string",\n    "remark": "Customer reported unusual consumption",\n    "metadata": {\n      "registration_id": "1234567890",\n      "business_unit": "ABC"\n    },\n    "note": "string",\n    "unit": "string"\n  }\n}\n```\n\n</details>\n\n---\n\n### `getReadingsByInterval`\n\nRetrieves all readings specified in an interval.\nIf the start_date and end_date are equal, then it returns the readings of the specified date.\nThe start_date should be less than or equal to the end_da\n\n`GET /v1/metering/reading/{meter_id}/{counter_id}`\n\n```ts\nconst { data } = await client.getReadingsByInterval({\n  meter_id: \'example\',\n  counter_id: \'example\',\n  start_date: \'example\',\n  end_date: \'example\',\n  direction: \'example\',\n  size: 1,\n  from: 1,\n  type: \'example\',\n  sort: \'example\',\n  include_pending_changesets: true,\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "results": [\n    {\n      "value": 240,\n      "read_by": "John Doe",\n      "reason": "",\n      "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "direction": "feed-in",\n      "timestamp": "2022-10-10T00:00:00.000Z",\n      "source": "ECP",\n      "status": "valid",\n      "external_id": "string",\n      "remark": "Customer reported unusual consumption",\n      "metadata": {\n        "registration_id": "1234567890",\n        "business_unit": "ABC"\n      },\n      "note": "string",\n      "unit": "string"\n    }\n  ],\n  "hits": 120,\n  "firstRecordCreatedAt": "2022-10-01T20:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `updateMeterReading`\n\nUpdates an existing meter reading identified by meter ID, counter ID, and timestamp.\n\n`PUT /v1/metering/reading/{meter_id}/{counter_id}`\n\n```ts\nconst { data } = await client.updateMeterReading(\n  {\n    meter_id: \'example\',\n    counter_id: \'example\',\n    timestamp: \'example\',\n  },\n  {\n    value: 240,\n    read_by: \'John Doe\',\n    reason: \'string\',\n    meter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n    counter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n    direction: \'feed-in\',\n    timestamp: \'2022-10-10T00:00:00.000Z\',\n    source: \'ECP\',\n    status: \'valid\',\n    external_id: \'string\',\n    remark: \'Customer reported unusual consumption\',\n    metadata: {\n      registration_id: \'1234567890\',\n      business_unit: \'ABC\'\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": {\n    "value": 240,\n    "read_by": "John Doe",\n    "reason": "",\n    "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "direction": "feed-in",\n    "timestamp": "2022-10-10T00:00:00.000Z",\n    "source": "ECP",\n    "status": "valid",\n    "external_id": "string",\n    "remark": "Customer reported unusual consumption",\n    "metadata": {\n      "registration_id": "1234567890",\n      "business_unit": "ABC"\n    },\n    "note": "string",\n    "unit": "string"\n  }\n}\n```\n\n</details>\n\n---\n\n### `deleteMeterReading`\n\nPermanently deletes a meter reading identified by meter ID, counter ID, and timestamp.\n\n`DELETE /v1/metering/reading/{meter_id}/{counter_id}`\n\n```ts\nconst { data } = await client.deleteMeterReading({\n  meter_id: \'example\',\n  counter_id: \'example\',\n  timestamp: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": {\n    "meterId": "string",\n    "counterId": "string",\n    "timestamp": "2022-10-01T20:00:00.000Z"\n  }\n}\n```\n\n</details>\n\n---\n\n### `getReadingChangesets`\n\nList pending reading changesets for a counter\n\n`GET /v1/metering/reading/{meter_id}/{counter_id}/changesets`\n\n```ts\nconst { data } = await client.getReadingChangesets({\n  meter_id: \'example\',\n  counter_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "changesets": [\n    {\n      "changeset_id": "string",\n      "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "proposed": {\n        "value": 0,\n        "direction": "feed-in",\n        "timestamp": "1970-01-01T00:00:00.000Z",\n        "reason": "string",\n        "remark": "string",\n        "read_by": "string",\n        "status": "valid",\n        "external_id": "string"\n      },\n      "previous": {\n        "value": 0,\n        "direction": "feed-in",\n        "timestamp": "1970-01-01T00:00:00.000Z",\n        "reason": "string",\n        "remark": "string",\n        "read_by": "string",\n        "status": "valid",\n        "external_id": "string"\n      },\n      "edit_mode": "external",\n      "match_strategy": "exact",\n      "timestamp_tolerance": "exact",\n      "created_at": "1970-01-01T00:00:00.000Z",\n      "created_by": {\n        "type": "user",\n        "id": "string"\n      },\n      "source": "360",\n      "fuzzy_config": {\n        "percentage_threshold": 0.01,\n        "absolute_threshold": 0\n      },\n      "dismissed_reason": "string",\n      "dismissed_at": "1970-01-01T00:00:00.000Z"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `applyReadingChangeset`\n\nApply (approve) a pending reading changeset\n\n`POST /v1/metering/reading/{meter_id}/{counter_id}/changesets/{changeset_id}:apply`\n\n```ts\nconst { data } = await client.applyReadingChangeset({\n  meter_id: \'example\',\n  counter_id: \'example\',\n  changeset_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "reading": {\n    "value": 240,\n    "read_by": "John Doe",\n    "reason": "",\n    "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "direction": "feed-in",\n    "timestamp": "2022-10-10T00:00:00.000Z",\n    "source": "ECP",\n    "status": "valid",\n    "external_id": "string",\n    "remark": "Customer reported unusual consumption",\n    "metadata": {\n      "registration_id": "1234567890",\n      "business_unit": "ABC"\n    },\n    "note": "string",\n    "unit": "string"\n  },\n  "changeset": {\n    "changeset_id": "string",\n    "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "proposed": {\n      "value": 0,\n      "direction": "feed-in",\n      "timestamp": "1970-01-01T00:00:00.000Z",\n      "reason": "string",\n      "remark": "string",\n      "read_by": "string",\n      "status": "valid",\n      "external_id": "string"\n    },\n    "previous": {\n      "value": 0,\n      "direction": "feed-in",\n      "timestamp": "1970-01-01T00:00:00.000Z",\n      "reason": "string",\n      "remark": "string",\n      "read_by": "string",\n      "status": "valid",\n      "external_id": "string"\n    },\n    "edit_mode": "external",\n    "match_strategy": "exact",\n    "timestamp_tolerance": "exact",\n    "created_at": "1970-01-01T00:00:00.000Z",\n    "created_by": {\n      "type": "user",\n      "id": "string"\n    },\n    "source": "360",\n    "fuzzy_config": {\n      "percentage_threshold": 0.01,\n      "absolute_threshold": 0\n    },\n    "dismissed_reason": "string",\n    "dismissed_at": "1970-01-01T00:00:00.000Z"\n  }\n}\n```\n\n</details>\n\n---\n\n### `dismissReadingChangeset`\n\nDismiss (reject) a pending reading changeset\n\n`POST /v1/metering/reading/{meter_id}/{counter_id}/changesets/{changeset_id}:dismiss`\n\n```ts\nconst { data } = await client.dismissReadingChangeset(\n  {\n    meter_id: \'example\',\n    counter_id: \'example\',\n    changeset_id: \'example\',\n  },\n  {\n    reason: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "changeset_id": "string",\n  "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n  "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n  "proposed": {\n    "value": 0,\n    "direction": "feed-in",\n    "timestamp": "1970-01-01T00:00:00.000Z",\n    "reason": "string",\n    "remark": "string",\n    "read_by": "string",\n    "status": "valid",\n    "external_id": "string"\n  },\n  "previous": {\n    "value": 0,\n    "direction": "feed-in",\n    "timestamp": "1970-01-01T00:00:00.000Z",\n    "reason": "string",\n    "remark": "string",\n    "read_by": "string",\n    "status": "valid",\n    "external_id": "string"\n  },\n  "edit_mode": "external",\n  "match_strategy": "exact",\n  "timestamp_tolerance": "exact",\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "created_by": {\n    "type": "user",\n    "id": "string"\n  },\n  "source": "360",\n  "fuzzy_config": {\n    "percentage_threshold": 0.01,\n    "absolute_threshold": 0\n  },\n  "dismissed_reason": "string",\n  "dismissed_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `updateReadingChangeset`\n\nEdit a pending reading changeset\n\n`PATCH /v1/metering/reading/{meter_id}/{counter_id}/changesets/{changeset_id}`\n\n```ts\nconst { data } = await client.updateReadingChangeset(\n  {\n    meter_id: \'example\',\n    counter_id: \'example\',\n    changeset_id: \'example\',\n  },\n  {\n    proposed: {\n      value: 0,\n      direction: \'feed-in\',\n      timestamp: \'1970-01-01T00:00:00.000Z\',\n      reason: \'string\',\n      remark: \'string\',\n      read_by: \'string\',\n      status: \'valid\',\n      external_id: \'string\'\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "changeset_id": "string",\n  "meter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n  "counter_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n  "proposed": {\n    "value": 0,\n    "direction": "feed-in",\n    "timestamp": "1970-01-01T00:00:00.000Z",\n    "reason": "string",\n    "remark": "string",\n    "read_by": "string",\n    "status": "valid",\n    "external_id": "string"\n  },\n  "previous": {\n    "value": 0,\n    "direction": "feed-in",\n    "timestamp": "1970-01-01T00:00:00.000Z",\n    "reason": "string",\n    "remark": "string",\n    "read_by": "string",\n    "status": "valid",\n    "external_id": "string"\n  },\n  "edit_mode": "external",\n  "match_strategy": "exact",\n  "timestamp_tolerance": "exact",\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "created_by": {\n    "type": "user",\n    "id": "string"\n  },\n  "source": "360",\n  "fuzzy_config": {\n    "percentage_threshold": 0.01,\n    "absolute_threshold": 0\n  },\n  "dismissed_reason": "string",\n  "dismissed_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n## Schemas\n\n### `ErrorResp`\n\n```ts\ntype ErrorResp = {\n  message?: string\n}\n```\n\n### `EntityId`\n\n```ts\ntype EntityId = string // uuid\n```\n\n### `EntitySlug`\n\nURL-friendly identifier for the entity schema\n\n```ts\ntype EntitySlug = string\n```\n\n### `BaseEntity`\n\n```ts\ntype BaseEntity = {\n  _id: string // uuid\n  _title: string\n  _org: string\n  _tags?: string[]\n  _created_at: string // date-time\n  _updated_at: string // date-time\n}\n```\n\n### `Entity`\n\n```ts\ntype Entity = Record<string, unknown>\n```\n\n### `EntityItem`\n\n```ts\ntype EntityItem = {\n  _id: string // uuid\n  _title: string\n  _org: string\n  _tags?: string[]\n  _created_at: string // date-time\n  _updated_at: string // date-time\n}\n```\n\n### `Id`\n\n```ts\ntype Id = string\n```\n\n### `EntityRelation`\n\n```ts\ntype EntityRelation = {\n  entity_id?: string // uuid\n  _slug?: "contact" | "contract"\n}\n```\n\n### `Meter`\n\n```ts\ntype Meter = {\n  _id: string // uuid\n  _title: string\n  _org: string\n  _tags?: string[]\n  _created_at: string // date-time\n  _updated_at: string // date-time\n  _schema: "meter"\n  ma_lo_id?: string\n  status?: "active" | "decommissioned"\n  meter_type?: "three-phase-meter" | "bellow-gas-meter" | "rotary-piston-meter" | "smart-meter" | "performance-meter" | "maximum-meter" | "turbine-gas-meter" | "ultrasonic-gas-meter" | "alternating-current-meter" | "modern-metering-system" | "intelligent-measuring-system" | "electronic-meter"\n  tariff_type?: string\n  meter_number?: string\n  sector?: "power" | "water" | "gas" | "district_heating" | "waste_water"\n  location?: object\n  used_for?: string\n  manufacturer?: string\n  calibration_date?: string\n  contract?: {\n    $relation?: Array<{\n      entity_id?: { ... }\n      _slug?: { ... }\n    }>\n  }\n  customer?: {\n    $relation?: Array<{\n      entity_id?: { ... }\n      _slug?: { ... }\n    }>\n  }\n}\n```\n\n### `Direction`\n\n```ts\ntype Direction = "feed-in" | "feed-out"\n```\n\n### `TariffType`\n\n```ts\ntype TariffType = "ht" | "nt"\n```\n\n### `Reason`\n\nThe reason for recording the reading\nIf no reason is specified or left empty, the Epilot UI will show \'Regular\' as the default display text\n\n\n```ts\ntype Reason = "" | "regular" | "irregular" | "last" | "first" | "meter_change" | "contract_change" | "meter_adjustment"\n```\n\n### `ReasonString`\n\nThis field is deprecated. Please use the Reason enum instead.\n\n\n```ts\ntype ReasonString = string\n```\n\n### `ReadBy`\n\nThe person who recorded the reading\n\n```ts\ntype ReadBy = string\n```\n\n### `ReadingStatus`\n\n```ts\ntype ReadingStatus = "valid" | "in-validation" | "implausible" | null | ""\n```\n\n### `Reading`\n\n```ts\ntype Reading = {\n  value: number\n  read_by?: string\n  reason?: "" | "regular" | "irregular" | "last" | "first" | "meter_change" | "contract_change" | "meter_adjustment"\n  meter_id?: string // uuid\n  counter_id?: string // uuid\n  direction?: "feed-in" | "feed-out"\n  timestamp?: string // date-time\n  source: "ECP" | "ERP" | "360" | "journey-submission"\n  status?: "valid" | "in-validation" | "implausible" | null | ""\n  external_id?: string\n  remark?: string\n  metadata?: Record<string, string>\n  note?: string\n  unit?: string\n}\n```\n\n### `MeterReading`\n\n```ts\ntype MeterReading = {\n  value: number\n  read_by?: string\n  reason?: "" | "regular" | "irregular" | "last" | "first" | "meter_change" | "contract_change" | "meter_adjustment"\n  meter_id: string // uuid\n  counter_id?: string // uuid\n  direction?: "feed-in" | "feed-out"\n  timestamp?: string // date-time\n  source: "ECP" | "ERP" | "360" | "journey-submission"\n  status?: "valid" | "in-validation" | "implausible" | null | ""\n  external_id?: string\n  remark?: string\n  metadata?: Record<string, string>\n  note?: string\n  unit?: string\n}\n```\n\n### `PortalMeterReading`\n\n```ts\ntype PortalMeterReading = {\n  value: number\n  read_by?: string\n  reason?: "" | "regular" | "irregular" | "last" | "first" | "meter_change" | "contract_change" | "meter_adjustment"\n  meter_id?: string // uuid\n  counter_id: string // uuid\n  direction?: "feed-in" | "feed-out"\n  timestamp?: string // date-time\n  source: "ECP" | "ERP" | "360" | "journey-submission"\n  status?: "valid" | "in-validation" | "implausible" | null | ""\n  external_id?: string\n  remark?: string\n  metadata?: Record<string, string>\n  note?: string\n  unit?: string\n}\n```\n\n### `BatchReadingBase`\n\nBase properties shared by all batch reading operations\n\n```ts\ntype BatchReadingBase = {\n  meter_id?: string // uuid\n  counter_id?: string // uuid\n  direction?: "feed-in" | "feed-out"\n  timestamp?: string // date-time\n  external_id?: string\n  metadata?: Record<string, string>\n}\n```\n\n### `CreateOrUpdateBatchReading`\n\nSchema for create or update operations - requires value, source, and meter_id\n\n```ts\ntype CreateOrUpdateBatchReading = {\n  meter_id: string // uuid\n  counter_id?: string // uuid\n  direction?: "feed-in" | "feed-out"\n  timestamp?: string // date-time\n  external_id?: string\n  metadata?: Record<string, string>\n  operation?: "create" | "update"\n  value: number\n  source: "ECP" | "ERP" | "360" | "journey-submission"\n  read_by?: string\n  reason?: "" | "regular" | "irregular" | "last" | "first" | "meter_change" | "contract_change" | "meter_adjustment"\n  status?: "valid" | "in-validation" | "implausible" | null | ""\n  remark?: string\n  note?: string\n  unit?: string\n}\n```\n\n### `DeleteBatchReading`\n\nSchema for delete operations - only requires identifier fields specified in the identifiers parameter\n\n```ts\ntype DeleteBatchReading = {\n  meter_id?: string // uuid\n  counter_id?: string // uuid\n  direction?: "feed-in" | "feed-out"\n  timestamp?: string // date-time\n  external_id?: string\n  metadata?: Record<string, string>\n  operation: "delete"\n}\n```\n\n### `BatchReading`\n\nA meter reading for batch operations. The required fields depend on the operation:\n- create/update: requires value, source, and meter_id\n- delete: only requires the fields specified in the identifiers parameter\n\n\n```ts\ntype BatchReading = {\n  meter_id: string // uuid\n  counter_id?: string // uuid\n  direction?: "feed-in" | "feed-out"\n  timestamp?: string // date-time\n  external_id?: string\n  metadata?: Record<string, string>\n  operation?: "create" | "update"\n  value: number\n  source: "ECP" | "ERP" | "360" | "journey-submission"\n  read_by?: string\n  reason?: "" | "regular" | "irregular" | "last" | "first" | "meter_change" | "contract_change" | "meter_adjustment"\n  status?: "valid" | "in-validation" | "implausible" | null | ""\n  remark?: string\n  note?: string\n  unit?: string\n} | {\n  meter_id?: string // uuid\n  counter_id?: string // uuid\n  direction?: "feed-in" | "feed-out"\n  timestamp?: string // date-time\n  external_id?: string\n  metadata?: Record<string, string>\n  operation: "delete"\n}\n```\n\n### `UpdateMeterReading`\n\n```ts\ntype UpdateMeterReading = {\n  value: number\n  read_by?: string\n  reason?: string\n  meter_id: string // uuid\n  counter_id?: string // uuid\n  direction?: "feed-in" | "feed-out"\n  timestamp?: string // date-time\n  source: "ECP" | "ERP" | "360" | "journey-submission"\n  status?: "valid" | "in-validation" | "implausible" | null | ""\n  external_id?: string\n  remark?: string\n  metadata?: Record<string, string>\n}\n```\n\n### `MeterCounter`\n\n```ts\ntype MeterCounter = {\n  _id: string // uuid\n  _title: string\n  _org: string\n  _tags?: string[]\n  _created_at: string // date-time\n  _updated_at: string // date-time\n  _schema: "meter_counter"\n  obis_number?: string\n  direction?: "feed-in" | "feed-out"\n  transformer_ratio?: number\n  unit?: string\n  forecast_reading_value?: string\n  forecast_as_of?: string\n  current_consumption?: number\n  last_reading?: string\n  conversion_factor?: number\n  tariff_type?: "ht" | "nt"\n}\n```\n\n### `CounterReadingOnSubmission`\n\n```ts\ntype CounterReadingOnSubmission = {\n  counterId: string\n  direction: "feed-in" | "feed-out"\n  unit?: string\n  value: number\n}\n```\n\n### `SubmissionMeterReading`\n\n```ts\ntype SubmissionMeterReading = {\n  meterId: string\n  readings?: Array<{\n    counterId: string\n    direction: "feed-in" | "feed-out"\n    unit?: string\n    value: number\n  }>\n  readingValue?: number\n  readingDate?: string\n  readBy?: string\n  reason?: "" | "regular" | "irregular" | "last" | "first" | "meter_change" | "contract_change" | "meter_adjustment"\n  maloId?: string\n  obisNumber?: string\n  readingUnit?: string\n  meterType?: "one_tariff" | "two_tariff" | "bi_directional"\n  feedInValue?: number\n  feedOutValue?: number\n  htValue?: number\n  ntValue?: number\n}\n```\n\n### `Unit`\n\n```ts\ntype Unit = string\n```\n\n### `Source`\n\n```ts\ntype Source = "ECP" | "ERP" | "360" | "journey-submission"\n```\n\n### `ActionLabel`\n\n```ts\ntype ActionLabel = {\n  en?: string\n  de?: string\n}\n```\n\n### `Rule`\n\n```ts\ntype Rule = {\n  entity?: string\n  attribute?: string\n  attribute_value?: string\n}\n```\n\n### `JourneyActions`\n\n```ts\ntype JourneyActions = {\n  journey_id?: string\n  action_label?: {\n    en?: string\n    de?: string\n  }\n  slug?: string\n  rules?: Array<{\n    entity?: string\n    attribute?: string\n    attribute_value?: string\n  }>\n}\n```\n\n### `ReadingWithMeter`\n\n```ts\ntype ReadingWithMeter = {\n  ma_lo_id?: string\n  meter_id?: string\n  obis_number?: string\n  unit?: string\n  direction?: "feed-in" | "feed-out"\n  tariff_type?: "ht" | "nt"\n  value?: number\n  read_by?: string\n  reason?: "" | "regular" | "irregular" | "last" | "first" | "meter_change" | "contract_change" | "meter_adjustment"\n  timestamp?: string\n  source?: "ECP" | "ERP" | "360" | "journey-submission"\n}\n```\n\n### `MeterReadingChangeset`\n\n```ts\ntype MeterReadingChangeset = {\n  changeset_id: string\n  meter_id?: string // uuid\n  counter_id?: string // uuid\n  proposed: {\n    value: number\n    direction?: "feed-in" | "feed-out"\n    timestamp?: string // date-time\n    reason?: string\n    remark?: string\n    read_by?: string\n    status?: "valid" | "in-validation" | "implausible"\n    external_id?: string\n  }\n  previous?: {\n    value: number\n    direction?: "feed-in" | "feed-out"\n    timestamp?: string // date-time\n    reason?: string\n    remark?: string\n    read_by?: string\n    status?: "valid" | "in-validation" | "implausible"\n    external_id?: string\n  }\n  edit_mode: "external" | "approval"\n  match_strategy?: "exact" | "fuzzy"\n  timestamp_tolerance?: "exact" | {\n    type: "same-day"\n    timezone?: string\n  } | {\n    type: "within-seconds"\n    seconds: number\n  }\n  created_at: string // date-time\n  created_by?: {\n    type?: "user" | "portal_user" | "api_client" | "automation"\n    id?: string\n  }\n  source?: "360" | "ECP" | "ERP" | "journey-submission"\n  fuzzy_config?: {\n    percentage_threshold?: number\n    absolute_threshold?: number\n  }\n  dismissed_reason?: string\n  dismissed_at?: string // date-time\n}\n```\n\n### `FuzzyConfig`\n\nNumeric-threshold fuzzy matching for meter reading auto-clear.\n\nNOTE: This is intentionally different from entity-api\'s FuzzyConfig. Entity-api\'s\nfuzzy strategies (suffix, digits_only, normalize_phone, ignore_fields,\ncontains_entry, regex) are designed for strings and structured objects (IBAN, phone\n\n```ts\ntype FuzzyConfig = {\n  percentage_threshold?: number\n  absolute_threshold?: number\n}\n```\n\n### `ProposedReading`\n\n```ts\ntype ProposedReading = {\n  value: number\n  direction?: "feed-in" | "feed-out"\n  timestamp?: string // date-time\n  reason?: string\n  remark?: string\n  read_by?: string\n  status?: "valid" | "in-validation" | "implausible"\n  external_id?: string\n}\n```\n\n### `ChangesetCreator`\n\n```ts\ntype ChangesetCreator = {\n  type?: "user" | "portal_user" | "api_client" | "automation"\n  id?: string\n}\n```\n\n### `TimestampTolerance`\n\nSlack on `reading.timestamp` when auto-clear matches an incoming reading\nagainst a pending changeset. Both sides reference the SAME physical\nmeter-read event \u2014 one as stored when the user submitted, the other as\nechoed back by the ERP. The tolerance accommodates round-trip format\ndrift between the t\n\n```ts\ntype TimestampTolerance = "exact" | {\n  type: "same-day"\n  timezone?: string\n} | {\n  type: "within-seconds"\n  seconds: number\n}\n```\n\n### `ActivityId`\n\nSee https://github.com/ulid/spec\n\n```ts\ntype ActivityId = string // ulid\n```\n';
-export {
-  metering_default as default
-};