Contact4Center UtilitiesGuide PDF
Contact4Center UtilitiesGuide PDF
Contact4Center UtilitiesGuide PDF
2020-11-18
The SAP Cloud for Customer Utilities Contact Center solution helps you to optimize call center operations
using modern customer engagement tools for sales and service processes.
The contact center capabilities are fully integrated with ERP IS-Utilities (IS-U) and SAP ERP backend, and
support seamless transition between the different support channels. Using this setup, all the utility services
performed in this cloud solution are correspondingly updated in the ERP system.
The following table details the software compatibility matrix for SAP Cloud for Customer Utilities Contact
Center.
2011 SAP Cloud for Minimum ERP 6.0, PI 7.11 ● EHP2 for Ex
Customer Add-On CO EHP 0 change Rate Cur
DERINT 600 Note rencies
(COD_ERP_INT 6.00), ● Adobe Document
Ensure that you
Support Package 59 Server for preview
have downloaded
of an ERP cus
the latest service tomer fact sheet
packs listed here: in a PDF format
● XI CONTENT ● EHP4 to view print
SAP_BYD preview (PDF) of
2.40 (SP36) sales documents
(Interface in opportunity,
quote and Ac
Definitions for
count
SAP Cloud for
● EPH2 to view
Customer for
sales order details
Utilities Con in the opportunity,
tact Center) quote and ac
● XI CONTENT count
COD_ERP_IN ● EHP3 to view
T 6.00 (SP35) sales quote de
(ERP Inter tails in the oppor
face Defini tunity and Ac
tions) count
● XI CONTENT
COD_ERP_IN
T_IC 6.00
(SP35) (Map
ping, Tem
plates and
Scenarios)
The topics below provide a detailed overview of the configuration required to setup the utilities contact center.
Administrators can configure the utilities contact center using scoping, scoping questions, and finetuning
activities.
Scoping [page 7]
To set up your SAP Cloud for Customer system to support Utilities Contact Center solution, scope your
implementation project accordingly.
To set up your SAP Cloud for Customer system to support Utilities Contact Center solution, scope your
implementation project accordingly.
Recommendation
SCOPING: When you scope an industry solution, the business configuration set attached to the industry
fetches only the mandatory workcenters and workcenter views. Note that this scoping does not include the
mandatory scoping for Cloud for Sales or Cloud for Service. Therefore, it is recommended that you scope
the other essential workcenters you may need for your industry solution, based on your business
requirement.
This section lists the prerequisites to configure the Utilities Contact Center.
The connection to SAP ERP system must be established before the on-boarding to SAP Cloud for Customer is
implemented.
For more information about integration with SAP ERP, see the standard integration guide.
The required configuration must have been set up in IS-Utilities in the ERP system.
To begin scoping and to scope the solution, go to Business Configuration Edit Product Scope Industry
Solution Utilities , and then select Utilities Call Center and Service.
Many of the scoping elements are automatically selected and cannot be deselected. The Business
Configuration sets (BC Sets) defined for the utilities call center will be activated once you scope the Utilities
industry solution. Review the questions for the scoping elements and confirm your scoping.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Quotation, select the Do you want to
enable utilities lean quotation and replicate point of delivery from your external application to your cloud
solution? question.
● Ensure that the sales quotes are enabled under Business Configuration Edit Project Scope Sales
New Business Sales Quotes .
● Scope the following under Communication and Information Exchange Integration into Sales, Service
and Marketing Processes :
○ Do you want to create follow-up documents for sales quotes from your cloud solution to an external
application?
○ Do you want to replicate sales quotes from an external application or solution to your cloud solution?
● Enable the You can use a template to send sales quotes to your customers scoping question under
Business Configuration Edit Project Scope Questions Sales New Business Communication for
New Business .
● Configure PoD replication (see documentation under Technical Objects Replication).
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Quotation, select the Do you want to
enable Internal Pricing for Utilities Lean Quotation? question.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Technical Master Data Replication, select the
Do you want to replicate point of delivery data from your external application to your cloud solution? question.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Technical Master Data Replication, select the
Do you want to use Premise External ID as the Internal ID in C4C? question.
As an administrator, you can configure the use of master data template to customize rate change in the
solution.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Master Data Template, select the Do you
want to use Master Data Template for Rate Change? question.
As an administrator, you can configure the use of master data template for guided move-in and guided transfer.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Master Data Template, select the Do you
want to use Master Data Template for Guided Move-In and Guided Transfer? question.
You can configure separate master data templates for move processes and installations.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and select Utilities Call
Center and Service.
In the Questions for Utilities Call Center and Service section, under Master Data Template, select the Do you
want to use a different master data template for each installation within guided move-in/guided transfer?
question.
As an administrator, you can configure the creation of BPEM clarification case from your cloud solution that is
completely integrated with your SAP ERP solution.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Exception Management, select the
Do you want to enable creation of BPEM Clarification Case? question.
As an administrator, you can implement the SAP S/4HANA edition for utilities solution in SAP Cloud for
Customer.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under S/4HANA Integration, select the Do you
want to integrate your cloud solution with SAP S/4HANA? question.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Security Deposit, select the Do you
want to enable Security Deposit at contract level? question.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Alerts, select the Do you want to
enable Alerts in Move Processes? question.
You can also enable the display of alerts in the expanded mode or collapsed mode through a scoping
question.To configure the scoping question go to Business Configuration Edit Product Scope Industry
Solution Utilities , and select Utilities Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Alerts, select the Do you want
expanded Alerts in Move Processes?
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Service Order/Notifications, select
the Do you want to use the order code for generating service orders? question.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Enhancements, select the Do you
want to enable basic and advanced search for the Contract Account value help? question.
As an administrator, you can configure to use the meter reading history from the legacy move-in date, when the
legacy system is migrated to an EPR system.
Go to Business Configuration Implementation Projects Your Project Edit Project Scope Questions
Industry Solutions Utilities Utilities Call Center and Service . From Questions for Utilities Call Center and
Service, select Do you want to use the meter reading history from the legacy move-in date?.
Go to Business Configuration Implementation Projects Your Project Edit Project Scope Questions
Industry Solutions Utilities Utilities Call Center and Service . From Questions for Utilities Call Center and
Service, select Do you want to enable Manual Posting in ‘Utilities Financials’?.
Code values configured in ERP can be replicated using automatic code list mapping during initial load.
After the initial load replication,you can add or modify the code values in the cloud solution. Using the fine
tuning activity ( Business Configuration Implementation Projects Your Project Open Activity List Fine-
Tune Utilities ), you can maintain code values for the following:
Note
If you update the code values in the ERP system, make corresponding updates to the code values in the
cloud solution and vice-versa.
View list of all phone numbers and email addresses related to the customer.
To enable Valid from and Valid to columns in the tables under Utilities Communications Data page, go to
Business Configuration Implementation Projects Your Project Edit Project Scope Questions Industry
Solution Utilities , and then select Utilities Call Center and Service. From Questions for Utilities Call Center
and Service, select Is Time Dependency for BP Independent Address Communication data enabled in ISU?
As an administrator, enable the time dependency for Business Partner to enable Valid from and Valid to
columns in the tables under Utilities Communications Data page.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Enhancements, select the Is Time
Dependency for BP Independent Address Communication data enabled in ISU? question.
As an administrator, you can now turn on an alternative title for contract account object based on scoping
question for easy and quick identification.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Enhancements, select the Do you
want to enable the contract account object labels to display external ID and name? question.
As an administrator, you can now turn on an alternative title for premise object based on scoping question for
easy and quick identification.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Enhancements, select the Do you
want to enable the premise object labels to display house number, street name, and house supplement?
question.
As an administrator, you can enable service location section in the ticket based on the premise selected. This
enables visibility to the field level information for the selected premise.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Enhancements, select the Do you
want to copy premise/PoD address fields to service location fields while assigning premise/PoD address to
service ticket. question.
As an administrator, you can configure a new Contract Account Work Center with value help capabilities for
advanced search fields.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Enhancements, select the Do you
want to enable the new contract account work center with value help capabilities for advanced search fields?
question.
As an administrator, you can enable the Additional offering step to add external products in guided move-in.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Move Process for S/4, select the Do you want
to enable the automatic creation of sales quote during create Move-In? and Do you want to display the
“Additional Offering” step for selecting Sales Product during create Move-In?questions.
As an administrator, you can configure to use premise basic search in live activity.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Business Option, select the Do you want to
enable basic search for the Utilities-Premise Category in Enterprise Search and Live activity? question.
You can execute reports to transfer data from IS-Utilities system to the Utilities Contact Center cloud solution.
For more information, see Technical Objects Replication [page 297] and Contract Account Replictaion [page
300].
COD_UTILITIES_WCF Utilities
Premise COD_PREMISE_WCVIEW
COD_SALES_WCF Sales
CODACCOUNTWC Customers
Note
The utilities specific screen -
Utilities Financials, Utilities 360,
and Utilities Service Orders are
available with this scoping.
CODACCOUNTWCV
Accounts
Contacts COD_CONTACT_WCV
After you add the tab, you can enable it as a side pane in screens. From the Adapt menu, select Company
Settings, and then select the Enable Side Pane in Fiori client checkbox.
In ERP or S/4HANA system, you can configure the alerts framework using the IMG configuration. You must
maintain the configuration for the BRF application name corresponding to the SAP Cloud for Customer launch
object. Similarly, to extract the required importing parameters to the BRF application, you must implement the
process context method in the ERP or S/4HANA system.
You can enable the display of alerts in the expanded mode through a scoping question. To configure the
scoping question go to Business Configuration Edit Product Scope Industry Solution Utilities , and
select Utilities Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Alerts, select the Do you want
expanded Alerts in Move Processes? question.
As an administrator, you can configure scripts to display the terms and conditions for rate or service orders in
the move-in and move-out processes.
Section Description
3. Click Save.
4. Go to Rules for value determination for Move In/Out Script, and set the rules for the script.
After the script is configured, the agent can launch the script during the move processes to agree to the terms
and conditions.
As an administrator, you can configure to manage views for Recent Hisory and Hierarchy sections under
Utilities 360screen of a customer.
4. Click Save.
To configure the default view in the Hierarchy section , follow these steps:
4. Click Save.
As an administrator, you can configure a safety message to reconnect the AMI smart meter.
On the Safety Message for Reconnect, you can manage the message to be mandatory or optional.
If the message is mandatory, when the user selects a device to reconnect, the message appears in the
Reconnect popup.
Maintain the call center agents who are the key business users in utilities contact center solution. Once you
have created employees, you must edit the business user attributes and access rights for the call center
agents.
The access rights for this user are described in the chapter on scoping.
To integrate the front office processes with your SAP ERP system, you must create and configure a new
mashup.
1. Go to the Administrator work center and click Industry Settings Utilities Settings for Front Office
Process .
2. Click on New to configure. Maintain the following details:
○ Description
○ Active Flag
3. In the Assign Mashup ID to Launch Object table, add a new row and select the Launch Object.
4. Under Mashup ID, select the Mashup ID.
Note
You also need to assign the launch object in the Implementation Guide Customizing for SAP Hybirs Cloud
for Customer Utilities. For more information, see the reference in the related links section.
Related Information
To integrate the Smart Energy Water (SEW) with SAP ERP system, Communication Preferences, Consumption
Graph, Outage Map, and Compare should be configured.
Follow the steps to configure Communication Preferences, Consumption Graph, Outage map, and Compare tabs
from Cloud for Customer.
Note
Be sure to enter a mashup web service ID in the Configuration settings screen, or you won't be able to
view or edit the Contract Account communication preferences, and Consumption Graph.
As an Administrator, you can configure the severity for the messages received during move process to display
whether it’s an error, warning, or instruction. The messages can also be suppressed if you don’t want them to
display.
In the PI system, execute the SXMB_IFR transaction code. This opens the PI system homepage from where you
can access the PI clients for Enterprise Service Repository, Integration Directory, and System Landscape
Directory.
Note
Ensure that you have always download the latest integration package from the SAP Service Marketplace.
http://help.sap.com/disclaimer?site=https://support.sap.com/software/patches.html
1.1.2.1.1 Prerequisites
Note
You must create the required logical ports in the ERP system. For more information, see Logical Ports for
Outbound Services for PI Integration under Configure Integration with ERP.
The PI 7.11 system (ABAP+JAVA) should be ready and trust relationship should established with theSAP Cloud
for Customer and CPM as per Integration Guide. See the following sections in the standard integration guide
for ERP using PI.
The screenshots shown in this appendix are only examples taken from PI value mapping. They are not
complete from a PI configuration point of view. Please note that some of the code lists named below can be
enhanced or modified in SAP Cloud for Customer during finetuning.
<SID>CLNT<client number>, where SID is the system ID of Logical System name of the corresponding business system
the connecting ERP/Cloud system.
The values of these mapping are used in the PI message mappings for the services
You need to download the standard integration package for SAP Cloud for Customer for Utilities Contact
Center from the SAP Service Marketplace to get started with the configuration required for integration with
SAP ERP system.
1. Go to https://support.sap.com/software/patches.html .
Note
Ensure that you download the latest versions of all available support packages.
XI CONTENT SAP BYD XI CONTENT SAP_BYD 2.40 Interface Definitions for SAP Cloud for
Customer for Utilities Contact Center
You need to register the on-premise system in the System Landscape Directory. Systems are typically
registered in SLD when they are initially configured.
You need to import the standard integration content delivered for SAP Cloud for Customer for Utilities Contact
Center to your PI system.
You have already downloaded the ESR content to your local machine. Now you need to import this content to
the PI system in your landscape. Follow these steps:
1. Login to the PI 7.11 system and enter the transaction code SXMB_IFR to start the Integration Builder.
2. Under Enterprise Services Repository, click on Enterprise Services Builder.
3. To import the ESR content from local machine, go to Tools Import Design Objects Client and
provide the path to the local machine. Note that the file with ESR content is saved with a '.TPZ' extension.
Result
Verify that the required web services are displayed under the relevant software components. If the import is
successful, you will see the list of outbound web services from SAP Cloud for Customer under SAP BYD 2.40
HTTP://SAP/COM/XI/AVS/GLOBAL . Similarly the ERP web services are listed under COD_ERP_INT and
the mappings and templates for ERP are listed under COD_ERP_INT.
Create a configuration scenario for the Utilities solution and perform the required configuration for all required
web services.
Perform the following steps to create a configuration scenario for your SAP Cloud for Customer for Utilities
Contact Center solution:
1. Go to Integration Directory Integration Builder and switch to the Configuration Scenario view.
2. In the menu bar, go to Object New and in the Object Create dialog box that appears, select
Administration Configuration Scenario ..
3. Enter a name for the configuration scenario with the prefix COD_ERP_UTILITIES and select Type of ES
Repository Model as Process Integration Scenario.
4. click on Create and save the configuration scenario.
You will maintain the ID configurations for each of the web services in this configuration scenario. As
part of the ID configuration, you will perform the following steps for each web service:
1. Assign sender business system (that you have defined in the software landscape directory - SLD
configuration.)
2. Assign receiver business system
3. Create the following:
1. Sender communication channel (SOAP Sender) business system
2. Receiver communication channel (SOAP Receiver) business system
3. Receiver determination
4. Interface determination
5. Sender agreement
6. Receiver agreement
4. Activate change lists
Note
For detailed information on how to maintain ID Configuration for web services, see the topic
Example: ID Configuration for Web Service - BP Overview.
The sample ID configuration for BP Overview web service is provided here. Note that the screenshots are
provided only for reference.
To the Utilities configuration scenario that you created in the previous step, configure the following for the BP
Overview web service:
2. In the Assign Business System dialog box that appears, click on Select Business Systems (on the left
hand side of the screen). You need to select the business systems that you have configured in the SLD
3. Click twice on Continue to assign both the sender and receiver business systems.
4. Click on Finish to save the configuration.
2. Create communication channel (SOAP sender) for sender business system. To do this,
1. Right click on communication channel and select New.
3. Click on Create.
8. Activate change lists. To activate, right click on the top node of the change list and click on Activate.
Synchronous and asynchronous web services for the utilities solution must be configured.
For a complete list of the web services, see the worksheet for Utilities PI Services in the attachments section
under 2675745 .
Communication arrangements help you to configure the electronic data exchange between the cloud Utilities
Contact Center solution and the IS-Utilities in ERP system.
Prerequisites
Procedure
Note
Contact your system administrator for details of System Instance ID, Code List Mapping,
Authentication Method (user and password), Port, Cloud for Customer Business System ID, Cloud for
Customer Business System Client, and Communication System Client.
ERP Utility Management Integration ISU Configuration, ERP Contract Account Replication,
Query, and Maintain ERP Customer Info
Creation of Sales Quote Follow Up Document in SAP Busi Create Sales Quote Follow Up Document in SAP Business
ness Suite Suite
Creation of Sales Quote Follow Up Document in SAP Busi Notify Sales Quote of Sales Order Creation in SAP Business
ness Suite Suite
When a service gets triggered form SAP Cloud for Customer, a corresponding ERP service gets executed in
ERP through SAP Cloud Platform. Therefore, you need to create a binding in SOAMANAGER that generates a
calculated URL. This must be configured in the cloud platform receiver connector of cloud platform.
2. In the field Object Name search for the inbound S/4HANA service name.
8. Click Finish and the screen below displays the service and binding.
9. On the second line – click on the icon marked with the shown arrow:
10. The dialog as displayed in the screenshot appears. Here, you can see the URL for the WSDL. Copy this URL
as you need the upload this URL when configuring the SAP Cloud Platform Receiver communication
channel or Receiver Connector.
11. In the Display Communication Channel dialog, upload the WSDL URL as the Target URL under Connection
Properties.
Note
You must have defined the required integration setup to connect with ERP and PI system.
1. Setup the PI value configuration to execute the utilities contact center specific web services. For the list of
web services, see the worksheet for Utilities PI Services in the attachments section under 2675745 . .
Note
It is recommended to use Master Data Governance (MDG) framework for replicating business partners.
4. Run the data replication reports to transfer data from ERP to the cloud system.
Note
The contracts are replicated from ERP system using an online call; there is no specific report to be
executed for replicating contracts to the cloud solution.
Logical Ports for Outbound Services for Asynchronous Interface using PI Integration [page 77]
Logical Ports for Outbound Services for Asynchronous Interface using SAP CPI [page 81]
Related Information
The utilities standard solution provides reports for business partner initial load and delta load replication.
Note
The replication is valid only for business partner addresses maintained in the SAP ERP system and that are
valid as on the current date.
You need to maintain the required configurations in the SAP Cloud for Customer, SAP ERP, and the SAP PI
systems to enable the framework for the business partner replication. The following topics Maintain
Configuration in ERP System, Maintain Configuration in PI System and Maintain Configuration in the SAP
Cloud for Customer system explain the configuration steps in detail.
Note
(Deprecated) BP Replication using MDG: If you are replicating business partners using MDG, then in the
PI mapping for contract account replication, maintain the schema code 888 for MDG.
(Deprecated) BP Replication using CVI: If you are replicating business partners using Customer Vendor
Integration (CVI), then in the PI mapping for contract account replication, maintain the schema code 918
for CVI.
When the Business Partner has multiple External IDs, all Utilities Services (Synchronous and Asynchronous)
consider the default ID mapping for Business Partners maintained in Administrator ID Mapping for
Integration Edit Default Configuration .
The standard system currently supports only the Contract Partner business partner role. Note that multiple
business partner roles are not supported in the current solution.
The following reports are provided in the standard system for business partner replication:.
● COD_UTIL_BP_REP_LOAD
Initial load report for business partner replication
● COD_UTIL_REL_REP_LOAD
Initial load report for replication of business partner relationships
Note
Run the initial load report in the SAP ERP system to transfer the business partner data to your cloud
solution. Note that the two initial load reports must be run in sequence to replicate the business
partners and their relationship respectively.
● COD_UTIL_BP_LOAD
Note
The delta load report is run periodically in the system and you do not need to trigger delta replication.
Note
The replication is valid only for business partner addresses maintained in the SAP ERP system and that are
valid as on the current date.
1. In the dialog screen for Business partners Replication, select and specify value in one of the fields –
Business Partner ID.
2. Specify the Logical Port ID.
3. Run both the initial load and the relationships replication reports in sequence.
You can choose to different number ranges for business partner IDs in your SAP Cloud for Customer system or
have identical number ranges for business partner IDs in both the systems.
Business partner IDs of ERP and Cloud for Customer are not identical. There is always an internal assignment
table that maps the ERP business partner ID to the corresponding ID in SAP Cloud for Customer system to
ensure a consistent data exchange.
Example
Classication
Replication Direction Account Group From Number To Number Number Range Type
In the above example, the first customer created in ERP gets ID 1 in the ERP and ID 1000 in the Cloud for
Customer system. If the next customer is created in the Cloud for Customer system, ID will be 1001 in the
Cloud for Customer system and ID 2 in the ERP.
There are two approaches to achieve identical number ranges in both your cloud solution and the ERP system.
Leading System Approach
Account group or classifications are only maintained in the ERP or in the Cloud for Customer system
exclusively.
For example: Customers (account group 0001 in ERP) are only maintained in the Cloud for Customer,
Competitors (account group Z001 in ERP) are only maintained in the ERP system. The account group in ERP
and BPs in Cloud for Customer must have the same number range. For the receiving system, external number
assignment is required. You should make sure that business partner creation in the receiving system is
prohibited.
Example
Classication
Replication Direction Account Group From Number To Number Number Range Type
If the leading system approach is not feasible, you can ensure identical number ranges by using different
account groups. For example: If the requirement is to maintain customers in the ERP system and in the Cloud
for Customer system in parallel. Define one account group (e.g. 0001) for customers that are created in the
ERP system and should be replicated in the Cloud for Customer system. Define an additional account group
(e.g. Z001) for customers that are created in the Cloud for Customer system and should be replicated to the
ERP system. Use different number ranges for these account groups and define external number assignment in
the receiving system.
Classication
Replication Direction Account Group From Number To Number Number Range Type
Maintain number ranges as per the ones that you have finalized.
1. In SAP Cloud for Customer system, under Business Configuration Implementation Projects , select
your implementation project and open the Activity List.
2. Under Fine Tuning, select the General Business Partners activity and enter the required number ranges.
During inbound processing in ERP, the business add-in COD_UTIL_BP_REPL is available to specify if you need
to follow an identical number range (as in ERP) or use a different number range.
In this add-in implementation, you can also set the Account Group of the business partner in ERP system.
Note
By default, the inbound processing creates business partners in number range internal to SAP ERP. If you
need to retain the business partner ID in your cloud solution, you need to ensure that the BP ID in SAP
When a business partner is created in your SAP Cloud for Customer system and replicated to the ERP system,
BP internal ID in the cloud solution will be saved in BUT000-BPEXT field by default.
However, if you need to follow the identification approach, implement the following steps:
1. Create Identification Categories in ERP to hold the business partner IDs in your cloud solution.
2. Implement business add-in COD_UTIL_BP_REPL and in method
IF_COD_UTIL_BP_REPL~COD_UTIL_BP_REPL_IN_PRE and set flag cv_set_identification to ‘X’ and
assign the identification category to cv_id_category.
3. For ID mapping during relationship create and update implement method IF_COD_UTIL_BP_REPL
~COD_UTIL_BP_REL_REPL_IN_PRE and set flag cv_set_identification to ‘X’ and assign the identification
category to cv_id_category.
4. When a business partner is created in ERP and replicated to Cloud for Customer, Cloud for Customer
should send a confirmation message back to ERP. For ID mapping during inbound confirmation in ERP
implement method IF_COD_UTIL_BP_REPL~COD_UTIL_BP_REPL_CONF_IN_PRE and set flag
cv_set_identification to ‘X’ and assign the identification category to cv_id_category.
In the ERP system, define logical ports for the HCI/PI using the SOAMANAGER transaction for the consumer
proxies.
You need to maintain the following code lists in your SAP Cloud for Customer system before migrating business
partners from the SAP ERP system:
● BusinessPartnerRoleCode
● CountryCode
● FormOfAddressCode
● GenderCode
● AddressUsageCode
● RegionCode
● BusinessPartnerRelationshipCategoryCode
○ In the CHANGED event of the business partner, deselect the Linkage Activated checkbox.
The table list of BAdIs available for extending inbound and outbound processing for BP replication.
Migration Reports
Use the following reports to migrate business partners and their relationships from SAP ERP system to your
SAP Cloud for Customer system:
● COD_UTIL_BP_REP_LOAD
● COD_UTIL_REL_REP_LOAD
1. In the Business Partners Replication dialog screen, select and specify value for – Business Partner ID.
2. Specify the Logical Port ID.
3. Execute the report.
As per the enhanced feature of Business Partner replication; a BPEM case is created, whenever there is a
failure in Business Partner Replication.
Follow these steps to configure automatic BPEM Case creation during failed Business Partner replictaion:
Note
Note
Maintain the error message in case category, for which you need to create an BPEM.
5. Enter the transaction code SM30 and maintain the below configuration in table COD_APPL_BPEM.
6. You need to run transaction code EMMA, whenever there is any error message captured as logs in
transaction code SLG1.
Whenever there is any business partner related changes triggered from Cloud for Customer; you can choose
whether the message needs to get back to Cloud for Customer or not. You can use the below IMG configuration
to suppress the messages originated from asynchronous or synchronous services using business partner APIs.
To configure the message suppression, navigate to SAP ERP Implementation Guide Customizing SAP ERP
SAP Utilities Cloud For Customer Utilities Business Partner Replication Message Suppression Activate
Services for Message Suppression .
Asynchronous Services
For asynchronous business partner replication service from Cloud for Customer to ERP, you have an option to
choose the scenario in which you do not want full business partner message back to Cloud for Customer.
Follow the below steps:
Note
This class has to be called before the commit statement only. If due to any error changes got role
back then no need to suppress the message.
For specific sub-scenarios where the suppression is not needed, parameter in respective BADI's are provided.
The parameter carries the configured value by default and it can be reversed in the BADI.
For example, in case of addition/creation of a new business partner address during business partner update
process in Cloud for Customer, the message loopback from ERP to Cloud for Customer may be required to
update the address number. In this case, the parameter in the BADI will have the suppression flag set to
"TRUE" and this can be changed to "FALSE" to allow the message loop back.
Technical details:
Changing parameter in BADI’s ‘cv_suppression_flg’ which carries the configured value by default.
● BADI : cod_util_bp_create_repl
○ Method - create_business_partner_pre
● BADI : cod_util_bp_repl
○ Method - cod_util_bp_central_modify
○ cod_util_bp_addr_modify
○ cod_util_bp_modify
○ cod_util_bp_ident
There an importing parameter ‘IS_SUPP_CONFIG’ which carries the actual configuration values.
Synchronous Services
You can suppress the message loop back to Cloud for Customer by activating the "Activate Suppress" under
Synchronous Services and maintaining Functional Module in below IMG activity: SAP ERP Implementation
Guide Customizing SAP ERP SAP Utilities Cloud For Customer Utilities Business Partner Replication
Message Supression Maintain Synchronous Services for Message Suppression
You can follow the below steps to configure business partner replication message sequencing from Cloud for
Customer to SAP ERP.
1. Switch framework to activate Business Function.Goto transaction code SFW5 and activate the Business
Function FND_SOA_REUSE_1 (Improvements for SOA Reuse Functions). This Business Function is available
under ENTERPRISE_BUSINESS_FUNCTIONS
.
2. To activate support for Point to Point communication.navigate to SAP ERP Implementation Guide
Customizing SAP ERP Cross-Application Components Processes and Tools for Enterprise
Applications Enterprise Services Point-to-Point Enablement for Asynchronous Enterprise Services
Activate Support for Point2Point Communication .
Use the report COD_UTIL_BP_REP_LOAD_V1 to replicate business partner data in bulk with parallel processing.
You have the option to run the report with a dedicated server group to maximize performance. Set up a
background job and monitor the status with transaction SM37.
You can follow the steps to configure business partner replication via parallel processing from Clouud for
Customer to SAP ERP.
It’s recommendable to schedule the report as background job and monitor in SM37 for bulk data
processing.
The steps to creating the configurable object hierarchy are listed below:
1. In your SAP ERP-IS Utilities system, use transaction code ENVD to create a configurable hierarchy.
2. Next, assign the configurable hierarchy to IMG activity node Configure Object Hierarchy under SAP ERP
Implementation Guide Customizing SAP ERP SAP Utilities Cloud for Customer for Utilities
Configure Object Hierarchy .
3. Implement Web Service - COD_UTILITIES_CONF_HIER_GET. The COD_UTILITIES_CONF_HIER_GET
reads the profile from the IMG node and sends it to the SAP Cloud for Customer system
Utilities solution uses the MDT template for creating a new customer and contract account in guided move-in
and for creating a contract account (during move-in) in guided transfer and also for rate change.
Note
For detailed information on the configuration, see the corresponding documentation for the IMG node
Configure MDT Template in the Implementation Guide configuration under IMG for SAP ERP SAP
Utilities Cloud for Customer .
Follow these steps to configure MDT template for use in your utilities solution in SAP Cloud for Customer:
Prerequisites
1. Create an MDT template using transaction code EPRODCUST. You need to create the MDT template with
category assignment – NewCust (standard template delivered by SAP IS-Utilities). A series of hierarchical
nodes representing utilities objects (along with the field level assignments) is displayed in the template.
Utilities solution in SAP Cloud for Customer uses this assignment to create customer and contract account
in the guided process for move-in (creating customer and contract account) and transfer (creating
contract account).
2. Double click on a node to list the mandatory fields for an object (listed below in this document). You will see
that for each field name, you can update the Value. However, it is recommended to retain the naming
convention as given in the standard template. Note that you may assign different Services to these fields
depending on your business requirements.
If you need to add additional fields, ensure the naming convention mapping (as in the above screenshot) is
maintained in the pre-exit add-in method MDT_MVI_CREATE_PRE. Find details of the add-in below:
● BADI_COD_UTIL_MDT_MVI_CREATE
● IF_COD_UTIL_MDT_MVI_CREATE
● COD_UTILITIES_MDT_MVI_CREATE (MDT_MVI_CREATE_PRE and MDT_MVI_CREATE_POST)
For further details, see the documentation for the IMG activity in the ERP system.
Assign the front office processes that you need to launch from SAP Cloud for Customer in the Implementation
Guide customizing.
Use
In the Implementation Guide (IMG) customizing for ERP system, assign the relevant front office processes that
you need to launch from SAP Cloud for Customer to the utilities launch object in the ERP system. You will find
the IMG for Cloud for Customer under IMGSAP Utilities This assignment enables you to call up your Front Office
processes in your cloud solution. Note that the launch object (of BOR object type) is assigned to the following
work centers in your cloud solution:
Prerequisites
You must have defined the required Front Office process in the IMG activity under SAP ERP IMG SAP
Utilities Customer Service Front OFfice .
Related Information
A switch document is triggered when you complete a quote (using guided quote), review and submit it to the
ERP system. This service is a webservice to service proxy asynchronous call. It triggers the creation of a switch
document from the cloud solution and creates the same in the ERP system. It also triggers a notification back
to the cloud solution to update the quote line item with the switch document ID.
Parameter Value
Communication Arrangement Scenario in cloud solution CREATION OF SALES QUOTE FOLLOW UP DOCUMENT IN
(MCPG) SAP BUSINESS SUITE
Communication Arrangement Service in cloud solution Create Sales Quote Follow Up Document in SAP Business
Suite
This service is triggered subsequent to the web service call for creating a switch document. After the the switch
document is successfully created, each quote line item shall have a corresponding switch document ID. This
switch document ID is then updated in the quote line items in the cloud solution using this service. The logical
port for this service is determined and the Default port is picked. However, this logical port can be overwritten
by implementing the business add-in COD_UTILITIES_QUOTE_NOTIF_PORT.
Parameter Value
Communication Arrangement Scenario in cloud solution Creation of Sales Quote Follow Up Document in SAP Busi
(MCPG) ness Suite
Communication Arrangement Service in cloud solution Notify Sales Quote of Sales Order Creation in SAP Business
Suite
In the ERP system, you need to create logical ports with transaction code SOAMANAGER in order to send web
service calls to the PI or other middleware system. Follow these configuration steps:
You can now trigger the update of swtich ID in the ERP system. Under Sales Sales Quotes Products
use Actions Update Switch Status to update the switch ID in ERP after you submit the quote using the
enrollment process. The on-premise ERP system triggers a notification to the cloud solution to update the
switch document ID
Extensibility using SAP Cloud Application Studio is supported for fields in switch documents.
The reports listed in this section must be executed for transfer of data from IS-Utilities system to the Utilities
Contact Center cloud solution.
The following table provides a snapshot of the data replication supported for Utilities Contact Center.
Delta (Modifica
Delta (Creation of tion of Existing Unidirectional/ Scoping and Fine
Object Initial Load New Objects) Objects ) Bidirectional Tuning
MDG
Utilities to Cloud
solution)
Utilities to Cloud
solution)
Technical Object Report: COD_UTIL_TECH_OBJECTS_REPL. Use the Technical Object report to replicate the
contract accounts to the cloud solution.
Note
Implement this report if you have scoped the Do you want to enable sales quote in your solution? question.
When you scope this question, you can create utilitiesspecific sales quote using the Utilities Lean
Quotation document type. Additionally, you can enable replication of contract account and point of delivery
data in the business configuration.
Note
If you have not scoped the question for sales quote, then you must execute the
COD_UTIL_CONN_OBJ_PREMISE_REPL report for replicating technical objects including premise, point of
delivery, and connection object.
Note
To enable the feature to use the External ID as Internal ID in Cloud for Customer for premise you must
scope the question Do you want to use Premise External ID as Internal ID in C4C?.
Schedule periodic runs for the initial load report ERP system to transfer the utilities technical master data to
the cloud solution. This report offers a single interface to replicate the following objects:
● Premise
● Point of Delivery (PoD)
● Connection Object
● Installation Point
● Hierarchical Relationship
1. On the Utilities Technical Objects Replication screen, enter values in the relevant field. You can enter values
in one of the following fields:
○ Connection Object ID
○ Premise ID
○ Point of delivery ID
The following table describes the fields that appear on the screen:
Field Description
Connection Object ID Select the range or ID of connection objects that you want
to replicate.
Point of delivery ID Select the range or ID of point of deliveries that you want
to replicate.
Language Key Used only when the point of delivery is selected. If left
empty, the logged on language is used.
Date Enter date and time details for the currently active point of
delivery selection. If left empty, the current application
service date and time are used.
Logical Port This is a mandatory parameter for the report and is the
logical port that is created for the PI.
Maximum Size Indicates the package size to split the data load. With this
field, you can control how much technical master data can
be sent in a single message. The web service can upload
several connection object IDs, premises, and point of de
liveries at once. The Technical Master Data is distributed
accordingly.
Test If you select this checkbox, the system does not send any
data to the SAP Cloud for Customer. It only checks the
number of possible records to be triggered for the given
selection.
Note
Along with the existing fields the District field is enabled for replication under the Premise.
Delta Replication
To replicate delta, you must maintain the setting using the SWE2 transaction code. The objects to be configured
for delta replication are as follows:
● CONNOBJ
● PREMISES
● ISUPOD
Maintain the following setting for the CREATE and CHANGED events:
● For standard implementation, use the CL_COD_UTIL_SWER_TECH_OBJ_DELT class. You can also maintain
a custom-implemented class.
● Enter a customized Receiver Type, maintain the same for all the objects.
● The Receiver Call is Method.
To trigger a delta replication for connection object data, follow these steps:
Note
Creating or changing a connection object triggers the delta replication for connection objects.
Note
Creating or changing a connection object triggers the delta replication for premises.
To trigger a delta replication for point of delivery data, follow these steps:
Creating or changing a connection object triggers the delta replication for point of delivery data.
This enables the replication of technical objects for Initial load with faster response time via parallel processing
technique.
Report COD_UTIL_TMD_REPL enables you to replicate bulk data related to technical master data objects using
additional option of parallel processing.
This report provides the option to execute the replication in a dedicated server group which preferably has
ample work processes available in order to maximize the performance.
Once the report is executed , technical master data is replicated through proxy generation. We can view the
payloads generated for data in message monitoring via sxmb_moni.
Extensibility for Initial Data Replication Report and for Delta Replication
To modify the standard implementation for the initial data replication report and for the delta replication runs,
you can use a Business Add-In (BAdI).
The COD_UTIL_TECH_OBJS_REPLICATION BAdI has four methods that is used to adjust the different types of
data. The following table describes the methods: IF_COD_UTIL_TECH_OBJS_REPL
Method Use
TMD_ADJUST_DATA Used only for initial load where you can adjust all the payload
that contain data, processed by the standard implementa
tion logic.
To run the reports in the ERP system and send web service calls to the PI or another middleware system, you
need to create logical ports with the SOAMANAGER transaction code. To configure, follow these steps:
Example
XISOAPAdapter/MessageServlet?
senderParty=&senderService=Q5J_340&receiverParty=&receiverService=&interface=Utilities_Techini
cal_Objests_Repl_Out&interfaceNamespace=http%3A%2F%2Fsap.com%2Fxi%2FCODERINT
7. To confirm that the logical port was created and configured correctly, ping the web service. If the ping is
successful, a confirmation message appears.
Contract Account Replication Report: COD_UTILITIES_ACCOUNT_EXTRACT. Use this report to replicate the
contract accounts to the cloud solution.
Note
Irrespective of whether or not you maintain the configuration for replicating contract accounts, the move in
screen displays all the contract accounts from ERP that are linked to the business partner. Further, the start
date for contract accounts is defaulted to the current date.
Prerequisites
1. You have implemented the corresponding web service for contract account.
Note
If you have scoped the question - Do you want to enable sales quote in your solution?, then you enable
the point of delivery data also to be replicated along with contract account.
1. You must always replicate a contract account using a business partner. To replicate a new contract
account, you can either create a new business partner or use an existing business partner in the cloud
solution.
Note
BP Replication using MDG: If you are replicating business partners using MDG, then in the PI mapping
for contract account replication, maintain the schema code 888 for MDG.
BP Replication using CVI: Similarly, if you are replicating business partners using Customer Vendor
Integration (CVI), then in the PI mapping for contract account replication, maintain the schema code
918 for CVI.
2. Configure the partner profile for IDoc type COD_UTILITIES_ISU_ACCOUNT_RE01 q. For the partner
profile, you must
1. Add or subscribe to the message type – COD_UTILITIES_ISU_ACCOUNT_REP
2. Maintain the PI receiver port
3. Execute the IDoc.
3. A customer implementation of business partners using Master Data Governance (MDG) must be done for
replicating business partners.
Note
Note that the framework for business partner replication using MDG is recommend but is not part of
the standard delivery.
Note
The business partner ID must have 10 characters. If the ID has less than 10 characters, you must
add leading zeroes to the ID. For example, if the BP ID is 1234, you must enter the BP ID as
0000001234.
Note
○ Contract Account
○ Business Partner ID
○ Partner Number of Receiver - Logical (system ID of the cloud solution)
Result
When you execute the report COD_UTILITIES_ACCOUNT_EXTRACT in the IS-U system, the report generates
and displays an IDoc number. It takes a few minutes to send this IDoc number to the cloud solution.
You can search for the new contract account under UTILITIES BUSINESS AGREEMENT .
Note
You need to enter a 10 character ID for contract account. Add leading zeroes if the contract account ID is
less than 10 characters.
This document describes the configuration required to run the report COD_UTILITIES_ACCOUNT_EXTRACT in
order to fetch the delta for contract accounts.
The contract account delta replication involves two steps - identifying the delta and replicating to the cloud
solution. These steps are documented in detail below.
In IS-Utilities, contract accounts are represented by business object ISUACCOUNT in the business object
repository (BOR). When a contract account is created or changed, events situation. The object ISUACCOUNT
has the events UtilAccount.created and UtilAccount.changed . These events are triggered when a
contract account is created or updated using Transaction codes CAA1 or CAA2.
In the transaction code SM30, create two separate entries in the customizing view SWFDVEVTY1 for the two
events CREATED and CHANGED.
Note
The SAP Cloud for Customer Utilities Contact Center solution implements an event handler (class
CL_COD_UTIL_SWER_CA) to consume these events (UtilAccount.create and UtilAccount.changed). This
event handler determines if the incoming event is for contract account and triggers the report
COD_UTILITIES_ACCOUNT_EXTRACT to fetch the delta for contract accounts.
This enables the replication of contract accounts for Initial load with faster response time via parallel
processing technique.
This report provides the option to execute the replication in a dedicated server group which preferably has
ample work processes available in order to maximize the performance.
You can also create background job via this report and monitor it separately in transaction SM37.
Once the report is executed , Idocs are created and can be monitored via transaction WE02.
Use the below configuration steps, if you want to send multiple IDocs as a single PI message to the receiver
system:
Note
The below images explain the setps involved to process 100 IDocs as a single message.
WE20
SE38 - RSEOUT00
For more information on Contract Account Replication – Extension on CPI Artifact, see https://help.sap.com/
viewer/368c481cd6954bdfa5d0435479fd4eaf/Cloud/en-US/d3741720e29842e4bf547dcd66139f7f.html
Code list mapping must be maintained for the fields specified in the following sections
Automatic and manual code list mapping must be maintained for the utilities specific codes..
In the code list mapping, ensure that the delimiter is set to coma (,) and the Code List Mapping Group as 03 -
SAP On Premise Integration.
Note
If you are using the MDG framework to replicate business partners, you also need to maintain the code list
mapping for role code from ERP to role : CRM000 in the SAP Cloud for Customer.
Prerequisites
Before downloading the code-list mapping report you need to activate BC set COD_MERGE_CONFIGURATION in
SCPR20 transaction.
To configure a consumer proxy to access a service, you need to create and configure logical port. A logical port
is created for a specific consumer proxy to access one particular binding on the provider system.
Logical Port configuration is applicable for the below Interfaces/services either for SAP PI or SAP HCI/CPI
Note
1. Start the ABAP SOA Manager using the transaction code SOAMANAGER.
2. Go to Web Service Configuration under Service Administration.
3. Enter the PI outbound service name or the ERP service name and click on Search.
4. For this Consumer Proxy, create a logical port and select Manual Confguration.
Note
Logical port can be created as any type, but this example shows for Manual Creation
5. Provide the logical port name and description and then click Next.
7. Under HTTP Settings, provide the technical connectivity details pointing to the PI system. Then click Next.
9. Click Next.
10. In the New Manual Configuration dialog, click Finish.
To configure a consumer proxy to access a service, you need to create and configure logical port. A logical port
is created for a specific consumer proxy to access one particular binding on the provider system.
Logical Port configuration is applicable for the below Interfaces/services for SAP Cloud Platform integration.
Note
1. Start the ABAP SOA Manager using the transaction code SOAMANAGER.
2. Go to Web Service Configuration under Service Administration.
3. Enter the SAP Cloud Platform outbound service name or the ERP service name and click on Search.
4. For this Consumer Proxy, create a logical port and select Manual Confguration.
Note
Logical port can be created as any type, but this example shows for Manual Creation
6. For Authentication Settings, under UserID/Password and enter your cloud platform system user ID and
password. Click Next.
7. Under HTTP Settings, provide the technical connectivity details pointing to the SAP Cloud Platform
system. Then click Next.
8. Under SOAP Protocol, enter the following details:
○ RM Protocol - SAP RM
Note
The endpoint of any iFlow can be determined by referring to the sender connector of the cloud
platform system. The /cxf will be added for all the urls.
9. Click Next.
10. In the New Manual Configuration dialog, click Finish.
11. Finally test the connectivity that you have configured. To do this, click Ping Web Service.
Tip
For SAP Cloud Platform system connection, the ping test returns a fail as this is an empty request for
cloud platform. Note that the logs you to the HCI monitoring. This failed message determines a
successful connectivity between ERP and cloud platform.
To integrate the front office processes with your SAP ERP system, you must create and configure a new
mashup.
1. Go to the Administrator work center and click Industry Settings Utilities Settings for Front Office
Process .
2. Click on New to configure. Maintain the following details:
○ Description
○ Active Flag
3. In the Assign Mashup ID to Launch Object table, add a new row and select the Launch Object.
4. Under Mashup ID, select the Mashup ID.
Note
You also need to assign the launch object in the Implementation Guide Customizing for SAP Hybirs Cloud
for Customer Utilities. For more information, see the reference in the related links section.
Business Partner Exception Management (BPEM) - Integration with SAP ERP or S/4HANA System [page
190]
Remove Personal Data in Contract Account and Sales POD [page 196]
Search for utilities customers in the cloud solution and in the SAP ERP system.
The search that you perform launches an online search for business partners in the ERP system. Use the
advanced search based on customer identification, address details or specific utilities information such as
point of delivery, service location, service order, meter ID, connection object ID, contract ID, and so on. Also
customize the search criteria with extension fields.
Note
For a local search within the cloud solution, you need to replicate the utilities business partners from ERP
system to your cloud solution. Additionally, you must have defined the required code list mapping.
In the search result for a customer, if the customer has a contact role, you can navigate to the customer details
page using the hyperlink in the Contact ID column.
Enterprise search in HTML client and Live Activity Center-based search in Fiori client are available for Utilities
Contact Center. The utilitiesspecific object categories are available in enterprise search or live activity center
only if the Utilities Call Center solution is scoped in the system.
Enterprise Search
Enterprise search is available in the HTML client for the following utilities categories. Note that for the Utilities-
Customers category, the basic customer search is a local search in the cloud solution and advanced search is
executed as online search. The search for other utilities categories is an advanced online search.
You can use the live activity center based search in the responsive UI (RUI) client to search for utilities objects.
The search feature is similar to enterprise search in the HTML client.
1. Launch the Live Activity Configuration screen ( Administrator Service and Social Live Activity
Configuration ).
2. In the Search Objects section of the screen, click Add.
3. In the Add Search Object box, select the object that you want to add, and then click Add. If you want to add
more objects, select Add and New. If no objects are selected, the following objects are searched:
○ Account
○ Contact
○ Individuals
○ Tickets
4. Click Save.
The following conditions apply for the search using both Enterprise Search and for search using Live Activity
Center.
● For the customers' category, the basic search is a local search in cloud solution and advanced search
triggers an online search.
● For the premise category, search using division must be executed along with equipment number.
● For POD category, search using division must be executed along with installation number.
● Customer and Premise Search:
○ Search using either house number, street name, apartment ID, floor ID, or country/region must be
supported with additional parameters.
Under Live Activity screen, when you receive the calls through IVR, you can now identify the customers based
on independent communication data i:e phone number stored or replicated in the system.
In Live Activity Center, you can view the contract account and premise details of an customer and account.
As an administrator, you can enable contract account and premise tables in the live activity center. Go to
Administrator Service and Social Communication Channels Live Activity Configuration , and select
the Enable Contract Account checkbox.
When you select a customer and account, a table with the contract account and premise details appears.
In Live Activity Center, you can confirm the contract account details of an already confirmed customer and
account and the same contract account would be defaulted across all the screen.
When you select a customer and account, a table with the contract account and premise details of the
customer and account appears. You can confirm the required contract account and the same would be
defaulted across the following screens: Utilities 360, Utilities Financials, Utilities Rate Change, Utilities
Collections, and Utilities Contracts. You can also unconfirm the contract account and the same would be
unconfirmed across the above mentioned screens of the confirmed customer and account.
You can confirm the contract account via IVR(Interactive voice response), along with the customer. The
confirmed contract account in Live Activity is reflected in Utilities 360, Utilities Financials, and Utilities
Collections screens of the customer.
To specify the custom field to be used as an input to IVR, administrator must navigate to Administrator
Service and Social Communication Channels Live Activity Configuration and set value for field Select the
custom field that you want to use to confirm Contract Account from IVR.
This enables you to confirm the collective contract account from Contract Account table in Live Activity screen
of the customer.
The details of the confirmed collective contract account are defaulted under Utilities Financials, Utilities
Collections, Utilities Rate Change, and Utilities Contracts screens of the customer.
The reuse libraries for contract account provide additional, very specific services to the scripting language that
are relevant to fetch the Confirmed Contract Account.
To use this reuse library, you need to import the http://sap.com/xi/AP/CRM/Global name space.
UtilitiesLib.GetConfirmedObjects
Description Returns the contract account confirmed from the Live activity in the current session. The confirmed
contract account can be used in custom tab.
Result:
When a call is simulated through IVR, the respective customer gets identified in Live Activity and the Customer
Hub screen of the identified user opens up.
To specify the custom field to be used as an input to IVR, administrator must navigate to Administrator
Service and Social Communication Channels Live Activity Configuration and set value to YES for
optionOpen Customer Hub.
Once you enable the option of opening custome hub you will be able to ebale the new contract accounts table
containing list of contract accounts for the identified customer under the following path Administrator
Service and Social Communication Channels Live Activity Configuration Utilities Settings and set value
to YES for optionConsider Contract Account View in Customer Hub.
You can initiate Move-In, Move-Out, and Transfer services from all the Utilities screens of a customer.
As an administrator, you can configure scripts to display the terms and conditions for rate or service orders in
the move-in and move-out processes.
Section Description
3. Click Save.
4. Go to Rules for value determination for Move In/Out Script, and set the rules for the script.
After the script is configured, the agent can launch the script during the move processes to agree to the terms
and conditions.
As an Administrator, you can configure the severity for the messages received during move process to display
whether it’s an error, warning, or instruction. The messages can also be suppressed if you don’t want them to
display.
1.2.3.3 Move-In
Move-in service can be initiated in the ERP system from your cloud solution from the Utilities Contracts view
screen for a customer.
Move-in of a service means that a customer is signing up for a utilities service such as gas, electricity, water,
and so on. A move-in created in SAP Cloud for Customer creates a corresponding move-in in the SAP ERP
system.
Create Move-In
Note
For guided move-in, you can only use either Move-In or Move-In using MDT. The decision and the
necessary configuration must be made during early implementation.
To create a move-in, you must specify the mandatory fields Contract Account, Start Date, Joint Invoicing, and
select the service address. The mailing address is populated using the service address. The list of contract
accounts available for selection is pulled in from ERP system.
New Mailing Address: Set the flag for New Mailing Address in the Create Move-In dialog screen to create a new
mailing address during move-out. This address replaces the standard address maintained for the business
partner in the ERP on-premise system. Note that the standard address in the ERP system is not updated if you
do not set the flag for New Mailing Address. Validity date range is introduced in Move-In using the new Valid
From and Valid To fields within the mailing address.
You can also use type ahead search to select an address after typing only a portion of it. For detailed
information on Address Type Ahead Search, refer to
When you select a valid Service Type, the fields for meter reading are enabled and you can update the meter
reading for each of the devices at move-in. You can also select a meter reading type and note type. After saving
the move-in, a new move-in document and contract are created for the customer (and for the specified
premise) in the ERP system and a new move-in is added to the Contracts table.
Note
Create Service Order: Select the checkbox for Create Service Order when creating a move-in, move-out or
transfer. A corresponding service order is created for the move-in request and is displayed in the list of
service orders in the Service Orders screen. This feature for create and display of service orders is available
only if you have performed business replication to customer master. Additionally, in the BAdI
configuration, the Order Type, and Order Code for service order has to be defaulted in the ERP pre-BADI.
Note
Irrespective of whether or not you maintain the configuration for replicating contract accounts, the move in
screen displays all the contract accounts from ERP that are linked to the business partner.
When you create a new move-in or transfer, you notice that the move-in (or move-out as applicable) date and
the meter reading date are the same. If you change the move-in date, this correspondingly updates the meter
reading date with the new date. However, when you estimate a meter reading (in move-in, move-out or
transfer), you can change the meter reading date to a different date.
Based on the premise that you select and the current or the move-in date, the active rate category is defaulted
for a contract from ERP. You can also modify the default active rate category by selecting a rate category from
the list of all rate categories valid for the selected division. These values are retrieved from the ERP system
using the move-in date for the selected installation.
Note
When you modify the rate category, a new row gets added for move-in with date starting from move-in date.
The existing rate category exists with ending date just before the move-in date where the move-in date is
D-1 with D being the current date.
Cancel Move-In
Select a move-in from the table and use Actions Change Move-In to cancel an existing move-in. A
message is displayed confirming the cancellation. Further note the following: 1) If a move-out date exists, the
Change Move-In is not enabled. 2) The entry for the move-in is deleted from the table.
Note that you can only cancel a move-in for which no move-out has been created. On cancel of a move-in
for which move-out has already been created, you are prompted with a message that the move-in is
irreversible.
Edit Move-In
You can change the date for an existing move-in. Note that the date cannot exist earlier than the move-out date
of previous contract.
The change process displays all the installations of a selected move document. You can update all the meter
readings at once for the installation or devices in the move document. The process immediately saves the
change in date.
Launch guided move-in from the toolbar in accounts and individual customers or in the Premise using the
Move-In button.
Feature highlights for guided move-in include possibility to capture reason for move-in, update rate category,
enter meter reading, create an ERP service order, request security deposit, update mailing address, and add
additional notes.
You can view both AMI and non-AMI meter details in the move in process. If it's an AMI meter, the AMI-related
capabilities appear dynamically.
Note
You can also use type ahead search to select an address after typing only a portion of it. For
detailed information on Address Type Ahead Search, refer to
Note
If you've implemented move-in using MDT, to create a customer or contract account during guided
move-in, maintain the required configuration for MDT. For more information, see MDT Templates
for Move-In, Customer, Contract Account & Rate Change Using Guided Processes [page 61]
○ The Premise section displays the Move-In Address, Move-In Date (current date), and Supplementary
Fields.
2. Services
○ The header section displays Customer ID, Premise ID, and Address from the previous step.
○ This step also displays all the services listed for that particular customer along with information such
as rate category, installation ID, and division.
○ The Details section displays meter reading for the selected service. Estimate and Reset is possible for
meter reading.
○ The Meter Information table displays meter details such as device category, register group, AMI status,
and capabilities in the move-in process. Create and change the meter reading screens to view device
information record.
Note
Restriction
It is not possible to identify the device for which meter reading history is displayed in Move-In GAF
as there are multiple rows of device as lead selection.
Restriction
○ The Guided Activity Floorplan (GAF) data automatically disappears after Move-In action.
○ Product list are not handled for sales areas, territory and so on.
○ The custom extensions for Sales process is not supported.
5. Review
○ This step displays a summary of all information maintained in the previous steps. Review the details
and click Create Move-In to initiate the move-in process.
In the step 2 of Move-In process where services and meter reading reusable Embedded Component (EC) are
available for which the round trips made to ERP are reduced.
In the following ECs, the property in the in port RequestFireOnInitialization and RequestAutoRefire is set to false.
So, to use the EC in any screen fireOutport should be used to call it explicitly.
● COD_UTILITIES_ACCOUNT_AND_PAYMENT_DETAILS.EC
● COD_UTILITIES_SERVICES_AND_METER_READING_EC.EC
● COD_UTILITIES_CONTRACTACCOUNT_AND_BILLING.EC
● COD_UTILITIES_MOVEIN_REVIEW.EC
● COD_UTILITIES_MOVEOUT_REVIEW.EC
● COD_UTILITIES_TRANSFER_REVIEW.EC
Related Links
Use the security deposit and joint invoicing details at contract level in move in process.
To enable the Contract Information table appear on the move in process page, go to Business Configuration
Implementation Projects Your Project Edit Project Scope Questions Industry Solution Utilities ,
and then select Utilities Call Center and Service. From Questions for Utilities Call Center and Service, select Do
you want to enable Security Deposit at contract level?.
Based on the requirement of your project, you can use the previous billing information or the new contract
information table for the process. Both billing information and contract information have joint invoicing and
security deposit details. However, while billing information appears at the Contract Account level, contract
information appears at the Contracts level.
For a move in, you can perform rate simulation to get information about the alternative rate categories that are
available.
1.2.3.4 Move-Out
Move-out services can be initiated in the ERP system from your cloud solution from the Utilities Contracts view
screen for a customer.
Create Move-Out
A move-out can be initiated if the contract account has valid contracts and associated move-in's for the same.
The service address and meter readings are defaulted from the Utilities Contracts table. You can specify a
move-out date and also the meter reading at move-out, note type, and the meter reading type.
New Mailing Address: Set the flag for New Mailing Address in the Create Move-Out dialog screen to create a
new mailing address during move-out. This address replaces the standard address maintained for the business
partner in the ERP on-premise system. Note that the standard address in the ERP system isn't updated if you
Note
You can also use type ahead search to select an address after typing only a portion of it. For detailed
information on Address Type Ahead Search, refer to
The action Cancel allows you to cancel the customer mailing address for a move-out. Therefore, after you’ve
completed the move-out and refreshed the screen, you'll no longer see the customer mailing address.
On save, the existing contract in ERP system is terminated and a confirmation for the same is displayed in the
cloud solution. Further, the move-out date is updated with the end-date.
Cancel Move-Out
Select a move-out from the table and use Actions Change Move-Out to cancel a move-out that has
been created earlier. Once you cancel a move-out, a confirmation message is displayed that the move-out has
been canceled. Further, that end-date for the contract is set to unlimited.
The change process displays all the installations of a selected move document. You can update all the meter
readings at once for the installation or devices in the move document. The process immediately saves the
change in date.
Edit Move-Out
You can change the date for an existing move-out. Note that the date can't exist earlier than the move-in date of
the previous current contract.
Launch guided move-out from the toolbar in accounts and individual customers. Guided transfer is also
launched when you select a move-out line item in a premise and then click Move-Out button.
Feature highlights for guided move-in include possibility to capture reason for move-in, update rate category,
enter meter reading, create an ERP service order, request security deposit, update mailing address and add
additional notes.
Note
1.2.3.5 Transfer
You can transfer the services for an existing move-in using the transfer feature. Click on Transfer in the Utilities
Contracts screen to initiate transfer.
1. Select a contract from the table and click on Transfer. In the dialog box that appears, the Move-Out Address
displayed is the same as the move-out address of the selected contract.
2. You need to specify the mandatory values for Contract Account and Joint Invoicing.
3. Select the address for the new move-in and then you're prompted to enter the start date of the new move-
in.
4. Also select the service address for the new move-in. The mailing address is defaulted to the service
address of the new move-in. Choose to maintain the other values for transfer in the dialog box.
New Mailing Address: Set the flag for New Mailing Address in the Transfer dialog screen to create a new
mailing address during move-out. This address replaces the standard address maintained for the business
partner in the ERP on-premise system. Note that the standard address in the ERP system isn't updated if
you don't set the flag for New Mailing Address. Validity date range is introduced in Transfer using the new
Valid From and Valid To fields within the mailing address.
Note
You can also use type ahead search to select an address after typing only a portion of it. For detailed
information on Address Type Ahead Search, refer to
RESULT: You select an active contract and initiate a transfer. Note that you are moving in to new service
address and moving out from an existing service address. But there is no move-out for the contract as part of
transfer. Once the transfer is complete, the selected contract is updated in the Contracts table with the move-
out date. Further, a new row is created for the new move-in contract.
The meter reading table is also refreshed with the entries for the new move-in address. If you have set the flag
for Create Service Order, a new service order is created and an entry is made in the table for service orders in
the Utilities Service Orders screen.
Note
Force Move-Out: If there is an existing customer in the new Move-In Address, this customer is replaced by
the new customer moving-in.
With guided transfer, you can now create a move-in, move-out and transfer in a single process. Launch guided
transfer from the toolbar in accounts and individual customers. Guided transfer is also launched when you
select a move-in line item in a premise and then click Move-In.
You can view both AMI and non-AMI meter details in the move in processes. If it is an AMI meter, the AMI-
related capabilities appear dynamically.
Note
Note
A contract account is automatically created only for a move-in as part of the transfer. To enable this,
maintain the required configuration for MDT template. For detailed information, see MDT Templates for
Move-In, Customer, Contract Account & Rate Change Using Guided Processes [page 61]
1.2.4 Alerts
You can view static content under the Alerts side panel across the Customer, Premise and Contcat Account
screens in Utilities Contact Center solution.The Alerts framework is also available at every stage of move
processes.
After you add the tab, you can enable it as a side pane in screens. From the Adapt menu, select Company
Settings, and then select the Enable Side Pane in Fiori client checkbox.
In ERP or S/4HANA system, you can configure the alerts framework using the IMG configuration. You must
maintain the configuration for the BRF application name corresponding to the SAP Cloud for Customer launch
object. Similarly, to extract the required importing parameters to the BRF application, you must implement the
process context method in the ERP or S/4HANA system.
You can enable the display of alerts in the expanded mode through a scoping question. To configure the
scoping question go to Business Configuration Edit Product Scope Industry Solution Utilities , and
select Utilities Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Alerts, select the Do you want
expanded Alerts in Move Processes? question.
1.2.5 Premise
The Premise work center is a hub that allows you to perform a host of utilities functions such as creating or
changing move-in, move-out, transfer and meter readings. In addition, view the premise on a map, display
object hierarchy for installation point and create new sales PODs for the premise.
Use the icon for Map View to view the premise locations plotted on google maps. In the premise header, the
Installation Point is hyperlinked.
This screen has three sub-sections, namely the CustomerMap View, Highlights and Customer Overview. This
view is displayed in the Collapse Map mode by default. To display the premise in map view, click Expand Map.
Highlights
This section displays key details such as connection status for an installation or any other custom defined
messages. Click the hyperlinks for Contract Account and Name to navigate to the Contract Account and
Individual Customers work center views respectively.
Customer Overview
● Create a simple Move-In. Use the Move-In on the toolbar to create a guided move-in.
● Cancel a Move-In
● Change a Move-In
● Create a Move-Out. Use the Move-Out on the toolbar to created a guided move-out.
● Cancel a Move-Out
● Change a Move-Out
● Create a new simple Transfer. Use the Transfer on the toolbar to create a guided transfer.
Connection Details
This tab screen displays the object hierarchy starting from the installation point or the point of delivery. For the
devices in the premise, the Details section lists information for the installation point such as the Meter Reading
Unit, Grid Level Type, Status, Guarantee of Supply (field from the SAP ERP IS-Utilities) and so on.
An agent can ping AMI to receive the status of the meter from the call center. The status comes with details
that can be used for analysis. To ping a meter, select the AMI, and then click Ping.
The ping provides the date and time of the last ping along with the details of the meter. For example, in the
following image, the voltage of the meter is displayed.
Meter readings are displayed for a selected device in a table. Edit the meter readings or create a new meter
reading. Use the advanced search to search for a device for the selected premise that is not displayed here.
Note
The New Meter Reading allows you to create new meter readings using a form template. Use the New Meter
Readings menu option under the gear icon to create meter readings using the standard screens in your
solution.
Tickets
This tab screen displays all tickets associated with the premise. Search for tickets in this screen using the
Completed Tickets, Open Tickets, Related to Premise Only, and Related to Point of Delivery filter values. You can
also use the advanced search to look for tickets.
Create new tickets and also select a point of delivery related to a premise. To do this, you can use the search
help for the POD External ID. The installation point, address details and the Premise Ext. ID are for the ticket.
Select a ticket in the list to navigate to the Tickets work center.
Note
Two POD IDs are displayed when creating a new ticket from a premise. The premise that is displayed by
default reflects an existing implementation where the search help for point of delivery or POD External ID is
restricted to the Cloud for Customer system. A new implementation for the POD External ID is available
wherein an online search is performed in the ERP system to fetch values for POD External ID.
Service Orders
In this screen, a call center agent can find an overview of service orders logged in for the premise You can also
create new service orders for the premise. Note that the service address is not defaulted to the premise
address to allow you to log a service ticket for a different service location.
Sales POD
Search for a sales POD linked to the premise or create new sales POD. The premise ID and the address details
are copied from the selected premise.
Exceptions
Disconnection Documents
In the Disconnection Documents section, view the disconnected documents associated with a premise or an
installation.
Note
Analytical Reporting
You can use Premise objects for Analytical Reporting. To find the objects go to Business Analytics Design
Data Sources . For details on Analytical Reporting, see https://help.sap.com/viewer/
66e9a9081a7b40e38c8604d6617d0311/1911/en-US/576afc782dde4567ad3856ed128e0a1d.html.
When you hover over the premise you can see the details of it under the premise quick view. In addition to the
previously added obejcts you can also view the number of existing services, premise type, address in the label
For easy and quick identification you can now turn on an alternative title for premise object based on scoping
question.
The alternative title displays house number, street name, and house supplement, which makes it more
meaningful.
To configure the premise object title navigate to Business Configuration Edit Product Scope Industry
Solution Utilities , and then select Utilities Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Enhancements, select the Do you
want to enable the premise object labels to display house number, street name, and house supplement?
question.
1.2.5.2.1 Central
This tab displays cards such as Customer, Recent Tickets, and Recent Meter Readings.
● View recent customer details in Customer card and Google map view for the premise.
● View recent tickets and create ticket in Recent Ticket card.
● View recent meter readings and enter new meter reading in Recent Meter Reading card.
You can add new meter readings for each of the services corresponding to the service address of the contract.
Along with the meter reading, you will need to specify the meter reading type, date and select a meter reading
note type. On saving your entries, a confirmation message is displayed in the cloud solution and the
corresponding meter readings are updated in the ERP system.
Note
Meter reading is not mandatory for move-in, move-out and transfer. You can create move-in, move-out and
transfer without specifying meter readings.
All the field help values such as meter reading note type / reason / meter reading type are updated using
the auto code list mapping. See Related Information section below for the topic Code Lists Mapping.
You can now enter or estimate an interim meter reading with or without billing. You must specify the
appropriate meter reading reason and type.
Additional features for meter reading: If you enter an incorrect meter reading (meter reading not in the
expected range), the meter reading is considered as Implausible. Any meter reads in processing status 2 are
considered as implausible but will nevertheless be saved.
● Estimate - Use this option to estimate the meter reading and consumption for an installation.
● Override
● Reset - Use this option to clear all the meter reading values and you can enter fresh data.
The meter reading table displays a combination of meter reading result and meter reading order, sorted by
date, device and registers. Create a meter reading result for a meter reading order. Customer receives a bill
only if meter reading order is available for the period.
Characteristics of MR Order:
● View meter reading orders in the meter reading table under Premise (work center) Connection Details
(tab) .
● Create and edit meter reading orders in the Connection Details tab in the Premise work center.
● In the meter reading table, a highlighted tick mark in the MR Order column indicates that meter reading
order is active and scheduled. An active meter reading order is in status Meter Reading Order Created and
it is possible to create new meter readings and edit the line item.
● A grayed out check mark indicates the meter reading has already been recorded for the order. It is possible
to enter new meter reading only for the following meter reading reasons: 02- Interim meter reading with
billing and 09-Interim meter reading without billing.
● Edit a line item in the meter reading table is possible for both, an active meter reading order and for a
meter reading result. If meter reading is already maintained, edit is NOT possible for meter reading status
Billed.
● If meter readings are blank, then meter reading orders are created for meter reading reasons 02 and
09.
The Connection Details tab of a Customer displays the validity period of meters of a premise or an installation.
In the Meter Information table,view the device location details related to the selected device and connection
object. The device location note appears in the Notes popup.
Use Advanced Metering Infrastructure (AMI) to capture consumption from the periodic interval meter
readings. This information is for display only and cannot be modified.
Advanced metering infrastructure (AMI) is an integrated system of smart meters, communications networks,
and data management systems. Use this system to enable two-way communication with your customers.
Access details on AMI and non-AMI meters under the Meter Information table for meter readings. Find this
table under:
The following details are retrieved from the SAP ERP system and displayed in the Meter Information table.
Note
In the Utilities 360 tab, the Meter Informationtable is displayed only if you select an AMI activie device.
However, in the Connection Details tab in the Premise, the Meter Information table is displayed irrespective
of whether the device is AMI active or not AMI active. However, the fields listed below are displayed only for
an AMI active device. If you select a non-AMI device, then only the general meter reading details are
displayed.
● AMI Status
● Remote Connect
● Remote Disconnect
● Remote Meter Reading
● Manual Meter Reading with AMS
● On-Demand Meter Reading
● Request Operational State
Note
Some of the fields listed above are personalization hidden and can be enabled by the user.
As an administrator, you can configure a safety message to reconnect the AMI smart meter.
On the Safety Message for Reconnect, you can manage the message to be mandatory or optional.
This work center view displays all contracts for a selected contract account including information such as
move-in and move-out dates.
The contract accounts are listed with the following details: Contract ID Description, Contract ID, Customer ID,
Customer Name, Customer External ID, Bill to Party, Payment Terms, Inbound Payment Method Outbound
Payment Method and Collective Contract Account ID, Due Amount, and Open and Payable Amount.
If you are creating contract accounts using the MDT template, in the BAdI configuration, make sure the Bill
Form and Clearing Category are defaulted in ERP pre-BADI.
This new work center provides you the capability to use value help search in advance search.
Click Edit Contract Account to edit the selected contract account. The Edit Contract Account dialog appears
where you can modify your options and save the entries.
Note
The edit icon is not a valid UI option for editing the contract account. Always use the Edit Contract Account.
Fix Address: If an address is marked as main (flag Main is selected) in the Addresses tab for customers, then it
is considered the fixed address. You find the fixed address in the Additional Details section in Overview tab. If no
main address is available, then select a fixed address for a contract account. To do this, edit the contract
account and select a Fix Address from the list of values filtered for your user. You can also select a Fix Address in
the Utilities Contracts work center view under Customers.
Sales Quotes
All sales quotes for the selected contract account are displayed in this tab screen. You can create a new sales
quote or search for an existing quote using Advanced Search.
You can use Contract Account objects for Analytical Reporting. To find the objects, go to Business Analytics
Design Data Sources . For details on Analytical Reporting, see https://help.sap.com/viewer/
66e9a9081a7b40e38c8604d6617d0311/1911/en-US/576afc782dde4567ad3856ed128e0a1d.html.
Related Information
MDT Templates for Move-In, Customer, Contract Account & Rate Change Using Guided Processes [page 61]
Contract Account Replication [page 71]
Contract Account Delta Replication [page 73]
As an administrator, you can configure a new Contract Account Work Center with value help capabilities for
advanced search fields.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Enhancements, select the Do you
want to enable the new contract account work center with value help capabilities for advanced search fields?
question.
Due to change in business landscape there is a need to provide some important views under contract account
as well.The information visible would be pertaining to the relevant contract account only
1.2.6.2.1 Details
This view displays the consolidated general, financial, and more information of the contract account. This
screen gives visibility of all the details pertaining to the selected contract account in a single place.
The links in the following fields open the associated objects: Customer External ID, Customer ID, Bill to Party,
Corr. Recipient, Alt. Dunning Recipient, and Alternative Payer.
This screen displays all tickets created for the contract account.
Create a new ticket for contract account by selecting the New option. While creating the new ticket the system
auto populates the Contract Account ID for that contract account.
Create the BPEM cases by selecting the contract account case category provided in tickets.
This screen displays all the locks related to the contract account and contract.
This screen has three sections has the following sections in it:
Locks
All locks for the selected contract account are listed in this screen. Details that are displayed include Lock
Status, Object, Object ID, Lock Type, Lock Reason and validity dates. You can create, edit, and delete locks. The
following lock types are supported for contract account locks:
● Calculate Interest
● Dunning
● Income Payment
● Invoice
● Invoicing
● Outgoing Payment
● Posting/Clearing Lock
Contracts
This tab screen displays all contracts associated with the contract account. They are listed with details such as
the Contract Account ID, Customer ID, Contract ID, Premise ID, Service Address, Installation, Point of Delivery
(PoD), Division, Move In Date, Move Out date and Rate Category.
Contract Locks
When you select a contract in the Contracts table, the corresponding locks for the contract are displayed in the
Contract Locks table below. Details such as Lock Reason, Status, validity dates, Object ID, and so on, are
displayed for the locks.
In the Contract Locks table, use Actions Create New Lock/Edit Lock features. Only locks of type Invoicing
can be created for contracts.
1.2.6.2.4 Invoices
This screen displays the invoices pertaining to the open contract account.
A list of invoices created for the contract account and for each of which one or more corresponding billing
documents exists, are displayed in this section. You can set a date range to view the invoices of that time
period. Some of the available options are Invoices From Last 1 Year, Invoices From Last 90 Days, and Invoices
From Last 7 Days.
This screen displays all the unpaid financial documents pertaining to the open contract account
For the selected line item, you can perform the actions Create Locks, Manual Posting, Deferral, and Reversal.
You can also verify the document origin key and origin text; displayed in the table.
1.2.6.2.6 Payments
This screen displays all the payment documents created for the contract account.
You can also cancel a particular payment line item by selecting Cancel Payment action provided on the
Payments table.
This screen displays history of all financial transactions pertaining to the contract account.
For the selected line item, you can perform the Reversal action.
This screen displays all the security deposit documents posted for the contract account.
You can also perform actions like Reverse, Release and Partial Release on the security deposit docuemnts
based on the status.
This screen displays the collections details pertaining to the open contract account.
● Dunning History - Displays the dunning activity of the contract account. With this functionality, you can
create and send payment reminders or dunning letters to your business partners to remind them of
overdue payable and to request payment.
● Returns - Displays the list of payment transactions, which are returned from the target systems (Bank,
Cheque, SEPA, and so on)
● Correspondence History - Displays the history of all the correspondences sent to the customer.
● Write Offs - Displays the list of items, which have been written off. Writeoff data provides information on a
business partner's payment history.
In this screen, view contact information and preferences for notifications such as email, text, or IVR for
different services.
This is integrated with Smart Energy Water to view and update the preference in Service Cloud.
In Consumption Graph, review the usage graph for the services installed for a contract account.
The usage graph is integrated with Smart Energy Water to view the usage information for linked Premises in
Contract Account.
Related Information
View and maintain the Payment Plan and Budget Billing Plan pertaining to the open contract account.
Payment Plan - Create, edit, display, and deactivate payment plans for a contract account.
Budget Billing Plan - Create, edit, and display the budget billing plan for a contract account. The budget billing
plan is the basis for charging budget billing amounts.
View and maintain the Installment Plan pertaining to the open contract account.
Installment Plan - Create, view, or change the installment plans. Use an installment plan to divide source items
into several installment receivables that have future due dates.
View the total variance amount, with changes to the installment plan amounts, in the Calculated Variance field
for contract account. Access the over or under amounts while creating or editing the installment plan.
This tab displays cards such as Recent Invoices, Last Payment, Premises, Locks, Recent Tickets, Open Items,
Customer Credit Worthiness, Security Deposit, and Dunning.
In this screen, view the nearby outage area for a customer based on contract account.
It shows the current map as well as the planned outage map based on city or ZIP code.
The outage map is integrated with Smart Energy Water to view the outage areas.
1.2.6.2.16 Compare
In this screen, view the power consumption difference of a time period for a customer.
It displays the current month or year power usage compared to previous month or year usage depending on
ZIP code,utility, and so on.
This is integrated with Smart Energy Water to view the consumption difference.
For easy and quick identification you can now turn on an alternative title for contract account object based on
scoping question.
The alternative title displays conract account external ID and name, which is more meaningful.
To configure the scoping question for contract account you can navigate to Business Configuration Edit
Product Scope Industry Solution Utilities , and then select Utilities Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Enhancements, select the Do you
want to enable the contract account object labels to display external ID and name? question.
1. Navigate to Administrator Industry Settings and select Contract Account Profile Configuration.
2. Select theEnable Profile toggle button under Profile Configuration to determine the visibilities of the tabs
and cards.
3. Click New to create a profile.
The system sets the first profile as default. You can change it later.
Note
5. Select the Visible check box for the cards and tabs from the list that you need.
Note
You must manually select the Central tab if you are selecting any card.
Delete the cards or tabs that you don’t want for the profile. You can add the deleted cards using + icon.
6. Click Save.
Note
1. Navigate to Administrator Industry Settings and select Rules for value determination for Contract
Account Profile.
2. Click Add Row to add rules.
3. Enter the following input fields:
○ Contract Account Category
○ Account Determination ID
○ Contract Account Class
Enter the Profile ID as output field.
If you make changes to your profile, you must adjust the rules accordingly.
4. Click Save.
5. Under Actions, click Activate Rules.
Note
If the cards and tabs are hidden by the administrator, they are not visible even if you select them using
profile configuration.
Customer screens include a large scope of utilities solution. When you scope utilities industry in the business
configuration scoping, you will see a standalone workcenter for Utilities in the workcenter menu. Further,
customer is also scoped with utilities specific screens.
● Utilities 360
● Utilities Financials
● Utilities Contracts
● Utilities Service Orders
● Utilities Sales POD
Related Information
A 360 degree overview of the object hierarchy for all utilities objects.
The section for Highlights displays the overdue amount and total balance for a customer.
Note
If the contract account is a collective contract account (with multiple contract accounts within it), then the
hierarchy top node displays the collective contract account and the individual contract accounts are
included as sub-nodes for this collective contract account.
Note
If records for business partners are more than a hundred, an icon for More is displayed.
● The Highlights section displays account header information such as Overdue Amount and Total Balance.
● The hierarchy under Utilities Hierarchy reflects the nodes related to the selected contract account.
● If the contract account has a collective contract account, then the hierarchy top node displays the
collective contract account.
● Select and click on any object in the hierarchy to display further details in the section below. For example,
for a contract account, the Dunning Procedure and Payment Terms are some of the details displayed in the
details section.
● The contract account (or collective contract) account, premise, contract, installation and device are
displayed for each top level hierarchy node in Utilities Hierarchy.
Actions
● Confirm - You can confirm a contract account or a premise. When you confirm a contract account,the
same would be defaulted across different screens of the customer likeUtilities 360, Utilities Financials,
Utilities Rate Change , Utilities Collections , and Utilities Contracts . You can also confirm the collective
contract account and the same would be confirmed across the above mentioend screens of the confirmed
customer. Further, a field Confirmed Contract Account is displayed above the table with the confirmed
contract account ID. Note that this action is greyed out by default and is highlighted when you select a
contract account or a premise.
Note
The Confirm action is valid only until the logged in session of the individual customer is active.
● Unconfirm - You can unconfirm a contract account or a premise. When you unconfirm a contract account,
the Utilities Contracts and Utilities Financials tab screens no longer display only the confirmed contract
account details. Further the field that displays the confirmed contract account is no longer displayed and
the Confirm action is highlighted again.
The Unconfirm action is valid only until the logged in session of the individual customer is active.
● Create Contract Account - You can create a new contract account using this action in the Utilities 360
screen.
● Search - Search for a contract account, point of delivery or premise using this action. Note that search in
the Utilities 360 work center view performs an online search in the ERP system.
Recent Changes
The Recent Changes section displays a recent history for all objects in your solution.
View IS-Utilities contacts in the Recent History tab of the Utilities 360 work center view. All fields are display
and cannot be edited in the cloud solution. Fields displayed include Contact ID, Customer ID, Contact Class,
Action, Communication Mode and Type, Priority, Additional Info, Delete Flag, Text and Created Date and Created
Time. When you create move-in, move-out or transfer, the contacts created as part of these processes are
saved to the backend SAP ERP system and displayed in the Utilities 360 screen as IS-Utilities contacts.
Administrators must determine during implementation, what contact types from IS-Utilities be displayed in the
cloud solution. Further, a sample business add-in implementation is available to extend this feature.
As an administrator, you can configure to manage views for Recent Hisory and Hierarchy sections under
Utilities 360screen of a customer.
4. Click Save.
To configure the default view in the Hierarchy section , follow these steps:
4. Click Save.
The configurable hierarchy displays utilities object structure you have created in the SAP ERP system, in your
cloud solution.
Launch the configurable hierarchy from tool bar in Customer work center. Icons in the hierarchy help to identify
the different objects. Only one configurable object hierarchy can be active at any time.
The steps to creating the configurable object hierarchy are listed below:
1. In your SAP ERP-IS Utilities system, use transaction code ENVD to create a configurable hierarchy.
2. Next, assign the configurable hierarchy to IMG activity node Configure Object Hierarchy under SAP ERP
Implementation Guide Customizing SAP ERP SAP Utilities Cloud for Customer for Utilities
Configure Object Hierarchy .
3. Implement Web Service - COD_UTILITIES_CONF_HIER_GET. The COD_UTILITIES_CONF_HIER_GET
reads the profile from the IMG node and sends it to the SAP Cloud for Customer system
On the Utilities 360 page, you can select a configurable hierarchy view of an individual customer or an account.
To set the configurable hierarchy view as the default view in Utilities 360, go to the Administrator work center
and click Industry Settings Utilities Settings for Utilities 360 , and in the Hierarchy tab, select
Configurable Hierarchy.
Note
Selecting a default view for hierarchy overwrites all the adaptation or personalization settings. As an
administrator, you can clear the default view entry. This restores the previous settings.
After you assign FOP profile for configurable hierarchy (go to Administrator Industry Settings Utilities
Settings for Front Office Process , and assign mash up ID for Hierarchy), you can launch front office process for
a line selection on the Utilities 360 page.
Note
After assigning the FOP profile for configurable hierarchy, you must either reopen the Utilities 360 page of
the account or individual customer, or refresh the list, for the assignment to take effect.
Note
The search performed in the Configurable Hierarchy view is independent of the search perfomed in the
Hierarchy View or List View.
You can perform advance search using Premise, Point of Delivery, and Device fields in the Configurable
Hierarchy view to get the respective hierarchies.
On the Utilities 360 page, you can select a list view of the 360 hierarchy of an individual customer or an
account. By default, the hierarchical view is selected for the objects.
The table view has no limit on the number of records to be displayed. You can confirm or unconfirm both the
contract account and premise on the same line item. When you click a line item, all the details related to the
objects are displayed in the area under the list or hierarchical view.
View IS-Utilities contacts in the Recent History tab of the Utilities 360 work center view. All fields are display
and cannot be edited in the cloud solution. Fields displayed include Contact ID, Customer ID, Contact Class,
Action, Communication Mode and Type, Priority, Additional Info, Delete Flag, Created Date and Created Time.
When you execute ERP processes, the contacts created as part of move-in, move-out or transfer are saved to
the backend SAP ERP system and displayed in the Utilities 360 screen as IS-Utilities contacts. Note that the
contacts are created only for the processes that are configured in the ERP system.
The Financials screen shows a detailed overview of the business partner invoices, payments, open items,
installment plans, payment plans as well as the premise and contracts associated with the business partner.
Perform functions such as updating meter readings, invoicing, budget billing, installment plans, and so on, from
the various tabs in this screen.
In the Utilities 360 screen, if you confirm a contract account, then the same contract account is defaulted
for all actions in Utilities Financials.
A list of invoices created for the business partner and for each of which one or more corresponding billing
documents exists, are displayed in this section. Invoices are also grouped by contract account. Set a date range
to view the invoices of that time period. Some of the available options are Invoices From Last 1 Year, Invoices
From Last 90 Days, and Invoices From Last 7 Days.
Header Bar
The Customer Must Pay Amount in the header is the total amount the business partner owes to the utility
company while the Customer Total Balance is the sum of all unpaid invoices for which the due date has elapsed.
The contract account that you confirmed in the object hierarchy in Utilities 360 is defaulted in the financials
screen. You can also select a contract account in the header to display the latest Dunning Level for the account.
Item level dunning information such as Dunning Text, Dunning Level, and Dunning Step are shown in the Open
Items tab.
Click Contract Account Details to navigate to the confirmed contract account or filter and select another
contract account in the Filter Contract Account section.
● Open Items: The unpaid items for a billing document are grouped and displayed for each contract account.
You can also verify the document origin key and origin text displayed in the table. The menu offers creation
of document locks and installment plans for the open items.
● Premises: Displays a list of premises tied to the customer.
● Installment Plans
● Payments
● Payment Plans
● Contracts with Meter Reading: This section displays all contracts for the customer with their meter
readings. Select a row to display all recorded meter readings for the selected contract account. Add new
meter readings here or even edit the existing entries. The locks table displays the locks for a selected
contract.
A synchronous call to the SAP ERP IS-Utilities gets initiated the first time the Utilities Financial in customer is
loaded. When you navigate between different tabs (Open Items, Invoices, Payments, and so on) the data is
retained; A fresh call to IS-U is made during initial load or if a separate contract account is selected.
A new service to IS-U is also initiated when you perform specific action in one of these tabs. For example, when
you perform any action in Payments or Open items tab and navigating to Invoices initiates a service call to IS-U.
The table contains detail information on the tab screens and actions that initiate a call to IS-U.
Utilities Contact Center offers comprehensive features for bill correction. These include bill reversal
(Adjustment and Full Reversal), rebill and invoicing document locks. Use bill correction to perform reversals,
modify meter reading and display the updated invoices from the ERP system.
Transaction Function
Reversal is the first step to bill correction. The Utilities Contact Center supports adjustment and full reversal for
invoice documents.
For both adjustment and full reversal, you need to specify reversal reasons. You must maintain the reversal
reasons in the fine tuning under Business Configuration Open Activity List Utilities . The reversal
reasons that you maintain in the fine tuning must be the same as those configured in the IS-Utilities.
Note
When you reverse an invoice or line items in an invoice, the invoice is marked as reversed (marked as 'X')
and a reversal document is created and sent to ERP IS-U system. Additionally, a new row is created in the
Balances table for the the updated invoice from ERP IS-U.
You can perform adjustment reversal only on the complete billing document. When you adjust reverse a bill, a
new bill with amount as negative is created under the invoice. On a reversed bill, you can also update the meter
reading and subsequently rebill the invoice. This will generate new bills with the latest amount. Follow these
steps for adjustment reversal:
1. Select the billing document (select the row that has the contract ID displayed) in the Invoice History table
of the Utilities Financials tab screen. When you select a billing document, the Bill Correction action gets
enabled.
2. Click Actions Bill Correction .
3. Select a valid reason for reversal.
4. Click Adjustment Reversal.
5. Click Meter Reading. A new window appears with the device and meter reading details.
6. Save the meter reading.
Full Reversal
Use full reversal to reverse an invoice line item. When you full reverse, a new invoice with amount as negative is
created for the contract. On a reversed invoice, you can also update the meter reading and subsequently rebill
the invoice. This will generate new invoice with the latest amount. Follow these steps for full reversal.
1. Select the invoice line item (select the row that has the Invoice No displayed) in the Invoice History table.
Note that you can perform a full reversal only for individual line items of an invoice document.
2. Click on the bill correction
3. Enter the reversal reason
4. Click on the Full Reversal and the invoice line item is reversed.
5. Click on Meter Reading. A new window appears with the device and meter reading details
6. Save the meter reading.
1.2.7.2.1.2 Rebill
Rebilling is required if you have made an adjustment or full reversal of invoice line items or an invoice. You need
to therefore use rebill to update the meter readings for reversed invoices. If you do not rebill, invoices are
generated for the previously available meter readings.
When you click Rebill, the Meter Reading is enabled and it allows update of meter readings for the invoice line
items or invoices .
If you are creating an invoice with a meter reading, the Create Invoice dialog also displays the periodic meter
readings for the contract account. If there are no periodic meter readings, an interim meter reading order is
created. Follow these steps to create an invocie with meter reading:
Note
Note
The utilities screens have been enhanced to create and change all the meter reading screens to
consider device information record.
The Bill and Invoice helps you to invoice and bill at one go as soon as a valid meter reading is posted. This
option is available even when there are no billing documents unlike the Invoice that invoices only if billing
documents exist.
When you click Bill and Invoice, all contracts for the contract account and all billing documents for a contract
(that have not yet been invoiced) are automatically selected. Billing documents and invoices get generated for
the selected contracts.
Note
Only the following three meter reading reasons are available for Bill and Invoice: 01 - Periodic Meter Reading,
02 - Interim Meter Reading with Billing, and 09 - Interim Meter Reading without Billing.
This section displays a list of payment document numbers for which payments have been made. The following
payment types are supported in your utilities solution:
● Payment Lot
● Payment Run
● Payment Specification (Displays under the Open Items tab)
● Payment from Cash Desk
In the Payments table, filter for payments based on payment date. The Payments table displays the following
details:
The Payments tab displays the status of payments such as scheduled, posted, and reversed. You can also
cancel a scheduled future payment.
Use the Utilities Financials tab of an individual customer to make a one time payment with the existing or new
bank account.
The tab displays the default contract account ID. However, you can select a different account number in the
One Time Payment window. If you select a different account number, the amount and bank details, related to
the selected contract account, are updated accordingly.
The One Time Payment button can be controlled through business actions. For more information about
business actions, see .
The new bank account created as part of this process is stored at the business-partner level and is not
associated with the selected contract account.
In the Utilities Financials tab screen, for the first section on Open Items, use Actions Create Locks to
create new locks. You need to specify the lock type, reason and duration for the lock.
The selection values for lock types and lock reasons are displayed from the IS-Utilities configuration.. The lock
types Dunning, Payment, Posting and Interest locks are supported for Utilities Contact Center solution. When
you set a lock, the symbol for lock is displayed against the open financial document. You can choose to set one
or more locks on a financial document.
To edit or delete lock, click the document lock icon for an open item line. In the dialog box that appears, select
the row for a lock and click Edit, Delete, or Cancel to perform the corresponding action.
The Utilities Contact Center solution supports create, change, and deactivation of an installment plan. All
installment plans for a business partner are displayed in the Installment PlanUtilities Financials tab screen.
1. Under Utilities Financials Installment Plan , click Create Installment Plan to create a new installment
plan.
2. In the Create Installment Plan dialog, select the contract account for which you want to create an
installment plan. On selection of a contract account, the open items are displayed for the contract account.
3. Select one or more open items in the list. The total amount for the installment plan is displayed below the
table. The total amount is the sum of the selected open invoice items.
4. Select an installment Plan Type. Based on the plan type that you select, values for Plan Category, No. of
Installments, Installment Interval, Interval Type, and Amount are defaulted. You can modify these defaulted
values.
5. Enter a start date for the plan.
6. Simulate: When you select Simulate, the list of installments along with the respective due dates is
displayed in the Confirm Installment Plan dialog screen. You can also modify the simulated data; for
example, you can change amount or due date for any of the individual installments in the list.
7. Click Save to save the installment plan.
You can modify the amount for unpaid installments, number of installments and the due date for payment for
an installment plan.
When you change the installment plan amount, the total variance amount is displayed in the Calculated
Variance dialog screen.
Select an installment plan and specify the reason for deactivation and the deactivation date if you need to
cancel an existing installment plan. If you don’t specify a date, the current date is defaulted for deactivation.
In the Invoice History section in the Utilities Financials screen, click on the hyperlink for the field Invoice No to
display the PDF document for the invoice.
Create, edit, display and deactivate payment plans from the Payment Plans tab in the Financials screen.
Payment Plan
The payment plan displays the Payment Plan ID, Type, Contract Account ID, Alternate Starting Month, Status,
Division, Validity, ' and so on. If you have confirmed a contract account in the Utilities 360 screen, the same is
defaulted for the new payment plan and the related contracts are displayed for selection. The system first
creates a proposal based on the previous monthly consumption bills. Edit the amount or go ahead to confirm
and save the payment plan.
Available actions include Create, Edit, Display, and Deactivate payment plans. Edit option allows you to change
the text and amount for the payment plan. The Payment Plan Type BBP is defaulted for payment plans created
in your utilities cloud solution. A new icon highlights the status for a payment plan. The same prerequisites that
apply for creating payment plan in SAP ERP IS-Utilities solution also apply in the utilities cloud solution.
When you confirm deactivation for a payment plan, the system performs displays the confirmation message
and performs the following actions::
● Displays the last invoice number of the contract for the field Deactivated . The field is blank if no invoice
exists.
● Deletes the starting month for the plan in the ERP system.
● Displays the Deactivated status icon for the status field.
● Displays the deactivation date for .
Create and update meter readings in this section. On selection of a contract in the table for Contracts, the
corresponding values of existing meter reading are listed in the meter reading table.
You can add new meter readings for each of the services corresponding to the service address of the contract.
Along with the meter reading, you will need to specify the meter reading type, date and select a meter reading
note type. On saving your entries, a confirmation message is displayed in the cloud solution and the
corresponding meter readings are updated in the ERP system.
Note
Meter reading is not mandatory for move-in, move-out and transfer.,You can create move-in, move-out and
transfer without specifying meter readings.
Note
All the field help values such as meter reading note type / reason / meter reading type are updated using
the auto code list mapping. See Related Information section below for the topic Code Lists Mapping.
Note
Meter Reading Reason and Note can be defaulted by implementing the post badi for FM
COD_UTILITIES_VALUE_HELP in the ERP system
You can now enter or estimate an interim meter reading with or without billing. You must specify the
appropriate meter reading reason and type.
Additional features for meter reading: If you enter an incorrect meter reading (meter reading not in the
expected range), the meter reading is considered as Implausible. Any meter reads in processing status 2 are
considered as implausible but will nevertheless be saved.
● Estimate - Use this option to estimate the meter reading and consumption for an installation.
● Override - Use this option to save an implausible meter reading by overriding the error.
● Reset - Use this option to clear all the meter reading values and you can enter fresh data.
The meter reading table displays a combination of meter reading result and meter reading order, sorted by
date, device and registers. Create a meter reading result for a meter reading order. Customer receives a bill
only if meter reading order is available for the period.
Characteristics of MR Order:
● View meter reading orders in the meter reading table in Utilities Financials tab and under Premise (work
center) Connection Details (tab) .
● Edit meter reading orders in the Utilities Financials tab for customers and in the Connection Details tab in
the Premise work center.
● In the meter reading table, a highlighted tick mark in the MR Order column indicates that meter reading
order is active and scheduled. An active meter reading order is in status Meter Reading Order Created and
it is possible to add new meter readings and edit the line item.
● A grayed out check mark indicates the meter reading has already been recorded for the order. It is possible
to create new meter reading only for the following meter reading reasons: 02- Interim meter reading with
billing and 09-Interim meter reading without billing.
● Edit a line item in the meter reading table is possible for both, an active meter reading order and for a
meter reading result. If meter reading is already maintained, edit is NOT possible for meter reading status
Billed.
Related Information
When you select Manual Posting, the dialog for creating a miscellaneous posting appears. In this dialog, you
can select a Contract Account, Amount and Posting Reason. Note that if you have confirmed a contract
account in the hierarchy in Utilities 360, the same is defaulted here. You can choose to change your selection.
Use Reversal to reverse open items. You can select specific open items for reversal so that they appear on the
account status of a customer.
The Reversal option is available on the Open Items table under Utilities Financials screen and on the Account
History table under Utilities Collections screen of a customer.
Use Deferral to defer open items. You can select multiple open items for deferral.
The Utilities Collections tab displays the collection details of the selected individual customer.
You can view details such as total balance, must pay amount, credit worthiness, and security deposit related to
the customer. By default, the latest or the highest number of contract account is displayed. You can select a
different contract account if you want.
The Creditworthiness Details link displays the selected customer's creditworthiness in the past one year.
● Dunning History - Displays the dunning activity of the customer. As an agent, you can simulate dunning to
inform a customer about the next dunning step for an unpaid item.
● Correspondence History
● Account History - Use Reversal to reverse open items. You can select specific open items for reversal so
that they appear on the account status of a customer.
The Utilities Contracts tab screen displays the contract accounts and contracts attached to contract accounts
in a hierarchical view. In this tab screen, you can create, modify and display contract accounts, create a new
move-in, move-out for an existing installation, transfer a move-in, create a meter reading and edit meter
readings for existing contracts.
In the Utilities Contact Center, you can create and update meter readings. On selection of a contract in the
table for Contracts, the corresponding service addresses along with existing meter reading values are listed in
the meter reading table.
You can add new meter readings for each of the services corresponding to the service address of the contract.
Along with the meter reading, you will need to specify the meter reading type, date and select a meter reading
note type. On saving your entries, a confirmation message is displayed in the cloud solution and the
corresponding meter readings are updated in the ERP system.
Tip
The meter readings in the Utilities Contracts tab screen are displayed only for the previous one year
calculated at the current date. But the meter readings in the Utilities Overview and Utilities 360 tab screens
display meter readings only for the last five transactions.
Note
Meter reading is not mandatory for move-in, move-out and transfer. You can create move-in, move-out and
transfer without specifying meter readings.
Note
All the field help values such as meter reading note type / reason / meter reading type are updated using
the auto code list mapping. See Related Information section below for the topic Code Lists Mapping.
You can now enter or estimate an interim meter reading with or without billing. You must specify the
appropriate meter reading reason and type.
Additional features for meter reading: If you enter an incorrect meter reading (meter reading not in the
expected range), the meter reading is considered as Implausible. Any meter reads in processing status 2 are
considered as implausible but will nevertheless be saved.
● Estimate - Use this option to estimate the meter reading and consumption for an installation.
● Override
● Reset - Use this option to clear all the meter reading values and you can enter fresh data.
The meter reading table displays a combination of meter reading result and meter reading order, sorted by
date, device and registers. Create a meter reading result for a meter reading order. Customer receives a bill
only if meter reading order is available for the period.
Characteristics of MR Order:
● View meter reading orders in the meter reading table in Utilities Financials tab and under Premise (work
center) Connection Details (tab) .
● Create and edit meter reading orders in the Utilities Financials tab for customers and in the Connection
Details tab in the Premise work center.
● In the meter reading table, a highlighted tick mark in the MR Order column indicates that meter reading
order is active and scheduled. An active meter reading order is in status Meter Reading Order Created and
it is possible to create new meter readings and edit the line item.
● A grayed out check mark indicates the meter reading has already been recorded for the order. It is possible
to enter new meter reading only for the following meter reading reasons: 02- Interim meter reading with
billing and 09-Interim meter reading without billing.
● Edit a line item in the meter reading table is possible for both, an active meter reading order and for a
meter reading result. If meter reading is already maintained, edit is NOT possible for meter reading status
Billed.
Note
● If meter readings are blank, then meter reading orders are created for meter reading reasons 02 and
09.
● When creating meter reading for Register1, the system automatically creates meter reading orders for
all other registers associated with the equipments.
Following new validations are available for guided processes (move-in, move-out and transfer)
● New Validate action on the UI for move-in meter reads in guided processes.
● A new status indicator shows if the meter reading has been successful or is errored.
Use Validate UI action to validate meter readings in guided move-in, move-out and transfer.
Related Information
The Utilities Service Orders view screen displays a list of service orders for the selected customer.
Service order details include the service order number, contract account, contract, division, reason, date and
status.
Note
If you check the flag Create Service Order during move-in create, a new service order is created for the
corresponding move-in. Refresh the list to view the new service order.
An agent can select an order code for a service order. This enables a better understanding of the purpose of the
service order.
Click New to create a new service order. Enter the details such as the service address, service type, start and
end date and time, service order type, functional location and all the required meter reading details. After
saving the entries, a new row is added in the Service Orders table.
Add additional notes to your service order descriptions up to 250 characters long. The Description itself cannot
exceed 40 characters. Also note that no formatting is available for the notes you create here.
Service Orders During Move-In, Move-Out and Transfer: You can set the flag for Service Order to trigger
creation of a service order for a move-in, move-out and transfer. After successfully completing the
transactions, you can verify that a corresponding service order is created in your cloud solution and in ERP
system.
You can only change the start and end date & time for a service order using the menu option Actions
Change Service Order .
To cancel a service order, you need to invalidate the start and end date & time accordingly using Actions
Cancel Service Order
.
View the current rate category and billing parameters for a customer's contract in the Utilities Rate Change
workcenter view under Customers. In this workcenter view, select a contract and click on Rate Change to:
● Modify the rate category using selection help on the field Proposed Rate.
● Modify the Valid From date. This date is defaulted to one day later than the last billing date. If no date is
specified, then move-in date of the contract is considered as the valid-from date.
● View the following information (represented as installation facts in the SAP ERP system):
○ Current Rate (you cannot modify the current rate but replace it with a new rate using the Proposed
Rate.
○ Last Billing Date (date of the last billed period; if no billed date is available, then the move-in date of the
contract is considered for Valid From date)
○ Installation (installation number)
○ Address (address of the connection object to which the installation is linked)
○ Division
○ Billing Parameters (this table displays the operand, operand description and operand category (such
as Amount, Factor, Integer, Discount, Quantity and so on).
Note
The following parameters/operands are not supported: Operand categories TQUANT, REFVALUE,
SEASON, RATE TYPE.
Simulate rate change in the Utilities Rate Change work center view. Click Simulate in the Rate Change dialog.
In the Rate Simulation dialog, you see details such as the scenario, default rate category, description, start and
end dates for bill period. The simulation result lists the billing amount for different rate categories. User can
change the dates and re-simulate.
In the Utilities Rate Change work center view, click Rate Change to navigate to the screen where you can
propose a new rate category. Once you are done with updates, click on Rate Change with MDT or Rate Change
based on implementation in your organization.
Administrators can configure the custom implementation using master data template for rate change. Go to
Business Configuration Implementation Projects Your Project Edit Project Scope Questions
Industry Solution Utilities and select the scoping question - Do you want to use Master Data Template for
Rate Change?
Use the Utilities Payment Data tab to view and update the bank details of an individual customer.
Note
The New and Edit buttons in the Bank Data section can be controlled from the business actions. For more
information about business actions, see .
Note
For security reasons, only the last four digits of the bank account number are displayed.
While updating the bank details, you can provide a reason for changing the details.
Note
In Edit Bank Details, if you do not enter a new bank account number or IBAN, the old value is considered for
these fields. Additionally, if you update the bank account number without updating the IBAN details, the old
IBAN details are deleted.
You can also delete the bank data by using the Delete option provided on the Bank Data table. If the bank is
assigned to any contract account, then you can unassign the bank using Unassign option, provided on the
Contract Account table or you can select the unassign and delete option provided under the Delete action.
The Contract Account Payment Method table in the Utilities Payment Data tab displays the payment details of
the contract account.
The Assign button on the Bank Data table allows you to assign the bank data to a customer with the payment
details. When you select a line item from the Bank Data table and click Assign, the Assign Contract Accounts
dialog box appears. Select the contract account for which you want to assign the bank data and save the
changes. You can also assign incoming and outgoing payment methods while assigning the bank details.The
entries appear in the Contract Account Payment Method table.
Note
The Incoming Payment Method and Outgoing Payment Method drop down menus display only the payment
methods that are related to the bank information.
The Utilities Owner Allocationtab of an individual customer displays all the properties that are owned by the
customer. For each property, you can also view the premise, installation and contract account details.
In the Utilities Service Notifications work center view in Customers , create, edit and even cancel a service
notification. The Create Service Order flag enables you to trigger creation of a parallel service order for a service
notification.
Following details are displayed for service notifications in the launch screen. Search for service notifications
using basic search parameters such as Notification ID, Premise External ID, Customer ID and Description.
Many other search parameters are added to the advanced search.
● Notification ID
● Notification Type
● Description
To these descriptions, you can add additional notes up to 250 characters long. The Description itself
cannot exceed 40 characters long. Also note that no formatting is available for the notes you create here.
● Code Group
● Coding
Note
Equipment ID is mandatory if you are creating service notification from the premise, particularly if you
want the service notification to trigger creation of a service order.
● Required Start
Note
The system validates the start date is on or later than the current date. An error message is displayed if
this validation fails.
● Required End
Note
The system validates the end date is later than the start date. An error message is displayed if this
validation fails.
● Customer ID
● Premise Address
● Premise Ext. ID
● Service Order ID
● Main Work Center
● Company Code
● Created By
● Created On
When creating the service notification, the customer is defaulted. You must enter the other mandatory values -
Premise Address, Start Date and Notification Type.
Note
An agent can select an order code for a service notification. This enables a better understanding of the purpose
of the service notification.
The Utilities Addresses tab helps you to view overview of addresses relevant for a customer.
The Utilities Addresses tab displays details of addresses relevant to the customer, along with the validity dates
and status.The Edit button on the All Addresses table allows you to edit the validity of addresses.
You can also view the corresponding usage types of the address selected along with the validity dates in the
Address Usages table.
Relevant BPEM cases are displayed in the Utilities Exceptions tabs in Customer and Premise, respectively.
The exceptions generated in a ticket can be viewed in the Document Flow tab of the ticket and also under the
Utilities Exceptions tab in Customers (for the selected business partner ID) and Premise (for the selected
premise ID). Only exceptions relevant for customers or for the premise are displayed in the table. Click on a row
in the table to display detailed information for an exception. Use search or advanced search criteria to filter for
specific exceptions.
In the Utilities Exceptions tab of a service ticket, you can add up to five objects from Configurable Hierarchy to
create an exception.
You can view the BPEM Case ID in Utilities-Exception Management section of the service ticket.
Business Partner Exception Management (BPEM) - Integration with SAP ERP or S/4HANA System [page 190]
The Utilities Communications Data tab helps you to view independent communication address details of a
customer.
The sections that appear on the Utilities Communications Data tab are as follows:
You can now create and edit address independent communication information such as phone numbers and
email addresses in the Utilities Communication Data screen of customer.
● If no independent comminictaion data available for the customer, then the table shows Addbutton and in-
case of alerady existing independent communictaion details, the table shows Edit button.
● You need to select the Do Not Useflag if the number is not in use.
● You can mark the phone number or email ID to be a primary one by using the Primary Telephone/Mobile or
Mainflags.
● You can not use Do Not Use flag, where only one data is available in the table.
View list of all phone numbers and email addresses related to the customer.
To enable Valid from and Valid to columns in the tables under Utilities Communications Data page, go to
Business Configuration Implementation Projects Your Project Edit Project Scope Questions Industry
Solution Utilities , and then select Utilities Call Center and Service. From Questions for Utilities Call Center
and Service, select Is Time Dependency for BP Independent Address Communication data enabled in ISU?
The Utilities Switch Document tab displays all the switch documents for a customer - irrespective of the
document status and type.
Sales POD is a point of delivery that you create in your SAP Cloud for Customer system. A new workcenter is
available for Sales POD.
Note
When you select the release flag for a new sales POD, it updates the status of the sales POD to Released
and subsequently the sales POD appears in the enrollment process..
You can
In the Sales POD work center, select the sales PODs and click Set Grouping under Actions.
Note
When the Sales POD is being uploaded using oData, it is mandatory to provide atleast one instance of
Grouping per Sales POD, in order to view the Sales POD in the Sales POD Work center.
In the Sales POD screen of Utilities view you can delete the Sales PoD, if the status is not set to Released.
You can also navigate to the selected Sales PoD screen and delete the grouping information if more than one
grouping entries are added under the same Sales PoD ID.
Note
To enable the feature for sales quote, you must scope the question Do you want to enable sales quote and
replicate point of delivery from your external application to your cloud solution?. This question scopes sales
quote, contract account, and PoD in product selection. Further, you must also maintain the pricing and
other standard configuration for sales quotes.
The New Quote Wizard guides the users through the steps from obtaining customer and premise information to
finally saving the quote and submitting the switch document. Utilities specifics processes and objects are
added to the standard SAP Cloud for Customer quotation process. For example, you can add multiple point of
deliveries at a time or fill in specific parameters such as contract account or payment terms to help with
product determination and pricing.
Utilities sales quotes process provides these options: API to external pricing or standard integration to SD
pricing in ERP system. Standard integration to create switch document as part quotation process and exits are
Customer
Since you launch the wizard from Accounts/Individual Customer Sales Quotes , the customer name is
defaulted in the quote. Since the quote is utilities specific, the document type is defaulted to Utilities Lean
Quotation and the category determination displays only Quote for Enrollment for selection.
Note
You can now create sales quote by launching the wizard from Contacts screen.
All involved parties including where the customer is a Bill-To or Ship-To are also listed here. Note that you must
enter a party with role Seller is mandatory for creating the quote using the wizard.
Premise
You need to use the advanced search to find premises. All valid premises for the customer in the cloud solution
are displayed for selection. All point of delivery (PoD) associated with the selected premise are displayed as
individual line items in the table.
Note
If the product that you have selected has no division attached to it, an error message is displayed that
product for item is missing. You need to ensure that the product that you select is assigned to a division.
Product Proposal
In this process step, you can select products for each PoD line item. You can also select multiple line items and
use Set Product to apply a selected product for all the PoD line items. Similarly, you can use Set Contract
Account and Set Service Date to set the selected values for multiple PoD line items.
Note
The selection values displayed for contract account are locally retrieved from the cloud solution.
The Switch Type and Switch View are fields from ERP system. You need to specify a switch type and switch view
for each PoD line item. The External PoD identifies the PoD in the ERP IS-U system.
Pricing determination is similar to that of a standard quote. You can also use Request External Pricing to fetch
external prices. For more information, see documentation for Pricing in the User Stories Guide.
Review
Review terms and conditions, total pricing and the contract header details such as customer, validity, campaign
validity for customer, mailing address, etc. The Total is the cumulative price for all PoD line items.
Save the new sales quote. Use Actions Submit to submit the quote to ERP. When you submit, a switch
document is created for each line item in ERP and a confirmation for the quote is sent back to the cloud
solution.
Note
Prospect Customers: When you create a quote for a prospect customer using the enrollment process, On
Submit of a quote in the quotation enrollment process, the prospect customer is confirmed as a customer
in the solution.
Status Management
You can now use Set as Lost or Set as Won options to set the status after submitting the quote. Set as Lost is
available as an action but Set as Won is set automatically when you submit the quote. Note that these options
will only be enabled if valid pricing information is available for the quote. The corresponding status for the
quote is updated based on these options.
Note
Update Switch Status: You can now trigger the update of swtich ID in the ERP system. Under Sales
Sales Quotes Products use Actions Update Switch Status to update the switch ID in ERP after
you submit the quote using the enrollment process. The on-premise ERP system triggers a notification to
the cloud solution to update the switch document ID.
Related Information
Business Benefits
With the integration of sales POD (Point of Delivery) with sales quote, you can:
In the guided utilities processes (created using guided activity floor plans), when you save and submit the
quote request, a corresponding quote is created and displayed in the quotes overview list. An ISU POD and a
corresponding switch document with the ISU POD are also created. In the Products screen of the quote, the
Market Communication Data section displays the Switch Document ID that is generated from the on-premise
backend system for the quote request.
Note
The standard POD table in ISU-EUIHEAD is enhanced with the field SALES_POD_ID so that the project can
store the corresponding Sales POD ID. This also updates the Sales POD in Cloud for Customer with
corresponding ISU POD ID.
Launch the front office processes that you have configured in your S/4HANA system from your utilities cloud
solution. The Launch FOP action in the Customers toolbar launches the front office process that you have
configured and assigned for your utlities solution profile. For more information, see Configuring Front Office
Process.
Note
In order to use the front office processes, you need to have a minimum version for WEBCUIF 731 and also
implement the note 1890755 .
In the guided move-in process, use the Create Move-In using MDT to use the master data template for creating
guided move-in. You will need this option if you have made custom changes to your move-in implementation
using the master data template. For more information on how to configure the master data template for move-
in, see the related links section below.
To use this feature, you need to scope the scoping question - Do you want to use Master Data Template for
Guided Move-In and Guided Transfer? under Business Configuration Implementation Projects Your
Project Edit Project Scope Questions Industry Solution Utilities Utilies Call Center and Service .
Select this question if you need to use the master data template implementation in order to build-in custom
changes to guided move-in and guided transfer processes. When you select this question, the system fetches
the MDT template for configuration. Further, as part of guided move-in, you will see a new action Move-In using
MDT.
In addition to scoping, the administrator needs to adapt the screens to use the Move-In Using MDT option. Two
options are provided - Move-In (which is set as default) and the Move-In Using MDT.
Related Information
MDT Templates for Move-In, Customer, Contract Account & Rate Change Using Guided Processes [page 61]
The Create Transfer using MDT allows you to create a guided move-in using MDT template during the guided
transfer process. You will find this option in the Reivew tab in the guided transfer.
Note
During implementation, you need to select one of the UI options - Create Transferor Create Transfer using
MDT. It is not possible to include and implement both the approaches together.
Note
Existing contract account that you have selected is used in this process. However, if you select the option to
create a new contract account is created only for a move-in as part of the transfer (note that a contract
account is created only if you select the option to create a new contract account; selects for a new CA , else
existing CA which is selected by user will be used.. To enable this, maintain the required configuration for
MDT template. For detailed information, see MDT Templates for Move-In, Customer, Contract Account &
Rate Change Using Guided Processes [page 61]
In the Utilities Rate Change work center view, click Rate Change to navigate to the screen where you can
propose a new rate category. Once you are done with updates, click on Rate Change with MDT or Rate Change
based on implementation in your organization.
Administrators can configure the custom implementation using master data template for rate change. Go to
Business Configuration Implementation Projects Your Project Edit Project Scope Questions
Industry Solution Utilities and select the scoping question - Do you want to use Master Data Template for
Rate Change?
The Create Customer in the guided move-in allows you to create a new individual customer or account using
MDT. You will find this option in the Customer & Premise tab in guided move-in. Create a new customer by
enabling New Individual Customer or New Account flags. This enables the Create Customer in the toolbar. When
you enable creating a new individual customer or account, the creation dialog appears. The feature uses MDT
processes to allow a guided process experience in creating a new customer/account.
To enable this, maintain the required configuration for MDT template. For detailed information, see MDT
Templates for Move-In, Customer, Contract Account & Rate Change Using Guided Processes [page 61]
The Create Contract Account in Customers allows you to create a new contract account using the guided
transfer process. You will find this option in the toolbar for customers.
Note
To enable this, maintain the required configuration for MDT template. For detailed information, see MDT
Templates for Move-In, Customer, Contract Account & Rate Change Using Guided Processes [page 61]
A new UI option - Edit Contract Account is provided. Use this option to edit your contract accounts. This
navigates to the Edit Contract Account dialog screen where you can modify and save your entries.
You can configure separate master data templates for move processes and installations.
In the guided move-in process, Create Move-In using MDT allows you to use different master data templates for
each of the installations in the Premise to create separate move in documents. You need to implement the Pre-
Badi to specify a different Master Data Template for each of the installation as per requirement.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and select Utilities Call
Center and Service.
In the Questions for Utilities Call Center and Service section, under Master Data Template, select the Do you
want to use a different master data template for each installation within guided move-in/guided transfer?
question.
Account Executive Dashboard contains information tiles to show corresponding list view of configured object
for the user’s key accounts.
To set up key accounts you can navigate to Account Team tab in the customer screen and add the name of
account executive as Party Role Employee Responsible.
Note
The list displays the objects of the customers and accounts for which the logged in user is the Employee
Responsible.
Account Executive Dashboard contains informational tile to show all the new and in process service orders for
the user’s key accounts.
You can also use basic and advance search fields to select desired service orders.
Account Executive Dashboard contains informational tile to show all the new and in process exceptions for the
user’s key accounts.
You can also use basic and advance search fields to select desired exceptions.
The section Utilities - Exception Management is added to the Overview tab for tickets. Select a case category
from the value help (drop down) and then click Generate Exception in the toolbar to automatically create a
business partner exception management (BPEM) exception case in the SAP ERP or S/4HANA system. The
case category that you select here determines the main object assigned. Therefore, understand business need
of your organization before selecting the appropriate case category.
You can also track the exception case under Document Flow tab in the tickets.
● Define the required case categories in the finetuning under Business Configuration Implementation
Projects Your Project Open Activity List Utilities .
● Do you want to enable creation of BPEM Certification Case under Business Configuration
Implementation Projects Your Project Edit Project Scope Questions Utilities Contact Center and
Service Utilities Exception Management .
As a part of BPEM finetuning you can now configure your own clarification case categories by setting the
primary object type in the SAP ERP or S/4HANA system and maintain the same case category in Cloud for
Customer finetuning under Business Configuration Overview Utilities Case Category Maintain Case
Category .
Note
The validation takes place as per the primary object type maintained in Cloud for Customer and is skipped
even if it is maintained in SAP ERP or S/4HANA System.
As an administrator, you can configure replication of BPEM status to SAP Cloud for Customer, so that service
tickets are closed automatically on the completion of an exception that is linked with the ticket.
1 New
2 In Process
3 Completed
4 Canceled
6 Confirmed
The following table describes the SAP Cloud for Customer ticket user status:
1 Open
2 In Process
4 Customer Action
5 Completed
6 Closed
The default mapping of the BPEM case status to the SAP Cloud for Customer ticket user status is as follows:
BPEM Case Status Code SAP Cloud for Customer Case Status Code
1 1
2 2
3 5
4, 6 6
To register an event handler for the BPEM case in S/4H, in the SWE2 transaction code, do the following:
To register an event handler for the BPEM case in ERP, in the SWE2 transaction code, do the following:
If you want to change the default mapping the BPEM case status to the SAP Cloud for Customer ticket user
status, implement the following BAdI:
● In S/4H - isu_c4c_bpem_status
● In ERP - cod_erp_util_bpem_status
You can view the Contract Account, Premise and PoD details in the Utilities - Objects section group, under
Overview tab of service ticket screen. You can also navigate to the respective contract account and premise
using the hyperlinks.
A detailed Service Location section is now available in the Overview tab of ticket based on the premise selected.
This enables visibility to the field level information for the selected premise.
You can now use the logs in ERP system to track updates performed in the Utilities Financials screens.
Use transaction code AUT10 to view a log of all the updates performed in your utilities cloud solution. Use
change object ISUC4C_FIN to view the updates. You can also enter a specific date or date range to look up for
the updates in the log.
To avoid confusion while searching for the change documents due to the duplication in CDHDR & CDPOS log
tables, a new table COD_UTIL_AUDTLOG has been introduced for capturing the change documents.The main
technical enhancements include:
● Creation of new table COD_UTIL_AUDTLOG to maintain the standard change document number, Cloud for
Customer user name, logical system, creation date & creation time.
● Standard change document number will act as a link/foreign key between standard log tables (CDHDR &
CDPOS) and Cloud for Customer specific new table.
● Duplication of log table entries is avoided.
Depersonalization is only available for users with access to the Data Protection and Privacy work center.
The Data Privacy Management tab allows those responsible for data protection issues in an organization to
respond to personal information removal and disclosure.
Various considerations apply for deletion of personal data in contract accounts and sales POD. These are:
● When a business partner is deleted in your solution, the corresponding business partner ID in contract
account and sales POD are depersonalized or removed.
● When logged in with data privacy officer (DPO) authorizations, the Delete icon is displayed to the DPO in
contract account and sales POD work center views. These users can use this option to delete a contract
account or sales POD,
● If a sales POD/contract account are used in a sales quote, then they are blocked for deletion and hence
sales POD or contract account cannot be deleted in the system.
● Similarly, if a business partner is blocked for deletion, then the assigned sales POD or contract account are
blocked for deletion.
Transaction Function
Transaction Function
1.3 Extensibility
You can extend both the UI screens and the functionality for Utilities Contact Center using the extensibility
framework.
Use PDI extensibility framework to extend UI screens. For functional extensions, SAP predelivers Business Add-
Ins that you can implement to add or modify features.
Note
You cannot add a KUT field with default value for Utilities Contact Center.
Utilities Contact Center provides business add-ins for both the IS-Utilities backend system and the cloud
solution backend that you can implement for functional extensions.
All the Extensions mentioned in this section extend the Utilities Extensibility BO. The following processes
extend the Utilities Action BO (not Utilities Extension BO):
The following actions of Guided Application Framework can be extended using UtilitiesActionBO. Pre-
Validations are also possible for these actions.
● Move-In
● Move-Out
● Transfer
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Note
You can use the same implementation for display and edit of contract blocks. For display, the parameters
required are CUSTOMER_REMOTE_ID, CA_REMOTE_IDType and UTIL_CONTRACTS_TAB. For edit,
additional parameters include UTIL_CONTRACTS_OLD_TAB, ACTION_CODE and
UTILITIES_MESSAGE_TAB. Note that action code 03 has to be set after the BAdI implementation for edit of
contract blocks.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Note
The same implementation can be used for Create, Edit and Display of contract account locks. For display,
the required parameters are UTIL_CA_LOCKS_TAB, CONTRACT_ACCTID and CUSTOMER_ID. For create,
additional parameters include ACTION_CODE and UTILITIES_MESSAGE_TAB. Note that the action code 02
has to be set after the BAdI implementation for create of contract account locks. For edit, the same
parameters as that used for create (display + create) apply apart from an additional parameter -
UTIL_CA_OLD_LOCKS_TAB. Note that the action code 03 has to be set after the BAdI implementation for
edit of contract account locks.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Note
The same implementation can be used for Create, Edit and Display of contract locks. For display, the
required parameters are UTIL_CONTRACT_LOCKS_TAB, CONTRACT_ACCTID, CUSTOMER_ID and
CONTRACT_ID. . For create, additional parameters include ACTION_CODE and UTILITIES_MESSAGE_TAB.
Note that the action code 02 has to be set after the BAdI implementation for create of contract account
locks. For edit, the same parameters as that used for create (display + create) apply apart from an
additional parameter UTIL_CONTRACT_OLD_LOCKS_TAB. Note that the action code 03 has to be set after
the BAdI implementation for edit of contract locks.
1.3.1.2 Financials
List of business add-ins for the functionality under Utilities Financials work center view.
Account Overview
Use this business add-in exit Utilities Financial Account Overview to extend the Account Overview service
with financial specific data. The input provides the customer remote object ID, date range filter, filter flags for
data and filter for confirmed objects. The output expected should contain data (If available) for at least: the
following: Invoice History, Payments, Total Balance, Overdue Amount, Open Items, Installment Plan, Contract
Account, Installments.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this business add-in exit to implement an alternative approach to reversing an invoice. Note that the
appropriate messages must be created through the output message structures.
Enhancement Imple
mentation Business Object Namespace Input Parameters Output Parameters
● InvoiceNow
● BillNow
● InvoiceSimulation
● SubmitMR
● InvoiceMR
● BillAndInvoice
● FullReversal
● AdjustmentReversal
● Rebill
● UpdateMR
If the FullReversalflag is set to true, then the ISU service shall be triggered after the badi call. For example, If
FullReversal flag is set to ‘True’, then the ISU service shall be triggered for Full Reversal after this Badi is
executed.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI exit for an alternative approach adjust reversing a billing document. Note that the appropriate
messages must be created through the output message structures.
● InvoiceNow
If the AdjustmentReversal flag is set to true, then the ISU service shall be triggered after the badi call. For
example, If AdjustmentReversal flag is set to ‘True’, then the ISU service shall be triggered for Adjustment
Reversal after this Badi is executed.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
This BAdI is responsible to fill in the retrieved meter reading results through the output. Use this BAdI to
implement a different approach to fetch meter readings for the corresponding invoice selected.
Use this BAdI exit to implement a different approach to edit and save the meter reading results. The
appropriate messages have to be provided through the output structures.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI exit for an alternative approach to the rebill function. The appropriate messages have to be
provided through the output structures.
● InvoiceNow
● BillNow
● InvoiceSimulation
● SubmitMR
● InvoiceMR
● BillAndInvoice
● FullReversal
● AdjustmentReversal
● Rebill
● UpdateMR
If the Rebill flag is set to true, then the ISU service shall be triggered after the badi call. For example, If Rebill flag
is set to ‘True’, then the ISU service shall be triggered for Rebill after this Badi is executed.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
The flag ExecuteService has been introduced in the output parameter UtilitiesFinancialsBadiInput. This flag
has the action parameter UpdateMR If the ExecuteService. UpdateMR is set to true, then the ISU service shall
be triggered after the BADI call.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI exit for implementing an alternative approach to perform the estimate functionality on meter
reading result. The appropriate messages have to be provided through the output structures.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI exit to implement an alternative approach to performing the override function on meter reading
result. The appropriate messages have to be provided through the output structures.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI exit to implement an alternative approach to fetch the locks for a corresponding open document.
The BAdI needs to fill the lock details through output structures.
New structure ExecuteService has been introduced in the input parameter UtilitiesFinancialLockBadiResult.
This structure has the below indicator flag:
● CreateLock
● DisplayLocks
● EditLock
If the DisplayLocks flag is set to true, then the ISU service shall be triggered after the BAdI call. For example, If
DisplayLocks flag is set to ‘True’, then the ISU service shall be triggered for Display Locks after this Badi is
executed.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI exit to implement an alternative approach to create the locks for a corresponding open
document. The appropriate messages have to be provided through the output structures.
● CreateLock
● DisplayLocks
● EditLock
● Delete
If the CreateLock flag is set to true, then the ISU service shall be triggered after the BAdI call. For example, If
CreateLock flag is set to ‘True’, then the ISU service shall be triggered for Create Lock after this BAdI is
executed.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI to implement an alternative approach to edit the locks for a corresponding open document. The
appropriate messages have to be provided through the output structures.
● CreateLock
If the EditLock flag is set to true, then the ISU service shall be triggered after the badi call. For example, If
EditLock flag is set to ‘True’, then the ISU service shall be triggered for Edit Lock after this Badi is executed.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI to implement an alternative approach to delete the locks for a corresponding open document.
The appropriate messages have to be provided through the output structures.
New structure ExecuteService has been introduced in the input parameter UtilitiesFinancialDelteLocksResult.
This structure has the below indicator flag:
● CreateLock
● DisplayLocks
● EditLock
● Delete
If the Delete flag is set to true, then the ISU service shall be triggered after the badi call. For example, If Delete
flag is set to ‘True’, then the ISU service shall be triggered for Delete Lock after this Badi is executed.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this add-in to implement an alternative approach for the function on installment plan. This exit needs to fill
the action code (mandatory) in the output structures to correspond the action performed in add-in. The
Success/Error message to be filled in UTIL_MESSAGE table in the exit. The appropriate messages have to be
provided through the output structures. This add-in handles the following actions as per the action codes:
● Edit
● Cancel
● Create
● Simulate
The above mentioned ‘Execute’ flag works in combination with the Action Code. If the execute flag is set to true
(for the corresponding action code), then the ISU service shall be triggered after the badi call. For example, If
Action Code is ‘2’ and ExecuteServiceIndicator. CreateInstallmentPlan is set to ‘True’, then the ISU service shall
be triggered for Create Installment plan after this Badi is executed.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameters Output Parameters
Use this add-in to implement an alternative approach to perform billing operations. This exit needs to fill the
action code (mandatory) in the output structures to correspond the action performed in add-in. The
appropriate messages have to be provided through the output structures. This add-in handles the following
actions as per the action codes:
The above mentioned ‘Execute’ flag works in combination with the Action Code. If the execute flag is set to true
(for the corresponding action code), then the ISU service shall be triggered after the BADI call. For example, If
Action Code is ‘01’ and ExecuteServiceIndicator. Submit_MR is set to ‘True’, then the ISU service shall be
triggered for Submit Meter Reading after this Badi is executed.
Enhancement Imple
mentation Business Object Namespace Input Parameters Output Parameters
Enhancement Imple
mentation Business Object Namespace Input Parameters Output Parameters
● CustomAction : flag
● ActionName : Text field
Enhancement Imple
mentation Business Object Namespace Input Parameters Output Parameters
Structure UtilitiesInvoices has been introduced in the input parameter UtilitiesFinancialActionsBADiInput and
output parameter UtilitiesFinancialActionsBadiResult.
● CustomAction : flag
● ActionName : Text field
The UtilitiesFinancialActionsBadiResult has the parameter SkipActions. When the SkipActions, ManualPosting
is set to false, then the ISU service shall be triggered after the BADI call.
List of business add-ins for the functionality under Premise work center view.
UtilitiesPremise
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI exit for extending the Premise Service. The input provides the Premise UUID and the Remote
Object ID, and the output expected should contain data (If available) for at least the following:
Note
1. The ID for an “Object Hierarchy” object of type “Installation / Point of Delivery” should be maintained
as "<INSTALLATION ID> / <POD ID>”, (Eg: “11678 / 20000012”)
2. The TYPE_CODE for objects in the object hierarchy must be maintained as follows:
2 Device
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI exit for implementing an alternative approach for cancelling a Move In or a Move Out action. The
appropriate messages have to be provided through the output.
Note
● The flag CANCEL_MOVE_IN_IMPL should be marked “true” if “Cancel Move In” has been implemented.
● The flag CANCEL_MOVE_OUT_IMPL should be marked “true” if “Cancel Move Out” has been
implemented.
UtilitiesPremiseEditMoveInMoveOut
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this business add-in exit to implement an alternative approach for editing a Move In or a Move Out action.
The appropriate messages have to be provided through the output.
Note
● The flag EDIT_MOVE_IN_IMPL should be marked “true” if “Edit Move In” has been implemented.
● The flag EDIT_MOVE_OUT_IMPL should be marked “true” if “Edit Move Out” has been implemented.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI exit to implement an alternate approach for Move In action. The appropriate messages have to be
provided through the output.
Note
UtilitiesPremiseMoveOut
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI exit to implement an alternative approach for Move Out action. The appropriate messages have
to be provided through the output.
UtilitiesInstallation
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this business add-in exit for extending the Installation Service. The input provides the Premise External ID
and the Installation ID, and the output expected should contain data for the provided installation (If available)
for at least: the following:
● Installation (UtilitiesInstallationDetails)
● Device (UtilitiesInstallationDeviceDetails)
● Meter Reading (UtilitiesInstallationDeviceRegisterDetails)
UtilitiesInstallationEstimateMeterReading
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this business add-in exit to implement an alternative approach estimating meter readings. The appropriate
messages have to be provided through the output. The output structure MR_ESTIMATES should contain the
requested meter reading estimates.
The flag ExecuteAction has been introduced in the output parameter UtilitiesInstallationBadiResult. This flag
has the estimate component. If the execute flag is set to true for estimate ,then the ISU service shall be
triggered after the badi call.
UtilitiesInstallationOverrideMeterReading
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this business add-in exit to implement an alternative approach for overriding meter readings. The
appropriate messages have to be provided through the output.
The flag SkipAction has been introduced in the output parameter UtilitiesInstallationBadiResult. This flag has
the override component. If the skip flag is set to true for override ,then the ISU service will not be triggered after
the badi call.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this business add-in exit to implement an alternative approach for updating meter readings. The
appropriate messages have to be provided through the output.
The flag SkipAction has been introduced in the output parameter UtilitiesInstallationBadiResult. This flag has
the update component. If the skip flag is set to true for update ,then the ISU service will not be triggered after
the badi call.
UtilitiesPremiseActions
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
UtilitiesPremiseDetails
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
1.3.1.4 Contracts
Overview of Business Add-Ins that exist for the Utilities Contracts work center view functionality.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
The ACTION_CODE value will be sent from the cloud solution to PDI to set the condition for BADI
implementation. After any BADI implementation, ACTION_CODE is to be sent back to the cloud solution to
determine the action for which the add-in is implemented.
Note
The display contract account is retrieved locally in the cloud solution using buffer and therefore BADI is not
implemented for display of contract account.
Note
The ACTION_CODE value will be sent from the cloud solution to PDI to set the condition for BADI
implementation. After any BADI implementation, ACTION_CODE is to be sent back to the cloud solution to
determine the action for which the add-in is implemented.
Move-In
Enhancement Imple
mentation Business Object Namespace Input Parameters Output Parameters
Enhancement Imple
mentation Business Object Namespace Input Parameters Output Parameters
Transfer
Enhancement Imple
mentation Business Object Input Parameters Output Parameters
Estimate
Enhancement Imple
mentation Business Object Namespace Input Parameters Output Parameters
Edit Move-In
Enhancement Imple
mentation Business Object Namespace Input Parameters Output Parameters
Enhancement Imple
mentation Business Object Namespace Input Parameters Output Parameters
Cancel Move-In
Enhancement Imple
mentation Business Object Namespace Input Parameters Output Parameters
Cancel Move-Out
Enhancement Imple
mentation Business Object Namespace Input Parameters Output Parameters
Enhancement Imple
mentation Business Object Namespace Input Parameters Output Parameters
Enhancement Imple
mentation Business Object Namespace Input Parameters Output Parameters
Override
Enhancement Imple
mentation Business Object Namespace Input Parameters Output Parameters
Enhancement Imple
mentation Business Object Namespace Input Parameters Output Parameters
Overview of Business Add-Ins that exist for the Utilities Collections work center view functionality.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
UtilitiesDunningHistory
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
UtilitiesAccountHistory
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
UtilitiesCorrespondenceHistoryActions
Business Add-In:UtilitiesCorrespondenceHistoryActions
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
UtilitiesWriteOffs
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
UtilitiesSecurityDepositActions
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
UtilitiesReturns
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
UtilitiesCreditWorthiness
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Overview of business add-in exits for service orders. BAdI exits are provided for service orders overview, create
and change. As the cancel service order pop up is just a text box, BAdI is not provided for cancel.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Note
The ACTION_CODE value will be sent from the cloud solution to the PDI to set the condition for BADI
implementation. After the BADI implementation, the ACTION_CODE must be sent back to the cloud
solution to determine the action for which BADI is implemented.
The flag ExecuteService is added in the input structure UtilitiesServiceOrderBadiInput and the ExecuteService
flag has below components:
● CREATE
● CHANGE
● CANCEL
Note
The ACTION_CODE value will be sent from the cloud solution to the PDI to set the condition for BADI
implementation. After the BADI implementation, the ACTION_CODE must be sent back to the cloud
solution to determine the action for which BADI is implemented.
Business add-ins for functionality available under Utilities 360 work center view.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
The hierarchy is built in the standard delivery. Use this BAdI exit for extending the Utilities 360 data fetch
service. The input provides the Customer remote object ID, filter flags for data as per POD, premise and
Contract Account. The output expected should contain data (if available) for at least:
Enhancement
Implementa Business Ob Input Parame Output Param
tion ject Namespace Interface Method ter eter
UtilitiesCustomerHistory
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
1.3.1.8 Alerts
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
UtilitiesBPEMActions
Business Add-In:UtilitiesBPEMActions
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
The flag SkipAction has been introduced in the parameter UtilitiesRateCategoryChangeBADIInput. If the skip
flag is set to true for override ,then the ISU service will not be triggered after the badi call
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
The flag SkipAction has been introduced in the parameter UtilitiesInstallationFactsBADIInput. If the skip flag is
set to true for override ,then the ISU service will not be triggered after the badi call
Overview of business add-in exits for switch documents created for utilities guided quote.
Use this business add-in exit for extending the functions for both create and fetch for the switch document
from the ERP system.
Enhancement Implementation
COD_UTILITIES_QUOTE_NOTIF_PORT
Use this business add-in exit for the enrollment process. Use this add-in to set the logical port for the
notification service that updates the switch document ID back to the cloud solution in the customer quote line
item.
Business add-in exit for extending implementation for product proposal in the enrollment process.
Use this Business Add-in exit to propose product for each line item in the Enrolment GAF based on existing and
custom fields available in quote. The input data has the UUID of the quote line item and the output should have
the quote line item UUID and the corresponding Product ID that has to be defaulted against that line item.
Customer Search
Use the Customer Search add-in to extend the customer search feature.
You can add custom fields to the Move In and Move Out tables under the Services step of GAF Move processes
by following the below process of Auto-mapping.
1. Add custom fields in Cloud for Customer and note the ES Names for the same.
2. Implement the post business add-in in ERP under Function Module COD_UTILITIES_VALUE_HELP.
3. Send the ES Name for each field in extension data
1. In the post bAdi implementation, populate the ES Name of the Cloud for Customer custom field in the
fieldname and corresponding value in fieldvalue.
Note
Auto mapping of custom fields is only applicable for element data types.
Note
New Contract Account Indicator and Mailing Address Indicator flags are released to be consumed in PDI.
These flags once set in PDI shall behave as per the logic in PDI (In After Modify Event - which would be
called every time a field changes on the UI).
Note
: Utilities Addressesand Utilities Communication Data screens have a common BADI. If the BADI is
implemented then data in both facets needs to be passed from PDI.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use the step-by-step guide to create projectspecific extensions for screens where online transactions are
involved. The Utilities Contact Center uses the PDI tool for creating UI extensions and does not support UI
extensions using KUT (the standard framework for UI extensions in SAP Cloud for Customer).
Note
UI extensions are possible only if a corresponding field exists and is also editable in the SAP Cloud for
Customer utilities solution.
For Utilities Collections tab, changes are made to the event handler of inport FromUtilitiesCollections. So, to
reuse the EC’s of Collections tab such as Dunning History, Correspondence History, Account History,
Returns, WriteOffs, and Security Deposit in different screens, the Inport FromContractAccount to be used.
Prerequisites
● Use the latest PDI tool whose version corresponds to the release version of SAP Cloud for Customer.
●
Create a new PDI solution, maintain the mandatory fields and save the new solution.
Under Installed Templates SAP Extension Business Object Extension , specify the name of the
extension object.
You have now added the extension object into your solution (as seen in the graphic below)
In the screenshot below, you will see the example for a contract node added with an extension field and another
extension field is added in the Meter Reading sub-node within the contract node. Note that since the contract
node is associated with move in /move out/ transfer, the extension field added here can be reused in the
contract table/move in screen/move out screen etc. This will complete the addition of extension field in the
SAP Cloud for Customer backend system.
To add the extension fields to UI screen, right click on the .xbo file extension and choose Enhance Screen (see
screenshot below) .
In the step 5, you opened the floor plans for the UI screens where you need to add the extension fields. This
opens up the UI designer.
In the UI desginer,
1. Select the section group/anchor where you want to add the new extension field
2. Click on Extensibility Explorer Tab Add Extension Field to List .
3. Select the extension field you want to add and apply.
Open the UI screen to see the new extension field (as seen in the screenshot below).
Since these UI screens involve online transactions, you need to create a service interface to ERP using web
service. To do this, upload the WSDL that is imported from the ERP and create the service interface under
Solution Explorer Add Item Service Integration External Web Service Integration .
For detailed information, see Web Services Quick Guide under http://help.sap.com/
saphelpiis_studio_1508/KTP/Products/bf889ebdf45d4dd19d4a0e0bd39a07fb/LibraryStructure/
SAP_BBD_Studio.html
To integrate the web service interface with ERP system, you need to create a communication scenario.
For detailed information, see the Web Services Quick Guide under http://help.sap.com/
saphelpiis_studio_1508/KTP/Products/bf889ebdf45d4dd19d4a0e0bd39a07fb/LibraryStructure/
SAP_BBD_Studio.html
As a next step, you need to select the valid business add-in implementation. You can do this under Solution
Explorer Add Item Implementation .
Sample BADI implementation looks like the screenshot below where we call the Service -> Get the Response ->
Map it to the extension field -> Display on the UI.
An implementation-friendly extensibility concept is available for utilities. The approach enables you to extend
your solution by extending standard tables and does not require any significant PDI or backend
implementation.
● Standard RFCs provided with a table-type structure where you can add extension data.
● Creating new RFCs and configuring WSDLs in PI system not required.
● No additional configuration required for outbound service creation in PDI.
To implement the BAdI in SAP Cloud for Customer, follow these steps:
1. Extend the Utilities Extensibility BO, using the SAP Cloud Application Studio.
1. Log on to the SAP Cloud Application Studio, add a new item, and then enter the name of .xbo.
3. Add the extension field to the node where the enhancement is to be implemented—use the following
business object etension code snippet to extend the invoice node with an invoice description extension
field.
The extension value is fetched from the ERP service BAdI implementation.
4. Extend the ERP ISU BAdI provided for the functional modules.
1. In the Display service do the following:
1. Create an active BAdI implementation for COD_UTILITIES_ERP_CUST_BADI of the
ISU_C4C_ACCOUNT_OVERVIEW web service.
The data sent from ERP is passed to the extension field from PDI, and displayed in SAP Cloud for
Customer:
The services listed in the following table are supported with new extensibility framework. For a list of all services
for utilities contact center, see the worksheet for Utilities in the Attachments tab under SAP Cloud for
Customer
For details on web services and corresponding UI to be extended, see SAP Cloud for Customer .
You can now create Custom Actions for the following options:
To implement custom actions in Disconnection Documents screen of Utilities Premisepage, follow these steps:
1. Create a custom action within the Extension Business Object for corresponding
node(UtilitiesDisconnectionDocuments is used here for reference)
3. Pass the custom action name (as per your preference; the name given here is “ActionNameTest”) to the
CallAction and activate the absl file as well as xbo.
4. Implement the corresponding action BADI and write custom action logic in it.
SAP Cloud for Customer Utilities Contact Center for S/4HANA edition helps you to optimize call center
operations using modern customer engagement tools for sales and service processes.
The contact center capabilities are fully integrated with S/4HANA IS-Utilities (IS-U) and SAP S/4HANA back
end and support seamlessly transition between the different support channels. Using this setup, all the utility
services performed in this cloud solution are updated correspondingly in the S/4HANA system.
The following table details the software compatibility matrix for SAP Cloud for Customer Utilities Contact
Center:
2011 SAP Cloud for Customer IS- S4H OP 2020 FPSO PI 7.31
Utilities
The Note 2987953 to be im Note
plemented for SAP Cloud for
Ensure that you have
Customer 2011 feature par
downloaded the latest
ity.
service packs listed here:
● XI CONTENT
SAP_BYD 2.40
(SP36 Patch 00)
(Interface Defini
tions for SAP Cloud
for Customer for
Utilities Contact
Center)
● XI CONTENT: IS-UT
805 (SP00) (S/
4HANA Interface
Definitions)
● XI CONTENT:
C4CS4_IC 100
(SP18 Patch 00)
(Mapping, Tem
plates, and Scenar
ios)
The topics below provide a detailed overview of the configuration required to setup the utilities contact center.
Related Information
Administrators can configure the utilities contact center using scoping, scoping questions, and finetuning
activities.
2.1.1.1 Scoping
To set up your SAP Cloud for Customer system to support Utilities Contact Center solution, scope your
implementation project accordingly.
Recommendation
SCOPING: When you scope an industry solution, the business configuration set attached to the industry
fetches only the mandatory workcenters and workcenter views. Note that this scoping does not include the
mandatory scoping for Cloud for Sales or Cloud for Service. Therefore, it is recommended that you scope
the other essential workcenters you may need for your industry solution, based on your business
requirement.
This section lists the prerequisites to configure the Utilities Contact Center.
The connection to S/4HANA system must be established before the on-boarding to SAP Cloud for Customer is
implemented.
For more information about integration with S/4HANA, see the standard integration guide.
The required configuration must have been set up in IS-Utilities in the S/4HANA system.
To begin scoping and to scope the solution, go to Business Configuration Edit Product Scope Industry
Solution Utilities , and then select Utilities Call Center and Service.
Many of the scoping elements are automatically selected and cannot be deselected. The Business
Configuration sets (BC Sets) defined for the utilities call center will be activated once you scope the Utilities
industry solution. Review the questions for the scoping elements and confirm your scoping.
For the Utilities integration with ERP, to replicate technical maste data, you must also select Maintain Installed
Base under Service Entitlement Management Registered Products and Installed Base Maintain
Installed Base .
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Quotation, select the Do you want to
enable utilities lean quotation and replicate point of delivery from your external application to your cloud
solution? question.
● Ensure that the sales quotes are enabled under Business Configuration Edit Project Scope Sales
New Business Sales Quotes .
● Scope the following under Communication and Information Exchange Integration into Sales, Service
and Marketing Processes :
○ Do you want to create follow-up documents for sales quotes from your cloud solution to an external
application?
○ Do you want to replicate sales quotes from an external application or solution to your cloud solution?
● Enable the You can use a template to send sales quotes to your customers scoping question under
Business Configuration Edit Project Scope Questions Sales New Business Communication for
New Business .
● Configure PoD replication (see documentation under Technical Objects Replication).
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Quotation, select the Do you want to
enable Internal Pricing for Utilities Lean Quotation? question.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Technical Master Data Replication, select the
Do you want to replicate point of delivery data from your external application to your cloud solution? question.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Technical Master Data Replication, select the
Do you want to use Premise External ID as the Internal ID in C4C? question.
As an administrator, you can configure the use of master data template to customize rate change in the
solution.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Master Data Template, select the Do you
want to use Master Data Template for Rate Change? question.
As an administrator, you can configure the use of master data template for guided move-in and guided transfer.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Master Data Template, select the Do you
want to use Master Data Template for Guided Move-In and Guided Transfer? question.
When you select this question, the system fetches the MDT template for configuration. You can also see a new
action named Move-In using MDT in guided move-in.
You can configure separate master data templates for move processes and installations.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and select Utilities Call
Center and Service.
In the Questions for Utilities Call Center and Service section, under Master Data Template, select the Do you
want to use a different master data template for each installation within guided move-in/guided transfer?
question.
As an administrator, you can configure the creation of BPEM clarification case from your cloud solution that is
completely integrated with your SAP ERP solution.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Exception Management, select the
Do you want to enable creation of BPEM Clarification Case? question.
As an administrator, you can implement the SAP S/4HANA edition for utilities solution in SAP Cloud for
Customer.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under S/4HANA Integration, select the Do you
want to integrate your cloud solution with SAP S/4HANA? question.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Security Deposit, select the Do you
want to enable Security Deposit at contract level? question.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Alerts, select the Do you want to
enable Alerts in Move Processes? question.
You can also enable the display of alerts in the expanded mode or collapsed mode through a scoping
question.To configure the scoping question go to Business Configuration Edit Product Scope Industry
Solution Utilities , and select Utilities Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Alerts, select the Do you want
expanded Alerts in Move Processes?
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Service Order/Notifications, select
the Do you want to use the order code for generating service orders? question.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Service Order/Notifications, select
the Do you want to use the notification code for generating notifications? question.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Enhancements, select the Do you
want to enable basic and advanced search for the Contract Account value help? question.
As an administrator, you can configure to use the meter reading history from the legacy move-in date, when the
legacy system is migrated to an EPR system.
Go to Business Configuration Implementation Projects Your Project Edit Project Scope Questions
Industry Solutions Utilities Utilities Call Center and Service . From Questions for Utilities Call Center and
Service, select Do you want to use the meter reading history from the legacy move-in date?.
View list of all phone numbers and email addresses related to the customer.
To enable Valid from and Valid to columns in the tables under Utilities Communications Data page, go to
Business Configuration Implementation Projects Your Project Edit Project Scope Questions Industry
Solution Utilities , and then select Utilities Call Center and Service. From Questions for Utilities Call Center
and Service, select Is Time Dependency for BP Independent Address Communication data enabled in ISU?
As an administrator, enable the time dependency for Business Partner to enable Valid from and Valid to
columns in the tables under Utilities Communications Data page.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Enhancements, select the Is Time
Dependency for BP Independent Address Communication data enabled in ISU? question.
As an administrator, you can now turn on an alternative title for contract account object based on scoping
question for easy and quick identification.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Enhancements, select the Do you
want to enable the contract account object labels to display external ID and name? question.
As an administrator, you can now turn on an alternative title for premise object based on scoping question for
easy and quick identification.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Enhancements, select the Do you
want to enable the premise object labels to display house number, street name, and house supplement?
question.
As an administrator, you can enable service location section in the ticket based on the premise selected. This
enables visibility to the field level information for the selected premise.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Enhancements, select the Do you
want to copy premise/PoD address fields to service location fields while assigning premise/PoD address to
service ticket. question.
Go to Business Configuration Implementation Projects Your Project Edit Project Scope Questions
Industry Solutions Utilities Utilities Call Center and Service . From Questions for Utilities Call Center and
Service, select Do you want to enable Manual Posting in ‘Utilities Financials’?.
Code values configured in ERP can be replicated using automatic code list mapping during initial load.
After the initial load replication,you can add or modify the code values in the cloud solution. Using the fine
tuning activity ( Business Configuration Implementation Projects Your Project Open Activity List Fine-
Tune Utilities ), you can maintain code values for the following:
● Tolerance Group
● Meter Reading Reason
● Meter Reading Type
● Order Type
● Payment Lock Reason
● Payment Terms
● Plant
● POD Service Type
● Pod Types
● Posting Lock Reason
● Premise Type
● Release Block Reason
● Reversal Reason
● Security Deposit Reason
● Switch Type
● Switch View
Note
If you update the code values in the ERP system, make corresponding updates to the code values in the
cloud solution and vice-versa.
As an administrator, you can configure a new Contract Account Work Center with value help capabilities for
advanced search fields.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Enhancements, select the Do you
want to enable the new contract account work center with value help capabilities for advanced search fields?
question.
As an administrator, you can enable the Additional offering step to add external products in guided move-in.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Move Process for S/4, select the Do you want
to enable the automatic creation of sales quote during create Move-In? and Do you want to display the
“Additional Offering” step for selecting Sales Product during create Move-In?questions.
As an administrator, you can configure to use premise basic search in live activity.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Business Option, select the Do you want to
enable basic search for the Utilities-Premise Category in Enterprise Search and Live activity? question.
You can execute reports to transfer data from IS-Utilities system to the Utilities Contact Center cloud solution.
For more information, see Technical Objects Replication [page 297] and Contract Account Replictaion [page
300].
Maintain the call center agents who are the key business users in utilities contact center solution. Once you
have created employees, you must edit the business user attributes and access rights for the call center
agents.
The access rights for this user are described in the chapter on scoping.
COD_UTILITIES_WCF Utilities
Premise COD_PREMISE_WCVIEW
COD_SALES_WCF Sales
CODACCOUNTWC Customers
Note
The utilities specific screen -
Utilities Financials, Utilities 360,
and Utilities Service Orders are
available with this scoping.
CODACCOUNTWCV
Accounts
Contacts COD_CONTACT_WCV
After you add the tab, you can enable it as a side pane in screens. From the Adapt menu, select Company
Settings, and then select the Enable Side Pane in Fiori client checkbox.
When you enable the side pane, you can view alerts for a selected individual customer, account, or premise in
the right pane of the respective UI. The Alerts framework is also available at every stage of move processes.
You can enable the display of alerts in the expanded mode through a scoping question. To configure the
scoping question go to Business Configuration Edit Product Scope Industry Solution Utilities , and
select Utilities Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Alerts, select the Do you want
expanded Alerts in Move Processes? question.
As an administrator, you can configure scripts to display the terms and conditions for rate or service orders in
the move-in and move-out processes.
3. Click Save.
4. Go to Rules for value determination for Move In/Out Script, and set the rules for the script.
After the script is configured, the agent can launch the script during the move processes to agree to the terms
and conditions.
As an administrator, you can configure to manage views for Recent Hisory and Hierarchy sections under
Utilities 360screen of a customer.
4. Click Save.
To configure the default view in the Hierarchy section , follow these steps:
4. Click Save.
As an administrator, you can configure a safety message to reconnect the AMI smart meter.
On the Safety Message for Reconnect, you can manage the message to be mandatory or optional.
If the message is mandatory, when the user selects a device to reconnect, the message appears in the
Reconnect popup.
Assign the front office processes that you need to launch from SAP Cloud for Customer in the Implementation
Guide customizing.
Use
In the Implementation Guide (IMG) customizing for S/4HANA system, assign the relevant front office
processes that you need to launch from SAP Cloud for Customer to the utilities launch object in the S.4HANA
system. You will find the IMG for Cloud for Customer under IMGSAP Utilities This assignment enables you to
call up your Front Office processes in your cloud solution. Note that the launch object (of BOR object type) is
assigned to the following work centers in your cloud solution:
Prerequisites
You must have defined the required Front Office process in the IMG activity under SAP S.4HANA IMG SAP
Utilities Customer Service Front OFfice .
Related Information
To integrate the Smart Energy Water (SEW) with SAP S/4 HANA system, Communication Preferences and
Consumption Graph should be configured.
Follow the steps to configure Communication Preferences and Consumption Graph tabs from C4C.
Note
Note
Be sure to enter a mashup web service ID in the Configuration settings screen, or you won't be able to
view or edit the Contract Account communication preferences, and Consumption Graph.
2.1.2.1 Configure PI
The configuration required in PI system is documented in detail in the following topics.
In the PI system, execute the SXMB_IFR transaction code. This opens the PI system homepage from where you
can access the PI clients for Enterprise Service Repository, Integration Directory, and System Landscape
Directory.
Note
Ensure that you have always download the latest integration package from the SAP Service Marketplace.
http://help.sap.com/disclaimer?site=https://support.sap.com/software/patches.html
2.1.2.1.1 Prerequisites
Summary of the prerequisites for PI configuration
Note
You must create the required logical ports in the S/4HANA system. For more information, see Logical Ports
for Outbound Services for PI Integration under Configure Integration with S/4HANA.
The screenshots shown in this appendix are only examples taken from PI value mapping. They are not
complete from a PI configuration point of view. Please note that some of the code lists named below can be
enhanced or modified in SAP Cloud for Customer during finetuning.
<SID>CLNT<client number>, where SID is the system ID of Logical System name of the corresponding business system
the connecting S/4HANA/Cloud system.
The values of these mapping are used in the PI message mappings for the services
● S4_C4C_Utilities_BusinessAgreementReplication
● S4_C4C_Utilities_Tech_Objects_Replication
You need to download the standard integration package for SAP Cloud for Customer for Utilities Contact
Center from the SAP Service Marketplace to get started with the configuration required for integration with
SAP S/4HANA system.
1. Go to https://support.sap.com/software/patches.html .
Note
Ensure that you download the latest versions of all available support packages.
XI CONTENT SAP BYD XI CONTENT SAP_BYD 2.40 Interface Definitions for SAP Cloud for
Customer for Utilities Contact Center
You need to register the on-premise system in the System Landscape Directory. Systems are typically
registered in SLD when they are initially configured.
You need to import the standard integration content delivered for SAP Cloud for Customer for Utilities Contact
Center to your PI system.
You have already downloaded the ESR content to your local machine. Now you need to import this content to
the PI system in your landscape. Follow these steps:
1. Login to the PI 7.11 system and enter the transaction code SXMB_IFR to start the Integration Builder.
2. Under Enterprise Services Repository, click on Enterprise Services Builder.
3. To import the ESR content from local machine, go to Tools Import Design Objects Client and
provide the path to the local machine. Note that the file with ESR content is saved with a '.TPZ' extension.
Verify that the required web services are displayed under the relevant software components. If the import is
successful, you will see the list of outbound web services from SAP Cloud for Customer under SAP BYD 2.40
http://sap.com/xi/A1S/Global . Similarly, the S/4HANA web services are listed under COD_S4H_INT and the
mappings and templates for S/4HANA are listed under COD_S4H_INT.
Create a configuration scenario for the Utilities solution and perform the required configuration for all required
web services.
Perform the following steps to create a configuration scenario for your SAP Cloud for Customer for Utilities
Contact Center solution:
1. Go to Integration Directory Integration Builder and switch to the Configuration Scenario view.
2. In the menu bar, go to Object New and in the Object Create dialog box that appears, select
Administration Configuration Scenario ..
3. Enter a name for the configuration scenario with the prefix CS_C4CS4_UtilitiesIntegration and
select Type of ES Repository Model as Process Integration Scenario.
4. click on Create and save the configuration scenario.
Note
You will maintain the ID configurations for each of the web services in this configuration scenario. As
part of the ID configuration, you will perform the following steps for each web service:
1. Assign sender business system (that you have defined in the software landscape directory - SLD
configuration.)
2. Assign receiver business system
3. Create the following:
1. Sender communication channel (SOAP Sender) business system
2. Receiver communication channel (SOAP Receiver) business system
3. Receiver determination
4. Interface determination
5. Sender agreement
6. Receiver agreement
4. Activate change lists
Note
For detailed information on how to maintain ID Configuration for web services, see the topic
Example: ID Configuration for Web Service - BP Overview.
The sample ID configuration for Account Overview web service is provided here. Note that the screenshots are
provided only for reference.
2. In the Assign Business System dialog box that appears, click Select Business Systems (on the left hand
side of the screen). Select the business systems that you have configured in the SLD (Software
Landscape Directory).
Synchronous and asynchronous web services for the utilities solution must be configured.
For a complete list of the web services, see the worksheet for Utilities PI Services in the attachments section
under 2675745 .
Communication arrangements help you to configure the electronic data exchange between the cloud Utilities
Contact Center solution and the IS-Utilities in S/4HANA system.
Prerequisites
Procedure
Contact your system administrator for details of System Instance ID, Code List Mapping,
Authentication Method (user and password), Port, Cloud for Customer Business System ID, Cloud for
Customer Business System Client, and Communication System Client.
ERP Utility Management Integration ISU Configuration, S/4HANA Contract Account Replication,
Query, and Maintain S/4HANA Customer Info
Creation of Sales Quote Follow Up Document in SAP Busi Create Sales Quote Follow Up Document in SAP Business
ness Suite Suite
Creation of Sales Quote Follow Up Document in SAP Busi Notify Sales Quote of Sales Order Creation in SAP Business
ness Suite Suite
Industry Service Request Replication to External System Requesting service ticket creation from SAP Cloud for
Customer to S4/HANA
Service Ticket Delegation to SAP Business Suite This service is for BPEM notification. After the BPEM is cre
ated, S4/HANA sends confirmation to SAP Cloud for
Customer.
When a service gets triggered form SAP Cloud for Customer, a corresponding S/4HANA service gets executed
in S/4HANA through SAP Cloud Platform. Therefore, you need to create a binding in SOAMANAGER that
generates a calculated URL. This must be configured in the cloud platform receiver connector of cloud
platform.
2. In the field Object Name search for the inbound S/4HANA service name.
4. Enter the Service Name and Binding Name and then click on Next.
9. On the second line – click on the icon marked with the shown arrow:
10. The dialog as displayed in the screenshot appears. Here, you can see the URL for the WSDL. Copy this URL
as you need the upload this URL when configuring the SAP Cloud Platform Receiver communication
channel or Receiver Connector.
Here we have a URL for the WSDL – copy this URL as we will need to upload this url when we perform the
configuration in PI or HCI Receiver communication channel or Receiver Connector.
Note
You must have defined the required integration set-up to connect with S/4HANA and PI system.
1. Setup the PI value configuration to execute the utilities contact center S/4HANA specific web services. For
the list of web services, see the worksheet for S4H Utilities in the Attachments tab under 2597086 .
2. Define the PI value mapping between the cloud business system ID and the S/4HANA logical system ID.
3. Replicate the required business partners to the cloud solution. For more information, see http://
help.sap.com/mdg80/
It is recommended to use Master Data Governance (MDG) framework for replicating business partners.
4. Run the data replication reports to transfer data from S/4HANA to the cloud system.
Note
The contracts are replicated from S/4HANA system using an online call; there is no specific report to
be executed for replicating contracts to the cloud solution.
Related Information
Use the report COD_UTIL_BP_REP_LOAD_V1 to replicate business partner data in bulk with parallel processing.
You have the option to run the report with a dedicated server group to maximize performance. Set up a
background job and monitor the status with transaction SM37.
After executing the report, the output displays the details with the count of business partners processed if
executed in dialog mode. The parallel logs are also maintained which can be monitored in SLG1.
You can follow the steps to configure business partner replication via parallel processing from Clouud for
Customer to SAP ERP.
It’s recommendable to schedule the report as background job and monitor in SM37 for bulk data
processing.
MDT Templates for Move-In, Customer, Contract Account and Rate Change Using Guided Processes [page
292]
Utilities solution uses the MDT template for creating a new customer and contract account in guided
move-in and for creating a contract account (during move-in) in guided transfer and also for rate
change.
The steps to creating the configurable object hierarchy are listed below:
1. In your SAP S/4HANA-IS Utilities system, use transaction code ENVD to create a configurable hierarchy.
2. Next, assign the configurable hierarchy to IMG activity node Configure Object Hierarchy under SAP
Customizing Implementation Guide SAP Utilities Cloud for Customer for Utilities Configure Object
Hierarchy .
3. Implement Web Service - ISU_C4C_CONF_HIER_GET. The web service reads the profile from the IMG node
and sends it to the SAP Cloud for Customer system
Utilities solution uses the MDT template for creating a new customer and contract account in guided move-in
and for creating a contract account (during move-in) in guided transfer and also for rate change.
Note
For detailed information on the configuration, see the corresponding documentation for the IMG node
Configure MDT Template in the Implementation Guide configuration under IMG for SAP S/4HANA SAP
Utilities Cloud for Customer .
Follow these steps to configure MDT template for use in your utilities solution in SAP Cloud for Customer:
Prerequisites
1. Create an MDT template using transaction code EPRODCUST. You need to create the MDT template with
category assignment – NewCust (standard template delivered by SAP IS-Utilities). A series of hierarchical
nodes representing utilities objects (along with the field level assignments) is displayed in the template.
Utilities solution in SAP Cloud for Customer uses this assignment to create customer and contract account
in the guided process for move-in (creating customer and contract account) and transfer (creating
contract account).
2. Double click on a node to list the mandatory fields for an object (listed below in this document). You will see
that for each field name, you can update the Value. However, it is recommended to retain the naming
convention as given in the standard template. Note that you may assign different Services to these fields
depending on your business requirements.
If you need to add additional fields, ensure the naming convention mapping (as in the above screenshot) is
maintained in the pre-exit add-in method MDT_MVI_CREATE_PRE. Find details of the add-in below:
● BADI_COD_UTIL_MDT_MVI_CREATE
● IF_COD_UTIL_MDT_MVI_CREATE
● ISU_C4C_UTILITIES_MDT_MVI_CRT (MDT_MVI_CREATE_PRE and MDT_MVI_CREATE_POST)
For further details, see the documentation for the IMG activity in the SAP S/4HANA system.
A switch document is triggered when you complete a quote (using guided quote), review and submit it to the
S/4HANA system. This service is a webservice to service proxy asynchronous call. It triggers the creation of a
switch document from the cloud solution and creates the same in the S/4HANA system. It also triggers a
notification back to the cloud solution to update the quote line item with the switch document ID.
The service contains details from the Utilities Lean Quotation and also enrollment specific fields such as Point
of Delivery (PoD), Contract Account, Switch Type, Switch View and Old Supplier, etc.
Parameter Value
Communication Arrangement Scenario in cloud solution CREATION OF SALES QUOTE FOLLOW UP DOCUMENT IN
(MCPG) SAP BUSINESS SUITE
Communication Arrangement Service in cloud solution Create Sales Quote Follow Up Document in SAP Business
Suite
This service is triggered subsequent to the web service call for creating a switch document. After the the switch
document is successfully created, each quote line item shall have a corresponding switch document ID. This
switch document ID is then updated in the quote line items in the cloud solution using this service. The logical
port for this service is determined and the Default port is picked. However, this logical port can be overwritten
by implementing the business add-in COD_UTILITIES_QUOTE_NOTIF_PORT.
Parameter Value
Communication Arrangement Scenario in cloud solution Creation of Sales Quote Follow Up Document in SAP Busi
(MCPG) ness Suite
Communication Arrangement Service in cloud solution Notify Sales Quote of Sales Order Creation in SAP Business
Suite
In the S/4HANA system, you need to create logical ports with transaction code SOAMANAGER in order to send
web service calls to the PI or other middleware system. Follow these configuration steps:
You can now trigger the update of swtich ID in the S/4HANA system. Under Sales Sales Quotes
Products use Actions Update Switch Status to update the switch ID in S/4HANA after you submit the
quote using the enrollment process. The on-premise S/4HANA system triggers a notification to the cloud
solution to update the switch document ID
Assign the front office processes that you need to launch from SAP Cloud for Customer in the Implementation
Guide customizing.
Use
In the Implementation Guide (IMG) customizing for S/4HANA system, assign the relevant front office
processes that you need to launch from SAP Cloud for Customer to the utilities launch object in the S.4HANA
system. You will find the IMG for Cloud for Customer under IMGSAP Utilities This assignment enables you to
call up your Front Office processes in your cloud solution. Note that the launch object (of BOR object type) is
assigned to the following work centers in your cloud solution:
Prerequisites
You must have defined the required Front Office process in the IMG activity under SAP S.4HANA IMG SAP
Utilities Customer Service Front OFfice .
Related Information
Note
In order to use the front office processes, you need to have a minimum version for WEBCUIF 731 and also
implement the note 1890755 .
For more information on configuring front office processes, see the Related Links section below.
The reports listed in this section must be executed for transfer of data from IS-Utilities system to the Utilities
Contact Center cloud solution.
The following table provides a snapshot of the data replication supported for Utilities Contact Center.
Snapshot of Replicated Master Data and Utilities Technical Data in Cloud Solution
ner - MDG
Contract Ac Not Applicable Not Applicable Not Applicable Unidirectional Yes
(Only from IS-
count Online
Utilities to
Cloud Solution)
Contracts Not Applicable Not Applicable Not Applicable Not Applicable Not Applicable
ject (IS-Utilities to
Cloud solution)
(IS-Utilities to
Cloud solution)
Note
Implement this report if you have scoped the question Do you want to enable sales quote in your solution? .
Note that when you scope this question, you can create utilitiesspecific sales quote using the document
type Utilities Lean Quotation. In addition, you also enable replication of contract account and Point of
Delivery data in the business configuration.
Note
If you have not scoped the above question for sales quote, then you MUST execute the report
ISU_C4C_CONN_OBJ_PREMISE_REPL for replicating technical objects including premise, point of delivery
and connection object.
Note
To enable the feature to use the External ID as Internal ID in Cloud for Customer for premise you must
scope the question Do you want to use Premise External ID as Internal ID in C4C?.
Schedule periodic runs for the initial load report S/4HANA system to transfer the utilities technical master data
to the cloud solution. This report offers a single interface to replicate the following objects:
● Premise
● Point of Delivery (PoD)
● Connection Object
1. In the dialog screen for Utilities Technical Objects Replication, select and specify value in one of the fields -
Premise ID, Connection Object ID or Point of Delivery ID.
2. Specify the Logical Port ID.
Note
Language key will be set to sy-langu if empty. Also the From-Date will be set to today’s date if empty.
And the To-Date will be set to 31.12.9999 if empty.
3. Specify a number for the field Maximum Size. With the field “Maximum Size’ you can control how many
technical master data will be sent in a single message. The web service can upload several Connection
Object IDs, Premises and PoDs at once. Technical Master Data (Connection Object, Premise and Point of
Delivery) will be distributed accordingly.
Create or change of a connection object triggers delta replication. Follow these steps to trigger a delta
replication for connection object data:
Note
Creating or changing a connection object triggers the delta replication for connection objects.
Note
Creating or changing a connection object triggers the delta replication for premises.
Note
Along with the existing fields the District field is enabled for replication under the Premise.
Follow these steps to trigger a delta replication for point of delivery data:
Note
Creating or changing a connection object triggers the delta replication for point of delivery data.
This enables the replication of technical objects for Initial load with faster response time via parallel processing
technique.
This report provides the option to execute the replication in a dedicated server group which preferably has
ample work processes available in order to maximize the performance.
Once the report is executed , technical master data is replicated through proxy generation. We can view the
payloads generated for data in message monitoring via sxmb_moni.
Extensibility for Initial Data Replication Report and for Delta Replication
A Business Add-In (BAdI) to modify the standard implementation for the initial data replication report and for
the delta replication runs. This BAdI is called after retrieving the PoD. It allows to change the PoD data to be
replicated, to skip the standard checks and to skip the replication for this PoD.
To run any of the above mentioned reports in the S/4HANA system, you need to create logical ports with
transaction code SOAMANAGER in order to send web service calls to the PI or other middleware system. Follow
these configuration steps:
Contract Account Replication Report: ISU_C4C_ACCOUNT_EXTRACT. Use this report to replicate the contract
accounts to the cloud solution.
Note
Irrespective of whether or not you maintain the configuration for replicating contract accounts, the move in
screen displays all the contract accounts from S/4HANA that are linked to the business partner. Further,
the start date for contract accounts is defaulted to the current date.
Prerequisites
1. You have implemented the corresponding web service for contract account.
2. The following scoping question under Business Configuration Edit Project Scope Questions has
been scoped in your solution - Do you want to replicate contract account data from your external
application to your cloud solution?
Note
If you have scoped the question - Do you want to enable sales quote in your solution?, then you enable
the point of delivery data also to be replicated along with contract account.
1. You must always replicate a contract account using a business partner. To replicate a new contract
account, you can either create a new business partner or use an existing business partner in the cloud
solution.
Note
BP Replication using MDG: If you are replicating business partners using MDG, then in the PI mapping
for contract account replication, maintain the schema code 888 for MDG.
BP Replication using CVI: Similarly, if you are replicating business partners using Customer Vendor
Integration (CVI), then in the PI mapping for contract account replication, maintain the schema code
918 for CVI.
2. Configure the partner profile for IDoc type ISU_C4C_CONTRACT_ACCOUNT_REP01 q. For the partner
profile, you must
1. Add or subscribe to the message type – ISU_C4C_CONTRACT_ACCOUNT_REPL
2. Maintain the PI receiver port
3. Execute the IDoc.
3. A customer implementation of business partners using Master Data Governance (MDG) must be done for
replicating business partners.
Note
Note that the framework for business partner replication using MDG is recommend but is not part of
the standard delivery.
Note
The business partner ID must have 10 characters. If the ID has less than 10 characters, you must
add leading zeroes to the ID. For example, if the BP ID is 1234, you must enter the BP ID as
0000001234.
Note
○ Contract Account
○ Business Partner ID
○ Partner Number of Receiver - Logical (system ID of the cloud solution)
Result
When you execute the report ISU_C4C_ACCOUNT_EXTRACT in the IS-U system, the report generates and
displays an IDoc number. It takes a few minutes to send this IDoc number to the cloud solution.
You can search for the new contract account under UTILITIES CONTRACT ACCOUNT .
Note
You need to enter a 10 character ID for contract account. Add leading zeroes if the contract account ID is
less than 10 characters.
This document describes the configuration required to run the report ISU_C4C_ACCOUNT_EXTRACT in order to
fetch the delta for contract accounts.
The contract account delta replication involves two steps - identifying the delta and replicating to the cloud
solution. These steps are documented in detail below.
In IS-Utilities, contract accounts are represented by business object ISUACCOUNT in the business object
repository (BOR). When a contract account is created or changed, events situation. The object ISUACCOUNT
has the events UtilAccount.created and UtilAccount.changed . These events are triggered when a
contract account is created or updated using Transaction codes CAA1 or CAA2.
In the transaction code SM30, create two separate entries in the customizing view SWFDVEVTY1 for the two
events CREATED and CHANGED.
Note
The SAP Cloud for Customer Utilities Contact Center solution implements an event handler (class
CL_ISU_C4C_SWER_CA) to consume these events (UtilAccount.create and UtilAccount.changed). This
event handler determines if the incoming event is for contract account and triggers the report
ISU_C4C_ACCOUNT_EXTRACT to fetch the delta for contract accounts.
Report ISU_C4C_CONTRACT_ACCOUNT_REPL enables to replicate bulk data related to contract accounts using
additional option of parallel processing.
This enables the replication of contract accounts for Initial load with faster response time via parallel
processing technique.
This report provides the option to execute the replication in a dedicated server group which preferably has
ample work processes available in order to maximize the performance.
You can also create background job via this report and monitor it separately in transaction SM37.
Once the report is executed , Idocs are created and can be monitored via transaction WE02.
Use the below configuration steps, if you want to send multiple IDOCs as a single PI message to the receiver
system:
Note
The below images explain the setps involved to process 100 IDocs as a single message:
WE20
For more information on Contract Account Replication – Extension on CPI Artifact, see https://help.sap.com/
viewer/368c481cd6954bdfa5d0435479fd4eaf/Cloud/en-US/d3741720e29842e4bf547dcd66139f7f.html
Code list mapping must be maintained for the fields specified in the following sections
Automatic and manual code list mapping must be maintained for the utilities specific codes..
In the code list mapping, ensure that the delimiter is set to comma (,) and the Code List Mapping Group as 03 -
SAP On Premise Integration.
Note
If you are using the MDG framework to replicate business partners, you also need to maintain the code list
mapping for role code from S/4HANA to role : CRM000 in the SAP Cloud for Customer.
Prerequisites
Before downloading the code-list mapping report you need to activate BC set ISU_S4H_C4C_INTEGRATION in
SCPR20 transaction.
Follow these steps to create and configure a new mashup for integrating front office processes with your SAP
S/4HANA system.
1. Go to the Administrator work center and click Industry Settings Utilities Settings for Front Office
Process .
2. Click on New to configure. Maintain the following details:
○ Description
○ Active Flag
3. In the Assign Mashup ID to Launch Object table, add a new row and select the Launch Object.
4. Under Mashup ID, select the Mashup ID.
Note
You also need to assign the launch object in the Implementation Guide Customizing for SAP Hybirs Cloud
for Customer Utilities. For more information, see the reference in the related links section.
Business Partner Exception Management (BPEM) - Integration with SAP ERP or S/4HANA System [page
410]
Remove Personal Data in Contract Account and Sales POD [page 416]
In the cloud solution, search for utilities customers that exist in the SAP S/4HANA system.
The search launches an online search for business partners in the S/4HANA system. Use the advanced search
based on customer identification, address details or specific utilities information such as point of delivery,
service location, service order, meter ID, connection object ID, contract ID, and so on. You can also customize
the search criteria with extension fields.
Note
For a local search within the cloud solution, you need to replicate the utilities business partners from S/
4HANA system to your cloud solution. Additionally, you must have defined the required code list mapping.
In the search result for a customer, if the customer is the contact, you can navigate to the customer details
page using the hyperlink in the Contact ID column.
Enterprise search in HTML client and Live Activity Center-based search in Fiori client are available for Utilities
Contact Center. The utilitiesspecific object categories are available in enterprise search or live activity center
only if the Utilities Call Center solution is scoped in the system.
Enterprise Search
Enterprise search is available in the HTML client for the following utilities categories. Note that for the Utilities-
Customers category, the basic customer search is a local search in the cloud solution and advanced search is
executed as online search. The search for other utilities categories is an advanced online search.
You can use the live activity center based search in the responsive UI (RUI) client to search for utilities objects.
The search feature is similar to enterprise search in the HTML client.
1. Launch the Live Activity Configuration screen ( Administrator Service and Social Live Activity
Configuration ).
2. In the Search Objects section of the screen, click Add.
3. In the Add Search Object box, select the object that you want to add, and then click Add. If you want to add
more objects, select Add and New. If no objects are selected, the following objects are searched:
○ Account
○ Contact
○ Individuals
○ Tickets
4. Click Save.
The following conditions apply for the search using both Enterprise Search and for search using Live Activity
Center.
● For the customers' category, the basic search is a local search in cloud solution and advanced search
triggers an online search.
● For the premise category, search using division must be executed along with equipment number.
● For POD category, search using division must be executed along with installation number.
● Customer and Premise Search:
○ Search using either house number, street name, apartment ID, floor ID, or country/region must be
supported with additional parameters.
Under Live Activity screen, when you receive the calls through IVR, you can now identify the customers based
on independent communication data i:e phone number stored or replicated in the system.
In Live Activity Center, you can view the contract account and premise details of an customer and account.
As an administrator, you can enable contract account and premise tables in the live activity center. Go to
Administrator Service and Social Communication Channels Live Activity Configuration , and select
the Enable Contract Account checkbox.
When you select a customer and account, a table with the contract account and premise details appears.
In Live Activity Center, you can confirm the contract account details of an already confirmed customer and the
same contract account would be defaulted across all the screens of the customer.
When you select a customer, a table with the contract account and premise details of the customer
appears.You can confirm the required contract account and the same would be defaulted across the following
screens of the confirmed customer: Utilities 360, Utilities Financials, Utilities Rate Change , and Utilities
Collections . You can also unconfirm the contract account and the same would be unconfirmed across the
above mentioend screens of the confirmed customer.
You can confirm the contract account via IVR(Interactive voice response), along with the customer. The
confirmed contract account in Live Activity is reflected in Utilities 360, Utilities Financials and Utilities
Collections screens of the customer.
To specify the custom field to be used as an input to IVR, administrator must navigate to Administrator
Service and Social Communication Channels Live Activity Configuration and set value for field Select the
custom field that you want to use to confirm Contract Account from IVR.
This enables you to confirm the collective contract account from Contract Account table in Live Activity screen
of the customer.
The details of the confirmed collective contract account is defaulted under Utilities Financials, Utilities
Collections, Utilities Rate Change and Utilities Contracts screens of the customer.
The reuse libraries for contract account provide additional, very specific services to the scripting language that
are relevant to fetch the Confirmed Contract Account.
To use this reuse library, you need to import the http://sap.com/xi/AP/CRM/Global name space.
UtilitiesLib.GetConfirmedObjects
Description Returns the contract account confirmed from the Live activity in the current session. The confirmed
contract account can be used in custom tab.
Result:
When a call is simulated through IVR, the respective customer gets identified in Live Activity and the Customer
Hub screen of the identified user opens up.
To specify the custom field to be used as an input to IVR, administrator must navigate to Administrator
Service and Social Communication Channels Live Activity Configuration and set value to YES for
optionOpen Customer Hub.
Once you enable the option of opening custome hub you will be able to ebale the new contract accounts table
containing list of contract accounts for the identified customer under the following path Administrator
Service and Social Communication Channels Live Activity Configuration Utilities Settings and set value
to YES for optionConsider Contract Account View in Customer Hub.
You can initiate Move-In, Move-Out, and Transfer services from all the Utilities screens of a customer.
As an administrator, you can configure scripts to display the terms and conditions for rate or service orders in
the move-in and move-out processes.
Section Description
3. Click Save.
4. Go to Rules for value determination for Move In/Out Script, and set the rules for the script.
After the script is configured, the agent can launch the script during the move processes to agree to the terms
and conditions.
As an Administrator, you can configure the severity for the messages received during move process to display
whether it’s an error, warning, or instruction. The messages can also be suppressed if you don’t want them to
display.
2.2.3.3 Move-In
Move-in of a service means that a customer is signing up for a utilities service such as gas, electricity, water,
and so on. A move-in created in SAP Cloud for Customer creates a corresponding move-in in the SAP S/
4HANA system.
Create Move-In
Note
For guided move-in, you can use one of the two available UI options - Move-In or Move-In using MDT.
The decision and the necessary configuration must be made during early implementation.
To create a move-in, you must specify the mandatory fields Contract Account, Start Date, and Joint Invoicing
and select the service address. The mailing address is populated using the service address. The list of contract
accounts available for selection is pulled in from S/4HANA system.
New Mailing Address: Set the flag for New Mailing Address in the Create Move-In dialog screen to create a new
mailing address during move-out. This address replaces the standard address maintained for the business
partner in the S/4HANA on-premise system. Note that the standard address in the S/4HANA system isn’t
updated if you don’t set the flag for New Mailing Address. Validity date range is introduced in Move-In using the
new Valid From and Valid To fields within the mailing address.
Note
You can also use type ahead search to select an address after typing only a portion of it. For detailed
information on Address Type Ahead Search, refer to
Note
Create Service Order: Select the checkbox for Create Service Order when creating a move-in, move-out or
transfer. A corresponding service order is created for the move-in request and is displayed in the list of
service orders in the Service Orders screen. This feature for create and display of service orders is available
only if you have performed business replication to customer master. Additionally, in the BAdI
configuration, the Order Type, and Order Code for service order has to be defaulted in the S/4HANA pre-
BADI.
Note
Irrespective of whether or not you maintain the configuration for replicating contract accounts, the move in
screen displays all the contract accounts from S/4HANA that are linked to the business partner.
When you create a new move-in or transfer, you notice that the move-in (or move-out as applicable) date and
the meter reading date are the same. If you change the move-in date, this correspondingly updates the meter
reading date with the new date. However, when you estimate a meter reading (in move-in, move-out or
transfer), you can change the meter reading date to a different date.
Based on the premise that you select and the current or the move-in date, the active rate category is defaulted
for a contract from S/4HANA. You can also modify the default active rate category by selecting a rate category
from the list of all rate categories valid for the selected division. These values are retrieved from the S/4HANA
system using the move-in date for the selected installation.
Note
When you modify the rate category, a new row gets added for move-in with date starting from move-in date.
The existing rate category exists with ending date just before the move-in date where the move-in date is
D-1 with D being the current date.
Cancel Move-In
Select a move-in from the table and use Actions Change Move-In to cancel an existing move-in. A
message is displayed confirming the cancellation. Further note the following: 1) If a move-out date exists, the
Change Move-In is not enabled. 2) The entry for the move-in is deleted from the table.
Note that you can only cancel a move-in for which no move-out has been created. On cancel of a move-in
for which move-out has already been created, you are prompted with a message that the move-in is
irreversible.
Edit Move-In
You can change the date for an existing move-in. Note that the date can’t exist earlier than the move-out date of
previous contract.
The change process displays all the installations of a selected move document. You can update all the meter
readings at once for the installation or devices in the move document. The process immediately saves the
change in date.
Launch guided move-in from the toolbar in accounts and individual customers or in the Premise using the
Move-In button.
Feature highlights for guided move-in include possibility to capture reason for move-in, update rate category,
enter meter reading, create a service order, request security deposit, update mailing address, and add
additional notes.
You can view both AMI and non-AMI meter details in the move in process. If it’s an AMI meter, the AMI-related
capabilities appear dynamically.
Note
You can also use type ahead search to select an address after typing only a portion of it. For
detailed information on Address Type Ahead Search, refer to
Note
If you've implemented move-in using MDT, to create a customer or contract account during guided
move-in, maintain the required configuration for MDT. For more information, see MDT Templates
for Move-In, Customer, Contract Account & Rate Change Using Guided Processes [page 61]
○ The Premise section displays the Move-In Address, Move-In Date (current date), and Supplementary
Fields.
2. Services
Note
Restriction
It is not possible to identify the device for which meter reading history is displayed in Move-In GAF
as there are multiple rows of device as lead selection.
Restriction
○ The Guided Activity Floorplan (GAF) data automatically disappears after Move-In action.
○ Product list are not handled for sales areas, territory and so on.
○ The custom extensions for Sales process is not supported.
5. Review
○ This step displays a summary of all information maintained in the previous steps. Review the details
and click Create Move-In to initiate the move-in process.
In the step 2 of Move-In GAF where services and meter reading reusable Embedded Component (EC) are
available for which the round trips made to S/4 HANA are reduced.
In the following ECs, the property in the in port RequestFireOnInitialization and RequestAutoRefire is set to false.
So, to use the EC in any screen fireOutport should be used to call it explicitly.
● COD_UTILITIES_ACCOUNT_AND_PAYMENT_DETAILS.EC
● COD_UTILITIES_SERVICES_AND_METER_READING_EC.EC
● COD_UTILITIES_CONTRACTACCOUNT_AND_BILLING.EC
● COD_UTILITIES_MOVEIN_REVIEW.EC
● COD_UTILITIES_MOVEOUT_REVIEW.EC
● COD_UTILITIES_TRANSFER_REVIEW.EC
Related Links
Use the security deposit and joint invoicing details at contract level in move in process.
To enable the Contract Information table appear on the move in process page, go to Business Configuration
Implementation Projects Your Project Edit Project Scope Questions Industry Solution Utilities ,
and then select Utilities Call Center and Service. From Questions for Utilities Call Center and Service, select Do
you want to enable Security Deposit at contract level?.
Based on the requirement of your project, you can use the previous billing information or the new contract
information table for the process. Both billing information and contract information have joint invoicing and
security deposit details. However, while billing information appears at the Contract Account level, contract
information appears at the Contracts level.
For a move in, you can perform rate simulation to get information about the alternative rate categories that are
available.
2.2.3.4 Move-Out
Move-out services can be initiated in the S/4HANA system from your cloud solution from the Premise view for
a customer.
Create Move-Out
A move-out can be initiated if the contract account has valid contracts and associated move-in's for the same.
The service address and meter readings are defaulted. You can specify a move-out date and also the meter
reading at move-out, note type, and the meter reading type.
New Mailing Address: Set the flag for New Mailing Address in the Create Move-Out dialog screen to create a
new mailing address during move-out. This address replaces the standard address maintained for the business
partner in the S/4HANA on-premise system. Note that the standard address in the S/4HANA system is not
Note
You can also use type ahead search to select an address after typing only a portion of it. For detailed
information on Address Type Ahead Search, refer to
The action Cancel allows you to cancel the customer mailing address for a move-out. Therefore, after you have
completed the move-out and refreshed the screen, you will no longer see the customer mailing address.
On save, the existing contract in S/4HANA system is terminated and a confirmation for the same is displayed in
the cloud solution. Further, the move-out date is updated with the end-date.
Cancel Move-Out
Select a move-out from the table and use Actions Change Move-Out to cancel a move-out that has
been created earlier. Once you cancel a move-out, a confirmation message is displayed that the move-out has
been canceled. Further, that end-date for the contract is set to unlimited.
Change Move-Out
You can change the date for an existing move-out. Note that the date cannot exist earlier than the move-in date
of the previous current contract.
Launch guided move-out from the toolbar in accounts and individual customers. Guided transfer is also
launched when you select a move-out line item in a premise and then click Move-Out button.
Feature highlights for guided move-in include possibility to capture reason for move-in, update rate category,
enter meter reading, create an S/4HANA service order, request security deposit, update mailing address and
add additional notes.
Note
2.2.3.5 Transfer
You can transfer the services for an existing move-in using the transfer feature. Click on Transfer in the Premise
screen to initiate transfer.
1. Select a contract from the table and click on Transfer. In the dialog box that appears, the Move-Out Address
displayed is the same as the move-out address of the selected contract.
2. You need to specify the mandatory values for Contract Account and Joint Invoicing.
3. Select the address for the new move-in and then you are prompted to enter the start date of the new move-
in.
4. Also select the service address for the new move-in. The mailing address is defaulted to the service
address of the new move-in. Choose to maintain the other values for transfer in the dialog box.
New Mailing Address: Set the flag for New Mailing Address in the Transfer dialog screen to create a new
mailing address during move-out. This address replaces the standard address maintained for the business
partner in the S/4HANA on-premise system. Note that the standard address in the S/4HANA system is not
updated if you do not set the flag for New Mailing Address. Validity date range is introduced in Transfer
using the new Valid From and Valid To fields within the mailing address.
Note
You can also use type ahead search to select an address after typing only a portion of it. For detailed
information on Address Type Ahead Search, refer to
Note
6. In the Meter Reading table, you will see a list of services for both the new move-in address and the move-
out address. You can specify the corresponding meter readings at move-in/move-out. Specify the
corresponding move-in/move-out dates for each of the services and save your entries.
RESULT: You select an active contract and initiate a transfer. Note that you are moving in to new service
address and moving out from an existing service address. But there is no move-out for the contract as part of
transfer. Once the transfer is complete, the selected contract is updated in the Contracts table with the move-
out date.
The meter reading table is also refreshed with the entries for the new move-in address. If you have set the flag
for Create Service Order, a new service order is created and an entry is made in the table for service orders in
the Utilities Service Orders screen.
Note
Force Move-Out: If there is an existing customer in the new Move-In Address, this customer is replaced by
the new customer moving-in.
Guided Transfer
With guided transfer, you can now create a move-in, move-out and transfer in a single process. Launch guided
transfer from the toolbar in accounts and individual customers. Guided transfer is also launched when you
select a move-in line item in a premise and then click Move-In. Guided transfer process includes the following
five steps:
Note
A contract account is automatically created only for a move-in as part of the transfer. To enable this,
maintain the required configuration for MDT template. For detailed information, see MDT Templates for
Move-In, Customer, Contract Account & Rate Change Using Guided Processes [page 61]
With guided transfer, you can now create a move-in, move-out and transfer in a single process. Launch guided
transfer from the toolbar in accounts and individual customers. Guided transfer is also launched when you
select a move-in line item in a premise and then click Move-In.
You can view both AMI and non-AMI meter details in the move in processes. If it is an AMI meter, the AMI-
related capabilities appear dynamically.
Note
Note
A contract account is automatically created only for a move-in as part of the transfer. To enable this,
maintain the required configuration for MDT template. For detailed information, see MDT Templates for
Move-In, Customer, Contract Account & Rate Change Using Guided Processes [page 61]
You can view static content under the Alerts side panel across the Customer, Premise and Contcat Account
screens in Utilities Contact Center solution.The Alerts framework is also available at every stage of move
processes.
After you add the tab, you can enable it as a side pane in screens. From the Adapt menu, select Company
Settings, and then select the Enable Side Pane in Fiori client checkbox.
When you enable the side pane, you can view alerts for a selected individual customer, account, or premise in
the right pane of the respective UI. The Alerts framework is also available at every stage of move processes.
You can enable the display of alerts in the expanded mode through a scoping question. To configure the
scoping question go to Business Configuration Edit Product Scope Industry Solution Utilities , and
select Utilities Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Alerts, select the Do you want
expanded Alerts in Move Processes? question.
2.2.5 Premise
The Premise work center is a hub that allows you to perform a host of utilities functions such as creating or
changing move-in's, move-out, transfer and meter readings. In addition, view the premise on a map, display
object hierarchy for installation point and create new sales PODs for the premise.
Use the icon for Map View to view the premise locations plotted on google maps. In the premise header, the
Installation Point is hyperlinked.
This screen has three sub-sections, namely the Map View, Highlights and Customer Overview. This view is
displayed in the Collapse Map mode by default. Click on Expand Map to display the premise in map view.
Highlights
This section displays key details such as connection status for an installation or any other custom defined
messages. Click on the hyperlinks for Contract Account and Name to navigate to the Contract Account and
Individual Customers work center views respectively.
Customer Overview
● Create a Simple Move-In. Use the Move-In on the toolbar to create a guided move-in.
● Cancel a Move-In
● Change a Move-In
● Create a Simple Move-Out. Use the Move-Out on the toolbar to create a guided move-out.
● Cancel a Move-Out
● Change a Move-Out
● Create a new Transfer
This tab screen displays the object hierarchy starting from the installation or the point of delivery. The Details
section below lists information for the installation point such as the Meter Reading Unit, Grid Level Type, Status,
Guarantee of Supply (field from the S/4HANA IS-Utilities) and so on.
Meter readings are displayed for a selected device in a table below. Edit the meter readings or create a new
meter reading. Use the advanced search to search for a device for the selected premise, that is not displayed
here.
Note
The New Meter Reading allows you to create new meter readings using a form template. Use the New Meter
Readings menu option under the gear icon to create meter readings using the standard screens in your
solution.
Tickets
This tab screen displays all tickets associated with the premise. Search for tickets in this screen using the filter
values - Completed Tickets, Open Tickets, Related to Premise Only, Related to Point of Delivery. You can also use
the advanced search to look for tickets.
Create new tickets and also select a point of delivery related to a premise. To do this, you can use the search
help for the POD External ID. The installation point, address details and the Premise Ext. ID are prefilled for the
ticket. Click on a ticket in the list to navigate to the Tickets work center.
Note
Two POD IDs are displayed when creating a new ticket from a premise. The premise that is displayed by
default reflects an existing implementation where the search help for point of delivery or POD External ID is
restricted to the Cloud for Customer system. A new implementation for the POD External ID is available
wherein an online search is performed in the S/4HANA system to fetch values for POD External ID.
Service Orders
In this screen, a call center agent can find an overview of service orders logged in for the premise You can also
create new service orders for the premise. Note that the service address is not defaulted to the premise
address to allow you to log a service ticket for a different service location.
Sales POD
Search for a sales POD linked to the premise or create new sales POD. The premise ID and the address details
are copied from the selected premise.
Service Notifications
For detailed information, see the documentation for topic Utilities Service Notifications.
Exceptions
Disconnection Documents
In the Disconnection Documents section, view the disconnected documents associated with a premise or an
installation.
Note
Analytical Reporting
You can use Premise objects for Analytical Reporting. To find the objects go to Business Analytics Design
Data Sources . For details on Analytical Reporting, see https://help.sap.com/viewer/
66e9a9081a7b40e38c8604d6617d0311/1911/en-US/576afc782dde4567ad3856ed128e0a1d.html.
When you hover over the premise you can see the details of it under the premise quick view. In addition to the
previously added obejcts you can also view the number of existing services, premise type, address in the label
For easy and quick identification you can now turn on an alternative title for premise object based on scoping
question.
The alternative title displays house number, street name, and house supplement, which makes it more
meaningful.
To configure the premise object title navigate to Business Configuration Edit Product Scope Industry
Solution Utilities , and then select Utilities Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Enhancements, select the Do you
want to enable the premise object labels to display house number, street name, and house supplement?
question.
Due to change in business landscape there is a need to provide some important views under premise. The
information visible would be pertaining to the premise only
2.2.5.2.1 Central
This tab displays cards such as Customer, Recent Tickets, and Recent Meter Readings.
● View recent customer details in Customer card and Google map view for the premise.
● View recent tickets and create ticket in Recent Ticket card.
● View recent meter readings and enter new meter reading in Recent Meter Reading card.
In the Utilities Contact Center, you can create and update meter readings. On selection of a contract in the
table for Contracts, the corresponding service addresses along with existing meter reading values are listed in
the meter reading table.
You can add new meter readings for each of the services corresponding to the service address of the contract.
Along with the meter reading, you will need to specify the meter reading type, date and select a meter reading
note type. On saving your entries, a confirmation message is displayed in the cloud solution and the
corresponding meter readings are updated in the ERP system.
The meter readings in the Utilities Contracts tab screen are displayed only for the previous one year
calculated at the current date. But the meter readings in the Utilities Overview and Utilities 360 tab screens
display meter readings only for the last five transactions.
Note
Meter reading is not mandatory for move-in, move-out and transfer. You can create move-in, move-out and
transfer without specifying meter readings.
Note
All the field help values such as meter reading note type / reason / meter reading type are updated using
the auto code list mapping. See Related Information section below for the topic Code Lists Mapping.
You can now enter or estimate an interim meter reading with or without billing. You must specify the
appropriate meter reading reason and type.
Additional features for meter reading: If you enter an incorrect meter reading (meter reading not in the
expected range), the meter reading is considered as Implausible. Any meter reads in processing status 2 are
considered as implausible but will nevertheless be saved.
● Estimate - Use this option to estimate the meter reading and consumption for an installation.
● Override
● Reset - Use this option to clear all the meter reading values and you can enter fresh data.
The meter reading table displays a combination of meter reading result and meter reading order, sorted by
date, device and registers. Create a meter reading result for a meter reading order. Customer receives a bill
only if meter reading order is available for the period.
Characteristics of MR Order:
● View meter reading orders in the meter reading table in Utilities Financials tab and under Premise (work
center) Connection Details (tab) .
● Create and edit meter reading orders in the Utilities Financials tab for customers and in the Connection
Details tab in the Premise work center.
Note
● If meter readings are blank, then meter reading orders are created for meter reading reasons 02 and
09.
● When creating meter reading for Register1, the system automatically creates meter reading orders for
all other registers associated with the equipments.
Following new validations are available for guided processes (move-in, move-out and transfer)
● New Validate action on the UI for move-in meter reads in guided processes.
● A new status indicator shows if the meter reading has been successful or is errored.
● A flag - Override that allows you to ignore an invalid read and continue to save your move-in.
Use Validate UI action to validate meter readings in guided move-in, move-out and transfer.
Related Information
The Connection Details tab of a Customer displays the validity period of meters of a premise or an installation.
In the Meter Information table,view the device location details related to the selected device and connection
object. The device location note appears in the Notes popup.
Use Advanced Metering Infrastructure (AMI) to capture consumption from the periodic interval meter
readings. This information is for display only and cannot be modified.
Advanced metering infrastructure (AMI) is an integrated system of smart meters, communications networks,
and data management systems. Use this system to enable two-way communication with your customers.
Access details on AMI and non-AMI meters under the Meter Information table for meter readings. Find this
table under:
The following details are retrieved from the SAP ERP system and displayed in the Meter Information table.
Note
In the Utilities 360 tab, the Meter Informationtable is displayed only if you select an AMI activie device.
However, in the Connection Details tab in the Premise, the Meter Information table is displayed irrespective
of whether the device is AMI active or not AMI active. However, the fields listed below are displayed only for
an AMI active device. If you select a non-AMI device, then only the general meter reading details are
displayed.
● AMI Status
● Remote Connect
● Remote Disconnect
● Remote Meter Reading
● Manual Meter Reading with AMS
● On-Demand Meter Reading
● Request Operational State
Note
Some of the fields listed above are personalization hidden and can be enabled by the user.
As an administrator, you can configure a safety message to reconnect the AMI smart meter.
On the Safety Message for Reconnect, you can manage the message to be mandatory or optional.
This work center view displays all contracts for a selected contract account including information such as
move-in and move-out dates.
The contract accounts are listed with the following details: Contract ID Description, Contract ID, Customer ID,
Customer Name, Customer External ID, Bill to Party, Payment Terms, Collective Contract Account ID, Due
Amount, and Open and Payable Amount.
In the BAdI configuration, make sure the Bill Form and Clearing Category are defaulted in S/4HANA pre-
BADI.
This new work center provides you the capability to use value help search in advance search.
Sales Quotes
All sales quotes for the selected contract account are displayed in this tab screen. You can create a new sales
quote or search for an existing quote using Basic/Advanced Search.
Analytical Reporting
You can use Contract Account objects for Analytical Reporting. To find the objects, go to Business Analytics
Design Data Sources . For details on Analytical Reporting, see https://help.sap.com/viewer/
66e9a9081a7b40e38c8604d6617d0311/1911/en-US/576afc782dde4567ad3856ed128e0a1d.html.
Related Information
MDT Templates for Move-In, Customer, Contract Account & Rate Change Using Guided Processes [page 61]
Contract Account Replication [page 71]
Contract Account Delta Replication [page 73]
As an administrator, you can configure a new Contract Account Work Center with value help capabilities for
advanced search fields.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and then select Utilities
Call Center and Service.
In the Questions for Utilities Call Center and Service section, under Utilities Enhancements, select the Do you
want to enable the new contract account work center with value help capabilities for advanced search fields?
question.
Due to change in business landscape there is a need to provide some important views under contract account
as well.The information visible would be pertaining to the relevant contract account only
2.2.6.2.1 Details
This view displays the consolidated general, financial, and more information of the contract account. This
screen gives visibility of all the details pertaining to the selected contract account in a single place.
The links in the following fields open the associated objects: Customer External ID, Customer ID, Bill to Party,
Corr. Recipient, Alt. Dunning Recipient, and Alternative Payer.
This screen displays all tickets created for the contract account.
Create a new ticket for contract account by selecting the New option. While creating the new ticket the system
auto populates the Contract Account ID for that contract account.
Create the BPEM cases by selecting the contract account case category provided in tickets.
This screen displays all the locks related to the contract account and contract.
This screen has three sections has the following sections in it:
Locks
All locks for the selected contract account are listed in this screen. Details that are displayed include Lock
Status, Object, Object ID, Lock Type, Lock Reason and validity dates. You can create, edit, and delete locks. The
following lock types are supported for contract account locks:
● Calculate Interest
● Dunning
● Income Payment
● Invoice
● Invoicing
● Outgoing Payment
● Posting/Clearing Lock
Contracts
This tab screen displays all contracts associated with the contract account. They are listed with details such as
the Contract Account ID, Customer ID, Contract ID, Premise ID, Service Address, Installation, Point of Delivery
(PoD), Division, Move In Date, Move Out date and Rate Category.
Contract Locks
When you select a contract in the Contracts table, the corresponding locks for the contract are displayed in the
Contract Locks table below. Details such as Lock Reason, Status, validity dates, Object ID, and so on, are
displayed for the locks.
In the Contract Locks table, use Actions Create New Lock/Edit Lock features. Only locks of type Invoicing
can be created for contracts.
2.2.6.2.4 Invoices
This screen displays the invoices pertaining to the open contract account.
A list of invoices created for the contract account and for each of which one or more corresponding billing
documents exists, are displayed in this section. You can set a date range to view the invoices of that time
period. Some of the available options are Invoices From Last 1 Year, Invoices From Last 90 Days, and Invoices
From Last 7 Days.
This screen displays all the unpaid financial documents pertaining to the open contract account
For the selected line item, you can perform the actions Create Locks, Manual Posting, Deferral, and Reversal.
You can also verify the document origin key and origin text; displayed in the table.
2.2.6.2.6 Payments
This screen displays all the payment documents created for the contract account.
You can also cancel a particular payment line item by selecting Cancel Payment action provided on the
Payments table.
This screen displays history of all financial transactions pertaining to the contract account.
For the selected line item, you can perform the Reversal action.
This screen displays all the security deposit documents posted for the contract account.
You can also perform actions like Reverse, Release and Partial Release on the security deposit docuemnts
based on the status.
This screen displays the collections details pertaining to the open contract account.
● Dunning History - Displays the dunning activity of the contract account. With this functionality, you can
create and send payment reminders or dunning letters to your business partners to remind them of
overdue payable and to request payment.
● Returns - Displays the list of payment transactions, which are returned from the target systems (Bank,
Cheque, SEPA, and so on)
● Correspondence History - Displays the history of all the correspondences sent to the customer.
● Write Offs - Displays the list of items, which have been written off. Writeoff data provides information on a
business partner's payment history.
In this screen, view contact information and preferences for notifications such as email, text, or IVR for
different services.
This is integrated with Smart Energy Water to view and update the preference in Service Cloud.
In Consumption Graph, review the usage graph for the services installed for a contract account.
The usage graph is integrated with Smart Energy Water to view the usage information for linked Premises in
Contract Account.
Related Information
View and maintain the Payment Plan and Budget Billing Plan pertaining to the open contract account.
Payment Plan - Create, edit, display, and deactivate payment plans for a contract account.
Budget Billing Plan - Create, edit, and display the budget billing plan for a contract account. The budget billing
plan is the basis for charging budget billing amounts.
This screen you can view and maintain the Installment Plan, Promise to Pay pertaining to the open contract
account.
Installment Plan - You can create, view, or change the installment plans. With an installment plan, you divide
source items to several installment receivables that have a due date in the future.
You can view the total variance amount - with changes to the installment plan amounts - in the Calculated
Variance field for contract account. You can access the over or under amounts while creating or editing the
Installment Plan.
Promise to Pay - You can create, view, or change the promise to pay plans. Use a promise to pay to record a
business partner's agreement to pay receivables that are on the account.
This tab displays cards such as Recent Invoices, Last Payment, Premises, Locks, Recent Tickets, Open Items,
Customer Credit Worthiness, Security Deposit, and Dunning.
In this screen, view the nearby outage area for a customer based on contract account.
It shows the current map as well as the planned outage map based on city or ZIP code.
The outage map is integrated with Smart Energy Water to view the outage areas.
2.2.6.2.16 Compare
In this screen, view the power consumption difference of a time period for a customer.
It displays the current month or year power usage compared to previous month or year usage depending on
ZIP code,utility, and so on.
This is integrated with Smart Energy Water to view the consumption difference.
Related Information
For easy and quick identification you can now turn on an alternative title for contract account object based on
scoping question.
The alternative title displays conract account external ID and name, which is more meaningful.
To configure the scoping question for contract account you can navigate to Business Configuration Edit
Product Scope Industry Solution Utilities , and then select Utilities Call Center and Service.
Launch collective account as a contract account object. A table with the details of the child accounts of the
collective contract account is displayed.
As an administrator, configure the contract account profile in order to have a flexibility to hide or unhide which
tabs and cards to be visible based on contract account information.
1. Navigate to Administrator Industry Settings and select Contract Account Profile Configuration.
2. Select theEnable Profile toggle button under Profile Configuration to determine the visibilities of the tabs
and cards.
3. Click New to create a profile.
The system sets the first profile as default. You can change it later.
All the Cards and Tabs are loaded based on the Business Configuration.
4. Enter an Alpha Numeric value as Profile ID.
Note
5. Select the Visible check box for the cards and tabs from the list that you need.
Note
You must manually select the Central tab if you are selecting any card.
Delete the cards or tabs that you don’t want for the profile. You can add the deleted cards using + icon.
6. Click Save.
Note
1. Navigate to Administrator Industry Settings and select Rules for value determination for Contract
Account Profile.
2. Click Add Row to add rules.
3. Enter the following input fields:
○ Contract Account Category
○ Account Determination ID
○ Contract Account Class
Enter the Profile ID as output field.
Note
If the cards and tabs are hidden by the administrator, they are not visible even if you select them using
profile configuration.
Customer screens include a large scope of utilities solution. When you scope utilities industry in the business
configuration scoping, you will see a standalone workcenter for Utilities in the workcenter menu. Further,
customer is also scoped with utilities specific screens.
● Utilities 360
● Utilities Financials
● Utilities Service Orders
● Utilities Sales POD
● Utilities Service Notification
● Utilities Rate Change
Note
Utilities Contracts and Utilities Overview tabs in Customer are not available for S/4 HANA scoping.
A 360 degree overview of the object hierarchy for all utilities objects.
The Highlights section displays the overdue amount and total balance for a customer.
The Utilities Hierarchy section displays the object hierarchy for a customer. If collective contract account exists,
then the hierarchy is displayed from collective contract account. If the collective contract account is not
maintained for that contract account, then the hierarchy is launched for the contract account itself. The device
is the last level in the hierarchy.
Note
If the contract account is a collective contract account (with multiple contract accounts within it), then the
hierarchy top node displays the collective contract account and the individual contract accounts are
included as sub-nodes for this collective contract account.
Note
If records for business partners are more than a hundred, an icon for More is displayed.
● The Highlights section displays account header information such as Overdue Amount and Total Balance.
● The hierarchy under Utilities Hierarchy reflects the nodes related to the selected contract account.
● If the contract account has a collective contract account, then the hierarchy top node displays the
collective contract account.
● Select and click on any object in the hierarchy to display further details in the section below. For example,
for a contract account, the Dunning Procedure and Payment Terms are some of the details displayed in the
details section.
● The contract account (or collective contract) account, premise, contract, installation and device are
displayed for each top level hierarchy node in Utilities Hierarchy.
● Confirm - You can confirm a contract account or a premise. When you confirm a contract account,the
same would be defaulted across different screens of the customer likeUtilities 360, Utilities Financials,
Utilities Rate Change , Utilities Collections , and Utilities Contracts . You can also confirm the collective
contract account and the same would be confirmed across the above mentioend screens of the confirmed
customer. Further, a field Confirmed Contract Account is displayed above the table with the confirmed
contract account ID. Note that this action is greyed out by default and is highlighted when you select a
contract account or a premise.
Note
The Confirm action is valid only until the logged in session of the individual customer is active.
● Unconfirm - You can unconfirm a contract account or a premise. When you unconfirm a contract account,
the Utilities Contracts and Utilities Financials tab screens no longer display only the confirmed contract
account details. Further the field that displays the confirmed contract account is no longer displayed and
the Confirm action is highlighted again.
Note
The Unconfirm action is valid only until the logged in session of the individual customer is active.
● Create Contract Account - You can create a new contract account using this action in the Utilities 360
screen.
● Search - Search for a contract account, point of delivery or premise using this action. Note that search in
the Utilities 360 work center view performs an online search in the S/4HANA system.
Recent Changes
The Recent Changes section displays a recent history for all objects in your solution.
View IS-Utilities contacts in the Recent History tab of the Utilities 360 work center view. All fields are display
and cannot be edited in the cloud solution. Fields displayed include Contact ID, Customer ID, Contact Class,
Action, Communication Mode and Type, Priority, Additional Info, Delete Flag, Text and Created Date and Created
Time. When you create move-in, move-out or transfer, the contacts created as part of these processes are
saved to the backend S/4HANA system and displayed in the Utilities 360 screen as IS-Utilities contacts.
Administrators must determine during implementation, what contact types from IS-Utilities be displayed in the
cloud solution. Further, a sample business add-in implementation is available to extend this feature.
As an administrator, you can configure to manage views for Recent Hisory and Hierarchy sections under
Utilities 360screen of a customer.
4. Click Save.
To configure the default view in the Hierarchy section , follow these steps:
4. Click Save.
The configurable hierarchy displays utilities object structure you have created in the SAP S/4HANA system, in
your cloud solution. Launch the configurable hierarchy from tool bar in Customer work center. Icons in the
hierarchy help to identify the different objects. Only one configurable object hierarchy can be active at any
time.
The steps to creating the configurable object hierarchy are listed below:
1. In your SAP S/4HANA-IS Utilities system, use transaction code ENVD to create a configurable hierarchy.
2. Next, assign the configurable hierarchy to IMG activity node Configure Object Hierarchy under SAP S/
4HANA Implementation Guide Customizing SAP Utilities Cloud for Customer for Utilities Configure
Object Hierarchy .
3. Implement Web Service - ISU_C4C_CONF_HIER_GET. The ISU_C4C_CONF_HIER_GET reads the profile
from the IMG node and sends it to the SAP Cloud for Customer system
On the Utilities 360 page, you can select a configurable hierarchy view of an individual customer or an account.
To set the configurable hierarchy view as the default view in Utilities 360, go to the Administrator work center
and click Industry Settings Utilities Settings for Utilities 360 , and in the Hierarchy tab, select
Configurable Hierarchy.
Note
Selecting a default view for hierarchy overwrites all the adaptation or personalization settings. As an
administrator, you can clear the default view entry. This restores the previous settings.
After you assign FOP profile for configurable hierarchy (go to Administrator Industry Settings Utilities
Settings for Front Office Process , and assign mash up ID for Hierarchy), you can launch front office process for
a line selection on the Utilities 360 page.
Note
After assigning the FOP profile for configurable hierarchy, you must either reopen the Utilities 360 page of
the account or individual customer, or refresh the list, for the assignment to take effect.
Note
The search performed in the Configurable Hierarchy view is independent of the search perfomed in the
Hierarchy View or List View.
You can perform advance search using Premise, Point of Delivery, and Device fields in the Configurable
Hierarchy view to get the respective hierarchies.
On the Utilities 360 page, you can select a list view of the 360 hierarchy of an individual customer or an
account. By default, the hierarchical view is selected for the objects.
The table view has no limit on the number of records to be displayed. You can confirm or unconfirm both the
contract account and premise on the same line item. When you click a line item, all the details related to the
objects are displayed in the area under the list or hierarchical view.
View IS-Utilities contacts in the Recent History tab of the Utilities 360 work center view. All fields are display
and cannot be edited in the cloud solution. Fields displayed include Contact ID, Customer ID, Contact Class,
Action, Communication Mode and Type, Priority, Additional Info, Delete Flag, Created Date and Created Time.
When you execute S/4HANA processes, the contacts created as part of move-in, move-out or transfer are
saved to the backend SAP S/4HANA system and displayed in the Utilities 360 screen as IS-Utilities contacts.
Note that the contacts are created only for the processes that are configured in the S/4HANA system.
The Financials screen shows a detailed overview of the business partner invoices, payments, open items,
installment plans, as well as the premise and contracts associated with the business partner. Perform functions
such as updating meter readings, invoicing, installment plans, and so on, from the various tabs in this screen.
Header Bar
The Customer Must Pay Amount in the header is the total amount the business partner owes to the utility
company while the Customer Total Balance is the sum of all unpaid invoices for which the due date has elapsed.
The contract account that you confirmed in the object hierarchy in Utilities 360 is defaulted in the financials
screen. You can also select a contract account in the header to display the latest Dunning Level for the account.
Item level dunning information such as Dunning Text, Dunning Level, and Dunning Step are shown in the Open
Items tab.
The Utilities Financials screen has the following sections that are displayed as tabs:
● Open Items: The unpaid items for a billing document are grouped and displayed for each contract account.
You can also verify the document origin key and origin text; displayed in the table. The menu offers creation
of document locks and installment plans for the open items.
● Premises: Displays a list of premises tied to the customer.
● Installment Plans
● Payments
● Payment Plans
● Contracts with Meter Reading: This section displays all contracts for the customer with their meter
readings. Select a row to display all recorded meter readings for the selected contract account. Add new
meter readings here or even edit the existing entries. The locks table displays the locks for a selected
contract.
A synchronous call to the SAP S/4 HANA IS-Utilities gets initiated the first time the Utilities Financial in
customer is loaded. When the user navigates between different tabs (Open Items, Invoices, Payments, and so
on) the data is retained; A fresh call to IS-U is made during initial load or if a separate contract account is
selected.
A new service to IS-U is also initiated when the user performs specific action in one of these tab screens. For
example, any action performed in Payments or Open items tab screen and navigating to Invoices initiates a
service call to IS-U. The table contains detail information on the tab screens and actions that initiate a call to IS-
U.
Related Information
Utilities Contact Center S/4HANA edition offers comprehensive features for bill correction. These include bill
reversal (Adjustment and Full Reversal), rebill and invoicing document locks. Use bill correction to perform
reversals, modify meter reading and display the updated invoices from the S/4HANA system.
The Utilities Contact Center supports adjustment and full reversal for invoice documents. For both adjustment
and full reversal, you need to specify reversal reasons. You must maintain the reversal reasons in the fine tuning
under Business Configuration Open Activity List Utilities . The reversal reasons that you maintain in the
fine tuning must be the same as those configured in the IS-Utilities.
Note
When you reverse an invoice or line items in an invoice, the invoice is marked as reversed (marked as 'X')
and a reversal document is created and sent to S/4HANA IS-U system. Additionally, a new row is created in
the Balances table for the the updated invoice from S/4HANA IS-U.
Adjustment Reversal
You can perform adjustment reversal only on the complete billing document. When you adjust reverse a bill, a
new bill with amount as negative is created under the invoice. On a reversed bill, you can also update the meter
reading and subsequently rebill the invoice. This will generate new bills with the latest amount. To perform
adjustment reversal, follow these steps:
1. Select the billing document (select the row that has the contract ID displayed) in the Invoice History table
of the Utilities Financials tab screen. When you select a billing document, the action Bill Correction gets
enabled.
2. Click Actions Bill Correction .
3. Select a valid reason for reversal.
4. Click Adjustment Reversal.
5. Click Meter Reading. A new window appears with the device and meter reading details.
Full Reversal
Use full reversal to reverse an invoice line item. When you full reverse, a new invoice with amount as negative is
created for the contract. On a reversed invoice, you can also update the meter reading and subsequently rebill
the invoice. This will generate new invoice with the latest amount. Follow these steps for full reversal.
1. Select the invoice line item (select the row that has the Invoice No displayed) in the Invoice History table.
Note that you can perform a full reversal only for individual line items of an invoice document.
2. Click on the bill correction
3. Enter the reversal reason
4. Click Full Reversal and the invoice line item is reversed.
5. Click Meter Reading. A new window appears with the device and meter reading details
6. Save the meter reading.
2.2.7.2.1.2 Rebill
Rebilling is required if you have made an adjustment or full reversal of invoice line items or an invoice. You need
to therefore use rebill to update the meter readings for reversed invoices. If you do not rebill, invoices are
generated for the previously available meter readings.
When you click Rebill, the Meter Reading is enabled and it allows update of meter readings for the invoice line
items or invoices .
Invoicing with MR: If you are creating an invoice with a meter reading, then the Create Invoice dialog also
displays the periodic meter readings for the contract account. If there are no periodic meter readings, an
interim meter reading order is created. Follow these steps to create an invoice with meter reading:
Note
Note
The utilities screens have been enhanced to create and change all the meter reading screens to
consider device information record.
The Bill and Invoice helps you to invoice and bill at one go as soon as a valid meter reading is posted. This
option is available even when there are no billing documents unlike the Invoice that invoices only if billing
documents exist.
When you click Bill and Invoice, all contracts for the contract account and all billing documents for a contract
(that have not yet been invoiced) are automatically selected. Billing documents and invoices get generated for
the selected contracts.
Note
Only the following three meter reading reasons are available for Bill and Invoice: 01 - Periodic Meter Reading,
02 - Interim Meter Reading with Billing, and 09 - Interim Meter Reading without Billing.
2.2.7.2.2 Payments
This section displays a list of payment document numbers for which payments have been made. The following
payment types are supported in your utilities solution:
● Payment Lot
● Payment Run
● Payment Specification (Displays under the Open Items tab)
● Payment from Cash Desk
In the Payments table, filter for payments based on payment date. The Payments table displays the following
details:
Use the Utilities Financials tab of an individual customer to make a one time payment with the existing or new
bank account.
The tab displays the default contract account ID. However, you can select a different account number in the
One Time Payment window. If you select a different account number, the amount and bank details, related to
the selected contract account, are updated accordingly.
The One Time Payment button can be controlled through business actions. For more information about
business actions, see .
You can either pay the outstanding amount (open payable amount), or an amount of your choice. The payment
date can be the current date or a future date.
The new bank account created as part of this process is stored at the business-partner level and is not
associated with the selected contract account.
In the Utilities Financials tab screen, for the first section on Open Items, use Actions Create Locks to
create new locks. You need to specify the lock type, reason and duration for the lock.
The selection values for lock types and lock reasons are displayed from the IS-Utilities configuration.. The lock
types Dunning, Payment, Posting and Interest locks are supported for Utilities Contact Center solution. When
you set a lock, the symbol for lock is displayed against the open financial document. You can choose to set one
or more locks on a financial document.
To edit or delete lock, click the document lock icon for an open item line. In the dialog box that appears, select
the row for a lock and click Edit, Delete, or Cancel to perform the corresponding action.
The Utilities Contact Center solution supports create, change, and deactivation of an installment plan. All
installment plans for a business partner are displayed in the Installment Plan section in the Utilities Financials
tab screen.
1. Under Utilities Financials Installment Plan , click Create Installment Plan to create a new installment
plan.
2. In the Create Installment Plan dialog, select the contract account for which you want to create an
installment plan. On selection of a contract account, the open items are displayed for the contract account.
3. Select one or more open items in the list. The total amount for the installment plan is displayed below the
table. The total amount is the sum of the selected open invoice items.
4. Select an installment Plan Type. Based on the plan type that you select, values for Plan Category, No. of
Installments, Installment Interval, Interval Type, and Amount are defaulted. You can modify these defaulted
values.
5. Enter a start date for the plan.
6. Simulate: When you select Simulate, the list of installments along with the respective due dates is
displayed in the Confirm Installment Plan dialog screen. You can also modify the simulated data; for
example, you can change amount or due date for any of the individual installments in the list.
7. Click Save to save the installment plan.
You can modify the number of installments, amount to be paid for unpaid installments and the due date for
payment for an installment plan.
When you change the installment plan amount, the total variance amount is displayed in the Calculated
Variance dialog screen.
Select an installment plan and specify the reason for deactivation and the deactivation date if you need to
cancel an existing installment plan. If you don’t specify a date, the current date is defaulted for deactivation.
In the Invoice History section in the Utilities Financials screen, click on the hyperlink for the field Invoice No to
display the PDF document for the invoice.
From the Payment Plans tab in the Financials screen, create, edit, display, and deactivate payment plans.
Payment Plan
The payment plan displays the Payment Plan ID, Type, Contract Account ID, Alternate Starting Month, Status,
Division, Validity, and so on. If you have confirmed a contract account in the Utilities 360 screen, the same is
defaulted for the new payment plan and the related contracts are displayed for selection. The system first
creates a proposal based on the previous monthly consumption bills. Edit the amount or go ahead to confirm
and save the payment plan.
Available actions include Create, Edit, Display, and Deactivate payment plans. Edit option allows you to change
the text and amount for the payment plan. The Payment Plan Type BBP is defaulted for payment plans created
in your utilities cloud solution. A new icon highlights the status for a payment plan. The same prerequisites that
apply for creating payment plan in S/4HANA IS-Utilities solution also apply in the utilities cloud solution.
When you confirm deactivation for a payment plan, the system performs displays the confirmation message
and performs the following actions::
● Displays the last invoice number of the contract for the field Deactivated. The field is blank if no invoice
exists.
● Deletes the starting month for the plan in the S/4HANA system.
● Displays the Deactivated status icon for the status field.
● Displays the deactivation date for .
Create and update meter readings in this section. On selection of a contract in the table for Contracts, the
corresponding values of existing meter reading are listed in the meter reading table.
You can add new meter readings for each of the services corresponding to the service address of the contract.
Along with the meter reading, you will need to specify the meter reading type, date and select a meter reading
note type. On saving your entries, a confirmation message is displayed in the cloud solution and the
corresponding meter readings are updated in the S/4HANA system.
Note
Meter reading is not mandatory for move-in, move-out and transfer.,You can create move-in, move-out and
transfer without specifying meter readings.
Note
All the field help values such as meter reading note type / reason / meter reading type are updated using
the auto code list mapping. See Related Information section below for the topic Code Lists Mapping.
Note
Meter Reading Reason and Note can be defaulted by implementing the post badi for FM
ISU_C4C_VALUE_HELP in the S/4HANA system
You can now enter or estimate an interim meter reading with or without billing. You must specify the
appropriate meter reading reason and type.
Additional features for meter reading: If you enter an incorrect meter reading (meter reading not in the
expected range), the meter reading is considered as Implausible. Any meter reads in processing status 2 are
considered as implausible but will nevertheless be saved.
● Estimate - Use this option to estimate the meter reading and consumption for an installation.
● Override - Use this option to save an implausible meter reading by overriding the error.
● Reset - Use this option to clear all the meter reading values and you can enter fresh data.
The meter reading table displays a combination of meter reading result and meter reading order, sorted by
date, device and registers. Create a meter reading result for a meter reading order. Customer receives a bill
only if meter reading order is available for the period.
Characteristics of MR Order:
● View meter reading orders in the meter reading table in Utilities Financials tab and under Premise (work
center) Connection Details (tab) .
● Edit meter reading orders in the Utilities Financials tab for customers and in the Connection Details tab in
the Premise work center.
● In the meter reading table, a highlighted tick mark in the MR Order column indicates that meter reading
order is active and scheduled. An active meter reading order is in status Meter Reading Order Created and
it is possible to add new meter readings and edit the line item.
● A grayed out check mark indicates the meter reading has already been recorded for the order. It is possible
to create new meter reading only for the following meter reading reasons: 02- Interim meter reading with
billing and 09-Interim meter reading without billing.
● Edit a line item in the meter reading table is possible for both, an active meter reading order and for a
meter reading result. If meter reading is already maintained, edit is NOT possible for meter reading status
Billed.
Related Information
When you select Manual Posting, the dialog for creating a miscellaneous posting appears. In this dialog, you
can select a Contract Account, Amount and Posting Reason. Note that if you have confirmed a contract account
in the hierarchy in Utilities 360, the same is defaulted here. You can choose to change your selection.
2.2.7.2.11 Promise-to-Pay
What is Promise-to-Pay
Promise-to-Pay is a commitment from customer for payment of an outstanding receivable within a specified
time. Create, display and modify Promise-to-Pay plans in Utilities Financials. The table in this section displays
all open and closed plans for a contract account that is defaulted in utlities financials screen.
Click Create to open the Create Promise-to-Pay dialog screen. Following points describe the create dialog
screen in detail:
● If the customer has contract accounts with open items, these are displayed in the Open Items table.
● The advanced search filter displays four fields - Contract Account ID, Net Due Date, Company Code and
Contract. If a confirmed contract account is available, it is defaulted in the contract account ID field. If the
field is blank, then the open items table displays all available open items for all contract accounts of the
customer.
● The Open Items table displays details such as document number, amount, net due date, days past due
date and gross clearning.
● Select an item in the Open Items table to maintain other information for Promise-to-Pay .
● Under Promise-to-Pay Parameters, select the Category and the Reason and Confirmation are automatically
populated. All three fields, category, reason and confirmation are values maintained in the S/4HANA
system.
● In the Assign Payment Parameters section, the fields Open Items, Interest, Charges and Total Amount are
populated based on selection of category and reason.
● In the Assign Payment Parameters section, the fields First Payment On, No. of Dates (free text field) and
Payment Installments are enabled after the selection of category and reason.
● In the Assign Payment Parameters section, the field Maximum per Payment is enabled only if No of Dates or
Payment Installments are not specified.
● Click Payment Details to populate the installment amounts in the table. The validation for this amount is
performed in the SAP S/4HANA system and any success or error message is displayed in your cloud
solution.
● Click Create to finally create the Promise-to-Pay plan.
Display Promise-to-Pay
In the Promise-to-Pay tab in Utilities Financials, select a plan in the open items table. Details displayed in the
table include Payment Date (the date on which the payment is agreed upon during the plan creation), Amount
(the Promise-to-Pay amount agreed upon) and Status (whether the plan is paid or open).
● Change allows you to modify status of an existing plan. Enter the Levels of Fulfillment and maintain
comments (for example - 'changes to customer').
● Reactivate enables and activates a closed plan. The system prompts you to confirm if you need to
reactivate a plan.
● Select Withdraw to disable an open plan. You need to specify the Reason for Withdrawal and Initiator of
Withdrawal (for example if it is the company, customer and so on).
● Replace allows you to withdraw an existing plan and create a new plan.
Use Reversal to reverse open items. You can select specific open items for reversal so that they appear on the
account status of a customer.
The Reversal option is available on the Open Items table under Utilities Financials screen and on the Account
History table under Utilities Collections screen of a customer.
Use Deferral to defer open items. You can select multiple open items for deferral.
The Utilities Collections tab displays the collection details of the selected individual customer.
You can view details such as total balance, must pay amount, credit worthiness, and security deposit related to
the customer. By default, the latest or the highest number of contract account is displayed. You can select a
different contract account if you want.
The Creditworthiness Details link displays the selected customer's creditworthiness in the past one year.
● Dunning History - Displays the dunning activity of the customer. As an agent, you can simulate dunning to
inform a customer about the next dunning step for an unpaid item.
● Correspondence History
● Account History - Use Reversal to reverse open items. You can select specific open items for reversal so
that they appear on the account status of a customer.
Service order details include the service order number, contract account, contract, division, reason, date and
status.
Note
If you check the flag Create Service Order during move-in create, a new service order is created for the
corresponding move-in. Refresh the list to view the new service order.
An agent can select an order code for a service order. This enables a better understanding of the purpose of the
service order.
Create a new service order using New to create a new service order. You need to enter the details such as the
service address, service type, start and end date & time, service order type, functional location and all the
required meter reading details. On saving your entries you will see that a new row has been added for new
service order in the Service Orders table.
Service Orders During Move-In, Move-Out and Transfer: Set the flag for Service Order to trigger creation of a
service order for a move-in, move-out and transfer. After successfully completing the transactions, you can
verify that a corresponding service order is created in your cloud solution and in S/4HANA system.
You can only change the start and end date & time for a service order using the menu option Actions
Change Service Order .
To cancel a service order, you need to invalidate the start and end date & time accordingly using Actions
Cancel Service Order
View the current rate category and billing parameters for a customer's contract in the Utilities Rate Change
workcenter view under Customers. In this workcenter view, select a contract and click on Rate Change to:
● Modify the rate category using selection help on the field Proposed Rate.
● Modify the Valid From date. This date is defaulted to one day later than the last billing date.
● View the following information (represented as installation facts in the SAP S/4HANA system):
○ Current Rate (you cannot modify the current rate but replace it with a new rate using the Proposed
Rate.
○ Last Billing Date (date of the last billed period; if no billed date is available, then the move-in date of the
contract is considered for Valid From date)
○ Installation (installation number)
○ Address (address of the connection object to which the installation is linked)
○ Division
○ Billing Parameters (this table displays the operand, operand description and operand category (such
as Amount, Factor, Integer, Discount, Quantity and so on).
Note
The TQUANT, REFVALUE, SEASON, RATE TYPE operand categories are not supported.
Prior to this release, it was possible to update rate change. Now, you can simulate rate change in the Utilities
Rate Change work center view. Click Simulate in the Rate Change dialog.
In the Rate Simulation dialog, you see details such as the scenario, default rate category, description, start and
end dates for bill period. The simulation result table lists all valid rate categories; Select a rate category as the
Proposed Rate Category for future dates.
In the Utilities Rate Change work center view, click Rate Change to navigate to the screen where you can
propose a new rate category. Once you are done with updates, click on Rate Change with MDT or Rate Change
based on implementation in your organization.
Administrators can now configure using master data template for custom implementation for rate change. Go
to Business Configuration Implementation Projects Your Project Edit Project Scope Questions
Industry Solution Utilities and select the scoping question - Do you want to use Master Data Template for
Rate Change?
Related Information
MDT Templates for Move-In, Customer, Contract Account & Rate Change Using Guided Processes [page 61]
Use the Utilities Payment Data tab to view and update the bank details of an individual customer.
Note
The New and Edit buttons in the Bank Data section can be controlled from the business actions. For more
information about business actions, see .
Note
For security reasons, only the last four digits of the bank account number are displayed.
While updating the bank details, you can provide a reason for changing the details.
Note
In Edit Bank Details, if you do not enter a new bank account number or IBAN, the old value is considered for
these fields. Additionally, if you update the bank account number without updating the IBAN details, the old
IBAN details are deleted.
The Contract Account Payment Method table in the Utilities Payment Data tab displays the payment details of
the contract account.
The Assign button on the Bank Data table allows you to assign the bank data to a customer with the payment
details. When you select a line item from the Bank Data table and click Assign, the Assign Contract Accounts
dialog box appears. Select the contract account for which you want to assign the bank data and save the
Note
The Incoming Payment Method and Outgoing Payment Method drop down menus display only the payment
methods that are related to the bank information.
The Utilities Owner Allocationtab of an individual customer displays all the properties that are owned by the
customer. For each property, you can also view the premise, installation and contract account details.
In the Utilities Service Notifications work center view in Customers , create, edit and even cancel a service
notification. The Create Service Order flag enables you to trigger creation of a parallel service order for a service
notification.
● Notification ID
● Notification Type
● Description
● Code Group
● Coding
● Functional Location
● Equipment
Note
Equipment ID is mandatory if you are creating service notification from the premise, particularly if you
want the service notification to trigger creation of a service order.
● Required Start
● Required End
● Customer ID
● Premise Address
● Premise Ext. ID
● Service Order ID
● Main Work Center
● Company Code
● Created By
● Created On
When creating the service notification, the customer is defaulted. You must enter the other mandatory values -
Premise Address, and Notification Type.
Note
An agent can select an order code for a service notification. This enables a better understanding of the
purpose of the service notification.Start Date
The Utilities Addresses tab helps you to view overview of addresses relevant for a customer.
The Utilities Addresses tab displays details of addresses relevant to the customer, along with the validity dates
and status.The Edit button on the All Addresses table allows you to edit the validity of addresses.
You can also view the corresponding usage types of the address selected along with the validity dates in the
Address Usages table.
The Utilities Communications Data tab helps you to view independent communication address details of a
customer.
The sections that appear on the Utilities Communications Data tab are as follows:
You can now create and edit address independent communication information such as phone numbers and
email addresses in the Utilities Communication Data screen of customer.
● If no independent comminictaion data available for the customer, then the table shows Addbutton and in-
case of alerady existing independent communictaion details, the table shows Edit button.
● You need to select the Do Not Useflag if the number is not in use.
● You can mark the phone number or email ID to be a primary one by using the Primary Telephone/Mobile or
Mainflags.
● You can not use Do Not Use flag, where only one data is available in the table.
View list of all phone numbers and email addresses related to the customer.
To enable Valid from and Valid to columns in the tables under Utilities Communications Data page, go to
Business Configuration Implementation Projects Your Project Edit Project Scope Questions Industry
Solution Utilities , and then select Utilities Call Center and Service. From Questions for Utilities Call Center
and Service, select Is Time Dependency for BP Independent Address Communication data enabled in ISU?
Relevant BPEM cases are displayed in the Utilities Exceptions tabs in Customer and Premise, respectively.
The exceptions generated in a ticket can be viewed in the Document Flow tab of the ticket and also under the
Utilities Exceptions tab in Customers (for the selected business partner ID) and Premise (for the selected
premise ID). Only exceptions relevant for customers or for the premise are displayed in the table. Click on a row
in the table to display detailed information for an exception. Use search or advanced search criteria to filter for
specific exceptions.
In the Utilities Exceptions tab of a service ticket, you can add up to five objects from Configurable Hierarchy to
create an exception.
You can view the BPEM Case ID in Utilities-Exception Management section of the service ticket.
Business Partner Exception Management (BPEM) - Integration with SAP ERP or S/4HANA System [page 190]
The Utilities Switch Documenttab displays all the switch documents for the customer - irrespective of the
document status and type.
Note
When you select the release flag for a new sales POD, it updates the status of the sales POD to Released
and subsequently the sales POD appears in the enrollment process..
You can
Note
You can also use type ahead search to select an address after typing only a portion of it. For detailed
information on Address Type Ahead Search, refer to
In the Sales POD work center, select the sales PODs and click Set Grouping under Actions.
Note
When the Sales POD is being uploaded using oData, it is mandatory to provide atleast one instance of
Grouping per Sales POD, in order to view the Sales POD in the Sales POD Work center.
In the Sales POD screen of Utilities view you can delete the Sales PoD, if the status is not set to Released.
You can also navigate to the selected Sales PoD screen and delete the grouping information if more than one
grouping entries are added under the same Sales PoD ID.
Note
To enable the feature for sales quote, you must scope the question Do you want to enable sales quote and
replicate point of delivery from your external application to your cloud solution?. This question scopes sales
quote, contract account and PoD in product selection. Further, you must also maintain the pricing and
other standard configuration for sales quotes.
Utilities sales quotes process provides these options: API to external pricing or standard integration to SD
pricing in S/4HANA system. Standard integration to create switch document as part quotation process and
exits are provided to allow projects to enhance the switch document. The five process steps are detailed in the
sections below:
Customer
Since you launch the wizard from Accounts/Individual Customer Sales Quotes , the customer name is
defaulted in the quote. Since the quote is utilities specific, the document type is defaulted to Utilities Lean
Quotation and the category determination displays only Quote for Enrollment for selection.
All involved parties including where the customer is a Bill-To or Ship-To are also listed here. Note that you must
enter a party with role Seller and Sales Unit for creating the quote using the wizard.
Premise
You need to use the Basic/Advanced Search to find premises. All valid premises for the customer in the cloud
solution are displayed for selection. All point of delivery (PoD) associated with the selected premise are
displayed as individual line items in the table.
If the product that you have selected has no division attached to it, an error message is displayed that
product for item is missing. You need to ensure that the product that you select is assigned to a division.
Product Proposal
In this process step, you can select products for each PoD line item. You can also select multiple line items and
use Set Product to apply a selected product for all the PoD line items. Similarly, you can use Set Contract
Account and Set Service Date to set the selected values for multiple PoD line items.
Note
The selection values displayed for contract account are locally retrieved from the cloud solution.
The Switch Type and Switch View are fields from S/4HANA system. You need to specify a switch type and
switch view for each PoD line item. The External PoD identifies the PoD in the S/4HANA IS-U system.
Pricing
Pricing determination is similar to that of a standard quote. You can also use Request External Pricing to fetch
external prices. Note that you need to implement the standard services for pricing apart from the services
delivered for the Utilities S/4HANA solution.
Review
Review terms and conditions, total pricing and the contract header details such as customer, validity, campaign
validity for customer, mailing address, etc. The Total is the cumulative price for all PoD line items.
Save the new sales quote. Use Actions Submit to submit the quote to S/4HANA. When you submit, a
switch document is created for each line item in S/4HANA and a confirmation for the quote is sent back to the
cloud solution.
Note
Prospect Customers: When you create a quote for a prospect customer using the enrollment process, On
Submit of a quote in the quotation enrollment process, the prospect customer is confirmed as a customer
in the solution.
You can now use Set as Lost or Set as Won options to set the status after submitting the quote. Set as Lost is
available as an action but Set as Won is set automatically when you submit the quote. Note that these options
will only be enabled if valid pricing information is available for the quote. The corresponding status for the
quote is updated based on these options.
Note
Update Switch Status: You can now trigger the update of swtich ID in the S/4HANA system. Under Sales
Sales Quotes Products use Actions Update Switch Status to update the switch ID in S/4HANA
after you submit the quote using the enrollment process. The on-premise S/4HANA system triggers a
notification to the cloud solution to update the switch document ID.
Related Information
Business Benefits
With the integration of sales POD (Point of Delivery) with sales quote, you can:
In the guided utilities processes (created using guided activity floor plans), when you save and submit the
quote request, a corresponding quote is created and displayed in the quotes overview list. In the Products
screen of the quote, the section - Market Communication Data displays Switch Document ID that is generated
from the on-premise backend system for the quote request.
The standard POD table in ISU-EUIHEAD is enhanced with the field SALES_POD_ID so that the project can
store the corresponding Sales POD ID. This also updates the Sales POD in Cloud for Customer with
corresponding ISU POD ID.
Launch the front office processes that you have configured in your S/4HANA system from your utilities cloud
solution. The Launch FOP action in the Customers toolbar launches the front office process that you have
configured and assigned for your utlities solution profile. For more information, see Configuring Front Office
Process.
Note
In order to use the front office processes, you need to have a minimum version for WEBCUIF 731 and also
implement the note 1890755 .
For more information on configuring front office processes, see the following topics:
In the guided move-in process, use the Create Move-In using MDT to use the master data template for creating
guided move-in. You will need this option if you have made custom changes to your move-in implementation
using the master data template. For more information on how to configure the master data template for move-
in, see the related links section below.
To use this feature, you need to scope the scoping question - Do you want to use Master Data Template for
Guided Move-In and Guided Transfer?.
Select this question if you need to use the master data template implementation in order to build-in custom
changes to guided move-in and guided transfer processes. When you select this question, the system fetches
In addition to scoping, the administrator needs to adapt the screens to use the Move-In Using MDT option. Two
options are provided - Move-In (which is set as default) and the Move-In Using MDT.
Further, also maintain the required configuration for MDT template in the Implementation Guide (IMG) for S/
4HANA system. For detailed information, see MDT Templates for Move-In, Customer, Contract Account & Rate
Change Using Guided Processes [page 61]
The Create Transfer using MDT allows you to create a guided move-in using MDT template during the guided
transfer process. You will find this option in the Review tab in the guided transfer.
Note
During implementation, you need to select one of the UI options - Create Transferor Create Transfer using
MDT. It is not possible to include and implement both the approaches together.
Note
A contract is automatically created only for a move-in as part of the transfer. To enable this, maintain the
required configuration for MDT template.
Further, also maintain the required configuration for MDT template in the Implementation Guide (IMG) for S/
4HANA system. For detailed information, see MDT Templates for Move-In, Customer, Contract Account & Rate
Change Using Guided Processes [page 61]
Related Information
MDT Templates for Move-In, Customer, Contract Account & Rate Change Using Guided Processes [page 61]
In the Utilities Rate Change work center view, click Rate Change to navigate to the screen where you can
propose a new rate category. Once you are done with updates, click on Rate Change with MDT or Rate Change
based on implementation in your organization.
Administrators can now configure using master data template for custom implementation for rate change. Go
to Business Configuration Implementation Projects Your Project Edit Project Scope Questions
Industry Solution Utilities and select the scoping question - Do you want to use Master Data Template for
Rate Change?
Related Information
MDT Templates for Move-In, Customer, Contract Account & Rate Change Using Guided Processes [page 61]
The Create Customer in the guided move-in allows you to create a new individual customer or account using
MDT. You will find this option in the Customer & Premise tab in guided move-in. Create a new customer by
enabling New Individual Customer or New Account flags. This enables the Create Customer in the toolbar. When
you enable creating a new individual customer or account, the creation dialog appears. The feature uses MDT
processes to allow a guided process experience in creating a new customer/account.
Further, also maintain the required configuration for MDT template in the Implementation Guide (IMG) for S/
4HANA system. For detailed information, see MDT Templates for Move-In, Customer, Contract Account & Rate
Change Using Guided Processes [page 61]
The Create Contract Account in Customers allows you to create a new contract account using the guided
transfer process. You will find this option in the toolbar for customers.
A new UI option - Edit Contract Account is provided. Use this option to edit your contract accounts. This
navigates to the Edit Contract Account dialog screen where you can modify and save your entries.
You can configure separate master data templates for move processes and installations.
In the guided move-in process, Create Move-In using MDT allows you to use different master data templates for
each of the installations in the Premise to create separate move in documents. You need to implement the Pre-
Badi to specify a different Master Data Template for each of the installation as per requirement.
Go to Business Configuration Edit Product Scope Industry Solution Utilities , and select Utilities Call
Center and Service.
In the Questions for Utilities Call Center and Service section, under Master Data Template, select the Do you
want to use a different master data template for each installation within guided move-in/guided transfer?
question.
Utilities solution uses the MDT template for creating a new customer and contract account in guided move-in
and for creating a contract account (during move-in) in guided transfer and also for rate change.
Note
For detailed information on the configuration, see the corresponding documentation for the IMG node
Configure MDT Template in the Implementation Guide configuration under IMG for SAP S/4HANA SAP
Utilities Cloud for Customer .
Follow these steps to configure MDT template for use in your utilities solution in SAP Cloud for Customer:
Prerequisites
1. Create an MDT template using transaction code EPRODCUST. You need to create the MDT template with
category assignment – NewCust (standard template delivered by SAP IS-Utilities). A series of hierarchical
nodes representing utilities objects (along with the field level assignments) is displayed in the template.
Utilities solution in SAP Cloud for Customer uses this assignment to create customer and contract account
in the guided process for move-in (creating customer and contract account) and transfer (creating
contract account).
2. Double click on a node to list the mandatory fields for an object (listed below in this document). You will see
that for each field name, you can update the Value. However, it is recommended to retain the naming
convention as given in the standard template. Note that you may assign different Services to these fields
depending on your business requirements.
If you need to add additional fields, ensure the naming convention mapping (as in the above screenshot) is
maintained in the pre-exit add-in method MDT_MVI_CREATE_PRE. Find details of the add-in below:
● BADI_COD_UTIL_MDT_MVI_CREATE
● IF_COD_UTIL_MDT_MVI_CREATE
● ISU_C4C_UTILITIES_MDT_MVI_CRT (MDT_MVI_CREATE_PRE and MDT_MVI_CREATE_POST)
For further details, see the documentation for the IMG activity in the SAP S/4HANA system.
Account Executive Dashboard contains information tiles to show corresponding list view of configured object
for the user’s key accounts.
To set up key accounts you can navigate to Account Team tab in the customer screen and add the name of
account executive as Party Role Employee Responsible.
Note
The list displays the objects of the customers and accounts for which the logged in user is the Employee
Responsible.
Account Executive Dashboard contains informational tile to show all the new and in process service orders for
the user’s key accounts.
You can also use basic and advance search fields to select desired service orders.
Account Executive Dashboard contains informational tile to show all the new and in process exceptions for the
user’s key accounts.
You can also use basic and advance search fields to select desired exceptions.
The section Utilities - Exception Management is added to the Overview tab for tickets. Select a case category
from the value help (drop down) and then click Generate Exception in the toolbar to automatically create a
business partner exception management (BPEM) exception case in the SAP ERP or S/4HANA system. The
case category that you select here determines the main object assigned. Therefore, understand business need
of your organization before selecting the appropriate case category.
You can also track the exception case under Document Flow tab in the tickets.
● Define the required case categories in the finetuning under Business Configuration Implementation
Projects Your Project Open Activity List Utilities .
● Do you want to enable creation of BPEM Certification Case under Business Configuration
Implementation Projects Your Project Edit Project Scope Questions Utilities Contact Center and
Service Utilities Exception Management .
As a part of BPEM finetuning you can now configure your own clarification case categories by setting the
primary object type in the SAP ERP or S/4HANA system and maintain the same case category in Cloud for
Customer finetuning under Business Configuration Overview Utilities Case Category Maintain Case
Category .
Note
The validation takes place as per the primary object type maintained in Cloud for Customer and is skipped
even if it is maintained in SAP ERP or S/4HANA System.
As an administrator, you can configure replication of BPEM status to SAP Cloud for Customer, so that service
tickets are closed automatically on the completion of an exception that is linked with the ticket.
1 New
2 In Process
3 Completed
4 Canceled
6 Confirmed
The following table describes the SAP Cloud for Customer case status:
1 Open
2 In Process
4 Customer Action
5 Completed
6 Closed
The default mapping of the BPEM case status to the SAP Cloud for Customer case status is as follows:
BPEM Case Status Code SAP Cloud for Customer Case Status Code
1 1
2 2
3 4
4, 6 6
To register an event handler for the BPEM case in S/4H, in the SWE2 transaction code, do the following:
If you want to change the default mapping the BPEM case status to the SAP Cloud for Customer case status,
implement the following BAdI:
● In S/4H - isu_c4c_bpem_status
You can view the Contract Account, Premise and PoD details in the Utilities - Objects section group, under
Overview tab of service ticket screen. You can also navigate to the respective contract account and premise
In addition to this you can also view the details of premise address under the Utilities - Premise Address section
group.
A detailed Service Location section is now available in the Overview tab of ticket based on the premise selected.
This enables visibility to the field level information for the selected premise.
You can now use the logs in S/4HANA system to track updates performed in the Utilities Financials screens.
Use transaction code AUT10 to view a log of all the updates performed in your utilities cloud solution. Use
change object ISU_C4C to view the updates. You can also enter a specific date or date range to look up for the
updates in the log.
New CDS View ISU_C4C_AUDIT_V is introduced to display details of Audit logs captured in various change
document tables under single View. The main technical enhancements include:
● Creation of new CDS View ISU_C4C_AUDIT_V with following changes in document tables CDHDR, CDPOS,
ISU_C4C_AUDITLOG.
● Table ISU_C4C_AUDITLOG was developed to overcome challenges pertaining to duplicity and high volume
of change documents in log tables CDHDR & CDPOS in process for capturing change documents.
● The new view enables you to fetch and display header, item, and other user details of changes captured
during a transaction based on change document number.
Depersonalization is only available for users with access to the Data Protection and Privacy work center.
The Data Privacy Management tab allows those responsible for data protection issues in an organization to
respond to personal information removal and disclosure.
Various considerations apply for deletion of personal data in contract accounts and sales POD. These are:
● When a business partner is deleted in your solution, the corresponding business partner ID in contract
account and sales POD are depersonalized or removed.
● When logged in with data privacy officer (DPO) authorizations, the Delete icon is displayed to the DPO in
contract account and sales POD work center views. These users can use this option to delete a contract
account or sales POD,
● If a sales POD/contract account are used in a sales quote, then a VETO is raised and hence sales POD or
contract account cannot be deleted in the system.
● Similarly, a VETO is raised if a business partner in sales POD or contract account is blocked for deletion.
10 Control Reading
26 Contract change
27 Customer Change
90 Start of simulation
91 End of simulation
1 Billable
2 Automatically Locked
3 Locked by Agent
4 Released by Agent
5 Checked Independently
7 Billed
* Partially Billed
Transaction Function
Transaction Function
2.3 Extensibility
You can extend both the UI screens and the functionality for Utilities Contact Center using the extensibility
framework.
Use PDI extensibility framework to extend UI screens. For functional extensions, SAP predelivers Business Add-
Ins that you can implement to add or modify features.
You cannot add a KUT field with default value for Utilities Contact Center.
Utilities Contact Center provides business add-ins for both the IS-Utilities backend system and the cloud
solution backend that you can implement for functional extensions.
All the Extensions mentioned in this section extend the Utilities Extensibility BO. The following processes
extend the Utilities Action BO (not Utilities Extension BO):
The following actions of Guided Application Framework can be extended using UtilitiesActionBO. Pre-
Validations are also possible for these actions.
● Move-In
● Move-Out
● Transfer
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Note
You can use the same implementation for display and edit of contract blocks. For display, the parameters
required are CUSTOMER_REMOTE_ID, CA_REMOTE_IDType and UTIL_CONTRACTS_TAB. For edit,
additional parameters include UTIL_CONTRACTS_OLD_TAB, ACTION_CODE and
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Note
The same implementation can be used for Create, Edit and Display of contract account locks. For display,
the required parameters are UTIL_CA_LOCKS_TAB, CONTRACT_ACCTID and CUSTOMER_ID. For create,
additional parameters include ACTION_CODE and UTILITIES_MESSAGE_TAB. Note that the action code 02
has to be set after the BAdI implementation for create of contract account locks. For edit, the same
parameters as that used for create (display + create) apply apart from an additional parameter -
UTIL_CA_OLD_LOCKS_TAB. Note that the action code 03 has to be set after the BAdI implementation for
edit of contract account locks.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Note
The same implementation can be used for Create, Edit and Display of contract locks. For display, the
required parameters are UTIL_CONTRACT_LOCKS_TAB, CONTRACT_ACCTID, CUSTOMER_ID and
CONTRACT_ID. . For create, additional parameters include ACTION_CODE and UTILITIES_MESSAGE_TAB.
Note that the action code 02 has to be set after the BAdI implementation for create of contract account
locks. For edit, the same parameters as that used for create (display + create) apply apart from an
additional parameter UTIL_CONTRACT_OLD_LOCKS_TAB. Note that the action code 03 has to be set after
the BAdI implementation for edit of contract locks.
List of business add-ins for the functionality under Utilities Financials work center view.
Account Overview
Use this business add-in exit Utilities Financial Account Overview to extend the Account Overview service
with financial specific data. The input provides the customer remote object ID, date range filter, filter flags for
data and filter for confirmed objects. The output expected should contain data (If available) for at least: the
following: Invoice History, Payments, Total Balance, Overdue Amount, Open Items, Installment Plan, Contract
Account, Installments.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this business add-in exit to implement an alternative approach to reversing an invoice. Note that the
appropriate messages must be created through the output message structures.
Enhancement Imple
mentation Business Object Namespace Input Parameters Output Parameters
● InvoiceNow
● BillNow
● InvoiceSimulation
● SubmitMR
● InvoiceMR
● BillAndInvoice
● FullReversal
● AdjustmentReversal
If the FullReversalflag is set to true, then the ISU service shall be triggered after the badi call. For example, If
FullReversal flag is set to ‘True’, then the ISU service shall be triggered for Full Reversal after this Badi is
executed.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI exit for an alternative approach adjust reversing a billing document. Note that the appropriate
messages must be created through the output message structures.
● InvoiceNow
● BillNow
● InvoiceSimulation
● SubmitMR
● InvoiceMR
● BillAndInvoice
● FullReversal
● AdjustmentReversal
● Rebill
● UpdateMR
If the AdjustmentReversal flag is set to true, then the ISU service shall be triggered after the badi call. For
example, If AdjustmentReversal flag is set to ‘True’, then the ISU service shall be triggered for Adjustment
Reversal after this Badi is executed.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
This BAdI is responsible to fill in the retrieved meter reading results through the output. Use this BAdI to
implement a different approach to fetch meter readings for the corresponding invoice selected.
Use this BAdI exit to implement a different approach to edit and save the meter reading results. The
appropriate messages have to be provided through the output structures.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI exit for an alternative approach to the rebill function. The appropriate messages have to be
provided through the output structures.
● InvoiceNow
● BillNow
● InvoiceSimulation
● SubmitMR
● InvoiceMR
● BillAndInvoice
If the Rebill flag is set to true, then the ISU service shall be triggered after the badi call. For example, If Rebill flag
is set to ‘True’, then the ISU service shall be triggered for Rebill after this Badi is executed.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
The flag ExecuteService has been introduced in the output parameter UtilitiesFinancialsBadiInput. This flag
has the action parameter UpdateMR If the ExecuteService. UpdateMR is set to true, then the ISU service shall
be triggered after the BADI call.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI exit for implementing an alternative approach to perform the estimate functionality on meter
reading result. The appropriate messages have to be provided through the output structures.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI exit to implement an alternative approach to performing the override function on meter reading
result. The appropriate messages have to be provided through the output structures.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI exit to implement an alternative approach to fetch the locks for a corresponding open document.
The BAdI needs to fill the lock details through output structures.
New structure ExecuteService has been introduced in the input parameter UtilitiesFinancialLockBadiResult.
This structure has the below indicator flag:
● CreateLock
● DisplayLocks
● EditLock
● Delete
If the DisplayLocks flag is set to true, then the ISU service shall be triggered after the BAdI call. For example, If
DisplayLocks flag is set to ‘True’, then the ISU service shall be triggered for Display Locks after this Badi is
executed.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI exit to implement an alternative approach to create the locks for a corresponding open
document. The appropriate messages have to be provided through the output structures.
● CreateLock
● DisplayLocks
● EditLock
● Delete
If the CreateLock flag is set to true, then the ISU service shall be triggered after the BAdI call. For example, If
CreateLock flag is set to ‘True’, then the ISU service shall be triggered for Create Lock after this BAdI is
executed.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI to implement an alternative approach to edit the locks for a corresponding open document. The
appropriate messages have to be provided through the output structures.
● CreateLock
● DisplayLocks
● EditLock
● Delete
If the EditLock flag is set to true, then the ISU service shall be triggered after the badi call. For example, If
EditLock flag is set to ‘True’, then the ISU service shall be triggered for Edit Lock after this Badi is executed.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI to implement an alternative approach to delete the locks for a corresponding open document.
The appropriate messages have to be provided through the output structures.
New structure ExecuteService has been introduced in the input parameter UtilitiesFinancialDelteLocksResult.
This structure has the below indicator flag:
● CreateLock
● DisplayLocks
● EditLock
● Delete
If the Delete flag is set to true, then the ISU service shall be triggered after the badi call. For example, If Delete
flag is set to ‘True’, then the ISU service shall be triggered for Delete Lock after this Badi is executed.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this add-in to implement an alternative approach for the function on installment plan. This exit needs to fill
the action code (mandatory) in the output structures to correspond the action performed in add-in. The
● Edit
● Cancel
● Create
● Simulate
The above mentioned ‘Execute’ flag works in combination with the Action Code. If the execute flag is set to true
(for the corresponding action code), then the ISU service shall be triggered after the badi call. For example, If
Action Code is ‘2’ and ExecuteServiceIndicator. CreateInstallmentPlan is set to ‘True’, then the ISU service shall
be triggered for Create Installment plan after this Badi is executed.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameters Output Parameters
Use this add-in to implement an alternative approach to perform billing operations. This exit needs to fill the
action code (mandatory) in the output structures to correspond the action performed in add-in. The
appropriate messages have to be provided through the output structures. This add-in handles the following
actions as per the action codes:
The above mentioned ‘Execute’ flag works in combination with the Action Code. If the execute flag is set to true
(for the corresponding action code), then the ISU service shall be triggered after the BADI call. For example, If
Action Code is ‘01’ and ExecuteServiceIndicator. Submit_MR is set to ‘True’, then the ISU service shall be
triggered for Submit Meter Reading after this Badi is executed.
Enhancement Imple
mentation Business Object Namespace Input Parameters Output Parameters
Enhancement Imple
mentation Business Object Namespace Input Parameters Output Parameters
● CustomAction : flag
● ActionName : Text field
Enhancement Imple
mentation Business Object Namespace Input Parameters Output Parameters
Structure UtilitiesInvoices has been introduced in the input parameter UtilitiesFinancialActionsBADiInput and
output parameter UtilitiesFinancialActionsBadiResult.
● CustomAction : flag
● ActionName : Text field
The UtilitiesFinancialActionsBadiResult has the parameter SkipActions. When the SkipActions, ManualPosting
is set to false, then the ISU service shall be triggered after the BADI call.
2.3.1.3 Premise
List of business add-ins for the functionality under Premise work center view.
UtilitiesPremise
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI exit for extending the Premise Service. The input provides the Premise UUID and the Remote
Object ID, and the output expected should contain data (If available) for at least the following:
1. The ID for an “Object Hierarchy” object of type “Installation / Point of Delivery” should be maintained
as "<INSTALLATION ID> / <POD ID>”, (Eg: “11678 / 20000012”)
2. The TYPE_CODE for objects in the object hierarchy must be maintained as follows:
2 Device
UtilitiesPremiseCancelMoveInMoveOut
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI exit for implementing an alternative approach for cancelling a Move In or a Move Out action. The
appropriate messages have to be provided through the output.
Note
● The flag CANCEL_MOVE_IN_IMPL should be marked “true” if “Cancel Move In” has been implemented.
● The flag CANCEL_MOVE_OUT_IMPL should be marked “true” if “Cancel Move Out” has been
implemented.
UtilitiesPremiseEditMoveInMoveOut
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this business add-in exit to implement an alternative approach for editing a Move In or a Move Out action.
The appropriate messages have to be provided through the output.
● The flag EDIT_MOVE_IN_IMPL should be marked “true” if “Edit Move In” has been implemented.
● The flag EDIT_MOVE_OUT_IMPL should be marked “true” if “Edit Move Out” has been implemented.
UtilitiesPremiseMoveIn
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI exit to implement an alternate approach for Move In action. The appropriate messages have to be
provided through the output.
Note
UtilitiesPremiseMoveOut
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this BAdI exit to implement an alternative approach for Move Out action. The appropriate messages have
to be provided through the output.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this business add-in exit for extending the Installation Service. The input provides the Premise External ID
and the Installation ID, and the output expected should contain data for the provided installation (If available)
for at least: the following:
● Installation (UtilitiesInstallationDetails)
● Device (UtilitiesInstallationDeviceDetails)
● Meter Reading (UtilitiesInstallationDeviceRegisterDetails)
UtilitiesInstallationEstimateMeterReading
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this business add-in exit to implement an alternative approach estimating meter readings. The appropriate
messages have to be provided through the output. The output structure MR_ESTIMATES should contain the
requested meter reading estimates.
The flag ExecuteAction has been introduced in the output parameter UtilitiesInstallationBadiResult. This flag
has the estimate component. If the execute flag is set to true for estimate ,then the ISU service shall be
triggered after the badi call.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this business add-in exit to implement an alternative approach for overriding meter readings. The
appropriate messages have to be provided through the output.
The flag SkipAction has been introduced in the output parameter UtilitiesInstallationBadiResult. This flag has
the override component. If the skip flag is set to true for override ,then the ISU service will not be triggered after
the badi call.
UtilitiesInstallationUpdateMeterReading
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Use this business add-in exit to implement an alternative approach for updating meter readings. The
appropriate messages have to be provided through the output.
The flag SkipAction has been introduced in the output parameter UtilitiesInstallationBadiResult. This flag has
the update component. If the skip flag is set to true for update ,then the ISU service will not be triggered after
the badi call.
UtilitiesPremiseActions
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
UtilitiesDisconnectionDocuments
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
2.3.1.4 Contracts
Overview of Business Add-In exits for the Utilities Contracts work center view functionality.
Note
The ACTION_CODE value will be sent from the cloud solution to PDI to set the condition for BADI
implementation. After any BADI implementation, ACTION_CODE is to be sent back to the cloud solution to
determine the action for which the add-in is implemented.
Note
The display contract account is retrieved locally in the cloud solution using buffer and therefore BADI is not
implemented for display of contract account.
Note
The ACTION_CODE value will be sent from the cloud solution to PDI to set the condition for BADI
implementation. After any BADI implementation, ACTION_CODE is to be sent back to the cloud solution to
determine the action for which the add-in is implemented.
Move-Out
Transfer
Edit Move-In
Cancel Move-In
Override
2.3.1.5 Collections
Overview of Business Add-Ins that exist for the Utilities Collections work center view functionality.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
UtilitiesAccountHistory
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
UtilitiesCorrespondenceHistory
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
UtilitiesCorrespondenceHistoryActions
Business Add-In:UtilitiesCorrespondenceHistoryActions
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
UtilitiesSecurityDepositActions
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
UtilitiesSecurityDeposit
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
UtilitiesReturns
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Overview of business add-in exits for service orders. BAdI exits are provided for service orders overview, create
and change. As the cancel service order pop up is just a text box, BAdI is not provided for cancel.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Note
The ACTION_CODE value will be sent from the cloud solution to the PDI to set the condition for BADI
implementation. After the BADI implementation, the ACTION_CODE must be sent back to the cloud
solution to determine the action for which BADI is implemented.
The flag ExecuteService is added in the input structure UtilitiesServiceOrderBadiInput and the ExecuteService
flag has below components:
Note
The ACTION_CODE value will be sent from the cloud solution to the PDI to set the condition for BADI
implementation. After the BADI implementation, the ACTION_CODE must be sent back to the cloud
solution to determine the action for which BADI is implemented.
Business add-ins for functionality available under Utilities 360 work center view.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
The hierarchy is built in the standard delivery. Use this BAdI exit for extending the Utilities 360 data fetch
service. The input provides the Customer remote object ID, filter flags for data as per POD, premise and
Contract Account. The output expected should contain data (if available) for at least:
Enhancement
Implementa Business Ob Input Parame Output Param
tion ject Namespace Interface Method ter eter
UtilitiesCustomerHistory
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Utilities Locks
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Business Add-In:UtilitiesBPEMActions
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
BAdI Definition Semantic Name Business Object Namespace Input Parameter Output Parameter
BAdI Definition Semantic Name Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
The flag SkipAction has been introduced in the parameter UtilitiesRateCategoryChangeBADIInput. If the skip
flag is set to true for override ,then the ISU service will not be triggered after the badi call
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
The flag SkipAction has been introduced in the parameter UtilitiesInstallationFactsBADIInput. If the skip flag is
set to true for override ,then the ISU service will not be triggered after the badi call
Note
: Utilities Addressesand Utilities Communication Data screens have a common BADI. If the BADI is
implemented then data in both facets needs to be passed from PDI.
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Enhancement Imple
mentation Business Object Namespace Input Parameter Output Parameter
Overview of business add-in exits for switch documents created for utilities guided quote.
Use this business add-in exit for extending the functions for both create and fetch for the switch document
from the S/4HANA system.
COD_UTILITIES_QUOTE_NOTIF_PORT
Business add-in exit for extending implementation for product proposal in the enrollment process.
Use this Business Add-in exit to propose product for each line item in the Enrolment GAF based on existing and
custom fields available in quote. The input data has the UUID of the quote line item and the output should have
the quote line item UUID and the corresponding Product ID that has to be defaulted against that line item.
Customer Search
Use the Customer Search add-in to extend the customer search feature.
You can add custom fields to the Move In and Move Out tables under the Services step of GAF Move processes
by following the below process of Auto-mapping.
1. Add custom fields in Cloud for Customer and note the ES Names for the same.
2. Implement the post business add-in in S/4HANA under Function Module ISU_C4C_VALUE_HELP.
3. Send the ES Name for each field in extension data
1. In the post bAdi implementation, populate the ES Name of the Cloud for Customer custom field in the
fieldname and corresponding value in fieldvalue.
Note
Auto mapping of custom fields is only applicable for element data types.
Note
New Contract Account Indicator and Mailing Address Indicator flags are released to be consumed in PDI.
These flags once set in PDI shall behave as per the logic in PDI (In After Modify Event - which would be
called every time a field changes on the UI).
Use the step-by-step guide to create projectspecific extensions for screens where online transactions are
involved. The Utilities Contact Center uses the PDI tool for creating UI extensions and does not support UI
extensions using KUT (the standard framework for UI extensions in SAP Cloud for Customer).
Note
UI extensions are possible only if a corresponding field exists and is also editable in the SAP Cloud for
Customer utilities solution.
Note
For Utilities Collections tab, changes are made to the event handler of inport FromUtilitiesCollections. So, to
reuse the EC’s of Collections tab such as Dunning History, Correspondence History, Account History,
Returns, WriteOffs, and Security Deposit in different screens, the Inport FromContractAccount to be used.
Prerequisites
● Use the latest PDI tool whose version corresponds to the release version of SAP Cloud for Customer.
●
Create a new PDI solution, maintain the mandatory fields and save the new solution.
Under Installed Templates SAP Extension Business Object Extension , specify the name of the
extension object.
You have now added the extension object into your solution (as seen in the graphic below)
In the screenshot below, you will see the example for a contract node added with an extension field and another
extension field is added in the Meter Reading sub-node within the contract node. Note that since the contract
node is associated with move in /move out/ transfer, the extension field added here can be reused in the
contract table/move in screen/move out screen etc. This will complete the addition of extension field in the
SAP Cloud for Customer backend system.
To add the extension fields to UI screen, right click on the .xbo file extension and choose Enhance Screen (see
screenshot below) .
In the step 5, you opened the floor plans for the UI screens where you need to add the extension fields. This
opens up the UI designer.
In the UI desginer,
1. Select the section group/anchor where you want to add the new extension field
2. Click on Extensibility Explorer Tab Add Extension Field to List .
3. Select the extension field you want to add and apply.
Open the UI screen to see the new extension field (as seen in the screenshot below).
Since these UI screens involve online transactions, you need to create a service interface to S/4HANA using
web service. To do this, upload the WSDL that is imported from the S/4HANA and create the service interface
under Solution Explorer Add Item Service Integration External Web Service Integration .
For detailed information, see Web Services Quick Guide under http://help.sap.com/
saphelpiis_studio_1508/KTP/Products/bf889ebdf45d4dd19d4a0e0bd39a07fb/LibraryStructure/
SAP_BBD_Studio.html
To integrate the web service interface with S/4HANA system, you need to create a communication scenario.
For detailed information, see the Web Services Quick Guide under http://help.sap.com/
saphelpiis_studio_1508/KTP/Products/bf889ebdf45d4dd19d4a0e0bd39a07fb/LibraryStructure/
SAP_BBD_Studio.html
As a next step, you need to select the valid business add-in implementation. You can do this under Solution
Explorer Add Item Implementation .
Sample BADI implementation looks like the screenshot below where we call the Service -> Get the Response ->
Map it to the extension field -> Display on the UI.
An implementation-friendly extensibility concept is available for utilities. The approach enables you to extend
your solution by extending standard tables and does not require any significant PDI or backend
implementation.
● Standard RFCs provided with a table-type structure where you can add extension data.
● Creating new RFCs and configuring WSDLs in PI system not required.
● No additional configuration required for outbound service creation in PDI.
To implement the BAdI in SAP Cloud for Customer, follow these steps:
1. Extend the Utilities Extensibility BO, using the SAP Cloud Application Studio.
1. Log on to the SAP Cloud Application Studio, add a new item, and then enter the name of .xbo.
3. Add the extension field to the node where the enhancement is to be implemented—use the following
business object etension code snippet to extend the invoice node with an invoice description extension
field.
The extension value is fetched from the ERP service BAdI implementation.
4. Extend the ERP ISU BAdI provided for the functional modules.
1. In the Display service do the following:
1. Create an active BAdI implementation for COD_UTILITIES_ERP_CUST_BADI of the
ISU_C4C_ACCOUNT_OVERVIEW web service.
The data sent from ERP is passed to the extension field from PDI, and displayed in SAP Cloud for
Customer:
The services listed in the following table are supported with new extensibility framework. For a list of all services
for utilities contact center, see the worksheet for Utilities in the Attachments tab under SAP Cloud for
Customer
For a complete list of utilities web services, see SAP Cloud for Customer.
You can now create Custom Actions for the following options:
To implement custom actions in Disconnection Documents screen of Utilities Premisepage, follow these steps:
1. Create a custom action within the Extension Business Object for corresponding
node(UtilitiesDisconnectionDocuments is used here for reference)
3. Pass the custom action name (as per your preference; the name given here is “ActionNameTest”) to the
CallAction and activate the absl file as well as xbo.
4. Implement the corresponding action BADI and write custom action logic in it.
Due to change in business landscape there is a need to provide some important views under contract account
as well.The information visible would be pertaining to the relevant contract account only
3.1.1 Central
This tab displays cards such as Recent Invoices, Last Payment, Premises, Locks, Recent Tickets, Open Items,
Customer Credit Worthiness, Security Deposit, and Dunning.
Note
If you click the Recent Invoice card title, it opens Convergent Invoice tab.
● Create or add items for Recent Invoices, Last Payment, and Recent Tickets.
● View the recent invoice PDF by selecting the Hyperlinked invoice item in recent Invoice card.
● View the graph based on the period against number of items in Open Items card.
● The Customer Credit Worthiness card displays the score for the current month and the comparison with
the previous month.
View all convergent invoices for contract account in Convergent Invoice tab.
The convergent invoice is also enabled in central tab to view the recent convergent invoices of contract
account.
Hyperlinks
Some links are classified by an icon and/or a mouseover text. These links provide additional information.
About the icons:
● Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your
agreements with SAP) to this:
● The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.
● SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.
● Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering a SAP-hosted Web site. By using such
links, you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this
information.
Example Code
Any software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax
and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of
example code unless damages have been caused by SAP's gross negligence or willful misconduct.
Gender-Related Language
We try not to use genderspecific word forms and formulations. As appropriate for context and readability, SAP may use masculine word forms to refer to all genders.
SAP and other SAP products and services mentioned herein as well as
their respective logos are trademarks or registered trademarks of SAP
SE (or an SAP affiliate company) in Germany and other countries. All
other product and service names mentioned are the trademarks of their
respective companies.