UTILMD. Utility Master Data Message Danish EDI Message Implementation Guide for the Gas Market

Transcription

1 UTILMD Utility Master Data Message Danish EDI Message Implementation Guide for the Gas Market Version: Release: 3 Date: August 3, 03 PUBLISHE D BY ENERGINET.DK

2 I n t r o d u c t i o n a n d g e n e r a l p r i n c i p l e s. Introduction and general principles The EDIFACT specification in the following chapters is based on the Message handbook for ebix - Implementation guide for Utility Master Data Message (UTILMD), version 5.0, revision B. Detailed explanations of the individual segments are not provided in this specification, but are to be found in the above-mentioned document.. Data model for UTILMD Document header (UTILMD) +IG version[] +BT combined ID[] +Message name[] +Message id[] +Message function[] +Request for acknowledgement[0..] +Message date[] +Time zone[] +Market[] +Message recipient[] +Message sender[]..* Reference to transaction +Reference to transaction id [] 0.. Transaction +Metering point id[] +Reason for transaction[] +Transaction id[] 0.. Answer status +Status for answer[] +Reason for answer[0..] Validity start date +Validity start date[] Contract stop date +Contract stop date[] Meter data +Estimated annual volume[] Consumer +Consumer party name[] +Consumer party contact address[0..] Contract start date +Contract start date[] Balance supplier +Balance supplier party id[] Balance responsible party +Balance responsible party id[] Metering point characteristic +Meter locatin address[] +Settlement method [] +Physical status for metering point[] Next scheduled meter reading date +Next scheduled meter reading date[0..] Metered: 0 Profiled:.. Figure : Common data model for UTILMD / 9 D K E d i e l M I G f o r U T I L M D

3 3. Mapping table for UTILMD UNH BGM 006 Message reference, e.g. A unique reference for the message within the interchange. S UTILMD The version number of this guide should be stated here. S D The number consists of E5 S B for EDI version 5, DK for Danish and 0 for version number S UN. S E5DK Business Transaction Combined id. Unique identification of the business transaction and version, e.g. DK-BT C = Request to metering point administrator of start of supply (Notification of change of supplier) 406 = Information or confirmation of end of supply (Notification to supplier of contract termination) 44 = Confirmation of start of supply, may include master data for a metering point (Acknowledgement of change of supplier) 43 = Notification to grid operator of end of supply E07 = Master data, metering point EDIFACT- or EDI-code for the identification of the message in relation to the actual business transaction. C = Ediel Nordic Forum Code list responsible agency code. Only to be used for Exx codes 004 Message id, e.g. SPH34 A unique (business related) reference for the message over time. 5 9 = Original message Statement of that the message is a creation (9) NA = No acknowledgement needed Statement of whether the message sender wants an AB = Message acknowledgement acknowledgement for reception is required of the message by the application. This is only used on a bilateral agreement. C = Message date and time Date and the time for composition C Actual date and time of the message. C = Format: CYYMMDDHHmm Not specified in the dependency matrix, but must be included in the message IG version BT combined ID Message name / Meddelelse navn Message id / Meddelelsesidentifikation Message function Request for Acknowledgement / Anmodning om kvittering Message date / Meddelelsesdato

