UN/EDIFACT Message Type : Batch : UTILTS

__ United Nations Directories for Electronic Data Interchange for Administration, Commerce and Transport __UN/EDIFACT

Message Type : UTILTS Version : D Release : 08A Contr. Agency: UN Revision : 5 Date : 2008-05-30 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. 0010UNH, 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 08A 0051 UN 0020BGM, 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. 0030DTM, 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. 0040MKS, 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. 0050PRC, 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. 0070RFF, Reference A segment identifying a reference by its type and number. 0080DTM, 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. 0100NAD, 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. 0110RFF, Reference A segment for inclusion of any references related to the current party, e.g. fiscal number, government reference number, etc. 0120ATT, 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. 0140CTA, Contact information A segment to identify a person and/or department, and their function, to whom communications should be directed. 0150COM, 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. 0170CUX, 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. 0180DTM, Date/time/period A segment specifying the date/time/period related to the rate of exchange. 0190STS, 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. 0210IDE, 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). 0220LOC, Place/location identification A segment to identify location(s) related to the time series. 0230NAD, Name and address A segment to identify a premise or a party related to the time series. 0240ALI, Additional information A segment indicating that special condition due to the origin, customs preference, fiscal or commercial factors are applicable. 0250LIN, Line item A segment used to identify the time series by its product identification. 0260PIA, Additional product id A segment providing additional identification to the product or service specified. 0270IMD, 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.). 0280DTM, Date/time/period A segment to specify dates associated with the time series. 0290PRC, Process identification A segment to specify to which business activity phase the time series relates. 0300STS, Status A segment giving the status for the time series being reported, such as metered, estimated or corrected. 0310AGR, Agreement identification A segment for specifying agreement details connected to the time series, such as a contract type. 0320MEA, Measurements A segment for specifying physical measurements or measurement unit connected to the time series. 0330FTX, 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. 0350RFF, Reference A segment identifying any references related to the current time series. 0360DTM, 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. 0380CCI, Characteristic/class id A segment to identify characteristic and/or the characteristic name and characteristic relevance for the time series. 0390CAV, 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. 0410SEQ, Sequence details A segment to identify the sequence of the observations in a time series. 0420DTM, Date/time/period A segment to specify a date or a period related to observations in a time series. 0430RFF, Reference A segment to specify references connected to the observations. 0440MOA, Monetary amount A segment providing observations of monetary amounts in a time series. 0450PCD, Percentage details A segment providing observations of percentages in a time series. 0460GPO, 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. 0480CCI, Characteristic/class id A segment to identify characteristic and/or the characteristic name and characteristic relevance for the observations. 0490CAV, 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. 0510PRI, Price details A segment identifying the price details. 0520CUX, 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. 0540QTY, Quantity A segment identifying the quantity details in a time series. 0550DTM, Date/time/period A segment to specify a date or a period related to the previous quantity. 0560STS, 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. 0580CCI, Characteristic/class id A segment to identify characteristic and/or the characteristic name and characteristic relevance for the quantity. 0590CAV, 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. 0610PRI, Price details A segment identifying the price details. 0620CUX, 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. 0630CNT, Control total A segment to provide message control totals. 0640UNT, 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 0010UNH Message header M 1 0020BGM Beginning of message M 1 0030DTM Date/time/period M 9 0040MKS Market/sales channel information C 9 0050PRC Process identification C 9 0060 ----- Segment group 1 ------------------ C 9-----------+ 0070RFF Reference M 1 | 0080DTM Date/time/period C 9-----------+ 0090 ----- Segment group 2 ------------------ C 99----------+ 0100NAD Name and address M 1 | 0110RFF Reference C 1 | 0120ATT Attribute C 9 | | 0130 ----- Segment group 3 ------------------ C 9----------+| 0140CTA Contact information M 1 || 0150COM Communication contact C 9----------++ 0160 ----- Segment group 4 ------------------ C 99----------+ 0170CUX Currencies M 1 | 0180DTM Date/time/period C 9 | 0190STS Status C 9-----------+ 0200 ----- Segment group 5 ------------------ C 99999-------+ 0210IDE Identity M 1 | 0220LOC Place/location identification C 9 | 0230NAD Name and address C 9 | 0240ALI Additional information C 9 | 0250LIN Line item C 9 | 0260PIA Additional product id C 9 | 0270IMD Item description C 9 | 0280DTM Date/time/period C 9 | 0290PRC Process identification C 9 | 0300STS Status C 9 | 0310AGR Agreement identification C 9 | 0320MEA Measurements C 9 | 0330FTX Free text C 9 | | 0340 ----- Segment group 6 ------------------ C 99999------+| 0350RFF Reference M 1 || 0360DTM Date/time/period C 9----------+| | 0370 ----- Segment group 7 ------------------ C 99---------+| 0380CCI Characteristic/class id M 1 || 0390CAV Characteristic value C 99---------+| | 0400 ----- Segment group 8 ------------------ C 99999------+| 0410SEQ Sequence details M 1 || 0420DTM Date/time/period C 9 || 0430RFF Reference C 9 || 0440MOA Monetary amount C 9 || 0450PCD Percentage details C 9 || 0460GPO Geographical position C 9 || || 0470 ----- Segment group 9 ------------------ C 99--------+|| 0480CCI Characteristic/class id M 1 ||| 0490CAV Characteristic value C 99--------+|| || 0500 ----- Segment group 10 ------------------ C 9---------+|| 0510PRI Price details M 1 ||| 0520CUX Currencies C 9---------+|| || 0530 ----- Segment group 11 ------------------ C 99999-----+|| 0540QTY Quantity M 1 ||| 0550DTM Date/time/period C 9 ||| 0560STS Status C 9 ||| ||| 0570 ----- Segment group 12 ------------------ C 99-------+||| 0580CCI Characteristic/class id M 1 |||| 0590CAV Characteristic value C 99-------+||| ||| 0600 ----- Segment group 13 ------------------ C 9--------+||| 0610PRI Price details M 1 |||| 0620CUX Currencies C 9--------++++ 0630CNT Control total C 9 0640UNT Message trailer M 1