@epilot/sdk 2.20.33 → 2.20.34

package/dist/{metering-FJI2AU7Q.cjs → metering-WAVFLJZD.cjs}

@@ -1,7 +1,7 @@
 "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- [`pruneMeterReadings`](#prunemeterreadings)\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- [`PruneMeterReadingsPayload`](#prunemeterreadingspayload)\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-10",\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-10",\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-10",\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-10",\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-10",\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-10",\n      "current_consumption": 240,\n      "last_reading": "2022-10-10",\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-10",\n    "current_consumption": 240,\n    "last_reading": "2022-10-10",\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-10\',\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-10",\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-10\',\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-10",\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-10\',\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-10",\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-10",\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### `pruneMeterReadings`\n\nDeletes every reading of a meter whose `external_id` is NOT in the provided keep list \u2014 in a single request.\n\n`POST /v2/metering/readings/prune`\n\n```ts\nconst { data } = await client.pruneMeterReadings(\n  {\n    async: true,\n    activity_id: \'example\',\n    create_ticket: true,\n    dry_run: true,\n  },\n  {\n    meter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n    counter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n    source: \'ECP\',\n    keep_external_ids: [\'erp-reading-1\', \'erp-reading-2\']\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": {\n    "deleted_count": 42,\n    "kept_count": 12\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-10",\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-10",\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-10\',\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-10",\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-10",\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### `PruneMeterReadingsPayload`\n\n```ts\ntype PruneMeterReadingsPayload = {\n  meter_id: string // uuid\n  counter_id?: string // uuid\n  source?: "ECP" | "ERP" | "360" | "journey-submission"\n  keep_external_ids: string[]\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';
