🔑Update Meter Key

Use this endpoint to update meter key.

post

Header parameters

AuthorizationstringRequired

API token for user authentication

Example: {"value":"Token tk-abc-1234-xyz"}

Body

application/json

objectOptional

Valid combinations for this request:

1. 'meter_no'
2. 'meter_card'
3. ['meter_no', 'supply_group_code', 'key_rev_no', 'tariff_index', 'token_tech', 'algo_tech'] Note: In Update Meter Key flow only combinations 2 and 3 are allowed

and

Responses

200

Meter key updated successfully

application/json

400

Invalid input

application/json

500

Failed to update meter key

application/json

post

/api/v1/meter/update

HTTPcURLJavaScriptPython

POST /api/v1/meter/update HTTP/1.1
Host: stage-api.digimali.co.za
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 176

{
  "algo_tech": "07",
  "key_rev_no": "1",
  "meter_no": "1234567890",
  "supply_group_code": "100600",
  "tariff_index": "07",
  "token_tech": "02",
  "meter_card": "600727123412341234===0716123456647"
}

{
  "client_id": "CLIENT123",
  "desc": "Meter key updated successfully",
  "display_header": "Meter Key Update",
  "from_key_rev_no": "REV999",
  "from_supply_group_code": "SGC999",
  "from_tariff_index": "TARIFF999",
  "id": "d9650f26-5037-4319-8c42-f27f36855855",
  "message": {
    "flow": "<flow_name>",
    "id_type": "5",
    "message_number": 183,
    "message_time": "20241116184733"
  },
  "meter": {
    "algo_tech": "07",
    "key_rev_no": "1",
    "meter_no": "1234567890",
    "supply_group_code": "100600",
    "tariff_index": "07",
    "token_tech": "02"
  },
  "pwr_limit_desc": "Power Limit Description",
  "pwr_limit_token": "LIMITTOKEN123",
  "pwr_limit_unit": "kW",
  "pwr_limit_value": "50",
  "resp_date_time": "2024-10-10T12:00:00",
  "terminal_id": "TERMINAL456",
  "to_key_rev_no": "R2",
  "to_supply_group_code": "SGC123",
  "to_tariff_index": "T5",
  "token_1": "TOKEN123",
  "token_2": "TOKEN456",
  "utility": {
    "address": "Foo Road",
    "name": "Eskom",
    "tax_ref": "1234567890"
  }
}