CustomerAgreement

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.

Type

Class

URI

cim:CustomerAgreement

CIM standard (perspective)

IEC61968 (Enterprise)

Class hierarchy

Slots

Associated classes
Figure 1. Associated classes
Name Cardinality Type Description

Customer

1

Customer

Customer for this agreement.

CustomerAccount

1

CustomerAccount

Customer account owning this agreement.

ServiceSupplier

1

ServiceSupplier

Service supplier for this customer agreement.

InstanceSet

1

InstanceSet

Dataset containing the data objects.

MeterReadSchedule

0..1

MeterReadSchedule

Meter read schedule that applies to the customer agreement

ServiceCategory

0..1

ServiceCategory

Service category for this agreement.

StandardIndustryCode

0..1

StandardIndustryCode

n/a

isPrePay

0..1

boolean

If true, the customer is a pre-pay customer for the specified service.

loadMgmt

0..1

string

Load management code.

shutOffDateTime

0..1

date

Final date and time the service will be billed to the previous customer.

AuxiliaryAgreements

0..*

AuxiliaryAgreement

All (non-service related) auxiliary agreements that refer to this customer agreement.

DemandResponsePrograms

0..*

DemandResponseProgram

All demand response programs the customer is enrolled in through this customer agreement.

MeterReadings

0..*

MeterReading

(could be deprecated in the future) All meter readings for this customer agreement.

PricingStructures

0..*

PricingStructure

All pricing structures applicable to this customer agreement.

ServiceLocations

0..*

ServiceLocation

All service locations regulated by this customer agreement.

UsagePoints

0..*

UsagePoint

All service delivery points regulated by this customer agreement.

Approver

0..1

Approver

Approver of this document.

Author

0..1

Author

Author of this document.

Editor

0..1

Editor

Editor of this document.

Issuer

0..1

Issuer

Issuer of this document.

PropertiesCIMDataObject

0..1

ChangeSetMember

The single CIM data object in the appropriate dataset context.

aliasName

0..1

string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy. The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

authorName

0..1

string

Name of the author of this document.

comment

0..1

string

Free text comment.

createdDateTime

0..1

date

Date and time that this document was created.

description

0..1

string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

docStatus

0..1

Status

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.

electronicAddress

0..1

ElectronicAddress

Electronic address.

lastModifiedDateTime

0..1

date

Date and time this document was last modified. Documents may potentially be modified many times during their lifetime.

mRID

0..1

string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended. For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

name

0..1

string

The name is any free human readable and possibly non unique text naming the object.

revisionNumber

0..1

string

Revision number for this document.

signDate

0..1

date

Date this agreement was consummated among associated persons and/or organisations.

status

0..1

Status

Status of subject matter (e.g., Agreement, Work) this document represents. For status of the document itself, use 'docStatus' attribute.

subject

0..1

string

Document subject.

title

0..1

string

Document title.

type

0..1

string

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.).

validityInterval

0..1

DateTimeInterval

Date and time interval this agreement is valid (from going into effect to termination).

ActivityRecord

0..*

ActivityRecord

The activity record for a document

ConfigurationEvents

0..*

ConfigurationEvent

All configuration events created for this document.

DiagramObjects

0..*

DiagramObject

The diagram objects that are associated with the domain object.

Names

0..*

Name

All names of this identified object.

TargetingCIMDataObject

0..*

ChangeSetMember

Data objects registered.


ActivityRecord

The activity record for a document

URI

cim:Document.ActivityRecord

Cardinality

0..*

Type

ActivityRecord

Inherited from

Document

aliasName

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy. The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

URI

cim:IdentifiedObject.aliasName

Cardinality

0..1

Type

string

Inherited from

IdentifiedObject

Approver

Approver of this document.

URI

cim:Document.Approver

Cardinality

0..1

Type

Approver

Inherited from

Document

Author

Author of this document.

URI

cim:Document.Author

Cardinality

0..1

Type

Author

Inherited from

Document

authorName

Name of the author of this document.

URI

cim:Document.authorName

Cardinality

0..1

Type

string

Inherited from

Document

AuxiliaryAgreements

All (non-service related) auxiliary agreements that refer to this customer agreement.

URI

cim:CustomerAgreement.AuxiliaryAgreements

Cardinality

0..*

Type

AuxiliaryAgreement

comment

Free text comment.

URI

cim:Document.comment

Cardinality

0..1

Type

string

Inherited from

Document

ConfigurationEvents

All configuration events created for this document.

URI

cim:Document.ConfigurationEvents

Cardinality

0..*

Type

ConfigurationEvent

Inherited from

Document

createdDateTime

Date and time that this document was created.

URI

cim:Document.createdDateTime

Cardinality

0..1

Type

date

Inherited from

Document

Customer

Customer for this agreement.

URI

cim:CustomerAgreement.Customer

Cardinality

1

Type

Customer

CustomerAccount

Customer account owning this agreement.

URI

cim:CustomerAgreement.CustomerAccount

Cardinality

1

Type

CustomerAccount

DemandResponsePrograms

All demand response programs the customer is enrolled in through this customer agreement.

URI

cim:CustomerAgreement.DemandResponsePrograms