+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- [`pruneMeterReadings`](#prunemeterreadings)\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- [`PruneMeterReadingsPayload`](#prunemeterreadingspayload)\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-10",\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-10",\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-10",\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-10",\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-10",\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-10",\n      "current_consumption": 240,\n      "last_reading": "2022-10-10",\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-10",\n    "current_consumption": 240,\n    "last_reading": "2022-10-10",\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-10\',\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-10",\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-10\',\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-10",\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-10\',\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-10",\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-10",\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### `pruneMeterReadings`\n\nDeletes every reading of a meter whose `external_id` is NOT in the provided keep list \u2014 in a single request.\n\n`POST /v2/metering/readings/prune`\n\n```ts\nconst { data } = await client.pruneMeterReadings(\n  {\n    async: true,\n    activity_id: \'example\',\n    create_ticket: true,\n    dry_run: true,\n  },\n  {\n    meter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n    counter_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n    source: \'ECP\',\n    keep_external_ids: [\'erp-reading-1\', \'erp-reading-2\']\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": {\n    "deleted_count": 42,\n    "kept_count": 12\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-10",\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-10",\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-10\',\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-10",\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\nLists the 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\nApplies (approves) a pending reading changeset: the proposed reading value is written to ClickHouse and the pending changeset is removed.\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-10",\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\nDismisses (rejects) a pending reading changeset: the changeset is removed without being applied. The reading value remains unchanged.\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\nEdits a pending reading changeset by updating its proposed value, without going through the normal write path.\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### `PruneMeterReadingsPayload`\n\n```ts\ntype PruneMeterReadingsPayload = {\n  meter_id: string // uuid\n  counter_id?: string // uuid\n  source?: "ECP" | "ERP" | "360" | "journey-submission"\n  keep_external_ids: string[]\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.d-DomHYl06.d.cts → metering.d-BP04w-gR.d.cts}

@@ -850,7 +850,9 @@ declare namespace Components {
              */
             counter_id?: EntityId /* uuid */;
             /**
-             * The direction of the reading (feed-in or feed-out)
+             * The direction of the reading. Optional, but **strongly recommended**: readings are keyed by direction in storage, so every reading is stored with one.
+             * Resolution order: the value sent here, else the `direction` of the reading's counter, else a value derived from the counter's `obis_number` — `2.x.x` on an electricity counter is `feed-in`, and everything else (including heat, gas and water, which have no meaningful direction) is `feed-out`.
+             * Relying on the derived fallback is fine for single-flow media. For electricity, set `direction` on the reading or on the counter: an electricity export counter that carries neither, and whose OBIS code does not say `2.x.x`, will be stored as `feed-out`.
              */
             direction?: Direction;
             /**
@@ -1836,6 +1838,7 @@ declare namespace Paths {
             export type $400 = Components.Responses.InvalidRequest;
             export type $401 = Components.Responses.Unauthorized;
             export type $403 = Components.Responses.Forbidden;
+            export type $413 = Components.Schemas.ErrorResp;
             export type $500 = Components.Responses.InternalServerError;
         }
     }
@@ -2150,7 +2153,10 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.DeleteMeterReading.Responses.$200>
   /**
-   * getReadingChangesets - List pending reading changesets for a counter
+   * getReadingChangesets - getReadingChangesets
+   * 
+   * Lists the pending reading changesets for a counter.
+   * 
    */
   'getReadingChangesets'(
     parameters?: Parameters<Paths.GetReadingChangesets.PathParameters> | null,
@@ -2158,9 +2164,9 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetReadingChangesets.Responses.$200>
   /**
-   * applyReadingChangeset - Apply (approve) a pending reading changeset
+   * applyReadingChangeset - applyReadingChangeset
    * 
-   * Applies the proposed reading value to ClickHouse and removes the pending changeset.
+   * Applies (approves) a pending reading changeset: the proposed reading value is written to ClickHouse and the pending changeset is removed.
    * 
    * Requires `meter_reading:edit` permission (approval workflow action on the reading's approval state).
    * 
@@ -2171,9 +2177,9 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.ApplyReadingChangeset.Responses.$200>
   /**
-   * dismissReadingChangeset - Dismiss (reject) a pending reading changeset
+   * dismissReadingChangeset - dismissReadingChangeset
    * 
-   * Removes the pending changeset without applying it. The reading value remains unchanged.
+   * Dismisses (rejects) a pending reading changeset: the changeset is removed without being applied. The reading value remains unchanged.
    * 
    * Requires `meter_reading:edit` permission (approval workflow action on the reading's approval state).
    * 
@@ -2184,9 +2190,9 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.DismissReadingChangeset.Responses.$200>
   /**
-   * updateReadingChangeset - Edit a pending reading changeset
+   * updateReadingChangeset - updateReadingChangeset
    * 
-   * Updates the proposed value of a pending changeset without going through the normal write path.
+   * Edits a pending reading changeset by updating its proposed value, without going through the normal write path.
    * 
    */
   'updateReadingChangeset'(
@@ -2459,7 +2465,10 @@ interface PathsDictionary {
   }
   ['/v1/metering/reading/{meter_id}/{counter_id}/changesets']: {
     /**
-     * getReadingChangesets - List pending reading changesets for a counter
+     * getReadingChangesets - getReadingChangesets
+     * 
+     * Lists the pending reading changesets for a counter.
+     * 
      */
     'get'(
       parameters?: Parameters<Paths.GetReadingChangesets.PathParameters> | null,
@@ -2469,9 +2478,9 @@ interface PathsDictionary {
   }
   ['/v1/metering/reading/{meter_id}/{counter_id}/changesets/{changeset_id}:apply']: {
     /**
-     * applyReadingChangeset - Apply (approve) a pending reading changeset
+     * applyReadingChangeset - applyReadingChangeset
      * 
-     * Applies the proposed reading value to ClickHouse and removes the pending changeset.
+     * Applies (approves) a pending reading changeset: the proposed reading value is written to ClickHouse and the pending changeset is removed.
      * 
      * Requires `meter_reading:edit` permission (approval workflow action on the reading's approval state).
      * 
@@ -2484,9 +2493,9 @@ interface PathsDictionary {
   }
   ['/v1/metering/reading/{meter_id}/{counter_id}/changesets/{changeset_id}:dismiss']: {
     /**
-     * dismissReadingChangeset - Dismiss (reject) a pending reading changeset
+     * dismissReadingChangeset - dismissReadingChangeset
      * 
-     * Removes the pending changeset without applying it. The reading value remains unchanged.
+     * Dismisses (rejects) a pending reading changeset: the changeset is removed without being applied. The reading value remains unchanged.
      * 
      * Requires `meter_reading:edit` permission (approval workflow action on the reading's approval state).
      * 
@@ -2499,9 +2508,9 @@ interface PathsDictionary {
   }
   ['/v1/metering/reading/{meter_id}/{counter_id}/changesets/{changeset_id}']: {
     /**
-     * updateReadingChangeset - Edit a pending reading changeset
+     * updateReadingChangeset - updateReadingChangeset
      * 
-     * Updates the proposed value of a pending changeset without going through the normal write path.
+     * Edits a pending reading changeset by updating its proposed value, without going through the normal write path.
      * 
      */
     'patch'(

package/dist/{metering.d-DomHYl06.d.ts → metering.d-BP04w-gR.d.ts}

@@ -850,7 +850,9 @@ declare namespace Components {
              */
             counter_id?: EntityId /* uuid */;
             /**
-             * The direction of the reading (feed-in or feed-out)
+             * The direction of the reading. Optional, but **strongly recommended**: readings are keyed by direction in storage, so every reading is stored with one.
+             * Resolution order: the value sent here, else the `direction` of the reading's counter, else a value derived from the counter's `obis_number` — `2.x.x` on an electricity counter is `feed-in`, and everything else (including heat, gas and water, which have no meaningful direction) is `feed-out`.
+             * Relying on the derived fallback is fine for single-flow media. For electricity, set `direction` on the reading or on the counter: an electricity export counter that carries neither, and whose OBIS code does not say `2.x.x`, will be stored as `feed-out`.
              */
             direction?: Direction;
             /**
@@ -1836,6 +1838,7 @@ declare namespace Paths {
             export type $400 = Components.Responses.InvalidRequest;
             export type $401 = Components.Responses.Unauthorized;
             export type $403 = Components.Responses.Forbidden;
+            export type $413 = Components.Schemas.ErrorResp;
             export type $500 = Components.Responses.InternalServerError;
         }
     }
@@ -2150,7 +2153,10 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.DeleteMeterReading.Responses.$200>
   /**
-   * getReadingChangesets - List pending reading changesets for a counter
+   * getReadingChangesets - getReadingChangesets
+   * 
+   * Lists the pending reading changesets for a counter.
+   * 
    */
   'getReadingChangesets'(
     parameters?: Parameters<Paths.GetReadingChangesets.PathParameters> | null,
@@ -2158,9 +2164,9 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetReadingChangesets.Responses.$200>
   /**
-   * applyReadingChangeset - Apply (approve) a pending reading changeset
+   * applyReadingChangeset - applyReadingChangeset
    * 
-   * Applies the proposed reading value to ClickHouse and removes the pending changeset.
+   * Applies (approves) a pending reading changeset: the proposed reading value is written to ClickHouse and the pending changeset is removed.
    * 
    * Requires `meter_reading:edit` permission (approval workflow action on the reading's approval state).
    * 
@@ -2171,9 +2177,9 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.ApplyReadingChangeset.Responses.$200>
   /**
-   * dismissReadingChangeset - Dismiss (reject) a pending reading changeset
+   * dismissReadingChangeset - dismissReadingChangeset
    * 
-   * Removes the pending changeset without applying it. The reading value remains unchanged.
+   * Dismisses (rejects) a pending reading changeset: the changeset is removed without being applied. The reading value remains unchanged.
    * 
    * Requires `meter_reading:edit` permission (approval workflow action on the reading's approval state).
    * 
@@ -2184,9 +2190,9 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.DismissReadingChangeset.Responses.$200>
   /**
-   * updateReadingChangeset - Edit a pending reading changeset
+   * updateReadingChangeset - updateReadingChangeset
    * 
-   * Updates the proposed value of a pending changeset without going through the normal write path.
+   * Edits a pending reading changeset by updating its proposed value, without going through the normal write path.
    * 
    */
   'updateReadingChangeset'(
@@ -2459,7 +2465,10 @@ interface PathsDictionary {
   }
   ['/v1/metering/reading/{meter_id}/{counter_id}/changesets']: {
     /**
-     * getReadingChangesets - List pending reading changesets for a counter
+     * getReadingChangesets - getReadingChangesets
+     * 
+     * Lists the pending reading changesets for a counter.
+     * 
      */
     'get'(
       parameters?: Parameters<Paths.GetReadingChangesets.PathParameters> | null,
@@ -2469,9 +2478,9 @@ interface PathsDictionary {
   }
   ['/v1/metering/reading/{meter_id}/{counter_id}/changesets/{changeset_id}:apply']: {
     /**
-     * applyReadingChangeset - Apply (approve) a pending reading changeset
+     * applyReadingChangeset - applyReadingChangeset
      * 
-     * Applies the proposed reading value to ClickHouse and removes the pending changeset.
+     * Applies (approves) a pending reading changeset: the proposed reading value is written to ClickHouse and the pending changeset is removed.
      * 
      * Requires `meter_reading:edit` permission (approval workflow action on the reading's approval state).
      * 
@@ -2484,9 +2493,9 @@ interface PathsDictionary {
   }
   ['/v1/metering/reading/{meter_id}/{counter_id}/changesets/{changeset_id}:dismiss']: {
     /**
-     * dismissReadingChangeset - Dismiss (reject) a pending reading changeset
+     * dismissReadingChangeset - dismissReadingChangeset
      * 
-     * Removes the pending changeset without applying it. The reading value remains unchanged.
+     * Dismisses (rejects) a pending reading changeset: the changeset is removed without being applied. The reading value remains unchanged.
      * 
      * Requires `meter_reading:edit` permission (approval workflow action on the reading's approval state).
      * 
@@ -2499,9 +2508,9 @@ interface PathsDictionary {
   }
   ['/v1/metering/reading/{meter_id}/{counter_id}/changesets/{changeset_id}']: {
     /**
-     * updateReadingChangeset - Edit a pending reading changeset
+     * updateReadingChangeset - updateReadingChangeset
      * 
-     * Updates the proposed value of a pending changeset without going through the normal write path.
+     * Edits a pending reading changeset by updating its proposed value, without going through the normal write path.
      * 
      */
     'patch'(