The retail customer schema provides details about a UsagePoint that are considered Personally identifiable information (PII) and cannot be part of normal ESPI usage information. These resources are available via the same messaging patterns as other ESPI data. However, they are defined in a separate namespace and cannot be retrieved in the same message as non-PII containing ESPI data. Organisation receiving services from service supplier. Kind of customer. True if customer organisation has special service needs such as life support, hospitals, etc. (use 'priority' instead) True if this is an important customer. Importance is for matters different than those in 'specialNeed' attribute. (if applicable) Public utilities commission (PUC) identification number. Status of this customer. Priority of the customer. Locale designating language to use in communications with this customer. Assignment of a group of products and services purchased by the customer through a customer agreement, used as a mechanism for customer billing and payment. It contains common information from the various types of customer agreements to create billings (invoices) for a customer and receive payment. Cycle day on which the associated customer account will normally be billed, used to determine when to produce the billing. Budget bill code. The last amount that will be billed to the customer prior to shut off of the account. Set of customer account notifications. [extension] Customer contact information used to identify individual responsible for billing and payment of CustomerAccount. Agreement between the customer and the service supplier to pay for service at a specific service location. It records certain billing information about the type of service provided at the service location and is used during charge creation to determine the type of service. Load management code. If true, the customer is a pre-pay customer for the specified service. Final date and time the service will be billed to the previous customer. Demand Response program characteristics covered by Customer Agreement All pricing structures applicable to this customer agreement. Currency for all monetary amounts for this agreement. [extension] Known future changes to CustomerAgreement's Status of Service. Asset container that performs one or more end device functions. One type of end device is a meter which can perform metering, load management, connect/disconnect, accounting functions, etc. Some end devices, such as ones monitoring and controlling air conditioners, refrigerators, pool pumps may be connected to a meter. All end devices may have communication capability defined by the associated communication function(s). An end device may be owned by a consumer, a service provider, utility or otherwise. There may be a related end device function that identifies a sensor or control point within a metering application or communications systems (e.g., water, gas, electricity). Some devices may use an optical port that conforms to the ANSI C12.18 standard for communications. If true, there is no physical device. As an example, a virtual meter can be defined to aggregate the consumption for two or more physical meters. Otherwise, this is a physical hardware device. If true, this is a premises area network (PAN) device. Installation code. Automated meter reading (AMR) or other communication system responsible for communications to this end device. Physical asset that performs the metering role of the usage point. Used for measuring consumption and detection of events. Meter form designation per ANSI C12.10 or other applicable standard. An alphanumeric designation denoting the circuit arrangement for which the meter is applicable and its specific terminal arrangement. All multipliers applied at this meter. [extension] Current interval length specified in seconds. [extension] Collection of all customer Energy Efficiency programs [extension] Program date description A real estate location, commonly referred to as premises. Method for the service person to access this service location. For example, a description of where to obtain a key if the facility is unmanned and secured. Problems previously encountered when visiting or performing work on this location. Examples include: bad dog, violent customer, verbally abusive occupant, obstructions, safety hazards, etc. True if inspection is needed of facilities at this service location. This could be requested by a customer, due to suspected tampering, environmental concerns (e.g., a fire in the vicinity), or to correct incompatible data. All usage points delivering service (of the same type) to this service location. [extension] Outage Block Identifier Organisation that provides services to customers. Kind of supplier. Unique transaction reference prefix number issued to an entity by the International Organization for Standardization for the purpose of tagging onto electronic financial transactions, as defined in ISO/IEC 7812-1 and ISO/IEC 7812-2. [extension] Effective Date of Service Activation [extension] Contains attributes related to the configuration of the time service. Rule to calculate end of daylight savings time in the current year. Result of dstEndRule must be greater than result of dstStartRule. Daylight savings time offset from local standard time. Rule to calculate start of daylight savings time in the current year. Result of dstEndRule must be greater than result of dstStartRule. Local time zone offset from UTCTime. Does not include any daylight savings time offsets. A 128-bit field encoded as a hex string (32 characters / 16 octets) A 32-bit field encoded as a hex string (8 characters / 4 octets) A 16-bit field encoded as a hex string (4 characters / 2 octets) An 8-bit field encoded as a hex string (2 characters / 1 octets) [extension] Character string of max length 512 Character string of max length 256 Character string of max length 64 Character string of max length 32 Unsigned integer, max inclusive 281474976710655 (2^48-1), restriction of xs:unsignedLong Unsigned integer, max inclusive 4294967295 (2^32-1), same as xs:unsignedInt Unsigned integer, max inclusive 65535 (2^16-1), same as xs:unsignedShort Unsigned integer, max inclusive 255 (2^8-1), same as xs:unsignedByte Signed integer, max inclusive -140737488355327 to +140737488355327 (2^47-1), restriction of xs:long Signed integer, max inclusive (2^16-1), restriction of xs:short Percentage on a defined base. For example, specify as 100 to indicate at the defined base. Time is a signed 64-bit value representing the number of seconds since 0 hours, 0 minutes, 0 seconds, on the 1st of January, 1970. This pattern defines a UUID Acceptance test for assets. True if asset has passed acceptance test and may be placed in or is in service. It is set to false if asset is removed from service and is required to be tested again before being placed back in service, possibly in a new location. Since asset may go through multiple tests during its lifecycle, the date of each acceptance test may be recorded in 'Asset.ActivityRecord.status.dateTime'. Date and time the asset was last tested using the 'type' of test and yielding the current status in 'success' attribute. timedate of notification annotation of the reason for the notification delinquency,move in, move out ... Formal agreement between two parties defining the terms and conditions for a set of services. The specifics of the services are, in turn, defined via one or more service agreements. Date this agreement was consummated among associated persons and/or organisations. Date and time interval this agreement is valid (from going into effect to termination). Tangible resource of the utility, including power system equipment, various end devices, cabinets, buildings, etc. For electrical network equipment, the role of the asset is defined through PowerSystemResource and its subclasses, defined mainly in the Wires model (refer to IEC61970-301 and model package IEC61970::Wires). Asset description places emphasis on the physical characteristics of the equipment fulfilling that role. Utility-specific classification of Asset and its subtypes, according to their corporate standards, practices, and existing IT systems (e.g., for management of assets, maintenance, work, outage, customers, etc.). Uniquely tracked commodity (UTC) number. Serial number of this asset. Lot number for this asset. Even for the same model and version number, many assets are manufactured in lots. Purchase price of asset. True if asset is considered critical for some reason (for example, a pole with critical attachments). Electronic address. Lifecycle dates for this asset. Information on acceptance test. Condition of asset in inventory or at time of installation. Examples include new, rebuilt, overhaul required, other. Refer to inspection data for information on the most current condition of the asset. Whenever an asset is reconditioned, percentage of expected life for the asset when it was new; zero for new devices. Status of this asset. Asset that is aggregation of other assets such as conductors, transformers, switchgear, land, fences, buildings, equipment, vehicles, etc. Includes elements that make it possible to include multiple transactions in a single (batch) request. An identifier for this object that is only unique within the containing collection. Specifies the operation requested of this item. Indicates the status code of the associated transaction. Indicates the reason for the indicated status code. Interval of date and time. End is not included because it can be derived from the start and the duration. [correction] Duration of the interval, in seconds. [correction] Date and time that this interval started. [extension] Demand Response program characteristics covered by Customer Agreement [extension] Name of Demand Response program [extension] Retail Customer's current Demand Response program enrollment status [extension] URI of Demand Response program description [extension] All Demand Response program enrollment and termination dates [extension] Summary measurement of Capacity Reservation [extension] Summary measurement of Demand Response Parent class for different groupings of information collected and managed as a part of a business process. It will frequently contain references to other objects, such as assets, people and power system resources. Utility-specific classification of this document, according to its corporate standards, practices, and existing IT systems (e.g., for management of assets, maintenance, work, outage, customers, etc.). Name of the author of this document. Date and time that this document was created. Date and time this document was last modified. Documents may potentially be modified many times during their lifetime. Revision number for this document. Electronic address. Document subject. Document title. Status of this document. For status of subject matter this document represents (e.g., Agreement, Work), use 'status' attribute. Example values for 'docStatus.status' are draft, approved, cancelled, etc. Status of subject matter (e.g., Agreement, Work) this document represents. For status of the document itself, use 'docStatus' attribute. Free text comment. Electronic address information. Address on local area network. MAC (Media Access Control) address. Primary email address. Alternate email address. World wide web address. Radio address. User ID needed to log in, which can be for an individual person, an organisation, a location, etc. Password needed to log in. This is a root class to provide common naming attributes for all classes needing naming attributes identifier of object instance The place, scene, or point of something where someone or something has been, is, and/or will be at a given moment in time. It can be defined with one or more postition points (coordinates) in a given coordinate system. Classification by utility's corporate standards and practices, relative to the location itself (e.g., geographical, functional accounting, etc., not a given property that happens to exist at that location). Main address of the location. Secondary address of the location. For example, PO Box address may have different ZIP code than that in the 'mainAddress'. Phone number. Additional phone number. Electronic address. (if applicable) Reference to geographical information source, often external to the utility. (if applicable) Direction that allows field crews to quickly find a given asset. For a given location, such as a street address, this is the relative direction in which to find the asset. For example, a streetlight may be located at the 'NW' (northwest) corner of the customer's site, or a usage point may be located on the second floor of an apartment building. Status of this location. Sequence of position points describing this location, expressed in coordinate system 'Location.CoordinateSystem'. Dates for lifecycle events of an asset. Date the asset was manufactured. Date the asset was purchased. Note that even though an asset may have been purchased, it may not have been received into inventory at the time of purchase. Date the asset was received and first placed into inventory. (if applicable) Date current installation was completed, which may not be the same as the in-service date. Asset may have been installed at other locations previously. Ignored if asset is (1) not currently installed (e.g., stored in a depot) or (2) not intended to be installed (e.g., vehicle, tool). (if applicable) Date when the asset was last removed from service. Ignored if (1) not intended to be in service, or (2) currently in service. (if applicable) Date the asset is permanently retired from service and may be scheduled for disposal. Ignored if asset is (1) currently in service, or (2) permanently removed from service. Multiplier applied at the meter. Kind of multiplier. Multiplier value. Superclass of all object classes to allow extensions. Contains an extension. Organisation that might have roles as utility, contractor, supplier, manufacturer, customer, etc. Street address. Postal address, potentially different than 'streetAddress' (e.g., another city). Phone number. Additional phone number. Electronic address. Identifies a way in which an organisation may participate in the utility enterprise (e.g., customer, manufacturer, etc). Organisation having this role. Set of spatial coordinates that determine a point, defined in the coordinate system specified in 'Location.CoordinateSystem'. Use a single position point instance to desribe a point-oriented location. Use a sequence of position points to describe a line-oriented object (physical location of non-point oriented objects like cables or lines), or area of an object (like a substation or a geographical zone - in this case, have first and last position point with the same values). X axis position. Y axis position. (if applicable) Z axis position. Grouping of pricing components and prices used in the creation of customer charges and the eligibility criteria under which these terms may be offered to a customer. The reasons for grouping include state, customer classification, site characteristics, classification (i.e. fee price structure, deposit price structure, electric service price structure, etc.) and accounting requirements. Priority definition. Type describing 'rank'; e.g., high, emergency, etc. Justification for 'rank'. [extension] Demand Response Program enrollment or termination date information [extension] Demand Response Program enrollment or termination date [extension] Description of programDate (i.e., Enrollment, Termination, etc.) [extension] Single Demand Response program date mapping [extension] Code value (may be alphanumeric). [extension] Name associated with code. [extension] Optional description of code Current status information relevant to an entity. Status value at 'dateTime'; prior status changes may have been kept in instances of activity records associated with the object to which this status applies. Date and time for which status 'value' applies. Pertinent information regarding the current 'value', as free form text. Reason code or explanation for why an object went to the current status 'value'. General purpose street and postal address information. Street detail. Town detail. Status of this address. Postal code for the address. Post office box. Street details, in the context of address. Designator of the specific location on the street. Name of the street. Suffix to the street name. For example: North, South, East, West. Prefix to the street name. For example: North, South, East, West. Type of street. Examples include: street, circle, boulevard, avenue, road, drive, etc. (if applicable) Utilities often make use of external reference systems, such as those of the town-planner's department or surveyor general's mapping system, that allocate global reference codes to streets. (if applicable) In certain cases the physical location of the place of interest does not have a direct point of entry from the street, but may be located inside a larger structure such as a building, complex, office block, apartment, etc. Number of the apartment or suite. First line of a free form address or some additional address information (for example a mail stop). (if applicable) Second line of a free form address. (if applicable) Third line of a free form address. True if this street is within the legal geographical boundaries of the specified town (default). An aggregated summary measurement reading The multiplier part of the unit of measure, e.g. "kilo" (k) The date and time (if needed) of the summary measurement. The units of the reading, e.g. “Wh” The value of the summary measurement. Reference to a full ReadingType. Telephone number. Country code. Area or region code. City code. Main (local) part of this telephone number. (if applicable) Extension for this telephone number. (if applicable) Dial out code, for instance to call outside an enterprise. (if applicable) Prefix used when calling an international number. Phone number according to ITU E.164. Town details, in the context of address. Town code. Town section. For example, it is common for there to be 36 sections per township. Town name. [extension] Name of county. Name of the state or province. Name of the country. Logical or physical point in the network to which readings or events may be attributed. Used at the place where a physical or virtual meter may be located; however, it is not required that a meter be present. Sequence of UsagePoint URIS Information about a particular location for various forms of work. Specifies the operation requested of this item Create Read Update Delete Code for the currency for costs associated with this ReadingType. The valid values per the standard are defined in CurrencyCode. USD US dollar EUR European euro AUD Australian dollar CAD Canadian dollar CHF Swiss francs CNY Chinese yuan renminbi DKK Danish crown GBP British pound JPY Japanese yen NOK Norwegian crown RUB Russian ruble SEK Swedish crown INR India rupees other Another type of currency. Kind of customer. Residential customer. Residential and commercial customer. Residential and streetlight customer. Residential streetlight or other related customer. Residential farm service customer. Commercial industrial customer. Pumping load customer. Wind machine customer. Customer as energy service supplier. Customer as energy service scheduler. Represents the owning enterprise. Represents a local operator of a larger enterprise. A subsidiary of a larger enterprise. Internal use customer. Other kind of customer. [extension] Bit map encoded rule from which is calculated the start or end time, within the current year, to which daylight savings time offset must be applied. The rule encoding: Bits 0 - 11: seconds 0 - 3599 Bits 12 - 16: hours 0 - 23 Bits 17 - 19: day of the week 0 = not applicable, 1 - 7 (Monday = 1) Bits:20 - 24: day of the month 0 = not applicable, 1 - 31 Bits: 25 - 27: operator (detailed below) Bits: 28 - 31: month 1 - 12 Rule value of 0xFFFFFFFF means rule processing/DST correction is disabled. The operators: 0: DST starts/ends on the Day of the Month 1: DST starts/ends on the Day of the Week that is on or after the Day of the Month 2: DST starts/ends on the first occurrence of the Day of the Week in a month 3: DST starts/ends on the second occurrence of the Day of the Week in a month 4: DST starts/ends on the third occurrence of the Day of the Week in a month 5: DST starts/ends on the forth occurrence of the Day of the Week in a month 6: DST starts/ends on the fifth occurrence of the Day of the Week in a month 7: DST starts/ends on the last occurrence of the Day of the Week in a month An example: DST starts on third Friday in March at 1:45 AM. The rule... Seconds: 2700 Hours: 1 Day of Week: 5 Day of Month: 0 Operator: 4 Month: 3 [extension] Current Demand Response program enrollment status [extension] Currently NOT enrolled in the Demand Response program [extension] Currently enrolled in the Demand Response program [extension] Currently pending enrollment in the Demand Response program Kind of meter multiplier. Meter kh (watthour) constant. The number of watthours that must be applied to the meter to cause one disk revolution for an electromechanical meter or the number of watthours represented by one increment pulse for an electronic meter. Register multiplier. The number to multiply the register reading by in order to get kWh. Test constant. Current transformer ratio used to convert associated quantities to real measurements. Potential transformer ratio used to convert associated quantities to real measurements. Method by which the customer was notified Contacted by phone by customer service representative. Trouble reported by email. Trouble reported by letter. Trouble reported by other means. Trouble reported through interactive voice response system. [extension] Type of Demand Response program date [extension] Date customer enrolled in Demand Response program [extension] Date customer terminated enrollment in Demand Response program [extension] Earliest date customer can terminate Demand Response enrollment, regardless of financial impact [extension] Earliest date customer can terminate Demand Response enrollment, without financial impact Accounting classification of the type of revenue collected for the customer agreement, typically used to break down accounts for revenue accounting. Residential revenue. Non-residential revenue. Commercial revenue. Industrial revenue. Irrigation revenue. Streetlight revenue. Other revenue kind. Kind of service. Electricity service. Gas service. Water service. Time service. Heat service. Refuse (waster) service. Sewerage service. Rates (e.g. tax, charge, toll, duty, tariff, etc.) service. TV license service. Internet service. Other kind of service. indicates the status code of the associated transaction Ok Created No Content Moved Permanently Redirect Not Modified Bad Request Unauthorized Forbidden Not Found Method Not Allowed Gone Internal Server Error Kind of supplier. Entity that delivers the service to the customer. Entity that sells the service, but does not deliver to the customer; applies to the deregulated markets. Other kind of supplier. The power of ten unit multipliers Pico 10**-12 Nano 10**-9 Micro 10**-6 Milli 10**-3 Centi 10**-2 Deci 10**-1 Kilo 10**3 Mega 10**6 Giga 10**9 Tera 10**12 Not Applicable or "x1" deca 10**1 hecto 10**2 Code for the base unit of measure for Readings of ReadingType. Used in combination with the powerOfTenMultiplier to specify the actual unit of measure. Valid values per the standard are defined in UomType. N/A, None Length, meter, m Mass in gram, g Rotational speed, Rotations per second, rev/s Current, ampere, A Temperature, Kelvin, K Amount of substance, mole, mol Luminous intensity, candela, cd Plane angle, degrees, deg Plane angle, Radian (m/m), rad Solid angle, Steradian (m2/m2), sr Absorbed dose, Gray (J/kg), GY Radioactivity, Becquerel (1/s), Bq Relative temperature in degrees Celsius. In the SI unit system the symbol is ºC. Electric charge is measured in coulomb that has the unit symbol C. To distinguish degree Celsius from coulomb the symbol used in the UML is degC. Reason for not using ºC is the special character º is difficult to manage in software. Doe equivalent, Sievert (J/kg), Sv Electric capacitance, Farad (C/V), °C Time, seconds, s Electric inductance, Henry (Wb/A), H Electric potential, Volt (W/A), V Electric resistance, Ohm (V/A), O Energy joule, (N·m = C·V = W·s), J Force newton, (kg m/s²), N Frequency hertz, (1/s), Hz Illuminance lux, (lm/m²), L(uncompensated)/h Luminous flux, lumen (cd sr), Lm Magnetic flux, Weber (V s), Wb Magnetic flux density, Tesla (Wb/m2), T Real power, Watt. By definition, one Watt equals one Joule per second. Electrical power may have real and reactive components. The real portion of electrical power (I²R) or VIcos?, is expressed in Watts. (See also apparent power and reactive power.), W Pressure, Pascal (N/m²)(Note: the absolute or relative measurement of pressure is implied with this entry. See below for more explicit forms.), Pa Area, square meter, m² Volume, cubic meter, m³ Velocity, meters per second (m/s), m/s Acceleration, meters per second squared, m/s² m3PerSec, cubic meters per second, m³/s Fuel efficiency, meters / cubic meter, m/m³ Moment of mass ,kilogram meter (kg·m), M Density, gram/cubic meter (combine with prefix multiplier “k” to form kg/ m³), g/m³ Viscosity, meter squared / second, m²/s Thermal conductivity, Watt/meter Kelvin, W/m K Heat capacity, Joule/Kelvin, J/K Electric conductance, Siemens (A / V = 1 / O), S Angular velocity, radians per second, rad/s Apparent power, Volt Ampere (See also real power and reactive power.), VA Reactive power, Volt Ampere reactive. The “reactive” or “imaginary” component of electrical power (VISin?). (See also real power and apparent power)., VAr Power factor, Dimensionless, cos? Volt seconds, Volt seconds (Ws/A), Vs Volts squared, Volt squared (W2/A2), V² Amp seconds, amp seconds, As Amps squared, amp squared, A2 Amps squared time, square amp second, A²s Apparent energy, Volt Ampere hours, VAh Real energy, Watt hours, Wh Reactive energy, Volt Ampere reactive hours, VArh Magnetic flux, Volts per Hertz, V/Hz Rate of change of frequency, hertz per second, Hz/s Number of characters, characters, char Data rate, characters per second, char/s Turbine inertia, gram·meter2 (Combine with multiplier prefix “k” to form kg·m2.), gm² Sound pressure level, Bel, acoustic, Combine with multiplier prefix “d” to form decibels of Sound Pressure Level“dB (SPL).”, B (SPL) Monetary unit, Generic money (Note: Specific monetary units are identified the currency class)., ¤ Ramp rate, Watts per second, W/s Volumetric flow rate, Volumetric flow rate, L/s Quantity power, Q, Q Quantity energy, Qh, Qh resistivity, ? (rho), ?m A/m, magnetic field strength, Ampere per metre, A/m volt-squared hour, Volt-squared-hours, V²h ampere-squared, Ampere-squared hour, A²h Ampere-hours, Ampere-hours, Ah Wh/m3, energy per volume, Wh/m³ Timestamp, time and date per ISO 8601 format, timeStamp State, "1" = "true", "live", "on", "high", "set"; "0" = "false", "dead", "off", "low", "cleared". Note: A Boolean value is preferred but other values may be supported, status Amount of substance, counter value, count Signal Strength, Bel-mW, normalized to 1mW. Note: to form “dBm” combine “Bm” with multiplier “d”. Bm Application Value, encoded value, code Kh-Wh, active energy metering constant, Wh/rev Kh-VArh, reactive energy metering constant, VArh/rev Kh-Vah, apparent energy metering constant, VAh/rev EndDeviceEvent, value to be interpreted as a EndDeviceEventCode, meCode Volume, cubic feet, ft³ Volume, cubic feet, ft³(compensated) Volumetric flow rate, compensated cubic feet per hour, ft³(compensated)/h Volumetric flow rate, cubic meters per hour, m³/h Volumetric flow rate, compensated cubic meters per hour, ³(compensated)/h Volumetric flow rate, uncompensated cubic meters per hour, m³(uncompensated)/h Volume, US gallons, Gal Volumetric flow rate, US gallons per hour, USGal/h Volume, imperial gallons, ImperialGal Volumetric flow rate, Imperial gallons per hour, ImperialGal/h Energy, British Thermal Units, BTU Power, BTU per hour, BTU/h Volume, litre = dm3 = m3/1000., L Volumetric flow rate, litres per hour, L/h Volumetric flow rate, litres (compensated) per hour, L(compensated)/h Volumetric flow rate, litres (uncompensated) per hour, L(uncompensated)/h Pressure, Pascal, gauge pressure, PaG Pressure, Pounds per square inch, absolute, psiA Pressure, Pounds per square inch, gauge, psiG Concentration, The ratio of the volume of a solute divided by the volume of the solution., L/L Concentration, The ratio of the mass of a solute divided by the mass of the solution., g/g Concentration, The amount of substance concentration, (c), the amount of solvent in moles divided by the volume of solution in m³., mol/ m³ Concentration, Molar fraction (?), the ratio of the molar amount of a solute divided by the molar amount of the solution.,mol/mol Concentration, Molality, the amount of solute in moles and the amount of solvent in kilograms., mol/kg Length, Ratio of length, m/m Time, Ratio of time (can be combined with an multiplier prefix to show rates such as a clock drift rate, e.g. “µs/s”), s/s Frequency, Rate of frequency change, Hz/Hz Voltage, Ratio of voltages (e.g. mV/V), V/V Current, Ratio of Amperages, A/A Power Factor, PF, W/VA Amount of rotation, Revolutions, rev Pressure, Pascal, absolute pressure, PaA Volume, litre, with the value uncompensated for weather effects., L(uncompensated) Volume, litre, with the value compensated for weather effects, L(compensated) Catalytic activity, katal = mol / s, kat Time, minute = s * 60, min Time, hour = minute * 60, h Quantity power, Q measured at 45º, Q45 Quantity power, Q measured at 60º, Q60 Quantity energy, Q measured at 45º, Q45h Quantity energy, Qh measured at 60º, Q60h Specific energy, Joules / kg, J/kg m3uncompensated, cubic meter, with the value uncompensated for weather effects., m3(uncompensated) Volume, cubic meter, with the value compensated for weather effects., m3(compensated) Signal Strength, Ratio of power, W/W Energy, Therm, therm