4 MKS SG SG IDE 3 C C C C C = Deviation from UTC = UTC 406 = Format ZHHMM Actual date and time 03 = Format: CYYMMDDHHmm Defines the offset to UTC used for all dates, times and periods in the message. The offset must be expressed in the format ZHHMM, where Z is plus (+) or minus (-). In this guide only must be used The time zone should always be UTC format = Gas supply industry s of the market relevant for the current message. C C E0 = Structuring phase 60 = Ediel Nordic Forum 3035 C MR = Message recipient Recipient s party id The party id of the recipient of the message. Both EAN-GLN and EIC can be used. C = EAN (International Article 305 = ETSO (EIC, ETSO identification code) 3035 C MS = Message sender Sender s party id The party id of the sender of the message. Both EAN-GLN and EIC can be used. C = EAN (International Article 305 = ETSO (EIC, ETSO identification code) 7495 C = Transaction Unique transaction id The sender s unique identification of the transaction. Can be e.g. Message id and line number. Is used as reference when answering. C C C C C C = Contract start date / Kontrakt start dato Date 03 = Format CCYYMMDDHHMM 93 = Contract stop date / Kontrakt stop dato Date 03 = Format CCYYMMDDHHMM C = Validity start date / Gyldighedsdato C C Date 03 = Format CCYYM MDDHHMM Date and time in UTC format for start of supply. Date must be stated as start of a local day where there will be supply, e.g and Date and time in UTC format for end of supply. Date must be stated as start of the day where there is no supply, e.g and Date and time in UTC format to indicate from when data for this transaction is valid. If more data are modified with different validity dates, these must be sent as separate transactions. Time must always be equal to gas day local time. Time zone / Tidszone Market / Marked Message recipient / Modtager af meddelelse Message sender / Afsender af meddelelse Transaction id / Transaktions-id Contract start date / Kontrakt start dato Contract stop date / Kontrakt slut dato Validity start date / Gyldighedsdato 4 / 9 D K E d i e l M I G f o r U T I L M D

5 4 STS C C C = Meter reading date, next scheduled / Aflæsningsdag Date 06 = Format MMDD List of days in the year when the periodical meter reading will take place for the profiled settled metering point. Repeated for every meter reading date in the year. If done at the end of a month, the first date in the next month is used. For metering points that are not read, it is the date when consumption is calculated. Not mentioned for time-series settled metering point. The date is in local time, must not be changed by receiving system. C = Transaction The reason for exchange of the C E0 = Move / Flytning information (transaction) for the concerned metering point. E03 = Change of supplier /Leverandørskifte E05 = Cancellation of transaction / Annullering af tidligere transaction E06 = Unrequested Change of supplier / Overflytning til Forsyningspligtselskab E0 = End of supply / Ophør af leverance E3 = Update of master data, metering point / Stamdata sendt efter aftale Z0 = Change of meter location address / Målepunkt adresse ændret Z03 = Change of next scheduled meter reading date / Aflæsningdag(e) ændret Z04 = Change of estimated annual volume / Forventet årsforbrug ændret Z05 = Change of consumer party name / Disponentnavn(e) ændret Z06 = Change of physical status for metering point / Tilslutningsstatus ændret Z07 = Change of settlement method / Målepunkt afregningsform ændret Z08 = Terminal date changed / Skæringsdato ændret Note that E05 can be used only for cancellation of an already sent message When codes beginning with Z are used, DK must be stated as Code list responsible agency code. Next scheduled meter reading date / Aflæsningsdag Reason for transaction / Transaktionsårsag

6 Z09 = Request for closure / Anmodning om lukning fra Forsyningspligtselskab Z0 = Termination of metering point / Nedlæggelse af Målersted C = Ediel Nordic Forum DK = Danish ebix Group STS SG 5 LOC SG 6 RFF SG 7 CCI C E0 = Answer The status for a response to a C = Ediel Nordic Forum previous transaction, i.e. approved or rejected C = Approved C C = Rejected E0 = Installation address or metering point not identifiable / Målepunkt ikke identificerbart E6 = Unauthorised supplier / Ikke godkendt leverandør E7 = Requested switch date not within time limits / Anmodet skæringsdato ikke inden for tidsfrist E8 = Unauthorised Balance responsible / Ikke godkendt balanceansvarlig E = Metering point blocked for switching / Målepunkt blokeret for skift E59 = Already existing relation (rejection) / Leverandøren er allerede leverandør Z = Consumer name missing (rejection) / Disponentnavn mangler 60 = Ediel Nordic Forum The reason for an answer, used to describe an error code for the Status for answer 4 (rejected)* = Metering point id of the metering point. Every metering point has C57 35 EAN-GSRN-number of Metering a unique EAN-GSRN-number point. of 8 digits. C = EAN (International Article C TN = Reference to transaction id Reference to a received transaction C Transaction id id. C E0 = Settlement method The method used for settlement, such as profiled or nonprofiled. E5 states a metering point settled on a net basis. SG 7 C889 7 E0 = Profiled / Skabelonafregnet E0 = Non-profiled / Timeafregnet Status for answer / Svarstatus Reason for answer / Begrundelse for svar Metering point id / Målepunkt-id Reference to transaction id / Transaktions-id Settlement method / Afregningsmåde 6 / 9 D K E d i e l M I G f o r U T I L M D

7 CAV E5 = Non-profiled, netto / Nettoafregnet SG 7 CCI C E5 = Physical status for metering point Physical status of the Metering point, such as connected or disconnected Physical status for metering point / Tilslutningsstatus SG 7 CAV C889 7 E = Connected / Målepunkt tilsluttet E3 = Disconnected / Målepunkt afbrudt SG 8 SEQ SG 9 QTY SG 9 QTY SG SG C = Register number Not specified in the dependency matrix, but must be included in the message if SG9/QTY is used C = Estimated annual volume Annual volume for the last year C Quantity or the expected annual volume if it is believed to change. Stated C86 64 KWH = Kilowatt-hour in kwh without decimals. Estimated annual volume / Forventet årsforbrug C = Meter reading Meter reading / C Quantity Måleraflæsning C86 64 MTQ = Cubic Metre 3035 DDK = Balance responsible party / Balanceansvarlig C C Balance responsible ID 9 = EAN (International Article 305 = ETSO (EIC, ETSO Code) 3035 IT = Metering point address (Installation on site) C Street name line C Street name line C C House number Coded address 364 City name (fx Fredericia) 35 Postal code (fx 7000) The party id of the Balance Responsible Party for the metering point. Both EAN-GLN and EIC can be used. Address for a metering point. Specified as the name of the street in up to two data elements and the street number including house number, floor, direction and door number. Note, it is not allowed to include local City names in the Street name lines. The fourth repetition of Balance responsible party id / Balanceansvarlig id Meter location address / Målepunkt adresse

8 307 DK C059/304 must state coded address configured as address codes from the CPR register separated by semicolon as follows: Municipality code; (n4) Street code; (n4) House number; (an4) Floor; (an4) Direction/door number; (an4) Country code must be stated as two letter ISO 366 country code. 8 / 9 D K E d i e l M I G f o r U T I L M D

9 SG UD = Consumer, address for correspondence (Ultimate customer) C C Consumer party name / Disponentnavn Second consumer party name / Andet disponentnavn This is the name of the person/company that is allowed to choose a Balance Supplier for a metering point. If a coordinated person is registered, the name of this person can either be a part of the part name or be an independent name. Consumer party name / Disponentnavn SG 4 UNT C C C C Street name line Street name line House number Coded address City name (fx Fredericia) Postal code (fx 7000) DK Valid only for reason for transaction E0 (Move) and E06 (Unrequested Change of supplier). This is the contact address for the customer in moving. Specified as the name of the street in up to two data elements and the street number including house number, floor, direction and door number. The house number does not need to be present, if this is not recorded in the system. In the fourth of repetition of C059/304 it is possible to state coded address configured as address codes from the CPR register separated by semicolon as follows: Municipality code; (n4) Street code; (n4) House number; (an4) Floor; (an4) Direction/door number; (an4) Country code must be stated as two letter ISO 366 country code DDQ = Balance supplier (Balance power supplier) / Elleverandør/gasleverandør C C Balance supplier ID 9 = EAN (International Article 305 = ETSO (EIC, ETSO Code) 0074 Number of segments in the message 006 Message reference number The party id of the Balance Supplier for the metering point. Both EAN-GLN and EIC can be used. The message reference should be equal to UNH 006. Consumer party contact address / Disponent adresse Balance supplier party id / Leverandør id Not specified in the dependency matrix, but must be included in the message