United Nations Directories for Electronic Data Interchange for Administration, Commerce and Transport UN/EDIFACT |
Message Type : UTILTS Version : D Release : 06A Contr. Agency: UN Revision : 4 Date : 2006-09-25 SOURCE: TBG1 Supply Chain CONTENTS Utilities time series message 0. INTRODUCTION 1. SCOPE 1.1 Functional definition 1.2 Field of application 1.3 Principles 2. REFERENCES 3. TERMS AND DEFINITIONS 3.1 Standard terms and definitions 3.2 Message terms and definitions 4. MESSAGE DEFINITION 4.1 Segment clarification 4.2 Segment index (alphabetical sequence by tag) 4.3 Message structure 4.3.1 Segment table ---------------------------------------------------------------------- For general information on UN standard message types see UN Trade Data Interchange Directory, UNTDID, Part 4, Section 2.3, UN/ECE UNSM General Introduction ---------------------------------------------------------------------- 0. INTRODUCTION This specification provides the definition of the Utilities time series message (UTILTS) to be used in Electronic Data Interchange (EDI) between trading partners involved in administration, commerce and transport. 1. SCOPE 1.1 Functional definition The Utilities time series message is sent between responsible parties in a utilities infrastructure for the purpose of reporting time series and connected technical and/or administrative information. 1.2 Field of application The Utilities time series message may be used for both national and international applications. It is based on universal practice related to administration, commerce and transport, and is not dependent on the type of business or industry. 1.3 Principles The Utilities time series message may contain time series for metered values, forecasts, estimates, prices, etc. Connected to each time series there may be technical and administrative information, such as characteristics of a meter, exchange rates, etc. Each time series will be identified by the companies and/or locations that are reported, the product and the validity time period. The message may be an initial message and does not require a response. 2. REFERENCES See UNTDID, Part 4, Chapter 2.3 UN/ECE UNSM - General Introduction, Section 1. 3. TERMS AND DEFINITIONS 3.1 Standard terms and definitions See UNTDID, Part 4, Chapter 2.3 UN/ECE UNSM - General Introduction, Section 2. 3.2 Message terms and definitions TIME SERIES: A sequence of observations of a single process often taken at equal time intervals. 4. MESSAGE DEFINITION 4.1 Segment clarification This section should be read in conjunction with the segment table which indicates mandatory, conditional and repeating requirements. 0010 UNH, Message header A service segment starting and uniquely identifying a message. The message type code for the Utilities time series message is UTILTS. Note: Utilities time series messages conforming to this document must contain the following data in segment UNH, composite S009: Data element 0065 UTILTS 0052 D 0054 06A 0051 UN 0020 BGM, Beginning of message A segment by which the sender uniquely identifies the Utilities time series message by means of its name and number and when necessary its function. 0030 DTM, Date/time/period A segment specifying general dates and, when relevant, times related to the whole message. The segment must be specified at least once to specify the message date as allocated by the sender. 0040 MKS, Market/sales channel information A segment to specify to which market and/or through which sales distribution channel and/or for which end-use the time series relates. 0050 PRC, Process identification A segment used to identify the type of process that the message is covering or the process that was used in its creation. For example, day ahead schedule or settlement. 0060 Segment group 1: RFF-DTM A group of segments giving references and, where necessary, their dates relating to the whole message. 0070 RFF, Reference A segment identifying a reference by its type and number. 0080 DTM, Date/time/period A segment specifying general dates, and when relevant, time related tot the whole message. The segment must be specified at least once to specify the message date as allocated by the sender. 0090 Segment group 2: NAD-RFF-ATT-SG3 A group of segments identifying the parties with associated information relevant to the whole message. 0100 NAD, Name and address A segment identifying names and addresses of the parties, in coded or clear form, and their functions relevant to the message. It is recommended that, if possible, only the coded form of the party ID should be specified. 0110 RFF, Reference A segment for inclusion of any references related to the current party, e.g. fiscal number, government reference number, etc. 0120 ATT, Attribute A segment used to identify attributes of the relevant party, such as additional functions of the sender or receiver. 0130 Segment group 3: CTA-COM A group of segments giving contact details of a specific person and/or department within the party identified. 0140 CTA, Contact information A segment to identify a person and/or department, and their function, to whom communications should be directed. 0150 COM, Communication contact A segment to identify a communication type and number for the contact specified. 0160 Segment group 4: CUX-DTM-STS A group of segments specifying the currencies, related dates/periods and status for the rate of exchange valid for the whole message. 0170 CUX, Currencies A segment identifying the currencies specified in the message, such as the currency in which the prices are expressed. A rate of exchange may be given to convert a reference currency into a target currency. 0180 DTM, Date/time/period A segment specifying the date/time/period related to the rate of exchange. 0190 STS, Status A segment giving a status for the range of exchange, such as if the exchange rate is preliminary or accurate. 0200 Segment group 5: IDE-LOC-NAD-ALI-LIN-PIA-IMD-DTM-PRC-STS-AGR- MEA-FTX-SG6-SG7-SG8 A group of segments providing details of the time series and connected technical and/or administrative information. In addition to the time series itself, this includes identification of the time series, associated dates, references, characteristics, etc. 0210 IDE, Identity A segment identifying a time series, the type of object and the product or service being reported in the time series (e.g. electrical energy, electrical power, water, gas). 0220 LOC, Place/location identification A segment to identify location(s) related to the time series. 0230 NAD, Name and address A segment to identify a premise or a party related to the time series. 0240 ALI, Additional information A segment indicating that special condition due to the origin, customs preference, fiscal or commercial factors are applicable. 0250 LIN, Line item A segment used to identify the time series by its product identification. 0260 PIA, Additional product id A segment providing additional identification to the product or service specified. 0270 IMD, Item description A segment to describe the product or service being reported. The segment may be used for specification of the use of the product (e.g. if the product is consumed, produced etc.). 0280 DTM, Date/time/period A segment to specify dates associated with the time series. 0290 PRC, Process identification A segment to specify to which business activity phase the time series relates. 0300 STS, Status A segment giving the status for the time series being reported, such as metered, estimated or corrected. 0310 AGR, Agreement identification A segment for specifying agreement details connected to the time series, such as a contract type. 0320 MEA, Measurements A segment for specifying physical measurements or measurement unit connected to the time series. 0330 FTX, Free text A segment with free text information, in coded or clear form, used when additional information is needed but cannot be accommodated within other segments. In computer to computer exchanges such text will normally require the receiver to process this segment manually. 0340 Segment group 6: RFF-DTM A group of segments for specifying any references and associated dates valid for the current time series. 0350 RFF, Reference A segment identifying any references related to the current time series. 0360 DTM, Date/time/period A segment to specify any dates associated with the current reference. 0370 Segment group 7: CCI-CAV A group of segments providing characteristics and characteristic details connected to the current time series. 0380 CCI, Characteristic/class id A segment to identify characteristic and/or the characteristic name and characteristic relevance for the time series. 0390 CAV, Characteristic value A segment to specify the value of the characteristic previously defined in either coded form or in free format. 0400 Segment group 8: SEQ-DTM-RFF-MOA-PCD-GPO-SG9-SG10-SG11 A group of segments providing details of the observations in a time series. 0410 SEQ, Sequence details A segment to identify the sequence of the observations in a time series. 0420 DTM, Date/time/period A segment to specify a date or a period related to observations in a time series. 0430 RFF, Reference A segment to specify references connected to the observations. 0440 MOA, Monetary amount A segment providing observations of monetary amounts in a time series. 0450 PCD, Percentage details A segment providing observations of percentages in a time series. 0460 GPO, Geographical position A segment used to identify the geographical position of the relevant object. 0470 Segment group 9: CCI-CAV A group of segments providing characteristics and characteristic details connected to the observations, such as the number of digits and the constant of a meter or a register. 0480 CCI, Characteristic/class id A segment to identify characteristic and/or the characteristic name and characteristic relevance for the observations. 0490 CAV, Characteristic value A segment to specify the value of the characteristic previously defined in either coded form or in free format. 0500 Segment group 10: PRI-CUX A group of segments providing observations of prices with related currency, in a time series. 0510 PRI, Price details A segment identifying the price details. 0520 CUX, Currencies A segment identifying the currency applicable for the price. A rate of exchange may be given to convert a reference currency into a target currency. 0530 Segment group 11: QTY-DTM-STS-SG12-SG13 A group of segments providing observation of quantities with related characteristics and statuses, in a time series. 0540 QTY, Quantity A segment identifying the quantity details in a time series. 0550 DTM, Date/time/period A segment to specify a date or a period related to the previous quantity. 0560 STS, Status A segment giving the status for the quantity, e.g. metered, estimated or corrected. 0570 Segment group 12: CCI-CAV A group of segments providing characteristics and characteristic details connected to the quantity. 0580 CCI, Characteristic/class id A segment to identify characteristic and/or the characteristic name and characteristic relevance for the quantity. 0590 CAV, Characteristic value A segment to specify the value of the characteristic previously defined in either coded form or in free format. 0600 Segment group 13: PRI-CUX A group of segments providing one or more prices connected to the previous quantity with related currency. 0610 PRI, Price details A segment identifying the price details. 0620 CUX, Currencies A segment identifying the currency applicable for the price. A rate of exchange may be given to convert a reference currency into a target currency. 0630 CNT, Control total A segment to provide message control totals. 0640 UNT, Message trailer A service segment ending a message, giving the total number of segments in the message (including the UNH & UNT) and the control reference number of the message. 4.2 Segment index (alphabetical sequence by tag) AGR Agreement identification ALI Additional information ATT Attribute BGM Beginning of message CAV Characteristic value CCI Characteristic/class id CNT Control total COM Communication contact CTA Contact information CUX Currencies DTM Date/time/period FTX Free text GPO Geographical position IDE Identity IMD Item description LIN Line item LOC Place/location identification MEA Measurements MKS Market/sales channel information MOA Monetary amount NAD Name and address PCD Percentage details PIA Additional product id PRC Process identification PRI Price details QTY Quantity RFF Reference SEQ Sequence details STS Status UNH Message header UNT Message trailer
4.3 Message structure 4.3.1 Segment table Pos Tag Name S R 0010 UNH Message header M 1 0020 BGM Beginning of message M 1 0030 DTM Date/time/period M 9 0040 MKS Market/sales channel information C 9 0050 PRC Process identification C 9 0060 ----- Segment group 1 ------------------ C 9-----------+ 0070 RFF Reference M 1 | 0080 DTM Date/time/period C 9-----------+ 0090 ----- Segment group 2 ------------------ C 99----------+ 0100 NAD Name and address M 1 | 0110 RFF Reference C 1 | 0120 ATT Attribute C 9 | | 0130 ----- Segment group 3 ------------------ C 9----------+| 0140 CTA Contact information M 1 || 0150 COM Communication contact C 9----------++ 0160 ----- Segment group 4 ------------------ C 99----------+ 0170 CUX Currencies M 1 | 0180 DTM Date/time/period C 9 | 0190 STS Status C 9-----------+ 0200 ----- Segment group 5 ------------------ C 99999-------+ 0210 IDE Identity M 1 | 0220 LOC Place/location identification C 9 | 0230 NAD Name and address C 9 | 0240 ALI Additional information C 9 | 0250 LIN Line item C 9 | 0260 PIA Additional product id C 9 | 0270 IMD Item description C 9 | 0280 DTM Date/time/period C 9 | 0290 PRC Process identification C 9 | 0300 STS Status C 9 | 0310 AGR Agreement identification C 9 | 0320 MEA Measurements C 9 | 0330 FTX Free text C 9 | | 0340 ----- Segment group 6 ------------------ C 99---------+| 0350 RFF Reference M 1 || 0360 DTM Date/time/period C 9----------+| | 0370 ----- Segment group 7 ------------------ C 99---------+| 0380 CCI Characteristic/class id M 1 || 0390 CAV Characteristic value C 99---------+| | 0400 ----- Segment group 8 ------------------ C 99999------+| 0410 SEQ Sequence details M 1 || 0420 DTM Date/time/period C 9 || 0430 RFF Reference C 9 || 0440 MOA Monetary amount C 9 || 0450 PCD Percentage details C 9 || 0460 GPO Geographical position C 9 || || 0470 ----- Segment group 9 ------------------ C 99--------+|| 0480 CCI Characteristic/class id M 1 ||| 0490 CAV Characteristic value C 99--------+|| || 0500 ----- Segment group 10 ------------------ C 9---------+|| 0510 PRI Price details M 1 ||| 0520 CUX Currencies C 9---------+|| || 0530 ----- Segment group 11 ------------------ C 99999-----+|| 0540 QTY Quantity M 1 ||| 0550 DTM Date/time/period C 9 ||| 0560 STS Status C 9 ||| ||| 0570 ----- Segment group 12 ------------------ C 99-------+||| 0580 CCI Characteristic/class id M 1 |||| 0590 CAV Characteristic value C 99-------+||| ||| 0600 ----- Segment group 13 ------------------ C 9--------+||| 0610 PRI Price details M 1 |||| 0620 CUX Currencies C 9--------++++ 0630 CNT Control total C 9 0640 UNT Message trailer M 1