Customer Migrations Guide: Pre Account Import
Overview
Use this endpoint to import a market participant and its contact details before importing accounts.
Schema
Responses
The following responses may be returned from the API.
| Status code | Description |
|---|---|
200 - OK | A market participant with the given code already existed; no changes were made. |
201 - Created | The market participant was successfully imported. |
400 - Bad Request | Invalid request data or validation errors. |
401 - Unauthorized | Authentication credentials were not provided or are invalid. |
Payloads
Import market participant
{
"code": 9900123456789,
"code_type": "BDEW",
"name": "Stadtwerke Example GmbH",
"role": "NETWORK_OPERATOR",
"energy": "ELECTRICITY",
"contact_details": [
{
"category": "Z10",
"name": "EDI-Kommunikation",
"email": "edi@stadtwerke-example.de",
"phone": "+49123456789",
"valid_from": "2024-01-01T00:00:00+01:00"
}
]
}Overview
Use this endpoint to import one or more price sheets of market participant fees. Each price sheet mirrors a PRICAT message: a single market participant, a price sheet type, and a list of article prices. The market participants referenced by code must already exist (use the market participant import endpoint first).
Schema
Responses
The following responses may be returned from the API.
| Status code | Description |
|---|---|
201 - Created | The market participant fees were successfully imported. |
400 - Bad Request | Invalid request data or validation errors. |
401 - Unauthorized | Authentication credentials were not provided or are invalid. |
Payloads
Import market participant fees
{
"price_sheets": [
{
"market_participant_code": 9900123456789,
"price_sheet_type": "Z64",
"document_number": "PRC-2026-0001",
"preceding_document_number": "PRC-2025-0099",
"is_price_sheet_unused": false,
"active_from": "2026-01-01T00:00:00+01:00",
"external_id": "legacy-pk-12345",
"article_prices": [
{
"article_id": "1-01-1-002",
"price_cents": "1234.5600",
"interval_zone": {
"lower_bound": 0,
"upper_bound": 1000
}
}
]
}
]
}Overview
Use this endpoint to import market participant time definitions (Zählzeit-, Schaltzeit- and Leistungskurvendefinitionen) as they arrive over UTILTS. It accepts definition overviews (with their registers) and rolled-out definitions (with their change-point entries); at least one of the two lists must be provided. The network operators referenced by code must already exist (use the market participant import endpoint first).
Schema
Responses
The following responses may be returned from the API.
| Status code | Description |
|---|---|
201 - Created | The market participant time definitions were successfully imported. |
400 - Bad Request | Invalid request data or validation errors. |
401 - Unauthorized | Authentication credentials were not provided or are invalid. |
Payloads
Import market participant time definitions
{
"network_operator_code": "9900123456789",
"definitions": [
{
"valid_from": "2026-01-01",
"version_datetime": "2025-12-01T00:00:00+01:00",
"status": "Z45",
"definition_type": "Z39",
"definition_code": "MSP",
"transmission_frequency": "Z34",
"registers": [
{
"register_code": "HT",
"low_load_capable": false
},
{
"register_code": "NT",
"low_load_capable": true
}
]
}
],
"rolled_out_definitions": [
{
"definition_type": "Z39",
"definition_code": "MSP",
"version_datetime": "2025-12-01T00:00:00+01:00",
"validity_period_start": "2026-01-01T00:00:00+01:00",
"validity_period_end": "2027-01-01T00:00:00+01:00",
"recurrence": "303",
"entries": [
{
"period_start": "2026-01-01T00:00:00+01:00",
"period_end": "2026-07-01T00:00:00+02:00",
"active_register_code": "NT"
},
{
"period_start": "2026-07-01T00:00:00+02:00",
"period_end": "2027-01-01T00:00:00+01:00",
"active_register_code": "HT"
}
]
}
]
}