Cardinality

0..*

Type

DemandResponseProgram

description

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

URI

cim:IdentifiedObject.description

Cardinality

0..1

Type

string

Inherited from

IdentifiedObject

DiagramObjects

The diagram objects that are associated with the domain object.

URI

cim:IdentifiedObject.DiagramObjects

Cardinality

0..*

Type

DiagramObject

Inherited from

IdentifiedObject

docStatus

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.

URI

cim:Document.docStatus

Cardinality

0..1

Type

Status

Inherited from

Document

Editor

Editor of this document.

URI

cim:Document.Editor

Cardinality

0..1

Type

Editor

Inherited from

Document

electronicAddress

Electronic address.

URI

cim:Document.electronicAddress

Cardinality

0..1

Type

ElectronicAddress

Inherited from

Document

InstanceSet

Dataset containing the data objects.

URI

cim:IdentifiedObject.InstanceSet

Cardinality

1

Type

InstanceSet

Inherited from

IdentifiedObject

isPrePay

If true, the customer is a pre-pay customer for the specified service.

URI

cim:CustomerAgreement.isPrePay

Cardinality

0..1

Type

boolean

Issuer

Issuer of this document.

URI

cim:Document.Issuer

Cardinality

0..1

Type

Issuer

Inherited from

Document

lastModifiedDateTime

Date and time this document was last modified. Documents may potentially be modified many times during their lifetime.

URI

cim:Document.lastModifiedDateTime

Cardinality

0..1

Type

date

Inherited from

Document

loadMgmt

Load management code.

URI

cim:CustomerAgreement.loadMgmt

Cardinality

0..1

Type

string

MeterReadings

(could be deprecated in the future) All meter readings for this customer agreement.

URI

cim:CustomerAgreement.MeterReadings

Cardinality

0..*

Type

MeterReading

MeterReadSchedule

Meter read schedule that applies to the customer agreement

URI

cim:CustomerAgreement.MeterReadSchedule

Cardinality

0..1

Type

MeterReadSchedule

mRID

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended. For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

URI

cim:IdentifiedObject.mRID

Cardinality

0..1

Type

string

Inherited from

IdentifiedObject

name

The name is any free human readable and possibly non unique text naming the object.

URI

cim:IdentifiedObject.name

Cardinality

0..1

Type

string

Inherited from

IdentifiedObject

Names

All names of this identified object.

URI

cim:IdentifiedObject.Names

Cardinality

0..*

Type

Name

Inherited from

IdentifiedObject

PricingStructures

All pricing structures applicable to this customer agreement.

URI

cim:CustomerAgreement.PricingStructures

Cardinality

0..*

Type

PricingStructure

PropertiesCIMDataObject

The single CIM data object in the appropriate dataset context.

URI

cim:IdentifiedObject.PropertiesCIMDataObject

Cardinality

0..1

Type

ChangeSetMember

Inherited from

IdentifiedObject

revisionNumber

Revision number for this document.

URI

cim:Document.revisionNumber

Cardinality

0..1

Type

string

Inherited from

Document

ServiceCategory

Service category for this agreement.

URI

cim:CustomerAgreement.ServiceCategory

Cardinality

0..1

Type

ServiceCategory

ServiceLocations

All service locations regulated by this customer agreement.

URI

cim:CustomerAgreement.ServiceLocations

Cardinality

0..*

Type

ServiceLocation

ServiceSupplier

Service supplier for this customer agreement.

URI

cim:CustomerAgreement.ServiceSupplier

Cardinality

1

Type

ServiceSupplier

shutOffDateTime

Final date and time the service will be billed to the previous customer.

URI

cim:CustomerAgreement.shutOffDateTime

Cardinality

0..1

Type

date

signDate

Date this agreement was consummated among associated persons and/or organisations.

URI

cim:Agreement.signDate

Cardinality

0..1

Type

date

Inherited from

Agreement

StandardIndustryCode

URI

cim:CustomerAgreement.StandardIndustryCode

Cardinality

0..1

Type

StandardIndustryCode

status

Status of subject matter (e.g., Agreement, Work) this document represents. For status of the document itself, use 'docStatus' attribute.

URI

cim:Document.status

Cardinality

0..1

Type

Status

Inherited from

Document

subject

Document subject.

URI

cim:Document.subject

Cardinality

0..1

Type

string

Inherited from

Document

TargetingCIMDataObject

Data objects registered.

URI

cim:IdentifiedObject.TargetingCIMDataObject

Cardinality

0..*

Type

ChangeSetMember

Inherited from

IdentifiedObject

title

Document title.

URI

cim:Document.title

Cardinality

0..1

Type

string

Inherited from

Document

type

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.).

URI

cim:Document.type

Cardinality

0..1

Type

string

Inherited from

Document

UsagePoints

All service delivery points regulated by this customer agreement.

URI

cim:CustomerAgreement.UsagePoints

Cardinality

0..*

Type

UsagePoint

validityInterval

Date and time interval this agreement is valid (from going into effect to termination).

URI

cim:Agreement.validityInterval

Cardinality

0..1

Type

DateTimeInterval

Inherited from

Agreement