Pre Mutation Md

create

Method	URL
POST	api/esh/pre_mutation_md/create

The Global Task “Pre Mutation MD” is available for consulting data from a small-scale connection by a supplier who has registered an offer/supply contract for the relevant small consumption connection.

The process for consulting a Metered Data for a connection at TMR follows the following scenario:

Pre-requisite steps

1. The initiator sends a request to create a Global Task pre_mutation_md

2. If the validation of the input parameters results in an error the ‘Global Task’ is not created and the errors are returned.

3. A Global Task is created and the GlobalTask.ID is returned.

Global Task steps

1. The ValueA adapter sends out the request to EDSN via an XML request: PreMutationMDRequest.

2. EDSN validates the request (see EDSN validations). If there are inaccuracies, the message is rejected.

3. If the request is successful, the TMR sends the current data of the concerned connection to the requesting party via an XML response PreMutationMDResponse.

Input parameters

pre_mutation_md global_task input parameters
type	object
properties
ean_id	type	string
	pattern	^[0-9]{18}$
use_local_data_for_validation	If true then the latest available MeteringPoint data will be used to perform additional validations
	type	boolean
	default	False
required	[‘ean_id’]

EDSN validations

validation	error message	error code
Is the requesting party authorized?	Account <P1> not authorized	P01
Does the EAN code complies with the EAN code check?	EAN-code <EAN-code> error	A01
Is Measurement data available for connection?	No information was found for the existing connection	P20
Does the connection/measuring device concerns a conventional meter or a smart meter that cannot be read remotely or may not be read out?	The measuring device can be read remotely	P52
Does the requesting supplier registered a contract to be confirmed or contract end data in the CER for the connection?	The requesting supplier has not registered a connection contract in the CER	P50
General (unexpected fault)	Unknown error	P08
In case of a time-out	Time-out	P03

Output parameters

client_key global_task return parameters
properties
global_task_id	GlobalTask.id
	type	string
	format	uuid
error	type	object
	properties
	messsageid	ValueA Broker message.id
		type	string
		format	uuid
	validations	type	array
		items	global_task_validation

global_task_validation

type	object
properties
message	type	string
ref	optional reference to parameter
	type	string / null
user_message	type	string / null

getStatus

Method	URL
GET	api/esh/pre_mutation_md/get_status

Get status input parameters

global_task get_status input parameters
type	object
properties
id	GlobalTask.id
	type	string
	format	uuid

Get status return parameters

global_task get_status return parameters
type	object
properties
status	type	string
status_date	type	string
	format	date
status_description	type	string / null
status_details	type	array
	items	status_detail
error	type	object
	properties
	messsageid	ValueA Broker message.id
		type	string
		format	uuid
	validations	type	array
		items	get_status_validation

status_detail

type	object
properties
description	type	string
remark	type	string / null

get_status_validation

type	object
properties
message	type	string
ref	optional reference to parameter
	type	string / null
user_message	type	string / null

getData

Method	URL
GET	api/esh/pre_mutation_md/get_data

Get data input parameters

pre_mutation_md get_data input parameters
type	object
properties
id	GlobalTask.id
	type	string
	format	uuid

Get data return parameters

pre_mutation_md get_data return parameters
type	object
properties
tmr_data	properties
	grid_area	type	string
		pattern	^[0-9]{18}$
	grid_operator_company_id	type	string
		pattern	^[0-9]{13}$
	volumes	type	array
		items	volume
	readings	type	array
		items	reading
tmr_rejection	properties
	reasons	type	array
		items	reason
error	type	object
	properties
	messsageid	ValueA Broker message.id
		type	string
		format	uuid
	validations	type	array
		items	get_data_validation

volume

properties
meter_id	type	string
tariff_type	type	string
valid_from_date	type	string
	format	date
valid_to_date	type	string
	format	date
volume	type	integer
measure_unit	type	string
reading_method	type	string
calorific_corrected_volume	type	integer
calorific_corrected_volume_measure_unit	type	string
determined_party	type	string

reading

properties
meter_id	type	string
register_id	type	string
tariff_type	type	string
mutation_date	type	string
	format	date
reading	type	integer
reading_method	type	string
determined_party	type	string

reason

properties
index	type	integer
code	type	string
text	type	string / null

get_data_validation

type	object
properties
message	type	string
ref	optional reference to parameter
	type	string / null
user_message	type	string / null