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 |
|---|---|
413 - Content Too Large | The request body exceeds the maximum allowed size. Request payload too large:{
"detail": "The request body exceeds the maximum allowed size.",
"code": "request_payload_too_large"
} |
415 - Unsupported Media Type | The Content-Encoding header value is not supported. Unsupported content encoding:{
"detail": "Unsupported Content-Encoding: <encoding>. Supported values are gzip and identity.",
"code": "unsupported_content_encoding"
} |
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 |
|---|---|
413 - Content Too Large | The request body exceeds the maximum allowed size. Request payload too large:{
"detail": "The request body exceeds the maximum allowed size.",
"code": "request_payload_too_large"
} |
415 - Unsupported Media Type | The Content-Encoding header value is not supported. Unsupported content encoding:{
"detail": "Unsupported Content-Encoding: <encoding>. Supported values are gzip and identity.",
"code": "unsupported_content_encoding"
} |
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 |
|---|---|
413 - Content Too Large | The request body exceeds the maximum allowed size. Request payload too large:{
"detail": "The request body exceeds the maximum allowed size.",
"code": "request_payload_too_large"
} |
415 - Unsupported Media Type | The Content-Encoding header value is not supported. Unsupported content encoding:{
"detail": "Unsupported Content-Encoding: <encoding>. Supported values are gzip and identity.",
"code": "unsupported_content_encoding"
} |
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"
}
]
}
]
}