The documentation may have changed since you downloaded the PDF. You can always find the latest information on SAP Help
Portal.
Note
This PDF document contains the selected topic and its subtopics (max. 150) in the selected structure. Subtopics from other structures are not included.
The selected structure has more than 150 subtopics. This download contains only the first 150 subtopics. You can manually download the missing
subtopics.
2015 SAP SE or an SAP affiliate company. All rights reserved. No part of this publication may be reproduced or transmitted in any form or for any purpose
without the express permission of SAP SE. The information contained herein may be changed without prior notice. Some software products marketed by SAP
SE and its distributors contain proprietary software components of other software vendors. National product specifications may vary. These materials are
provided by SAP SE and its affiliated companies ("SAP Group") for informational purposes only, without representation or warranty of any kind, and SAP
Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set
forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional
warranty. SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE in
Germany and other countries. Please see www.sap.com/corporate-en/legal/copyright/index.epx#trademark for additional trademark information and notices.
Table of content
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 1 of 130
Table of content
1 SAP Utilities
1.1 Basic Functions
1.2 Master Data
1.3 Device Management
1.4 Energy Data Management
1.5 Contract Billing
1.6 Invoicing
1.7 Contract Accts Receivable and Payable for the Utilities Industry
1.8 Customer Service
1.9 Work Management
1.10 Information System
1.11 Intercompany Data Exchange
1.12 Advanced Metering Infrastructure
1.13 SAP Utilities Enterprise Services Documentation (EN only)
1.13.1 Business Partner Data Management
1.13.1.1 Business Partner
1.13.1.1.1 Business Partner Replication In
1.13.1.1.1.1 Replicate Business Partner as Bulk
1.13.1.1.2 Business Partner Replication Out
1.13.1.1.2.1 Confirm Business Partner Replication as Bulk
1.13.1.1.3 Business Partner Replication Requesting In
1.13.1.1.3.1 Change Business Partner Replication Status as Bulk
1.13.1.1.4 Business Partner Replication Requesting Out
1.13.1.1.4.1 Request Business Partner Replication as Bulk
1.13.1.2 Payment Card
1.13.1.2.1 Payment Card Processing In
1.13.1.2.1.1 Change Payment Card
1.13.1.2.1.2 Create Payment Card
1.13.1.2.1.3 Read Payment Card
1.13.2 Utilities Business Partner Data Management
1.13.2.1 Utilities Service Provider
1.13.2.1.1 Manage Utilities Service Provider In
1.13.2.1.1.1 Read Utilities Service Provider Basic Data
1.13.2.1.2 Query Utilities Service Provider In
1.13.2.1.2.1 Find Utilities Service Provider by Identification
1.13.3 Measurement Processing
1.13.3.1 Measurement Reading
1.13.3.1.1 Manage Measurement Reading In
1.13.3.1.1.1 Cancel Measurement Reading
1.13.3.1.1.2 Check Measurement Reading Creation
1.13.3.1.1.3 Create Measurement Reading
1.13.3.1.1.4 Read Measurement Reading
1.13.3.1.2 Measurement Reading In
1.13.3.1.2.1 Create Measurement Reading as Bulk
1.13.3.1.3 Query Measurement Reading In
1.13.3.1.3.1 Find Latest Measurement Reading
1.13.3.1.3.2 Find Measurement Reading ERP by Measuring Device
1.13.3.1.3.3 Find Measurement Reading by Elements
1.13.3.2 Meter Reading Card
1.13.3.2.1 Manage Meter Reading Card
1.13.3.2.1.1 Change Meter Reading Card
1.13.3.3 Meter Reading Document
1.13.3.3.1 Manage Meter Reading Document In
1.13.3.3.1.1 Cancel Meter Reading Document
1.13.3.3.1.2 Cancel Meter Reading Document Result
1.13.3.3.1.3 Create Meter Reading Document Result
1.13.3.3.1.4 Create Meter Reading Document With Reference To Utilities Device
1.13.3.3.1.5 Read Meter Reading Document Basic Data
1.13.3.3.2 Meter Reading Document In
1.13.3.3.2.1 Change Meter Reading Document Result as Bulk
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 2 of 130
1.13.3.3.2.2 Change Based on Smart Meter Meter Reading Document Result Creati
1.13.3.3.2.3 Change Based on Smart Meter Meter Reading Document Result Creati
1.13.3.3.2.4 Change Based on Smart Meter Meter Reading Document Creation Conf
1.13.3.3.2.5 Change Based on Smart Meter Meter Reading Document Creation Conf
1.13.3.3.2.6 Change Based on Smart Meter Meter Reading Document Result Change
1.13.3.3.2.7 Change Based on Smart Meter Meter Reading Document Result Change
1.13.3.3.2.8 Change Based on Smart Meter Meter Reading Document Cancellation
1.13.3.3.2.9 Change Based on Smart Meter Meter Reading Document Cancellation
1.13.3.3.2.10 Create Meter Reading Document Result
1.13.3.3.2.11 Create Meter Reading Document Result as Bulk
1.13.3.3.3 Meter Reading Document Out
1.13.3.3.3.1 Notify Meter Reading Document Out
1.13.3.3.3.1.1 Notify of Meter Reading Document Result as Bulk
1.13.3.3.3.2 Confirm Meter Reading Document Result Creation
1.13.3.3.3.3 Confirm Meter Reading Document Result Creation as Bulk
1.13.3.3.3.4 Confirm Meter Reading Document Result Change as Bulk
1.13.3.3.3.5 Request Smart Meter Meter Reading Document Creation
1.13.3.3.3.6 Request Smart Meter Meter Reading Document Creation as Bulk
1.13.3.3.3.7 Request Smart Meter Meter Reading Document Cancellation
1.13.3.3.3.8 Request Smart Meter Meter Reading Document Cancellation as Bulk
1.13.3.3.3.9 Request Smart Meter Meter Reading Document Result Creation
1.13.3.3.3.10 Request Smart Meter Meter Reading Document Result Creation as Bu
1.13.3.3.3.11 Request Smart Meter Meter Reading Document Result Change
1.13.3.3.3.12 Request Smart Meter Meter Reading Document Result Change as Bulk
1.13.3.3.4 Query Meter Reading Document In
1.13.3.3.4.1 Find Meter Reading Document Result by Utilities Device
1.13.3.3.4.2 Find Meter Reading Document by Utilities Device
1.13.3.4 Utilities Measurement Task
1.13.3.4.1 Manage Utilities Measurement Task In
1.13.3.4.1.1 Read Utilities Measurement Task Basic Data
1.13.3.4.2 Notify Utilities Measurement Task Out
1.13.3.4.2.1 Notify of Smart Meter Measurement Task Point Of Delivery Assigne
1.13.3.4.2.2 Notify of Smart Meter Utilities Measurement Task Device Assignme
1.13.3.4.2.3 Notify of Smart Meter Utilities Measurement Task Point Of Delive
1.13.3.4.3 Query Utilities Measurement Task In
1.13.3.4.3.1 Find Utilities Measurement Task by Utilities Point Of Delivery I
1.13.3.4.4 Utilities Measurement Task In
1.13.3.4.4.1 Change Based on Smart Meter Measurement Task Change Confirmation
1.13.3.4.4.2 Change Based on Smart Meter Utilities Measurement Task Change Co
1.13.3.4.5 Utilities Measurement Task Out
1.13.3.4.5.1 Request Smart Meter Utilities Measurement Task Change
1.13.3.4.5.2 Request Smart Meter Utilities Measurement Task Change as Bulk
1.13.4 Service Contract Processing
1.13.5 Utilities Connection Processing
1.13.5.1 Utilities Connection Status Change Request
1.13.5.1.1 Utilities Connection Status Change Request In
1.13.5.1.1.1 Change Based on Smart Meter Connection Status Change Request Bul
1.13.5.1.1.2 Change Based on Smart Meter Connection Status Change Request Can
1.13.5.1.1.3 Change Based on Smart Meter Connection Status Change Request Cre
1.13.5.1.2 Utilities Connection Status Change Request Out
1.13.5.1.2.1 Request Smart Meter Utilities Connection Status Change Request C
1.13.5.1.2.2 Request Smart Meter Utilities Connection Status Change Request C
1.13.5.1.2.3 Request Smart Meter Utilities Connection Status Change Request C
1.13.5.1.2.4 Notify Utilities Connection Status Change Request Out
1.13.5.1.2.4.1 Notify of Smart Meter Utilities Connection Status Change Request
1.13.5.1.2.4.2 Notify Cancellation of Smart Meter Utilities Connection Status C
1.13.5.1.3 Utilities Connection Status Management In
1.13.5.1.3.1 Change Utilities Connection Status Change Request Based on Confi
1.13.5.1.4 Utilities Connection Status Management Out
1.13.5.1.4.1 Request Utilities Connection Status Change Request
1.13.5.1.4.2 Request Utilities Connection Status Change Request Cancellation
1.13.6 Utilities Contract Processing
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 3 of 130
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 4 of 130
SAPUtilities
Purpose
SAP Utilities is a process-oriented sales and information system that supports all services provided by utility and waste disposal companies. You can use
SAP Utilities to manage and bill residential, commercial and industrial, and prospective customers.
In times of deregulated markets and increasing competition, it is vital that you provide the bet possible response to your customers requirements, use
operational information tailored to their specific requirements, and maximize revenue potential. As an integrated component in SAP ERP , SAP Utilities
provides you with all the benefits of a comprehensive and effective Enterprise Resource Planning (ERP) System.
SAP Utilities helps you to keep you business processes as streamlined and as efficient as possible. As a single software solution, SAP Utilities eliminates
incompatible and isolated information in the back office.With SAP Utilities , you can access data at any time from diverse business areas, providing you with
the information you need to make the right decisions.
Integration
Solution Portfolio SAPfor Utilities
SAP Utilities is part of the solution portfolio SAP for Utilities and includes the SAP Utilities (IS-U) industry-specific component.
SAPforUtilities can be integrated with the following applications:
Application
Documentation
BI Content
German
Industry Solutions
Utilities
You can use the Plant Maintenance (PM), Customer Service (CS) and Sales and Distribution (SD) SAP ECC application components to bill service orders,
service contracts, services, and the sale of goods. Due to the large number of postings from billing and budget billing requests, these are posted in a
subledger in Contract Accounts Receivable and Payable (FI-CA) .
SAP Utilities uses SAP Business Workflow to automate the processing of its many business processes. Common workflows include initial creation of a
service connection and the disconnection of devices.
Features
SAPUtilities
You can use Basic Functions to manage addresses and regional structures. You can generate schedules for meter reading, budget billing, and billing.
You can use Master Data to manage data that remains fixed for long periods of time. In IS-U, this data includes the business partners, contracts and
contract accounts, connection objects (buildings and real estate) and the premises, installations, and device locations contained therein.
You can use Device Management to manage the installations, meter reading, and the certification of all devices for a utility company.
The Billing component is used to bill the standard divisions: Electricity, gas, water/waste water, district heating, and multimedia services (for
example, cable TV).
You can use Invoicing to group services and invoice them on one bill. You can also use Invoicing to calculate and charge duty, fees, and taxes.
In Customer Service you can use the Customer Interaction Center (CIC) or Front Office to display all data and start specific business processes. In
Internet-Self-Services your customers can send you new data or changes to their existing data via the Internet. For example, they can grant you
collection authorization or register a move-in.
Energy Data Management (EDM) is a solution that meets the requirements of interval reading, schedule management, and the billing of interval energy
consumption. EDM includes the following functions:
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 5 of 130
Note
If you have any comments or suggestions regarding this documentation, we are always grateful for Feedback .
There are 2 different types of master data: technical and business. These are shown in the graphic below:
Integration
The following table lists the standard application components that must be integrated into device management before you can manage devices. The device,
device category, and device number in the Utilities Industry (IS-U) component correspond to equipment, material, and the serial number in the standard
system:
Name in IS-U
From Component
Device
Equipment
Device Category
Material
Device Number
Serial Number
The device number is created in MM with the Goods Receipt function and transferred to the device. It can also be generated when you create a device in ISU. The device is identified by a unique material and serial number combination to distinguish it from other pieces of material that may have the same serial
number. The equipment number is the same throughout the system.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 6 of 130
Component
Procurement
Delivery
Stock Transfer
Equipment records are created automatically at goods receipt . Therefore, functions of the PM application component are used, including standard ordering
functions and creation of maintenance plans or task lists. Billing is then carried out with the Sales and Distribution (SD) component.
More Information
PM: Equipment
LO-MD: Material Master
MM-PUR: Purchase Requisitions, Purchase Orders
MM-IM: Planning Goods Receipts, Goods Receipts for Purchase Orders, Goods Receipts for Orders, Other Goods Receipts, Goods Issues.
Integration
The Energy Data Management (SAP IS-U-EDM) component is fully integrated into the SAP IS-U system and can be installed in an existing SAP IS-U
system as a new component. SAP IS-U-EDM is also integrated into Intercompany Data Exchange (SAP IS-U-IDE). This component allows for data exchange
in standardized formats and enables the integration of cross-company business processes. SAP IS-U-EDM allows you to bill profiles in SAP IS-U. Profiles are
prepared in SAP IS-U-EDM and transferred to SAP IS-U billing via an internal interface. This allows you to bill new types of contracts, such as spot
purchases.
SAP IS-U-EDM also interfaces with automated meter reading systems.
Features
Energy Data Management covers the following areas:
Central database for energy data (Energy Data Repository)
Settlement and scheduling using the settlement workbench
Billing profiles using Real-Time-Pricing Billing
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 7 of 130
Profile Management
For further information see Profile Management
Settlement
For more information see Settlement
Calculating Profiles
For more information see Profile Calculation
Sending Profiles
You can send profiles to communication partners and display a list of sent profiles.
To send profiles, see Energy Data Management Send Profiles in the Utilities Industry menu.
Profile Billing
For more information, see Real-Time-Pricing Billing .
Integration
Billing can process discrete measured data from the Meter Reading component (IS-U-DM-MR) as well as interval data from the Energy Data Management
component (IS-U-EDM).
If you have activated the business function Utilities, Quantity Determination (ISU_QD_1) and you use the quantity determination procedure Quantity
Determination During Meter Reading , the system determines a consumption value during meter reading result entry. The value is saved to the database. In
this case, billing processes the consumption quantity and not the meter reading results.
For more information, see:
Quantity Determination During Meter Reading
The billing results are processed in the Invoicing component (IS-U-IN).
In addition to the standard services, utility companies also offer their customers other services. Some important additional services are, for example:
Installation of a service connection
Maintenance and repairs
Sales
These additional services are either billed and invoiced in the Sales and Distribution (SD) component, or externally.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 8 of 130
1.6 Invoicing
Use
This component:
Creates FI-CA documents for:
IS-U consumption billing
External billing
SD billing (sales, installation)
Clears bill receivables with posting items, in particular with budget billing payments that have been made
Creates and prints bills
Supports reversal processes
Manages the budget billing plans and provides functions for processing the budget billing amounts
Supports the determination and levying of taxes, charges and duties
Supports additional functions such as:
Interest Calculation
Dunning
Locks
Clearing control, account maintenance, and so on
The following figure shows the uses and additional functions of invoicing:
Integration
The Contract Billing (IS-U-BI) component sends billing documents, credit memos, backbillings, and the basis for the budget billing plans to invoicing. The
budget billing plan is formed on the basis of the budget billing extrapolation lines, which are created automatically in periodic billing.
Invoicing links the Utilities Industry (IS-U) component with the Contract Accounts Receivable and Payable (FI-CA) component. Posting documents and
budget billing plans are created in FI-CA and are taken into account by invoicing during account maintenance.
The Print Workbench (IS-U-TO-PW) component is used for creating the bill form.
The following graphic shows the connection between billing, invoicing and contract accounts receivable and payable:
Page 9 of 130
Features
This component provides standard accounts receivable and accounts payable functions including dunning, posting documents, and making payments.
Contract accounts receivable and payable currently consists of the following detailed components:
Basic Functions
Business Transactions
Integration
Closing Operations
Information System
Job Controls
European Monetary Union and Contract Accounts Receivable and Payable
Archiving
Interfaces
The EVENT Concept
Data Processing in Mass Runs
Enhanced Message Management
Integration
Depending on your Customizing settings, you can integrate all components of the Utilities Industry (IS-U) component and components of the standard
system, for example the component Service Processing (CS-SE).
Features
The data finder , a high-performance search function, helps you identify customers. Depending on the data you are given, you can search by the following
criteria:
Name and address of the customer
Address of the connection object
Customer number
Social security number
You can also:
Combine search criteria any way you like
Search with incomplete criteria (for example, all names starting with Ma).
Restrict the search according to objects (for example, the division electricity).
Example
You can search for customers who inhabit the same property.
You can integrate external communication systems in IS-U/CCS. You can, for example, display documents stored in the optical archive (such as bills and
welcome letters), store in or outbounf documents (such as letters or faxes), integrate a call center solution using the SAPPhone component or send E-mails
via the SAPConnect component.
Page 10 of 130
You use this component for accepting, planning, calculating and carrying out work orders and, if applicable, for billing work orders to a customer. For this
process, a distinction is made between two types of work order as follows:
External work orders relating to the customer ("services")
Examples of external work orders are:
Creation and amplification of service connections
Energy consulting
Unplanned meter readings
Disconnection and reconnection (electricity, gas)
Internal work orders
Examples of internal work orders are:
Maintenance
Repairs
Installation, modification or removal of technical equipment
To create a work order efficiently, the Utilities Industry (IS-U) component uses references ("compatible units"). Using a small number of parameters defined
by the user, the system can generate the appropriate order.
After the order has been created, the system monitors the provision of resources and schedules the order. Geographical conditions play an important role here,
especially in the utilities industry.
Integration
IS-U manages data required for evaluating statistics in separate files. You analyze stock statistics, transaction statistics, and sales statistics using the
Logistics Information System (LO-LIS) component, which is integrated with the Open Information Warehouse (CA-OIW) component. This allows you to use
the analysis tools from CA-OIW to evaluate, analyze and present statistics.
You can also use external programs, such as Microsoft Excel , to analyze the statistics. User Exits also allow you to add information from other applications
to the statistics.
Integration
To represent certain processes, you also require additional SAP for Utilities applications that are seamlessly integrated with Intercompany Data Exchange.
Representing the processes for Energy Quantity Settlement involves both Energy Data Management and Intercompany Data Exchange.
Representing the processes for Managing Grid Usage involves the following applications in addition to Intercompany Data Exchange:
Billing
Energy Data Management
Invoicing
FI-CA
Features
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 11 of 130
Intercompany data exchange provides the infrastructure and functions required to implement unbundling requirements and to represent the resulting scenario
Change of Supplier and Managing Grid Usage and also to process data exchange in deregulated markets.
Note
For more information about this scenario, see SAP Solution Manager.
The documentation for Intercompany Data Exchange is structured as follows:
Deregulation Data
This section describes the master data objects that are required to use the SAP IS-U System in deregulated markets. This deregulation data is used by
the deregulation functions.
Deregulation Functions
The Deregulation Settings section describes the basic settings that you make to configure your system for use in a deregulated environment.
These deregulation settings are the basis for using the deregulation functions.
The Deregulation Infrastructure section describes the functions that make up the infrastructure used to represent deregulated processes.
The Unbundling section describes the options for implementing unbundling of information.
The Processing Data Exchange section describes the functions and processes that are used to perform data exchange in the deregulated
environment.
Data exchange is performed for all deregulation processes. During the change of supplier process, information about the registration or
deregistration of grid usage and the cancellation of supply service relationships is exchanged. During bill processing and payment handling, market
participants communicate with each other to exchange bills, complaints, payments, and payment advice notes. The data exchanged refers to the
customers for which the various service providers perform services or with whom they have contractual agreements.
The Change of Supplier section describes the functions and processes that are used to manage the change of supplier processes.
The Bill Processing and Payment Handling section describes the functions and processes that are used to manage the various individual
processes.
The Technical Reference to Deregulation Functions contains information about the architecture and project-specific enhancement options for the
deregulation functions described previously.
Migration
This section describes migration objects for the deregulation data.
The AMI system landscape illustrated is subdivided into three large areas:
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 12 of 130
On the left hand side, the AMI systems, on the right hand side, the SAP system as a back-office system, and in the middle, the MDUS system as an
interface between the two.
The AMI systems on the left hand side include devices with advanced metering capabilities, advanced metering systems (AMS), and other devices and
systems, such as data concentrators. Advanced metering systems measure, gather, and analyze energy consumption data from AMI devices and transmit
commands and data to these devices.
MDUS in the middle stands for Meter Data Unification & Synchronization and describes systems that unite the interfaces between different advanced
metering systems and synchronize the data and processes in these systems with those in the back-office systems.
You can use the SAP system on the right hand side to run the usual back-office processes, as well as processes and functions specific to an advanced
metering infrastructure. Communication between the SAP applications and the MDUS system takes place using enterprise services.
Processes can only run fully if all the devices and systems in the advanced metering infrastructure meet the technical requirements and support the required
capabilities. For this reason, the SAP Utilities processes are only possible if the required capabilities are supported both by the advanced metering system and
by the device.
Example
The advanced metering system supports the Remote Disconnection capability but the device does not.
This means the remote disconnection process cannot take place.
Integration
The AMI capabilities in the SAP system are based on existing functions in the following areas:
Device Management
Meter Reading
Contract Billing
Customer Service
The remaining documentation focuses on the capabilities and processes that are specific to an advanced metering infrastructure, or that are processed
differently in this context than is the case in an infrastructure that is not based on advanced metering technology. For this reason, the descriptions contain a
number of references to the documentation for the above areas.
More Information
For more information about enterprise services (English language), see SAP Library at SAP for Utilities Enterprise Services Documentation and
help.sap.com/ecc
SAP ERP 6.0 Enterprise Services Documentation
Process Component
Business Object
Service Interface
Enterprise Service Operation.
Enterprise service bundles provide an ideal starting point to explore the impact of service-oriented architecture (SOA) on your business processes. They
create a comprehensive portfolio of business scenario descriptions that are SOA-enabled by solutions and enterprise services currently shipped by SAP.
Enterprise service bundles documentation provides you with information about the impact of SOA on your business processes without requiring detailed
knowledge of SAP solutions or technology. Each enterprise service bundle refers to a set of enterprise services that support a particular business process and
are made available as part of the SAP Enhancement Packages for SAP Business Suite solutions.
Note
To search for information about specific enterprise service fields, you can use the Utilities data type catalog at
http://service.sap.com/~sapidb/011000358700001049282012E
( service.sap.com/utilities
Information IS-U/CCS General Cookbook&Guidelines
Utilities Data Type Catalog ).
Specific use cases for service operations in the SAP for Utilities area can be found in the following enterprise service WIKIs (registration required):
Advanced Meter Infrastructure WIKI at https://wiki.sdn.sap.com/wiki/display/ESpackages/Advanced+Meter+Infrastructure
Market Communication WIKI at https://wiki.sdn.sap.com/wiki/display/ESpackages/Market+Communication
For general information about the installation and prerequisites for using enterprise services, see the following information sources:
SCN Community in the SAP Network at https://scn.sap.com/community/soa
(registration required)
SAP Note 1359215: Technical prerequisites for using enterprise services (relevant for ERP only)
Page 13 of 130
Business Partner Data Processing enables a company to manage all Business Partner data that is relevant to control its business processes, such as sales,
purchasing and accounting processes.
Technical Data
Entity Type
Process Component
Technical Name
BusinessPartnerDataManagement
Namespace
http://sap.com/xi/ESM/SUITE
Technical Data
Entity Type
Business Object
Technical Name
BusinessPartner
Object Category
Service Interface
Category
SAP A2A
Direction
inbound
Technical Data
Entity Type
Service Operation
SAP_BS_FOUNDATION 731
Release State
Technical Name
BusinessPartnerSUITEBulkReplicateRequest_In
Namespace
http://sap.com/xi/SAP_BS_FND/MDG/Global2
Application Component
CA-MDG-APP-BP
BUSINESSPARTNERSUITEBULKREPLIC
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
yes
Message Types
Business Partner SUITE Bulk Replicate Request
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 14 of 130
Service Interface
Category
SAP A2A
Direction
outbound
Technical Data
Entity Type
Service Operation
SAP_BS_FOUNDATION 731
Release State
Technical Name
BusinessPartnerSUITEBulkReplicateConfirmation_Out
Namespace
http://sap.com/xi/SAP_BS_FND/MDG/Global2
Application Component
CA-MDG-APP-BP
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
yes
Message Types
Business Partner SUITE Bulk Replicate Confirmation
Technical Data
Entity Type
Service Interface
Category
SAP A2A
Direction
inbound
Technical Data
Entity Type
Service Operation
SAP_BS_FOUNDATION 731
Release State
Technical Name
BusinessPartnerSUITEBulkReplicateConfirmation_In
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 15 of 130
Namespace
http://sap.com/xi/SAP_BS_FND/MDG/Global2
Application Component
CA-MDG-APP-BP
BUSINESSPARTNERSUITEBULKREPLI1
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
yes
Message Types
Business Partner SUITE Bulk Replicate Confirmation
Technical Data
Entity Type
Service Interface
Category
SAP A2A
Direction
outbound
Technical Data
Entity Type
Service Operation
SAP_BS_FOUNDATION 731
Release State
Technical Name
BusinessPartnerSUITEBulkReplicateRequest_Out
Namespace
http://sap.com/xi/SAP_BS_FND/MDG/Global2
Application Component
CA-MDG-APP-BP
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
yes
Message Types
Business Partner SUITE Bulk Replicate Request
Page 16 of 130
Payment Cards, such as credit cards, debit cards, or charge cards, are payment instruments issued by banks, financial institutions and businesses to
individuals (card holders). The card holder can present the card to make cashless payments for goods and services at a merchant, who has an agreement with
the issuer to accept the payment.
Technical Data
Entity Type
Business Object
Technical Name
PaymentCard
Object Category
Features
Payment Card consists of the card data (root) and information regarding blocks (node: Block).The business and technical purpose that applies to all service
interfaces of this business object is the processing of payment card master records.Customer and business partner payment card master data are stored at
two different storages in the SAP back-end system.The related semantic name of this object in the SAP SUITE back-end system is payment card master
record.
Constraints
You cannot delete a payment card master record from the SAP SUITE back-end system because this may result in inconsistencies, such as, if a payment
card which has already been used for payment transactions will be physically removed from the system.
Service Interface
Category
SAP A2A
Direction
inbound
Technical Data
Entity Type
Service Operation
SAP_BS_FOUNDATION 731
Release State
released
Technical Name
PaymentCardSUITEChangeRequestConfirmation_In
Namespace
http://sap.com/xi/SAP_BS_FND/Global2
Application Component
CA-EPT
BS_PAYTCARDSUITECHGRC
Category
A2X
Direction
inbound
Mode
synchronous
Idempotency
yes
Change/Update Behavior
not applicable
true
Page 17 of 130
Features
To change a Payment Card, the following data is needed:
Input
All mandatory fields have to be filled.
ID (ID of the payment card)
blockListCompleteTransmissionIndicator (If this indicator is set, all block items will be deleted, which are not part of the block payload.)
CategoryCode (not supported; should therefore not be filled)
TypeCode (type of payment card)
ValidityStartDate (date from which the payment card is valid)
ExpirationDate (date up to which the payment card is valid)
IssueDate (date the payment card was issued)
HolderName (name of the person or company to whom the payment card was issued)
IssuerName (bank that issued the payment card)
Block
PaymentCardBlockingReasonCode (ndicates whether a payment card is blocked and for what reason)
ActionCode (If the ActionCode is empty the default 01 = create is used automatically; only ActionCodes 01 (Create) and 03 (Delete) are
supported.)
ValidityPeriod
StartDate (date as of which the payment card block is valid)
EndDate (date up to which the payment card block is valid)
Duration (not supported; should therefore not be filled)
Output
Output
For security reasons, the payment card ID which corresponds to the payment card number in the SAP Business Suite back-end system is not displayed.
Instead the Payment Card MaskedID of the payment card master record is displayed, which has been created by the current service operation. The security
level can be adjusted in Customizing of the SAP Business Suite back-end system underCross Application Components -> Payment Cards -> Basic Settings > Maintain Security Settings for Payment Cards.If the Customizing is not maintained only the first five and the last two digits of the card number are displayed
(for example 99341*********77).
For security reasons, the payment card ID which corresponds to the payment card number in the SAP Business Suite back-end system is not displayed.
Instead the Payment Card MaskedID of the payment card master record is displayed, which has been created by the current service operation. The security
level can be adjusted in Customizing of the SAP Business Suite back-end system under Cross Application Components -> Payment Cards -> Basic Settings
-> Maintain Security Settings for Payment Cards. If the Customizing is not maintained only the first five and the last two digits of the card number are
displayed (for example 99341*********77).
Error Handling
If errors occur, tThe system issues an error log.
Message Types
PaymentCardSUITEChangeConfirmation_sync
PaymentCardSUITEChangeRequest_sync
Prerequisites
You have created a payment card master record.
Constraints
ActionCode 02 used to change the block of a payment card is not supported. As an alternative you can delete the block and then create a new block
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 18 of 130
You set the security level in Customizing under Cross Application Components -> Payment Cards -> Basic Settings -> Maintain Security Settings for
Payment Cards .
In addition, to ensure secure handling of payment card information in the SAP Business Suite, you must deactivate the recording of service calls in the PI
monitor (also see SAP note 1032588).
Enhancements
There are three Business Add-Ins available to enhance the current operation:
Change Payment Card ( PYCD _ESOA_PAYTCARDCHGRC), e nhancement spot PYCD_SPOT_ESOA_PAYT_CARDMethod
INBOUND_PROCESSING of this BAdI is processed at the beginning of the operation. Using this method you can run checks and modify the input data.
Method OUTBOUND_PROCESSING is processed at the end of the operation. Using this method you can modify the values in the response message
before they are sent to the consumer.
Mapping for Blocking Reason Code ( PYCD_ESOAMAP_PAYTCARDBLCKREAS), e nhancement spot PYCD_SPOT_ESOA_PAYT_CARD Using
Method MAP_EXT2INT, you can implement your own value mapping for the external field PaymentCardBlockingReasonCode to the payment card block
(data element CC_LOCK ) in the SAP Buisness Suite back-end system. Using Method MAP_INT2EXT, you can implement your own value mapping for
the payment card block (data element CC_LOCK ) in the SAP Business Suite back-end system to the external field
PaymentCardBlockingReasonCode.
Mapping of Payment Card Type (BSBP_ESAMAP_PAYMNTCRDTYPE), e nhancement spot BSBP_ESAMAP_PAYMNTCRDTYPE Met hod:
MAP_EXT2INT Using Method MAP_EXT2INT, you can implement your own value mapping for the external field TypeCode to the payment card type
(data element CC_INSTITUTE) in the SAP Buisness Suite back-end system. Using Method MAP_INT2EXT, you can implement your own value
mapping for the payment card type in the SAP Business Suite back-end system to the to the external field TypeCode.
Technical Data
Entity Type
Service Operation
SAP_BS_FOUNDATION 731
Release State
released
Technical Name
PaymentCardSUITECreateRequestConfirmation_In
Namespace
http://sap.com/xi/SAP_BS_FND/Global2
Application Component
CA-EPT
BS_PAYTCARDSUITECRTRC
Category
A2X
Direction
inbound
Mode
synchronous
Idempotency
yes
Change/Update Behavior
not applicable
true
Features
To create a Payment Card, the following data is needed:
Input
All mandatory elements have to be filled:
PaymentCardID (number of the payment card)
TypeCode (type of payment card)
ValidityStartDate (date from which the payment card is valid)
IssueDate (date the payment card was issued)If the IssueDate is not specified in the inbound service the IssueDate will be initial.
ExpirationDate (date up to which the payment card is valid)If the ExpirationDate is not specified in the inbound service the ExpirationDate
will automatically be set to December 31, 9999.
HolderName (name of the person or company to whom the payment card was issued)
IssuerName (bank that issued the payment card)
Output
Output
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 19 of 130
Error Handling
In case errors occur the system issues an error log.
Message Types
PaymentCardSUITECreateConfirmation_sync
PaymentCardSUITECreateRequest_sync
Constraints
CategoryCode is not supported and should therefore not be filled.
Technical Data
Entity Type
Service Operation
SAP_BS_FOUNDATION 731
Release State
released
Technical Name
PaymentCardSUITEByIdQueryResponse_In
Namespace
http://sap.com/xi/SAP_BS_FND/Global2
Application Component
CA-EPT
BS_PAYTCARDSUITEBYIDQR
Category
A2X
Direction
inbound
Mode
synchronous
Idempotency
no
Change/Update Behavior
not applicable
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 20 of 130
true
Features
The Create Payment Card inbound operation reads detail information of payment card master records in the SAP Business Suite back-end system. To read a
Payment Card, the following data is needed:
Input
All mandatory elements have to be filled:
PaymentCardID (number of the payment card)
TypeCode (type of payment card)
Output
Output
Payment Card MaskedID
For security reasons, the payment card ID which corresponds to the payment card number in the SAP Business Suite back-end system is not displayed.
Instead the Payment Card MaskedID of the payment card master record is displayed, which has been created by the current service operation. The security
level can be adjusted in Customizing of the SAP Business Suite back-end system under Cross Application Components -> Payment Cards -> Basic Settings
-> Maintain Security Settings for Payment Cards. If the Customizing is not maintained only the first five and the last two digits of the card number are
displayed (for example 99341*********77).
Error Handling
If errors occur, the system issues an error log.
Message Types
PaymentCardSUITEByIDQuery_sync
PaymentCardSUITEByIDResponse_sync
Prerequisites
You have created a payment card master record.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 21 of 130
Technical Data
Entity Type
Process Component
Technical Name
UtilitiesBusinessPartnerDataManagement
Namespace
http://sap.com/xi/ESM/ERP
Technical Data
Entity Type
Business Object
Technical Name
UtilitiesServiceProvider
Object Category
Technical Data
Entity Type
Service Interface
Category
A2X
Direction
inbound
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 22 of 130
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
UtilitiesServiceProviderERPBasicDataByIDQueryResponse_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_SERVPROVBDIDQR
Category
A2X
Direction
inbound
Mode
synchronous
Idempotency
no
Change/Update Behavior
not applicable
true
Related Operations
The Find Utilities Service Provider by Identification inbound operation allows you to find the list of roles and identifications for a service provider.
Features
The query returns the information related to the service provider, such as a list of roles and a list of identification with the code list agency if this has been
defined. It also provides master data such as person name or organization name, address information and address and dependent communication data for the
business partner assigned to the service provider. The query status is added to the log to indicate the success or failure of the operation.
Error Handling
The operation returns an error message in the log if no input is provided or this input is incorrect.
Message Types
UtilitiesServiceProviderERPBasicDataByIDQuery_sync
UtilitiesServiceProviderERPBasicDataByIDResponse_sync
Page 23 of 130
Technical Data
Entity Type
Service Interface
Category
A2X
Direction
inbound
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
UtilitiesServiceProviderERPSimpleByIdentificationQueryResponse_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_SERVPROV001QR
Category
A2X
Direction
inbound
Mode
synchronous
Idempotency
no
Change/Update Behavior
not applicable
true
Related Operations
The Read Utilities Service Provider Basic Data inbound operation is used to read the master data for the business partner assigned to the service provider
using its internal ID.
Features
This inbound operation performs a query to find the Utilities Service Provider by providing its external Identification (mandatory) and service type (optional). If
the code list agency is defined for the requested external identification, it should also be provided.
The query returns the information related to the service provider: Service provider ID, list of role and list of identification. The query result is also recorded in
the log, for example, Successful processing, when the service provider is found.
Error Handling
The operation returns error messages in the log if no input is provided or the input is incorrect.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 24 of 130
Message Types
UtilitiesServiceProviderERPSimpleByIdentificationQuery_sync
UtilitiesServiceProviderERPSimpleByIdentificationResponse_sync
Technical Data
Entity Type
Process Component
Technical Name
MeasurementProcessing
Namespace
http://sap.com/xi/ESM/ERP
Constraints
The target group must run the IS-U back-end application component in order to use the operations that Measurement Processing contains.
Processing
The Measurement Processing process component enables communication with data of the following SAP ECC application components:
Meter Reading in the Utilities Industry (IS-U/DM-MR) industry-specific component
Measuring Points and Counters (PM-EQM-SF-MPC)
Technical Data
Entity Type
Business Object
Technical Name
MeasurementReading
Object Category
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 25 of 130
Technical Data
Entity Type
Service Interface
Category
SAP A2A
Direction
inbound
Service Operation
Release State
released
Technical Name
MeasurementReadingERPCancelRequestConfirmation_In
Namespace
http://sap.com/xi/EA-APPL/SE/Global
Application Component
PM
ECC_MSMTRDNGCNCRC
Category
SAP A2A
Direction
inbound
Mode
synchronous
Idempotency
yes
Change/Update Behavior
not applicable
true
Features
This inbound operation processes the following message types:
MeasurementReadingERPCancelRequest_sync
MeasurementReadingERPCancelConfirmation_sync
The following value must be supplied:
MeasurementReadingID
Message Types
MeasurementReadingERPCancelConfirmation_sync
MeasurementReadingERPCancelRequest_sync
Prerequisites
A measurement reading that has not been canceled must exist in the system. You can create a measurement reading with either the appropriate operation or
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 26 of 130
Processing
The EAM_SE_MSMTRDNGCRTRC Business Add-In (enhancement spot EAM_SPOT_SE_MSMTRDNG) is available for this operation.
Service Operation
Release State
released
Technical Name
MeasurementReadingERPCreateCheckQueryResponse_In
Namespace
http://sap.com/xi/EA-APPL/SE/Global
Application Component
PM
ECC_MSMTRDNGCRTCHKQR
Direction
inbound
Mode
synchronous
Idempotency
no
Change/Update Behavior
not applicable
true
Features
This inbound operation processes the following message types:
MeasurementReadingERPCreateCheckQuery_sync
MeasurementReadingERPCreateCheckResponse_sync
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 27 of 130
Message Types
MeasurementReadingERPCreateCheckQuery_sync
MeasurementReadingERPCreateCheckResponse_sync
Prerequisites
Before you create a measurement reading, you must create at least one measuring device in the system. Use transaction IK01 to create a measuring device.
You have configured the Measuring Points and Counters (PM-EQM-SF-MPC) application component to suit your requirements.
Processing
If the variables DateTime and RecordingPersonFormattedName are not filled, the system generates default values for these variables. These are generated as
follows:
DateTime Today's date and current time
RecordingPersonFormattedName Name of the user that is logged on (sy-uname)
The EAM_SE_MSMTRDNGCRTRC Business Add-In (enhancement spot EAM_SPOT_SE_MSMTRDNG) is available for this operation.
Service Operation
Release State
released
Technical Name
MeasurementReadingERPCreateRequestConfirmation_In
Namespace
http://sap.com/xi/EA-APPL/SE/Global
Application Component
PM
ECC_MSMTRDNGCRTRC
Direction
inbound
Mode
synchronous
Idempotency
yes
Change/Update Behavior
not applicable
true
Features
This inbound operation processes the following message types:
MeasurementReadingERPCreateRequest_sync
MeasurementReadingERPCreateConfirmation_sync
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 28 of 130
Message Types
MeasurementReadingERPCreateConfirmation_sync
MeasurementReadingERPCreateRequest_sync
Prerequisites
Before you create a measurement reading, at least one measuring device must be created in the system. Use transaction IK01 to create a measuring device.
You have configured the Measuring Points and Counters (PM-EQM-SF-MPC) application component to suit your requirements.
Processing
If the variables DateTime and RecordingPersonFormattedName are not filled, default values are generated for these variables. These are generated in the
following way:
DateTime Today's date and current time
RecordingPersonFormattedName Name of the user that is logged on (sy-uname)
The EAM_SE_MSMTRDNGCRTRC Business Add-In (enhancement spot EAM_SPOT_SE_MSMTRDNG) is available for this operation. This service operation
is designed as Idempotency.
Service Operation
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 29 of 130
Release State
released
Technical Name
MeasurementReadingERPByIDQueryResponse_In
Namespace
http://sap.com/xi/EA-APPL/SE/Global
Application Component
PM
ECC_MSMTRDNGIDQR
Direction
inbound
Mode
synchronous
Idempotency
no
Change/Update Behavior
not applicable
true
Features
This inbound operation processes the following message types:
MeasurementReadingERPByIDQuery_sync
MeasurementReadingERPByIDResponse_sync
The following value must be supplied:
MeasurementReadingID
Message Types
MeasurementReadingERPByIDQuery_sync
MeasurementReadingERPByIDResponse_sync
Prerequisites
At least one measurement reading must exist in the system. You can create a measurement reading with either the appropriate operation or transaction IK11
in the back-end system.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 30 of 130
Processing
The EAM_SE_MSMTRDNGCRTRC Business Add-In (enhancement spot EAM_SPOT_SE_MSMTRDNG) is available for this operation.
Technical Data
Entity Type
Service Interface
Category
SAP A2A
Direction
Inbound
Technical Data
Entity Type
Service Operation
EA-APPL 606
Release State
released
Technical Name
MeasurementReadingERPBulkCreateRequest_In
Namespace
http://sap.com/xi/PLM/Global2
Direction
inbound
Mode
asynchronous
Idempotency
no
no
Message Types
MeasurementReadingERPBulkCreateRequest_sync
Technical Data
Entity Type
Service Interface
Category
A2X
Direction
inbound
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 31 of 130
Service Operation
Release State
released
Technical Name
LatestMeasurementReadingERPByMeasuringDeviceIDQueryResponse_In
Namespace
http://sap.com/xi/EA-APPL/SE/Global
Application Component
PM
ECC_LSTMSMTRDNGBYMSRDEVIDQR
Direction
inbound
Mode
synchronous
Idempotency
no
Change/Update Behavior
not applicable
true
Features
This inbound operation processes the following message types:
LatestMeasurementReadingERPByMeasuringDeviceIDQuery_sync
LatestMeasurementReadingERPByMeasuringDeviceIDResponse_sync
The following value must be supplied:
MeasuringDeviceID
Message Types
LatestMeasurementReadingERPByMeasuringDeviceIDQuery_sync
LatestMeasurementReadingERPByMeasuringDeviceIDResponse_sync
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 32 of 130
Prerequisites
At least one measuring device must exist in the system. Use transaction IK01 to create a measuring device.
Processing
The EAM_SE_LSTMSMTRDNGBYMSRDEVIDQR business add-in (enhancement spot EAM_SPOT_SE_MSMTRDNG) is available for this operation.
Service Operation
Release State
released
Technical Name
MeasurementReadingERPByMeasuringDeviceIDQueryResponse_In
Namespace
http://sap.com/xi/APPL/Global2
Application Component
PM
ECC_MSMTRDNGBYMSRDEVIDQR
Direction
inbound
Mode
synchronous
Idempotency
no
Change/Update Behavior
not applicable
true
Features
To find the measurement reading for a measuring device before a specified point in time, the following information is needed:
The ID of the measuring device for which you would like the measurement reading (MeasuringDeviceID element)
The point in time before which you would like the measurement reading for (CutoffMeasurementReadingDateTime element). If you do not specify a point
in time, the operation will automatically fill the current date and time.
The value for the QueryHitsMaximumNumberValue element is 100 by default. If only the latest measurement (according to given time point) is needed, enter
1. If you enter a value for the QueryHitsMaximumNumberValue element, do not set the UnlimitedQueryHitsIndicator.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 33 of 130
StartPointMeasure: optionalStartPoint identifies the start position of a technical asset along a linear asset technical asset or segment in a measurement
reading.
EndPointMeasure: optionalEndPoint identifies the end position of a technical asset along a linear technical asset or segment in a measurement reading.
LengthMeasure: optionalLength identifies the length of a linear technical asset or segment in a measurement reading.
StartMarkerLengthMeasure: optionalStartMarkerLengthMeasure identifies the length between StartPointMeasure and StartLinearTechnicalAssetMarkerID
of a linear technical asset or segment in a measurement reading.
EndMarkerLengthMeasure: optionalEndMarkerLengthMeasure identifies the length between EndMarkerLengthMeasure and
EndLinearTechnicalAssetMarkerID of a linear technical asset or segment in a measurement reading.
LinearInformationFirstOffset identifies the localization of a technical asset in relation to a reference point or line of a technical asset in a measurement
reading.
LinearInformationSecondOffset identifies the localization of a technical asset in relation to a second reference point or line of a technical asset in a
measurement reading.
Integrity Conditions: The subelements for StartPointMeasure, EndPointMeasure and LenghtMeasure are set to optional. However, the representation can only
comprise one of the following data sets:
1. StartPointMeasure
2. StartPointMeasure and EndPointMeasure
3. StartPointMeasure and EndPointMeasure and LenghtMeasure
4. StartPointMeasure and LenghtMeasure.
Message Types
MeasurementReadingERPByMeasuringDeviceIDQuery_sync
MeasurementReadingERPByMeasuringDeviceIDResponse_sync
Service Operation
Release State
released
Technical Name
MeasurementReadingERPSimpleByElementsQueryResponse_In
Namespace
http://sap.com/xi/EA-APPL/SE/Global
Application Component
PM
ECC_MSMTRDNG001QR
Direction
inbound
Mode
synchronous
Idempotency
no
Change/Update Behavior
not applicable
true
Features
This inbound operation processes the following message types:
MeasurementReadingERPSimpleByElementsQuery_sync
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 34 of 130
MeasurementReadingERPSimpleByElementsResponse_sync
One of the following values must be supplied:
MeasuringDeviceID
InstallationPointID
IndividualMaterialID
Message Types
MeasurementReadingERPSimpleByElementsQuery_sync
MeasurementReadingERPSimpleByElementsResponse_sync
Prerequisites
At least one measurement reading must exist in the system. A measurement reading can be created with either the appropriate operation or transaction IK11
in the back-end system.
Processing
The EAM_SE_MSMTRDNG001QR business add-in (enhancement spot EAM_SPOT_SE_MSMTRDNG) is available for this operation.
Technical Data
Entity Type
Business Object
Technical Name
MeterReadingCard
Object Category
Technical Data
Entity Type
Service Interface
Category
A2X
Direction
inbound
Page 35 of 130
Technical Data
Entity Type
Service Operation
Release State
released
Technical Name
MeterReadingCardChangeRequestConfirmation_In
Namespace
http://sap.com/xi/IS-U/SE/Global
Application Component
IS-U
ISU_METERREADINGCARDCHGRC
Direction
inbound
Mode
synchronous
Idempotency
no
Change/Update Behavior
not applicable
true
Features
When this operation is executed, the meter reading results are stored in the SAP for Utilities System.
Error Handling
A plausibility check of the received meter reading data is provided by downstream processes.
Message Types
MeterReadingCardChangeConfirmation
MeterReadingCardChangeRequest
Configuration
This operation is suitable for the Utilities Industry Solutions sector. To use this operation, you must implement the SAP for Utilities (IS-U) application
component.
Note that users require the correct authorization to create meter reading results (authorization object E_MR_DOC).
Enhancements
The ISU_SE_METERREADINGCARD_CHGRC Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot
ISU_SPOT_SE_EET.
This BAdI allows you to create customer-specific logic for the inbound and outbound mapping of application data.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 36 of 130
Technical Data
Entity Type
Business Object
Technical Name
MeterReadingDocument
Object Category
Technical Data
Entity Type
Service Interface
Category
A2X
Direction
inbound
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
MeterReadingDocumentERPCancellationRequestConfirmation_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_MRDOCCNCRC
Category
A2X
Direction
inbound
Mode
synchronous
Idempotency
yes
Change/Update Behavior
not applicable
true
Page 37 of 130
The Cancel Meter Reading Document inbound service operation cancels a meter reading document.
The operation can only be performed if the meter reading is not already being used in an invoice request (meaning that it is billed) and for documents with the
following meter reading reasons:
1 Periodic
2 Interim With Billing
5 Service Territory Transfer With Billing
9 Interim Without Billing
10 Control
You can use Create Meter Reading Document With Reference To Utilities Device to create meter reading documents.
Features
To cancel a meter reading document, you must provide the following value:
Meter Reading Document ID
If the service operation is successful, it deletes the meter reading document with the ID that is identified. The BusinessDocumentProcessingResultCode is
defined accordingly.
Error Handling
Typical errors are:
General mapping error: MeterReadingDocumentID (Int. MR doc. ID) is initial you must provide an ID
Meter reading document <ID> does not exist there is no meter reading document with the specified ID
Meter reading documents with this reason cannot be cancelled you can only cancel meter reading documents with meter reading reasons 1, 2, 5, 9,
and 10, respectively.
Cancellation is not possible for the selected entry see the additional information for this log item (WebURI). One reason could be that the meter reading
has already been billed.
Message Types
MeterReadingDocumentERPCancellationConfirmation_sync
MeterReadingDocumentERPCancellationRequest_sync
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
MeterReadingDocumentERPResultCancellationRequestConfirmation_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_MRDRESULTCNCRC
Category
A2X
Direction
inbound
Mode
synchronous
Idempotency
yes
Change/Update Behavior
not applicable
true
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 38 of 130
Features
To cancel a meter reading result, the following value must be provided:
Meter Reading Document ID
If the service operation is successful, it deletes the result node for the meter reading document and changes the status of the meter reading document from
Result Received to Result Requested . The BusinessDocumentProcessingResultCode is defined accordingly.
Error Handling
Typical errors are:
General mapping error: MeterReadingDocumentID (Int. MR doc. ID) is initial you must provide an ID
Meter reading document <ID> does not exist there is no meter reading document with the specified ID
The meter reading document result cannot be cancelled the result node does not exist
The meter reading cannot be reset because it has been billed
Message Types
MeterReadingDocumentERPResultCancellationConfirmation_sync
MeterReadingDocumentERPResultCancellationRequest_sync
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
MeterReadingDocumentERPResultCreateRequestConfirmation_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_MRDRESULTCRTRC
Category
A2X
Direction
inbound
Mode
synchronous
Idempotency
yes
Change/Update Behavior
not applicable
true
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 39 of 130
Features
When this service is executed, the result for a Meter Reading Document IDs is created.
The following values must be provided:
MeterReadingDocumentID
MeterReadingResultValue
If the operation is successful, the response contains a message in the log. The BusinessDocumentProcessingResultCode is defined accordingly. The Meter
Reading Document ID is always returned.
Error Handling
Typical errors are:
General mapping error: MeterReadingDocumentID (Int. MR doc. ID) is initial.
Message Types
MeterReadingDocumentERPResultCreateConfirmation_sync
MeterReadingDocumentERPResultCreateRequest_sync
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
Configuration
This operation is suitable for the Utilities Industry Solutions sector. To use this operation, customers must run the IS-U application component.
Note that users should have the correct authorization to create a Meter Reading Document Result.
Constraints
The ISU_SE_MRDRESULTCRTRC Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_MRD. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data. The
implementations are sorted according to the field layer of a BAdI implementation, for example, SAP standard, partner, or customer.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
MeterReadingDocumentERPWithReferenceToUtilitiesDeviceCreateRequestConfir
mation_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_MRDOCCRT001RC
Category
A2X
Direction
inbound
Mode
synchronous
Idempotency
yes
Change/Update Behavior
not applicable
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 40 of 130
true
Features
The following values must be provided:
Utilities Device ID
MeterReadingReasonCode
ScheduledMeterReadingDate
If the operation is successful, the response contains a list of the IDs of the meter reading documents created with the corresponding utilities device register
ID and meter reading category code. The BusinessDocumentProcessingResultCode is defined accordingly.
Error Handling
Typical errors are:
General mapping error: UtilitiesDeviceID (Equipment) is initial;
MeterReadingReasonCode (MR reason) is initial; MeterReadingReasonCode (MR reason) is initial.
Message Types
MeterReadingDocumentERPWithReferenceToUtilitiesDeviceCreateConfirmation_sync
MeterReadingDocumentERPWithReferenceToUtilitiesDeviceCreateRequest_sync
Configuration
This operation is suitable for the Utilities Industry Solutions sector. Customers must run the IS-U application component to use it.
Note that users should have unrestricted authorization to create meter reading document and have authorization for activity 13 (Create Order) for authorization
object E_MR_DOC, E_MR_DOC1, E_MR_DOC2.
Enhancements
The ISU_SE_MRDOCCRT001RC Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_MRD. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data. The
implementations are sorted according to the field layer of a BAdI implementation, for example, SAP standard, partner, or customer.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
MeterReadingDocumentERPBasicDataByIDQueryResponse_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_MRDOCBDIDQR
Category
A2X
Direction
inbound
Mode
synchronous
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 41 of 130
Idempotency
no
Change/Update Behavior
not applicable
true
Features
When this service is executed, the basic data of a Meter Reading Document is returned. You have to provide the MeterReadingDocumentID.
Error Handling
Typical errors are:
No objects correspond to the selection criteria
General mapping error, MeterReadingDOcumentID (Int. MR doc. ID) is initial
Message Types
MeterReadingDocumentERPBasicDataByIDQuery_sync
MeterReadingDocumentERPBasicDataByIDResponse_sync
Configuration
This operation is suitable for the Utilities Industry Solutions sector. It is necessary that the customer runs the IS-U application component in order to use it.
Note that users should have the proper authorization in order to display the Meter Reading Document. Therefore, they need the permission for activity 11
(Display Order) for authorization object E_MR_DOC, E_MR_DOC1, E_MR_DOC2.
Enhancements
The ISU_SE_MRDOCBDIDQR Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_MRD.
You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data. The implementations are sorted
according to the field layer of a BAdI implementation, for example, SAP standard, partner, or customer. In particular, you should implement this BAdI to select
the most important meter reading reason code if there is more than one reason entered for a Meter Reading Document.
Technical Data
Entity Type
Service Interface
Category
SAP A2A
Direction
inbound
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 42 of 130
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
MeterReadingDocumentERPResultBulkChangeRequest_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_MRDRESULTCHGBLKRQ
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
Type2
yes
Related Operations
The corresponding outbound operation is Confirm Meter Reading Document Result Change as Bulk in the Measurement Processing process component.
Features
This inbound service operation is used to change existing meter reading document results as part of a mass process. The service starts the
BAPI_MTRREADDOC_UPLOAD BAPI, which uploads the meter reading document results to the SAP for Utilities back-end system.
The following values must be provided for the bulk message:
MessageHeader - UUID
The following values must be provided for each single message within this inbound operation:
Meter reading document ID
Result - actual date and actual time of the meter reading
Result - meter reading result value
Processing
For information, see Bulk, Bundle, Collection.
Error Handling
Typical errors include:
The meter reading document ID or actual date or meter reading result value is initial.
The user does not have the proper authorization to correct the meter reading results.
The meter reading result has already been billed.
The process cannot be carried out because it is locked by another user.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 43 of 130
Message Types
Meter Reading Document ERP Result Bulk Change Request
Configuration
Users must have the appropriate authorization to correct the meter reading results in SAP for Utilities.
Enhancements
The BAdI for Change Meter Reading Document Result as Bulk and Confirm Meter Reading Document Result Change as Bulk
(ISU_SE_MRDRESULTCHGBLKRCI_ASYN) Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot
ISU_SPOT_SE_MRD. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data.
Technical Data
Entity Type
Service Operation
IS-UT 605
Release State
Released
Technical Name
SmartMeterMeterReadingDocumentERPResultCreateConfirmation_In
Namespace
http://sap.com/xi/IS-U/Global
Application Component
IS-U
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
true
Features
The following graphic illustrates both the interface, the fields and cardinality of this service operation. You can use the Utilities data type catalog at
http://service.sap.com/~sapidb/011000358700001049282012E
( service.sap.com/utilities
SAP for Utilities
SAP for Utilities - Product Information
IS-U/CCS General Cookbook&Guidelines
Utilities Data Type Catalog ) to search for information about specific fields.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 44 of 130
Related Operations
The bulk counterpart for this service operation is the SmartMeterMeterReadingDocumentERPResultBulkCreateConfirmation_In operation
The outbound counterpart for this inbound operation is the SmartMeterMeterReadingDocumentERPResultCreationRequest_Out operation
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
Integration
This service operation belongs to the Meter Reading Document In service interface.
Note
Users should have the appropriate authorization to Correct plausible and implausible meter reading results (E_MR_ACTVT: 04, 05) in SAP for Utilities.
Enhancements
The Business Add-In (BAdI) ISU_SE_MRDRESSMCRTRCO_ASYN is available for this service operation. This BAdI allows you to use a customer-specific logic
for the inbound/outbound mapping of application data. This BAdI is available in the enhancement spot ISU_SPOT_SE_MRD.
The BAdI can be implemented several times. The implementations are sorted according to the content of the field Layer of a BAdI implementation , for
example, SAP standard, partner, or customer.
Error Handling
Typical general processing and/or mapping errors are:
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 45 of 130
ES Bundles
This service operation is part of the Advanced Meter Infrastructure ES bundle. For more information about this bundle, see the Enterprise Services WIKI at
https://wiki.sdn.sap.com/wiki/display/ESpackages/Advanced+Meter+Infrastructure
Technical Data
Entity Type
Service Operation
IS-UT 605
Release State
Released
Technical Name
SmartMeterMeterReadingDocumentERPResultBulkCreateConfirmation_In
Namespace
http://sap.com/xi/IS-U//Global
Application Component
IS-U
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
true
Features
The following graphic illustrates both the interface, the fields and cardinality of this service operation. You can use the Utilities data type catalog at
http://service.sap.com/~sapidb/011000358700001049282012E
( service.sap.com/utilities
SAP for Utilities
SAP for Utilities - Product Information
IS-U/CCS General Cookbook&Guidelines
Utilities Data Type Catalog ) to search for information about specific fields.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 46 of 130
Related Operations
The single counterpart for this service operation is the SmartMeterMeterReadingDocumentERPResultCreateConfirmation_In operation
The outbound counterpart for this inbound operation is the SmartMeterMeterReadingDocumentERPResultBulkCreateRequest_Out operation
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
Integration
This service operation belongs to the Meter Reading Document In service interface.
Note
Users should have the appropriate authorization to Correct plausible and implausible meter reading results (E_MR_ACTVT: 04, 05) in SAP for
Utilities.
Enhancements
The Business Add-In (BAdI) ISU_SE_MRDRESSMCHGBLKRCO_ASYN is available for this service operation. This BAdI allows you to use a customer-specific
logic for the inbound/outbound mapping of application data. This BAdI is available in the enhancement spot ISU_SPOT_SE_MRD.
The BAdI can be implemented several times. The implementations are sorted according to the field Layer of a BAdI implementation , for example, SAP
standard, partner, or customer.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 47 of 130
Error Handling
Typical general processing and/or mapping errors are:
MeterReadingDocumentID not provided
Message UUID not provided
For more information about monitoring your process integration, see the SAP Process Integration (PI) Handbook.
ES Bundles
This service operation is part of the Advanced Meter Infrastructure ES bundle. For more information about this bundle, see the Enterprise Services WIKI at
https://wiki.sdn.sap.com/wiki/display/ESpackages/Advanced+Meter+Infrastructure
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
SmartMeterMeterReadingDocumentERPCreateConfirmation_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_MRDOCSMCRTCO
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
The following values have to be provided:
Meter reading document ID
The confirmation message UUID
The request message UUID stored in the field reference_UUID of the confirmation message header
The log describing the status of the creation of meter reading document in the AMI system
Error Handling
Typical errors include:
General processing and mapping errors, such as MeterReadingDocumentID is initial, and Message UUID or Reference_UUID not provided.
For more information about monitoring your process integration, see
SAP NetWeaver Process Integration Library
Administrator's Guide Technical
Operations for SAP NetWeaver Administration of SAP NetWeaver Systems
PI (Process Integration) Monitoring Tools for Monitoring .
Message Types
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 48 of 130
SmartMeterMeterReadingDocumentERPCreateConfirmation
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
Configuration
This operation is suitable for the Utilities Industry Solutions sector. To use this operation, customers must run the IS-U application component to use it. Note
that users should have the correct authorization to change the meter reading document in IS-U.
Enhancements
The Business Add-In (BAdI) ISU_SE_MRDOCSMCRTRC is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_MRD.You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data.
Technical Data
Entity Type
Service Operation
IS-UT 605
Release State
released
Technical Name
SmartMeterMeterReadingDocumentERPBulkCreateConfirmation_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_MRDOCSMCRTBLKCO
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
Every object (meter reading document) in the bulk confirmation message should provide the following values:
Meter reading document ID
The (single) confirmation message UUID
The request message UUID stored in the field reference_UUID in the confirmation message header
The log that describes the creation status of each meter reading document in the bulk message
You must also supply the UUID of the bulk confirmation message and the bulk request message stored in the reference_UUID.
Error Handling
Typical errors include:
General processing and mapping errors, such as Bulk Confirmation Message UUID and Reference_UUID not provided.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 49 of 130
Message Types
SmartMeterMeterReadingDocumentERPBulkCreateConfirmation
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
Configuration
This operation is suitable for the Utilities Industry Solutions sector. However, it can only be used by customers who are running the IS-U application
component.
Note: Users require the correct authorization to change the meter reading document in IS-U.
Enhancements
The Business Add-In (BAdI) ISU_SE_MRDOCSMCRTBLKRCO_ASYN is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_MRD. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data.
Technical Data
Entity Type
Service Operation
IS-UT 605
Release State
Released
Technical Name
SmartMeterMeterReadingDocumentERPResultChangeConfirmation_In
Namespace
http://sap.com/xi/IS-U/Global
Application Component
IS-U
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
true
Features
The following graphic illustrates both the interface, the fields and cardinality of this service operation. You can use the Utilities data type catalog at
http://service.sap.com/~sapidb/011000358700001049282012E
( service.sap.com/utilities
SAP for Utilities
SAP for Utilities - Product Information
IS-U/CCS General Cookbook&Guidelines
Utilities Data Type Catalog ) to search for information about specific fields..
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 50 of 130
Related Operations
The outbound counterpart for this service operation is the SmartMeterMeterReadingDocumentERPResultChangeRequest_Out operation
The bulk counterpart for this service operation is the SmartMeterMeterReadingDocumentERPResultBulkChangeConfirmation_In operation
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
Integration
This service operation belongs to the Meter Reading Document In service interface.
Note
Users should have the appropriate authorization to Correct plausible and implausible meter reading results (E_MR_ACTVT: 04, 05) in SAP for
Utilities.
Enhancements
The Business Add-In (BAdI) ISU_SE_MRDRESSMCHGRCO_ASYN is available for this service operation. This BAdI allows you to use a customer-specific logic
for the inbound/outbound mapping of application data. This BAdI is available in the enhancement spot ISU_SPOT_SE_MRD.
The BAdI can be implemented several times. The implementations are sorted according to the field Layer of a BAdI implementation , for example, SAP
standard, partner, or customer.
Error Handling
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 51 of 130
ES Bundles
This service operation is part of the Advanced Meter Infrastructure ES bundle. For more information about this bundle, see the Enterprise Services WIKI at
https://wiki.sdn.sap.com/wiki/display/ESpackages/Advanced+Meter+Infrastructure
Technical Data
Entity Type
Service Operation
IS-UT 605
Release State
Released
Technical Name
SmartMeterMeterReadingDocumentERPResultBulkChangeConfirmation_In
Namespace
http://sap.com/xi/IS-U/Global
Application Component
IS-U
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
true
Features
The following graphic illustrates both the interface, the fields and cardinality of this service operation. You can use the Utilities data type catalog at
http://service.sap.com/~sapidb/011000358700001049282012E
( service.sap.com/utilities
SAP for Utilities
SAP for Utilities - Product Information
IS-U/CCS General Cookbook&Guidelines
Utilities Data Type Catalog ) to search for information about specific fields.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 52 of 130
Every SmartMeterMeterReadingDocumentERPResultCreateConfirmationMessage in the bulk request message should provide the following values:
The MeterReadingDocumentID
The (single) confirmation message UUID
The request message UUID stored in the field ReferenceUUID in the confirmation message header
The log that describes the change status for each meter reading document result in the bulk message
The UUID of the bulk confirmation message and the bulk request message stored in the ReferenceUUID should also be supplied.
Related Operations
The single counterpart for this service operation is the SmartMeterMeterReadingDocumentERPResultChangeConfirmation_In operation
The outbound counterpart for this inbound operation is the SmartMeterMeterReadingDocumentERPResultBulkChngeRequest_Out operation
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
Integration
This service operation belongs to the Meter Reading Document In service interface.
Note
Users should have the appropriate authorization to Correct plausible and implausible meter reading results (E_MR_ACTVT: 04, 05) in SAP for
Utilities.
Enhancements
The Business Add-In (BAdI) ISU_SE_MRDRESSMCRTRCO_ASYN is available for this service operation. This BAdI allows you to use a customer-specific logic
for the inbound/outbound mapping of application data. This BAdI is available in the enhancement spot ISU_SPOT_SE_MRD.
The BAdI can be implemented several times. The implementations are sorted according to the field Layer of a BAdI implementation , for example, SAP
standard, partner, or customer.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 53 of 130
Error Handling
Typical general processing and/or mapping errors are:
MeterReadingDocumentID not provided
Message UUID not provided
For more information about monitoring your process integration, see the SAP Process Integration (PI) Handbook.
ES Bundles
This service operation is part of the Advanced Meter Infrastructure ES bundle. For more information about this bundle, see the Enterprise Services WIKI at
https://wiki.sdn.sap.com/wiki/display/ESpackages/Advanced+Meter+Infrastructure
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
SmartMeterMeterReadingDocumentERPCancellationConfirmation_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_MRDOCSMCNCCO
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
The following values have to be provided:
MessageHeader - UUID
MessageHeader- ReferenceUUID
MeterReadingDocument - Meter reading document ID
The log that describes the status of the cancellation of meter reading document from the AMS
Error Handling
General processing and mapping errors include:
Missing log data, MessageHeader->UUID or MessageHeader->ReferenceUUID are not provided, and meter reading document ID is initial.
Message Types
Smart Meter Meter Reading Document ERP Cancellation Confirmation
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 54 of 130
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
Configuration
This operation is suitable for the Utilities Industry Solutions sector. However, it can only be used by customers who are running the IS-U application
component.
Note that users require the correct authorization to change the meter reading document in IS-U.
Enhancements
The ISU_SE_MRDOCSMCNCRCO_ASYN Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_MRD. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
SmartMeterMeterReadingDocumentERPBulkCancellationConfirmation_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_MRDOCSMCNCBLKCO
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
The following values have to be provided for the bulk message:
MessageHeader - UUID
MessageHeader- ReferenceUUID
The log that describes the cancellation status of all meter reading documents
The following values have to be provided for each single message in this inbound operation:
MessageHeader - UUID
MessageHeader - ReferenceUUID
MeterReadingDocument - Meter Reading Document ID
The log that describes the cancellation status of each single meter reading document
Error Handling
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 55 of 130
Message Types
SmartMeterMeterReadingDocumentERPBulkCancellationConfirmation
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
Configuration
This operation is suitable for the Utilities Industry Solutions sector. However, it can only be used by customers who are running the IS-U application
component. Note that users require the correct authorization to change the meter reading document in IS-U.
Enhancements
The ISU_SE_MRDOCSMCNCBLKRCO_ASYN Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_MRD. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data. The
implementations are sorted according to the field layer of a BAdI implementation, for example, SAP standard, partner, or customer.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
MeterReadingDocumentERPResultCreateRequest_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_MRDRESULTCRTRQ
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
This inbound operation processes the message type MeterReadingDocumentERPResultCreateRequest.
The following values have to be provided:
Result->Actual Date and time of the meter reading
Result->Meter Reading Result Value
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 56 of 130
Exactly one of the identification variants for creating or finding of meter reading document:
Meter Reading Document ID
Utilities Measurement Task ID and Utilities Object Identification System Code Text
Utilities Device ID and Utilities Object Identification System Code Text
Utilities Point Of Delivery Party ID and Utilities Object Identification System Code Text
Error Handling
Typical errors are:
Actual time of the meter reading or meter reading result value is not provided.
Actual date of the meter reading is initial.
The identification variant isnt provided or is invalid.
Message Types
Meter Reading Document ERP Result Create Request
Prerequisites
To use this service operation, the application component Utilities (IS-U) should be implemented.
Configuration
This operation is suitable for the Utilities Industry Solutions sector. To use this operation, customers must run the IS-U application component. Note that users
should have the correct authorization to create the meter reading result in IS-U.
Enhancements
The ISU_SE_MRDRESULTCRTRCI_ASYN Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_MRD. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
MeterReadingDocumentERPResultBulkCreateRequest_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_MRDRESULTCRTBLKRQ
Category
SAP A2A
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 57 of 130
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
The following values have to be provided for the bulk message:
MessageHeader - UUID
The following values have to be provided for each single message within this inbound operation:
Result - actual date and actual time of the meter reading
Result - meter reading result value
Exactly one of the identification variants for the creation or the finding of the meter reading document:
Meter Reading Document ID
Utilities Measurement Task ID and Utilities Object Identification System Code Text
Utilities Device ID and Utilities Object Identification System Code Text
Utilities Point Of Delivery Party ID and Utilities Object Identification System Code Text
Error Handling
Typical errors are:
Actual time of the meter reading or meter reading result value is not provided
Actual date of meter reading is initial
The identification variant is not provided or is invalid
Message Types
Meter Reading Document ERP Result Bulk Create Request
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
Configuration
This operation is suitable for the Utilities Industry Solutions sector. To use this operation, customers must run the IS-U application component. Note that users
should have the correct authorization to create the meter reading results in IS-U.
Enhancements
The ISU_SE_MRDRESULTCRTBLKRCI_ASYN Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot:
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 58 of 130
ISU_SPOT_SE_MRD. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data.
Technical Data
Entity Type
Service Interface
Category
SAP A2A
Direction
outbound
Technical Data
Entity Type
Service Interface
Category
SAP A2A
Direction
outbound
Integration
This service interface is used in the following process component interactions:
Measurement Processing - Measurement Processing (3rd party) (notify MRD, bulk)
Measurement Processing - Measurement Processing (3rd party) (notify MRD, single)
Service Operations
Notify of Meter Reading Document Result as Bulk
Technical Data
Entity Type
Service Operation
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 59 of 130
IS-UT 607
Release State
Released
Technical Name
MeterReadingDocumentERPResultBulkNotification_Out
Namespace
http://sap.com/xi/IS-U/SE/Global
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
no
Features
The Notify of Meter Reading Document Result as Bulk outbound operation is triggered using the mass activity transaction EDATEXEXECUTEMA when
executable data exchange tasks based on the data exchange basis process EXPMRCONS exist and have the status Planned .
If consumption determination is not active, the service communicates the recorded meter reading.
If consumption determination is active, the service communicates the recorded meter reading and the calculated consumption.
The attribute resultCalculatedQuantityCompleteTransmissionIndicator for the element Result is always set to true. If the attribute
resultCalculatedQuantityCompleteTransmissionIndicator is true, the element CalculatedQuantity is transferred completely. This means that elements
that are not transferred in the message are implicitly regarded by the recipient as being deleted.
If the meter reading document was deleted or reset, or a meter reading result changes from plausible to implausible, the ResultDeletedIndicator is set to
true. The service only communicates the MeterReadingDate and MeterReadingTime in the element Result.
The following figures illustrate both the interface, the fields and cardinality of this service operation. You can use the Utilities data type catalog at
http://service.sap.com/~sapidb/011000358700001049282012E
( service.sap.com/utilities
SAP for Utilities
SAP for Utilities - Product Information
IS-U/CCS General Cookbook&Guidelines
Utilities Data Type Catalog ) to search for information about specific fields.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 60 of 130
Integration
This service operation belongs to the Notify Meter Reading Document Out service interface.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 61 of 130
You can use this BAdI to create a customer-specific logic for the outbound distribution of application data. The implementations are sorted according to the
field Layer of a BAdI implementation , for example, SAP standard, partner, or customer.
Related Items
Measurement Processing process component
Meter Reading Document business object
Meter Reading Document ERP Result Bulk Notification message type
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
MeterReadingDocumentERPResultCreateConfirmation_Out
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
The following values are provided:
MessageHeader - UUID
MessageHeader - Reference_UUID
The log which describes the status of the creation of Meter Reading Document with Result
Message Types
Meter Reading Document ERP Result Create Confirmation
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
Configuration
This operation is suitable for the Utilities Industry Solutions sector. However, it can only be used by customers who are running the IS-U application
component.
Enhancements
The ISU_SE_MRDRESULTCRTRCI_ASYN Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 62 of 130
ISU_SPOT_SE_MRD. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
MeterReadingDocumentERPResultBulkCreateConfirmation_Out
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
The following values are provided for the bulk message:
MessageHeader - UUID
MessageHeader- ReferenceUUID
The log describing the status of the creation of all Meter Reading Documents with Results
The following values will be provided for each single message in this outbound operation:
MessageHeader - UUID
MessageHeader - ReferenceUUID
The log describing the status of the creation of each single Meter Reading Document Result
Message Types
Meter Reading Document ERP Result Bulk Create Confirmation
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
Configuration
This operation is suitable for the Utilities Industry Solutions sector. However, it can only be used by customers who are running the IS-U application
component.
Enhancements
The ISU_SE_MRDRESULTCRTBLKRCI_ASYN Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_MRD. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 63 of 130
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
MeterReadingDocumentERPResultBulkChangeConfirmation_Out
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Related Operations
The corresponding inbound operation is Change Meter Reading Document Result as Bulk in the Measurement Processing process component.
Features
This outbound service operation is used to confirm the change of the existing meter reading document results as a mass process.
The following values are provided for the bulk message:
MessageHeader - UUID
MessageHeader- ReferenceUUID
The log describing the status of the change for all of the meter reading document results
The following values are provided for each single message in this outbound operation:
MessageHeader - UUID
MessageHeader - ReferenceUUID
Meter reading document ID
The log describing the status of the change for each meter reading document result
Processing
For information, see Bulk, Bundle, Collection.
Message Types
Meter Reading Document ERP Result Bulk Change Confirmation
Enhancements
The BAdI for Change Meter Reading Document Result as Bulk and Confirm Meter Reading Document Result Change as Bulk
(ISU_SE_MRDRESULTCHGBLKRCI_ASYN) Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot
ISU_SPOT_SE_MRD.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 64 of 130
You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data. The implementations are sorted
according to the field layer of a BAdI implementation, for example, SAP standard, partner, or customer.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
SmartMeterMeterReadingDocumentERPCreateRequest_Out
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
The following values have to be provided:
MeterReadingDocumentID
MeterReadingReasonCode
ScheduledMeterReadingDate
UtilitiesMeasurementTaskID
UtilitiesDeviceID
UtilitiesAdvancedMeteringSystemID
UtilitiesPointOfDeliveryPartyID
Error Handling
Typical errors include:
General processing and mapping errors: MeterReadingDocumentID (Int. MR doc. ID) is initial; Message UUID not provided.
To get information on monitoring your process integration, see
SAP NetWeaver Process Integration Library
Administrator's Guide Technical
Operations for SAP NetWeaver Administration of SAP NetWeaver Systems
PI (Process Integration) Monitoring Tools for Monitoring
Message Types
Smart Meter Meter Reading Document ERP Create Request
Configuration
This operation is suitable for the Utilities Industry Solutions sector. The customer must run the IS-U application component to use it.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 65 of 130
Enhancements
The Business Add-In (BAdI) ISU_SE_MRDOCSMCRTRCO_ASYN is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_MRD. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
SmartMeterMeterReadingDocumentERPBulkCreateRequest_Out
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
In the bulk request message, each object (meter reading document) should provide the following values:
MeterReadingDocumentID
MeterReadingReasonCode
ScheduledMeterReadingDate
UtilitiesMeasurementTaskID
UtilitiesDeviceID
UtilitiesAdvancedMeteringSystemID
UtilitiesPointOfDeliveryPartyID
The UUID of the (single) request message
Furthermore, the UUID of the bulk request message header should also be supplied.
Error Handling
Typical errors include: General processing and mapping errors like MeterReadingDocumentID (Int. MR doc. ID) is initial; Message request UUID not provided,
and so on.
For more information on monitoring your process integration, see
SAP NetWeaver Process Integration Library
Administrator's Guide Technical
Operations for SAP NetWeaver Administration of SAP NetWeaver Systems
PI (Process Integration) Monitoring Tools for Monitoring .
Message Types
SmartMeterMeterReadingDocumentERPBulkCreateRequest
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 66 of 130
Configuration
This operation is suitable for the Utilities Industry Solutions sector. It is necessary that the customer runs the IS-U application component in order to use it.
Enhancements
The Business Add-In (BAdI) ISU_SE_MRDOCSMCRTBLKRCO_ASYN is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_MRD. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data.
Technical Data
Entity Type
Service Operation
IS-UT 605
Release State
released
Technical Name
SmartMeterMeterReadingDocumentERPCancellationRequest_Out
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
The following values are provided:
MessageHeader-UUID
Meter Reading Document ID
UtilitiesDeviceSmartMeter- Utilities Advanced Metering System ID
Message Types
Smart Meter Meter Reading Document ERP Cancellation Request
Configuration
This operation is suitable for the Utilities Industry Solutions sector. The customer must run the IS-U application component to use it.
Users require the proper authorization to cancel the meter reading documents in IS-U.
Enhancements
The ISU_SE_MRDOCSMCNCRCO_ASYN Business Add-In (BAdI) is available for this operation. This BAdI definition is found in enhancement spot:
ISU_SPOT_SE_MRD. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data.
Page 67 of 130
Technical Data
Entity Type
Service Operation
IS-UT 605
Release State
released
Technical Name
SmartMeterMeterReadingDocumentERPBulkCancellationRequest_Out
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
The following values will be provided for the bulk message:
MessageHeader - UUID
The following values will be provided for each single message inside this outbound operation :
MessageHeader - UUID
Meter Reading Document ID
UtilitiesDeviceSmartMeter - Utilities Advanced Metering System ID
Message Types
Smart Meter Meter Reading Document ERP Bulk Cancellation Request
Prerequisites
To use this service operation, the application component Utilities (IS-U) should be implemented.
Configuration
This operation is suitable for the Utilities Industry Solutions sector. It is necessary that the customer runs the IS-U application component in order to use it.
Note that users should have the proper authorization in order to cancel the meter reading documents in IS-U.
Enhancements
The ISU_SE_MRDOCSMCNCRCO_ASYN Business Add-In (BAdI) is available for this operation. This BAdI definition is found in enhancement spot:
ISU_SPOT_SE_MRD. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data.
Page 68 of 130
Technical Data
Entity Type
Service Operation
IS-UT 605
Release State
Released
Technical Name
SmartMeterMeterReadingDocumentERPResultCreateRequest_Out
Namespace
http://sap.com/xi/IS-U/Global
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
true
Note
The service operation is not called automatically; you must implement the BAdI ISU_AMI_SEND_MR. For more information about the implementation and
when it is called, see the BAdI documentation. This BAdI is available in the enhancement spot ISU_AMI_SEND_MR.
Features
The following graphic illustrates both the interface, the fields, and cardinality of this service operation. You can use the SAP Global Data Types Catalog (GDT
catalog) to search for information about specific fields.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 69 of 130
Related Operations
The bulk counterpart for this service operation is the SmartMeterMeterReadingDocumentERPResultBulkCreateRequest_Out operation
The inbound counterpart for this outbound operation is the SmartMeterMeterReadingDocumentERPResultCreateConfirmation_In operation
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
Integration
This service operation belongs to the Meter Reading Document Out service interface.
Error Handling
Typical general processing and/or mapping errors are:
MeterReadingDocumentID not provided
Message UUID not provided
For more information about monitoring your process integration, see the SAP Process Integration (PI) Handbook.
ES Bundles
This service operation is part of the Advanced Meter Infrastructure ES bundle. For more information about this bundle, see the Enterprise Services WIKI at
https://wiki.sdn.sap.com/wiki/display/ESpackages/Advanced+Meter+Infrastructure
Technical Data
Entity Type
Service Operation
IS-UT 605
Release State
Released
Technical Name
SmartMeterMeterReadingDocumentERPResultBulkCreateRequest_Out
Namespace
http://sap.com/xi/IS-U/Global
Application Component
IS-U
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 70 of 130
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
true
Note
The service operation is not called automatically; you must implement the BAdI ISU_AMI_SEND_MR. For more information about the implementation and
when it is called, see the BAdI documentation. This BAdI is available in the enhancement spot ISU_AMI_SEND_MR.
Features
The following graphic illustrates both the interface, the fields, and cardinality of this service operation. You can use the Utilities data type catalog at
http://service.sap.com/~sapidb/011000358700001049282012E
( service.sap.com/utilities
SAP for Utilities
SAP for Utilities - Product Information
IS-U/CCS General Cookbook&Guidelines
Utilities Data Type Catalog ) to search for information about specific fields.
Related Operations
The single counterpart for this service operation is the SmartMeterMeterReadingDocumentERPResultCreateRequest_Out operation
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 71 of 130
The inbound counterpart for this outbound operation is the SmartMeterMeterReadingDocumentERPResultBulkCreateConfirmation_In operation
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
Integration
This service operation belongs to the Meter Reading Document Out service interface.
Error Handling
Typical general processing and/or mapping errors are:
MeterReadingDocumentID not provided
Message UUID not provided
For more information about monitoring your process integration, see the SAP Process Integration (PI) Handbook.
ES Bundles
This service operation is part of the Advanced Meter Infrastructure ES bundle. For more information about this bundle, see the Enterprise Services WIKI at
https://wiki.sdn.sap.com/wiki/display/ESpackages/Advanced+Meter+Infrastructure
Technical Data
Entity Type
Service Operation
IS-UT 605
Release State
Released
Technical Name
SmartMeterMeterReadingDocumentERPResultChangeRequest_Out
Namespace
http://sap.com/xi/IS-U/Global
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
true
Note
The service operation is not triggered automatically; you must implement the BAdI ISU_AMI_SEND_MR. For more information about the implementation
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 72 of 130
and when it is called, see the BAdI documentation. This BAdI is available in the enhancement spot ISU_AMI_SEND_MR.
Features
The following graphic illustrates both the interface, the fields and cardinality of this service operation. You can use the Utilities data type catalog at
http://service.sap.com/~sapidb/011000358700001049282012E
( service.sap.com/utilities
SAP for Utilities
SAP for Utilities - Product Information
IS-U/CCS General Cookbook&Guidelines
Utilities Data Type Catalog ) to search for information about specific fields.
Related Operations
The bulk counterpart for this service operation is the SmartMeterMeterReadingDocumentERPResultBulkChangeRequest_Out operation
The inbound counterpart for this outbound operation is the SmartMeterMeterReadingDocumentERPResultChangeConfirmation_In operation
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
Integration
This service operation belongs to the Meter Reading Document Out service interface.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 73 of 130
Enhancements
The Business Add-In (BAdI) ISU_SE_MRDRESSMCHGRCO_ASYN is available for this service operation. This BAdI allows you to use a customer-specific
logic for the inbound/outbound mapping of application data. This BAdI is available in the enhancement spot ISU_SPOT_SE_MRD.
The BAdI can be implemented several times. The implementations are sorted according to the content of the field Layer of a BAdI implementation , for
example, SAP standard, partner, or customer.
Error Handling
Typical general processing and/or mapping errors are:
MeterReadingDocumentID not provided
Message UUID not provided
For more information about monitoring your process integration, see the SAP Process Integration (PI) Handbook.
ES Bundles
This service operation is part of the Advanced Meter Infrastructure ES bundle. For more information about this bundle, see the Enterprise Services WIKI at
https://wiki.sdn.sap.com/wiki/display/ESpackages/Advanced+Meter+Infrastructure
Technical Data
Entity Type
Service Operation
IS-UT 605
Release State
Released
Technical Name
SmartMeterMeterReadingDocumentERPResultBulkChangeRequest_Out
Namespace
http://sap.com/xi/IS-U/Global
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
true
Note
The service operation is not called automatically; you must implement the BAdI ISU_AMI_SEND_MR. For information about the implementation and when
it is called, see the BAdI documentation. This BAdI is available in the enhancement spot ISU_AMI_SEND_MR.
Features
The following graphic illustrates both the interface, the fields and cardinality of this service operation. You can use the Utilities data type catalog at
http://service.sap.com/~sapidb/011000358700001049282012E
( service.sap.com/utilities
SAP for Utilities
SAP for Utilities - Product Information
IS-U/CCS General Cookbook&Guidelines
Utilities Data Type Catalog ) to search for information about specific fields.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 74 of 130
Related Operations
The single counterpart for this service operation is the SmartMeterMeterReadingDocumentERPResultChangeRequest_Out operation
The inbound counterpart for this outbound operation is the SmartMeterMeterReadingDocumentERPResultBulkChangeConfirmation_In operation
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
Integration
This service operation belongs to the Meter Reading Document Out service interface.
Error Handling
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 75 of 130
ES Bundles
This service operation is part of the Advanced Meter Infrastructure ES bundle. For more information about this bundle, see the Enterprise Services WIKI at
https://wiki.sdn.sap.com/wiki/display/ESpackages/Advanced+Meter+Infrastructure
Technical Data
Entity Type
Service Interface
Category
A2X
Direction
inbound
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
MeterReadingDocumentERPResultByUtilitiesDeviceQueryResponse_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_MRDOC002QR
Category
A2X
Direction
inbound
Mode
synchronous
Idempotency
no
Change/Update Behavior
not applicable
true
Features
When this service is executed, a list of Meter Reading Document IDs is retrieved.
The following values must be provided:
Utilities Device ID
Optionally, you can restrict the query by providing additional parameters.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 76 of 130
Error Handling
Typical errors are:
No objects correspond to the selection criteria
General mapping error; UtilitiesDeviceID (Equipment) is initial
Message Types
MeterReadingDocumentERPResultByUtilitiesDeviceQuery_sync
MeterReadingDocumentERPResultByUtilitiesDeviceResponse_sync
Configuration
This operation is suitable for the Utilities Industry Solutions sector. It is necessary that the customer runs the IS-U application component in order to use it.
Note that users should have the proper authorization to display the Meter Reading Document, that is, permission for activity 11 (Display Order) for
authorization objects E_MR_DOC, E_MR_DOC1, E_MR_DOC2.
Enhancements
The ISU_SE_MRDOC002QR Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_MRD. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data.
The implementations are sorted according to the field layer of a BAdI implementation, for example, SAP standard, partner, or customer. You should implement
this BAdI to select the most important MeterReadingReasonCode if more than one reason is maintained for a Meter Reading Document.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
MeterReadingDocumentERPSimpleByUtilitiesDeviceQueryResponse_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_MRDOC001QR
Category
A2X
Direction
inbound
Mode
synchronous
Idempotency
no
Change/Update Behavior
not applicable
true
Features
When this service is executed, a list of meter reading documents IDs is retrieved. The following values must be provided:
Utilities Device ID
Optionally, you can restrict the query by providing additional parameters.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 77 of 130
Error Handling
Typical errors are:
No objects correspond to the selection criteria
General mapping error; UtilitiesDeviceID (Equipment) is initial
Message Types
MeterReadingDocumentERPSimpleByUtilitiesDeviceQuery_sync
MeterReadingDocumentERPSimpleByUtilitiesDeviceResponse_sync
Configuration
This operation is suitable for the Utilities Industry Solutions sector. It is necessary that the customer runs the IS-U application component in order to use it.
Note: Users should have the proper authorization to display the meter reading document, that is, permission for activity #11 (Display Order) for authorization
objects E_MR_DOC, E_MR_DOC1, E_MR_DOC2.
Enhancements
The ISU_SE_MRDOC001QR Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_MRD. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data.
The implementations are sorted according to the field layer of a BAdI implementation, for example, SAP standard, partner, or customer. You should implement
this BAdI to select the most important MeterReadingReasonCode if multiple reasons are maintained for a meter reading document.
Technical Data
Entity Type
Business Object
Technical Name
UtilitiesMeasurementTask
Object Category
Technical Data
Entity Type
Service Interface
Category
A2X
Direction
inbound
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 78 of 130
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
UtilitiesMeasurementTaskERPBasicDataByIDQueryResponse_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_MeasurementTaskIDQR
Category
A2X
Direction
inbound
Mode
synchronous
Idempotency
no
Change/Update Behavior
not applicable
true
Features
When this operation is executed, the basic Utilities Measurement Task data, related to the provided Utilities Measurement Task ID, is returned. A Utilities
Measurement Task ID is mandatory. If you do not provide one, you will receive an error message and no results will be returned.
Error Handling
If you do not enter a Utilities Measurement Task ID, you will receive an error message.
No Utilities Measurement Task basic data will be found if you enter an invalid Utilities Measurement Task ID.
Note that users should have the proper authorization in order to display Utilities Measurement Task basic data.
Message Types
UtilitiesMeasurementTaskERPBasicDataByIDQuery_sync
UtilitiesMeasurementTaskERPBasicDataByIDResponse_sync
Configuration
This operation is suitable for the Utilities Industry Solutions sector. It is necessary that the customer runs the IS-U application component in order to use it.
Note that users should have the proper authorization in order to display the contracts (authorization object E_LOG_REG).
Enhancements
The ISU_SE_MEASTASKIDQR Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_MEASTASK. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 79 of 130
Technical Data
Entity Type
Service Interface
Category
SAP A2A
Direction
outbound
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
Released
Technical Name
SmartMeterUtilitiesMeasurementTaskERPPointOfDeliveryBulkAssignedNotification
_Out
Namespace
http://sap.com/xi/IS-U/Global2
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
no
no
Features
When changing the external ID of the PoD, the information about the new ID of the PoD has to be distributed to the AMI system. Therefore, you require a
notification that contains both the old and the new external ID of the PoD.
The following elements in the bulk request message are mandatory for every object:
Utilities Measurement Task ID
@UtilitiesPoint of DeliveryAssignmentListCompleteTransmissionIndicator
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 80 of 130
StartDate
StartTime
EndDate
EndTime
UtilitiesPointOfDeliveryPartyID
UtilitiesDeviceID
UtilitiesAdvancedMeteringSystemID
When the element @UtilitiesPointOfDeliveryAssignmentListCompleteTransmissionIndicator is selected:
If the node UtilitiesPointOfDeliveryAssignment is not part of the message, all entries for Utilities Point Of Delivery Assignments in the AMI System are
deleted.
If the node UtilitiesPointOfDeliveryAssignment is part of the message, all entries for Utilities Point Of Delivery Assignments in the message are changed
in the AMI System and the other entries which are not part of the message are deleted.
When the element @UtilitiesPointOfDeliveryAssignmentListCompleteTransmissionIndicator is not selected:
If the node UtilitiesPointOfDeliveryAssignment is not part of the message, no entries for Utilities Point Of Delivery Assignments are changed in the AMI
System.
If the node UtilitiesPointOfDeliveryAssignment is part of the message, all entries for Utilities Point Of Delivery Assignments in the message are changed
in the AMI System.
If you do not provide one or more of the mandatory elements, the system displays an error message and no information is sent to the AMI System.
Error Handling
If you do not enter one of the mandatory elements mentioned under Features , the system displays an error message.
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
SmartMeterUtilitiesMeasurementTaskERPDeviceAssignmentNotification_Out
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Page 81 of 130
This service operation is used to inform an external system, such as a Meter Data Synchronization and Unification System (MDUS) about new or changed
device allocations on register level (table EZUZ).
Message Types
Smart Meter Utilities Measurement Task ERP Device Assignment Notification
Enhancements
The ISU_SE_MEASTASKSMDEVNOO_ASYN Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_MEASTASK. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data. The
implementations are sorted according to the content of the field layer of a BAdI implementation, for example, SAP standard, partner, or customer.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
SmartMeterUtilitiesMeasurementTaskERPPointOfDeliveryAssignedNotification_Out
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
When changing the external ID of the PoD, the information regarding the new ID of the PoD has to be distributed to the AMI system. Therefore a notification
containing the old and the new external ID of the PoD is needed.
The following elements are mandatory:
Utilities Measurement Task ID
@UtilitiesPoint of DeliveryAssignmentListCompleteTransmissionIndicator
StartDate
StartTime
EndDate
EndTime
UtilitiesPointOfDeliveryPartyID
UtilitiesDeviceID
UtilitiesAdvancedMeteringSystemID
When the element @UtilitiesPointOfDeliveryAssignmentListCompleteTransmissionIndicator is set:
If the node UtilitiesPointOfDeliveryAssignment is not part of the message, all entries for Utilities Point Of Delivery assignments in the AMI system will
be deleted.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 82 of 130
If the node UtilitiesPointOfDeliveryAssignment is part of the message, all entries for Utilities Point Of Delivery assignments in the message will be
changed in the AMI system and the other entries which are not part of the message will be deleted.
When the element @UtilitiesPointOfDeliveryAssignmentListCompleteTransmissionIndicator is not set:
If the node UtilitiesPointOfDeliveryAssignment is not part of the message, no entries for Utilities Point Of Delivery Assignments are changed in the AMI
system.
If the node UtilitiesPointOfDeliveryAssignment is part of the message, all entries for Utilities Point Of Delivery Assignments in the message will be
changed in the AMI system.
If you do not provide one or more of the mandatory elements, you will receive an error message and no information will be sent to the AMI system.
Error Handling
If you do not enter any one of the mandatory elements mentioned above, you will receive an error.
Message Types
SmartMeterUtilitiesMeasurementTaskERPPointOfDeliveryAssignedNotification
Prerequisites
To use this service operation, the application component Utilities (IS-U) should be implemented.
Configuration
This operation is suitable for the Utilities Industry Solutions sector. It is necessary that the customer runs the IS-U application component in order to use it.
Enhancements
The Business Add-In (BAdI) ISU_SE_MEASTASKSMPODNOO_A is available for this operation. This BAdI definition is found in the enhancement spot
ISU_SPOT_SE_MEASTASK. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data.
Technical Data
Entity Type
Service Interface
Category
A2X
Direction
inbound
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 83 of 130
Technical Name
UtilitiesMeasurementTaskERPSimpleByUtilitiesPointOfDeliveryIDQueryResponse_
In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_MeasurementTask001QR
Category
A2X
Direction
inbound
Mode
synchronous
Idempotency
no
Change/Update Behavior
not applicable
true
Features
When this operation is executed, a list of Utilities Measurement Tasks, that are related to the provided Utilities Point Of Delivery Internal ID, is returned. A
Utilities Point Of Delivery Internal ID is mandatory; if you do not provide one, you will receive an error message and no results will be returned.
Error Handling
If you do not enter a Utilities Point Of Delivery Internal ID, you will receive an error message.
No Utilities Measurement Task will be found if you enter an invalid Utilities Point Of Delivery Internal ID.
Users should have the proper authorization to display Utilities Measurement Task basic data.
Message Types
UtilitiesMeasurementTaskERPSimpleByUtilitiesPointOfDeliveryIDQuery_sync
UtilitiesMeasurementTaskERPSimpleByUtilitiesPointOfDeliveryIDResponse_sync
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
Configuration
This operation is suitable for the Utilities Industry Solutions sector. It is necessary that the customer runs the IS-U application component in order to use it.
Note that users should have the proper authorization to display the contracts (authorization object E_LOG_REG).
Enhancements
The ISU_SE_MEASTASK001QR Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_MEASTASK. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data.
Technical Data
Entity Type
Service Interface
Category
SAP A2A
Direction
inbound
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 84 of 130
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
SmartMeterUtilitiesMeasurementTaskERPBulkChangeConfirmation_In
Namespace
http://sap.com/xi/IS-U/Global2
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
no
no
Features
When changing relevant register information (such as TOU information, register category or interval length), this information has to be sent to AMI.
Firstly, a request for changing the basic data is sent to AMI (SmartMeterUtilitiesMeasurementTaskERPChangeRequest_Out). Following this, the
corresponding confirmation (SmartMeterUtilitiesMeasurementTaskERPChangeConfirmation_In) is received.
This service consists of the following nodes:
UtilitiesMeasurementTask
UtilitiesDevice
The following elements are mandatory:
Utilities Measurement Task ID
UtilitiesDeviceID
If one or more mandatory elements are not provided, the system displays an error message.
Error Handling
The SmartMeterUtilitiesMeasurementTaskERPBulkChangeConfirmation_In operation supports Forward Error Handling (FEH).
The following error category is used: PRE.AUE Authorization error
For more information about individual error categories, see the code list for the global data type LogItemCategoryCode.
Message Types
Smart Meter Utilities Measurement Task ERP Bulk Change Confirmation
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
Page 85 of 130
Switch Framework
To use this service operation, activate the Utilities business function set (ISU_UTIL_1).
Configuration
This operation is suitable for the Utilities Industry Solutions sector. However, it is only available to customers who are running the IS-U application component.
Enhancements
The Business Add-In (BAdI) ISU_SE_MTSMCHGBLKRCO_ASYN is available for this service operation. This BAdI allows you to use a customer-specific logic
for the inbound/outbound mapping of application data. This BAdI is available in the enhancement spot ISU_SPOT_SE_DEVICE.
The BAdI can be implemented several times. The implementations are sorted according to the field layer of a BAdI implementation, for example, SAP
standard, partner, or customer.
More Information
The outbound counterpart for this inbound operation is the Request Utilities Device Smart Meter Change as
Bulk (UtilitiesDeviceERPSmartMeterBulkChangeRequest_Out) operation.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
SmartMeterUtilitiesMeasurementTaskERPChangeConfirmation_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_MEASTASKSMCHGCO
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
Type1
yes
Features
When changing relevant register information, such as TOU information, register category or interval length, this information has to be sent to AMI. Firstly, a
request for changing the basic data is sent to AMI (SmartMeterUtilitiesMeasurementTaskERPChangeRequest_Out). Secondly, the corresponding confirmation
(SmartMeterUtilitiesMeasurementTaskERPChangeConfirmation_In ) is received.
This service consists of the following nodes:
UtilitiesMeasurementTask
UtilitiesDevice
The following elements are mandatory:
Utilities Measurement Task ID
UtilitiesDeviceID
If one or more mandatory elements are not provided, the system displays an error message.
Error Handling
The system also displays an error message if any of the mandatory elements mentioned above are not provided.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 86 of 130
Message Types
Smart Meter Utilities Measurement Task ERP Change Confirmation
Prerequisites
To use this service operation, the application component Utilities (IS-U) should be implemented.
Configuration
This operation is suitable for the Utilities Industry Solutions sector. However, it can only be used by customers who are running the IS-U application
component.
Enhancements
The Business Add-In (BAdI) ISU_SE_MEASTASKSMCHGRCO_ASYN is available for this operation. This BAdI definition is found in the enhancement spot
ISU_SPOT_SE_MEASTASK. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data.
Technical Data
Entity Type
Service Interface
Category
SAP A2A
Direction
outbound
Technical Data
Entity Type
Service Operation
IS-UT 605
Release State
released
Technical Name
SmartMeterUtilitiesMeasurementTaskERPChangeRequest_Out
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
Category
SAP A2A
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 87 of 130
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
Type1
yes
Features
When changing relevant register information, for example, TOU information, register category or interval length, this information has to be sent to AMI. Firstly,
a request for changing the basic data is sent to AMI. Secondly, the corresponding confirmation
(SmartMeterUtilitiesMeasurementTaskERPChangeConfirmation_In) is received.
The following elements are mandatory:
Utilities Measurement Task ID
Time Zone Code
StartDate
EndDate
MeasureUnitCode
DecimalValuePrecision
UtilitiesDeviceID
UtilitiesAdvancedMeteringSystemID
If you do not provide one or more of the mandatory elements, you will receive an error message and no information will be sent to AMI.
Error Handling
If you do not enter any one of the mandatory elements mentioned above, you will receive an error.
Message Types
SmartMeterUtilitiesMeasurementTaskERPChangeRequest
Prerequisites
To use this service operation, the application component Utilities (IS-U) should be implemented.
Configuration
This operation is suitable for the Utilities Industry Solutions sector. It is necessary that the customer runs the IS-U application component in order to use it.
Enhancements
The Business Add-In (BAdI) ISU_SE_MEASTASKSMCHGRCO_ASYN is available for this operation. This BAdI definition is contained in the Enhancement
Spot ISU_SPOT_SE_MEASTASK. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data.
Technical Data
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 88 of 130
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
SmartMeterUtilitiesMeasurementTaskERPBulkChangeRequest_Out
Namespace
http://sap.com/xi/IS-U/Global2
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
no
no
Features
The service is used when key information regarding multiple measurement tasks (for example, TOU information, register category, interval length ID) is
changed in IS-U. The selection date for the advanced metering system should be the change date. If this date is not available, the current system date (sydatum) should be used. The service is triggered when data is changed at register level and multiple registers for a specific device are involved: Device
Modification (EG42)
In a first step, a request for changing the basic data is sent to AMI. Following this, the corresponding confirmation
(SmartMeterUtilitiesMeasurementTaskERPBulkChangeConfirmation_In) is received.
Error Handling
The following elements in the bulk request message are mandatory for every object:
Utilities Measurement Task ID
Time Zone Code
StartDate
EndDate
MeasureUnitCode
DecimalValuePrecision
UtilitiesDeviceID
UtilitiesAdvancedMeteringSystemID
If you do not provide one or more of the mandatory elements, the system displays an error message and no information is sent to AMI.
You should also provide the UUID of the bulk request message.
Message Types
Smart Meter Utilities Measurement Task ERP Bulk Change Request
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
More Information
The inbound counterpart for this outbound operation is the Change based on Smart Meter Measurement Task Change Confirmation as Bulk
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 89 of 130
(SmartMeterUtilitiesMeasurementTaskERPBulkChangeConfirmation_In) operation.
Technical Data
Entity Type
Process Component
Technical Name
ServiceContractProcessing
Namespace
http://sap.com/xi/ESM/ERP
Technical Data
Entity Type
Process Component
Technical Name
UtilitiesConnectionProcessing
Namespace
http://sap.com/xi/ESM/ERP
Technical Data
Entity Type
Business Object
Technical Name
UtilitiesConnectionStatusChangeRequest
Object Category
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 90 of 130
Technical Data
Entity Type
Service Interface
Category
SAP A2A
Direction
inbound
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
SmartMeterUtilitiesConnectionStatusChangeRequestERPBulkCreateConfirmation_
In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_CONNSTSREQSMCRTBLKCO
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Related Operations
The corresponding outbound operation is Request Smart Meter Utilities Connection Status Change Request Creation as Bulk.
Features
For information, see Change based on Smart Meter Connection Status Change Request Create Confirmation.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 91 of 130
Processing
For information, see Bulk, Bundle, Collection.
Error Handling
For information, see Change based on Smart Meter Connection Status Change Request Create Confirmation.
Message Types
SmartMeterUtilitiesConnectionStatusChangeRequestERPBulkCreateConfirmation
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
SmartMeterUtilitiesConnectionStatusChangeRequestERPCancellationConfirmatio
n_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_CONNSTSREQSMCNCCO
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
The inbound service Change Based on Smart Meter Connection Status Change Request Cancellation Conf. is used to confirm the new
disconnection/reconnection of a specific smart meter. The operation is sent from an external system back to the SAP system.
This service operation is used by SAP for Utilities, transaction EC87 Display Disconnection Document, to confirm the status of a Utilities smart
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 92 of 130
metering device. The operation can only be triggered if the device is an AMI device (smart meter). To trigger the operation, the user must first request
the cancellation of a remote disconnection or reconnection. The operation is confirmed by the MDUS (an external system).
The MDUS sends a cancellation confirmation of a disconnection/reconnection of a specific smart meter. The CancellationConfirmation updates the
status of the smart meter.
Error Handling
Forward Error Handling
The Change Based on Smart Meter Connection Status Change Request Cancellation Conf. operation supports Forward Error Handling (FEH). The following
error categories are used:
PRE.AUE : Authorization Error
PRE.TEE.LRE : Lock Request Error
PRE.IDE : Identification Error
PRE : Processing Error
For more information about the individual error categories, see the code list for the global data type LogItemCategoryCode.
Message Types
SmartMeterUtilitiesConnectionStatusChangeRequestERPCancellationConfirmation
Enhancements
The ISU_SE_CONNSTSREQSMCNCRCO_ASYN Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement
spot: ISU_SPOT_SE_CONNSTSREQ. You can use this BAdI to create a customer-specific logic for the outbound mapping of application data. The
implementations are sorted according to the field layer of a BAdI implementation, for example, SAP standard, partner, or customer.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
SmartMeterUtilitiesConnectionStatusChangeRequestERPCreateConfirmation_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_CONNSTSREQSMCRTCO
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 93 of 130
After this service operation is executed, the confirmation status for the disconnection or reconnection is changed.
If the confirmation is positive, the request status is:
Remote Disconnection Confirmed
Remote Disconnection Executed
Remote Reconnection Confirmed
Remote Reconnection Executed
If the confirmation is negative, the request status is:
Remote Disconnection Failed
Remote Reconnection Failed
Features
The inbound service operation Change Based on Smart Meter Connection Status Change Request Create Confirmation is used to confirm the new
disconnection/reconnection of a specific smart meter. The operation is sent from an external system back into the SAP system.
This service operation is used by SAP for Utilities, transaction EC87 Display Disconnection Document, to confirm the status of a Utilities AMI device
(smart meter). To trigger the operation, the device must be an AMI device and the user has to request a cancellation of a remote disconnection or
reconnection. The operation is confirmed by the MDUS (an external system).
The MDUS sends a confirmation of a disconnection/reconnection of a specific smart meter.
The Change Based on Smart Meter Connection Status Change Request Create Confirmation operation updates the status of the smart meter.
Error Handling
Forward Error Handling
The Change Based on Smart Meter Connection Status Change Request Create Confirmation operation supports Forward Error Handling (FEH). The following
error categories are used:
PRE.AUE : Authorization Error
PRE.TEE.LRE : Lock request Error
PRE.IDE :Identification Error
PRE : Processing Error
For more information about the individual error categories, see the code list for the global data type LogItemCategoryCode.
Message Types
Smart Meter Utilities Connection Status Change Request ERP Create Confirmation
Enhancements
The ISU_SE_CONNSTSREQSMCRTRCO_ASYN Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement
spot: ISU_SPOT_SE_CONNSTSREQ. You can use this BAdI to create a customer-specific logic for the outbound mapping of application data. The
implementations are sorted according to the field layer of a BAdI implementation, for example, SAP standard, partner, or customer.
Technical Data
Entity Type
Service Interface
Category
SAP A2A
Direction
outbound
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 94 of 130
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
SmartMeterUtilitiesConnectionStatusChangeRequestERPCancellationRequest_Ou
t
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
The outbound service Request Smart Meter Utilities Connection Status Change Request Cancellation performs a request to create a cancellation of
a disconnection or a reconnection of a specific smart meter. The operation is sent from the SAP system to an external system.
This service operation is used by SAP for Utilities, transaction EC86 Change Disconnection Document, to update the status of a Utilities smart metering
device. The operation can only be triggered if the device is an AMI (Advanced Metering Infrastructure) device. To trigger the operation, the user should choose
the Reverse Disconnection or Reconnection Action button. The operation then sends the current status of an AMI device to an external system called MDUS
(Meter Data Unification & Synchronization).
Message Types
Smart Meter Utilities Connection Status Change Request ERP Cancellation Request
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 95 of 130
Enhancements
The ISU_SE_CONNSTSREQSMCNCRCO_ASYN Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement
spot: ISU_SPOT_SE_CONNSTSREQ.
You can use this BAdI to create a customer-specific logic for the outbound mapping of application data. The implementations are sorted according to the field
layer of a BAdI implementation, for example, SAP standard, partner, or customer.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
SmartMeterUtilitiesConnectionStatusChangeRequestERPCreateRequest_Out
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
The outbound service Request Smart Meter Utilities Connection Status Change Request Creation requests the disconnection or reconnection of a specific
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 96 of 130
smart meter. The request is sent from the SAP system to an external system (Meter Data Unification and Synchronization).
This service operation is used by SAP for Utilities, transaction EC85 Create Disconnection Document, and is used to update the status of a utilities smart
meter. The operation can only be triggered if the device in question is an AMI (Advanced Metering Infrastructure) device. To trigger the operation, the user
must choose the Trigger Remote Disconnection" or "Trigger Remote Reconnection" button. The operation then sends the current status of the AMI device to
the MDUS external system.
The Request Smart Meter Utilities Connection Status Change Request Creation operation requires the ID of the Utilities Connection Status Change Request
message combined with the device that the service wishes to update.
Message Types
Smart Meter Utilities Connection Status Change Request ERP Create Request
Enhancements
The ISU_SE_CONNSTSREQSMCRTRCO_ASYN Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement
spot: ISU_SPOT_SE_CONNSTSREQ.
You can use this BAdI to create a customer-specific logic for the outbound mapping of application data. The implementations are sorted according to the field
layer of a BAdI implementation, for example, SAP standard, partner, or customer.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
SmartMeterUtilitiesConnectionStatusChangeRequestERPBulkCreateRequest_Out
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Related Operations
The Request Smart Meter Utilities Connection Status Change Request Creation outbound operation sends a single disconnection order.
The Change based on Smart Meter Connection Status Change Request Bulk Create Conf. inbound operation confirms the disconnection orders.
Features
For general information, see Request Smart Meter Utilities Connection Status Change Request Creation.
To send a disconnection order, the following information is needed:
AMI request ID (ID element)
Disconnection activity category (UtilitiesServiceDisconnectionReasonCode element)
Date and time of disconnection activity (PlannedProcessingDateTime element)
Equipment number (UtilitiesDeviceID element)
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 97 of 130
Processing
For more information, see Bulk, Bundle, Collection.
Message Types
SmartMeterUtilitiesConnectionStatusChangeRequestERPBulkCreateRequest
Enhancements
The BAdI for Utilities Connection Status Bulk Createl Request Confirmation (ISU_SE_CNSTSRQSMCRTBLKRCO_ASYN) Business Add-In (BAdI) is available
for this operation. This BAdi is found in the enhancement spot ISU_SPOT_SE_CONNSTSREQ. It allows you to create customer-specific inbound and
outbound mapping for pre- and post-processing.
Technical Data
Software Component Version
Technical Name
UtilitiesConnectionProcessingNotifyUtilitiesConnectionStatusChangeRequestOut
Category
SAP A2A
Direction
Outbound
Integration
This service interface is used in the following process component interactions:
Utilities Connection Processing - MDUS Processing (third party) (notify connection status - single)
Utilities Connection Processing - MDUS Processing (third party) (notify connection status - bulk)
Service Operations
Create Notification of Utilities Connection Status Change Request as Bulk
To send a notification about the utilities connection status change request as bulk.
as Bulk
request as bulk.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 98 of 130
Technical Data
Entity Type
Service Operation
IS-UT 605
Release State
Released
Technical Name
SmartMeterUtilitiesConnectionStatusChangeRequestERPBulkNotification_Out
Namespace
http://sap.com/xi/IS-U/Global
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
true
Features
The following graphic illustrates both the interface, the fields and cardinality of this service operation. You can use the Utilities data type catalog at
http://service.sap.com/~sapidb/011000358700001049282012E
( service.sap.com/utilities
SAP for Utilities
SAP for Utilities - Product Information
IS-U/CCS General Cookbook&Guidelines
Utilities Data Type Catalog ) to search for information about specific fields.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 99 of 130
Related Items
Utilities Device business object
Notify Cancellation of Smart Meter Utilities Connection Status Change Request as Bulk service operation
Error Handling
Typical general processing and/or mapping errors are:
UtilitiesDeviceID not provided
Message UUID not provided
For more information about monitoring your process integration, see the SAP Process Integration (PI) Handbook.
Integration
This service operation belongs to the Notify Utilities Connection Status Change Request Out service interface.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Configuration
This operation is suitable for the Utilities Industry Solutions sector. However, it is only available to customers who are running the IS-U application component.
Enhancements
The Business Add-In (BAdI) ISU_SE_CNSTSRQSMBLKNOO_ASYN is available for this operation. This BAdI definition is found in the enhancement spot
ISU_SPOT_SE_CONNSTSREQ. You can use this BAdI to create a customer-specific logic for inbound and outbound mapping of application data. The BAdI
can be implemented several times. The implementations are sorted according to the field layer of a BAdI implementation, for example, SAP standard, partner,
customer, and so on.
Technical Data
Entity Type
Service Operation
IS-UT 605
Release State
Released
Technical Name
SmartMeterUtilitiesConnectionStatusChangeRequestERPCancellationBulkNotificat
ion_Out
Namespace
http://sap.com/xi/IS-U/Global
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
true
Features
The following graphic illustrates both the interface and the fields and cardinality of this service operation. You can use the Utilities data type catalog at
http://service.sap.com/~sapidb/011000358700001049282012E
( service.sap.com/utilities
SAP for Utilities
SAP for Utilities - Product Information
IS-U/CCS General Cookbook&Guidelines
Utilities Data Type Catalog ) to search for information about specific fields.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Related Items
Utilities Device business object.
Error Handling
Typical general processing and/or mapping errors are:
UtilitiesDeviceID not provided
Message UUID not provided
For more information about monitoring your process integration, see the SAP Process Integration (PI) Handbook.
Integration
This service operation belongs to the Notify Utilities Connection Status Change Request Out service interface.
Technical Data
Entity Type
Service Interface
Category
SAP A2A
Direction
inbound
Constraints
This service interface has been released as of ECC 6.0 EhP2 (IS-U 602). A new version of this service interface is available as of ECC 6.0 EhP5. We strongly
recommend using the new service interface Utilities Connection Status Change Request In, instead.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
deprecated
This service operation has been released as of ECC 6.0 EhP2 (IS-U 602). A new
version of this service is available as of EhP5 (IS-U 605). SAP strongly recommends
using the new service operation Change based on Smart Meter Connection Status
Change Request Create Confirmation , instead.
Technical Name
UtilitiesConnectionStatusChangeRequestConfirmation_In
Namespace
http://sap.com/xi/IS-U
Application Component
IS-U
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
no
Related Operations
Request Utilities Connection Status Change Request
Request Utilities Connection Status Change Request Cancellation
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Features
This inbound service is an asynchronous service which is triggered from a remote system (AMS). In the signature of the incoming inbound message, the
following GDTs (Global Data Types) are expected to be included with corresponding values
Message Header
ID: (Used data type: UtilitiesConnectionStatusChangeRequestID)
Log
Message Types
UtilitiesConnectionStatusChangeRequestConfirmation
Constraints
This inbound service operation is used as confirmation to the following request messages:
UtilitiesConnectionStatusChangeRequestRequest, ( Activity Category Code: Disconnection)
UtilitiesConnectionStatusChangeRequestRequest, (Activity Category Code: Reconnection)
UtilitiesConnectionStatusChangeRequestCancelRequest, (Cancellation)
Processing
To use this service operation, the Utilities (IS-U) application component should be implemented.
The Change Utilities Connection Status Change Request Based on Confirmation inbound confirmation message from the AMS is the response to the
following outbound requests that are triggered in the SAP for Utilities backend system:
Disconnection or Reconnection request (UtilitiesConnectionStatusChangeRequestRequest)
Cancellation of Disconnection request (UtilitiesConnectionStatusChangeRequestRequest).
Enhancements
The Add-In (BAdI) BADI_ISU_DISCON_CONFIRM_IN is available for this operation. This BAdI definition is found in the enhancement spot:
SPOT_ISU_CONNECTION_IN. You can use this BAdI to create a customer-specific logic for the outbound mapping of application data. The implementations
are sorted according to the field layer of a BAdI implementation, for example, SAP standard, partner, or customer.
Switch Framework
The Utilities Business Function Set must be activated.
Technical Data
Entity Type
Service Interface
Category
SAP A2A
Direction
outbound
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Constraints
This service interface has been released as of ECC 6.0 EhP2 (IS-U 602). A new version of this service interface is available as of ECC 6.0 EhP5. We strongly
recommend using the new service interface Utilities Connection Status Change Request Out, instead.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
deprecated
This service operation has been released as of ECC 6.0 EhP2 (IS-U 602). A new
version of this service is available as of ECC 6.0 EhP5 ( (IS-U 605) . SAP strongly
recommends using the new service operation Request Smart Meter Utilities
Connection Status Change Request Creation, instead.
Technical Name
UtilitiesConnectionStatusChangeRequestRequest_Out
Namespace
http://sap.com/xi/IS-U
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
no
Features
The outbound service is an asynchronous service which is triggered from the SAP for Utilities backend system. In the signature of the service operation, the
following GDT (Global Data Type) is provided with the following corresponding values:
Message Header - Used data type BusinessDocumentMessageHeader
ID - Unique identifier for a Utilities connection status change request data type: UtilitiesConnectionStatusChangeRequestID
Device Activity ID - Unique identifier for an item of a Utilities connection status change request data type:
UtilitiesConnectionStatusChangeRquestActivityID
Device Activity Category Code - Coded representation of the category of a Utilities connection status change. Data type:
UtilitiesConnectionStatusChangeRequestActivityCategoryCode
Error Handling
Since this is an outbound asynchronous service, Forward Error Handling is not used.
Message Types
UtilitiesConnectionStatusChangeRequestRequest
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Prerequisites
To trigger the outbound request message, a disconnection or reconnection order should be created in the SAP for Utilities backend system.
Constraints
Typically, disconnection is triggered by the dunning of open items, which is part of the Contract Accounting (CA) module. An event is raised in the SAP for
Utilities backend system to trigger the disconnection of a device. Alternatively, a disconnection can be triggered manually, for example, upon receiving an end
customer request or for technical reasons such as maintenance. A reconnection is triggered by posting incoming payments that are going to be used to settle
dunning items. Alternatively, reconnection can be triggered manually upon request from a utilities end customer (for example, the reconnection of a vacation
home).
The disconnection outbound service performs a request to create a new disconnection/reconnection of a specific meter. The operation is sent from the SAP
system to an external system (for example, an Advanced Metering System (AMS)).
In the SAP for Utilities system, the transaction EC85 Create Disconnection Document can be used to update the status of a Utilities device. The operation
then sends the current status of the device to an external system (AMS), which can remotely control smart meters when requests are received from Utilities
Connection Processing.
The service is consumed in asynchronous interaction patterns and in conjunction with the SAP exchange Infrastructure (XI) acting as a service consumption
intermediary. In this case, the service consumer (AMS) does not interact directly with the SAP for Utilities backend system. XI itself interacts with the
backend system through XI service proxies. The interaction in the other direction works in a similar way. So XI mediates the entire message traffic between
SAP for Utilities and the AMS.
Processing
To use this service operation, the Utilities (IS-U) application component should be implemented.
Enhancements
The Business Add-In (BAdI) BADI_ISU_DISCON_REQU_OUT is available for this operation. The BAdI definition is found in the enhancement spot
SPOT_ISU_CONNECTION_IN. You can use this BAdI to create a customer-specific logic for the outbound mapping of application data. The implementations
are sorted according to the field layer of a BAdI implementation, for example, SAP standard, partner, or customer.
Switch Framework
The Utilities business function set must be activated.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
deprecated
This service operation has been released as of ECC 6.0 EhP2 (IS-U 602). A new
version of this service is available as of ECC 6.0 EhP5 (IS-U 605). SAP strongly
recommends using the new service operation Request Smart Meter Utilities
Connection Status Change Request Cancellation, instead.
Technical Name
UtilitiesConnectionStatusChangeRequestCancelRequest_Out
Namespace
http://sap.com/xi/IS-U
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Idempotency
not applicable
Change/Update Behavior
not applicable
no
Related operations
Request Utilities Connection Status Change Request
Features
This outbound asynchronous service operation is triggered from the SAP for Utilities backend system. In the signature of the service operation, the following
GDTs (Global Data Types) are provided with corresponding values:
Message Header
ID
Device Activity ID
Message Types
UtilitiesConnectionStatusChangeRequestCancelRequest
Prerequisites
To trigger the outbound cancel request message, a disconnection order should be created in the SAP for Utilities backend system.
Constraints
This outbound service performs a request to create a new disconnection/reconnection for a specific utilities device (for example, a smart meter). The operation
is sent from the SAP system to an external system (for example, an AMI system).
Example
In the SAP for Utilities system, a disconnection order has been incorrectly created and should either be removed or cancelled. Following this process, two
requests are sent to the AMI system: a disconnection request and a cancellation request. The status of the device is checked in the AMI system. If the
device is still active, the AMI system cancels the previously sent disconnection request message. If, at that point in time, the device should already be
disconnected, the cancellation request is ignored. In both cases, the AMI system sends a message back to the SAP for Utilities system confirming the
cancellation of that disconnection request.
The service is consumed in asynchronous interaction patterns, in conjunction with the SAP exchange infrastructure (XI) acting as a service consumption
intermediary. In this case, the service consumer (AMI system) does not interact directly with the SAP for Utilities backend system. The XI itself interacts with
the backend system through XI service proxies. The interaction works similarly in the other direction so the XI system mediates the entire message traffic
between the SAP for Utilities and the AMI system.
Processing
To use this service operation, the Utilities (IS-U) application component should be implemented.
Enhancements
The Business Add-In (BAdI) BADI_ISU_DISCON_CNL_REQU_OUT is available for this operation. The BAdI definition is found in the enhancement spot
SPOT_ISU_CONNECTION_IN. You can use this BAdI to create a customer-specific logic for the outbound mapping of application data. The implementations
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
are sorted according to the field layer of a BAdI implementation, for example, SAP standard, partner, or customer.
Switch Framework
The Utilities business function set must be activated.
Technical Data
Entity Type
Process Component
Technical Name
UtilitiesContractProcessing
Namespace
http://sap.com/xi/ESM/ERP
Technical Data
Entity Type
Process Component
Technical Name
UtilitiesDeviceManagement
Namespace
http://sap.com/xi/ESM/ERP
Technical Data
Entity Type
Business Object
Technical Name
UtilitiesDevice
Object Category
Technical Data
Entity Type
Service Interface
Category
A2X
Direction
Inbound
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
UtilitiesDeviceERPBasicDataByIDQueryResponse_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_DeviceIDQR
Category
A2X
Direction
inbound
Mode
synchronous
Idempotency
no
Change/Update Behavior
not applicable
true
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Features
When this operation is executed, the basic data of a device that is related to the provided device ID is retrieved. The device ID is mandatory; if you do not
provide one, you will receive an error message and no results will be returned.
Error Handling
Typical errors are:
Missing ID : The user has not entered an ID. This is needed to read basic device data.
Device not found : No device was found for the ID entered.
Message Types
UtilitiesDeviceERPBasicDataByIDQueryMessage_sync
UtilitiesDeviceERPBasicDataByIDResponseMessage_sync
Configuration
This operation is suitable for the Utilities Industry Solutions sector. The customer must run the IS-U application component to use it.
Note that users require authorization to display the device (authorization object E_DEVICE).
Enhancements
The ISU_SE_DEVICEIDQR Business Add-In (BAdI) is available for this operation. This BAdI definition is found in enhancement spot
ISU_SPOT_SE_DEVICE.
This BAdI allows you to create customer-specific logic for inbound and outbound mapping of application data.
Technical Data
Entity Type
Service Interface
Category
SAP A2A
Direction
inbound
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
UtilitiesDeviceERPSmartMeterRegisteredNotification_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_DEVICESMREGEDNO
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
The following values must be provided:
UtilitiesDeviceID
UtilitiesAdvancedMeteringSystemID
Error Handling
Typical errors are:
General mapping error: UtilitiesDeviceID is initial; Message UUID not provided.
In order to activate FEH, implement and activate BAdI ISU_SE_FEH_EXCEPTION: Set parameter XY_IS_FEH_PROCESSING of method
IF_EX_ISU_SE_FEH_EXCEPTION~CHECK_FEH_USAGE to 'X' for the related service specified by the parameters X_SERV_BO_NAME = 'DEVICE' and
X_SERV_OPERATION = 'DEVICESMREGEDNO' or set the filter values accordingly.
Information for the Post Processing Office (PPO): This service belongs to the component CA-SOA-ESM-ERP-MD and process UDEV004.
Message Types
Utilities Device ERP Smart Meter Registered Notification
Configuration
This operation is suitable for the Utilities Industry Solutions sector. The customer must run the IS-U application component to use it.
Enhancements
The ISU_SE_DEVICESMREGEDNOI_ASYNC Business Add-In (BAdI) is available for this operation. This BAdI definition is found in enhancement spot
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
ISU_SPOT_SE_DEVICE. This BAdI allows you to create customer-specific logic for inbound and outbound mapping of application data.
The BAdI can be implemented several times. The implementations are sorted according to the field layer of a BAdI implementation, for example, SAP
standard, partner, or customer.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
UtilitiesDeviceERPSmartMeterRegisteredBulkNotification_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_SMEVENTCRTBLKRQ
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
The following values must be provided on item level:
UtilitiesDeviceID
UtilitiesAdvancedMeteringSystemID
Processing
For information, see Bulk, Bundle, Collection.
Error Handling
Forward Error Handling
The Change Based on Utilities Device Smart Meter Registered Notification as Bulk service operation supports Forward Error Handling (FEH). The following
error categories are used:
PRE.AUE : Authorization Error
CON.POC : Possible Conflict
PRE.TEE.LPE : Lock Promotion Error
In order to activate FEH, implement and activate BAdI ISU_SE_FEH_EXCEPTION: Set parameter XY_IS_FEH_PROCESSING of method
IF_EX_ISU_SE_FEH_EXCEPTION~CHECK_FEH_USAGE to 'X' for the related service specified by the parameters X_SERV_BO_NAME = 'DEVICE' and
X_SERV_OPERATION = 'DEVICESMRGDBLKNO' or set the filter values accordingly.
Information for the Post Processing Office (PPO): This service belongs to the component CA-SOA-ESM-ERP-MD and process UDEV008.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Enhancements
The ISU_SE_DEVICESMRGDBLKNOI_ASYNC Business Add-In (BAdI) is available for this operation. This BAdI definition is found in enhancement spot
ISU_SPOT_SE_DEVICE. This BAdI allows you to create a customer-specific logic for inbound and outbound mapping of application data.
The BAdI can be implemented several times. The implementations are sorted according to the field layer of a BAdI implementation, for example, SAP
standard, partner, or customer.
Technical Data
Entity Type
Service Interface
Category
SAP A2A
Direction
outbound
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
UtilitiesDeviceERPSmartMeterLocationNotification_Out
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
The Notify of Utilities Device Smart Meter Location outbound operation is triggered when the installation point assignments within the device have been
changed using the following processes:
Device installation
Device removal
Device replacement and reversal
Technical installation, removal or replacement
The notification message is sent to the advanced metering system (AMS).
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Error Handling
General processing and/or mapping errors: UtilitiesDeviceID is initial; Message UUID not provided.
Message Types
UtilitiesDeviceERPSmartMeterLocationNotification
Enhancements
The ISU_SE_DEVICESMLOCNOO_ASYN Business Add-In (BAdI) is available for this operation. This BAdI definition is found in enhancement spot
ISU_SPOT_SE_DEVICE.
You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data. The implementations are sorted
according to the field layer of a BAdI implementation, for example, SAP standard, partner, or customer.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
UtilitiesDeviceERPSmartMeterLocationBulkNotification_Out
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Features
The Notify of Utilities Device Smart Meter Location as Bulk outbound operation is triggered when the installation point assignments within multiple devices
are changed using the following processes:
Device installation
Device removal
Device replacement and reversal
Technical installation, removal or replacement
The notification message is sent out to the Advanced Metering System (AMS).
The following fields need to be provided to trigger this outbound operation:
MessageHeader: UUID
UtilitiesDeviceID: LocationListCompleteTransmissionIndicator
SmartMeter: UtilitiesAdvancedMeteringSystemID
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Error Handling
General processing and/or mapping errors: UtilitiesDeviceID is initial; Message UUID is not provided.
Message Types
UtilitiesDeviceERPSmartMeterLocationBulkNotification
Enhancements
The Business Add-In (BAdI) ISU_SE_DEVICESMLOCBLKNOO_ASYN is available for this operation. This BAdI definition is available in the enhancement
spot ISU_SPOT_SE_DEVICE.
You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data. The implementations are sorted
according to the field layer of a BAdI implementation, for example, SAP standard, partner, or customer.
More Information
Related Items
Utilities Device business object
Utilities Device ERP Smart Meter Location Notification message type
Meter Data Unification & Synchronization (MDUS) Processing (3rd party) process component
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
UtilitiesDeviceERPSmartMeterRelationshipNotification_Out
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
This outbound operation is triggered when device allocations at device level have been changed using the following processes: Maintain device allocation,
reversal technical installation/removal/replacement and technical removal. This notification message is sent to the advanced metering system (AMS).
The following fields need to be provided in order to trigger this outbound operation:
MessageHeader: UUID
UtilitiesDeviceID
RelationshipListCompleteTransmissionIndicator
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
SmartMeter: UtilitiesAdvancedMeteringSystemID
Error Handling
General processing and/or mapping errors: UtilitiesDeviceID is initial; Message UUID not provided.
Message Types
UtilitiesDeviceERPSmartMeterRelationshipNotification
Enhancements
The ISU_SE_DEVICESMRELSHPNOO_ASYN Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_DEVICE.
This BAdI allows you to create customer-specific logic for outbound mapping of application data. The implementations are sorted according to the field layer of
a BAdI implementation, for example, SAP standard, partner, or customer.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
UtilitiesDeviceERPSmartMeterTextBulkNotification_Out
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
This outbound operation is used to send text messages to the smart meter. The meter data unification and synchronization (MDUS) system is used to
communicate with the smart meter. The notification message is sent to the advanced metering system (AMS) as a mass process.
To send the text messages to the smart meter, the following information is needed:
UtilitiesDeviceID
SmartMeter: Utilities Advanced Metering System ID
Text:
ID
CreationDateTime
TextPlainContent: Text
For more information, see the UtilisDvceERPSmrtMtrTxtBulkNotifMsg message data type.
Processing
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Message Types
Utilities Device ERP Smart Meter Text Bulk Notification
Configuration
Users must have the proper authorization to send messages to devices in the SAP for Utilities back-end system (authorization object E_AMI_MSG).
Enhancements
The BAdI for Utilities Device Smart Meter Text Notification as Bulk (ISU_SE_DEVICESMTXTBLKNOO_ASYN) Business Add-In (BAdI) is available for this
operation. This BAdI definition is found in enhancement spot ISU_SPOT_SE_DEVICE.
This BAdI allows you to create customer-specific logic for outbound mapping of application data. The implementations are sorted according to the field layer of
a BAdI implementation, for example, SAP standard, partner, or customer.
Technical Data
Entity Type
Service Interface
Category
SAP A2A
Direction
inbound
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
UtilitiesDeviceERPSmartMeterOperationalStateByIDResponse_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_DEVSMOPLSTATEIDRP
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
yes
Related Operations
This service operation interacts with service operation Query Utilities Device Smart Meter Operational State by ID, which requests this status, and is normally
used by a back office agent. The status helps to identify if a repair or other activity is needed for a specific device.
Features
The inbound service operation Change based on Utilities Device Smart Meter Operational State by ID Response is used to send a response regarding the
operational state of the device from the Advanced Metering System (AMS).
The following values will be provided in this inbound operation:
UtilitiesDeviceID
The log, which describes the process status of the query.
Error Handling
Typical errors include:
General processing and mapping errors like missing log; MessageHeader: UUID or MessageHeader: ReferenceUUID are not provided; Utilities Device ID
is initial
Missing authorization to save operational state of device (E_AMI_OPST)
Message Types
Utilities Device ERP Smart Meter Operational State by ID Response
Enhancements
The ISU_SE_DEVSMOPLSTATEIDQRO_ASYN Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the Enhancement Spot:
ISU_SPOT_SE_DEVICE. This BAdI allows customer-specific logic for inbound mapping of application data. The implementations are sorted according to the
field layer of a BAdI implementation, for example, SAP standard, partner, or customer.
Technical Data
Entity Type
Service Interface
Category
A2X
Direction
inbound
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
UtilitiesDeviceERPSimpleByUtilitiesMeasurementTaskQueryResponse_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_DEVICE001QR
Category
A2X
Direction
inbound
Mode
synchronous
Idempotency
no
Change/Update Behavior
not applicable
true
Features
When this operation is executed, the Utilities Device that is related to the provided Utilities measurement task ID is retrieved. A Utilities measurement task ID
is mandatory. If you do not provide one, you will receive an error message and no results will be returned.
Error Handling
If you do not enter a Utilities measurement task ID, you will receive an error.
No Utilities device will be found if you enter an invalid Utilities measurement task ID.
Message Types
UtilitiesDeviceERPSimpleByUtilitiesMeasurementTaskQuery_sync
UtilitiesDeviceERPSimpleByUtilitiesMeasurementTaskResponse_sync
Configuration
This operation is suitable for the Utilities Industry Solutions sector. It is necessary that the customer runs the IS-U application component in order to use it.
Note that users require authorization to display the Utilities device (authorization object E_DEV_CHNG).
Enhancements
The ISU_SE_DEVICE001QR Business Add-In (BAdI) is available for this operation. This BAdI definition is found in enhancement spot
ISU_SPOT_SE_DEVICE.
This BAdI allows you to create customer-specific logic for inbound and outbound mapping of application data.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Technical Data
Entity Type
Service Interface
Category
SAP A2A
Direction
outbound
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
UtilitiesDeviceERPSmartMeterOperationalStateByIDQuery_Out
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
Category
SAP A2A
Direction
outbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Related Operations
The response to this query is handled in the Change Based on Utilities Device Smart Meter Operational State by ID Response service operation.
Features
The Query Utilities Device Smart Meter Operational State by ID outbound service operation sends a query for the operational state of the device based on
priority code and source system to the advanced metering system (AMS).
The query can be triggered from the display or change modes of the device.
The following values need to be provided for this outbound operation:
UtilitiesDeviceID
UtilitiesAdvancedMeteringSystemID
UtilitiesAdvancedMeteringDataOriginTypeCode (source system from which data is requested)
Optionally, you can extend the query by providing priority codes.
Error Handling
General processing and/or mapping error: UtilitiesInvoiceRequestID is initial.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
UtilitiesDeviceERPSmartMeterOperationalStateByIDQuery
Enhancements
The ISU_SE_DEVSMOPLSTATEIDQRO_ASYN Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot
ISU_SPOT_SE_DEVICE. This BAdI allows customer-specific logic for outbound mapping of application data. The implementations are sorted according to the
field layer of a BAdI implementation, for example, SAP standard, partner, or customer.
Technical Data
Entity Type
Service Interface
Category
SAP A2A
Direction
inbound
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
UtilitiesDeviceERPSmartMeterRegisterBulkCreateConfirmation_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
no
no
Features
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
In the bulk confirmation message, each object should provide the following values:
UtilitiesDeviceID
The log describing the status of the creation of a device in the AMI system
Error Handling
The UtilitiesDeviceERPSmartMeterRegisterBulkCreateConfirmation_In operation supports Forward Error Handling (FEH). The following error category is used:
PRE.AUE Authorization error
For more information about individual error categories, see the code list for the global data type LogItemCategoryCode.
Message Types
Utilities Device ERP Smart Meter Register Bulk Create Confirmation
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
More Information
The outbound counterpart for this inbound operation is the Request Utilities Device Smart Meter Register Creation as Bulk
(UtilitiesDeviceERPSmartMeterRegisterBulkCreateRequest_Out) operation.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
UtilitiesDeviceERPSmartMeterCancellationBulkConfirmation_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_DEVICESMCNCBLKCO
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Features
This inbound service is used to confirm the cancellation of devices from an advanced metering system (AMS) as a mass process.
The following values will be provided for each object (Utilities device) within this inbound operation:
MessageHeader: UUID
MessageHeader: ReferenceUUID
UtilitiesDeviceID
The log, which describes the cancellation status of the device.
The following values have to be provided for the bulk message:
MessageHeader: UUID
MessageHeader: ReferenceUUID
The log, which describes the status of the cancellation of all devices.
The advanced metering system sends a cancellation confirmation of devices.
Error Handling
Typical errors include:
General processing and mapping errors such as missing log
MessageHeader: UUID or MessageHeader: ReferenceUUID are not provided
UtilitiesDeviceID is initial, missing authorization to receive the inbound confirmation
Information for the Post Processing Office (PPO): This service belongs to the component CA-SOA-ESM-ERP-MD and process UDEV003.
Message Types
Utilities Device ERP Smart Meter Cancellation Bulk Confirmation
Enhancements
The ISU_SE_DEVICESMCNCBLKRCO_ASYN Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_DEVICE. This BAdI allows customer-specific logic for inbound mapping of application data. The implementations are sorted according to the
field layer of a BAdI implementation, for example, SAP standard, partner, or customer.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
UtilitiesDeviceERPSmartMeterChangeConfirmation_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_DEVICESMCHGCO
Category
SAP A2A
Direction
inbound
Mode
asynchronous
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
The following values have to be provided:
UtilitiesDeviceID
The log describing the status of the creation of a device in the AMI system
Error Handling
Typical errors are:
General mapping error: UtilitiesDeviceID is initial; Message UUID or Reference_UUID not provided.
Message Types
UtilitiesDeviceERPSmartMeterChangeConfirmation
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
Configuration
This operation is suitable for the Utilities Industry Solutions sector. It is necessary that the customer runs the IS-U application component in order to use it.
Enhancements
The ISU_SE_DEVICESMCHGRCO_ASYNC Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_DEVICE. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data.
The BAdI can be implemented several times. The implementations are sorted according to the field layer of a BAdI implementation, for example, SAP
standard, partner, or customer.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
UtilitiesDeviceERPSmartMeterBulkChangeConfirmation_In
Namespace
http://sap.com/xi/IS-U/Global2
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
no
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
no
Features
In the bulk confirmation message, each object should provide the following values:
UtilitiesDeviceID
The log describing the status of the creation of a device in the AMI system
Error Handling
The UtilitiesDeviceERPSmartMeterBulkChangeConfirmation_In operation supports Forward Error Handling (FEH).
The following error category is used:
PRE.AUE Authorization error
For more information about individual error categories, see the code list for the global data type LogItemCategoryCode.
Message Types
Utilities Device ERP Smart Meter Bulk Change Confirmation
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
More Information
The outbound counterpart for this inbound operation is the Request Utilities Device Smart Meter Change as Bulk
(UtilitiesDeviceERPSmartMeterBulkChangeRequest_Out) operation.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
UtilitiesDeviceERPSmartMeterCreateConfirmation_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
ISU_DEVICESMCRTCO
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
The following values have to be provided:
UtilitiesDeviceID
The log describing the status of the creation of a device in the AMI system
Error Handling
Typical errors are:
General mapping error: UtilitiesDeviceID is initial; Message UUID or Reference_UUID not provided.
Message Types
Utilities Device ERP Smart Meter Create Confirmation
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
Configuration
This operation is suitable for the Utilities Industry Solutions sector. It is necessary that the customer runs the IS-U application component in order to use it.
Enhancements
The ISU_SE_DEVICESMCHGRCO_ASYNC Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_DEVICE. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data. The BAdI can
be implemented several times. The implementations are sorted according to the field layer of a BAdI implementation, for example, SAP standard, partner, or
customer.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
UtilitiesDeviceERPSmartMeterBulkCreateConfirmation_In
Namespace
http://sap.com/xi/IS-U/Global2
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Application Component
IS-U
ISU_DEVICESMCRTBLKCO
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
The following values have to be provided :
UtilitiesDeviceID
The log describing the status of the creation of a device in the AMI system
Error Handling
Typical errors are:
General mapping error: UtilitiesDeviceID is initial; Message UUID or Reference_UUID not provided.
Message Types
Utilities Device ERP Smart Meter Bulk Create Confirmation
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
Configuration
This operation is suitable for the Utilities Industry Solutions sector. It is necessary that the customer runs the IS-U application component in order to use it.
Enhancements
The ISU_SE_DEVICESMCRTBLKRCO_ASYNC Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_DEVICE. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data. The BAdI can
be implemented several times. The implementations are sorted according to the field layer of a BAdI implementation, for example, SAP standard, partner, or
customer.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
UtilitiesDeviceERPSmartMeterRegisterChangeConfirmation_In
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
ISU_DEVICESMREGCHGCO
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
The following values have to be provided :
UtilitiesDeviceID
The log describing the status of the creation of a device in the AMI system
Error Handling
Typical errors are: General mapping error: UtilitiesDeviceID is initial; Message UUID or Reference_UUID not provided.
Message Types
Utilities Device ERP Smart Meter Register Change Confirmation
Configuration
This operation is suitable for the Utilities Industry Solutions sector. The customer must run the IS-U application component to use it.
Enhancements
The ISU_SE_DEVICESMREGCHGRCO_ASYNC Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_DEVICE. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data. The BAdI can
be implemented several times. The implementations are sorted according to the field layer of a BAdI implementation, for example, SAP standard, partner, or
customer.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
UtilitiesDeviceERPSmartMeterRegisterBulkChangeConfirmation_In
Namespace
http://sap.com/xi/IS-U/Global2
Category
SAP A2A
Direction
inbound
Mode
asynchronous
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Idempotency
no
no
Features
In the bulk confirmation message, each object should provide the following values:
UtilitiesDeviceID
The log describing the status of the creation of a device in the AMI system
Error Handling
The UtilitiesDeviceERPSmartMeterRegisterBulkChangeConfirmation_In operation supports Forward Error Handling (FEH).
The following error category is used: PRE.AUE Authorization error
For more information about individual error categories, see the code list for the global data type LogItemCategoryCode.
Message Types
Utilities Device ERP Smart Meter Register Bulk Change Confirmation
Prerequisites
To use this service operation, the Utilities (IS-U) application component should be implemented.
More Information
The outbound counterpart for this inbound operation is the Request Utilities Device Smart Meter Register Change as Bulk
( UtilitiesDeviceERPSmartMeterRegisterBulkChangeRequest_Out ) operation.
Technical Data
Entity Type
Service Operation
IS-UT 606
Release State
released
Technical Name
UtilitiesDeviceERPSmartMeterRegisterCreateConfirmation_In
Namespace
http://sap.com/xi/IS-U/Global2
Application Component
IS-U
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
ISU_DEVICESMREGCRTCO
Category
SAP A2A
Direction
inbound
Mode
asynchronous
Idempotency
not applicable
Change/Update Behavior
not applicable
yes
Features
The following values have to be provided:
UtilitiesDeviceID
UtilitiesAdvancedMeteringSystemID
The log describing the status of the creation of a device in the AMI system
Error Handling
The following general mapping errors are typical: UtilitiesDeviceID is initial; Message UUID or Reference_UUID not provided.
Message Types
Utilities Device ERP Smart Meter Register Create Confirmation
Configuration
This operation is suitable for the Utilities Industry Solutions sector. The customer must run the IS-U application component to use it.
Enhancements
The ISU_SE_DEVICESMREGCRTRCO_ASYNC Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot:
ISU_SPOT_SE_DEVICE. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data. The BAdI can
be implemented several times. The implementations are sorted according to the field layer of a BAdI implementation, for example, SAP standard, partner, or
customer.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.