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 |
|---|---|
201 - Created | If the payload is valid and the market participant was created, a 201 Created response will be returned. |
200 - OK | If a market participant with the given code already exists, a 200 OK response will be returned. The existing record is not modified. |
400 - Bad Request |
If there are validation errors, a |
500 - Internal Server Error |
If an unexpected error occurs, a |
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 |
If the payload is valid, a |
400 - Bad Request |
If the payload is invalid or a referenced market participant does not exist,
a |
500 - Internal Server Error |
If an unexpected error occurs, a |
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 |
If the payload is valid, a |
400 - Bad Request |
If the payload is invalid or a referenced network operator does not exist,
a |
500 - Internal Server Error |
If an unexpected error occurs, a |
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"
}
]
}
]
}