Add or update account information in OpenWay Riva

For all installation scenarios, the SetAccount element should be included in the XML sample. If you do not have the account information when you import the installation MDI file, you can import the account information later in a separate MDI file. This scenario may be used to add just the account information.

In the XML file, account information is added to the service point or updated for the service point.

Source of the MDI file

• Customer work order system or FDM work orders

• CIS

• MDM

• For Itron Analytics, the MDI file should always come from OpenWay Operations Center - Collection Manager.

Elements and attributes

For information about the use of special characters, see Special characters.

The following table shows the elements and attributes included in the XML sample.

• Required = This element/attribute is required for this specific scenario. It may not be required in other scenarios.
• Recommended = Itron recommends that you use this element/attribute in this particular scenario.
• Optional = This element/attribute is optional for this scenario and is only required if you want a specific outcome described in the element/attribute definition. To see the element/attribute description, click on the element/attribute in the table or in the XML sample.
• Blank = The application does not use this element and any value in it will be ignored.

Element	Attribute/child element	Collection Manager	Performance Manager	Itron Analytics	Operations Optimizer
SetServicePoint		Required	Required	Required	Required
	ServicePointId	Required	Required	Required	Required
	EquipmentType		Optional	Optional	Optional
	CommodityUsageType			Optional	Optional
	CommodityType		Required	Required	Required
	TimeZone		Required	Recommended	Recommended
	ServicePointStatus			Required	Required
	PremiseId		Required	Required	Required
	UtilityId			Optional	Optional
	PrimaryCollectionSystem			Required	Required
SetAccount				Required	Required
	AccountId			Required	Required
	AccountNumber			Required	Required
	RevenueClass			Optional	Optional
	CustomerFirstName			Optional	Optional
	CustomerLastName			Optional	Optional
	BusinessName			Optional	Optional
BillingAddress				Recommended	Recommended
	StreetAddress			Recommended	Recommended
	City			Recommended	Recommended
	State			Recommended	Recommended
	Zip			Recommended	Recommended
AccountLinkRange				Required	Required
	Start			Required	Required
	End			Optional	Optional

XML sample

<?xml version="1.0" encoding="utf-8"?> 
<MasterDataImport 
	xmlns:xsd = "http://www.w3.org/2001/XMLSchema" 
	xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance" 
	xmlns = "http://www.itron.com/masterdata/2013/03">
	<SetServicePoint
		ServicePointId = "RivaGasSP1"
		EquipmentType = "Endpoint"
		CommodityUsageType  = "RateA"
		CommodityType = "Gas"
		TimeZone = "EasternUS"		
		ServicePointStatus = "Active"
		PremiseId = "RivaGasPremise1"
		UtilityId  = "018"
		PrimaryCollectionSystem = "OpenWayRiva">
		<SetAccount
			AccountId="RivaGasAccount_0100001216"
			AccountNumber="RivaGasAccount_0100001216"
			RevenueClass="Residential"
			CustomerFirstName="B"
			CustomerLastName="Baggins"
			BusinessName="OneRing, Inc.">
			<BillingAddress
				StreetAddress="4404 N Bland Rd"
				City="Raleigh"
				State="NC"
				Zip="27609"/>
			<AccountLinkRange
				Start="BOT"
				End="EOT"/>
		</SetAccount>
	</SetServicePoint>
</MasterDataImport>