Service-Schnittstellen der WiM
UTILMD to Masterdata
POST-Schnittstelle zur Konvertierung einer UTILMD in ein Masterdata Objekt, JSON-serialisiert.
URL: http://<server>:<port>/fastlane-backend/interface/utilmdToMasterdata
Beispiel-Request
UNB+UNOC:3+9812345678922:502+9812345678921:502+200415:1636+W1586961406433'
UNH+W1586961406433+UTILMD:D:11A:UN:5.2a'
BGM+Z14+D1586961419860'
DTM+137:202004151636:203'
NAD+MS+9812345678922::332'
NAD+MR+9812345678921::332'
IDE+24+T1586961436778'
STS+7++Z40'
LOC+172+233232323232323232323232323232323'
RFF+Z13:11060'
RFF+AAV:D1586954065663'
RFF+Z19:233232323232323232323232323232323'
SEQ+Z01'
RFF+Z18:33333333333'
SEQ+Z27'
RFF+Z18:33333333333'
PIA+5+7-1?:3.0.0:SRW'
CCI+Z26++ZA7'
CAV+Z84'
CCI+Z17'
CAV+Z65'
CAV+Z62'
CAV+Z56'
SEQ+Z18'
RFF+Z19:233232323232323232323232323232323'
RFF+Z16:33333333333'
CCI+++Y02'
CAV+Y05'
CCI+Z01++Z82'
SEQ+Z19'
RFF+Z19:233232323232323232323232323232323'
PIA+5+7-1?:3.0.0:SRW'
SEQ+Z03'
RFF+Z19:233232323232323232323232323232323'
CCI+++E13'
CAV+Z30:::12421421342341'
CCI+++Z28'
CAV+Z31'
CCI+++E12'
CAV+AMR'
NAD+Z03++++Teststreet::3+Testcity++34235+DE'
RFF+Z19:233232323232323232323232323232323'
UNT+42+W1586961406433'
UNZ+1+W1586961406433'
Beispiel-Response
{
"header": {
"versionNumber": null,
"sender": "9812345678922",
"recipient": "9812345678921",
"category": null,
"documentNumber": "D1586961419860",
"messageDate": "2020-04-15T16:36:00.000+02:00",
"contactPerson": {
"name": null,
"address": null,
"addressTypeCode": null
},
"unaData": null
},
"incidentId": "T1586961436778",
"identificationType": null,
"scheduledBeginDate": null,
"handOverDate": null,
"beginDate": null,
"endDate": null,
"changeDate": null,
"nextPossibleEndDate": null,
"accountingFrom": null,
"accountingTo": null,
"noticePeriod": null,
"cancellationDate": null,
"processedStartDate": null,
"nextProcessingDate": null,
"usageFrom": null,
"usageTo": null,
"gridOperatorProcessingOrder": null,
"transactionReason": "Z40",
"transactionReasonAddition": null,
"responseState": null,
"accountingGridAssignment": null,
"additionalInformation": null,
"profileDescription": null,
"suppliedAssignmentOrTermination": null,
"meteringPoints": [
"233232323232323232323232323232323"
],
"futureMeteringPoints": [],
"incidentIdentifier": "11060",
"referencedTransactionNumber": null,
"turnusReading": null,
"turnusIntervalMSB": null,
"turnusIntervalLF": null,
"invoicingAppointment": null,
"nextInvoicing": null,
"invoicingInterval": null,
"marketLocationDates": [],
"meteringLocationDates": [
{
"meteringLocationRef": "233232323232323232323232323232323",
"turnusReading": null,
"turnusIntervalNB": null
}
],
"marketLocationData": [
{
"marketLocationRef": "33333333333",
"dayDependingPrognosis": {
"consumptionQualifier": null,
"quantity": null,
"unit": null
},
"prognosis": null,
"prognosisTUM": null,
"accountedAmount": null,
"previousConsumption": null,
"deliveryDirection": null,
"transmissionGridOperator": null,
"measuringPointOperator": null,
"supplier": null,
"gridOperator": null,
"accountingRelevance": null,
"normZone": null,
"accountingGrid": null,
"accountingArea": null,
"marketRegion": null,
"voltageLevel": null,
"transformation": null,
"pressureLevel": null,
"classification": null,
"aggregationResponsibility": null,
"prognosisType": null,
"prognosisBase": null,
"exchangedPrognosisType": null,
"exchangedPrognosisBase": null,
"prognosisVote": null,
"generationState": null,
"generationType": null,
"groupAssignmentEnGW": null,
"gridAccessContract": null,
"paymentGridAccess": null,
"invoicingVariant": null,
"invoicingBase": null,
"invoicingExclusiveResources": null,
"remoteControlCapability": null,
"timeRowType": null,
"timeRowTypeCode": null,
"rewardReceiver": null
}
],
"marketLocationDataMarketRoles": [],
"obisMarketLocations": [],
"requiredObisMarketLocations": [
{
"obisNumber": "7-1:3.0.0",
"lightLoadAble": null,
"marketRoleObisRelevancies": [
{
"marketrole": "SUPPLIER",
"useCases": [
"NETUSAGE_BILLING"
]
}
],
"consumptionType": "WARMTH",
"interruptible": "INTERRUPTIBLE",
"thermalUse": "STORAGE_HEATER",
"marketLocationRef": "33333333333"
}
],
"obisMarketLocationMarketRoles": [],
"trancheData": [],
"trancheDataMarketRoles": [],
"requiredObisTranches": [],
"obisTranches": [],
"obisTrancheMarketRoles": [],
"electricityTaxes": [],
"concessionFees": [],
"meteringLocationDatas": [
{
"meteringLocationRef": "233232323232323232323232323232323",
"marketLocationRefs": [
"33333333333"
],
"invoicingMsbByNNE": null,
"measuringPointOperator": null,
"measuringPointOperatorOld": null,
"voltageLevel": null,
"gasQuality": "QUALITY_L",
"usage": "AFFECTED_METERING_LOCATION",
"lossFactor": null,
"workingState": null
}
],
"requiredObisMeteringLocations": [
{
"meteringLocationRef": "233232323232323232323232323232323",
"obis": "7-1:3.0.0",
"lightLoadAble": null
}
],
"deviceDirectionDatas": [
{
"meterPointIdRef": "233232323232323232323232323232323",
"meterType": null,
"meterTypeDetail": null,
"deviceNumber": "12421421342341",
"tarifeCount": null,
"energyDirection": null,
"mountingType": "Z31",
"measurementValueLogging": "AMR",
"meterSize": null,
"smartmeterGatewayRef": null,
"remoteControl": null,
"articleNumber": null
}
],
"obisMeters": [],
"transformerDatas": [],
"quantityTransformerDatas": [],
"controlDeviceDatas": [],
"communicationDeviceDatas": [],
"smartmeterGatewayDatas": [],
"controlBoxDatas": [],
"loadProfileGasDatas": [],
"loadProfileElectricityDatas": [],
"loadProfileDataInvolvedMarketroles": [],
"profileGroupDatas": [],
"profileGroupDataInvolvedMarketroles": [],
"customer": null,
"suppliedAddress": null,
"customerMeasuringPointOperator": null,
"communicationAddressMsbCustomer": null,
"meteringLocationAddress": {
"additionalInformation": "",
"street": "Teststreet",
"housenumber": "3",
"city": "Testcity",
"zip": "34235",
"poBox": null,
"meteringPointRef": "233232323232323232323232323232323",
"countryCode": "DE"
},
"communicationAddressLfCustomer": null,
"readoutCard": null,
"connectionOwner": null
}
UTILTS to JSON
POST-Schnittstelle zur Konvertierung einer UTILTS in ein UtiltsVo Objekt, JSON-serialisiert.
URL: http://<server>:<port>/fastlane-backend/interface/utiltsToJson
Beispiel-Request
UNA:+.? '
UNB+UNOC:3+4041407000008:14+9910902000001:500+200128:1244+040771851464'
UNH+040771851464+UTILTS:D:18A:UN:1.0'
BGM+Z36+040771851464'
DTM+137:202001281244:203'
NAD+MS+4041407000008::9'
NAD+MR+9910902000001::293'
IDE+24+051MXNdN7jgGk75BDABfdW'
LOC+172+50250163869'
DTM+157:201912010000:203'
STS+Z23+Z33'
RFF+Z13:25001'
CCI+Z30++Z06'
SEQ+Z36'
RFF+Z23:2'
CCI+Z27'
CAV+Z47'
CAV+Z84'
SEQ+Z37+1'
RFF+Z19:DE00721488410000EE210390781001RA0'
CCI+++Z86'
CAV+Z69'
CCI+++Z87'
CAV+Z72'
SEQ+Z37+1'
RFF+Z19:DE0072148841000000000000000956988'
CCI+++Z86'
CAV+Z70'
CCI+++Z87'
CAV+Z72'
SEQ+Z37+2'
RFF+Z23:1'
CCI+++Z86'
CAV+Z83'
UNT+33+040771851464'
UNZ+1+040771851464'
Beispiel-Response
{
"documentNr": "040771851464",
"messageDate": "2020-01-28T12:44:00.000+01:00",
"senderIln": "4041407000008",
"contactPerson": {
"name": null,
"address": null,
"addressTypeCode": null,
"id_": 50653
},
"receiverIln": "9910902000001",
"transactionNr": "051MXNdN7jgGk75BDABfdW",
"marketLocation": "50250163869",
"deliveryDirection": "Z06",
"validityDate": "2019-12-01T00:00:00.000+01:00",
"statusResponse": null,
"formulaStatus": "Z33",
"incidentIdentifier": "25001",
"referencedTransactionNumber": null,
"marketLocationAmounts": [
{
"computingStepReference": "2",
"usages": [
"Z47",
"Z84"
],
"id_": 2825325
}
],
"computingSteps": [
{
"computingStep": "1",
"meteringLocation": "DE00721488410000EE210390781001RA0",
"computingStepReference": null,
"mathematicalOperator": "Z69",
"flowDirection": "Z72",
"lossFactorTrafo": null,
"lossFactorCable": null,
"id_": -1457309693
},
{
"computingStep": "1",
"meteringLocation": "DE0072148841000000000000000956988",
"computingStepReference": null,
"mathematicalOperator": "Z70",
"flowDirection": "Z72",
"lossFactorTrafo": null,
"lossFactorCable": null,
"id_": -509753975
},
{
"computingStep": "2",
"meteringLocation": null,
"computingStepReference": "1",
"mathematicalOperator": "Z83",
"flowDirection": null,
"lossFactorTrafo": null,
"lossFactorCable": null,
"id_": 148259665
}
],
"id_": 292761251
}