You are on page 1of 526

PUBLIC

Document Version: CLOUD – 2023-09-24

Utilities Contact Center Administrator Guide


© 2023 SAP SE or an SAP affiliate company. All rights reserved.

THE BEST RUN


Content

1 ERP Edition for Utilities Contact Center. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4


1.1 Configuration and System Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Scope and Configure SAP Cloud for Customer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
Configure Middleware. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Configure Integration with ERP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
1.2 Functional Scenarios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
Customer Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Live Activity Center and Enterprise Search. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Move Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Alerts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Premise. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107
Contract Accounts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Utilities Views in Customers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Sales POD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
Front Office Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
MDT Based Processes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Account Executive Dashboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .183
Business Partner Exception Management (BPEM) - Integration with SAP ERP or SAP S/
4HANA System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
Audit Trail - Logs in ERP System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
Depersonalization in Contract Account and Sales POD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
Appendix with List of Relevant ERP Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
1.3 Extensibility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Functional Extensions Using Business Add-Ins. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
UI Extensions for Utilities Online Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
(Optional) Extend Your Solution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .237
Utilities Web Services for Extensibility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
Custom Action. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
1.4 Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247

2 S/4HANA Edition for Utilities Contact Center. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248


2.1 Configuration and System Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Scope and Configure SAP Cloud for Customer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Configure Middleware. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Configure Integration with S/4HANA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
2.2 Functional Scenarios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .305
Customer Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306

Utilities Contact Center Administrator Guide


2 PUBLIC Content
Live Activity Center and Enterprise Search. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307

Move Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .312

Alerts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326

Premise. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327

Contract Accounts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .338

Utilities Views in Customers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354

Sales POD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .396

Front Office Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401

Master Data Template-Based Processes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402

Account Executive Dashboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406

Business Partner Exception Management (BPEM) - Integration with SAP ERP or SAP S/
4HANA System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407

Audit Trail Logs in S/4HANA System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412

Depersonalization in Contract Account and Sales POD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .413

Appendix with List of Relevant S/4HANA Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413

2.3 Extensibility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415

Functional Extensions Using Business Add-Ins. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416

UI Extensions for Utilities Online Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454

(Optional) Extend Your Solution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463

Utilities Web Services for Extensibility Purposes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469

Custom Action. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .470

2.4 Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473

3 Cloud for Utilities Edition for Utilities Contact Center. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474

3.1 Configuration and System Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474

Scope and Configure Cloud for Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475

Configure Middleware. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483

Configure Integration with Cloud for Utilities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .485

3.2 Functional Scenarios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .495

Customer Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495

Alerts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496

Premise. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497

Contract Accounts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .506

Utilities Views in Customers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519

Front Office Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523

Utilities Contact Center Administrator Guide


Content PUBLIC 3
1 ERP Edition for Utilities Contact Center

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 back end, supports
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 graphic displays a transactional overview with ERP IS-Utilities:

Integration with SAP ERP Transactional Scenario View

The following table details the software compatibility matrix for SAP Cloud for Customer Utilities Contact
Center.

Utilities Contact Center Administrator Guide


4 PUBLIC ERP Edition for Utilities Contact Center
Minimum Software Requirements
SAP Cloud for
SAP Cloud for Customer ERP Add- Feature Specific
Customer On ERP PI Content Add-On (Higher EHP Req)

2205 SAP Cloud for Minimum ERP 6.0, PI 7.11 • EHP2 for Ex-
Customer Add-On EHP 0 change Rate Cur-
CODERINT 600  Note rencies
(COD_ERP_INT 6.00),
Support Package 65
Ensure that you • Adobe Document
have downloaded Server for preview
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 (SP41) sales documents
(Interface in opportunity,
Definitions for quote, and ac-
SAP Cloud for count

Customer for • EPH2 to view


sales order details
Utilities Con-
in the opportu-
tact Center)
nity, quote, and
• XI CONTENT account
COD_ERP_IN
• EHP3 to view
T 6.00
sales quote de-
(SP40) (ERP
tails in the op-
Interface Defi-
portunity and ac-
nitions)
count
• XI CONTENT
COD_ERP_IN
T_IC 6.00
(SP40) (Map-
ping, Tem-
plates, and
Scenarios)

1.1 Configuration and System Setup

The topics below provide a detailed overview of the configuration required to setup the utilities contact center.

Scope and Configure SAP Cloud for Customer [page 6]


Administrators can configure the utilities contact center using scoping, scoping questions, and fine-
tuning activities.

Configure Middleware [page 26]


Learn about the configuration of middleware.

Configure Integration with ERP [page 42]


An overview of how to configure integration with ERP system.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 5
Related Information

Assign Work Centers to Business Users [page 18]


Work center assignment to business users based on their roles.

1.1.1 Scope and Configure SAP Cloud for Customer

Administrators can configure the utilities contact center using scoping, scoping questions, and fine-tuning
activities.

Scoping [page 7]
To set up your SAP Cloud for Customer system to support Utilities Contact Center solution, scope your
implementation project accordingly.

Replicate Utilities Master Data [page 18]


You can execute reports to transfer data from IS-Utilities system to the Utilities Contact Center cloud
solution.

Assign Work Centers to Business Users [page 18]


Work center assignment to business users based on their roles.

Configure the Alerts Tab [page 19]


As an administrator, use adaptation to add the Alerts tab.

Configure Scripts for Move Processes [page 20]


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.

Configure Utilities 360 [page 22]


As an administrator, you can configure the views for Recent History and Hierarchy sections under
Utilities 360 screen of a customer.

Configure Safety Message for Reconnect [page 24]


As an administrator, you can configure a safety message to reconnect the AMI smart meter.

Configure Mashup for Front Office Process (FOP) [page 24]


To integrate the front office processes with your SAP ERP system, you must create and configure a new
mashup.

Configure Smart Energy Water [page 25]


Configure the Communication Preferences, Consumption Graph, Outage map, and Compare tabs from
SAP Cloud for Customer to integrate the Smart Energy Water (SEW) with SAP ERP system .

Configure Message Severity for Move Processes [page 26]


As an Administrator, configure the severity of the messages received during the move process. You can
also suppress the message if you do not want them to display.

Utilities Contact Center Administrator Guide


6 PUBLIC ERP Edition for Utilities Contact Center
1.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.

1.1.1.1.1 Prerequisites for Configuring Utilities Contact


Center

This section lists the prerequisites to configure the Utilities Contact Center.

Integration Setup for 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.

IS-Utilities Configuration in ERP System

The required configuration must have been set up in IS-Utilities in the ERP system.

1.1.1.1.2 Enable the Utilities Industry Solution

To begin scoping and to scope the solution, go to Business Configuration Implementation Projects .
Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities 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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 7
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 .

1.1.1.1.3 Configure Utilities Lean Quotation

As an administrator, configure the utilities lean quotation.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Quotation, select the scoping question Do you want to enable utilities lean quotation and replicate point
of delivery from your external application to your cloud solution?

If you’ve scoped this question, you must also scope the following questions:

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Question step navigate to:

• Sales New Business Sales Quotes , select all the scoping questions.
• Sales New Business Communication for New Business and under Sales Order Forms, select the
scoping question You can use a template to send sales quotes to your customers.
• Communication and Information Exchange Integration into Sales, Service and Marketing Processes ,
select the corresponding scoping questions:
• 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?
• Configure PoD replication (see documentation under Technical Objects Replication).

1.1.1.1.4 Configure Internal Pricing for Utilities Lean


Quotation

As an administrator, configure internal pricing for utilities lean quotation.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and
under Utilities Quotation, select the scoping question Do you want to enable Internal Pricing for Utilities Lean
Quotation?

Utilities Contact Center Administrator Guide


8 PUBLIC ERP Edition for Utilities Contact Center
1.1.1.1.5 Configure the Replication of Point of Delivery

As an administrator, configure the replication of Point of Delivery (PoD).

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Technical Master Data Replication, select the scoping question Do you want to replicate point of delivery data
from your external application to your cloud solution?

1.1.1.1.6 Configure to use Premise External ID as the


Internal ID in SAP Cloud for Customer

As an administrator, configure to use premise external ID as internal ID in cloud solution.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Technical Master Data Replication, select the scoping question Do you want to use Premise External ID as the
Internal ID in C4C?

1.1.1.1.7 Configure Master Data Template to Customize


Rate Change

As an administrator, you can configure the use of master data template to customize rate change in the
solution.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Master Data Template, select the scoping question Do you want to use Master Data Template for Rate Change?

1.1.1.1.8 Configure Master Data Template for Guided Move-


In and Guided Transfer

As an administrator, you can configure the use of master data template for guided move-in and guided transfer.

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.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 9
In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Master Data Template, select the scoping question Do you want to use Master Data Template for Guided
Move-In and Guided Transfer?

1.1.1.1.9 Configure Different Master Data Templates for


Move Processes

You can configure separate master data templates for move processes and installations.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Master Data Template, select the scoping question Do you want to use a different master data template for each
installation within guided move-in/guided transfer?

1.1.1.1.10 Configure the Creation of BPEM Clarification Case

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 Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and
under Utilities Exception Management, select the scoping question Do you want to enable creation of BPEM
Clarification Case?

1.1.1.1.11 Configure Integration of SAP Cloud for Customer


with S/4 HANA

As an administrator, you can implement the SAP S/4HANA edition for utilities solution in SAP Cloud for
Customer.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
S/4HANA Integration, select the scoping question Do you want to integrate your cloud solution with SAP S/
4HANA?

Utilities Contact Center Administrator Guide


10 PUBLIC ERP Edition for Utilities Contact Center
1.1.1.1.12 Configure Security Deposit at Contract Level

As an administrator, configure Security Deposit at contract level.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Security Deposit, select the scoping question Do you want to enable Security Deposit at contract level?

1.1.1.1.13 Configure Alerts in Move Processes

As an administrator, configure alerts in move processes and enable the display of alerts in the expanded mode
or collapsed mode. .

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Alerts, select the corresponding scoping questions:

• Do you want to enable Alerts in Move Processes?


• Do you want expanded Alerts in Move Processes?

1.1.1.1.14 Configure to Use Order Codes to Generate Service


Orders

As an administrator, configure to use order codes to generate service orders.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and
under Utilities Service Order/Notifications, select the scoping question Do you want to use the order code for
generating service orders?

1.1.1.1.15 Configure to Use Notification Codes to Generate


Notifications

As an administrator, configure to use notification codes to generate notifications.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Service Order/Notifications, select the scoping question Do you want to use the notification code for
generating notifications?

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 11
1.1.1.1.16 Configure Search for the Contract Account Value
Help

As an administrator, configure search for the Contract Account value help.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to enable basic and advanced search for the
Contract Account value help?

1.1.1.1.17 Configure to Use Meter Reading History from the


Legacy Move-in Date

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 . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to use the meter reading history from the
legacy move-in date?

1.1.1.1.18 Configure Manual Posting

As an administrator, you can enable manual posting in Utilities Financials.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and
under Utilities Manual Posting, select the scoping question Do you want to enable Manual Posting in ‘Utilities
Financials’?

1.1.1.1.19 Maintain Code Values

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

Utilities Contact Center Administrator Guide


12 PUBLIC ERP Edition for Utilities Contact Center
• 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
• Switch Document Status
• Tolerance Group
• Number Ranges for Utilities Contract Account
• Number Range for Utilities Connection Object
• Number Range for Utilities Installation
• Number Range for Utilities Point of Delivery
• Number Range for Utilities Premise
• Number Range for Utilities Sales POD
• Code List Mapping
• Account Determination ID
• Financial Overview Date Range
• Billing Block Reason
• Bill Form
• Case Category
• Contract Account Class
• Contract Process Status
• Coding and Code Group Assignment
• Clearing Category
• Code Group
• Contract Account Category
• Correspondence Dunning Lock Reason
• Company Code Group
• Deactivation Reason
• Dunning Lock Reason
• Dunning Procedure
• Dunning Group
• Grid Level
• Instalment Plan Category

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 13
• Instalment Plan Types
• Interest Key
• Interest Lock Reason
• Invoicing Lock Reason
• Move Out Reason
• Meter Reading Note Type

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

1.1.1.1.20 Configure Utilities Communication Data

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 . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and
under Utilities Enhancements, select the scoping question Is Time Dependency for BP Independent Address
Communication data enabled in ISU?

1.1.1.1.21 Configure Time Dependency for BP Independent


Address Communication data

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 Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and
under Utilities Enhancements, select the scoping question Is Time Dependency for BP Independent Address
Communication data enabled in ISU?

1.1.1.1.22 Enable the Contract Account Object Labels

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 Implementation Projects . Select your project and click Edit Project Scope.

Utilities Contact Center Administrator Guide


14 PUBLIC ERP Edition for Utilities Contact Center
In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to enable the contract account object labels to
display external ID and name?

1.1.1.1.23 Enable The Premise Object Labels

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 Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to enable the premise object labels to display
house number, street name, and house supplement?

1.1.1.1.24 View Service Location Fields in Service Tickets

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 Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to copy premise/PoD address fields to service
location fields while assigning premise/PoD address to service ticket?

1.1.1.1.25 Configure Alternate Contract Account Work Center

As an administrator, you can configure a new Contract Account Work Center with value help capabilities for
advanced search fields.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to enable the new contract account work
center with value help capabilities for advanced search fields?

1.1.1.1.26 Enable Additional Offering step in Move-In

As an administrator, you can enable the Additional offering step to add external products in guided move-in.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 15
In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Move Process for S/4, select the scoping questions 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?

1.1.1.1.27 Configure Premise Search in Live Activity

As an administrator, you can configure to use premise basic search in live activity.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to enable local search for the Utilities-Premise
Category in Enterprise Search and Live activity?

1.1.1.1.28 Configure Service Icons in Premise Header

As an administrator, you can configure to hide the service icons in premise header.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to hide the service icons in Premise Header?

1.1.1.1.29 Configure Financial Balance in Contract Account


Header

As an administrator, you can configure to hide the financial balance in contract account header.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to hide the Financial Balances in Contract
Account Header?

1.1.1.1.30 Configure Alternative View for Change Move-In

As an administrator, you can enable the alternative view for Change Move-In process.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

Utilities Contact Center Administrator Guide


16 PUBLIC ERP Edition for Utilities Contact Center
In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to enable the alternative view for Change
Move-In?

1.1.1.1.31 Assign Front Office Process for Configurable


Hierarchy

As an administrator, you can assign front office process for configurable hierarchy.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to assign Front Office Process for Configurable
Hierarchy?

1.1.1.1.32 Use the IBAN fields to display the payment data

As an administrator, you can use the IBAN fields to display the payment data.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to use the IBAN fields for displaying the
payment data?

1.1.1.1.33 Enable the New Mailing Address Feature in Move-In


Guided Activity

As an administrator, you can use the new mailing address feature to add address in move-in guided activity.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to use the new mailing address feature in move
processes?

1.1.1.1.34 Configure Plan Type for Create Payment Plan

As an administrator, select the plan type to create payment plan.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 17
In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to select the plan type in Create Payment Plan?

1.1.1.2 Replicate Utilities Master Data

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 295] and Contract Account Replictaion [page
297].

1.1.1.3 Assign Work Centers to Business Users

Work center assignment to business users based on their roles.

Assign Work Centers to Business Users

Supported Work Centers and Tab Screens

Work Center Folder Work Center Name Technical Name

COD_UTILITIES_WCF Utilities

Contract Account COD_CONTRACTACCOUNT_WCVIEW

Customer Search COD_CUSTOMER_SEARCH_EXT_WCVIEW

Premise COD_PREMISE_WCVIEW

COD_SALES_WCF Sales

Sales Quotes COD_QUOTE_WCVIEW

Sales POD SALESPOD_WCVIEW

CODACCOUNTWC Customers

 Note
The utilities specific screen -
Utilities Financials, Utilities 360,
and Utilities Service Orders are
available with this scoping.

Accounts CODACCOUNTWCV

Contacts COD_CONTACT_WCV

Utilities Contact Center Administrator Guide


18 PUBLIC ERP Edition for Utilities Contact Center
Work Center Folder Work Center Name Technical Name

Individual Customers COD_SEOD_ACCOUNTWL_WCVIEW

COD_SEOD_AGENT_QUEUE_WCF Tickets SEOD_TICKET_SADL_WCVIEW

Live Activity Center LIVE_ACTIVITY_CENTER

1.1.1.4 Configure the Alerts Tab

As an administrator, use adaptation to add the Alerts tab.

After you add the tab, you can enable it as a side pane in screens. Click your user profile and navigate to
Settings Company Settings and then set the Enable Side Pane toggle to Yes.

Company Setting Screen

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 19
Alert Notification

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.

Alerts in Move Process

You can enable the display of alerts in the expanded mode through a scoping question. To configure the
scoping question, go to Business Configuration Implementation Projects . Select your project and click
Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Alerts, select the scoping question Do you want expanded Alerts in Move Processes?

1.1.1.5 Configure Scripts for Move Processes

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.

To configure the script and rule, follow the steps:

1. Navigate to Administrator Industry Settings Utilities Move In/Out Script .

Utilities Contact Center Administrator Guide


20 PUBLIC ERP Edition for Utilities Contact Center
2. On the Move In/Out Scripts page, perform the required actions. The following table describes the sections
that appear on the page:

Section Description

Manage Message Do the following:


• If you want the script to be displayed, set Show Script
to Yes.
• If you want the script to be mandatory, set Mandatory
to Yes.

Message Configuration Do the following:


• To create a new script, select New.
• To modify an existing script, select Edit.
• To delete a script, select Remove.

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 21
Configure Scripts for Move Processes

1.1.1.6 Configure Utilities 360


As an administrator, you can configure the views for Recent History and Hierarchy sections under Utilities 360
screen of a customer.

To configure the fields in Recent History section, follow the steps:

Utilities Contact Center Administrator Guide


22 PUBLIC ERP Edition for Utilities Contact Center
1. Navigate to Administrator Industry Settings Utilities Settings for Utilities 360 .
2. Click Edit icon to enter into the edit mode.
3. On the Manage Recent History page, you can manage the tables to be shown on the screen by setting it to
Yes.

Utilities Settings
4. Click Save.

To configure the default view in the Hierarchy section, follow the steps:

1. Navigate to Administrator Industry Settings Utilities Settings for Utilities 360 .


2. Click Edit icon to enter into the edit mode.
3. On the Hierarchy page, you can manage the default view for Hierarchy in Utilities 360 to be shown on the
screen by selecting the default view type from the dropdown.

Utilities Settings
4. Click Save.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 23
1.1.1.7 Configure Safety Message for Reconnect

As an administrator, you can configure a safety message to reconnect the AMI smart meter.

Go to Administrator Industry Settings Utilities Safety Message for Reconnect .

On the Safety Message for Reconnect, you can manage the message to be mandatory or optional.

Safety Message for Reconnect

If the message is set to mandatory, when you select a device to reconnect the message appears in the
Reconnect popup.

1.1.1.8 Configure Mashup for Front Office Process (FOP)

To integrate the front office processes with your SAP ERP system, you must create and configure a new
mashup.

To create a new mashup, follow these steps:

1. Go to Administrator Mashup Authoring New URL Mashup .


2. Select a mashup category and port binding.
3. Enter a mashup name and description.
4. Enter the ISU system URL in the following format:
https://ldxxxxx.wdf.sap.corp:XXXXX/sap/bc/gui/sap/its/webgui
5. Enter additional parameters, such as client and language.

To configure a new mashup, follow these steps:

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.

Utilities Contact Center Administrator Guide


24 PUBLIC ERP Edition for Utilities Contact Center
4. Under Mashup ID, select the Mashup ID.

 Note

You also need to assign the launch object in the Implementation Guide Customizing for SAP Cloud for
Customer Utilities. For more information, see the reference in the related links section.

Related Information

Assign Front Office Processes [page 60]


Assign the front office processes that you need to launch from SAP Cloud for Customer in the
Implementation Guide customizing.

Mashups

1.1.1.9 Configure Smart Energy Water

Configure the Communication Preferences, Consumption Graph, Outage map, and Compare tabs from SAP
Cloud for Customer to integrate the Smart Energy Water (SEW) with SAP ERP system .

Create MashUp Web Service

Follow these steps to create mash up web service:

• Go to Administrator Mash up Web Service New REST Service .


• Enter the Service Name under General Information.
• Select Authorization Method as Basic, HTTP method as GET, Service Protocol as XML under Service
Information.
• Enter the Username, Password, and URL to extract the parameter.
• Enter the required Input Parameters.

 Note

Maintain the parameter names as UtilityAccountNumber for Contract Accounts and CustomerNumber
for Customer.
• Ensure to check the mandatory field, if the parameter is required to retrieve the token.
• Ensure to add all parameters as required.
• Constant values are given preference over actual values.

• Click Activate to enable web service.

 Note

Ensure the web service is active.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 25
Admin Settings

Maintain the admin settings as follows:

• Go to Administrator Industry Settings Setting for SEW Integration .


• Select the Mashup Web Service ID that you created from the list.
• Enter the Consumption URL, Notification URL, Utility ID, P ID, OutageMap URL, and Compare URL.

 Note

Make 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 accounts communication preferences, and Consumption Graph.

1.1.1.10 Configure Message Severity for Move Processes

As an Administrator, configure the severity of the messages received during the move process. You can also
suppress the message if you do not want them to display.

Configure Message Severity

1. Navigate to Business Configuration Overview .


2. Under Activity, search and select Utilities.
3. Select the Message Severity Configuration.
4. Select the severity for each message as you need.
5. Select the Suppress Message check box if you do not want to display any message.
6. Click Save.

1.1.2 Configure Middleware

Learn about the configuration of middleware.

Configure Platform Integration (PI) [page 26]


The configuration required in PI system is documented in detail in the following topics.

Configure SAP Cloud Integration [page 37]


This section describes the configuration required for SAP Cloud Integration.

1.1.2.1 Configure Platform Integration (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.

Utilities Contact Center Administrator Guide


26 PUBLIC ERP Edition for Utilities Contact Center
 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

The prerequisites for PI configuration are as follows:

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

• Connection Phase: Check and Prepare PI System


• Connection Phase: Set Up Secure Connection Between ERP-PI-Cloud Systems
• Create a view in the key storage and load certificate into view
• Import the root certificate used to sign the SAP Cloud for Customer certificate

1.1.2.1.2 PI Value Mapping: Map COD Business System ID -


ERP Logical System ID

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 fine-tuning.

Mapping Business System - Logical System

COD Business System ID ERP Logical System ID

<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

• ERP_COD_Utilities_BusinessAgreementReplication
• ERP_COD_Utilities_Tech_Objects_Replication

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 27
1.1.2.1.3 Download Enterprise Software Repository
Content for Integration
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.

2. Click on the tab Browse Download Catalog


3. Go to SAP Content ESR Content (XI Content)
4. Dowload the following software components to your local machine:

Download Software Components

Software Component Name Version Contents

XI CONTENT SAP BYD XI CONTENT SAP_BYD 2.40 Interface Definitions for SAP Cloud for
Customer for Utilities Contact Center

XI CONTENT COD_ERP_INT XI CONTENT COD_ERP_INT 6.00 ERP Interface Definitions

XI CONTENT COD_ERP_INT_IC XI CONTENT COD_ERP_INT_IC 6.00 Mapping, Templates and Scenarios

1.1.2.1.4 Create System Landscape Directory


Configuration
Register the on-premise system in the System Landscape Directory (SLD). Systems are typically registered in
SLD when they are initially configured.

To check if your system is registered in SLD, perform the following steps:

1. Log in to the PI system and go to System Landscape Directory System Landscape .


2. Register your on-premise system in PI, by creating a technical system of type AS ABAP for your on-premise
system. For more information, see Creating New Web AS Systems
3. Under ABAP System Details Business Systems , create the corresponding business system for the
technical system. For more information, see Creating and Removing Business Systems.
4. Go to System Landscape Technical Systems and register your cloud solution in PI.
5. Create a corresponding business system for the Cloud solution.
6. Assign SWCV SAP BYD 2.40 under the product SAP BUSINESS BYDESIGN 240.
7. Again, under System Landscape Technical Systems , perform the following steps:
1. Select the SAP Cloud for Customer system and click on Installed Software.
2. Select Add New Product, and add the product SAP BUSINESS BYDESIGN 240 and assign the
software component version SAP BYD 2.40.

Utilities Contact Center Administrator Guide


28 PUBLIC ERP Edition for Utilities Contact Center
3. Similarly, assign SWCV SAP BYD 1411 under the product SAP BUSINESS BYDESIGN 1411.

1.1.2.1.5 Import ESR Content into PI System

Import the standard integration content delivered for SAP Cloud for Customer for Utilities Contact Center to
your PI system.

To import the downloaded ERP content from local machine to the PI system in your landscape follow the steps:

1. Log in to the PI 7.11 system and enter the transaction code SXMB_IFR to start the Integration Builder.
2. Under Enterprise Services Repository, click 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

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

1.1.2.1.6 Create Configuration Scenario

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, 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 Create and save the configuration scenario.

 Note

Maintain the ID configurations for each of the Web Services in this configuration scenario. As part of
the ID configuration, you perform the following steps for each Web Service:

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 29
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.

1.1.2.1.7 Maintain ID Configuration for Web Services

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 .

Example: ID Configuration for Web Service - Account 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:

1. Assign sender and receiver business system.


1. To do this, right-click Business System and click Assign Business System.

Utilities Contact Center Administrator Guide


30 PUBLIC ERP Edition for Utilities Contact Center
2. In the Assign Business System dialog box, click 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 (Software
Landscape Directory).

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 31
3. Click twice Continue option to assign both sender and receiver business systems.
4. Click Finish to save the configuration.
2. Create communication channel (SOAP sender) for sender business system. To do this,
1. Right-click communication channel and select New.
2. In the dialog box search, and assign your sender business system in communication component and
enter a name for communication channel.

Utilities Contact Center Administrator Guide


32 PUBLIC ERP Edition for Utilities Contact Center
3. Click Create.
4. In the dialog box, select the SOAP Adapter Type as Sender. Enter security level as HTTP and enter the
namespace and the document name.

5. Under Default XI Parameters, enter the web service name.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 33
3. Create communication channel (SOAP receiver) for receiver business system similar to how you have
created the communication channel for sender system. Note that for SOAP Adapter Type as Receiver.
Provide the target URL and credentials of the receiver system.
4. Create receiver determination

1. Right-click Receiver Determination and then click New.


2. For Communication Component, select the business system maintained in the SLD configuration.
3. Also enter the sender interface name and the name space and click Create.
5. Create interface determination

1. Right-click Interface Determination and then click New.


2. In the dialog box, specify the interface name, namespace, and communication component for the
Sender. Similarly, under Receiver, enter the communication component.
6. Create receiver agreement

Utilities Contact Center Administrator Guide


34 PUBLIC ERP Edition for Utilities Contact Center
1. Right-click Receiver Agreement and then click New.
2. Create receiver agreement and enter the sender communication component name, receiver
component name, receiver interface, and name space names. Assign the receiver communication
channel and save.
7. Create sender agreement
1. Enter the receiver communication component name, sender component name, sender interface, and
name space names. Assign the sender communication channel and save.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 35
8. Activate change lists. To activate, right-click on the top node of the change list and click Activate.

1.1.2.1.8 Configure Communication Arrangements in Cloud


Solution

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

The required certificates have been installed and validated.

Procedure

1. To set the communication arrangement, go to Administrator General Settings Integration


Communication Arrangements
2. Click on New and follow the wizard to set up your communication arrangements
3. Use Edit Advance Setting to configure your outbound communication arrangements.
4. After you have completed the configuration, validate the same. To validate, select Outbound
Communication and click on Check Connection and look for the message “Ping successful”.

 Note

Contact your system administrator for details of System Instance ID, Code List Mapping,
Authentication Method (user and password), Port, SAP Cloud for Customer Business System ID, SAP
Cloud for Customer Business System Client, and Communication System Client.

Utilities Contact Center Administrator Guide


36 PUBLIC ERP Edition for Utilities Contact Center
Communication Arrangements for Utilities Contact Center

Communication Scenario (MCPG) Use

ERP Utility Management Integration ISU Configuration, ERP Contract Account Replication,
Query, and Maintain ERP Customer Info

Utilities Contract Account Replication ERP contract account replication

Utilities Bill Correction Invoice Generating invoice PDF

Utilities Technical Master Data Replication Technical objects replication

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

1.1.2.2 Configure SAP Cloud Integration

This section describes the configuration required for SAP Cloud Integration.

Inbound: Create Binding for inbound services in ERP

When a service gets triggered from SAP Cloud for Customer, a corresponding ERP service gets executed in
ERP through SAP Cloud Integration. Therefore, you need to create a binding in SOAMANAGER that generates a
calculated URL. This must be configured in the Receiver channel of SAP Cloud Integration.

1.1.2.2.1 Web Service Configuration for Account Overview


Service

1. Open SOAMANAGER and select Web Service Configuration.

2. In the field Object Name search for the inbound S/4HANA service name.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 37
3. Next click Create Service.

4. Enter the Service Name and Binding Name and then click Next.

5. Under Provider Security, select User ID/Password and click Next.

Utilities Contact Center Administrator Guide


38 PUBLIC ERP Edition for Utilities Contact Center
6. You do not need to maintain any settings for SOAP Protocol.

7. You do not need to maintain any settings under Operation Specific.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 39
8. Click Finish and the screen below displays the service and binding.

9. On the second line – click 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 to upload this URL when configuring the SAP Cloud Integration Receiver communication
channel or Receiver Connector.
Here we have a URL for the WSDL – copy this URL as we need to upload this url when we perform the
configuration in PI or HCI Receiver communication channel or Receiver Connector.

11. In the Display Communication Channel dialog, upload the WSDL URL as the Target URL under Connection
Properties.

Utilities Contact Center Administrator Guide


40 PUBLIC ERP Edition for Utilities Contact Center
12. Account Overview

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 41
1.1.3 Configure Integration with ERP

An overview of how to configure integration with ERP system.

Integration with SAP ERP-ISU Master Data View

 Note

You must have defined the required integration setup to connect with ERP and PI system.

1. Set up 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 .
2. Define the PI value mapping between the cloud business system ID and the ERP logical system ID.
3. Replicate the required business partners to the cloud solution. For more information, see http://
help.sap.com/mdg80/.

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

Utilities Business Partner Replication [page 43]


The utilities standard solution provides reports for business partner initial load and delta load
replication.

Implementation Guide (IMG) on IS-Utilities [page 59]

Utilities Contact Center Administrator Guide


42 PUBLIC ERP Edition for Utilities Contact Center
Perform and maintain the configuartion for IMG related to SAP Cloud for Customer

Data Replication from IS-Utilities [page 64]


The reports listed in this section must be executed for transfer of data from IS-Utilities system to the
Utilities Contact Center cloud solution.

Logical Ports for Outbound Services for Asynchronous Interface Using PI Integration [page 77]
To configure a consumer proxy to access a service, you need to create and configure logical port.

Logical Ports for Outbound Services for Asynchronous Interface Using SAP Cloud Integration [page 82]
To configure a consumer proxy to access a service, you need to create and configure logical port.

Configure Mashup for Front Office Process (FOP) [page 85]


To integrate the front office processes with your SAP ERP system, you must create and configure a new
mashup.

Related Information

Configure Platform Integration (PI) [page 26]


The configuration required in PI system is documented in detail in the following topics.

1.1.3.1 Utilities Business Partner Replication

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.

Prerequisites

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 43
Default Object Identifier Mapping

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 .

Supported Business Partner Roles

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.

Standard Reports for Business Partner Replication

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
Delta load report for delta replication of business partners

 Note

The delta load report is run periodically in the system and you do not need to trigger delta replication.

Run the Initial Load Reports

Follow these steps to run the initial load reports:

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

Utilities Contact Center Administrator Guide


44 PUBLIC ERP Edition for Utilities Contact Center
2. Specify the Logical Port ID.
3. Run both the initial load and the relationships replication reports in sequence.

Determine Your Strategy for Number Range Assignment [page 45]


Maintain and assign the number ranges for business partners IDs in your SAP Cloud for Customer
system.

Maintain Number Ranges [page 48]


Maintain number ranges as per the ones that you have finalized.

Configure Business Partner ID in ERP [page 48]


Configure business partner IDs by defining the number range and mapping business partner ID.

Define Logical Ports in ERP [page 49]


In the ERP system, define logical ports for the HCI/PI using the SOAMANAGER transaction for the
consumer proxies.

Map Code Lists [page 49]


Configure code list mapping.

Set up Delta Replication from ERP [page 50]


To set up delta replication from ERP, follow these steps.

Extend Inbound and Outbound Processing Using BAdIs [page 51]


The table lists of BAdIs available for extending Inbound and Outbound Processing for BP replication.

Migrate Business Partners from ERP [page 53]


Use migration reports to migrate business partners.

BPEM Case Creation for BP Replication Failure [page 54]


Whenever the Business Partner Replication fails, you can create a BPEM case.

Business Partner Replication Message Suppression [page 56]


You can activate the Business Partner Message Suppression process using IMG configuration to avoid
inconsistency in SAP Cloud for Customer message processing.

Business Partner Replication Message Sequencing [page 58]


Follow the steps to configure business partner replication message sequencing from SAP Cloud for
Customer to SAP ERP.

Business Partner Replication Via Parallel Processing [page 58]


Replicate the business partner data in bulk using parallel processing.

1.1.3.1.1 Determine Your Strategy for Number Range


Assignment

Maintain and assign the number ranges for business partners IDs in your SAP Cloud for Customer system.

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 45
Choosing Different Number Ranges

Business partner IDs of ERP and SAP 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

Mapping Example for Different Number Ranges

SAP Cloud for Customer System

Classification

System From Number To Number Number Range Type

CUSTOMER 1000 1999 Internal Number Range

CUSTOMER 1000 1999 Internal Number Range

Replication Direction Account Group From Number To Number Number Range Type

To SAP Cloud for 0001 1 999 Internal Number


Customer Range

To SAP ERP 0001 1 999 Internal Number


Range

In the above example, the first customer created in ERP gets ID 1 in the ERP and ID 1000 in the SAP Cloud for
Customer system. If the next customer is created in the SAP Cloud for Customer system, ID will be 1001 in the
SAP Cloud for Customer system and ID 2 in the ERP.

Choosing Identical Number Ranges

There are 2 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 SAP Cloud for Customer system
exclusively.

For example: Customers (account group 0001 in ERP) are only maintained in the SAP Cloud for Customer,
Competitors (account group Z001 in ERP) are only maintained in the ERP system. The account group in ERP
and BPs in SAP Cloud for Customer must have the same number range. For the receiving system, external
number assignment is required. You must make sure that business partner creation in the receiving system is
prohibited.

Utilities Contact Center Administrator Guide


46 PUBLIC ERP Edition for Utilities Contact Center
 Example

SAP Cloud for Customer System

Classification

System From Number To Number Number Range Type

CUSTOMER 1 999 Internal Number Range


(leading)

COMPETITOR 1000 ZZZ External Number Range

Replication Direction Account Group From Number To Number Number Range Type

To SAP ERP 0001 1 999 External Number


Range

SAP Cloud for Z001 1000 ZZZ Internal Number


Customer Range (leading)

Separate Account Groups Approach

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 both ERP system and SAP Cloud
for Customer system parallel, define 1 account group (e.g. 0001) for customers that are created in the ERP
system and must be replicated in the SAP Cloud for Customer system. Define an additional account group (e.g.
Z001) for customers that are created in the SAP Cloud for Customer system and must be replicated to the ERP
system. Use different number ranges for these account groups and define external number assignment in the
receiving system.

 Example

SAP Cloud for Customer System

Classification

System From Number To Number Number Range Type

CUSTOMER 1 999 External Number Range

CUSTOMER 1000 1999 Internal Number Range


(leading)

Replication Direction Account Group From Number To Number Number Range Type

To SAP Cloud for 0001 1 999 Internal Number


Customer Range (leading)

To SAP ERP Z001 1000 1999 ExternalNumber


Range

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 47
1.1.3.1.2 Maintain Number Ranges

Maintain number ranges as per the ones that you have finalized.

To maintain number ranges, follow these steps:

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.

1.1.3.1.3 Configure Business Partner ID in ERP

Configure business partner IDs by defining the number range and mapping business partner ID.

Define 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
Cloud for Customer and the BP ID internal to ERP system are the same. To do this, implement the add-in
COD_UTIL_BP_REPL method COD_UTIL_BP_REPL_IN_PRE and set flag CV_EXTERNAL_NUMBER to ‘"X"’
and assign a desired Account Group to CV_BU_GROUP.

Mapping Business Partner ID in SAP Cloud for Customer to the Business


Partner ID in ERP

When you create a business partner in your SAP Cloud for Customer system and replicated to the ERP system,
the BP internal ID in the cloud solution is 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 mappings 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.

Utilities Contact Center Administrator Guide


48 PUBLIC ERP Edition for Utilities Contact Center
4. When you create a business partner in ERP and replicated to SAP Cloud for Customer, the SAP Cloud
for Customer sends 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.

1.1.3.1.4 Define Logical Ports in ERP

In the ERP system, define logical ports for the HCI/PI using the SOAMANAGER transaction for the consumer
proxies.

Implement the business add-in COD_UTILITIES_REPLICATION_CONF and method


GET_LOGICAL_BP_PORTS. Set the following parameters in the add-in implementation:

• CV_LOGICAL_PORT1  port for BP replication consumer proxy


• CV_LOGICAL_PORT2  port for BP relationship replication consumer proxy
• CV_LOGICAL_PORT3  port for BP replication confirmation message to SAP Cloud for Customer
• CV_LOGICAL_PORT4  port for BP replication relationship confirmation message to SAP Cloud for
Customer

1.1.3.1.5 Map Code Lists

Configure code list mapping.

Prerequisite for Migration

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

Configure Automated Code List Mapping

Follow these steps to configure automated code list mapping:

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 49
1. Log in to your SAP Cloud for Customer
2. Click on the link for Download Code List.
3. Enter the Code List Mapping Group, Language, Delimiter and then select Download.
4. Specify a name for the file you want to download. Note that the file is saved in .zip format.
The code list is downloaded to the folder that you have specified.
5. Login to the ERP system to which your cloud solution is connected to.
6. Enter the transaction code SE38 and run the report CODD_CODE_LIST_MAPPING.
7. Click on Execute.
8. Alternately you can Execute the program CODD_CODE_LIST_MAPPING using the below options.
9. Specify the main language in which the code lists are to be mapped and enter the following details:
• Merged customized directory is where you want the merged code list mappings filled.
• Cloud for Customer Business Configuration File is the codeList.zip file that was downloaded from the
SAP Cloud for Customer system.

1.1.3.1.6 Set up Delta Replication from ERP

To set up delta replication from ERP, follow these steps.

• In the SWE2 transaction code in ERP, do the following:


• In the CREATE event of the business partner, deselect the Linkage Activated checkbox.

• In the CHANGED event of the business partner, deselect the Linkage Activated checkbox.

Utilities Contact Center Administrator Guide


50 PUBLIC ERP Edition for Utilities Contact Center
 Note

The delta configuration based on CRM Eventing (adding FM COD_UTIL_BUPX_C4C_BPOUT in the


CRMC_BUT_CALL_FU table) is no longer available.

1.1.3.1.7 Extend Inbound and Outbound Processing Using


BAdIs

The table lists of BAdIs available for extending Inbound and Outbound Processing for BP replication.

COD_UTIL_BP_INITIAL_PRE • Validate and filter Business Partners that must be sent


to SAP Cloud for Customer during initial download.
• Implement custom logic for business partner details
data selection and skip standard data selection.
• Map PDI/KUT fields.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 51
COD_UTIL_BP_INITIAL_POST • Validate and filter/change Business General Attributes,
Partner roles, addresses, and so on, that are relevant for
SAP Cloud for Customer.
• Validate and skip sending business partner to SAP
Cloud for Customer.
• Map PDI/KUT fields.

COD_UTIL_BP_REL_INITIAL_PRE • Validate and filter Business Partner's Relationship data


that should be sent to SAP Cloud for Customer during
initial download.
• Implement custom logic for data selection and skip
standard data selection.
• Map PDI/KUT fields.

COD_UTIL_BP_REL_INITIAL_POST • Validate and filter/change Business Relationship cate-


gories, that are relevant for SAP Cloud for Customer.
• Validate and skip sending business partner to SAP
Cloud for Customer.
• Map PDI/KUT fields.

COD_UTIL_BP_DELTA_PRE • Validate Business partner and skip sending BP to SAP


Cloud for Customer during delta in ERP.
• Implement custom logic to fetch BP data and execute
client proxy call.
• Map PDI/KUT fields if standard logic is skipped.

COD_UTIL_BP_DELTA_POST • Validate, change and filter BP general attributes, ad-


dress usages, addresses, and relationships during delta
in ERP.
• Skip sending BP data to SAP Cloud for Customer.
• Map PDI/KUT fields.

COD_UTIL_BP_REPL_IN_PRE • Validate, change inbound business partner’s details like


attributes, address, roles etc. before calling BAPIs to
post it.
• Implement custom inbound replication and skip stand-
ard logic.
• Set Account Group and indicator to determine number
range strategy.
• Set Identification or External number ID mapping.
• Map PDI/KUT fields.

Utilities Contact Center Administrator Guide


52 PUBLIC ERP Edition for Utilities Contact Center
COD_UTIL_BP_REPL_IN_POST • Map PDI/KUT fields.
• Manipulate confirmation message to send back to SAP
Cloud for Customer.
• Skip sending confirmation.

COD_UTIL_BP_REL_REPL_IN_PRE • Validate and change relationship data during business


partner relationship inbound processing.
• Implement custom logic and skip standard process.
• Map PDI.KUT fields.

COD_UTIL_BP_REL_REPL_IN_POST • Map PDI/KUT fields.


• Manipulate BP relationship confirmation message to
send back to SAP Cloud for Customer.
• Skip sending confirmation.

COD_UTIL_BP_REPL_CONF_IN_PRE • During inbound processing in ERP if there is a confirma-


tion message from SAP Cloud for Customer to ERP, set
BP Id mapping.
• Implement custom logic to maintain ID mapping and
skip standard logic.

1.1.3.1.8 Migrate Business Partners from ERP

Use migration reports to migrate business partners.

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

Follow these steps to migrate business partners:

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 53
1.1.3.1.9 BPEM Case Creation for BP Replication Failure

Whenever the Business Partner Replication fails, you can create a BPEM case.

Configure BPEM Creation for BP Replication Failure

Follow these steps to configure automatic BPEM Case creation during failed Business Partner replication:

1. Log in to your ERP system.


2. You can create or reuse a Business Process Area. To create a Business Process Area, navigate to
SAP ERP Implementation Guide Customizing SAP ERP Financial Accounting (New) Contract
Accounts Receivable and Payable Integration Business Intelligence Process Statistics Activate
Business Process Areas for Message Management .
3. You can create or reuse a Business Process Code. To create a Business Process Code, navigate to SAP
ERP Implementation Guide Customizing SAP ERP Financial Accounting (New) Contract Accounts
Receivable and Payable Integration Business Intelligence Process Statistics Define Customer
Business Processes for Message Management .

 Note

Assign your Business Process code to BUS1006 business object.

4. Create a new case category using transaction code EMMACCAT1.

 Note

Maintain the error message in case category, for which you need to create a BPEM.

Display Clarification Case Category


5. Enter the transaction code SM30 and maintain the respective configuration in table COD_APPL_BPEM.

Utilities Contact Center Administrator Guide


54 PUBLIC ERP Edition for Utilities Contact Center
Settings for BPEM in BP Replication
6. Run the transaction code EMMA, whenever there is any error message captured as logs in transaction code
SLG1.
1. Follow these steps in the first execution.

Business Process Analysis and Case Generation


2. Follow these steps in the second execution.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 55
Business Process Analysis and Case Generation

1.1.3.1.10 Business Partner Replication Message Suppression

You can activate the Business Partner Message Suppression process using IMG configuration to avoid
inconsistency in SAP Cloud for Customer message processing.

Whenever there is any business partners-related changes triggered from SAP Cloud for Customer; you
can choose whether the message needs to get back to SAP Cloud for Customer or not. You can use the
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 SAP Cloud for Customer to ERP, you have an
option to choose the scenario in which you don’t want full business partner message back to SAP Cloud for
Customer. Follow these steps for asynchronous services:

1. Enable BP Suppress Active.


1. Set the Suppress for Create to active, the messages during Create scenario won't get back to SAP
Cloud for Customer.

Utilities Contact Center Administrator Guide


56 PUBLIC ERP Edition for Utilities Contact Center
2. Set the Suppress for Update to active, the messages during Update scenario won't get back to SAP
Cloud for Customer.
3. Don’t set both the Suppress for Create and Suppress for Update to active, the full messages gets
back to SAP Cloud for Customer for both create and update scenarios, irrespective of the enablement
of BP Suppress Active.
2. If BADI implementation is active.
1. If you have BADI COD_UTIL_BP_REPL=>COD_UTIL_BP_REPL_IN_POST implemented,
then it is recommended to make use of the standard class
CL_COD_UTIL_BP_REPL_SUPPRESS=>SET_SUPPRESS_STATUS to suppress the BP message.

 Note

This class has to be called before the commit statement only. If any error changes got role back
then no need to suppress the message.

For Specific Subscenarios Where Message Loop Back is Required

For specific subscenarios where the suppression is not needed, parameter in respective BADIs is 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 SAP Cloud for Customer, the message loop back from ERP to SAP Cloud for Customer may be
required to update the address number. In this case, the parameter in the BADI has 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

For synchronous services like: COD_UTIL_BANK_PAYMENT_METHOD, COD_UTIL_BP_ADDR_AND_COMM_CHG


you need to enable BP Suppress Active to suppress the business partner full messages back to SAP Cloud
for Customer.

You can suppress the message loop back to SAP Cloud for Customer by activating the Activate Suppress
under Synchronous Services and maintaining Functional Module in the following IMG activity: SAP ERP

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 57
Implementation Guide Customizing SAP ERP SAP Utilities Cloud For Customer Utilities Business
Partner Replication Message Suppression Maintain Synchronous Services for Message Suppression

1.1.3.1.11 Business Partner Replication Message Sequencing

Follow the steps to configure business partner replication message sequencing from SAP Cloud for Customer
to SAP ERP.

1. Switch framework to activate Business Function. Go to 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 .

1.1.3.1.12 Business Partner Replication Via Parallel


Processing

Replicate the business partner data in bulk using parallel processing.

You can run the report COD_UTIL_BP_REP_LOAD_V1 with a dedicated server group to maximize the
performance. Set up a background job and monitor the status with transaction SM37.

The output displays the details with the count of business partners processed executed in dialog mode, after
execution of the report. Maintain the parallel logs to monitor them in SLG1.

Follow the steps to configure business partner replication using parallel processing from SAP Cloud for
Customer.

1. Open transaction SE38 and enter report COD_UTIL_BP_REP_LOAD_V1.


2. Execute the report or press F8.
3. Enter the following details in the selection screen.
• Business Partner ID - enter business partner IDs for replication.
• Port and Size - enter logical system and package size.
• Parallel Processing -
• To execute the program, select the checkbox and enter the Server Group. It’s good to create a
separate server group with available work processes to achieve fast response.
• To execute the program in normal processing mode, deselect the checkbox.

 Note

It’s recommended to schedule the report as background job and monitor in SM37 for bulk data processing.

Utilities Contact Center Administrator Guide


58 PUBLIC ERP Edition for Utilities Contact Center
1.1.3.2 Implementation Guide (IMG) on IS-Utilities

Perform and maintain the configuartion for IMG related to SAP Cloud for Customer

Create Configurable Hierarchy [page 59]

MDT Templates for Move-In, Customer, Contract Account & Rate Change Using Guided Processes [page
59]
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.

Assign Front Office Processes [page 60]


Assign the front office processes that you need to launch from SAP Cloud for Customer in the
Implementation Guide customizing.

Enrollment - Configure Switch Document Creation and Notification [page 62]


Detailed information for creating switch document in the cloud solution.

1.1.3.2.1 Create Configurable Hierarchy

To create the configurable object hierarchy, follow these steps:

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.

1.1.3.2.2 MDT Templates for Move-In, Customer, Contract


Account & Rate Change Using Guided Processes

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:

• Create an MDT template using transaction code EPRODCUST.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 59
• Assign the MDT template to IMG activity Configure MDT Template under IMG for SAP ERP SAP Utilities
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.

1.1.3.2.3 Assign Front Office Processes

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 SAP 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:

• ISUACCOUNT – Contract Account


• ISUPARTNER – Customers (Accounts and Individual Customers)
• PREMISES – Premise

Utilities Contact Center Administrator Guide


60 PUBLIC ERP Edition for Utilities Contact Center
Prerequisites

You must have defined the required Front Office Process in the IMG activity under SAP ERP IMG SAP
Utilities Customer Service Front Office .

Assign Front Office Process for Configurable Hierarchy

As an administrator, you can assign business roles to the corresponding object types and front office processes
for configurable hierarchy. This in turn helps you to directly select the front office processes from the SAP
Cloud for Customer system.

Assign the front office process for configurable hierarchy based on the scoping question.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to assign Front Office Process for Configurable
Hierarchy?

To configure front office process for configurable hierarchy, follow the steps:

1. Go to the Administrator Industry Settings Utilities Assign Front Office Process to Configurable
Hierarchy .
2. Add the Mashup ID as per the requirement.
3. Under Business Roles, click Add Row and select a business roles from the value help.
You can also copy the existing business role data by using the Copy option. The corresponding object types
and front office processes are assigned when you copy the existing business roles.
4. Under Object Types, click Add Row and select a object type from the dropdown.
5. Under Front Office Processes, click Add Row and enter the necessary details as per the EWBC transaction
in IS-U system.

 Note

Select the Hide check box if you want to hide the process in the front office process dialog box.

6. Click Save.

 Note

To delete any object type or role, select the row and click Remove.

You can now view the description of the objects under Configurable Hierarchy in the Utilities 360 screen.

Click the object hyperlink to display the list of processes for that particular business role and select the
required process to navigate to the S/4 system.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 61
Related Information

Configure Mashup for Front Office Process (FOP) [page 85]


To integrate the front office processes with your SAP ERP system, you must create and configure a new
mashup.

1.1.3.2.4 Enrollment - Configure Switch Document Creation


and Notification

Detailed information for creating switch document in the cloud solution.

Configure Switch Document Creation in Cloud Solution

Trigger a switch document after completing a quote (using guided quote) review and submit it to ERP system.
This service is a Web Service 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.

When you have a confirmed C4C quote, trigger a switch document creation on ERP ISU.

• For valid ISU PODs - successfully created the switch document


• For invalid ISU PODs - created a temporary switch message with the sales pod details. Later the back-office
process converts the sales pod to ISU pod using the sales pod details stored in temporary switch message
and create the switch document accordingly.

For the back-office process, you can refer to sample implementation COD_UTILITIES_SWITCH_BADI_IMPL in
the enhancement spot COD_UTILI TIES_SWITCH_DOC.

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.

Configuration for Creating Switch Document

Parameter Value

Service in Cloud Solution CO_CQP_SOR_OUT

ERP Service II_UTILITIES_LEAN_QUOTE_SI_IN

PI Outbound Service CustomerQuoteProcessingSalesOrderRequestOut

PI Inbound Service Utilities_LeanQuote_SI_In

Operation Mapping in PI COD_ERP_UtilitiesQuote_SwitchDocumentRequest

Communication Arrangement Scenario in cloud solution CREATION OF SALES QUOTE FOLLOW UP DOCUMENT IN
(MCPG) SAP BUSINESS SUITE

Utilities Contact Center Administrator Guide


62 PUBLIC ERP Edition for Utilities Contact Center
Parameter Value

Communication Arrangement Service in cloud solution Create Sales Quote Follow Up Document in SAP Business
Suite

Configure Notification for Switch Document in Cloud Solution

To create a switch document, this service is triggered along with the Web Service call. After successful creation
of the switch document, each quote line item shall have a corresponding switch document ID. Using the service
update the switch document ID in the quote line items in the cloud solution. Determine the logical port for this
service and pick the Default port. However, this logical port can be overwritten by implementing the business
add-in COD_UTILITIES_QUOTE_NOTIF_PORT.

Configure Notification for Switch Document

Parameter Value

Service in cloud solution II_CQP_SLO_NOTIFICATION_IN

ERP Service CO_COD_UTIL_LEAN_QUOTE_NOTIFIC

PI Outbound Service CustomerQuoteProcessingUpdatingSalesQuoteWithSale-


sOrderIn

PI Inbound Service CustomerQuoteProcessingUpdatingSalesQuoteWithSale-


sOrderIn_In

Operation Mapping in PI ERP_COD_Utilities_CustomerQuoteProcessingUpdatingSa-


lesQuoteWithSalesOrderIn

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

Configuration in ERP System

In the ERP system, you can 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:

1. Go to transaction code SOAMANAGER in the ERP system.


2. Choose Service Administration as Web Service Configuration.
3. Search for consumer proxy CO_COD_UTIL_LEAN_QUOTE_NOTIFIC. Click to view the details.
4. Choose Create a Manual configuration.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 63
5. Enter information based on your middleware configuration. Here is an example
value according to your configuration. Example URL Path: /XISOAPAdapter/MessageServlet?
channel=:ABC_004:ERP_SOAP_Utilities_LeanQuote_Notification_Send&sap-client=238
6. To confirm that the logical port created and configured correctly, ping the Web service. If the ping is
successful, a confirmation message appears.

Update Switch Status

You can now trigger the update of switch 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 for Switch Documents

Extensibility using SAP Cloud Application Studio supports for fields in switch documents.

1.1.3.3 Data Replication from IS-Utilities

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

Delta (Modifica-
Delta (Creation of tion of Existing Unidirectional/Bi- Scoping and Fine
Object Initial Load New Objects) Objects ) directional Tuning

Business Partner - Yes Yes Yes Bidirectional Yes

MDG

Contract Account Yes Yes Yes Unidirectional Yes

Replication (Only from IS-Util-


ities to Cloud Solu-
tion)

Point of Delivery Yes Yes Yes Unidirectional Yes

Replication (Only form IS-Util-


ities to Cloud Solu-
tion)

Utilities Contact Center Administrator Guide


64 PUBLIC ERP Edition for Utilities Contact Center
Delta (Modifica-
Delta (Creation of tion of Existing Unidirectional/Bi- Scoping and Fine
Object Initial Load New Objects) Objects ) directional Tuning

Connection Object Yes Yes Yes Unidirectional (IS- Not Applicable

Utilities to Cloud
solution)

Premise Yes Yes Yes Unidirectional (IS- Not Applicable

Utilities to Cloud
solution)

Technical Objects Replication [page 65]


Technical Object Report: COD_UTIL_TECH_OBJECTS_REPL. Use the Technical Object report to
replicate the contract accounts to the cloud solution.

Contract Account Replication [page 71]


Contract Account Replication Report: COD_UTILITIES_ACCOUNT_EXTRACT. Use this report to
replicate the contract accounts to the cloud solution.

Contract Account Delta Replication [page 73]


This document describes the configuration required to run the report
COD_UTILITIES_ACCOUNT_EXTRACT in order to fetch the delta for contract accounts.

Contract Account Replication Using Parallel Processing [page 74]


Report COD_UTIL_CONTRACT_ACCOUNT_REPL enables to replicate bulk data related to contract
accounts using additional option of parallel processing.

Contract Account - IDoc Mass Replication [page 75]


If you want to send multiple IDocs as a single PI message to the receiver system, follow the steps:

Code Lists Mapping [page 77]


Code list mapping must be maintained for the fields specified in the following sections.

1.1.3.3.1 Technical Objects Replication

Technical Object Report: COD_UTIL_TECH_OBJECTS_REPL. Use the Technical Object report to replicate the
contract accounts to the cloud solution.

Report for Initial Load - COD_UTIL_TECH_OBJECTS_REPL

 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 utilities-specific 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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 65
 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 SAP 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

To run the report, follow these steps:

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.

Premise ID Select the range or ID of premises that you want to repli-


cate.

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.

Utilities Contact Center Administrator Guide


66 PUBLIC ERP Edition for Utilities Contact Center
Field Description

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.

2. Execute the report.


You can also use this report to schedule a background job.

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 Settings for Events

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.

 Example

Here is an example of the settings for CREATE for PREMISES:

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 67
Utilities Contact Center Administrator Guide
68 PUBLIC ERP Edition for Utilities Contact Center
An example of the settings for CHANGE for PREMISES is as follows:

To trigger a delta replication for connection object data, follow these steps:

1. In the SM30 transaction code, enter the SWFDVEVTY2 table/view.


2. Add the entries for the CHANGED and CREATED events for CONNOBJ.

 Note

Creating or changing a connection object triggers the delta replication for connection objects.

To trigger a delta replication for premise data, follow these steps:

1. In the SM30 transaction code, enter the SWFDVEVTY2 table/view.


2. Add the entries for the CHANGED and CREATED events for PREMISES.

 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:

1. In the SM30 transaction code, enter the SWFDVEVTY2 table/view.


2. Add the entries for the CHANGED and CREATED events for ISUPOD.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 69
 Note

Creating or changing a connection object triggers the delta replication for point of delivery data.

Technical Object Replication via Parallel Processing Technique

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

• Enhancement Spot: COD_UTIL_TECH_OBJS_REPLICATION


• BAdI: COD_UTIL_TECH_OBJS_REPLICATION
• Interface:

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

CONN_OBJ_ADJUST_DATA IF_COD_UTIL_TECH_OBJS_REPLUsed to adjust the infor-


mation about Connection. If C_SKIP_CONN_OBJ is set to
TRUE, you must trigger the proxy to send the data to SAP
Cloud for Customer. Standard implementation does not trig-
ger any proxy.

PREMISE_ADJUST_DATA Used to adjust the information about Premise. If


C_SKIP_PREMISE is set to TRUE, you must trigger the proxy
to send the data to SAP Cloud for Customer. Standard im-
plementation does not trigger any proxy.

POD_ADJUST_DATA Used to adjust the information about PoD. If C_SKIP_POD is


set to TRUE, you must trigger the proxy to send the data to
SAP Cloud for Customer. Standard implementation does not
trigger any proxy. If C_SKIP_CHECKS is set to TRUE, then
also no PoD information is sent to SAP Cloud for Customer.

Utilities Contact Center Administrator Guide


70 PUBLIC ERP Edition for Utilities Contact Center
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.

Configuration in ERP System

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:

1. In the ERP system, go to the SOAMANAGER transaction code.


2. Select Service Administration as Web Service Configuration.
3. Search for the CO_COD_UTIL_TECH_OBJS_REPL consumer proxy.
4. Click to view the details.
5. Select Create a Manual configuration.
6. Enter information based on your middleware configuration.

 Example

Here is an example URL that needs to be adjusted according to your configuration:

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.

1.1.3.3.2 Contract Account Replication

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 71
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 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 recommended but is not part of
the standard delivery.

Maintain Following Configuration in the Cloud Solution

1. Go to the ADMINISTRATOR work center.


2. Click Edit ID Mapping for Integration to maintain the following values and click Go:
• Mapping Of : Business Partners
• ID : Business Partner ID in the cloud solution

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

• External ID : Business Partner ID in on-premise system

Utilities Contact Center Administrator Guide


72 PUBLIC ERP Edition for Utilities Contact Center
• System Instance ID: ID of the on-premise system

Maintain Following Configuration in IS-Utilities (ERP On-Premise System)

1. Create a contract account using the transaction code CAA1.


2. Use transaction code SE38 and enter the report name COD_UTILITIES_ACCOUNT_EXTRACT. Enter the
following values and execute the report:

 Note

Uncheck the Test flag before you execute the report.

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

1.1.3.3.3 Contract Account Delta Replication

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.

Identifying the Delta for Contract Accounts

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 73
Configuration for Enabling the Event Handler CL_COD_UTIL_SWER_CA

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.

Required - Business Add-In Implementation

Use business add-in COD_UTILITIES_REPLICATION_CONF and implement the method


GET_RECEIVER_SYSTEM to generate a list of receiving logical systems. The report
COD_UTILITIES_ACCOUNT_EXTRACT sends the contract account information as IDocs to the SAP PI
middleware and therefore you need to maintain the receiving logical systems as parameters for the report.

Optional - Other Extensibility Options

1. Use the BAdI COD_UTILITIES_REPLICATION (method CA_ADJUST_DATA) in the report


COD_UTILITIES_ACCOUNT_EXTRACT to modify or delete records that must be set to the cloud solution.
This BAdI called right before the IDocs are created and sent.
2. For other extensible options, you can develop custom event handler classes as part of a project and set
those in the customizing entries to have more control of the delta replication process.

1.1.3.3.4 Contract Account Replication Using Parallel


Processing

Report COD_UTIL_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.

Utilities Contact Center Administrator Guide


74 PUBLIC ERP Edition for Utilities Contact Center
1.1.3.3.5 Contract Account - IDoc Mass Replication

If you want to send multiple IDocs as a single PI message to the receiver system, follow the steps:

1. Main batch size in communication channel.


2. Create PI IDoc sender communication channel and enter package size, which you have entered in the
partner profile.
3. Use transaction code SE38 and enter the report name RSEOUT00.

 Note

Execute RSEOUT00 report using back-ground program.

The below images explain the steps involved to process 100 IDocs as a single message.

WE20

PI Sender Communication channel

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 75
SE38 - RSEOUT00

For more information on Contract Account Replication – Extension on SAP Cloud


Integration Artifact, see https://help.sap.com/viewer/368c481cd6954bdfa5d0435479fd4eaf/Cloud/en-US/
d3741720e29842e4bf547dcd66139f7f.html

Utilities Contact Center Administrator Guide


76 PUBLIC ERP Edition for Utilities Contact Center
1.1.3.3.6 Code Lists Mapping

Code list mapping must be maintained for the fields specified in the following sections.

Automatic Code List Mapping

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.

Related Information

Configure Automatic Code List Mapping

1.1.3.4 Logical Ports for Outbound Services for


Asynchronous Interface Using PI Integration

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 following Interfaces/services either for SAP PI or SAP Cloud
Integration:

1. Replication Technical Master data


2. Switch Document Create Notification from SAP ERP
3. Business Partner Replication from SAP ERP
4. Business Partner Relationship Replication from SAP ERP
5. Bushiness Partner Replication confirmation from SAP ERP

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 77
6. Business Partner Relationship Replication confirmation from SAP ERP

SOAMANAGER Configuration for SAP PI System as the Middleware

 Note

Screenshot provided is for one of the example Services.

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

4. For this Consumer Proxy, create a logical port and select Manual Configuration.

 Note

Logical port can be created as any type, but this example shows for Manual Creation.

Utilities Contact Center Administrator Guide


78 PUBLIC ERP Edition for Utilities Contact Center
5. Provide the logical port name and description and then click Next.

6. For Authentication Settings, under UserID/Password and enter your PI system user ID and password. Click
Next.

7. Under HTTP Settings, provide the technical connectivity details pointing to the PI system. Then click Next.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 79
8. Under SOAP Protocol, enter the following details:
• RM Protocol - SAP RM
• Message ID Protocol - SAP Message ID
• Data Transfer Scope - Basic Data Transfer

9. Click Next.
10. In the New Manual Configuration dialog, click Finish.

Utilities Contact Center Administrator Guide


80 PUBLIC ERP Edition for Utilities Contact Center
11. Finally test the connectivity that you have configured. To do this, click Ping Web Service for successful ping
test.

Related Information

Technical Objects Replication [page 65]


Technical Object Report: COD_UTIL_TECH_OBJECTS_REPL. Use the Technical Object report to replicate
the contract accounts to the cloud solution.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 81
1.1.3.5 Logical Ports for Outbound Services for
Asynchronous Interface Using SAP Cloud
Integration

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 following Interfaces/services for SAP Cloud Integration.

1. Replication Technical Master data


2. Switch Document Create Notification from SAP ERP
3. Business Partner Replication from SAP ERP
4. Business Partner Relationship Replication from SAP ERP
5. Bushiness Partner Replication confirmation from SAP ERP
6. Business Partner Relationship Replication confirmation from SAP ERP

SOAMANAGER Configuration for SAP Cloud Integration System as the


Middleware

 Note

Screenshot provided is for one of the example services.

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 Integration outbound service name or the ERP service name and click Search.

Utilities Contact Center Administrator Guide


82 PUBLIC ERP Edition for Utilities Contact Center
4. For this Consumer Proxy, create a logical port and select Manual Configuration.

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

6. For Authentication Settings, under UserID/Password and enter your SAP Cloud Integration system user ID
and password. Click Next.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 83
7. Under HTTP Settings, provide the technical connectivity details pointing to the SAP Cloud Integration
system. Then click Next.
8. Under SOAP Protocol, enter the following details:
• RM Protocol - SAP RM
• Message ID Protocol - SAP Message ID
• Data Transfer Scope - Basic Data Transfer

 Note

The endpoint of any iFlow can be determined by referring to the sender connector of the SAP Cloud
Integration system. The /cxf is added for all the urls.

9. Click Next.

Utilities Contact Center Administrator Guide


84 PUBLIC ERP Edition for Utilities Contact Center
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 Integration system connection, the ping test returns a fail as this is an empty request for
SAP Cloud Integration. Note that the logs you to the HCI monitoring. This failed message determines a
successful connectivity between ERP and SAP Cloud Integration.

1.1.3.6 Configure Mashup for Front Office Process (FOP)

To integrate the front office processes with your SAP ERP system, you must create and configure a new
mashup.

To create a new mashup, follow these steps:

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 85
1. Go to Administrator Mashup Authoring New URL Mashup .
2. Select a mashup category and port binding.
3. Enter a mashup name and description.
4. Enter the ISU system URL in the following format:
https://ldxxxxx.wdf.sap.corp:XXXXX/sap/bc/gui/sap/its/webgui
5. Enter additional parameters, such as client and language.

To configure a new mashup, follow these steps:

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 Cloud for
Customer Utilities. For more information, see the reference in the related links section.

Related Information

Assign Front Office Processes [page 60]


Assign the front office processes that you need to launch from SAP Cloud for Customer in the
Implementation Guide customizing.

Mashups

1.2 Functional Scenarios

Learn about the functional scenarios in the Utilities Contact Center.

Customer Search [page 87]


Search for utilities customers in the cloud solution and in the SAP ERP system.

Live Activity Center and Enterprise Search [page 88]


Enterprise search in HTML client and Live Activity Center-based search in Fiori client are available for
Utilities Contact Center. The utilities-specific object categories are available in enterprise search or live
activity center only if the Utilities Call Center solution is scoped in the system.

Move Processes [page 94]


You can initiate Move-In, Move-Out, and Transfer services from all the Utilities screens of a customer.

Alerts [page 106]

Utilities Contact Center Administrator Guide


86 PUBLIC ERP Edition for Utilities Contact Center
You can view static content under the Alerts side panel across the Customer, Premise, and Contact
Account screens in Utilities Contact Center solution. The Alerts framework is also available at every
stage of move processes.

Premise [page 107]


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.

Contract Accounts [page 117]


This work center view displays all contracts for a selected contract account including information such
as move-in and move-out dates.

Utilities Views in Customers [page 134]


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.

Sales POD [page 174]


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.

Front Office Process [page 180]


Configure the Front Office Process in your SAP Cloud for Customer.

MDT Based Processes [page 180]


Configure the Master Data Template (MDT) process in your SAP Cloud for Customer to create guided
move-in and guided transfer.

Account Executive Dashboard [page 183]


Account Executive Dashboard contains information tiles to show corresponding list view of configured
object for the user’s key accounts.

Business Partner Exception Management (BPEM) - Integration with SAP ERP or SAP S/4HANA System
[page 185]
Configure the Business Partner Exception Management in your SAP Cloud for Customer.

Audit Trail - Logs in ERP System [page 191]


You can now use the logs in ERP system to track updates performed in the Utilities Financials screens.

Depersonalization in Contract Account and Sales POD [page 191]


Depersonalization is only available for users with access to the Data Protection and Privacy work center.

Appendix with List of Relevant ERP Transactions [page 192]

1.2.1 Customer Search

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 87
 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.

Customer Search

1.2.2 Live Activity Center and Enterprise Search

Enterprise search in HTML client and Live Activity Center-based search in Fiori client are available for Utilities
Contact Center. The utilities-specific 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.

• Utilities-Contract Accounts
For basic search for contract accounts, search using Contract Account and Contract Account Name
• Utilities-Customer
For basic search for customers, search using Customer ID, First Name, Last Name, Phone Number, and
Email Address.
• Utilities-Point of Delivery
For the basic search for POD, search using POD ID, Installation ID.
• Utilities-Premise
For basic search for premise, search using Premise ID and Address.

Live Activity Center

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.

Utilities Contact Center Administrator Guide


88 PUBLIC ERP Edition for Utilities Contact Center
Configure Search Objects

To configure search objects, follow these steps:

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.

Conditions for Enterprise Search and Using Live Activity Center

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.
• Search using house number, apartment ID, and floor ID must have a combination of postal code or city
or street name.
• Search using street name must be executed along with either postal code or city or house number.

Live Activity - Identify Customers from Independent Communication


Information

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 89
1.2.2.1 View Contract Account and Premise Details in Live
Activity Center

In Live Activity Center, you can view the contract account and premise details of a 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 and Premise Tables checkbox.

Live Activity Configuration

When you select a customer or account, a table with the contract account and premise details appears.

Utilities Contact Center Administrator Guide


90 PUBLIC ERP Edition for Utilities Contact Center
Contract Account and Premise table in Live Activity

1.2.2.2 Confirm Contract Account in Live Activity Center

In Live Activity Center, you can confirm the contract account details of an already confirmed customer and
account and the same contract account is default across all the screen.

When you choose 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 defaults 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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 91
Confirm Contract Account in Live Activity

Confirm Contract Account from IVR in Live Activity

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, as an administrator 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.

Identify Customer when Contract Account is passed from IVR

It is possible to identify a customer when contract account is passed from IVR. When contract account
is passed in any of the custom fields, the identification happens only on the Utilities-customer category

Utilities Contact Center Administrator Guide


92 PUBLIC ERP Edition for Utilities Contact Center
and caller is identified. The search result set also comes from the Utilities-customer category. The service
ISU_C4C_FINDCUST(S4)/COD_UTILITIES_FINDCUST(ECC) has to be enabled for the functionality to work.

The caller is identified based on the ISU finder results when the phone number and contract account are
passed from the IVR.

If any changes needed from standard behavior then the S4/ECC BADI has to be implemented.

Confirm Collective Contract Account from IVR in Live Activity

This enables 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.

Reuse Libraries for Contract Account

The reuse libraries for contract account provide additional, specific services to the scripting language that are
relevant to fetch the confirmed contract account.

Get Confirmed Objects


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.

Example import AP.CRM.Global;var ConfirmedObjects =


UtilitiesLib.GetConfirmedObjects(this.CustomerUUID);
this.ConfCAID =
ConfirmedObjects.UtilitiesConfirmedObjectElements.GetFirst().Confirm
edObjectValue;;

Result:

The confirmed contract account will be returned.

1.2.2.3 Open Customer Hub from Live Activity

When a call is simulated through IVR, the respective customer gets identified in Live Activity and the Customer
Hub screen 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 option
Open Customer Hub.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 93
Once you enable the option of opening customer hub, you are able to enable 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 option Consider Contract Account View in Customer Hub.

1.2.3 Move Processes

You can initiate Move-In, Move-Out, and Transfer services from all the Utilities screens of a customer.

1.2.3.1 Configure Scripts for Move Processes

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.

To configure the script and rule, follow the steps:

1. Navigate to Administrator Industry Settings Utilities Move In/Out Script .


2. On the Move In/Out Scripts page, perform the required actions. The following table describes the sections
that appear on the page:

Section Description

Manage Message Do the following:


• If you want the script to be displayed, set Show Script
to Yes.
• If you want the script to be mandatory, set Mandatory
to Yes.

Message Configuration Do the following:


• To create a new script, select New.
• To modify an existing script, select Edit.
• To delete a script, select Remove.

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.

Utilities Contact Center Administrator Guide


94 PUBLIC ERP Edition for Utilities Contact Center
Configure Scripts for Move Processes

1.2.3.2 Configure Message Severity for Move Processes


As an Administrator, configure the severity of the messages received during the move process. You can also
suppress the message if you do not want them to display.

Configure Message Severity

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 95
1. Navigate to Business Configuration Overview .
2. Under Activity, search and select Utilities.
3. Select the Message Severity Configuration.
4. Select the severity for each message as you need.
5. Select the Suppress Message check box if you do not want to display any message.
6. Click Save.

1.2.3.3 Move-In

The Utilities Contracts view screen for a customer initiates the move-in service in the ERP system from your
cloud solution.

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

You can create move-in either using:

• Move-In in the various utilities processes.


• Move-In in the Customer toolbar; This is a guided move-in process.
• Move-In using MDT in the Customer toolbar; This is a guided move-in process.

 Note

For guided move-in, you can only use either Move-In or Move-In using MDT. During early
implementation, do the decision and necessary configuration.

To create a move-in, you must specify the mandatory fields Contract Account, Start Date, Joint Invoicing, and
select the service address. The service address populates the mailing address. The ERP system pulls the list of
contract accounts available for selection.

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 if you do n’t set the flag for New Mailing Address the standard
address in the ERP system is not updated. Validity date range with new Valid From and Valid To fields are
available 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 Address Type Ahead Search.

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

Utilities Contact Center Administrator Guide


96 PUBLIC ERP Edition for Utilities Contact Center
the move-in, a new move-in document and contract are created for the customer (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.

Rate Category Selection During Move-In

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

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 97
Change 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.

 Note

You can have an alternative view for the change move-in process where the original date is saved along with
the new move-in date based on the scoping question.

The new date is reflected in the Meter Reading table and Customer Overview table for a Premise. If you
cancel the change move-in process, move-in date resets to the original date and the meter reading order is
not reversed as it has already been created.

1.2.3.3.1 Guided Move-In

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.

Steps in a guided move-in are discussed as follows:

1. Customer and Premise


• The Customer section defaults the customer ID and name. To create a new individual customer, select
New Customer; and to create an account select New Account. When a new customer or an account is
created, a contract account is created automatically.

 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 Address Type Ahead Search

 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 59]

• The Premise section displays the Move-In Address, Move-In Date (current date), and Supplementary
Fields.

Utilities Contact Center Administrator Guide


98 PUBLIC ERP Edition for Utilities Contact Center
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.

 Note

The round trips made to ERP Cloud are reduced where services and meter reading reusable
Embedded Component (EC) are available.

In the following ECs, the property in the inport 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

• The Meter Information table displays meter details such as device category, register group, AMI status,
capabilities, and manufacturer serial number in the move-in process. Create and change the meter
reading screens to view device information record.

 Note

View meter reading history using the History option.

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

• Move-In Date is the same as selected for the service.


3. Contract Account and Billing
• The header section displays Customer ID, Move-In Address, and Move-In Date.
• In the Contract Account section, you can create a new contract account. From the External ID value
help search you can select an existing contract account.
• Billing information such as Joint Invoicing, Reason for Deposit, and Security Deposit are defaulted for
the selected contract account.
• In the mailing address section, you can select one of the following options to enter the mailing address:
1. Use Customer Address to auto fill the fields with customer address.
2. Use Premise Address to auto fill the fields with premise address.
3. Add New Address to enter the fields manually.
or use the PO Box details option to add the PO box address details for the customer.
• Create additional notes. Notes that what you create here will also be reflected in your ERP system.
• The Calculate Security Deposit tab is an empty service that can be implemented using the
COD_UTIL_SECURITY_DEPOSIT or ISU_C4C_SECURITY_DEPOSIT business add-in.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 99
4. Additional Offering
• Select and add the External products configured in product list for the particular customer.

 Note

Use the Refresh button to update the product list instead of restarting the move-in process.

After adding the products, the system creates corresponding sales quotes for the products selected and
they are visible in the Sales Quotes tab.

 Restriction

• The Guided Activity Floorplan (GAF) data automatically disappears after Move-In action.
• Product lists are not handled for sales areas, territory, and so on.
• The custom extensions for Sales process are 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.

Related Links

MDT Based Processes

1.2.3.3.2 Use the Contract Level Security Deposit and Joint


Invoicing Details in Move in Process

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.

Utilities Contact Center Administrator Guide


100 PUBLIC ERP Edition for Utilities Contact Center
1.2.3.3.3 Perform Rate Simulation in Move in Processes

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

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 101
have not set the flag for New Mailing Address. Validity date range is introduced in Move-Out 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 Address Type Ahead Search

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.

1.2.3.4.1 Guided Move-Out

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.

Steps in a guided move-out are discussed as follows:

1. Customer and Premise:


• The Customer section defaults the customer ID and name.
• The Premise section displays the Move-Out Address and the Move-Out Date (current date). Select a
move-out reason using value help on the field.
2. Services:

Utilities Contact Center Administrator Guide


102 PUBLIC ERP Edition for Utilities Contact Center
• 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.

 Note

View meter reading history using History option.

• Move-Out Date is the same as selected for the service.


3. Contract Account and Billing:
• The header section displays Customer ID, Move-out Address, and Move-Out Date.
• Possibility to create a new customer and a new contract account in the process of creating a move-out.
• Billing information such as Joint Invoicing, Reason for Deposit, and Security Deposit are defaulted for
the selected contract account.
• In the mailing address section, select Same as Above to copy the move-out address.
• Create additional notes. Notes that you create here will also be reflected in your ERP system.
4. Review:
This step displays a summary of all information maintained in the previous steps. Review the details and
click Create Move-Out to initiate the move-out process.

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.

Process Flow for Transfer of Move-In Address

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 103
 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 Address Type Ahead Search

5. Set the flag for Create Service Order if you need to create a service order to initiate the transfer. For every
device (Equipment) that is moved-in to, a service order can be created. Note that triggering service order
creation is completely optional.
6. In the Meter Reading table, you 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. 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.

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

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.

Guided transfer process includes the following steps:

1. Move Out Premise:


• This section displays the move-out address, date, premise external ID, and move-out reason. Value
help on Move-Out Address lists all premises for the customer. Select an address and move-out reason
using value help on the field.
2. Move Out Services:
• The header displays the customer ID and name, move-out address, and date from the previous step.
• The Services section displays all services available for the customer along with details such as rate
category, installation ID and division.
• The Details section displays meter reading information for a selected service. Estimate or reset of
meter readings is possible.
• The next step displayed is the Contract Account and Billing.
3. Move In Premise:

Utilities Contact Center Administrator Guide


104 PUBLIC ERP Edition for Utilities Contact Center
• The Premise section displays the move-in address, date and premise external ID. Select a move-in
address from value help on the field. All premises for the customer are listed for selection. The move-in
date is defaulted to current date.
• The Customer section displays customer name and ID. This information is defaulted from the
customer for which you create the move-in.
4. Move In Services:
• The Services section displays all services available for the customer along with details such as rate
category, installation ID and division.
• The Details section displays meter reading information for a selected service. Estimate or reset of
meter readings is possible.
• The Meter Information table displays meter details such as device category, register group, AMI status,
and capabilities in the move-in of transfer process. Create and change the meter reading screens to
view device information record.

 Note

View meter reading history using History option.

5. Contract Account and Billing:


• The header displays the customer name and ID, move-in and move-out address and date. These
details are copied from the previous steps.
• Possibility to create a new customer and a new contract account in the process of creating a move-ín.
• Billing information such as Joint Invoicing, Reason for Deposit and Security Deposit are defaulted for
the selected contract account.
• In the mailing address section, select flag Same as Above to copy the move-in address.
• Create additional notes. Notes that you create here will also be reflected in your ERP system.
• The Calculate Security Deposit tab is an empty service that can be implemented using the
COD_UTIL_SECURITY_DEPOSIT or ISU_C4C_SECURITY_DEPOSIT business add in.
6. Review:
This step displays a summary of all information maintained in the previous steps. Review the details and
click Complete Transfer to initiate the transfer process.

 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 59]

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 105
1.2.4 Alerts

You can view static content under the Alerts side panel across the Customer, Premise, and Contact Account
screens in Utilities Contact Center solution. The Alerts framework is also available at every stage of move
processes.

1.2.4.1 Configure the Alerts Tab

As an administrator, use adaptation to add the Alerts tab.

After you add the tab, you can enable it as a side pane in screens. Click your user profile and navigate to
Settings Company Settings and then set the Enable Side Pane toggle to Yes.

Company Setting Screen

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.

Utilities Contact Center Administrator Guide


106 PUBLIC ERP Edition for Utilities Contact Center
Alert Notification

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.

Alerts in Move Process

You can enable the display of alerts in the expanded mode through a scoping question. To configure the
scoping question, go to Business Configuration Implementation Projects . Select your project and click
Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Alerts, select the scoping question Do you want expanded Alerts in Move Processes?

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.

Use advanced search to filter premises.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 107
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.

Premise Quick View to Display Active Services and Active Customer

When you hover over the premise, you can see the details of it under the premise quick view. In addition to the
previously added objects, you can also view the number of existing services, premise type, address in the label

Utilities Contact Center Administrator Guide


108 PUBLIC ERP Edition for Utilities Contact Center
and the current active customer under this premise quick view.

1.2.5.1 Views in Premise

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.

1.2.5.1.1 Overview

This screen has 3 subsections, namely the Customer Map 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

In this section, you can:

• 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 create a guided move-out.
• Cancel a Move-Out.
• Change a Move-Out.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 109
• Create a new simple Transfer. Use the Transfer on the toolbar to create a guided transfer.

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

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

The Meter Information table displays meter details such as device category, register group, AMI status,
manufacturer serial number, and capabilities in the move-in and move-in of transfer processes.

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.

Utilities Contact Center Administrator Guide


110 PUBLIC ERP Edition for Utilities Contact Center
Meter Reading

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

For AMI, the create and edit actions are disabled as the meter reading entry is captured automatically from
backend.

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

Interim Meter Reading


You can now enter or estimate an interim meter reading with or without billing. You must specify the
appropriate meter reading reason and type.

Meter Reading Estimate, Override, and Reset


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.

Meter Reading Order


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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 111
• 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’s 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’s possible
to enter new meter reading only for the following meter reading reasons: 02- Interim meter reading with
billing, 09-Interim meter reading without billing, and 10- Control Reading.
• 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, 09,
and 10.

View Information About the Validity of a Meter

The validity period of meter of a premise or an installation are displayed under Meter Information table.

Utilities Contact Center Administrator Guide


112 PUBLIC ERP Edition for Utilities Contact Center
View Device Location Details

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 pop up.

Advanced Metering Infrastructure (AMI)

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:

• Customers Utilities 360 Object Hierarchy Device Details .

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 113
• Utilities Premise Connection Details Device Details .
On the Connection Details page, click Ping to receive the status of the meter from the call center. The
status comes with details that can be used for analysis. 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.

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

1.2.5.1.3 Tickets

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

Utilities Contact Center Administrator Guide


114 PUBLIC ERP Edition for Utilities Contact 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 SAP 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.

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

1.2.5.1.5 Service Notifications

For more information, see Utilities Service Notifications.

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

For more information, see Sales POD .

1.2.5.1.7 Exceptions

For more information, see Business Partner Exception Management (BPEM)

1.2.5.1.8 Disconnection Documents

In the this screen, view the disconnected documents associated with a premise or an installation.

 Note

Documents that have no disconnection activity are not displayed.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 115
1.2.5.1.9 Central

This tab displays cards such as Customer, Recent Tickets, and Recent Meter Readings.

You can perform the following actions:

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

1.2.5.2 Premise Object Title

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.

Utilities Contact Center Administrator Guide


116 PUBLIC ERP Edition for Utilities Contact Center
1.2.5.3 Configure Safety Message for Reconnect

As an administrator, you can configure a safety message to reconnect the AMI smart meter.

Go to Administrator Industry Settings Utilities Safety Message for Reconnect .

On the Safety Message for Reconnect, you can manage the message to be mandatory or optional.

Safety Message for Reconnect

If the message is set to mandatory, when you select a device to reconnect the message appears in the
Reconnect popup.

1.2.6 Contract Accounts

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 117
 Note

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.

Alternate Contract Account Work Center

This new work center provides you the capability to use value help search in advance search.

 Note

Collective Contract Account hyperlink is disabled in contract account work center list to improve the
performance.

Possibilities for Creating New Contract Accounts

You can create new contract accounts using:

• The Create Contract Account in the toolbar for Customers.


• The Move-In (guided move-in) in the toolbar for Customers. The guided move-in using the master data
template (MDT) allows you to extend the functionality by adding new fields or removing existing ones.

Possibilities for Editing Contract Account

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.

Utilities Contact Center Administrator Guide


118 PUBLIC ERP Edition for Utilities Contact Center
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 59]
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.

Contract Account Replication [page 71]


Contract Account Replication Report: COD_UTILITIES_ACCOUNT_EXTRACT. Use this report to replicate
the contract accounts to the cloud solution.

Contract Account Delta Replication [page 73]


This document describes the configuration required to run the report
COD_UTILITIES_ACCOUNT_EXTRACT in order to fetch the delta for contract accounts.

1.2.6.1 Configure Alternate Contract Account Work Center

As an administrator, you can configure a new Contract Account Work Center with value help capabilities for
advanced search fields.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to enable the new contract account work
center with value help capabilities for advanced search fields?

1.2.6.2 Views in Contract Account

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 specifically to the selected
contract account.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 119
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.

1.2.6.2.2 Tickets

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.

 Note

If required, release the contract account field in Service Request Industry Extension BO to consume in a
custom oData service.

Utilities Contact Center Administrator Guide


120 PUBLIC ERP Edition for Utilities Contact Center
1.2.6.2.3 Locks and Contracts
This screen displays all the locks related to the contract account and contract.

This screen has the following three 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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 121
Select a contract and use Actions Edit Block to edit details such as Billing Reason and Release Reason for
a contract.

Contract Locks

When you select a contract in the Contracts table, the corresponding locks for the contract are displayed in the
Contract Locks table. 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.

Utilities Contact Center Administrator Guide


122 PUBLIC ERP Edition for Utilities Contact Center
1.2.6.2.4.1 Create Invoice

Create invoicing for billing documents.

Create Invoice with Meter Reading

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:

1. Click the invoice with meter reading


2. Enter the meter reading in the add meter reading table – against the item that is already defaulted (option
of changing the date is possible).
3. In the above step, specify meter readings or choose to estimate the meter reading and then submit the
meter reading.

 Note

• For AMI, the create and edit actions are disabled as the meter reading entry is captured
automatically from back end. Actions such as Estimate, Validate, Reset, and Override are not
allowed for AMI meter reading.
• View meter reading history using the History option.
• The utilities screens have been enhanced to create and change all the meter reading screens to
consider device information record.
• The Save and Override button is enabled only when the meter read is implausible(02).

4. Select a contract account in the table.


5. Click the Bill Now. Billing documents appear in the billing documents table
6. Select a valid billing document in the list.
7. Choose to first Simulate (Use this feature to view an invoice before you generate one from the billing
documents.) or directly Invoice.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 123
1.2.6.2.5 Open Items

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.

Utilities Contact Center Administrator Guide


124 PUBLIC ERP Edition for Utilities Contact Center
1.2.6.2.7 Account History

This screen displays history of all financial transactions pertaining to the contract account.

For the selected line item, you can perform the Reversal action.

1.2.6.2.8 Security Deposit

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 125
1.2.6.2.9 Collection

This screen displays the collections details pertaining to the open contract account.

The details that appear in the Collections tab are:

• 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. Write-off data provides information on a
business partner's payment history.

1.2.6.2.10 Communication Preference

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.

Utilities Contact Center Administrator Guide


126 PUBLIC ERP Edition for Utilities Contact Center
Related Information

Configure Smart Energy Water [page 25]


Configure the Communication Preferences, Consumption Graph, Outage map, and Compare tabs from SAP
Cloud for Customer to integrate the Smart Energy Water (SEW) with SAP ERP system .

1.2.6.2.11 Consumption Graph

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 127
Related Information

Configure Smart Energy Water [page 25]


Configure the Communication Preferences, Consumption Graph, Outage map, and Compare tabs from SAP
Cloud for Customer to integrate the Smart Energy Water (SEW) with SAP ERP system .

1.2.6.2.12 Billing Plans

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.

1.2.6.2.13 Payment Arrangements

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.

Utilities Contact Center Administrator Guide


128 PUBLIC ERP Edition for Utilities Contact Center
Utilities Contact Center Administrator Guide
ERP Edition for Utilities Contact Center PUBLIC 129
1.2.6.2.14 Central

This tab displays cards such as Recent Invoices, Last Payment, Premises, Locks, Recent Tickets, Open Items,
Customer Credit Worthiness, Security Deposit, and Dunning.

You can perform the following actions:

• To go to that particular tab, click the card title.


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

1.2.6.2.15 Outage Map

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.

Utilities Contact Center Administrator Guide


130 PUBLIC ERP Edition for Utilities Contact Center
Related Information

Configure Smart Energy Water [page 25]


Configure the Communication Preferences, Consumption Graph, Outage map, and Compare tabs from SAP
Cloud for Customer to integrate the Smart Energy Water (SEW) with SAP ERP system .

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 131
Related Information

Configure Smart Energy Water [page 25]


Configure the Communication Preferences, Consumption Graph, Outage map, and Compare tabs from SAP
Cloud for Customer to integrate the Smart Energy Water (SEW) with SAP ERP system .

1.2.6.3 Contract Account Object Title

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.2.6.4 View Collective Account as a Contract Account


Object

Launch collective account as a contract account object. A Central tab with details of the collective contract
account is displayed.

Following are the tabs displayed in the contract account:

• Recent Invoices
• Child Accounts
• Recent Tickets
• Open items

Utilities Contact Center Administrator Guide


132 PUBLIC ERP Edition for Utilities Contact Center
1.2.6.5 Configure Profile Setup for Contract Account with
BRF plus Rules

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.

Configure Profile Setup

1. Go to Business Configuration Overview .


2. Under Activity, search and select Utilities.
3. Select the Maintain Card and Tab to Configure Profile.

Create Profile Configuration

To create a profile configuration, follow these steps:

1. Navigate to Administrator Industry Settings and select Contract Account Profile Configuration.
2. Slide the Enable 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. Once saved, the profile ID cannot be changed.
5. Select the Visible check box for the cards and tabs from the list that you need.
The Central tab is automatically selected if any card is selected from the card list. You cannot disable the
central tab once it is selected.
Delete the cards or tabs that you don’t want for the profile. You can also add the deleted cards or tabs using
+ icon.
6. Click Save.

 Note

To save the configuration at least one profile should be marked as default.

Add rules for value determination

To add the rules for value determination, follow these steps:

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 133
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
4. Enter the Profile ID as output field.
If you make changes to your profile, you must adjust the rules accordingly.
5. Click Save.
6. 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.

1.2.7 Utilities Views in Customers


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.

Toolbar Options for Utilities

The following utilities specific options are available under Customer:

• Guided processes for Move-In, Move-Out, and Transfer.


• Object Hierarchy - Displays the complete object hierarchy for a selected contract account.
• Create Contract Account - Launches a dialog box with mandatory fields required for creating a new
contract account.
• Launch FOP - Launches the front office process that you have defined front office process in the ERP
system and assigned to your utilities solution.

Utilities 360 [page 135]


A 360 degree overview of the object hierarchy for all utilities objects.

Utilities Financials [page 142]


The Financials screen displays a detailed overview of the business partner invoices, payments, open
items, installment plans, and payment plans.

Utilities Collections [page 158]


The Utilities Collections tab displays the collection details of the selected individual customer.

Utilities Contracts [page 161]


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

Utilities Contact Center Administrator Guide


134 PUBLIC ERP Edition for Utilities Contact Center
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.

Utilities Service Orders [page 163]


The Utilities Service Orders view screen displays a list of service orders for the selected customer.

Utilities Rate Change [page 165]

Utilities Payment Data [page 167]


Use the Utilities Payment Data tab to view and update the bank details of an individual customer.

Utilities Owner Allocation [page 168]


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.

Utilities Service Notifications [page 169]

Utilities Addresses [page 170]


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.

Utilities Exceptions [page 172]


Relevant BPEM cases are displayed in the Utilities Exceptions tabs in Customer and Premise,
respectively.

Utilities Communications Data [page 173]


The Utilities Communications Data tab helps you to view independent communication address details
of a customer.

Utilities Switch Document [page 174]


The Utilities Switch Document tab displays all the switch documents for a customer - irrespective of the
document status and type.

1.2.7.1 Utilities 360

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.

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 subnodes for this collective contract account.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 135
 Note

• If records for business partners are more than a hundred, an icon for More is displayed.
• The number of Contract accounts/child contract accounts in hierarchy view or list view is limited to
100 by default.

Recent History

The Recent History 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, Type, Priority, Additional Info, Delete Flag, Text , 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.

During implementation, the administrators must determine the contact types from IS-Utilities to be displayed
in the cloud solution. Further, a sample business add-in implementation is available to extend this feature. The
BAdI implementation is mandatory; the contacts table is displayed empty if BAdi is not implemented.

Utilities Hierarchy

Utilities hierarchy consists of 3 views such as Configurable Hierarchy, Hierarchy view, and List view. The
features of utilities hierarchy are as follows:

• 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 any object in the hierarchy to display further details in the corresponding details screen.
For example, for a contract account, the Dunning Procedure and Payment Terms are some of the details
displayed in the details screen.
• The contract account (or collective contract) account, premise, contract, installation, and device are
displayed for each top level hierarchy node in Utilities Hierarchy.

Configurable Hierarchy View


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 as follows:

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 .

Utilities Contact Center Administrator Guide


136 PUBLIC ERP Edition for Utilities Contact Center
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.

You can select a configurable hierarchy view from the list for 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.

Alternate views
The list view or hierarchy view displays the utilities object structure you have created in the SAP ERP system, in
your cloud solution. 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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 137
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.

The Meter Information table displays meter details such as device category, register group, AMI status, and
capabilities in the move-in and move-in of transfer processes.

Perform the following actions in the Utilities Hierarchy:

Utilities Contact Center Administrator Guide


138 PUBLIC ERP Edition for Utilities Contact Center
• 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 like Utilities 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 mentioned screens of the confirmed
customer. Further, a field Confirmed Contract Account is displayed before the table with the confirmed
contract account ID. Note that this action is grayed 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.
• Search - Search for a contract account, point of delivery, and premise using this action. Note that search in
the Utilities 360 work center view performs an online search in the ERP system.
• Launch FOP - After you assign FOP profile for configurable hierarchy, you can launch front office process
for a line object selected.

FOP Profile

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 139
Utilities Contact Center Administrator Guide
140 PUBLIC ERP Edition for Utilities Contact Center
You can also launch FOP by selecting any line item in the hierarchy and can also view the hierarchy details of
the objects of the selected line item passed in the URL.

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

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 141
Related Information

1.2.7.2 Utilities Financials

The Financials screen displays a detailed overview of the business partner invoices, payments, open items,
installment plans, and payment plans.

This also displays the premise and contracts associated with the business partner.

You can perform actions such as updating meter readings, invoicing, budget billing, installment plans, and so
on, from the various tabs in this screen.

Utilities Contact Center Administrator Guide


142 PUBLIC ERP Edition for Utilities Contact Center
 Note

In the Utilities 360 screen, if you confirm a contract account, then the same contract account defaults for
all actions in Utilities Financials.

This screen displays a list of invoices created for business partner which as one or more corresponding billing
documents and 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. 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 defaults across the financials
screen. You can also select a contract account in the header to display the latest Dunning Level for the account.
The Open Items tab displays the item level dunning information such as Dunning Text, Dunning Level, and
Dunning Step.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 143
 Note

Click Contract Account Details to navigate to the confirmed contract account or filter and select another
contract account in the Filter Contract Account section.

Tabs in Financials Screen

The Utilities Financials screen has the following 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.

Financials in Customer Views

For the first time, if the Utilities Financial in customer loads, a synchronous call to the SAP ERP IS_Utilities
gets initiated. When you navigate between different tabs (Open Items, Invoices, Payments, and so on) the data
retains; During initial load or when you select a seperate contract account, makes a new call to the IS-U.

When you perform specific action in any of these tabs, a new service to IS-U initiates. For example, when you
perform any action in Payments or Open Items tab and navigate to Invoices tab, initiates a service call to IS-U.

The table contains detail information on the tab screens and actions that initiates a call to IS-U.

Tab Screen Action Refresh Done on Navigation

Invoice Create Invoice, Full Reversal, and Adjustment Open Items


Reversal

Payments Cancel Payment Open Items and Invoice

Open Item Manual Posting, Deferral, Reversal Invoice

Installment Plan Create Identity Provisioning, Edit IP, and De- Open Items
activate IP

Payment Plan Create PP, Edit PP, and Deactivate PP Open Items

Budget Billing Create and Edit Open Items

One Time Payment Payment and Open Items

Utilities Contact Center Administrator Guide


144 PUBLIC ERP Edition for Utilities Contact Center
Bill Correction [page 145]
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.

Create Invoice [page 123]


Create invoicing for billing documents.

Bill and Invoice [page 148]


Create billing documents and invoices for a valid meter reading.

Payments [page 148]

One Time Payment [page 149]


Use the Utilities Financials tab of an individual customer to make a one time payment with the existing
or new bank account.

Document Locks [page 151]

Installment Plans [page 152]


Create installment plans for open items in an invoice.

Invoice Document [page 153]


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.

Payment Plans [page 153]


Create, edit, display, delete, and deactivate payment plans from the Payment Plans tab in the Financials
screen.

Budget Billing Plan [page 154]


In Utilities Financials, for a valid contract, you can create, edit, and delete a budget billing plan.

Contracts with Meter Reading [page 154]


Create and update meter readings in this section. On selection of a contract in the table for Contracts,
the meter reading table lists the corresponding values of existing meter reading.

Open Items [page 156]


Create manual posting, deferal, reversal for the open items.

1.2.7.2.1 Bill Correction

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.

Important ERP IS-U Transactions for Financials

Transaction Function

EA05 List of outsorted billing/invoice docs

EA40 Display print document

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 145
Transaction Function

EA14 Reverse print document

EA19 Create bill

EA20 Billing document reversal

EASIBI Individual bill

1.2.7.2.1.1 Adjustment Reversal and Full Reversal

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 updated invoice from ERP 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. 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.

 Note

The Save and Override button is enabled only when the meter read is implausible(02).

6. Save the meter reading.

Utilities Contact Center Administrator Guide


146 PUBLIC ERP Edition for Utilities Contact Center
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 the bill correction
3. Enter the reversal reason
4. Click the Full Reversal and the invoice line item is reversed.
5. Click Meter Reading. A new window appears with the device and meter reading details.

 Note

The Save and Override button is enabled only when the meter read is implausible(02).

6. Save the meter reading.

1.2.7.2.1.2 Rebill

Use the Rebill feature to update incorrect meter readings.

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 .

1.2.7.2.2 Create Invoice

Create invoicing for billing documents.

Create Invoice with Meter Reading

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:

1. Click the invoice with meter reading


2. Enter the meter reading in the add meter reading table – against the item that is already defaulted (option
of changing the date is possible).
3. In the above step, specify meter readings or choose to estimate the meter reading and then submit the
meter reading.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 147
 Note

• For AMI, the create and edit actions are disabled as the meter reading entry is captured
automatically from back end. Actions such as Estimate, Validate, Reset, and Override are not
allowed for AMI meter reading.
• View meter reading history using the History option.
• The utilities screens have been enhanced to create and change all the meter reading screens to
consider device information record.
• The Save and Override button is enabled only when the meter read is implausible(02).

4. Select a contract account in the table.


5. Click the Bill Now. Billing documents appear in the billing documents table
6. Select a valid billing document in the list.
7. Choose to first Simulate (Use this feature to view an invoice before you generate one from the billing
documents.) or directly Invoice.

1.2.7.2.3 Bill and Invoice

Create billing documents and invoices for a valid meter reading.

The Bill and Invoice tab 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 theInvoice 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 meter reading reasons are available for Bill and Invoice: 01 - Periodic Meter Reading
and 02 - Interim Meter Reading with Billing.
• For Create Invoice, Override button is disabled until you clicks on the validate button.
• The Save and Override button is enabled only when the meter read is implausible(02).

1.2.7.2.4 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:

Utilities Contact Center Administrator Guide


148 PUBLIC ERP Edition for Utilities Contact Center
• Payment Document No.
• Posting Date
• Amount Paid
This shows the header payment line items indicating the total payment made on a particular day against
the customer.
• Payment Origin
• External Contract Account
• Cleared Amount
These items indicate partial or complete payments cleared against the open items in the contract account.
• Description

The Payments tab displays the status of payments such as scheduled, posted, and reversed. You can also
cancel a scheduled future payment.

1.2.7.2.5 One Time 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, seeEnable or Disable Fields or Actions .

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 149
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.

Utilities Contact Center Administrator Guide


150 PUBLIC ERP Edition for Utilities Contact Center
 Note

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.

1.2.7.2.6 Document Locks

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 151
Edit and Delete Locks

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.

1.2.7.2.7 Installment Plans

Create installment plans for open items in an invoice.

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.

Create Installment Plan

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.

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

Utilities Contact Center Administrator Guide


152 PUBLIC ERP Edition for Utilities Contact Center
Cancel Installment Plan

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.

1.2.7.2.8 Invoice Document

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.

1.2.7.2.9 Payment Plans

Create, edit, display, delete, 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, Delete, 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.

It is now possible to choose the payment plan type during the creation of payment plan using scoping.

Perform download/upload of auto code list mapping for payment plan type. Auto code list would be available
from the fine tuning- Maintain Plan type automatically. In create payment plan, a drop down appears and show
the payment plan values that has category 1.

Deactivating a Payment Plan

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 153
• Deletes the starting month for the plan in the ERP system.
• Displays the Deactivated status icon for the status field.
• Displays the deactivation date.

1.2.7.2.10 Budget Billing Plan

In Utilities Financials, for a valid contract, you can create, edit, and delete a budget billing plan.

Create Budget Billing Plan

1. Under Utilities Financials Budget Billing Plan , click New to create a new budget billing plan.
2. In the Create Budget Billing Plan dialog, the Contract Account Ext. ID is selected by default from the Utilities
financial screen and the Budget Billing period is set to the current date.
3. Select a contract account, to view the details of Contracts.
4. Select one or more contracts from the list for which you want to create a budget billing plan and click Next.
5. Enter the data in the Text for Budget Billing field.
6. Optional: If necessary, change the due date and plan amount for each line item. You can also use the
Update Amount action to update the changes for all the plan amount in the Items list.
7. Click Create.

After the plan is created, it's displayed in the Budget Billing Plan section.

You can modify/edit thePlan Amount and Text for Budget Billing for a budget billing plan by selecting the Edit
option.

To edit the existing plans, Plan Amount and Text for Budget Billing, select the budget billing plan and click Edit.

To delete the existing plan, select the budget billing plan and click Delete. Note that the deletion happens only
when there are no payments or further activities for the plan.

1.2.7.2.11 Contracts with Meter Reading

Create and update meter readings in this section. On selection of a contract in the table for Contracts, the
meter reading table lists the corresponding values of existing meter reading.

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 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 system
updates the corresponding meter readings in the ERP system.

 Note

• Meter reading isn’t mandatory for move-in, move-out, and transfer. You can create move-in, move-out
and transfer without specifying meter readings.

Utilities Contact Center Administrator Guide


154 PUBLIC ERP Edition for Utilities Contact Center
• During create/edit meter reading, if the meter reading types are 03-Automatic estimation or 04-
Meter reading interpolated then when you enter the meter reading manually the type changes to 01-
Meter reading by utility company automatically.
• For AMI, meter reading entry captured automatically from the back end and system disables the create
and edit actions. Actions such as Estimate, Validate, Reset, and Override are not allowed for AMI
meter reading.
• Using the auto code list mapping, the system updates all the field help values such as meter reading
note type, reason, and meter reading type. See Related Information section for the topic Code Lists
Mapping.
• Meter Reading Reason and Note defaults by implementing the post badi for FM
COD_UTILITIES_VALUE_HELP in the ERP system.

Interim Meter Reading

You can now enter or estimate an interim meter reading with or without billing. Specify the appropriate meter
reading reason and type.

Meter Reading Estimate, Override, and Reset

Additional features for meter reading: If you enter an incorrect meter reading (meter reading not in the
expected range), the system considers the meter reading as Implausible. Also the system considers any meter
reads in processing status 2 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.

Meter Reading Order

The meter reading table displays a combination of meter reading result, 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 Meter Reading 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 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’s possible to add new meter readings and edit the line item.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 155
• A grayed out check mark indicates the meter reading has already recorded for the order. It’s possible to
create new meter reading only for the following meter reading reasons: 02- Interim meter reading with
billing, 09-Interim meter reading without billing, and 10-Control Reading.
• 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 maintained, edit isn’t possible for meter reading status Billed.

Related Information

Code Lists Mapping [page 77]


Code list mapping must be maintained for the fields specified in the following sections.

1.2.7.2.12 Open Items

Create manual posting, deferal, reversal for the open items.

1.2.7.2.12.1 Manual Postings

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.

1.2.7.2.12.2 Reverse Open Items

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.

Utilities Contact Center Administrator Guide


156 PUBLIC ERP Edition for Utilities Contact Center
Utilities Contact Center Administrator Guide
ERP Edition for Utilities Contact Center PUBLIC 157
1.2.7.2.12.3 Defer Open Items

Use Deferral to defer open items. You can select multiple open items for deferral.

1.2.7.3 Utilities Collections

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.

Utilities Contact Center Administrator Guide


158 PUBLIC ERP Edition for Utilities Contact Center
The tables that appear on the Utilities Collections tab are as follows:

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

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 159
• Returns
• Write-offs
• Security Deposit - Allows you to reverse or release a security deposit.

Utilities Contact Center Administrator Guide


160 PUBLIC ERP Edition for Utilities Contact Center
1.2.7.4 Utilities Contracts

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.

1.2.7.4.1 Meter Reading

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 choose 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

For AMI meters, the create/edit meter reading actions are disabled as the meter reading entry is captured
automatically from back end in the meter reading screens. Actions such as Estimate Validate, Reset, and
Override are not allowed for AMI meter reading.

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

Interim Meter Reading

You can now enter or estimate an interim meter reading with or without billing. You must specify the
appropriate meter reading reason and type.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 161
Meter Reading Estimate, Override and Reset

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.

Meter Reading Order

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 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 Register 1, the system automatically creates meter reading orders for
all other registers associated with the equipments.

Summary of Validations for Meter Readings

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.

Utilities Contact Center Administrator Guide


162 PUBLIC ERP Edition for Utilities Contact Center
• 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.

Validations in Guided Processes

Use Validate UI action to validate meter readings in guided move-in, move-out and transfer.

Validations for Meter Reading Create

• Reset option in the UI dialog for New Meter Reading.


• If meter readings are blank, then meter reading orders are created for meter reading reasons 02 and 09.
• Move-in, move-out and billed meter reads are not editable.

Related Information

Code Lists Mapping [page 77]


Code list mapping must be maintained for the fields specified in the following sections.

1.2.7.5 Utilities Service Orders

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 163
Create Service Orders

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.

Change Service Orders

You can only change the start and end date & time for a service order using the menu option Actions
Change Service Order .

Utilities Contact Center Administrator Guide


164 PUBLIC ERP Edition for Utilities Contact Center
Cancel Service Orders

To cancel a service order, you need to invalidate the start and end date & time accordingly using Actions
Cancel Service Order

1.2.7.6 Utilities Rate Change

View the current rate category and billing parameters for a customer's contract in the Utilities Rate Change
work center view under Customers. In this work center view, choose a contract and click on Rate Change to:

• Modify the rate category using selection help on the field Proposed Rate. The selection help takes the date
from the Valid From option. The rate categories pertaining to the date passed is displayed as the result.
• 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 can’t 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 ).

 Note

• The following parameters/operands are not supported: Operand categories TQUANT,


REFVALUE, SEASON, RATE TYPE.
• During edit rate category, the system does not restrict the change based on the last billing
date.

Simulate Rate Changes

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

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 165
1.2.7.6.1 Rate Change using Master Data Template (MDT)

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?

Utilities Contact Center Administrator Guide


166 PUBLIC ERP Edition for Utilities Contact Center
1.2.7.7 Utilities Payment Data

Use the Utilities Payment Data tab to view and update the bank details of an individual customer.

The Bank Data table displays the bank details of the contract account. The Contract Account Payment Method
table displays the payment details of the contract account.

The New button on the Bank Data table allows you to create new bank details. You can use either the Bank
Details or the IBAN option to create new bank details for Contract Account.

When you select the Bank Details option, the system displays the Country/Region, Bank Key, Bank Account,
Bank Name, Account Holder, SWIFT Code, and IBAN fields. Enter all the fields and click Save.

When you select the IBAN option, the system displays the IBAN, Country/Region, Bank Key, and Bank Account
fields. If you do not know the bank account, you can toggle the Account Number Unknown button to hide the
field.

Enter the IBAN number and click Generate. The system auto-populates the other fields. Click Save to store the
details against the Business Partner.

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 New and Edit buttons in the Bank Data section can be controlled from the business actions. For
more information about business actions, see Enable or Disable Fields or Actions.
• You can enter the IBAN details in text or country/region format for customer. This IBAN detail can be
converted to country/region format from text format or vice versa.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 167
• 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.

1.2.7.8 Utilities Owner Allocation

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.

Utilities Contact Center Administrator Guide


168 PUBLIC ERP Edition for Utilities Contact Center
1.2.7.9 Utilities Service Notifications

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
• 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

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

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 169
 Note

Administrators can configure notification types. Go to Business Configuration Implementation Projects


Your Project Open Activity List Utilities Maintain Notification Type .

An agent can select an order code for a service notification. This enables a better understanding of the purpose
of the service notification.

1.2.7.10 Utilities Addresses

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.

Utilities Contact Center Administrator Guide


170 PUBLIC ERP Edition for Utilities Contact Center
You can filter the addresses based on their usage types, using the advance search option provided on the All
Addresses table.

You can also view the corresponding usage types of the address selected along with the validity dates in the
Address Usages table.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 171
1.2.7.11 Utilities Exceptions

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

Utilities Contact Center Administrator Guide


172 PUBLIC ERP Edition for Utilities Contact Center
Related Information

Business Partner Exception Management (BPEM) - Integration with SAP ERP or SAP S/4HANA System [page
185]
Configure the Business Partner Exception Management in your SAP Cloud for Customer.

1.2.7.12 Utilities Communications Data

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:

• Preferred: Displays the preferred field of the customer communictaion data


• Phone Numbers: Search for phone numbers using basic or advance search parameters such as a phone
number.
• Emails: Search for emails using basic or advance search parameters such as an email address.

Create and Edit Address Independent Communication Information

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 173
The validtaions provided for this are as follows:

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

1.2.7.12.1 Configure Utilities Communication Data


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 . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and
under Utilities Enhancements, select the scoping question Is Time Dependency for BP Independent Address
Communication data enabled in ISU?

1.2.7.13 Utilities Switch Document


The Utilities Switch Document tab displays all the switch documents for a customer - irrespective of the
document status and type.

1.2.8 Sales POD


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

Utilities Contact Center Administrator Guide


174 PUBLIC ERP Edition for Utilities Contact Center
How you can Use Sales POD

You can

• Create and edit new sales PODs


• Import and export a list of sales PODs
• Group a set of sales PODs and assign values to them
• Use Batch IDs for Sales PODs that can help identify an imported list of PODs or help to set attributes for a
group of PODs.
• Specify validity for sales PODs. Only those sales PODs that are set to Released and that are valid on current
date, are considered for the enrollment process.

Creating a Sales POD

Enter the following details to create a sales POD:

• Select a POD for Type


• Select a Premise for Premise ID
• Set flag for Deregulation POD and Technical POD
• Enter the Address fields such as House Number, City, State, and so on.
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 Address Type Ahead Search

Grouping Sales PODs

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 175
Delete Sales PoD and Grouping Information

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.

1.2.8.1 Utilities Enrollment

Guided process for creating a utilities specific quote.

 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 Contact Center Administrator Guide


176 PUBLIC ERP Edition for Utilities Contact Center
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
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.

 Note

You can now create sales quote by launching the wizard from Contacts screen.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 177
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

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.

Utilities Contact Center Administrator Guide


178 PUBLIC ERP Edition for Utilities Contact Center
 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

Enrollment - Configure Switch Document Creation and Notification [page 62]


Detailed information for creating switch document in the cloud solution.

1.2.8.1.1 Integration with Enrollment Process

Detailed information for creating switch document in the cloud solution.

Business Benefits

With the integration of sales POD (Point of Delivery) with sales quote, you can:

• Search for sales POD when creating a quote.


• Select and submit sales POD in quote.
• Set the release flag for the new sales POD. This updates the status of the sales POD to Released.
• Trigger creation of switch document in IS-Utilities using the sales POD information.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 179
How the Integration Works

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 SAP Cloud for Customer with
corresponding ISU POD ID.

1.2.9 Front Office Process

Configure the Front Office Process in your SAP Cloud for Customer.

Launch the front office processes that you have configured in your 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 utilities solution profile. For more information, see Configuring Front Office Process.

1.2.9.1 Configure 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:

• Assign Front Office Processes [page 60]


• Configure Mashup for Front Office Process (FOP) [page 85]

1.2.10 MDT Based Processes

Configure the Master Data Template (MDT) process in your SAP Cloud for Customer to create guided move-in
and guided transfer.

Utilities Contact Center Administrator Guide


180 PUBLIC ERP Edition for Utilities Contact Center
1.2.10.1 Move-In using Master Data Template (MDT)

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 do adaption 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 59]
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.

1.2.10.2 Move-In in Transfer using MDT

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.

Additionally, to enable this feature, administrators must select 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

 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

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 181
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 59]

1.2.10.3 Rate Change using Master Data Template (MDT)

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?

1.2.10.4 Create Customer Using MDT

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.

 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 59]

1.2.10.5 Create Contract Account Using MDT

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.

Utilities Contact Center Administrator Guide


182 PUBLIC ERP Edition for Utilities Contact Center
 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 59]

Edit Cotract Account

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.

1.2.10.6 Different Master Data Template for Move Processes

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.

1.2.11 Account Executive Dashboard

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 183
1.2.11.1 Service Orders

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.

Utilities Contact Center Administrator Guide


184 PUBLIC ERP Edition for Utilities Contact Center
1.2.11.2 Exceptions
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.

1.2.12 Business Partner Exception Management (BPEM) -


Integration with SAP ERP or SAP S/4HANA System
Configure the Business Partner Exception Management in your SAP Cloud for Customer.

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

Maintain the following configuration:

• Define the required case categories in the fine-tuning 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 .

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 185
• Do you want to delegate service tickets from your cloud solution to an external application under
Business Configuration Implementation Projects Your Project Edit Project Scope Questions
Communication and Informaiton Exchange Integration with External Applications Integration with Sales,
Service and Marketing Processes Service Tickets . This service sends the BPEM case ID created to
cloud solution to update in the document flow. This is a confirmation message from SAP ERP or SAP
S/4HANA system to your cloud solution informing that a BPEM case is created.

For more information, see Business Process Exception Management (BPEM).

BPEM Primary Object Validation

As a part of BPEM fine-tuning you can now configure your own clarification case categories by setting the
primary object type in the SAP ERP or SAP S/4HANA system and maintain the same case category in
SAP Cloud for Customer fine-tuning under Business Configuration Overview Utilities Case Category
Maintain Case Category .

 Note

This fine-tuning is not supported for Auto Code List.

The validation takes place as per the primary object type maintained in SAP Cloud for Customer and is skipped
even if it is maintained in SAP ERP or SAP S/4HANA System.

1.2.12.1 Configure Replication of BPEM Status

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.

Navigate to Administrator General Settings Integration Communication Scenarios . Select Industry


Service Request Replication to External System and configure Replicate BPEM Status from ECC for the
corresponding PI (Process Integration) or SAP Cloud Integration content.

Utilities Contact Center Administrator Guide


186 PUBLIC ERP Edition for Utilities Contact Center
The following table describes the BPEM case status:

Status Code Status Value

1 New

2 In Process

3 Completed

4 Canceled

6 Confirmed

The following table describes the SAP Cloud for Customer ticket user status:

Status Code Status Value

1 Open

2 In Process

4 Customer Action

5 Completed

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 187
Status Code Status Value

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:

• In the CHANGED event of the business partner, enter the following:

To register an event handler for the BPEM case in ERP, in the SWE2 transaction code, do the following:

Utilities Contact Center Administrator Guide


188 PUBLIC ERP Edition for Utilities Contact Center
• In the CHANGED event of the business partner, enter 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

1.2.12.2 Service Ticket

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 189
In addition to this you can also view the details of premise address under the Utilities - Premise Address section
group.

Service Location Field in Ticket

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.

Utilities Contact Center Administrator Guide


190 PUBLIC ERP Edition for Utilities Contact Center
1.2.13 Audit Trail - Logs in ERP System

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.

Audit Log New Design

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, SAP 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 SAP Cloud for Customer specific new table.
• Duplication of log table entries is avoided.

1.2.14 Depersonalization in Contract Account and Sales POD

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 191
1.2.15 Appendix with List of Relevant ERP Transactions

List of Valid Meter Reading Reasons and Statuses

List of Valid Meter Reading Reasons

Meter Reading Reason ID Description

01 Periodic Meter Reading

02 Interim meter reading with billing

03 Final meter reading at move-in/out

06 Meter reading at move-in

09 Interim Meter Reading Without Billing

Important ERP IS-U Transactions for Meter Reading

Transaction Code Function

EL01 Create individual MR order

EL27 List of implausible MR results

EL28 Enter single MR result

EL29 List of plausible MR results

EL30 Meter reading result estimation

EL37 Reverse meter reads

EL31 Monitoring (MR results, billing orders)

Important ERP IS-U Transactions for Move-In

Transaction Function

EC50E Create Move-In

EC51E Change Move-In

EC52E Display Move-In

EC53E Reverse Move-IN

Utilities Contact Center Administrator Guide


192 PUBLIC ERP Edition for Utilities Contact Center
Important ERP IS-U Transactions for Move-Out

Important ERP IS-U Transactions for Move-Out

Transaction Function

EC55E Create Move-Out

EC56E Change Move-Out

EC57E Display Move-Out

EC58E Reverse Move-Out

1.3 Extensibility

You can extend both the UI screens and 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 can’t add an extension field with default value for Utilities Contact Center. Recommended to use PDI for
fields extension for Utilities screens.

1.3.1 Functional Extensions Using Business Add-Ins

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

• Move-In in Move-In Guided Application Framework (GAF)


• Move-In in Transfer GAF
• Create Contract Account in Move-In GAF, Transfer GAF and Customer/Account work center view
• Edit Contract Account in Contract Account work center view
• Create Customer in Move-In GAF and Transfer GAF

The following actions of Guided Application Framework can be extended using UtilitiesActionBO. Pre-
Validations are also possible for these actions.

• Move-In
• Move-Out

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 193
• Transfer

1.3.1.1 Contract Accounts

Overview of business add-ins that exist for contract accounts.

Contract Account - Contracts and Blocks

Business Add-In: Contract Account - Contracts and Blocks

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesContractBlocks UtilitiesExtensibility http:// UtilitiesContractsBA- UtilitiesContractsBA-


sap.com/xi/AP/CRM/ DIInput DIResult
Global

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

Utilities Contract Account Locks Actions

Business Add-In: Utilities Contract Account Locks Actions

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesContractAc- UtilitiesExtensibility http:// UtilitiesCALocksModi- UtilitiesContractAc-


sap.com/xi/AP/CRM/ fyBadiInput countLocksActionBA-
countLocksActions
Global DIResult

Utilities Contact Center Administrator Guide


194 PUBLIC ERP Edition for Utilities Contact Center
Utilities Contract Account Contract Locks Actions

Business Add-In: Utilities Contract Account Contract Locks Actions

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesContractAc- UtilitiesExtensibility http:// UtilitiesCAContracts- UtilitiesCAContractAc-


sap.com/xi/AP/CRM/ ModifyBadiInput tionsBadiResult
countContractLock-
Global
sAction

Utilities Contract Account Details

Business Add-In: Utilities Contract Account Details

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesContractAc- UtilitiesExtensibility http:// UtilitiesContractAc- UtilitiesContractAc-


sap.com/xi/AP/CRM/ countFetchBADIInput countBadiResult
countDetails
Global

Utilities Contract Account Locks

Business Add-In: Utilities Contract Account Locks

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesContractAc- UtilitiesExtensibility http:// ContractAccountExe- UtilitiesContractAc-


sap.com/xi/AP/CRM/ cuteLocksBADI countLocksBADIResult
countLocks
Global

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

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 195
Utilities Contract and Locks

Business Add-In: Utilities Contract and Locks

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesContractLocks UtilitiesExtensibility http:// ContractExecute- UtilitiesContractLocks-


sap.com/xi/AP/CRM/ LocksBADI BADIResult
Global

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

Business Add-In: . BADI_UTIL_FIN_ACC_OVERVIEW

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesFinancialAc- UtilitiesExtensibility http:// UtilitiesFinancialOver- UtilitiesFinancialOver-


sap.com/xi/AP/CRM/ viewRequestBADIInput viewBadiResult
countOverview
Global

Utilities Contact Center Administrator Guide


196 PUBLIC ERP Edition for Utilities Contact Center
Utilities Financials Full Reversal

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.

Business Add-In: Utilities Financials Full Reversal

Enhancement Imple-
mentation Business Object Namespace Input Parameters Output Parameters

UtilitiesFullReversal UtilitiesExtensibility http:// UtilitiesFinancialsOver- UtilitiesFinancialsOver-


sap.com/xi/AP/CRM/ viewBadiInput viewBadiInput
Global

New structure ExecuteService has been introduced in the input parameter


UtilitiesFinancialsOverviewBadiInput. This structure has the following indicator flag:

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

Utilities Financials Adjustment Reversal

Business Add-In: Utilities Financials Adjustment Reversal

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesAdjustmentRe- UtilitiesExtensibility http:// UtilitiesFinancialsOver- UtilitiesFinancialsOver-


sap.com/xi/AP/CRM/ viewBadiInput viewBadiInput
versal
Global

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.

New structure ExecuteService has been introduced in the input parameter


UtilitiesFinancialsOverviewBadiInput. This structure has the following indicator flag:

• InvoiceNow

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 197
• 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.

Utilities Financials Pre-Adjustment Reversal

Business Add-In: Utilities Financials Pre-Adjustment Reversal

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesPreAdjustmen- UtilitiesExtensibility http:// UtilitiesFinancialsOver- UtilitiesFinancialsOver-


sap.com/xi/AP/CRM/ viewBadiInput viewBadiInput
tReversal
Global

Use this BAdI exit for an approach for pre-adjustment validations and controlling the modal dialog. Note that
the appropriate messages must be created through the output message structures.

New element in the structure ExecuteService has been introduced in the input parameter
UtilitiesFinancialsOverviewBadiInput. This new element in the structure has the OpenAdjustmentRevPopUp
indicator flag:

If this Enhancement Implementation is created, all the messages are captured for both the scenarios:

• If the flag is set to 'True', then the Modal Dialog opens.


• If the flag is set to 'False', then the Modal Dialog won't open.

Utilities Financials Get Meter Reading

Business Add-In: Utilities Financials Get Meter Reading

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesFinancialGet- UtilitiesExtensibility http:// UtilitiesFinancialGet- UtiltiesFinGetMRBA-


sap.com/xi/AP/CRM/ MeterReadingBADIRe- DIResult
MeterReading
Global sult

Utilities Contact Center Administrator Guide


198 PUBLIC ERP Edition for Utilities Contact Center
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.

Utilities Financials Rebill After Bill Reversal

Business Add-In: Utilities Financials Rebill After Bill Reversal

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesFinancialRebill UtilitiesExtensibility http:// UtilitiesFinancialsOver- UtilitiesFinancialsOver-


sap.com/xi/AP/CRM/ viewBadiInput viewBadiInput
Global

Use this BAdI exit for an alternative approach to the rebill function. The appropriate messages have to be
provided through the output structures.

New structure ExecuteService has been introduced in the input parameter


UtilitiesFinancialsOverviewBadiInput. This structure has the following indicator flag:

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

Utilities Financials Update Meter Reading

Business Add-In: Utilities Financials Update Meter Reading

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesFinancialMeter- UtilitiesExtensibility http:// UtiltiesFinGetMRBA- UtilitiesFinancialsBa-


sap.com/xi/AP/CRM/ DIResult
ReadingUpdate diInput
Global

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 199
Utilities Financial Meter Reading Estimate

Business Add-In: Utilities Financial Meter Reading Estimate

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesFinancialMeter- UtilitiesExtensibility http:// UtiltiesFinGetMRBA- UtiltiesFinGetMRBA-


sap.com/xi/AP/CRM/ DIResult DIResult
ReadingEstimate
Global

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.

Utilities Financial Meter Reading Override

Business Add-In: Utilities Financial Meter Reading Override

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesFinancialMeter- UtilitiesExtensibility http:// UtiltiesFinGetMRBA- UtilitiesFinancialsBa-


sap.com/xi/AP/CRM/ DIResult diInput
ReadingOverride
Global

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.

Utilities Financials Locks

Business Add-In: Utilities Financials Locks

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesFinancialLocks UtilitiesExtensibility http:// UilitiesFinancialLocks- UtilitiesFinancialLock-


sap.com/xi/AP/CRM/ DisplayBadiInput BadiResult
Global

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 following indicator flag:

• CreateLock
• DisplayLocks
• EditLock

Utilities Contact Center Administrator Guide


200 PUBLIC ERP Edition for Utilities Contact Center
• 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.

Utilities Financial Create Locks

Business Add-In: Utilities Financial Create Locks

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesFinancialCrea- UtilitiesExtensibility http:// UtilitiesFinancialCrea- UtilitiesFinancialCrea-


sap.com/xi/AP/CRM/ teLocksBadiInput teLockBadiResult
teLocks
Global

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.

New structure ExecuteService has been introduced in the input parameter


UtilitiesFinancialCreateLockBadiResult. This structure has the following indicator flag:

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

Utilities Financial Edit Locks

Business Add-In: Utilities Financial Edit Locks

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesFinancialEdit- UtilitiesExtensibility http:// UtilitiesFinancialEdi- UtilitiesFinancialEdi-


sap.com/xi/AP/CRM/ tLockBadiInput tLocksBadiResult
Locks
Global

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.

New structure ExecuteService has been introduced in the input parameter


UtilitiesFinancialEditLocksBadiResult. This structure has the following indicator flag:

• CreateLock

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 201
• 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.

Utilities Financial Delete Locks

Business Add-In: Utilities Financial Delete Locks

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesFinancialDele- UtilitiesExtensibility http:// UtilitiesFinancialDele- UtilitiesFinancialDelte-


sap.com/xi/AP/CRM/ teLocksBadiInput LocksResult
teLocks
Global

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

Utilities Dunning History

Business Add-In: UtilitiesDunningHistory

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesDunningHis- UtilitiesExtensibility http:// UtilitiesServiceDun- UtilitiesServiceDun-


sap.com/xi/AP/CRM/ ningHistoryBadiInput ningHistoryBadiInput
tory
Global

Utilities Contact Center Administrator Guide


202 PUBLIC ERP Edition for Utilities Contact Center
Utilities Installment Plan

Business Add-In: Utilities Installment Plan Badi

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesInstallment- UtilitiesExtensibility http:// UtilitiesInstallment- UtilitiesInstallment-


Plan sap.com/xi/AP/CRM/ PlanBadiInput PlanBadiInput
Global

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:

• Simulate Installment Plan-1 (Action code)


• Create Installment Plan - 2 (Action code)
• Change Installment Plan - 3 (Action code)
• Cancel Installment Plan - 4 (Action code)

The flag ExecuteServiceIndicator has been introduced in the input parameter


UtilitiesInstallmentPlanBadiInput. This flag has the following components:

• 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 of Utilities Create Billing

Business Add-In: Enhancement of Utilities Create Billing

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesCreateBilling UtilitiesExtensibility http:// UtilitiesFinancialOver- UtilitiesFinancialCrea-


sap.com/xi/AP/CRM/ view teBillingBADIResult
Global

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 203
Create Bill Actions

Business Add-In: Create Bill Actions

Enhancement Imple-
mentation Business Object Namespace Input Parameters Output Parameters

UtilitiesCreateBillin- UtilitiesExtensibility http:// UtilitiesFinancialCrea- UtilitiesFinancialCrea-


gActions sap.com/xi/AP/CRM/ teBillingBADIResult teBillingActionsBADIR-
Global esult

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:

• Invoice Now - 03 (Action code)


• Bill Now - 02 (Action code)
• Submit Meter Reading - 01 (Action code)
• Invoice Simulation - 04 (Action code)
• Bill and Invoice -05 (Action Code)
• Invoice Now Mr – 06 (Action Code)

The flag ExecuteServiceIndicator has been introduced in the output parameter


UtilitiesFinancialCreateBillingActionsBADIResult. This flag has the following components for all above 6 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.

Utilities Budget Billing Overview

Business Add-In: Budget Billing Overview

Enhancement Imple-
mentation Business Object Namespace Input Parameters Output Parameters

UtilitiesBudgetBillin- UtilitiesExtensibility http:// UtilitiesBudgetBilling- UtilitiesBudBillBadiRe-


gOverview sap.com/xi/AP/CRM/ FetchBAdIInput sult
Global

Utilities Contact Center Administrator Guide


204 PUBLIC ERP Edition for Utilities Contact Center
Utilities Budget Billing Actions

Business Add-In: Utilities Budget Billing Actions (Simulate,Create,Edit,Deactivate)

Enhancement Imple-
mentation Business Object Namespace Input Parameters Output Parameters

UtilitiesBudgetBillin- UtilitiesExtensibility http:// UtilitiesBudgetBillin- UtilitiesBudgetBillin-


gActions sap.com/xi/AP/CRM/ gActionBadiInput gActionBadiResult
Global

The following components are introduced in ‘UtillitiesBudgetBillingCurrentAction’ parameter of Input


Parameter UtilitiesBudgetBillingActionBadiInput, to give details about Custom Action.

• CustomAction : flag
• ActionName : Text field

Utilities Financial Actions

Business Add-In: UtilitiesFinancialActionsBADI

Enhancement Imple-
mentation Business Object Namespace Input Parameters Output Parameters

UtilitiesFinancialAc- UtilitiesExtensibility http:// UtilitiesFinancialAc- UtilitiesFinancialAc-


tionsBADI sap.com/xi/AP/CRM/ tionsBADiInput tionsBadiResult
Global

Structure UtilitiesInvoices have been introduced in the input parameter UtilitiesFinancialActionsBADiInput and
output parameter UtilitiesFinancialActionsBadiResult.

The following components are introduced in ‘CurrentAction’ parameter of Input Parameter


UtilitiesFinancialActionsBADiInput, to give details about Custom Action.

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

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 205
1.3.1.3 Premise

List of business add-ins for the functionality under Premise work center view.

UtilitiesPremise

Business Add-In: UtilitiesPremise

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesPremise UtilitiesExtensibility http:// UtilitiesPremiseFetch- UtilitiesPremiseBadiR-


sap.com/xi/AP/CRM/ BAdIInput esult
Global

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:

• Customer History (UtilitiesPremiseCustomerHistory)


• Highlights (UtilitiesPremiseHighlights)
• Object Hierarchy (UtilitiesPremiseObjectHierarchy)
• Installation (UtilitiesPremiseObjectHierarchyInstallationDetails)
• Meter Reading (UtilitiesPremiseObjectHierarchyMeterReadingDetails)

 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:

Type Code Object

1 Installation / Point of Delivery

2 Device

Utilities Contact Center Administrator Guide


206 PUBLIC ERP Edition for Utilities Contact Center
UtilitiesPremiseCancelMoveInMoveOut

Business Add-In: . UtilitiesPremiseCancelMoveInMoveOut

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesPremiseCan- UtilitiesExtensibility http:// UtilitiesPremiseBadiIn- UtilitiesPremiseBadiR-


celMoveInMoveOut sap.com/xi/AP/CRM/ put esult
Global

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

Business Add-In: UtilitiesPremiseEditMoveInMoveOut

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesPremiseEdit- UtilitiesExtensibility http:// UtilitiesPremiseBadiIn- UtilitiesPremiseBadiR-


MoveInMoveOut sap.com/xi/AP/CRM/ put esult
Global

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 207
UtilitiesPremiseMoveIn

Business Add-In: UtilitiesPremiseMoveIn

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesPremiseMoveIn UtilitiesExtensibility http:// UtilitiesPremiseBadiIn- UtilitiesPremiseBadiR-


sap.com/xi/AP/CRM/ put esult
Global

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

Business Add-In: UtilitiesPremiseMoveOut

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesPremiseMove- UtilitiesExtensibility http:// UtilitiesPremiseBadiIn- UtilitiesPremiseBadiR-


Out sap.com/xi/AP/CRM/ put esult
Global

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

UtilitiesInstallation UtilitiesExtensibility http:// UtilitiesInstallation- UtilitiesInstallationBa-


sap.com/xi/AP/CRM/ FetchBAdIInput diResult
Global

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)

Utilities Contact Center Administrator Guide


208 PUBLIC ERP Edition for Utilities Contact Center
The structure UtilitiesInstallationDeviceNotesDetails has been introduced in the UtilitiesInstallationBadiResult
parameter of input and output parameter.

UtilitiesInstallationEstimateMeterReading

Business Add-In: UtilitiesInstallationEstimateMeterReading

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesInstallationEsti- UtilitiesExtensibility http:// UtilitiesInstallationBa- UtilitiesInstallationBa-


mateMeterReading sap.com/xi/AP/CRM/ diInput diResult
Global

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

Business Add-In: UtilitiesInstallationOverrideMeterReading

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesInstallationO- UtilitiesExtensibility http:// UtilitiesInstallationBa- UtilitiesInstallationBa-


verrideMeterReading sap.com/xi/AP/CRM/ diInput diResult
Global

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 209
UtilitiesInstallationUpdateMeterReading

Business Add-In: UtilitiesInstallationUpdateMeterReading

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesInstallationUp- UtilitiesExtensibility http:// UtilitiesInstallationBa- UtilitiesInstallationBa-


dateMeterReading sap.com/xi/AP/CRM/ diInput diResult
Global

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

Business Add-In: UtilitiesPremiseActions

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesPremiseAc- UtilitiesExtensibility http:// UtilitiesPremiseBadiIn- UtilitiesPremiseBadiR-


tions sap.com/xi/AP/CRM/ put esult
Global

UtilitiesPremiseDetails

Business Add-In: UtilitiesPremiseDetails

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesPremiseDetails UtilitiesExtensibility http:// UtilitiesPremiseDe- UtilitiesPremiseDe-


sap.com/xi/AP/CRM/ tailsFetchBADIInput tailsBadiResult
Global

Utilities Contact Center Administrator Guide


210 PUBLIC ERP Edition for Utilities Contact Center
UtilitiesDisconnectionDocuments

Business Add-In: UtilitiesDisconnectionDocuments

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesDisconnection- UtilitiesExtensibility http:// UtilitiesDisconnection- UtilitiesDisconnection-


DocumentsActions sap.com/xi/AP/CRM/ DocumentsBadiActio- DocumentsActionBa-
Global nInput diResult

1.3.1.4 Contracts

Overview of Business Add-Ins that exist for the Utilities Contracts work center view functionality.

Overview Fetch and Refresh (Deprecated)

Business Add-In: Overview Fetch and Refresh

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesOverviewEn- UtilitiesExtensibility http:// UtilitiesOverviewBA- UtilitiesOverviewBa-


hancement sap.com/xi/AP/CRM/ dIInput diResult
Global

• Results - Following tables are retreived:


• Contract Account - UtilitiesContractAccountTable
• Contracts - UtilitiesContractsTable
• Meter Reading - UtilitiesContractMeterReadsTable
• Division/Service Order Table in Move-In - UtilitiesContractServiceOrderIn
• Division/Service Order Table in Move-Out - UtilitiesContractsServiceOrderOut

Contract Account Create

Business Add-In: Contract Account Create

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesContractAc- UtilitiesExtensibility http:// UtilitiesCreateContrac- UtilitiesCreateContrac-


sap.com/xi/AP/CRM/ tAccountBaDIInput tAccountBaDIInput
counts
Global

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 211
 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.

Contract Account Change

Business Add-In: Contract Account Change

Enhancement Implementation Input Parameter Output Parameter

UtilitiesCreateContractAccount • UtilitiesCreateContractAccountBa- • UtilitiesCreateContractAccountBa-


DIInput DIInput
• ACTION_CODE = 02 • ACTION_CODE = 01
• UTILITIES_MESSAGE_TAB (For
success/error message)

 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

Business Add-In: Move-In

Enhancement Imple-
mentation Business Object Namespace Input Parameters Output Parameters

UtilitiesContractsMo- UtilitiesExtensibility http:// UtilitiesMoveInBadiIn- UtilitiesOverviewBa-


sap.com/xi/AP/CRM/ put diResult
veIn
Global

Utilities Contact Center Administrator Guide


212 PUBLIC ERP Edition for Utilities Contact Center
Move-Out

Business Add-In: Move-Out

Enhancement Imple-
mentation Business Object Namespace Input Parameters Output Parameters

UtilitiesContractsMo- UtilitiesExtensibility http:// UtilitiesMoveInBadiIn- UtilitiesOverviewBa-


sap.com/xi/AP/CRM/ put diResult
veOut
Global

Transfer

Business Add-In: Transfer

Enhancement Imple-
mentation Business Object Input Parameters Output Parameters

UtilitiesContract- UtilitiesExtensibility http:// UtilitiesMoveInBadiIn- UtilitiesOverviewBa-


sap.com/xi/AP/CRM/ put diResult
sTransfer
Global

Estimate

Business Add-In: Estimate

Enhancement Imple-
mentation Business Object Namespace Input Parameters Output Parameters

UtilitiesContractsMe- UtilitiesExtensibility http:// UtilitiesMeterReadBa- UtilitiesMeterReadBa-


terReadingEstimate sap.com/xi/AP/CRM/ diInput diInput
Global

Edit Move-In

Business Add-In: Edit Move-In

Enhancement Imple-
mentation Business Object Namespace Input Parameters Output Parameters

UtilitiesContractsEdit- UtilitiesExtensibility http:// UtilitiesMoveInBadiIn- UtilitiesOverviewBa-


sap.com/xi/AP/CRM/ put diResult
MoveIn
Global

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 213
Edit Move-Out

Business Add-In: Edit Move-Out

Enhancement Imple-
mentation Business Object Namespace Input Parameters Output Parameters

UtilitiesContractsEdit- UtilitiesExtensibility http:// UtilitiesMoveInBadiIn- UtilitiesOverviewBa-


sap.com/xi/AP/CRM/ put diResult
MoveOut
Global

Cancel Move-In

Business Add-In: Cancel Move-In

Enhancement Imple-
mentation Business Object Namespace Input Parameters Output Parameters

UtilitiesContractsCan- UtilitiesExtensibility http:// UtilitiesMoveInBadiIn- UtilitiesOverviewBa-


sap.com/xi/AP/CRM/ put diResult
celMoveIn/CancelMo-
Global
veOut

Cancel Move-Out

Business Add-In: Cancel Move-Out

Enhancement Imple-
mentation Business Object Namespace Input Parameters Output Parameters

UtilitiesContractsCan- UtilitiesExtensibility http:// UtilitiesMoveInBadiIn- UtilitiesOverviewBa-


sap.com/xi/AP/CRM/ put diResult
celMoveOut
Global

Create Meter Reading

Business Add-In: Create Meter Reading

Enhancement Imple-
mentation Business Object Namespace Input Parameters Output Parameters

UtilitiesContractsMe- UtilitiesExtensibility http:// UtilitiesMoveInBadiIn- UtilitiesOverviewBa-


sap.com/xi/AP/CRM/ put diResult
terReading
Global

Utilities Contact Center Administrator Guide


214 PUBLIC ERP Edition for Utilities Contact Center
Edit Meter Reading

Business Add-In: Edit Meter Reading

Enhancement Imple-
mentation Business Object Namespace Input Parameters Output Parameters

UtilitiesContractsMe- UtilitiesExtensibility http:// UtilitiesMoveInBadiIn- UtilitiesOverviewBa-


sap.com/xi/AP/CRM/ put diResult
terReading
Global

Override

Business Add-In: Override

Enhancement Imple-
mentation Business Object Namespace Input Parameters Output Parameters

UtilitiesContractsMe- UtilitiesExtensibility http:// UtilitiesMoveInBadiIn- UtilitiesOverviewBa-


sap.com/xi/AP/CRM/ put diResult
terReading
Global

Fetch Meter Reading Data

Business Add-In: Fetch Meter Reading Data

Enhancement Imple-
mentation Business Object Namespace Input Parameters Output Parameters

UtilitiesFetchMRData UtilitiesExtensibility http:// UtilitiesMoveInBadiIn- UtilitiesOverviewBa-


sap.com/xi/AP/CRM/ put diResult
Global

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 215
1.3.1.5 Collections

Overview of Business Add-Ins that exist for the Utilities Collections work center view functionality.

Utilities Collection Customer Overview

Business Add-In: UtilitiesCollectionCustomerOverview

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesCollectionCus- UtilitiesExtensibility http:// UtilitiesCustomerOver- UtilitiesCustomerOver-


tomerOverview sap.com/xi/AP/CRM/ viewBADIInput viewBADIInput
Global

UtilitiesDunningHistory

Business Add-In: UtilitiesDunningHistory

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesDunningHis- UtilitiesExtensibility http:// UtilitiesServiceDun- UtilitiesServiceDun-


tory sap.com/xi/AP/CRM/ ningHistoryBadiInput ningHistoryBadiInput
Global

UtilitiesAccountHistory

Business Add-In: UtilitiesAccountHistory

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesAccountHistory UtilitiesExtensibility http:// UtilitiesAccountHistor- UtilitiesAccountHistor-


sap.com/xi/AP/CRM/ yBADIInput yBADIInput
Global

Utilities Contact Center Administrator Guide


216 PUBLIC ERP Edition for Utilities Contact Center
UtilitiesCorrespondenceHistory

Business Add-In: UtilitiesCorrespondenceHistory

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesCorresponden- UtilitiesExtensibility http:// UtilitiesServiceCorres- UtilitiesServiceCorres-


ceHistory sap.com/xi/AP/CRM/ pondenceHistoryBa- pondenceHistoryBa-
Global diInput diInput

UtilitiesCorrespondenceHistoryActions

Business Add-In:UtilitiesCorrespondenceHistoryActions

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesCorresponden- UtilitiesExtensibility http:// UtilitiesServiceCorres- UtilitiesServiceCorres-


ceHistory sap.com/xi/AP/CRM/ pondenceHistoryBa- pondenceHistoryAc-
Global diActionInput tionBadiResult

UtilitiesWriteOffs

Business Add-In: UtilitiesWriteOffs

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesWriteOffs UtilitiesExtensibility http:// UtilitiesWriteOffsBA- UtilitiesWriteOffsBA-


sap.com/xi/AP/CRM/ DIIn DIIn
Global

UtilitiesSecurityDepositActions

Business Add-In: UtilitiesSecurityDepositActions

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesSecurityDepo- UtilitiesExtensibility http:// UtilitiesSecurityDepo- UtilitiesSecurityDe-


sitActions sap.com/xi/AP/CRM/ sitActionsBADIInput positActionBADIRes-
Global ponse

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 217
UtilitiesSecurityDeposit

Business Add-In: UtilitiesSecurityDeposit

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesSecurityDepo- UtilitiesExtensibility http:// SecurityDepositBADIIn SecurityDepositBADIIn


sit sap.com/xi/AP/CRM/
Global

UtilitiesReturns

Business Add-In: UtilitiesSecurityDeposit

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesSecurityDepo- UtilitiesExtensibility http:// UtilitiesReturnsBA- UtilitiesReturnsBA-


sit sap.com/xi/AP/CRM/ DIInput DIInput
Global

UtilitiesCreditWorthiness

Business Add-In: UtilitiesCreditWorthiness

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesCreditWorthi- UtilitiesExtensibility http:// UtilitiesCreditWorthi- UtilitiesCreditWorthi-


ness sap.com/xi/AP/CRM/ nessBADIInput nessBADIInput
Global

Utilities Contact Center Administrator Guide


218 PUBLIC ERP Edition for Utilities Contact Center
1.3.1.6 Service Orders

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.

Overview Fetch and Refresh

Business Add-In: Overview Fetch and Refresh

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesServiceOrderO- UtilitiesExtensibility http:// UtilitiesOverviewBA- UtilitiesServiceOrder-


sap.com/xi/AP/CRM/ dIInput BadiInput
verview
Global

Utilities Service Order Create

Business Add-In: Utilities Service Order Create

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesServiceOrders UtilitiesExtensibility http:// UtilitiesServiceOrder- UtilitiesServiceOrder-


sap.com/xi/AP/CRM/ BadiInput BadiInput
Global

 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

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 219
Utilities Service Order Change

Business Add-In: Utilities Service Order Change

Enhancement Implementation Input Parameter Output Parameter

BADI_UTIL_SERVICE_ORDER • UtilitiesServiceOrderBadiInput • UtilitiesServiceOrderBadiInput


• ACTION_CODE = 02 • ACTION_CODE = 02
• UTILITIES_MESSAGE_TAB (For
success/error message)

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

1.3.1.7 Utilities 360

Business add-ins for functionality available under Utilities 360 work center view.

Utilities 360 Object Hierarchy

Business Add-In: Utilities 360 Facet Object Hierarchy

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

Utilities360facetOb- UtilitiesExtensibility http:// Utilities360ViewRoo- Utilities360ObjectHier-


jectHierarchy sap.com/xi/AP/CRM/ tElements archyBadiResult
Global

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:

• Utillities360FacetRoot - Utilities 360 Root – More Indicator


• Utillities360FacetObjectHierarchyCCADetails - Collective Contract Account Details
• Utillities360FacetObjectHierarchyCADetails - Contract Account Details
• Utillities360FacetObjectHierarchyPremiseDetails - Premise Details
• Utillities360FacetObjectHierarchyContractDetails - Contract Details
• Utillities360FacetObjectHierarchyInstallationDetails - Installation Details
• Utillities360FacetObjectHierarchyDeviceDetails - Device Details
• Utillities360HighlightsAlerts - Alerts – [Deprecated]
• Utilities360Highlights - Highlights - [Deprecated]

Utilities Contact Center Administrator Guide


220 PUBLIC ERP Edition for Utilities Contact Center
• Utilities360Highlight - Highlights

Utilities 360 Facet Object Hierarchy Overview

Business Add-In: Utilities 360 Facet Object Hierarchy

Enhancement
Implementa- Business Ob- Input Parame- Output Param-
tion ject Namespace Interface Method ter eter

Utilities360fac- UtilitiesExtensi- http:// IF_BADI_UTIL_ EXE- Utilities360Ob- Utilities360Ob-


etObjectHier- bility sap.com/xi/AP/ jHierBAdIInput jectHierarchy-
360_OBJ_HI- CUTE_360_OB-
archyOverview CRM/Global BadiResult
ERARCHY JECT_HIERAR-
CHY

UtilitiesCustomerHistory

Business Add-In: BadiUtilitiesCustomerHistory

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesCustomerHis- UtilitiesExtensibility http:// UtilitiesOverviewBA- UtilitiesOverviewBa-


tory sap.com/xi/AP/CRM/ dIInput diResult2
Global

Following are the table details from output structure:

• UTIL_CONTRACTS_TAB - For Contracts Table


• UTIL_PAYMENTS_TAB - For Payments Table
• UTIL_INVOICES_TAB - For Invoice table
• UTIL_SRV_ORDS_TAB - For Service Order Table

Utilities 360 Recent History - Get Utilities Business Contact

Business Add-In: UtilitiesBusinessContactGet

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesBusinessCon- UtilitiesExtensibility http:// UtilitiesBusinessCon- UtilitiesBusinessCon-


tactGet sap.com/xi/AP/CRM/ tactFetchBadIInput tactBadiResult
Global

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 221
Utilities Locks

Business Add-In: Utilities Locks

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesOverviewLocks UtilitiesExtensibility http:// UtilitiesLocksBadiRe- UtilitiesLocksBadiRe-


sap.com/xi/AP/CRM/ sult sult
Global

Utilities Object Hierarchy

Business Add-In: Utilities Object Hierarchy

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

Utilities360ObjectHier- UtilitiesExtensibility http:// Utilities360ObjectHier- Utilities360ViewAc-


archyAction sap.com/xi/AP/CRM/ archyActionBadiInput tionBadiResult
Global

 Restriction

Note the following limitation for Utilities 360 list view.

• The list view displays the data for contract account, premise, contracts, and devices. The field
extensibility is not supported, as it is not possible to identify for which category an extension field
belongs to. If implemented also, the extension fields are mapped to a wrong association.

1.3.1.8 Alerts

Overview of business add-in that exists for alerts.

Alerts - Get Utilities Alerts

Business Add-In: Alerts - Utilities Alerts Get

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesAlertsGet UtilitiesExtensibility http:// UtilitiesAlertsFetchBa- UtilitiesAlertsBadiRe-


sap.com/xi/AP/CRM/ dIInput sult
Global

Utilities Contact Center Administrator Guide


222 PUBLIC ERP Edition for Utilities Contact Center
Alerts - Prefilling extension fields to the selection parameter

Business Add-In: Alerts - UtilitiesAlertsPreGet

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesAlertsPreGet UtilitiesExtensibility http:// UtilitiesAlertsFetchBa- UtilitiesAlertsBadiRe-


sap.com/xi/AP/CRM/ dIInput sult
Global

1.3.1.9 Exception Management

Overview of business add-in that exists for exeption management.

Exception Management - Get Utilities BPEM

Business Add-In: Exception Management - Utilities BPEM Get

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesBPEMGet UtilitiesExtensibility http:// UtilitiesBPEMFetchBa- UtilitiesBPEMBadiRe-


sap.com/xi/AP/CRM/ dIInput sult
Global

UtilitiesBPEMActions

Business Add-In:UtilitiesBPEMActions

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesBPEMActions UtilitiesExtensibility http:// UtilitiesBPEMBadiAc- UtilitiesBPEMAction-


sap.com/xi/AP/CRM/ tionInput BadiResult
Global

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 223
1.3.1.10 Payment Data

Overview of business add-ins that exist for payment data.

Utilities Payment Data Overview

Business Add-In: UtilitiesPaymentDataOverview

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesPaymentDa- UtilitiesExtensibility http:// UtilitiesPaymentData- UtilitiesPaymentData-


sap.com/xi/AP/CRM/ FetchBAdIInput BAdIResult
taOverview
Global

Utilities Payment Data Actions

Business Add-In: UtilitiesPaymentDataActions

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesPaymentDa- UtilitiesExtensibility http:// UtilitiesPaymentDa- UtilitiesPaymentDa-


sap.com/xi/AP/CRM/ taActionBAdIInput taActionBAdIResult
taActions
Global

1.3.1.11 Rate Category

Overview of business add-in that exists for rate category.

Utilities Contracts Installation Facts Modify

Business Add-In: UtilitiesContractsInstallationFactsModify

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesContractsIn- UtilitiesExtensibility http:// UtilitiesRateCategory- UtilitiesRateCategory-


sap.com/xi/AP/CRM/ ChangeBADIInput ChangeBADIOutput
stallationFactsModify
Global

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

Utilities Contact Center Administrator Guide


224 PUBLIC ERP Edition for Utilities Contact Center
1.3.1.12 Service Notification

Overview of business add-ins that exist for service notification.

Utilities Service Notification Overview

Business Add-In: UtilitiesServiceNotificationOverview

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesServiceNotifi- UtilitiesExtensibility http:// UtilitiesServiceNotifi- UtilitiesServiceNotifi-


sap.com/xi/AP/CRM/ caionFetchBAdIInput cationBadiResult
cationOverview
Global

Utilities Service Notification Actions

Business Add-In: UtilitiesServiceNotificationActions

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesServiceNotifi- UtilitiesExtensibility http:// UtilitiesServiceNotifi- UtilitiesServiceNotifi-


sap.com/xi/AP/CRM/ caionModifyBAdIInput cationBadiResult
cationActions
Global

1.3.1.13 Rate Change

Overview of business add-in that exists for rate change.

Utilities Contract Installation Facts

Business Add-In: UtilitiesContractInstallationFacts

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesContractInstal- UtilitiesExtensibility http:// UtilitiesInstallation- UtilitiesInstallation-


sap.com/xi/AP/CRM/ FactsBADIInput FactsBadiResult
lationFacts
Global

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

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 225
1.3.1.14 Switch Document for Enrollment Process

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.

Business Add-In: Logical Port for Notification Service

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.

1.3.1.15 Enrollment Product Proposal

Business add-in exit for extending implementation for product proposal in the enrollment process.

Product Proposal for Enrollment Process

Business Add-In: Product Proposal for Enrollment Process

Enhancement Implementation Input Parameter Output Parameter

BADI_UTILITIES_PROD_PROPOSAL BADI_UTILITIES_PROD_PROPOSAL_C BADI_UTILITIES_PROD_PROPOSAL_C

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.

1.3.1.16 Customer Search

Business Add-In for the customer search feature.

Customer Search

Use the Customer Search add-in to extend the customer search feature.

Utilities Contact Center Administrator Guide


226 PUBLIC ERP Edition for Utilities Contact Center
Business Add-In - Customer Search

Enhancement Implementation Business Object Namespace

UtilitiesAccountSearch UtilitiesAccountSearch http://sap.com/xi/AP/CRM/Global

1.3.1.17 Move Processes(GAF)

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.

Follow the below steps for the mapping process:

1. Add custom fields in SAP 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 SAP Cloud for Customer custom field in
the field-name and corresponding value in field-value.

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

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 227
1.3.1.18 Utilities Addresses

Overview of business add-in that exists for Utilities Addresses.

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

Utilities Addresses - Display

Business Add-In: Utilities Addresses - UtilitiesCustomerAddressGet

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesCustomerAd- UtilitiesExtensibility http:// UtilitiesAddressFetch- UtilitiesAddressGetBa-


sap.com/xi/AP/CRM/ BadIInput diResult
dressGet
Global

Utilities Addresses - Actions

Business Add-In: Utilities Addresses - UtilitiesCustomerAddressActions

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesCustomerAd- UtilitiesExtensibility http:// UtilitiesAddressAction- UTILITIES_AD-


sap.com/xi/AP/CRM/ BadiInput DRESS_ACTN_RE-
dressActions
Global SULT

1.3.2 UI Extensions for Utilities Online Transactions

Use the step-by-step guide to create project-specific 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.

Utilities Contact Center Administrator Guide


228 PUBLIC ERP Edition for Utilities Contact Center
 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, Write-Offs, and Security Deposit in different screens, the inport FromContractAccount to be used.

Prerequisites

You are using the SAP Cloud Applications Studio(PDI) version that corresponds to the SAP Cloud for Customer
release version.

1.3.2.1 Step 1 - Create a PDI Solution

Create a new PDI solution, maintain the mandatory fields and save the new solution.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 229
For the new solution, select solution type as Customer Specific Solution as shown in the graphic

below:

1.3.2.2 Step 2 - Add Item under Solution Explorer

Add a new item under the Solution Explorer.

Utilities Contact Center Administrator Guide


230 PUBLIC ERP Edition for Utilities Contact Center
1.3.2.3 Step 3 - Specify Name of Extension Object in
Business Object Extension

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)

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 231
1.3.2.4 Step 4 - Add Extension Fields to the Newly Added
Extension Business Object
In the previous step (step 3), you have added the extension business object into your solution. This will now
appear under the solution explorer with .xbo extension. Double click on this file extension to open the editor
where you can add the new extension fields under the desired node.

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.

1.3.2.5 Step 5 - Add Same Extension Fields to UI Screens


In the previous step (step 4), you have added extension fields to the extension business object in the backend
system. In this step, you will need to add the same extension fields to UI screens.

To add the extension fields to UI screen, right click on the .xbo file extension and choose Enhance Screen (see
screenshot below) .

Utilities Contact Center Administrator Guide


232 PUBLIC ERP Edition for Utilities Contact Center
This (Enhance Screen option) will show the list of floor plans where you can add the new extension field. You
can select the appropriate floor plan where you need to define extension fields.

1.3.2.6 Step 6 - Select Section Group in UI Screen Where


You Want to Add Extension Fields

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 233
4. Activate the floor plan. With this you can see the new extension field added to the section group.

Open the UI screen to see the new extension field (as seen in the screenshot below).

Utilities Contact Center Administrator Guide


234 PUBLIC ERP Edition for Utilities Contact Center
1.3.2.7 Step 7 - Create Service Interface to ERP using Web
Service

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

1.3.2.8 Step 8 - Create a Communication Scenario to


Integrate Web Service with ERP System

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

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 235
1.3.2.9 Step 9 - Select Valid BAdI Implementation in
Solution Explorer

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.

Utilities Contact Center Administrator Guide


236 PUBLIC ERP Edition for Utilities Contact Center
1.3.3 (Optional) Extend Your Solution

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.

The implementation-friendly extensibility concept can be summarized as follows:

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

2. Select the business object to extend.

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.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 237
2. Add the extension field to the UI designer screen.
1. Select the UI as COD_UTILITIES_FINANCIAL_OVERVIEW_EXTENSIBILITY_EC.
2. Enter the extended UI path as /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/
COD_UTILITIES_FINANCIAL_OVERVIEW_EXTENSIBILITY_EC.EC.uicomponent.

3. Implement the UtilititesFinancialAccountOverviewenhancement.


1. Add the enhancement implementation.

Utilities Contact Center Administrator Guide


238 PUBLIC ERP Edition for Utilities Contact Center
2. Enter the details.

3. Implement the logic in the ABSL script.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 239
The code snippet is as follows:

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.

Utilities Contact Center Administrator Guide


240 PUBLIC ERP Edition for Utilities Contact Center
2. Activate the implementation by clicking the implementing class that has all the methods that need
logic to be added for changing the standard behavior.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 241
A sample code snippet for ERP implementation method in Account_overview_post is as
follows:

The data sent from ERP is passed to the extension field from PDI, and displayed in SAP Cloud for
Customer:

2. Implement the enhancement for Actions.


1. Add the extension field in the node for onetime payment.

Utilities Contact Center Administrator Guide


242 PUBLIC ERP Edition for Utilities Contact Center
2. Extend the field to the UI by selecting the UI
as COD_UTILITIES_FINANCIAL_OVERVIEW_EXTENSIBILITY_EC, and the
extended UI path as /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/
COD_UTILITIES_FINANCIAL_OVERVIEW_EXTENSIBILITY_EC.EC.uicomponent

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

1.3.4 Utilities Web Services for Extensibility

For details on web services and corresponding UI to be extended, see SAP Cloud for Customer .

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 243
1.3.5 Custom Action

You can now create Custom Actions for the following options:

• Utilities Exceptions(Both in Premise and Customer screens)


• Utilities Financials
• Payments
• Open items
• Invoices
• Payment Plan
• Utilities Collections
• Dunning History
• Correspondences
• Utilities 360
• Object Hierarchy (Corresponding BADI for custom actions is Utilities360ObjectHierarchyAction)
• Utilities Service Orders
• Utilities Service Notifications

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)

Utilities Contact Center Administrator Guide


244 PUBLIC ERP Edition for Utilities Contact Center
2. Create script file for the custom action by right clicking on the xbo
Click on the Create check box (Within the corresponding node for the newly created custom action) and
Click on OK.

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 245
This will result in the creation of an absl file as shown below:

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.

Utilities Contact Center Administrator Guide


246 PUBLIC ERP Edition for Utilities Contact Center
1.4 Troubleshooting

References for troubleshooting issues with integration setup.

For detailed information on troubleshooting in PI system, see http://wiki.scn.sap.com/wiki/display/TechTSG/


%28PI%29+7.3.1+Troubleshooting+Guide

Utilities Contact Center Administrator Guide


ERP Edition for Utilities Contact Center PUBLIC 247
2 S/4HANA Edition for Utilities Contact
Center

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:

Minimum Software Requirements


SAP Cloud for Customer
S/4HANA Edition Software
SAP Cloud for Customer Components S/4HANA PI Content Add-On

2205 SAP Cloud for Customer IS- S4H OP 2020 FPS2 PI 7.31
Utilities
 Note
Ensure that you have
downloaded the latest
service packs listed here:

• XI CONTENT
SAP_BYD 2.40
(SP42 Patch 00)
(Interface Defini-
tions for SAP Cloud
for Customer for
Utilities Contact
Center)
• XI CONTENT: IS-
UT 806 (SP02)
(S/4HANA Interface
Definitions)
• XI CONTENT:
C4CS4_IC 100
(SP24 Patch
00) (Mapping, Tem-
plates, and Scenar-
ios)

Utilities Contact Center Administrator Guide


248 PUBLIC S/4HANA Edition for Utilities Contact Center
2.1 Configuration and System Setup

The topics below provide a detailed overview of the configuration required to setup the utilities contact center.

Scope and Configure SAP Cloud for Customer [page 249]


Administrators can configure the utilities contact center using scoping, scoping questions, and fine-
tuning activities.

Configure Middleware [page 270]


Learn about the configuration of middleware.

Configure Integration with S/4HANA [page 285]


An overview of how to configure integration with S/4HANA system.

Related Information

Assign Work Centers to Business Users [page 18]


Work center assignment to business users based on their roles.

2.1.1 Scope and Configure SAP Cloud for Customer

Administrators can configure the utilities contact center using scoping, scoping questions, and fine-tuning
activities.

Scoping [page 250]


To set up your SAP Cloud for Customer system to support Utilities Contact Center solution, scope your
implementation project accordingly.

Replicate Utilities Master Data [page 261]


You can execute reports to transfer data from IS-Utilities system to the Utilities Contact Center cloud
solution.

Assign Work Centers to Business Users [page 261]


Work center assignment to business users based on their roles.

Configure the Alerts Tab [page 262]


As an administrator, use adaptation to add the Alerts tab.

Configure Scripts for Move Processes [page 263]


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.

Configure Utilities 360 [page 264]


As an administrator, you can configure the views for Recent History and Hierarchy sections under
Utilities 360 screen of a customer.

Configure Safety Message for Reconnect [page 266]


As an administrator, you can configure a safety message to reconnect the AMI smart meter.

Assign Front Office Processes [page 266]

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 249
Assign the front office processes that you need to launch from SAP Cloud for Customer in the
Implementation Guide customizing.

Configure Smart Energy Water [page 268]


To integrate the Smart Energy Water (SEW) with SAP S/4 HANA system, the Communication
Preferences and Consumption Graph, Outage Map, and Compare must be configured.

Configure Message Severity for Move Processes [page 269]


As an Administrator, configure the severity of the messages received during the move process. You can
also suppress the message if you do not want them to display.

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.

2.1.1.1.1 Prerequisites for Configuring Utilities Contact


Center

This section lists the prerequisites to configure the Utilities Contact Center.

Integration Setup for 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.

IS-Utilities Configuration in S/4HANA System

The required configuration must have been set up in IS-Utilities in the S/4HANA system.

Utilities Contact Center Administrator Guide


250 PUBLIC S/4HANA Edition for Utilities Contact Center
2.1.1.1.2 Enable the Utilities Industry Solution

To begin scoping and to scope the solution, go to Business Configuration Implementation Projects .
Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities 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 .

2.1.1.1.3 Configure Utilities Lean Quotation


As an administrator, configure the utilities lean quotation.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Quotation, select the scoping question Do you want to enable utilities lean quotation and replicate point
of delivery from your external application to your cloud solution?

If you’ve scoped this question, you must also scope the following questions:

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Question step navigate to:

• Sales New Business Sales Quotes , select all the scoping questions.
• Sales New Business Communication for New Business and under Sales Order Forms, select the
scoping question You can use a template to send sales quotes to your customers.
• Communication and Information Exchange Integration into Sales, Service and Marketing Processes ,
select the corresponding scoping questions:
• 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?
• Configure PoD replication (see documentation under Technical Objects Replication).

2.1.1.1.4 Configure Internal Pricing for Utilities Lean


Quotation
As an administrator, configure internal pricing for utilities lean quotation.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 251
In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and
under Utilities Quotation, select the scoping question Do you want to enable Internal Pricing for Utilities Lean
Quotation?

2.1.1.1.5 Configure the Replication of Point of Delivery

As an administrator, configure the replication of Point of Delivery (PoD).

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Technical Master Data Replication, select the scoping question Do you want to replicate point of delivery data
from your external application to your cloud solution?

2.1.1.1.6 Configure to use Premise External ID as the


Internal ID in SAP Cloud for Customer

As an administrator, configure to use premise external ID as internal ID in cloud solution.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Technical Master Data Replication, select the scoping question Do you want to use Premise External ID as the
Internal ID in C4C?

2.1.1.1.7 Configure Master Data Template to Customize


Rate Change

As an administrator, you can configure the use of master data template to customize rate change in the
solution.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Master Data Template, select the scoping question Do you want to use Master Data Template for Rate Change?

Utilities Contact Center Administrator Guide


252 PUBLIC S/4HANA Edition for Utilities Contact Center
2.1.1.1.8 Configure Master Data Template for Guided Move-
In and Guided Transfer

As an administrator, you can configure the use of master data template for guided move-in and guided transfer.

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.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Master Data Template, select the scoping question Do you want to use Master Data Template for Guided
Move-In and Guided Transfer?

2.1.1.1.9 Configure Different Master Data Templates for


Move Processes

You can configure separate master data templates for move processes and installations.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Master Data Template, select the scoping question Do you want to use a different master data template for each
installation within guided move-in/guided transfer?

2.1.1.1.10 Configure the Creation of BPEM Clarification Case

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 Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and
under Utilities Exception Management, select the scoping question Do you want to enable creation of BPEM
Clarification Case?

2.1.1.1.11 Configure Integration of SAP Cloud for Customer


with S/4 HANA

As an administrator, you can implement the SAP S/4HANA edition for utilities solution in SAP Cloud for
Customer.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 253
In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
S/4HANA Integration, select the scoping question Do you want to integrate your cloud solution with SAP S/
4HANA?

2.1.1.1.12 Configure Security Deposit at Contract Level

As an administrator, configure Security Deposit at contract level.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Security Deposit, select the scoping question Do you want to enable Security Deposit at contract level?

2.1.1.1.13 Configure Alerts in Move Processes

As an administrator, configure alerts in move processes and enable the display of alerts in the expanded mode
or collapsed mode. .

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Alerts, select the corresponding scoping questions:

• Do you want to enable Alerts in Move Processes?


• Do you want expanded Alerts in Move Processes?

2.1.1.1.14 Configure to Use Order Codes to Generate Service


Orders

As an administrator, configure to use order codes to generate service orders.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and
under Utilities Service Order/Notifications, select the scoping question Do you want to use the order code for
generating service orders?

Utilities Contact Center Administrator Guide


254 PUBLIC S/4HANA Edition for Utilities Contact Center
2.1.1.1.15 Configure to Use Notification Codes to Generate
Notifications

As an administrator, configure to use notification codes to generate notifications.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Service Order/Notifications, select the scoping question Do you want to use the notification code for
generating notifications?

2.1.1.1.16 Configure Search for the Contract Account Value


Help

As an administrator, configure search for the Contract Account value help.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to enable basic and advanced search for the
Contract Account value help?

2.1.1.1.17 Configure to Use Meter Reading History from the


Legacy Move-in Date

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 . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to use the meter reading history from the
legacy move-in date?

2.1.1.1.18 Configure Utilities Communication Data

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 . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and
under Utilities Enhancements, select the scoping question Is Time Dependency for BP Independent Address
Communication data enabled in ISU?

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 255
2.1.1.1.19 Configure Time Dependency for BP Independent
Address Communication data

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 Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and
under Utilities Enhancements, select the scoping question Is Time Dependency for BP Independent Address
Communication data enabled in ISU?

2.1.1.1.20 Enable the Contract Account Object Labels

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 Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to enable the contract account object labels to
display external ID and name?

2.1.1.1.21 Enable The Premise Object Labels

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 Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to enable the premise object labels to display
house number, street name, and house supplement?

2.1.1.1.22 View Service Location Fields in Service Tickets

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 Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to copy premise/PoD address fields to service
location fields while assigning premise/PoD address to service ticket?

Utilities Contact Center Administrator Guide


256 PUBLIC S/4HANA Edition for Utilities Contact Center
2.1.1.1.23 Configure Manual Posting

As an administrator, you can enable manual posting in Utilities Financials.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and
under Utilities Manual Posting, select the scoping question Do you want to enable Manual Posting in ‘Utilities
Financials’?

2.1.1.1.24 Maintain Code Values

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
• Switch Document Status
• Tolerance Group
• Number Ranges for Utilities Contract Account
• Number Range for Utilities Connection Object
• Number Range for Utilities Installation
• Number Range for Utilities Point of Delivery
• Number Range for Utilities Premise
• Number Range for Utilities Sales POD
• Code List Mapping

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 257
• Account Determination ID
• Financial Overview Date Range
• Billing Block Reason
• Bill Form
• Case Category
• Contract Account Class
• Contract Process Status
• Coding and Code Group Assignment
• Clearing Category
• Code Group
• Contract Account Category
• Correspondence Dunning Lock Reason
• Company Code Group
• Deactivation Reason
• Dunning Lock Reason
• Dunning Procedure
• Dunning Group
• Grid Level
• Instalment Plan Category
• Instalment Plan Types
• Interest Key
• Interest Lock Reason
• Invoicing Lock Reason
• Move Out Reason
• Meter Reading Note Type

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

2.1.1.1.25 Configure Alternate Contract Account Work Center

As an administrator, you can configure a new Contract Account Work Center with value help capabilities for
advanced search fields.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to enable the new contract account work
center with value help capabilities for advanced search fields?

Utilities Contact Center Administrator Guide


258 PUBLIC S/4HANA Edition for Utilities Contact Center
2.1.1.1.26 Enable Additional Offering step in Move-In

As an administrator, you can enable the Additional offering step to add external products in guided move-in.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Move Process for S/4, select the scoping questions 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?

2.1.1.1.27 Configure Premise Search in Live Activity

As an administrator, you can configure to use premise basic search in live activity.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to enable local search for the Utilities-Premise
Category in Enterprise Search and Live activity?

2.1.1.1.28 Configure Service Icons in Premise Header

As an administrator, you can configure to hide the service icons in premise header.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to hide the service icons in Premise Header?

2.1.1.1.29 Configure Financial Balance in Contract Account


Header

As an administrator, you can configure to hide the financial balance in contract account header.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to hide the Financial Balances in Contract
Account Header?

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 259
2.1.1.1.30 Configure Alternative View for Change Move-In

As an administrator, you can enable the alternative view for Change Move-In process.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to enable the alternative view for Change
Move-In?

2.1.1.1.31 Assign Front Office Process for Configurable


Hierarchy

As an administrator, you can assign front office process for configurable hierarchy.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to assign Front Office Process for Configurable
Hierarchy?

2.1.1.1.32 Use the IBAN fields to display the payment data

As an administrator, you can use the IBAN fields to display the payment data.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to use the IBAN fields for displaying the
payment data?

2.1.1.1.33 Enable the New Mailing Address Feature in Move-In


Guided Activity

As an administrator, you can use the new mailing address feature to add address in move-in guided activity.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to use the new mailing address feature in move
processes?

Utilities Contact Center Administrator Guide


260 PUBLIC S/4HANA Edition for Utilities Contact Center
2.1.1.2 Replicate Utilities Master Data

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 295] and Contract Account Replictaion [page
297].

2.1.1.3 Assign Work Centers to Business Users

Work center assignment to business users based on their roles.

Assign Work Centers to Business Users

Supported Work Centers and Tab Screens

Work Center Folder Work Center Name Technical Name

COD_UTILITIES_WCF Utilities

Contract Account COD_CONTRACTACCOUNT_WCVIEW

Customer Search COD_CUSTOMER_SEARCH_EXT_WCVIEW

Premise COD_PREMISE_WCVIEW

COD_SALES_WCF Sales

Sales Quotes COD_QUOTE_WCVIEW

Sales POD SALESPOD_WCVIEW

CODACCOUNTWC Customers

 Note
The utilities specific screen -
Utilities Financials, Utilities 360,
and Utilities Service Orders are
available with this scoping.

Accounts CODACCOUNTWCV

Contacts COD_CONTACT_WCV

Individual Customers COD_SEOD_ACCOUNTWL_WCVIEW

COD_SEOD_AGENT_QUEUE_WCF Tickets SEOD_TICKET_SADL_WCVIEW

Live Activity Center LIVE_ACTIVITY_CENTER

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 261
2.1.1.4 Configure the Alerts Tab
As an administrator, use adaptation to add the Alerts tab.

After you add the tab, you can enable it as a side pane in screens. Click your user profile and navigate to
Settings Company Settings and then set the Enable Side Pane toggle to Yes.

Company Setting Screen

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.

Alert Notification

Utilities Contact Center Administrator Guide


262 PUBLIC S/4HANA Edition for Utilities Contact Center
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.

Alerts in Move Process

You can enable the display of alerts in the expanded mode through a scoping question. To configure the
scoping question, go to Business Configuration Implementation Projects . Select your project and click
Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Alerts, select the scoping question Do you want expanded Alerts in Move Processes?

2.1.1.5 Configure Scripts for Move Processes

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.

To configure the script and rule, follow the steps:

1. Navigate to Administrator Industry Settings Utilities Move In/Out Script .


2. On the Move In/Out Scripts page, perform the required actions. The following table describes the sections
that appear on the page:

Section Description

Manage Message Do the following:


• If you want the script to be displayed, set Show Script
to Yes.
• If you want the script to be mandatory, set Mandatory
to Yes.

Message Configuration Do the following:


• To create a new script, select New.
• To modify an existing script, select Edit.
• To delete a script, select Remove.

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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 263
Configure Scripts for Move Processes

2.1.1.6 Configure Utilities 360


As an administrator, you can configure the views for Recent History and Hierarchy sections under Utilities 360
screen of a customer.

To configure the fields in Recent History section, follow the steps:

Utilities Contact Center Administrator Guide


264 PUBLIC S/4HANA Edition for Utilities Contact Center
1. Navigate to Administrator Industry Settings Utilities Settings for Utilities 360 .
2. Click Edit icon to enter into the edit mode.
3. On the Manage Recent History page, you can manage the tables to be shown on the screen by setting it to
Yes.

Utilities Settings
4. Click Save.

To configure the default view in the Hierarchy section, follow the steps:

1. Navigate to Administrator Industry Settings Utilities Settings for Utilities 360 .


2. Click Edit icon to enter into the edit mode.
3. On the Hierarchy page, you can manage the default view for Hierarchy in Utilities 360 to be shown on the
screen by selecting the default view type from the dropdown.

Utilities Settings
4. Click Save.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 265
2.1.1.7 Configure Safety Message for Reconnect

As an administrator, you can configure a safety message to reconnect the AMI smart meter.

Go to Administrator Industry Settings Utilities Safety Message for Reconnect .

On the Safety Message for Reconnect, you can manage the message to be mandatory or optional.

Safety Message for Reconnect

If the message is set to mandatory, when you select a device to reconnect the message appears in the
Reconnect popup.

2.1.1.8 Assign Front Office Processes

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 SAP 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:

• ISUACCOUNT – Contract Account


• ISUPARTNER – Customers (Accounts and Individual Customers)
• PREMISES – Premise

Utilities Contact Center Administrator Guide


266 PUBLIC S/4HANA Edition for Utilities Contact Center
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 .

Assign Front Office Process for Configurable Hierarchy

As an administrator, you can assign business roles to the corresponding object types and front office processes
for configurable hierarchy. This in turn helps you to directly select the front office processes from the SAP
Cloud for Customer system.

Assign the front office process for configurable hierarchy based on the scoping question.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to assign Front Office Process for Configurable
Hierarchy?

To configure front office process for configurable hierarchy, follow the steps:

1. Go to the Administrator Industry Settings Utilities Assign Front Office Process to Configurable
Hierarchy .
2. Add the Mashup ID as per the requirement.
3. Under Business Roles, click Add Row and select a business roles from the value help.
You can also copy the existing business role data by using the Copy option. The corresponding object types
and front office processes are assigned when you copy the existing business roles.
4. Under Object Types, click Add Row and select a object type from the dropdown.
5. Under Front Office Processes, click Add Row and enter the necessary details as per the EWBC transaction
in IS-U system.

 Note

Select the Hide check box if you want to hide the process in the front office process dialog box.

6. Click Save.

 Note

To delete any object type or role, select the row and click Remove.

You can now view the description of the objects under Configurable Hierarchy in the Utilities 360 screen.

Click the object hyperlink to display the list of processes for that particular business role and select the
required process to navigate to the S/4 system.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 267
Related Information

Configure Mashup for Front Office Process (FOP) [page 85]


To integrate the front office processes with your SAP ERP system, you must create and configure a new
mashup.

2.1.1.9 Configure Smart Energy Water

To integrate the Smart Energy Water (SEW) with SAP S/4 HANA system, the Communication Preferences and
Consumption Graph, Outage Map, and Compare must be configured.

Follow the steps to configure Communication Preferences and Consumption Graph, Outage map, and Compare
tabs from SAP Cloud for Customer.

1. To create Mashup Web services, follow the steps:


• Go to Administrator Mash up Web Service New REST Service .
• Add all the mandatory parameters to fetch the token.
• General information – Enter the Service Name
• Service Information- Select Authorization Method as Basic, HTTP method as GET, Service Protocol
as XML, and enter the Username, Password, and URL.
• Input parameters- add Parameters as required.

 Note

Maintain the parameter names as UtilityAccountNumber for Contract Accounts and


CustomerNumber for Customer..
• Ensure the mandatory field is checked if the parameters is required to retrieve the token.
• Ensure to add all parameters as required.
• Constant values are given preference over actual values.

• Click Activate to enable web service.

Utilities Contact Center Administrator Guide


268 PUBLIC S/4HANA Edition for Utilities Contact Center
 Note

Ensure that web service is active.

2. Maintain Admin Settings.


• Go to Administrator Industry Settings Setting for SEW Integration .
• Select the Mashup Web Service ID that you created from the list.
• Enter the Consumption URL, Notification URL, Utility ID, and P ID.

 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.1.10 Configure Message Severity for Move Processes

As an Administrator, configure the severity of the messages received during the move process. You can also
suppress the message if you do not want them to display.

Configure Message Severity

1. Navigate to Business Configuration Overview .


2. Under Activity, search and select Utilities.
3. Select the Message Severity Configuration.
4. Select the severity for each message as you need.
5. Select the Suppress Message check box if you do not want to display any message.
6. Click Save.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 269
2.1.2 Configure Middleware

Learn about the configuration of middleware.

Configure Platform Integration (PI) [page 270]


The configuration required in PI system is documented in detail in the following topics.

Configure SAP Cloud Integration [page 280]


This section describes the configuration required for SAP Cloud Integration.

2.1.2.1 Configure Platform Integration (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 PI 7.11 system (ABAP+JAVA) should be ready and trust relationship should be established with theSAP
Cloud for Customer and CPM as per Integration Guide. See the following sections in the standard integration
guide for S/4HANA using PI.

• Connection Phase: Check and Prepare PI System


• Connection Phase: Set Up Secure Connection Between S/4HANA-PI-Cloud Systems
• Create a view in the key storage and load certificate into view
• Import the root certificate used to sign the SAP Cloud for Customer certificate

Utilities Contact Center Administrator Guide


270 PUBLIC S/4HANA Edition for Utilities Contact Center
2.1.2.1.2 PI Value Mapping: Map COD Business System ID -
S/4HANA Logical System ID

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 fine-tuning.

Mapping Business System - Logical System

COD Business System ID S/4HANA Logical System ID

<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 mappings are used in the PI message mappings for the services.

• S4_C4C_Utilities_BusinessAgreementReplication
• S4_C4C_Utilities_Tech_Objects_Replication

2.1.2.1.3 Download Enterprise Software Repository


Content for Integration

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.

2. Click on the tab Browse Download Catalog


3. Go to SAP Content ESR Content (XI Content)
4. Download the following software components to your local machine:

Download Software Components

Software Component Name Version Contents

XI CONTENT SAP BYD XI CONTENT SAP_BYD 2.40 Interface Definitions for SAP Cloud for
Customer for Utilities Contact Center

XI CONTENT IS-UT XI CONTENT IS-UT 804 S/4HANA Interface Definitions

XI CONTENT C4CS4_IC XI CONTENT C4CS4_IC 100 Mapping, Templates, and Scenarios

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 271
2.1.2.1.4 Create System Landscape Directory
Configuration

Register the on-premise system in the System Landscape Directory (SLD). Systems are typically registered in
SLD when they are initially configured.

To check if your system is registered in SLD, perform the following steps:

1. Log in to the PI system and go to System Landscape Directory System Landscape .


2. Register your on-premise system in PI, by creating a technical system of type AS ABAP for your on-premise
system. For more information, see Creating New Web AS Systems
3. Under ABAP System Details Business Systems , create the corresponding business system for the
technical system. For more information, see Creating and Removing Business Systems.
4. Go to System Landscape Technical Systems and register your cloud solution in PI.
5. Create a corresponding business system for the Cloud solution.
6. Assign SWCV SAP BYD 2.40 under the product SAP BUSINESS BYDESIGN 240.
7. Again, under System Landscape Technical Systems , perform the following steps:
1. Select the SAP Cloud for Customer system and click on Installed Software.
2. Select Add New Product, and add the product SAP BUSINESS BYDESIGN 240 and assign the
software component version SAP BYD 2.40.
3. Similarly, assign SWCV SAP BYD 1411 under the product SAP BUSINESS BYDESIGN 1411.

2.1.2.1.5 Import ESR Content into PI System

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. Log in 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/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.

Utilities Contact Center Administrator Guide


272 PUBLIC S/4HANA Edition for Utilities Contact Center
2.1.2.1.6 Create Configuration Scenario

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 Create and save the configuration scenario.

 Note

You maintain the ID configurations for each of the web services in this configuration scenario. As part of
the ID configuration, you 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
Maintain ID Configuration for Web Services.

2.1.2.1.7 Maintain ID Configuration for Web Services

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 .

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 273
Example: ID Configuration for Web Service - Account 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:

1. Assign sender and receiver business system.


1. To do this, right-click Business System and click Assign Business System.

2. In the Assign Business System dialog box, click 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 (Software
Landscape Directory).

Utilities Contact Center Administrator Guide


274 PUBLIC S/4HANA Edition for Utilities Contact Center
3. Click twice Continue option to assign both sender and receiver business systems.
4. Click Finish to save the configuration.
2. Create communication channel (SOAP sender) for sender business system. To do this,
1. Right-click communication channel and select New.
2. In the dialog box search, and assign your sender business system in communication component and
enter a name for communication channel.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 275
3. Click Create.
4. In the dialog box, select the SOAP Adapter Type as Sender. Enter security level as HTTP and enter the
namespace and the document name.

5. Under Default XI Parameters, enter the web service name.

Utilities Contact Center Administrator Guide


276 PUBLIC S/4HANA Edition for Utilities Contact Center
3. Create communication channel (SOAP receiver) for receiver business system similar to how you have
created the communication channel for sender system. Note that for SOAP Adapter Type as Receiver.
Provide the target URL and credentials of the receiver system.
4. Create receiver determination

1. Right-click Receiver Determination and then click New.


2. For Communication Component, select the business system maintained in the SLD configuration.
3. Also enter the sender interface name and the name space and click Create.
5. Create interface determination

1. Right-click Interface Determination and then click New.


2. In the dialog box, specify the interface name, namespace, and communication component for the
Sender. Similarly, under Receiver, enter the communication component.
6. Create receiver agreement

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 277
1. Right-click Receiver Agreement and then click New.
2. Create receiver agreement and enter the sender communication component name, receiver
component name, receiver interface, and name space names. Assign the receiver communication
channel and save.
7. Create sender agreement
1. Enter the receiver communication component name, sender component name, sender interface, and
name space names. Assign the sender communication channel and save.

Utilities Contact Center Administrator Guide


278 PUBLIC S/4HANA Edition for Utilities Contact Center
8. Activate change lists. To activate, right-click on the top node of the change list and click Activate.

2.1.2.1.8 Configure Communication Arrangements in Cloud


Solution

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

The required certificates have been installed and validated.

Procedure

1. To set the communication arrangement, go to Administrator General Settings Integration


Communication Arrangements
2. Click New and follow the wizard to set up your communication arrangements
3. Use Edit Advance Setting to configure your outbound communication arrangements.
4. After you have completed the configuration, validate the same. To validate, select Outbound
Communication and click Check Connection and look for the message Ping successful.

 Note

Contact your system administrator for details of System Instance ID, Code List Mapping,
Authentication Method (user and password), Port, SAP Cloud for Customer Business System ID, SAP
Cloud for Customer Business System Client, and Communication System Client.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 279
Communication Arrangements for Utilities Contact Center

Communication Scenario (MCPG) Use

ERP Utility Management Integration ISU Configuration, S/4HANA Contract Account Replication,
Query, and Maintain S/4HANA Customer Info

Utilities Contract Account Replication S/4HANA contract account replication

Utilities Bill Correction Invoice Generating invoice PDF

Utilities Technical Master Data Replication Technical objects replication

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
created, S4/HANA sends confirmation to SAP Cloud for
Customer.

2.1.2.2 Configure SAP Cloud Integration


This section describes the configuration required for SAP Cloud Integration.

Inbound: Create Binding for inbound services in S/4HANA

When a service gets triggered from SAP Cloud for Customer, a corresponding S/4HANA service gets executed
in S/4HANA through SAP Cloud Integration. Therefore, you need to create a binding in SOAMANAGER that
generates a calculated URL. This must be configured in the Receiver channel of SAP Cloud Integration.

2.1.2.2.1 Web Service Configuration for Account Overview


Service

1. Open SOAMANAGER and select Web Service Configuration.

Utilities Contact Center Administrator Guide


280 PUBLIC S/4HANA Edition for Utilities Contact Center
2. In the field Object Name search for the inbound S/4HANA service name.

3. Next click Create Service.

4. Enter the Service Name and Binding Name and then click Next.

5. Under Provider Security, select User ID/Password and click Next.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 281
6. You do not need to maintain any settings for SOAP Protocol.

7. You do not need to maintain any settings under Operation Specific.

Utilities Contact Center Administrator Guide


282 PUBLIC S/4HANA Edition for Utilities Contact Center
8. Click Finish and the screen below displays the service and binding.

9. On the second line – click 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 to upload this URL when configuring the SAP Cloud Integration Receiver communication
channel or Receiver Connector.
Here we have a URL for the WSDL – copy this URL as we need to upload this url when we perform the
configuration in PI or HCI Receiver communication channel or Receiver Connector.

11. In the Display Communication Channel dialog, upload the WSDL URL as the Target URL under Connection
Properties.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 283
12. Account Overview

Utilities Contact Center Administrator Guide


284 PUBLIC S/4HANA Edition for Utilities Contact Center
2.1.3 Configure Integration with S/4HANA

An overview of how to configure integration with S/4HANA system.

 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 S/4H Utilities in the Attachments tab.
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/.

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

Utilities Business Partner Replication [page 286]


For more information, see the following topics:

Implementation Guide (IMG) on IS-Utilities [page 287]


Perform and maintain the configuartion for IMG related to SAP Cloud for Customer

Data Replication from IS-Utilities [page 294]


The reports listed in this section must be executed for transfer of data from IS-Utilities system to the
Utilities Contact Center cloud solution.

Configure Mashup for Front Office Process (FOP) [page 304]

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 285
Related Information

Configure Platform Integration (PI) [page 26]


The configuration required in PI system is documented in detail in the following topics.

2.1.3.1 Utilities Business Partner Replication

For more information, see the following topics:

• Configuring Master Data Governance for Business Partner


• Data Replication Using Enterprise Service Oriented Architecture (SOA)

To run an initial load, use the drfout transaction.

2.1.3.1.1 Business Partner Replication Via Parallel


Processing

Replicate the business partner data in bulk using parallel processing.

You can run the report COD_UTIL_BP_REP_LOAD_V1 with a dedicated server group to maximize the
performance. Set up a background job and monitor the status with transaction SM37.

The output displays the details with the count of business partners processed executed in dialog mode, after
execution of the report. Maintain the parallel logs to monitor them in SLG1.

Follow the steps to configure business partner replication using parallel processing from SAP Cloud for
Customer.

1. Open transaction SE38 and enter report COD_UTIL_BP_REP_LOAD_V1.


2. Execute the report or press F8.
3. Enter the following details in the selection screen.
• Business Partner ID - enter business partner IDs for replication.
• Port and Size - enter logical system and package size.
• Parallel Processing -
• To execute the program, select the checkbox and enter the Server Group. It’s good to create a
separate server group with available work processes to achieve fast response.
• To execute the program in normal processing mode, deselect the checkbox.

 Note

It’s recommended to schedule the report as background job and monitor in SM37 for bulk data processing.

Utilities Contact Center Administrator Guide


286 PUBLIC S/4HANA Edition for Utilities Contact Center
2.1.3.2 Implementation Guide (IMG) on IS-Utilities
Perform and maintain the configuartion for IMG related to SAP Cloud for Customer

Create Configurable Hierarchy [page 287]

MDT Templates for Move-In, Customer, Contract Account and Rate Change Using Guided Processes [page
287]
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.

Enrollment - Configuring Switch Document Creation and Notification [page 288]


Detailed information for creating switch document in the cloud solution.

Assign Front Office Processes [page 266]


Assign the front office processes that you need to launch from SAP Cloud for Customer in the
Implementation Guide customizing.

Configure Account as Special Account [page 292]


A special account is a type of account which as too many contract accounts, contracts, and premises
for a particular account.

2.1.3.2.1 Create Configurable Hierarchy

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

2.1.3.2.2 MDT Templates for Move-In, Customer, Contract


Account and Rate Change Using Guided
Processes
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 .

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 287
Follow these steps to configure MDT template for use in your utilities solution in SAP Cloud for Customer:

• Create an MDT template using transaction code EPRODCUST.


• Assign the MDT template to IMG activity Configure MDT Template under IMG for SAP S/4HANA SAP
Utilities 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.

2.1.3.2.3 Enrollment - Configuring Switch Document


Creation and Notification

Detailed information for creating switch document in the cloud solution.

Configure Switch Document Creation in Cloud Solution

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.

When the C4C quote is confirmed (Submit Action), a switch document creation is triggered on S/4HANA ISU.

• For valid ISU PODs - the switch document is created successfully.

Utilities Contact Center Administrator Guide


288 PUBLIC S/4HANA Edition for Utilities Contact Center
• For invalid ISU PODs - a temporary switch message is created with the sales pod details . Later the
back-office process converts the sales pod to ISU pod using the sales pod details stored in temporary
switch message and create the switch document accordingly.

For the back-office process, you can refer to sample implementation COD_UTILITIES_SWITCH_BADI_IMPL in
the enhancement spot COD_UTILI TIES_SWITCH_DOC.

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.

Configuration for Creating Switch Document

Parameter Value

Service in Cloud Solution CO_CQP_SOR_OUT

S/4HANA Service II_UTILITIES_LEAN_QUOTE_SI_IN1

PI Outbound Service CustomerQuoteProcessingSalesOrderRequestOut

PI Inbound Service Utilities_LeanQuote_SI_In

Operation Mapping in PI C4C_S4_UtilitiesQuote_SwitchDocumentRequest

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

Configure Notification for Switch Document in Cloud Solution

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.

Configure Notification for Switch Document

Parameter Value

Service in cloud solution II_CQP_SLO_NOTIFICATION_IN

S/4HANA Service CO_CUSTOMER_QUOTE_PROCESSING_U

PI Outbound Service CustomerQuoteProcessingUpdatingSalesQuoteWithSale-


sOrderIn

PI Inbound Service CustomerQuoteProcessingUpdatingSalesQuoteWithSale-


sOrderIn_In

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 289
Parameter Value

Operation Mapping in PI S4_C4C_Utilities_CustomerQuoteProcessingUpdatingSales-


Quote¬-WithSalesOrderIn

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

Configuration in S/4HANA System

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:

1. Go to transaction code SOAMANAGER in the S/4HANA system.


2. Choose Service Administration as Web Service Configuration.
3. Search for consumer proxy CO_CUSTOMER_QUOTE_PROCESSING_U. Click to view the details.
4. Choose Create a Manual configuration.
5. Enter information based on your middleware configuration. Here is an example value that needs
to be adjusted according to your configuration. Example URL Path: /XISOAPAdapter/MessageServlet?
channel=:ABC_004: S4_SOAP_Utilities_LeanQuote_Notification_Send&sap-client=238
6. To confirm that the logical port was created and configured correctly, ping the Web service. If the ping is
successful, a confirmation message appears.

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

Utilities Contact Center Administrator Guide


290 PUBLIC S/4HANA Edition for Utilities Contact Center
2.1.3.2.4 Assign Front Office Processes

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 SAP 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:

• ISUACCOUNT – Contract Account


• ISUPARTNER – Customers (Accounts and Individual Customers)
• PREMISES – Premise

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 .

Assign Front Office Process for Configurable Hierarchy

As an administrator, you can assign business roles to the corresponding object types and front office processes
for configurable hierarchy. This in turn helps you to directly select the front office processes from the SAP
Cloud for Customer system.

Assign the front office process for configurable hierarchy based on the scoping question.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to assign Front Office Process for Configurable
Hierarchy?

To configure front office process for configurable hierarchy, follow the steps:

1. Go to the Administrator Industry Settings Utilities Assign Front Office Process to Configurable
Hierarchy .
2. Add the Mashup ID as per the requirement.
3. Under Business Roles, click Add Row and select a business roles from the value help.
You can also copy the existing business role data by using the Copy option. The corresponding object types
and front office processes are assigned when you copy the existing business roles.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 291
4. Under Object Types, click Add Row and select a object type from the dropdown.
5. Under Front Office Processes, click Add Row and enter the necessary details as per the EWBC transaction
in IS-U system.

 Note

Select the Hide check box if you want to hide the process in the front office process dialog box.

6. Click Save.

 Note

To delete any object type or role, select the row and click Remove.

You can now view the description of the objects under Configurable Hierarchy in the Utilities 360 screen.

Click the object hyperlink to display the list of processes for that particular business role and select the
required process to navigate to the S/4 system.

Related Information

Configure Mashup for Front Office Process (FOP) [page 85]


To integrate the front office processes with your SAP ERP system, you must create and configure a new
mashup.

2.1.3.2.5 Configure Account as Special Account

A special account is a type of account which as too many contract accounts, contracts, and premises for a
particular account.

Configuration for Special Account

To identify the account as special account, configure the account using IMG activity in SAP S/4HANA.

In this IMG activity, define the number of records for contract accounts, contracts, and premises. The number
of records default value is 30 and you can change the value as per your business requirement.

To configure account as special account the following conditions needs to be verified:

• Condition A: The system verifies for the number of active contract accounts with the number of records
defined for contract account, if the number of accounts matches, then the account is identified as a special
account.

 Note

If condition A is verified and identified as special account, then the system does not check for other
conditions.

Utilities Contact Center Administrator Guide


292 PUBLIC S/4HANA Edition for Utilities Contact Center
• Condition B : If condition A fails, then the system verifies for the number of active contracts (the start date
of which is less than the execution date and the end date is more than execution date) with the number of
records defined for contracts, if the number matches, then the account is identified as special account.
• Condition C : If both conditions A and B fail, then the system verifies for the number of active premises
(with contracts or occupied premises) with the number of records defined for premise, if the number
matches, then the account is identified as special account.

Special Account Classification

Business Partners are classified as special accounts when they meet the criteria set in the IMG activity for
special accounts.

Follow the steps to run the report ISU_C4C_LARGE_ACCOUNTS from the back end.

1. Under Use Bp’s for first time or configuration changes, you can select All Business partners or New
Business Partner.
2. When you select All Business Partners,
• It fetches all the active business partners and type as Organization. If this meets the IMG condition,
then the records get created in the large account table and replicated to Cloud for Customer.
• Select the Replication Period to replicate the business partner to special account.
3. When you select New Business Partner,
• Select the newly created business partner with the time period.
• In Replication for Special Accounts, you can select Update and Replicate to C4C or Replicate to C4C.
• If you select Update and Replicate to C4C, it updates the large accounts table in backend and
replicates the data to C4C. If its already replicated the data is ignored.
• If you select Replicate to C4C, it replicates the data from backend to C4C, using the replication
period mentioned in selection screen. This replicates the records that are created or modified
during the time period.
4. Select Parallel Processing when large number of records are processed.
5. You can split the records into multiple packets depending on the packet size.
6. Generates the multiple parallel jobs depending on number of work processors.
7. Uses server group for parallel processing as per the server group.

Once the classification set up is completed, a Special Account flag is set in the Cloud for Customer screen and
the account is considered as special account. It enabled with the new tabs such as Overview, Utilities Premises,
Utilities Contract Accounts.

 Note

All other Utilities-related tabs such as Utilities Financial, Utilities 360, Utilities Collection, and so on are not
available for the special account.

Related Information

Overview [page 395]

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 293
This screen displays the Contract Accounts, Premise, and Collective Contract Accounts cards.

Utilities Contract Account [page 395]


This screen displays all the details of utilities contract accounts and collective contract account.

Utilities Premises [page 396]


This screen displays all the premise for that corresponding special account.

2.1.3.3 Data Replication from IS-Utilities

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

Delta (Creation Delta (Modifi-


of New Ob- cation of Exist- Unidirectional/ Scoping and
Object Initial Load jects) ing Objects ) Bidirectional Fine Tuning

Business Part- Yes Yes Yes Bidirectional Yes

ner - MDG

Contract Ac- Yes Yes Yes Unidirectional Yes

count Replica- (Only from IS-


tion Utilities to
Cloud Solution)

Contract Ac- Not Applicable Not Applicable Not Applicable Unidirectional Yes
(Only from IS-
count Online
Utilities to
Cloud Solution)

Point of Deliv- Yes Yes Yes Unidirectional Yes

ery Replication (Only form IS-


Utilities to
Cloud Solution)

Contracts Not Applicable Not Applicable Not Applicable Not Applicable Not Applicable

Connection Ob- Yes Yes Yes Unidirectional Not Applicable

ject (IS-Utilities to
Cloud solution)

Premise Yes Yes Yes Unidirectional Not Applicable

(IS-Utilities to
Cloud solution)

Utilities Contact Center Administrator Guide


294 PUBLIC S/4HANA Edition for Utilities Contact Center
2.1.3.3.1 Technical Objects Replication

Technical Objects Replication Report: ISU_C4C_TECH_OBJECTS_REPL

Report for Initial Load - ISU_C4C_TECH_OBJECTS_REPL

 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 utilities-specific 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

To enable the feature to use the External ID as Internal ID in for premise,SAP Cloud for Customer 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

Follow these steps to run the report:

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 is set to sy-langu if empty. Also the From-Date is 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 “MaximumSize", you can control how many
technical master data is 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.

Delta Replication - Connection Object

Create or change of a connection object triggers delta replication. Follow these steps to trigger a delta
replication for connection object data:

1. In the transaction code SM30, enter the table / view SWFDVEVTY2.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 295
2. Add the entries for the events CHANGED and CREATED for the object CONNOBJ.

 Note

Creating or changing a connection object triggers the delta replication for connection objects.

Delta Replication - Premise

Follow these steps to trigger a delta replication for premise data:

1. In the transaction code SM30, enter the table / view SWFDVEVTY2.


2. Add the entries for the events CHANGED and CREATED for the object PREMISES.

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

Delta Replication - Point of Delivery

Follow these steps to trigger a delta replication for point of delivery data:

1. In the transaction code SM30, enter the table / view SWFDVEVTY2.


2. Add the entries for the events CHANGED and CREATED for the object ISUPOD.

 Note

Creating or changing a connection object triggers the delta replication for point of delivery data.

Technical Object Replication Via Parallel Processing Technique

This enables the replication of technical objects for Initial load with faster response time via parallel processing
technique.

Report ISU_C4C_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 that 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.

Utilities Contact Center Administrator Guide


296 PUBLIC S/4HANA Edition for Utilities Contact Center
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.

• Enhancement Spot: COD_UTIL_TECH_OBJS_REPLICATION


• BAdI: COD_UTIL_TECH_OBJS_REPLICATION
• Interface: IF_COD_UTIL_TECH_OBJS_REPL
• Method: POD_ADJUST_DATA

Configuration in S/4HANA System

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:

1. Go to transaction code SOAMANAGER in the S/4HANA system.


2. Choose Service Administration as Web Service Configuration.
3. Search for consumer proxy CO_UTILITIES_TECHNICAL_OBJEST. Click to view the details.
4. Choose Create a Manual configuration.
5. Enter information based on your middleware configuration. Here is an example value that needs to be
adjusted according to your configuration. Example URL Path: XISOAPAdapter/MessageServlet?
senderParty=&senderService=Q5J_340&receiverParty=&receiverService=&interface=Utilities_Technical_
Objests_Repl_Out&interfaceNamespace=http%3A%2F%2Fsap.com%2Fxi%2FCODERINT
6. To confirm that the logical port was created and configured correctly, ping the Web service. If the ping is
successful, a confirmation message appears.

2.1.3.3.2 Contract Account Replication

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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 297
Prerequisites

1. Implemented the ContractAccountBulkReplicateRequest_Out 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.

Maintain Following Configuration in the Cloud Solution

1. Go to the ADMINISTRATOR work center.


2. Click on Edit ID Mapping for Integration, maintain the following values and click on Go:
• Mapping Of : Business Partners
• ID : Business Partner ID in the cloud solution

Utilities Contact Center Administrator Guide


298 PUBLIC S/4HANA Edition for Utilities Contact Center
 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.

• External ID : Business Partner ID in on-premise system


• System Instance ID: ID of the on-premise system

Maintain Following Configuration in IS-Utilities (S/4HANA on-premise


system)

1. Create a contract account using the transaction code CAA1.


2. Use transaction code SE38 and enter the report name ISU_C4C_ACCOUNT_EXTRACT. Enter the following
values and execute the report:

 Note

Uncheck the Test flag before you execute the report.

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

2.1.3.3.3 Contract Account Delta Replication

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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 299
Identifying the Delta for Contract Accounts

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.

Configuration for Enabling the Event Handler CL_ISU_C4C_SWER_CA

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.

Required - Business Add-In Implementation

Use business add-in COD_UTILITIES_REPLICATION_CONF and implement the method


GET_RECEIVER_SYSTEM to generate a list of receiving logical systems. The ISU_C4C_ACCOUNT_EXTRACT
report sends the contract account information as IDocs to the SAP PI middleware and therefore you need to
maintain the receiving logical systems as parameters for the report.

Optional - Other Extensibility Options

1. Use the BAdI COD_UTILITIES_REPLICATION (method CA_ADJUST_DATA) in the report


ISU_C4C_ACCOUNT_EXTRACT to modify or delete records that must be set to the cloud solution. This
BAdI called right before the IDocs are created and sent.
2. For other extensible options, you can develop custom event handler classes as part of a project and set
those in the customizing entries to have more control of the delta replication process.

Utilities Contact Center Administrator Guide


300 PUBLIC S/4HANA Edition for Utilities Contact Center
2.1.3.3.4 Contract Account Replication Using Parallel
Processing

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.

2.1.3.3.5 Contract Account- IDoc Mass Replication

Use the below configuration steps, if you want to send multiple IDOCs as a single PI message to the receiver
system:

1. Main batch size in communication channel.


2. Create PI IDoc sender communication channel and enter package size, which you have entered in partner
profile.
3. Whenever you create an IDoc in S/4HANA system; it goes to Status 30( all IDocs in collect mode).
4. Use transaction code SE38 and enter the report name RSEOUT00. Enter the following values and execute
the report:

 Note

Execute RSEOUT00 report using back-ground program.

The below images explain the setps involved to process 100 IDocs as a single message:

WE20

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 301
PI Sender Communication channel

Utilities Contact Center Administrator Guide


302 PUBLIC S/4HANA Edition for Utilities Contact Center
SE38 - RSEOUT00

For more information on Contract Account Replication – Extension on SAP Cloud


Integration Artifact, see https://help.sap.com/viewer/368c481cd6954bdfa5d0435479fd4eaf/Cloud/en-US/
d3741720e29842e4bf547dcd66139f7f.html

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 303
2.1.3.3.6 Code Lists Mapping

Code list mapping must be maintained for the fields specified in the following sections

Automatic Code List Mapping

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.

Related Information

Configure Automatic Code List Mapping

2.1.3.4 Configure Mashup for Front Office Process (FOP)

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.

Utilities Contact Center Administrator Guide


304 PUBLIC S/4HANA Edition for Utilities Contact Center
 Note

You also need to assign the launch object in the Implementation Guide Customizing for SAP Cloud for
Customer Utilities. For more information, see the reference in the related links section.

Related Information

Assign Front Office Processes [page 60]


Assign the front office processes that you need to launch from SAP Cloud for Customer in the
Implementation Guide customizing.

Mashups

2.2 Functional Scenarios

Learn about the functional scenarios in the Utilities Contact Center.

Customer Search [page 306]


In the cloud solution, search for utilities customers that exist in the SAP S/4HANA system.

Live Activity Center and Enterprise Search [page 307]


Enterprise search in HTML client and Live Activity Center-based search in Fiori client are available for
Utilities Contact Center. The utilities-specific object categories are available in enterprise search or live
activity center only if the Utilities Call Center solution is scoped in the system.

Move Processes [page 312]


You can initiate Move-In, Move-Out, and Transfer services from all the Utilities screens of a customer.

Alerts [page 326]


You can view static content under the Alerts side panel across the Customer, Premise, and Contact
Account screens in Utilities Contact Center solution. The Alerts framework is also available at every
stage of move processes.

Premise [page 327]


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.

Contract Accounts [page 338]


This work center view displays all contracts for a selected contract account including information such
as move-in and move-out dates.

Utilities Views in Customers [page 354]


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.

Sales POD [page 396]

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 305
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.

Front Office Process [page 401]


Configure the Front Office Process in your SAP Cloud for Customer.

Master Data Template-Based Processes [page 402]


Configure the Master Data Template (MDT) process in your SAP Cloud for Customer to create guided
move-in and guided transfer.

Account Executive Dashboard [page 406]


Account Executive Dashboard contains information tiles to show corresponding list view of configured
object for the user’s key accounts.

Business Partner Exception Management (BPEM) - Integration with SAP ERP or SAP S/4HANA System
[page 407]
Configure the Business Partner Exception Management in your SAP Cloud for Customer.

Audit Trail Logs in S/4HANA System [page 412]


You can now use the logs in S/4HANA system to track updates performed in the Utilities Financials
screens.

Depersonalization in Contract Account and Sales POD [page 413]


Depersonalization is only available for users with access to the Data Protection and Privacy work center.

Appendix with List of Relevant S/4HANA Transactions [page 413]

2.2.1 Customer Search

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.

Utilities Contact Center Administrator Guide


306 PUBLIC S/4HANA Edition for Utilities Contact Center
2.2.2 Live Activity Center and Enterprise Search

Enterprise search in HTML client and Live Activity Center-based search in Fiori client are available for Utilities
Contact Center. The utilities-specific 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.

• Utilities-Contract Accounts
For basic search for contract accounts, search using Contract Account and Contract Account Name
• Utilities-Customer
For basic search for customers, search using Customer ID, First Name, Last Name, Phone Number, and
Email Address.
• Utilities-Point of Delivery
For the basic search for POD, search using POD ID, Installation ID.
• Utilities-Premise
For basic search for premise, search using Premise ID and Address.

Live Activity Center

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.

Configure Search Objects

To configure search objects, follow these steps:

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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 307
Conditions for Enterprise Search and Using Live Activity Center

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.
• Search using house number, apartment ID, and floor ID must have a combination of postal code or city
or street name.
• Search using street name must be executed along with either postal code or city or house number.

Live Activity - Identify Customers from Independent Communication


Information

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.

2.2.2.1 View Contract Account and Premise Details in Live


Activity Center

In Live Activity Center, you can view the contract account and premise details of a 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 and Premise Tables checkbox.

Utilities Contact Center Administrator Guide


308 PUBLIC S/4HANA Edition for Utilities Contact Center
Live Activity Configuration

When you select a customer or account, a table with the contract account and premise details appears.

Contract Account and Premise table in Live Activity

2.2.2.2 Confirm Contract Account in Live Activity Center


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

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 309
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 mentioned
screens of the confirmed customer.

Confirm Contract Account from IVR in Live Activity

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.

Utilities Contact Center Administrator Guide


310 PUBLIC S/4HANA Edition for Utilities Contact Center
Identify Customer when Contract Account is passed from IVR

It is possible to identify a customer when contract account is passed from IVR. When contract account
is passed in any of the custom fields, the identification happens only on the Utilities-customer category
and caller is identified. The search result set also comes from the Utilities-customer category. The service
ISU_C4C_FINDCUST(S4)/COD_UTILITIES_FINDCUST(ECC) has to be enabled for the functionality to work.

The caller is identified based on the ISU finder results when the phone number and contract account are
passed from the IVR.

If any changes needed from standard behavior then the S4/ECC BADI has to be implemented.

Confirm Collective Contract Account from IVR in Live Activity

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.

Reuse Libraries for Contract Account

The reuse libraries for contract account provide additional, very specific services to the scripting language that
are relevant to fetch the Confirmed Contract Account.

Get Confirmed Objects

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.

Example import AP.CRM.Global;var ConfirmedObjects =


UtilitiesLib.GetConfirmedObjects(this.CustomerUUID);
this.ConfCAID =
ConfirmedObjects.UtilitiesConfirmedObjectElements.GetFirst().Confirm
edObjectValue;;

Result:

The confirmed contract account will be returned.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 311
2.2.2.3 Open Customer Hub from Live Activity

When a call is simulated through IVR, the respective customer gets identified in Live Activity and the Customer
Hub screen 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 option
Open Customer Hub.

Once you enable the option of opening customer hub, you are able to enable 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 option Consider Contract Account View in Customer Hub.

2.2.3 Move Processes

You can initiate Move-In, Move-Out, and Transfer services from all the Utilities screens of a customer.

2.2.3.1 Configure Message Severity for Move Processes

As an Administrator, configure the severity of the messages received during the move process. You can also
suppress the message if you do not want them to display.

Configure Message Severity

1. Navigate to Business Configuration Overview .


2. Under Activity, search and select Utilities.
3. Select the Message Severity Configuration.
4. Select the severity for each message as you need.
5. Select the Suppress Message check box if you do not want to display any message.
6. Click Save.

2.2.3.2 Configure Scripts for Move Processes

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.

To configure the script and rule, follow the steps:

1. Navigate to Administrator Industry Settings Utilities Move In/Out Script .


2. On the Move In/Out Scripts page, perform the required actions. The following table describes the sections
that appear on the page:

Utilities Contact Center Administrator Guide


312 PUBLIC S/4HANA Edition for Utilities Contact Center
Section Description

Manage Message Do the following:


• If you want the script to be displayed, set Show Script
to Yes.
• If you want the script to be mandatory, set Mandatory
to Yes.

Message Configuration Do the following:


• To create a new script, select New.
• To modify an existing script, select Edit.
• To delete a script, select Remove.

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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 313
Configure Scripts for Move Processes

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.

Utilities Contact Center Administrator Guide


314 PUBLIC S/4HANA Edition for Utilities Contact Center
Create Move-In

You can create move-in either using:

• Move-In in the various utilities processes


• Move-In in the Customer toolbar; This is a guided move-in process
• Move-In using MDT in the Customer toolbar; This is a guided move-in process.

 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 Address Type Ahead Search

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 S/4HANA 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 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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 315
Rate Category Selection During Move-In

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

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.

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

 Note

You can have an alternative view for the change move-in process where the original date is saved along with
the new move-in date based on the scoping question.

The new date is reflected in the Meter Reading table and Customer Overview table for a premise. If you
cancel the change move-in process, move-in date resets to the original date and the meter reading order is
not reversed as it has already been created.

Utilities Contact Center Administrator Guide


316 PUBLIC S/4HANA Edition for Utilities Contact Center
2.2.3.3.1 Guided Move-In

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.

Steps in a guided move-in are discussed as follows:

1. Customer and Premise


• The Customer section defaults the customer ID and name. To create a new individual customer, select
New Customer; and to create an account select New Account. When a new customer or an account is
created, a contract account is created automatically.

 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 Address Type Ahead Search

 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 59]

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

 Note

The round trips made to S/4 HANA Cloud are reduced where services and meter reading reusable
Embedded Component (EC) are available.

In the following ECs, the property in the inport 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

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 317
• COD_UTILITIES_TRANSFER_REVIEW.EC

• The Meter Information table displays meter details such as device category, register group, AMI status,
manufacturer serial number, and capabilities in the move-in process. Create and change the meter
reading screens to view device information record.

 Note

View meter reading history using the History option.

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

• Move-In Date is the same as selected for the service.


3. Contract Account and Billing
• The header section displays Customer ID, Move-In Address, and Move-In Date.
• In the Contract Account section, you can create a new contract account. From the External ID value,
help you can select an existing contract account.
• Billing information such as Joint Invoicing, Reason for Deposit, and Security Deposit are defaulted for
the selected contract account.
• In the mailing address section, you can select one of the following options to enter the mailing address:
1. Use Customer Address to auto fill the fields with customer address.
2. Use Premise Address to auto fill the fields with premise address.
3. Add New Address to enter the fields manually.
or use the PO Box details option to add the PO box address details for the customer.
• Create additional notes. Notes that you create here will also be reflected in your S/4 HANA system.
• The Calculate Security Deposit tab is an empty service that can be implemented using the
COD_UTIL_SECURITY_DEPOSIT or ISU_C4C_SECURITY_DEPOSIT business add-in.
4. Additional Offering
• Select and add the External products configured in product list for the particular customer.

 Note

Use the Refresh button to update the product list instead of restarting the move-in process.

After adding the products, the system creates corresponding sales quotes for the products selected and
they are visible in the Sales Quotes tab.

 Restriction

• The Guided Activity Floorplan (GAF) data automatically disappears after Move-In action.
• Product list is 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.

Utilities Contact Center Administrator Guide


318 PUBLIC S/4HANA Edition for Utilities Contact Center
Related Links

MDT Based Processes

2.2.3.3.2 Use the Contract Level Security Deposit and Joint


Invoicing Details in Move in Process

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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 319
2.2.3.3.3 Perform Rate Simulation in Move in Processes

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

Utilities Contact Center Administrator Guide


320 PUBLIC S/4HANA Edition for Utilities Contact Center
updated if you have not set the flag for New Mailing Address. Validity date range is introduced in Move-Out
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 Address Type Ahead Search

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.

2.2.3.4.1 Guided Move-Out

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.

Steps in a guided move-out are discussed as follows:

1. Customer and Premise:


• The Customer section defaults the customer ID and name.
• The Premise section displays the Move-Out Address and the Move-Out Date (current date). Select a
move-out reason using value help on the field.
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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 321
• The Details section displays meter reading for the selected service. Estimate and Reset is possible for
meter reading.

 Note

View meter reading history using History option.

• Move-Out Date is the same as selected for the service.


3. Contract Account and Billing:
• The header section displays Customer ID, Move-out Address, and Move-Out Date.
• Possibility to create a new customer and a new contract account in the process of creating a move-out.
• Billing information such as Joint Invoicing, Reason for Deposit, and Security Deposit are defaulted for
the selected contract account.
• In the mailing address section, select Same as Above to copy the move-out address.
• Create additional notes. Notes that you create here will also be reflected in your ERP system.
4. Review:
This step displays a summary of all information maintained in the previous steps. Review the details and
click Create Move-Out to initiate the move-out process.

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.

Process Flow for Transfer of Move-In Address

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 Address Type Ahead Search

Utilities Contact Center Administrator Guide


322 PUBLIC S/4HANA Edition for Utilities Contact Center
5. Set the flag for Create Service Order if you need to create a service order to initiate the transfer. For every
device (Equipment) that is moved-in to, a service order can be created. Note that triggering service order
creation is optional.

 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:

• Move Out Premise:


• This section displays the move-out address, date, premise external ID, and move-out reason. Value
help on Move-Out Address lists all premises for the customer. Select an address and move-out reason
using value help on the field.
• Move Out Services:
• The header displays the customer ID and name, move-out address, and date from the previous step.
• The Services section displays all services available for the customer along with details such as rate
category, installation ID, and division.
• The Details section displays meter reading information for a selected service. Estimate or reset of
meter readings is possible.
• The next step displayed is the Contract Account and Billing.
• Move In Premise:
• The Premise section displays the move-in address, date, and premise external ID. Select a move-in
address from value help on the field. All premises for the customer are listed for selection. The move-in
date is defaulted to current date.
• The Customer section displays customer name and ID. This information is defaulted from the
customer for which you create the move-in.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 323
• Move In Services:
• The Services section displays all services available for the customer along with details such as rate
category, installation ID, and division.
• The Details section displays meter reading information for a selected service. Estimate or reset of
meter readings is possible.
• The next step displayed is the Contract Account and Billing.
• Contract Account and Billing:
• The header displays the customer name and ID, move-in and move-out address and date. These
details are copied from the previous steps.
• Possibility to create a new customer and a new contract account in the process of creating a move-ín.
• Billing information such as Joint Invoicing, Reason for Deposit, and Security Deposit are defaulted for
the selected contract account.
• In the mailing address section, select flag Same as Above to copy the move-in address.
• Create additional notes. Notes that you create here will also be reflected in your S/4HANA system.
• Review: This step displays a summary of all information maintained in the previous steps. Review the
details and click Complete Transfer to initiate the transfer process.

 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 59]

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

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.

Guided transfer process includes the following steps:

1. Move Out Premise:


• This section displays the move-out address, date, premise external ID, and move-out reason. Value
help on Move-Out Address lists all premises for the customer. Select an address and move-out reason
using value help on the field.
2. Move Out Services:
• The header displays the customer ID and name, move-out address, and date from the previous step.
• The Services section displays all services available for the customer along with details such as rate
category, installation ID and division.
• The Details section displays meter reading information for a selected service. Estimate or reset of
meter readings is possible.
• The next step displayed is the Contract Account and Billing.

Utilities Contact Center Administrator Guide


324 PUBLIC S/4HANA Edition for Utilities Contact Center
3. Move In Premise:
• The Premise section displays the move-in address, date and premise external ID. Select a move-in
address from value help on the field. All premises for the customer are listed for selection. The move-in
date is defaulted to current date.
• The Customer section displays customer name and ID. This information is defaulted from the
customer for which you create the move-in.
4. Move In Services:
• The Services section displays all services available for the customer along with details such as rate
category, installation ID and division.
• The Details section displays meter reading information for a selected service. Estimate or reset of
meter readings is possible.
• The Meter Information table displays meter details such as device category, register group, AMI status,
and capabilities in the move-in of transfer process. Create and change the meter reading screens to
view device information record.

 Note

View meter reading history using History option.

5. Contract Account and Billing:


• The header displays the customer name and ID, move-in and move-out address and date. These
details are copied from the previous steps.
• Possibility to create a new customer and a new contract account in the process of creating a move-ín.
• Billing information such as Joint Invoicing, Reason for Deposit and Security Deposit are defaulted for
the selected contract account.
• In the mailing address section, select flag Same as Above to copy the move-in address.
• Create additional notes. Notes that you create here will also be reflected in your ERP system.
• The Calculate Security Deposit tab is an empty service that can be implemented using the
COD_UTIL_SECURITY_DEPOSIT or ISU_C4C_SECURITY_DEPOSIT business add in.
6. Review:
This step displays a summary of all information maintained in the previous steps. Review the details and
click Complete Transfer to initiate the transfer process.

 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 59]

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 325
2.2.4 Alerts

You can view static content under the Alerts side panel across the Customer, Premise, and Contact Account
screens in Utilities Contact Center solution. The Alerts framework is also available at every stage of move
processes.

2.2.4.1 Configure the Alerts Tab

As an administrator, use adaptation to add the Alerts tab.

After you add the tab, you can enable it as a side pane in screens. Click your user profile and navigate to
Settings Company Settings and then set the Enable Side Pane toggle to Yes.

Company Setting Screen

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.

Utilities Contact Center Administrator Guide


326 PUBLIC S/4HANA Edition for Utilities Contact Center
Alert Notification

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.

Alerts in Move Process

You can enable the display of alerts in the expanded mode through a scoping question. To configure the
scoping question, go to Business Configuration Implementation Projects . Select your project and click
Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Alerts, select the scoping question Do you want expanded Alerts in Move Processes?

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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 327
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.

Premise Quick View to Display Active Services and Active Customer

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

Utilities Contact Center Administrator Guide


328 PUBLIC S/4HANA Edition for Utilities Contact Center
and the current active customer under this premise quick view.

2.2.5.1 Views in Premise

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.1.1 Overview

This screen has three subsections, namely the Map 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

In this section, you can:

• 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 create a guided move-out.
• Cancel a Move-Out
• Change a Move-Out

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 329
• Create a new simple Transfer. Use the Transfer on the toolbar to create a guided transfer.

2.2.5.1.2 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, 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.

Meter Reading

In the Utilities Contact Center, you can create and update meter readings. On selection of a device 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 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 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

For AMI, the create and edit actions are disabled as the meter reading entry is captured automatically from
backend.

Utilities Contact Center Administrator Guide


330 PUBLIC S/4HANA Edition for Utilities Contact Center
 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.

Interim Meter Reading


You can now enter or estimate an interim meter reading with or without billing. You must specify the
appropriate meter reading reason and type.

Meter Reading Estimate, Override, and Reset


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.

Meter Reading Order


The meter reading table displays a combination of meter reading result and meter reading order, sorted by
date, device, manufacturer serial number, 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’s 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’s possible
to enter new meter reading only for the following meter reading reasons: 02- Interim meter reading with
billing, 09-Interim meter reading without billing, and 10- Control Reading.
• 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, 09,
and 10.

• When creating meter reading for Register1, the system automatically creates meter reading orders for
all other registers associated with the equipment.

Summary of Validations for Meter Readings


Following new validations are available for guided processes (move-in, move-out and transfer)

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 331
• 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.

Validations in Guided Processes


Use Validate UI action to validate meter readings in guided move-in, move-out and transfer.

Validations for Meter Reading Create


• Reset option in the UI dialog for New Meter Reading.
• If meter readings are blank, then meter reading orders are created for meter reading reasons 02 and 09.
• Move-in, move-out and billed meter reads are not editable.

View Information About the Validity of a Meter

The validity period of meter of a premise or an installation are displayed under Meter Information table.

Utilities Contact Center Administrator Guide


332 PUBLIC S/4HANA Edition for Utilities Contact Center
View Device Location Details

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 pop up.

Advanced Metering Infrastructure (AMI)

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:

• Customers Utilities 360 Object Hierarchy Device Details .

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 333
• Utilities Premise Connection Details Device Details .
On the Connection Details page, click Ping to receive the status of the meter from the call center. The
status comes with details that can be used for analysis. 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.

The following details are retrieved from the SAP 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 active 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.

Related Information

Code Lists Mapping [page 77]


Code list mapping must be maintained for the fields specified in the following sections.

Utilities Contact Center Administrator Guide


334 PUBLIC S/4HANA Edition for Utilities Contact Center
2.2.5.1.3 Tickets

This 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 SAP 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.

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

2.2.5.1.5 Service Notifications

For more information, see Utilities Service Notifications.

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

For more information, see Sales POD .

2.2.5.1.7 Exceptions

For more information, see Business Partner Exception Management (BPEM)

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 335
2.2.5.1.8 Disconnection Documents

In the this screen, view the disconnected documents associated with a premise or an installation.

 Note

Documents that have no disconnection activity are not displayed.

2.2.5.1.9 Central

This tab displays cards such as Customer, Recent Tickets, and Recent Meter Readings.

You can perform the following actions:

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

2.2.5.2 Premise Object Title

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.

Utilities Contact Center Administrator Guide


336 PUBLIC S/4HANA Edition for Utilities Contact Center
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.

2.2.5.3 Configure Safety Message for Reconnect

As an administrator, you can configure a safety message to reconnect the AMI smart meter.

Go to Administrator Industry Settings Utilities Safety Message for Reconnect .

On the Safety Message for Reconnect, you can manage the message to be mandatory or optional.

Safety Message for Reconnect

If the message is set to mandatory, when you select a device to reconnect the message appears in the
Reconnect popup.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 337
2.2.6 Contract Accounts

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.

 Note

In the BAdI configuration, make sure the Bill Form and Clearing Category are defaulted in S/4HANA
pre-BADI.

Alternate Contract Account Work Center

This new work center provides you the capability to use value help search in advance search.

 Note

Collective Contract Account hyperlink is disabled in contract account work center list to improve the
performance.

Possibilities for Creating New Contract Accounts

You can create new contract accounts using:

• The Create Contract Account in the toolbar for Customers


• The Move-In (guided move-in). The guided move-in uses the master data template (MDT) and therefore
you can extend the functionality by adding new fields or removing existing ones.

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.

Utilities Contact Center Administrator Guide


338 PUBLIC S/4HANA Edition for Utilities Contact Center
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 59]
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.

Contract Account Replication [page 71]


Contract Account Replication Report: COD_UTILITIES_ACCOUNT_EXTRACT. Use this report to replicate
the contract accounts to the cloud solution.

Contract Account Delta Replication [page 73]


This document describes the configuration required to run the report
COD_UTILITIES_ACCOUNT_EXTRACT in order to fetch the delta for contract accounts.

2.2.6.1 Configure Alternate Contract Account Work Center

As an administrator, you can configure a new Contract Account Work Center with value help capabilities for
advanced search fields.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Enhancements, select the scoping question Do you want to enable the new contract account work
center with value help capabilities for advanced search fields?

2.2.6.2 Views in Contract Account

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 specifically to the selected
contract account.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 339
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.

2.2.6.2.2 Tickets

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.

 Note

If required, release the contract account field in Service Request Industry Extension BO to consume in a
custom oData service.

Utilities Contact Center Administrator Guide


340 PUBLIC S/4HANA Edition for Utilities Contact Center
2.2.6.2.3 Locks and Contracts
This screen displays all the locks related to the contract account and contract.

This screen has the following three 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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 341
Select a contract and use Actions Edit Block to edit details such as Billing Reason and Release Reason for
a contract.

Contract Locks

When you select a contract in the Contracts table, the corresponding locks for the contract are displayed in the
Contract Locks table. 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.

Utilities Contact Center Administrator Guide


342 PUBLIC S/4HANA Edition for Utilities Contact Center
2.2.6.2.4.1 Create Invoice

Create invoicing for billing documents.

Create Invoice with Meter Reading

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:

1. Click the invoice with meter reading


2. Enter the meter reading in the add meter reading table – against the item that is already defaulted (option
of changing the date is possible).
3. In the above step, specify meter readings or choose to estimate the meter reading and then submit the
meter reading.

 Note

• For AMI, the create and edit actions are disabled as the meter reading entry is captured
automatically from back end. Actions such as Estimate, Validate, Reset, and Override are not
allowed for AMI meter reading.
• View meter reading history using the History option.
• The utilities screens have been enhanced to create and change all the meter reading screens to
consider device information record.
• The Save and Override button is enabled only when the meter read is implausible(02).

4. Select a contract account in the table.


5. Click the Bill Now. Billing documents appear in the billing documents table
6. Select a valid billing document in the list.
7. Choose to first Simulate (Use this feature to view an invoice before you generate one from the billing
documents.) or directly Invoice.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 343
2.2.6.2.5 Open Items

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.

Utilities Contact Center Administrator Guide


344 PUBLIC S/4HANA Edition for Utilities Contact Center
2.2.6.2.7 Account History

This screen displays history of all financial transactions pertaining to the contract account.

For the selected line item, you can perform the Reversal action.

2.2.6.2.8 Security Deposit

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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 345
2.2.6.2.9 Collection

This screen displays the collections details pertaining to the open contract account.

The details that appear in the Collections tab are:

• 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. Write-off data provides information on a
business partner's payment history.

2.2.6.2.10 Communication Preference

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.

Utilities Contact Center Administrator Guide


346 PUBLIC S/4HANA Edition for Utilities Contact Center
Related Information

Configure Smart Energy Water [page 25]


Configure the Communication Preferences, Consumption Graph, Outage map, and Compare tabs from SAP
Cloud for Customer to integrate the Smart Energy Water (SEW) with SAP ERP system .

2.2.6.2.11 Consumption Graph

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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 347
Related Information

Configure Smart Energy Water [page 25]


Configure the Communication Preferences, Consumption Graph, Outage map, and Compare tabs from SAP
Cloud for Customer to integrate the Smart Energy Water (SEW) with SAP ERP system .

2.2.6.2.12 Billing Plans

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.

2.2.6.2.13 Payment Arrangements

View and maintain the Installment Plan, Promise to Pay pertaining to the open contract account.

Installment Plan - Create, view, or change the installment plans. With an installment plan, divide source items to
several installment receivables with 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.

Utilities Contact Center Administrator Guide


348 PUBLIC S/4HANA Edition for Utilities Contact Center
Promise to Pay - 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.

2.2.6.2.14 Central

This tab displays cards such as Recent Invoices, Last Payment, Premises, Locks, Recent Tickets, Open Items,
Customer Credit Worthiness, Security Deposit, and Dunning.

You can perform the following actions:

• To go to that particular tab, click the card title.


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

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 349
To use this feature, you need to scope the scoping question- Do you want to integrate your cloud solution
with SAP S/4HANA?

Related Information

Configure Integration of SAP Cloud for Customer with S/4 HANA [page 10]
As an administrator, you can implement the SAP S/4HANA edition for utilities solution in SAP Cloud for
Customer.

2.2.6.2.15 Outage Map

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.

Utilities Contact Center Administrator Guide


350 PUBLIC S/4HANA Edition for Utilities Contact Center
Related Information

Configure Smart Energy Water [page 25]


Configure the Communication Preferences, Consumption Graph, Outage map, and Compare tabs from SAP
Cloud for Customer to integrate the Smart Energy Water (SEW) with SAP ERP system .

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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 351
Related Information

Configure Smart Energy Water [page 25]


Configure the Communication Preferences, Consumption Graph, Outage map, and Compare tabs from SAP
Cloud for Customer to integrate the Smart Energy Water (SEW) with SAP ERP system .

2.2.6.3 Contract Account Object Title

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.

2.2.6.4 View Collective Account as a Contract Account


Object

Launch collective account as a contract account object. A Central tab with details of the collective contract
account is displayed.

Following are the tabs displayed in the contract account:

• Recent Invoices
• Child Accounts
• Recent Tickets
• Open items

Utilities Contact Center Administrator Guide


352 PUBLIC S/4HANA Edition for Utilities Contact Center
2.2.6.5 Configure Profile Setup for Contract Account with
BRF plus Rules

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.

Configure Profile Setup

1. Go to Business Configuration Overview .


2. Under Activity, search and select Utilities.
3. Select the Maintain Card and Tab to Configure Profile.

Create Profile Configuration

To create a profile configuration, follow these steps:

1. Navigate to Administrator Industry Settings and select Contract Account Profile Configuration.
2. Slide the Enable 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. Once saved, the profile ID cannot be changed.
5. Select the Visible check box for the cards and tabs from the list that you need.
The Central tab is automatically selected if any card is selected from the card list. You cannot disable the
central tab once it is selected.
Delete the cards or tabs that you don’t want for the profile. You can also add the deleted cards or tabs using
+ icon.
6. Click Save.

 Note

To save the configuration at least one profile should be marked as default.

Add rules for value determination

To add the rules for value determination, follow these steps:

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 353
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
4. Enter the Profile ID as output field.
If you make changes to your profile, you must adjust the rules accordingly.
5. Click Save.
6. 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.

2.2.7 Utilities Views in Customers


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.

Toolbar Options for Utilities

The following utilities specific options are available under Customer:

• Guided processes for Move-In, Move-Out, and Transfer.


• Object Hierarchy - Displays the complete object hierarchy for a selected contract account.
• Create Contract Account - Launches a dialog box with mandatory fields required for creating a new
contract account.
• Launch FOP - Launches the front office process that you have defined front office process in the S/4HANA
system and assigned to your utilities solution.

 Note

Utilities Contracts and Utilities Overview tabs in Customer are not available for S/4 HANA scoping.

Utilities 360 [page 355]


A 360 degree overview of the object hierarchy for all utilities objects.

Utilities Financials [page 363]


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.

Utilities Contact Center Administrator Guide


354 PUBLIC S/4HANA Edition for Utilities Contact Center
Utilities Collections [page 378]
The Utilities Collections tab displays the collection details of the selected individual customer.

Utilities Service Orders [page 381]

Utilities Rate Change [page 382]

Utilities Payment Data [page 384]


Use the Utilities Payment Data tab to view and update the bank details of an individual customer.

Utilities Owner Allocation [page 386]


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.

Utilities Service Notifications [page 386]

Utilities Addresses [page 388]


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.

Utilities Communications Data [page 392]


The Utilities Communications Data tab helps you to view independent communication address details
of a customer.

Utilities Exceptions [page 393]


Relevant BPEM cases are displayed in the Utilities Exceptions tabs in Customer and Premise,
respectively.

Utilities Switch Document [page 394]


The Utilities Switch Documenttab displays all the switch documents for the customer - irrespective of
the document status and type.

Utilities Special Account [page 395]


A special account is a type of account which as too many contract accounts, contracts, and premises
of a particular account.

2.2.7.1 Utilities 360

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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 355
 Note

• If records for business partners are more than a hundred, an icon for More is displayed.
• The number of Contract accounts/child contract accounts in hierarchy view or list view is limited to
100 by default.

Recent History

The Recent History 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, Type, Priority, Additional Info, Delete Flag, Text , 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.

During implementation, the administrators must determine the contact types from IS-Utilities to be displayed
in the cloud solution. Further, a sample business add-in implementation is available to extend this feature. The
BAdI implementation is mandatory; the contacts table is displayed empty if BAdi is not implemented.

Utilities Hierarchy

Utilities hierarchy consists of 3 views such as Configurable Hierarchy, Hierarchy view, and List view. The
features of utilities hierarchy are as follows:

• 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 any object in the hierarchy to display further details in the corresponding details screen.
For example, for a contract account, the Dunning Procedure and Payment Terms are some of the details
displayed in the details screen.
• The contract account (or collective contract) account, premise, contract, installation, and device are
displayed for each top level hierarchy node in Utilities Hierarchy.

Configurable Hierarchy View


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 as follows:

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 .

Utilities Contact Center Administrator Guide


356 PUBLIC S/4HANA Edition for Utilities Contact Center
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

You can select a configurable hierarchy view from the list for 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.

Alternate views
The list view or hierarchy view displays the utilities object structure you have created in the SAP S/4HANA
system, in your cloud solution. 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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 357
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.

The Meter Information table displays meter details such as device category, register group, AMI status, and
capabilities in the move-in and move-in of transfer processes.

Perform the following actions in the Utilities Hierarchy:

Utilities Contact Center Administrator Guide


358 PUBLIC S/4HANA Edition for Utilities Contact Center
• 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 like Utilities 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 mentioned screens of the confirmed
customer. Further, a field Confirmed Contract Account is displayed before the table with the confirmed
contract account ID. Note that this action is grayed 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.
• Search - Search for a contract account, point of delivery, and premise using this action. Note that search in
the Utilities 360 work center view performs an online search in the S/4HANA system.
• Launch FOP - After you assign FOP profile for configurable hierarchy, you can launch front office process
for a line object selected.

FOP Profile

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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 359
Utilities Contact Center Administrator Guide
360 PUBLIC S/4HANA Edition for Utilities Contact Center
You can also launch FOP by selecting any line item in the hierarchy and can also view the hierarchy details of
the objects of the selected line item passed in the URL.

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

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 361
Related Information

Utilities Contact Center Administrator Guide


362 PUBLIC S/4HANA Edition for Utilities Contact Center
2.2.7.2 Utilities Financials

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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 363
Tabs in Financials Screen

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.

Financials in Customer Views

A synchronous call to the SAP S/4 HANA IS-Utilities gets initiated for first time when 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 a 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 detailed information on the tab screens and actions that initiate a call to
IS-U.

Tab Screen Action Refresh Done on Navigation

Invoice Create Invoice, Full Reversal, Adjustment Re- Open Items


versal

Payments Cancel Payment Open Items and Invoice

Open Item Manual Posting, Deferral, Reversal Invoice

Installment Plan Create IP, Edit IP, Deactivate IP Open Items

Payment Plan Create PP, Edit PP, Deactivate PP Open Items

Budget Billing Create, Edit Open Items

Promise to Pay Create, Replace, Reactivate, Withdraw Open Items

One Time Payment Payment and Open Items

Bill Correction [page 365]


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.

Create Invoice [page 367]

Utilities Contact Center Administrator Guide


364 PUBLIC S/4HANA Edition for Utilities Contact Center
Create invoicing for billing documents.

Bill and Invoice [page 368]


Create billing documents and invoices for a valid meter reading.

Payments [page 368]

One Time Payment [page 369]


Use the Utilities Financials tab of an individual customer to make a one time payment with the existing
or new bank account.

Document Locks [page 370]

Installment Plans [page 371]

Invoice Document [page 372]


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.

Payment Plans [page 372]


From the Payment Plans tab in the Financials screen, you can create, edit, display, delete, and
deactivate payment plans.

Budget Billing Plan [page 373]


In Utilities Financials, for a valid contract, you can create, edit, and delete a budget billing plan.

Contracts with Meter Reading [page 373]


Create and update meter readings in this section. On selection of a contract in the table for Contracts,
the meter reading table lists the corresponding values of existing meter reading.

Open Items [page 375]


Create manual posting, promise-to-pay, deferal, and reversal for the open items.

2.2.7.2.1 Bill Correction


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.

2.2.7.2.1.1 Adjustment Reversal and Full Reversal


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

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 365
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.

 Note

The Save and Override button is enabled only when the meter read is implausible(02).

6. Save the meter reading.


7. Click Rebill.

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.

 Note

The Save and Override button is enabled only when the meter read is implausible(02).

6. Save the meter reading.

Utilities Contact Center Administrator Guide


366 PUBLIC S/4HANA Edition for Utilities Contact Center
2.2.7.2.1.2 Rebill

Use the Rebill feature to update incorrect meter readings.

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 .

2.2.7.2.2 Create Invoice

Create invoicing for billing documents.

Create Invoice with Meter Reading

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:

1. Click the invoice with meter reading


2. Enter the meter reading in the add meter reading table – against the item that is already defaulted (option
of changing the date is possible).
3. In the above step, specify meter readings or choose to estimate the meter reading and then submit the
meter reading.

 Note

• For AMI, the create and edit actions are disabled as the meter reading entry is captured
automatically from back end. Actions such as Estimate, Validate, Reset, and Override are not
allowed for AMI meter reading.
• View meter reading history using the History option.
• The utilities screens have been enhanced to create and change all the meter reading screens to
consider device information record.
• The Save and Override button is enabled only when the meter read is implausible(02).

4. Select a contract account in the table.


5. Click the Bill Now. Billing documents appear in the billing documents table
6. Select a valid billing document in the list.
7. Choose to first Simulate (Use this feature to view an invoice before you generate one from the billing
documents.) or directly Invoice.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 367
2.2.7.2.3 Bill and Invoice

Create billing documents and invoices for a valid meter reading.

The Bill and Invoice tab 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 theInvoice 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 meter reading reasons are available for Bill and Invoice: 01 - Periodic Meter Reading
and 02 - Interim Meter Reading with Billing.
• For Create Invoice, Override button is disabled until you clicks on the validate button.
• The Save and Override button is enabled only when the meter read is implausible(02).

2.2.7.2.4 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:

• Payment Document No.


• Posting Date
• Amount Paid
This shows the header payment line items indicating the total payment made on a particular day against
the customer.
• Payment Origin
• External Contract Account
• Cleared Amount
These items indicate partial or complete payments cleared against the open items in the contract account.
• Description

Utilities Contact Center Administrator Guide


368 PUBLIC S/4HANA Edition for Utilities Contact Center
2.2.7.2.5 One Time 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, seeEnable or Disable Fields or Actions .

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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 369
 Note

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.

2.2.7.2.6 Document Locks

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.

Utilities Contact Center Administrator Guide


370 PUBLIC S/4HANA Edition for Utilities Contact Center
Edit and Delete Locks

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.

2.2.7.2.7 Installment Plans

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.

Create Installment Plan

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.

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

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 371
Cancel Installment Plan

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.

2.2.7.2.8 Invoice Document

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.

2.2.7.2.9 Payment Plans

From the Payment Plans tab in the Financials screen, you can create, edit, display, delete, 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, Delete, 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 S/4HANA IS-Utilities solution also apply in the
utilities cloud solution.

It is now possible to choose the payment plan type during the creation of payment plan using scoping.

Perform download/upload of auto code list mapping for payment plan type. Auto code list would be available
from the fine tuning- Maintain Plan type automatically. In create payment plan, a drop down appears and show
the payment plan values that has category 1.

Deactivating a Payment Plan

When you confirm deactivation for a payment plan, the system performs displays the confirmation message
and performs the following actions:

Utilities Contact Center Administrator Guide


372 PUBLIC S/4HANA Edition for Utilities Contact Center
• 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 SAP S/4HANA system.
• Displays the Deactivated status icon for the status field.
• Displays the deactivation date.

2.2.7.2.10 Budget Billing Plan

In Utilities Financials, for a valid contract, you can create, edit, and delete a budget billing plan.

Create Budget Billing Plan

1. Under Utilities Financials Budget Billing Plan , click New to create a new budget billing plan.
2. In the Create Budget Billing Plan dialog, the Contract Account Ext. ID is selected by default from the Utilities
financial screen and the Budget Billing period is set to the current date.
3. Select a contract account, to view the details of Contracts.
4. Select one or more contracts from the list for which you want to create a budget billing plan and click Next.
5. Enter the data in the Text for Budget Billing field.
6. Optional: If necessary, change the due date and plan amount for each line item. You can also use the
Update Amount action to update the changes for all the plan amount in the Items list.
7. Click Create.

After the plan is created, it's displayed in the Budget Billing Plan section.

You can modify/edit thePlan Amount and Text for Budget Billing for a budget billing plan by selecting the Edit
option.

To edit the existing plans, Plan Amount and Text for Budget Billing, select the budget billing plan and click Edit.

To delete the existing plan, select the budget billing plan and click Delete. Note that the deletion happens only
when there are no payments or further activities for the plan.

2.2.7.2.11 Contracts with Meter Reading

Create and update meter readings in this section. On selection of a contract in the table for Contracts, the
meter reading table lists the corresponding values of existing meter reading.

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 need to specify the meter reading type, date, and choose a meter reading
note type. On saving your entries, a confirmation message is displayed in the cloud solution and the system
updates the corresponding meter readings in the SAP S/4HANA system.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 373
 Note

• Meter reading isn't mandatory for move-in, move-out, and transfer. You can create move-in, move-out,
and transfer without specifying meter readings.
• During create/edit meter reading, if the meter reading types are 03- Automatic estimation or 04-
Meter reading interpolatedthen when you enter the meter reading manually the type changes to 01-
Meter reading by utility company automatically.
• For AMI, meter reading entry captured automatically from the back end and system disables the create
and edit actions. Actions such as Estimate, Validate, Reset, and Override are not allowed for AMI
meter reading.
• Using the auto code list mapping, the system updates all the field help values such as meter reading
note type, reason, and meter reading type. See Related Information section for the topic Code Lists
Mapping.
• Meter Reading Reason and Note defaults by implementing the post badi for FM
ISU_C4C_VALUE_HELP in the SAP S/4HANA system.

Interim Meter Reading

You can now enter or estimate an interim meter reading with or without billing. Specify the appropriate meter
reading reason and type.

Meter Reading Estimate, Override, and Reset

Additional features for meter reading: If you enter an incorrect meter reading (meter reading not in the
expected range), the system considers the meter reading as Implausible. Also the system considers any meter
reads in processing status 2 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.

Meter Reading Order

The meter reading table displays a combination of meter reading result, 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 Meter Reading 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 Connection Details tab in the
Premise work center.

Utilities Contact Center Administrator Guide


374 PUBLIC S/4HANA Edition for Utilities Contact 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’s possible to add new meter readings and edit the line item.
• A grayed out check mark indicates the meter reading has already recorded for the order. It’s possible to
create new meter reading only for the following meter reading reasons: 02- Interim meter reading with
billing, 09-Interim meter reading without billing, and 10-Control Reading.
• 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 maintained, edit isn’t possible for meter reading status Billed.

Related Information

Code Lists Mapping [page 77]


Code list mapping must be maintained for the fields specified in the following sections.

2.2.7.2.12 Open Items

Create manual posting, promise-to-pay, deferal, and reversal for the open items.

2.2.7.2.12.1 Manual Posting

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

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 375
Create Promise-to-Pay

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

Actions - Change, Reactivate, Replace and Withdraw

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

Utilities Contact Center Administrator Guide


376 PUBLIC S/4HANA Edition for Utilities Contact Center
2.2.7.2.12.3 Reverse Open Items

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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 377
2.2.7.2.12.4 Defer Open Items

Use Deferral to defer open items. You can select multiple open items for deferral.

2.2.7.3 Utilities Collections

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.

Utilities Contact Center Administrator Guide


378 PUBLIC S/4HANA Edition for Utilities Contact Center
The tables that appear on the Utilities Collections tab are as follows:

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

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 379
• Returns
• Write-offs
• Security Deposit - Allows you to reverse or release a security deposit.

Utilities Contact Center Administrator Guide


380 PUBLIC S/4HANA Edition for Utilities Contact Center
2.2.7.4 Utilities Service Orders

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 Service Orders

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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 381
Add additional notes to your service order descriptions 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.

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.

Change Service Orders

You can only change the start and end date & time for a service order using the menu option Actions
Change Service Order .

Cancel Service Orders

To cancel a service order, you need to invalidate the start and end date & time accordingly using Actions
Cancel Service Order
.

2.2.7.5 Utilities Rate Change

View the current rate category and billing parameters for a customer's contract in the Utilities Rate Change
work center view under Customers. In this work center view, choose a contract and click on Rate Change to:

• Modify the rate category using selection help on the field Proposed Rate. The selection help takes the date
from the Valid From option. The rate categories pertaining to the date passed is displayed as the result.
• 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 following parameters/operands are not supported: Operand categories TQUANT,


REFVALUE, SEASON, RATE TYPE.

Utilities Contact Center Administrator Guide


382 PUBLIC S/4HANA Edition for Utilities Contact Center
• During edit rate category, the system does not restrict the change based on the last billing
date.

Simulate Rate Changes

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; choose a rate category as the
Proposed Rate Category for future dates.

2.2.7.5.1 Rate Change using MDT

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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 383
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?

Further, in the S/4HANA implementation guide (IMG) customizing for MDT template, maintain the required
configuration under SAP Utilities Cloud for Customer Utilities Configure MDT Template . See related
links section for detailed information.

Related Information

MDT Templates for Move-In, Customer, Contract Account & Rate Change Using Guided Processes [page 59]
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.

2.2.7.6 Utilities Payment Data

Use the Utilities Payment Data tab to view and update the bank details of an individual customer.

The Bank Data table displays the bank details of the contract account. The Contract Account Payment Method
table displays the payment details of the contract account.

Utilities Contact Center Administrator Guide


384 PUBLIC S/4HANA Edition for Utilities Contact Center
The New button on the Bank Data table allows you to create new bank details. You can use either the Bank
Details or the IBAN option to create new bank details for Contract Account.

When you select the Bank Details option, the system displays the Country/Region, Bank Key, Bank Account,
Bank Name, Account Holder, SWIFT Code, and IBAN fields. Enter all the fields and click Save.

When you select the IBAN option, the system displays the IBAN, Country/Region, Bank Key, and Bank Account
fields. If you do not know the bank account, you can toggle the Account Number Unknown button to hide the
field.

Enter the IBAN number and click Generate. The system auto-populates the other fields. Click Save to store the
details against the Business Partner.

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 New and Edit buttons in the Bank Data section can be controlled from the business actions. For
more information about business actions, see Enable or Disable Fields or Actions.
• You can enter the IBAN details in text or country/region format for customer. This IBAN detail can be
converted to country/region format from text format or vice versa.
• 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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 385
 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.

2.2.7.7 Utilities Owner Allocation

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.

2.2.7.8 Utilities Service Notifications

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.

Utilities Contact Center Administrator Guide


386 PUBLIC S/4HANA Edition for Utilities Contact Center
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
• 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

Administrators can configure notification types. Go to Business Configuration Implementation Projects


Your Project Open Activity List Utilities Maintain Notification Type .

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

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 387
2.2.7.9 Utilities Addresses

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.

Utilities Contact Center Administrator Guide


388 PUBLIC S/4HANA Edition for Utilities Contact Center
You can filter the addresses based on their usage types, using the advance search option provided on the All
Addresses table.

You can also view the corresponding usage types of the address selected along with the validity dates in the
Address Usages table.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 389
2.2.7.9.1 View Address Details of 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.

Utilities Contact Center Administrator Guide


390 PUBLIC S/4HANA Edition for Utilities Contact Center
You can now filter the addresses based on their usage types, using the advance search option provided on the
All Addresses table.

You can also view the corresponding usage types of the address selected along with the validity dates in the
Address Usages table.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 391
2.2.7.10 Utilities Communications Data

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:

• Preferred: Displays the preferred field of the customer communictaion data


• Phone Numbers: Search for phone numbers using basic or advance search parameters such as a phone
number.
• Emails: Search for emails using basic or advance search parameters such as an email address.

Create and Edit Address Independent Communication Information

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.

The validtaions provided for this are as follows:

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

Utilities Contact Center Administrator Guide


392 PUBLIC S/4HANA Edition for Utilities Contact Center
2.2.7.10.1 Configure Utilities Communication Data

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 . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and
under Utilities Enhancements, select the scoping question Is Time Dependency for BP Independent Address
Communication data enabled in ISU?

2.2.7.11 Utilities Exceptions

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

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 393
Related Information

Business Partner Exception Management (BPEM) - Integration with SAP ERP or SAP S/4HANA System [page
185]
Configure the Business Partner Exception Management in your SAP Cloud for Customer.

2.2.7.12 Utilities Switch Document

The Utilities Switch Documenttab displays all the switch documents for the customer - irrespective of the
document status and type.

Utilities Contact Center Administrator Guide


394 PUBLIC S/4HANA Edition for Utilities Contact Center
2.2.7.13 Utilities Special Account

A special account is a type of account which as too many contract accounts, contracts, and premises of a
particular account.

Once account is considered as special account via IMG activity, a Special Account flag is set in the Cloud for
Customer screen. It enabled with the new tabs such as Overview, Utilities Premises, Utilities Contract Accounts.

2.2.7.13.1 Overview

This screen displays the Contract Accounts, Premise, and Collective Contract Accounts cards.

The number in the card indicates the number of accounts. Click the card title to navigate to that respective
tabs.

2.2.7.13.2 Utilities Contract Account

This screen displays all the details of utilities contract accounts and collective contract account.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 395
2.2.7.13.3 Utilities Premises

This screen displays all the premise for that corresponding special account.

2.2.8 Sales POD

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

How you can Use Sales POD

You can

• Create and edit new sales PODs


• Import and export a list of sales PODs
• Group a set of sales PODs and assign values to them
• Use Batch IDs for Sales PODs that can help identify an imported list of PODs or help to set attributes for a
group of PODs.
• Specify validity for sales PODs. Only those sales PODs that are set to Released and that are valid on current
date, are considered for the enrollment process.

Creating a Sales POD

Enter the following details to create a sales POD:

Utilities Contact Center Administrator Guide


396 PUBLIC S/4HANA Edition for Utilities Contact Center
• Select a POD for Type
• Select a Premise for Premise ID
• Set flag for Deregulation POD and Technical POD
• Enter the Address fields such as House Number, City, State, and so on.

 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 Address Type Ahead Search

Grouping Sales PODs

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.

Delete Sales PoD and Grouping Information

In the Sales POD screen of Utilities view you can delete the Sales PoD, if the status is not set to Released.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 397
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.

2.2.8.1 Utilities Enrollment

Guided process for creating a utilities specific quote.

 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

Utilities Contact Center Administrator Guide


398 PUBLIC S/4HANA Edition for Utilities Contact Center
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 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.

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

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 399
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.

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

Enrollment - Configure Switch Document Creation and Notification [page 62]


Detailed information for creating switch document in the cloud solution.

Utilities Contact Center Administrator Guide


400 PUBLIC S/4HANA Edition for Utilities Contact Center
2.2.8.1.1 Integration with Enrollment Process

Business Benefits

With the integration of sales POD (Point of Delivery) with sales quote, you can:

• Search for sales POD when creating a quote.


• Select and submit sales POD in quote.
• Set the release flag for the new sales POD. This updates the status of the sales POD to Released.
• Trigger creation of switch document in IS-Utilities using the sales POD information.

How the Integration Works

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.

 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 SAP Cloud for Customer with
corresponding ISU POD ID.

2.2.9 Front Office Process

Configure the Front Office Process in your SAP Cloud for Customer.

Launch the front office processes that you have configured in your 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 utilities solution profile. For more information, see Configuring Front Office Process.

2.2.9.1 Configure 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 .

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 401
For more information on configuring front office processes, see the following topics:

• Assign Front Office Processes [page 60]


• Configure Mashup for Front Office Process (FOP) [page 85]

2.2.10 Master Data Template-Based Processes

Configure the Master Data Template (MDT) process in your SAP Cloud for Customer to create guided move-in
and guided transfer.

2.2.10.1 Move-In using MDT

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
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 do adaption 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 59]

2.2.10.2 Move-In in Transfer using MDT

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.

Utilities Contact Center Administrator Guide


402 PUBLIC S/4HANA Edition for Utilities Contact Center
 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 59]

Related Information

MDT Templates for Move-In, Customer, Contract Account & Rate Change Using Guided Processes [page 59]
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.

2.2.10.3 Rate Change using MDT

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?

Further, in the S/4HANA implementation guide (IMG) customizing for MDT template, maintain the required
configuration under SAP Utilities Cloud for Customer Utilities Configure MDT Template . See related
links section for detailed information.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 403
Related Information

MDT Templates for Move-In, Customer, Contract Account & Rate Change Using Guided Processes [page 59]
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.

2.2.10.4 Create Customer Using MDT

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 59]

2.2.10.5 Create Contract Account Using MDT

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.

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 59]

Edit Cotract Account

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.

2.2.10.6 Different Master Data Template for Move Processes

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.

Utilities Contact Center Administrator Guide


404 PUBLIC S/4HANA Edition for Utilities Contact Center
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.

2.2.10.7 MDT Templates for Move-In, Customer, Contract


Account and Rate Change Using Guided Processes
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:

• Create an MDT template using transaction code EPRODCUST.


• Assign the MDT template to IMG activity Configure MDT Template under IMG for SAP S/4HANA SAP
Utilities 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:

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 405
• 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.

2.2.11 Account Executive Dashboard

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.

2.2.11.1 Service Orders

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.

Utilities Contact Center Administrator Guide


406 PUBLIC S/4HANA Edition for Utilities Contact Center
2.2.11.2 Exceptions
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.

2.2.12 Business Partner Exception Management (BPEM) -


Integration with SAP ERP or SAP S/4HANA System
Configure the Business Partner Exception Management in your SAP Cloud for Customer.

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

Maintain the following configuration:

• Define the required case categories in the fine-tuning 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 .

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 407
• Do you want to delegate service tickets from your cloud solution to an external application under
Business Configuration Implementation Projects Your Project Edit Project Scope Questions
Communication and Informaiton Exchange Integration with External Applications Integration with Sales,
Service and Marketing Processes Service Tickets . This service sends the BPEM case ID created to
cloud solution to update in the document flow. This is a confirmation message from SAP ERP or SAP
S/4HANA system to your cloud solution informing that a BPEM case is created.

For more information, see Business Process Exception Management (BPEM).

BPEM Primary Object Validation

As a part of BPEM fine-tuning you can now configure your own clarification case categories by setting the
primary object type in the SAP ERP or SAP S/4HANA system and maintain the same case category in
SAP Cloud for Customer fine-tuning under Business Configuration Overview Utilities Case Category
Maintain Case Category .

 Note

This fine-tuning is not supported for Auto Code List.

The validation takes place as per the primary object type maintained in SAP Cloud for Customer and is skipped
even if it is maintained in SAP ERP or SAP S/4HANA System.

2.2.12.1 Configure Replication of BPEM Status

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.

Navigate to Administrator General Settings Integration Communication Scenarios . Select Industry


Service Request Replication to External System and configure Replicate BPEM Status for the corresponding
SAP Cloud Integration content.

Utilities Contact Center Administrator Guide


408 PUBLIC S/4HANA Edition for Utilities Contact Center
The following table describes the BPEM case status:

Status Code Status Value

1 New

2 In Process

3 Completed

4 Canceled

6 Confirmed

The following table describes the SAP Cloud for Customer case status:

Status Code Status Value

1 Open

2 In Process

4 Customer Action

5 Completed

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 409
Status Code Status Value

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:

• In the CHANGED event of the business partner, enter 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

2.2.12.2 Service Ticket

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

Utilities Contact Center Administrator Guide


410 PUBLIC S/4HANA Edition for Utilities Contact Center
using the hyperlinks.

In addition to this you can also view the details of premise address under the Utilities - Premise Address section
group.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 411
Service Location Field in Ticket

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.

2.2.13 Audit Trail Logs in S/4HANA System

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.

Audit Log New Design

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.

Utilities Contact Center Administrator Guide


412 PUBLIC S/4HANA Edition for Utilities Contact Center
2.2.14 Depersonalization in Contract Account and Sales POD

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.

2.2.15 Appendix with List of Relevant S/4HANA Transactions

List of Valid Meter Reading Reasons and Statuses

List of Valid Meter Reading Reasons

Meter Reading Reason ID Description

01 Periodic Meter Reading

02 Interim meter reading with billing

03 Final meter reading at move-in/out

04 Certification meter reading

05 Service territory transfer with billing

06 Meter reading at move-in

07 Service territory transfer w/o billing

08 Meter reading upon technical inst.

09 Interim Meter Reading Without Billing

10 Control Reading

11 Meter Reading after program/adjustment

12 Meter reading at technical removal

13 Meter reading on disconnection

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 413
Meter Reading Reason ID Description

14 Automatically calculated for proration

15 Stock transfer meter reading

16 Meter reading before program/adjustment

17 Reading for change of inst. Structure

18 Reconnection meter reading

19 Delivery meter reading

20 Device inspection meter reading

21 Meter reading at billing-rel. inst.

22 Meter reading at billing-rel. removal

23 Single reading for device modification

24 Replacement upon installation

25 Replacement upon removal

26 Contract change

27 Customer Change

28 Reading before change to log. reg. no.

29 Reading after change to log. reg. no.

90 Start of simulation

91 End of simulation

List of Valid Meter Reading Statuses

Meter Reading Status ID Description

0 Meter reading order created

1 Billable

2 Automatically Locked

3 Locked by Agent

4 Released by Agent

5 Checked Independently

7 Billed

* Partially Billed

Important S/4HANA IS-U Transactions for Meter Reading

Transaction Code Function

EL01 Create individual MR order

EL27 List of implausible MR results

Utilities Contact Center Administrator Guide


414 PUBLIC S/4HANA Edition for Utilities Contact Center
Transaction Code Function

EL28 Enter single MR result

EL29 List of plausible MR results

EL30 Meter reading result estimation

EL37 Reverse meter reads

EL31 Monitoring (MR results, billing orders)

Important S/4HANA IS-U Transactions for Move-In

Transaction Function

EC50E Create Move-In

EC51E Change Move-In

EC52E Display Move-In

EC53E Reverse Move-IN

Important S/4HANA IS-U Transactions for Move-Out

Important S/4HANA IS-U Transactions for Move-Out

Transaction Function

EC55E Create Move-Out

EC56E Change Move-Out

EC57E Display Move-Out

EC58E Reverse Move-Out

2.3 Extensibility

You can extend both the UI screens and 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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 415
 Note

You can’t add an extension field with default value for Utilities Contact Center. Recommended to use PDI for
fields extension for Utilities screens.

2.3.1 Functional Extensions Using Business Add-Ins

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

• Move-In in Move-In Guided Application Framework (GAF)


• Move-In in Transfer GAF
• Create Contract Account in Move-In GAF, Transfer GAF and Customer/Account work center view
• Edit Contract Account in Contract Account work center view
• Create Customer in Move-In GAF and Transfer GAF

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

2.3.1.1 Contract Accounts

Overview of business add-ins that exist for contract accounts.

Contract Account - Contracts and Blocks

Business Add-In: Contract Account - Contracts and Blocks

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesContractBlocks UtilitiesExtensibility http:// UtilitiesContractsBA- UtilitiesContractsBA-


sap.com/xi/AP/CRM/ DIInput DIResult
Global

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

Utilities Contact Center Administrator Guide


416 PUBLIC S/4HANA Edition for Utilities Contact Center
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.

Utilities Contract Account Locks Actions

Business Add-In: Utilities Contract Account Locks Actions

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesContractAc- UtilitiesExtensibility http:// UtilitiesCALocksModi- UtilitiesContractAc-


sap.com/xi/AP/CRM/ fyBadiInput countLocksActionBA-
countLocksActions
Global DIResult

Utilities Contract Account Contract Locks Actions

Business Add-In: Utilities Contract Account Contract Locks Actions

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesContractAc- UtilitiesExtensibility http:// UtilitiesCAContracts- UtilitiesCAContractAc-


sap.com/xi/AP/CRM/ ModifyBadiInput tionsBadiResult
countContractLock-
Global
sAction

Utilities Contract Account Details

Business Add-In: Utilities Contract Account Details

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesContractAc- UtilitiesExtensibility http:// UtilitiesContractAc- UtilitiesContractAc-


sap.com/xi/AP/CRM/ countFetchBADIInput countBadiResult
countDetails
Global

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 417
Utilities Contract Account Locks

Business Add-In: Utilities Contract Account Locks

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesContractAc- UtilitiesExtensibility http:// ContractAccountExe- UtilitiesContractAc-


sap.com/xi/AP/CRM/ cuteLocksBADI countLocksBADIResult
countLocks
Global

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

Utilities Contract and Locks

Business Add-In: Utilities Contract and Locks

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesContractLocks UtilitiesExtensibility http:// ContractExecute- UtilitiesContractLocks-


sap.com/xi/AP/CRM/ LocksBADI BADIResult
Global

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

Utilities Contact Center Administrator Guide


418 PUBLIC S/4HANA Edition for Utilities Contact Center
2.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.

Business Add-In: . BADI_UTIL_FIN_ACC_OVERVIEW

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesFinancialAc- UtilitiesExtensibility http:// UtilitiesFinancialOver- UtilitiesFinancialOver-


sap.com/xi/AP/CRM/ viewRequestBADIInput viewBadiResult
countOverview
Global

Utilities Financials Full Reversal

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.

Business Add-In: Utilities Financials Full Reversal

Enhancement Imple-
mentation Business Object Namespace Input Parameters Output Parameters

UtilitiesFullReversal UtilitiesExtensibility http:// UtilitiesFinancialsOver- UtilitiesFinancialsOver-


sap.com/xi/AP/CRM/ viewBadiInput viewBadiInput
Global

New structure ExecuteService has been introduced in the input parameter


UtilitiesFinancialsOverviewBadiInput. This structure has the following indicator flag:

• InvoiceNow
• BillNow
• InvoiceSimulation
• SubmitMR
• InvoiceMR
• BillAndInvoice
• FullReversal
• AdjustmentReversal

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 419
• 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.

Utilities Financials Adjustment Reversal

Business Add-In: Utilities Financials Adjustment Reversal

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesAdjustmentRe- UtilitiesExtensibility http:// UtilitiesFinancialsOver- UtilitiesFinancialsOver-


sap.com/xi/AP/CRM/ viewBadiInput viewBadiInput
versal
Global

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.

New structure ExecuteService has been introduced in the input parameter


UtilitiesFinancialsOverviewBadiInput. This structure has the following indicator flag:

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

Utilities Contact Center Administrator Guide


420 PUBLIC S/4HANA Edition for Utilities Contact Center
Utilities Financials Pre-Adjustment Reversal

Business Add-In: Utilities Financials Pre-Adjustment Reversal

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesPreAdjustmen- UtilitiesExtensibility http:// UtilitiesFinancialsOver- UtilitiesFinancialsOver-


sap.com/xi/AP/CRM/ viewBadiInput viewBadiInput
tReversal
Global

Use this BAdI exit for an approach for pre-adjustment validations and controlling the modal dialog. Note that
the appropriate messages must be created through the output message structures.

New element in the structure ExecuteService has been introduced in the input parameter
UtilitiesFinancialsOverviewBadiInput. This new element in the structure has the OpenAdjustmentRevPopUp
indicator flag:

If this Enhancement Implementation is created, all the messages are captured for both the scenarios:

• If the flag is set to 'True', then the Modal Dialog opens.


• If the flag is set to 'False', then the Modal Dialog won't open.

Utilities Financials Get Meter Reading

Business Add-In: Utilities Financials Get Meter Reading

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesFinancialGet- UtilitiesExtensibility http:// UtilitiesFinancialGet- UtiltiesFinGetMRBA-


sap.com/xi/AP/CRM/ MeterReadingBADIRe- DIResult
MeterReading
Global sult

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.

Utilities Financials Rebill After Bill Reversal

Business Add-In: Utilities Financials Rebill After Bill Reversal

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesFinancialRebill UtilitiesExtensibility http:// UtilitiesFinancialsOver- UtilitiesFinancialsOver-


sap.com/xi/AP/CRM/ viewBadiInput viewBadiInput
Global

Use this BAdI exit for an alternative approach to the rebill function. The appropriate messages have to be
provided through the output structures.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 421
New structure ExecuteService has been introduced in the input parameter
UtilitiesFinancialsOverviewBadiInput. This structure has the following indicator flag:

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

Utilities Financials Update Meter Reading

Business Add-In: Utilities Financials Update Meter Reading

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesFinancialMeter- UtilitiesExtensibility http:// UtiltiesFinGetMRBA- UtilitiesFinancialsBa-


sap.com/xi/AP/CRM/ DIResult
ReadingUpdate diInput
Global

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.

Utilities Financial Meter Reading Estimate

Business Add-In: Utilities Financial Meter Reading Estimate

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesFinancialMeter- UtilitiesExtensibility http:// UtiltiesFinGetMRBA- UtiltiesFinGetMRBA-


sap.com/xi/AP/CRM/ DIResult DIResult
ReadingEstimate
Global

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.

Utilities Contact Center Administrator Guide


422 PUBLIC S/4HANA Edition for Utilities Contact Center
Utilities Financial Meter Reading Override

Business Add-In: Utilities Financial Meter Reading Override

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesFinancialMeter- UtilitiesExtensibility http:// UtiltiesFinGetMRBA- UtilitiesFinancialsBa-


sap.com/xi/AP/CRM/ DIResult diInput
ReadingOverride
Global

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.

Utilities Financials Locks

Business Add-In: Utilities Financials Locks

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesFinancialLocks UtilitiesExtensibility http:// UilitiesFinancialLocks- UtilitiesFinancialLock-


sap.com/xi/AP/CRM/ DisplayBadiInput BadiResult
Global

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

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 423
Utilities Financial Create Locks

Business Add-In: Utilities Financial Create Locks

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesFinancialCrea- UtilitiesExtensibility http:// UtilitiesFinancialCrea- UtilitiesFinancialCrea-


sap.com/xi/AP/CRM/ teLocksBadiInput teLockBadiResult
teLocks
Global

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.

New structure ExecuteService has been introduced in the input parameter


UtilitiesFinancialCreateLockBadiResult. This structure has the following indicator flag:

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

Utilities Financial Edit Locks

Business Add-In: Utilities Financial Edit Locks

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesFinancialEdit- UtilitiesExtensibility http:// UtilitiesFinancialEdi- UtilitiesFinancialEdi-


sap.com/xi/AP/CRM/ tLockBadiInput tLocksBadiResult
Locks
Global

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.

New structure ExecuteService has been introduced in the input parameter


UtilitiesFinancialEditLocksBadiResult. This structure has the following indicator flag:

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

Utilities Contact Center Administrator Guide


424 PUBLIC S/4HANA Edition for Utilities Contact Center
Utilities Financial Delete Locks

Business Add-In: Utilities Financial Delete Locks

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesFinancialDele- UtilitiesExtensibility http:// UtilitiesFinancialDele- UtilitiesFinancialDelte-


sap.com/xi/AP/CRM/ teLocksBadiInput LocksResult
teLocks
Global

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

Utilities Dunning History

Business Add-In: UtilitiesDunningHistory

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesDunningHis- UtilitiesExtensibility http:// UtilitiesServiceDun- UtilitiesServiceDun-


sap.com/xi/AP/CRM/ ningHistoryBadiInput ningHistoryBadiInput
tory
Global

Utilities Installment Plan

Business Add-In: Utilities Installment Plan Badi

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesInstallment- UtilitiesExtensibility http:// UtilitiesInstallment- UtilitiesInstallment-


Plan sap.com/xi/AP/CRM/ PlanBadiInput PlanBadiInput
Global

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

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 425
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:

• Simulate Installment Plan-1 (Action code)


• Create Installment Plan - 2 (Action code)
• Change Installment Plan - 3 (Action code)
• Cancel Installment Plan - 4 (Action code)

The flag ExecuteServiceIndicator has been introduced in the input parameter


UtilitiesInstallmentPlanBadiInput. This flag has the following components:

• 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 of Utilities Create Billing

Business Add-In: Enhancement of Utilities Create Billing

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesCreateBilling UtilitiesExtensibility http:// UtilitiesFinancialOver- UtilitiesFinancialCrea-


sap.com/xi/AP/CRM/ view teBillingBADIResult
Global

Create Bill Actions

Business Add-In: Create Bill Actions

Enhancement Imple-
mentation Business Object Namespace Input Parameters Output Parameters

UtilitiesCreateBillin- UtilitiesExtensibility http:// UtilitiesFinancialCrea- UtilitiesFinancialCrea-


gActions sap.com/xi/AP/CRM/ teBillingBADIResult teBillingActionsBADIR-
Global esult

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:

• Invoice Now - 03 (Action code)

Utilities Contact Center Administrator Guide


426 PUBLIC S/4HANA Edition for Utilities Contact Center
• Bill Now - 02 (Action code)
• Submit Meter Reading - 01 (Action code)
• Invoice Simulation - 04 (Action code)
• Bill and Invoice -05 (Action Code)
• Invoice Now Mr – 06 (Action Code)

The flag ExecuteServiceIndicator has been introduced in the output parameter


UtilitiesFinancialCreateBillingActionsBADIResult. This flag has the following components for all above 6 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.

Utilities Budget Billing Overview

Business Add-In: Budget Billing Overview

Enhancement Imple-
mentation Business Object Namespace Input Parameters Output Parameters

UtilitiesBudgetBillin- UtilitiesExtensibility http:// UtilitiesBudgetBilling- UtilitiesBudBillBadiRe-


gOverview sap.com/xi/AP/CRM/ FetchBAdIInput sult
Global

Utilities Budget Billing Actions

Business Add-In: Utilities Budget Billing Actions (Simulate,Create,Edit,Deactivate)

Enhancement Imple-
mentation Business Object Namespace Input Parameters Output Parameters

UtilitiesBudgetBillin- UtilitiesExtensibility http:// UtilitiesBudgetBillin- UtilitiesBudgetBillin-


gActions sap.com/xi/AP/CRM/ gActionBadiInput gActionBadiResult
Global

The following components are introduced in ‘UtillitiesBudgetBillingCurrentAction’ parameter of Input


Parameter UtilitiesBudgetBillingActionBadiInput, to give details about Custom Action.

• CustomAction : flag
• ActionName : Text field

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 427
Utilities Financial Actions

Business Add-In: UtilitiesFinancialActionsBADI

Enhancement Imple-
mentation Business Object Namespace Input Parameters Output Parameters

UtilitiesFinancialAc- UtilitiesExtensibility http:// UtilitiesFinancialAc- UtilitiesFinancialAc-


tionsBADI sap.com/xi/AP/CRM/ tionsBADiInput tionsBadiResult
Global

Structure UtilitiesInvoices have been introduced in the input parameter UtilitiesFinancialActionsBADiInput and
output parameter UtilitiesFinancialActionsBadiResult.

The following components are introduced in ‘CurrentAction’ parameter of Input Parameter


UtilitiesFinancialActionsBADiInput, to give details about Custom Action.

• 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

Business Add-In: UtilitiesPremise

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesPremise UtilitiesExtensibility http:// UtilitiesPremiseFetch- UtilitiesPremiseBadiR-


sap.com/xi/AP/CRM/ BAdIInput esult
Global

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:

• Customer History (UtilitiesPremiseCustomerHistory)


• Highlights (UtilitiesPremiseHighlights)
• Object Hierarchy (UtilitiesPremiseObjectHierarchy)
• Installation (UtilitiesPremiseObjectHierarchyInstallationDetails)
• Meter Reading (UtilitiesPremiseObjectHierarchyMeterReadingDetails)

Utilities Contact Center Administrator Guide


428 PUBLIC S/4HANA Edition for Utilities Contact Center
 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:

Type Code Object

1 Installation / Point of Delivery

2 Device

UtilitiesPremiseCancelMoveInMoveOut

Business Add-In: . UtilitiesPremiseCancelMoveInMoveOut

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesPremiseCan- UtilitiesExtensibility http:// UtilitiesPremiseBadiIn- UtilitiesPremiseBadiR-


celMoveInMoveOut sap.com/xi/AP/CRM/ put esult
Global

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

Business Add-In: UtilitiesPremiseEditMoveInMoveOut

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesPremiseEdit- UtilitiesExtensibility http:// UtilitiesPremiseBadiIn- UtilitiesPremiseBadiR-


MoveInMoveOut sap.com/xi/AP/CRM/ put esult
Global

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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 429
 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.

UtilitiesPremiseMoveIn

Business Add-In: UtilitiesPremiseMoveIn

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesPremiseMoveIn UtilitiesExtensibility http:// UtilitiesPremiseBadiIn- UtilitiesPremiseBadiR-


sap.com/xi/AP/CRM/ put esult
Global

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

Business Add-In: UtilitiesPremiseMoveOut

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesPremiseMove- UtilitiesExtensibility http:// UtilitiesPremiseBadiIn- UtilitiesPremiseBadiR-


Out sap.com/xi/AP/CRM/ put esult
Global

Use this BAdI exit to implement an alternative approach for Move Out action. The appropriate messages have
to be provided through the output.

Utilities Contact Center Administrator Guide


430 PUBLIC S/4HANA Edition for Utilities Contact Center
UtilitiesInstallation

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesInstallation UtilitiesExtensibility http:// UtilitiesInstallation- UtilitiesInstallationBa-


sap.com/xi/AP/CRM/ FetchBAdIInput diResult
Global

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)

The structure UtilitiesInstallationDeviceNotesDetails has been introduced in the UtilitiesInstallationBadiResult


parameter of input and output parameter.

UtilitiesInstallationEstimateMeterReading

Business Add-In: UtilitiesInstallationEstimateMeterReading

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesInstallationEsti- UtilitiesExtensibility http:// UtilitiesInstallationBa- UtilitiesInstallationBa-


mateMeterReading sap.com/xi/AP/CRM/ diInput diResult
Global

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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 431
UtilitiesInstallationOverrideMeterReading

Business Add-In: UtilitiesInstallationOverrideMeterReading

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesInstallationO- UtilitiesExtensibility http:// UtilitiesInstallationBa- UtilitiesInstallationBa-


verrideMeterReading sap.com/xi/AP/CRM/ diInput diResult
Global

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

Business Add-In: UtilitiesInstallationUpdateMeterReading

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesInstallationUp- UtilitiesExtensibility http:// UtilitiesInstallationBa- UtilitiesInstallationBa-


dateMeterReading sap.com/xi/AP/CRM/ diInput diResult
Global

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

Business Add-In: UtilitiesPremiseActions

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesPremiseAc- UtilitiesExtensibility http:// UtilitiesPremiseBadiIn- UtilitiesPremiseBadiR-


tions sap.com/xi/AP/CRM/ put esult
Global

Utilities Contact Center Administrator Guide


432 PUBLIC S/4HANA Edition for Utilities Contact Center
UtilitiesPremiseDetails

Business Add-In: UtilitiesPremiseDetails

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesPremiseDetails UtilitiesExtensibility http:// UtilitiesPremiseDe- UtilitiesPremiseDe-


sap.com/xi/AP/CRM/ tailsFetchBADIInput tailsBadiResult
Global

UtilitiesDisconnectionDocuments

Business Add-In: UtilitiesDisconnectionDocuments

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesDisconnection- UtilitiesExtensibility http:// UtilitiesDisconnection- UtilitiesDisconnection-


DocumentsActions sap.com/xi/AP/CRM/ DocumentsBadiActio- DocumentsActionBa-
Global nInput diResult

2.3.1.4 Contracts

Overview of Business Add-In exits for the Utilities Contracts work center view functionality.

Overview Fetch and Refresh (Deprecated)

Business Add-In: Overview Fetch and Refresh

BAdI Definition Semantic Name Input Parameter Output Parameter

UTILITIES_OVERVIEW_EN- Enhancement of Utilities UTILITIES_OVER- UTILITIES_OVER-


Overview VIEW_BADI_IN VIEW_BADI_RESULT
HANCE

• Results - Following tables are retreived:


• Contract Account - UTIL_CONTRACT_ACCOUNT_TAB
• Contracts - UTIL_CONTRACTS_TAB
• Meter Reading - UTIL_CONTRACTS_METER_READ_TAB
• Division/Service Order Table in Move-In - UTIL_CONTRACTS_SO_TAB_IN
• Division/Service Order Table in Move-Out - UTIL_CONTRACTS_SO_TAB_OUT

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 433
Contract Account Create

Business Add-In: Contract Account Create

BAdI Definition Semantic Name Input Parameter Output Parameter

BADI_UTIL_CONTRACT_AC- Enhancement of contract ac- • UTILITIES_CRE- • UTIL_CONTRACT_AC-


count ATE_CA_BADI_IN COUNT_TAB
COUNT
• ACTION_CODE = 01 • ACTION_CODE = 01
• UTILITIES_MES-
SAGE_TAB (For suc-
cess/error message)

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

Contract Account Change

Business Add-In: Contract Account Change

BAdI Definition Semantic Name Input Parameter Output Parameter

BADI_UTIL_CONTRACT_AC- Enhancement of contract ac- • UTILITIES_CRE- • UTIL_CONTRACT_AC-


count ATE_CA_BADI_IN COUNT_TAB
COUNT
• ACTION_CODE = 02 • ACTION_CODE = 01
• UTILITIES_MES-
SAGE_TAB (For suc-
cess/error message)

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

Utilities Contact Center Administrator Guide


434 PUBLIC S/4HANA Edition for Utilities Contact Center
Move-In

Business Add-In: Move-In

BAdI Definition Semantic Name Input Parameters Output Parameters

BADI_UTIL_CON- Utilities Contracts Move In • UTILIT- • UTILITIES_OVER-


TRACTS_MOVE_IN IES_MOVE_IN_BADI_IN- VIEW_BADI_RESULT
PUT • UTILITIES_MES-
• UTIL_CONTRACTS_TAB SAGE_TAB (For suc-
• UTIL_CONTRACTS_ME- cess/error message)
TER_READ_TAB
• UTIL_CON-
TRACTS_SO_TAB_IN

Move-Out

Business Add-In: Move-Out

BAdI Definition Semantic Name Input Parameters Output Parameters

BADI_UTIL_CON- Utilities Move Out BADI defi- • UTILIT- • UTILITIES_OVER-


nition IES_MOVE_IN_BADI_IN- VIEW_BADI_RESULT
TRACTS_MOVE_OUT
PUT • UTILITIES_MES-
• UTIL_CONTRACTS_TAB SAGE_TAB (For suc-
• UTIL_CONTRACTS_ME- cess/error message)
TER_READ_TAB •
• UTIL_CON-
TRACTS_SO_TAB_OUT

Transfer

Business Add-In: Transfer

BAdI Definition Semantic Name Input Parameters Output Parameters

BADI_UTIL_CON- Utilities Transfer • UTILIT- • UTILITIES_OVER-


TRACTS_TRANSFER IES_MOVE_IN_BADI_IN- VIEW_BADI_RESULT
PUT • UTILITIES_MES-
• UTIL_CONTRACTS_TAB SAGE_TAB (For suc-
• UTIL_CONTRACTS_ME- cess/error message)
TER_READ_TAB
• UTIL_CON-
TRACTS_SO_TAB_IN
• UTIL_CON-
TRACTS_SO_TAB_OUT

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 435
Estimate

Business Add-In: Estimate

BAdI Definition Semantic Name Input Parameters Output Parameters

BADI_UTIL_CON- Utilities Contracts Meter • UTILIT- • UTILIT-


Reading Estimate IES_MR_BADI_INPUT IES_MR_BADI_INPUT
TRACTS_ESTIMATE
• UTIL_CONTRACTS_ME- • UTIL_CONTRACTS_ME-
TER_READ_TAB TER_READ_TAB
• UTILITIES_MES-
SAGE_TAB (For suc-
cess/error message)

Edit Move-In

Business Add-In: Edit Move-In

BAdI Definition Semantic Name Input Parameters Output Parameters

BADI_UTIL_CON- Contracts Edit Move-In • UTILIT- • UTILIT-


TRACTS_EDIT IES_MOVE_IN_BADI_IN- IES_MR_BADI_INPUT
PUT • UTILITIES_MES-
• UTIL_CONTRACTS_ME- SAGE_TAB (For suc-
TER_READ_TAB cess/error message)
• EDIT_MVI_IMPL =
TRUE (Set this flag
EDIT_MVI_IMPL to
specify that BADI is
implemented for Edit
Move-In.

Utilities Contact Center Administrator Guide


436 PUBLIC S/4HANA Edition for Utilities Contact Center
Edit Move-Out

Business Add-In: Edit Move-Out

BAdI Definition Semantic Name Input Parameters Output Parameters

BADI_UTIL_CON- • UTILIT- • Input Parameters


TRACTS_EDIT IES_MOVE_IN_BADI_IN- • Output Parameters
PUT
• UTILITIES_OVER-
VIEW_BADI_RE-
SULT
• UTILITIES_MES-
SAGE_TAB (For
success/error mes-
sage)
• EDIT_MVO_IMPL=
TRUE (Set this flag
EDIT_MVO_IMPL to
specify that BADI
is implemented for
Edit Move-Out.

Cancel Move-In

Business Add-In: Cancel Move-In

BAdI Definition Semantic Name Input Parameters Output Parameters

BADI_UTIL_CON- Utilities Contracts Cancel • UTILIT- • UTILITIES_OVER-


Move-In, Cancel Move-out IES_MOVE_IN_BADI_IN- VIEW_BADI_RESULT
TRACTS_CANCEL
PUT • UTILITIES_MES-
SAGE_TAB (For suc-
cess/error message)
• CANCEL_MVI_IMPL=
TRUE (Set this flag
CANCEL_MVI_IMPL to
specify that BADI is im-
plemented for Cancel
Move-In.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 437
Cancel Move-Out

Business Add-In: Cancel Move-Out

BAdI Definition Semantic Name Input Parameters Output Parameters

BADI_UTIL_CON- Utilities Contracts Cancel • UTILIT- • UTILITIES_OVER-


Move-In, Cancel Move-ou IES_MOVE_IN_BADI_IN- VIEW_BADI_RESULT
TRACTS_CANCEL
PUT • UTILITIES_MES-
SAGE_TAB (For suc-
cess/error message)
• CANCEL_MVO_IMPL=
TRUE (Set this flag
CANCEL_MVO_IMPL to
specify that BADI is im-
plemented for Cancel
Move-Out.

Create Meter Reading

Business Add-In: Create Meter Reading

BAdI Definition Semantic Name Input Parameters Output Parameters

BADI_UTIL_CON- Contracts Meter Reading • UTILIT- • UTILITIES_OVER-


Create/Edi IES_MOVE_IN_BADI_IN- VIEW_BADI_RESULT
TRACTS_MR
PUT • UTILITIES_MES-
SAGE_TAB (For suc-
cess/error message)
• MR_CREATE_IMPL=
TRUE (Set this flag
MR_CREATE_IMPL to
specify that BADI is im-
plemented for Create
Meter Reading.

Utilities Contact Center Administrator Guide


438 PUBLIC S/4HANA Edition for Utilities Contact Center
Edit Meter Reading

Business Add-In: Edit Meter Reading

BAdI Definition Semantic Name Input Parameters Output Parameters

BADI_UTIL_CON- • UTILIT- • UTILITIES_OVER-


TRACTS_MR IES_MOVE_IN_BADI_IN- VIEW_BADI_RESULT
PUT • UTILITIES_MES-
SAGE_TAB (For suc-
cess/error message)
• MR_EDIT_IMPL= TRUE
(Set this flag
MR_EDIT_IMPL to spec-
ify that BADI is imple-
mented for Edit Meter
Reading.

Override

Business Add-In: Override

BAdI Definition Semantic Name Input Parameters Output Parameters

BADI_UTIL_CON- • UTILIT- • UTILITIES_OVER-


TRACTS_MR IES_MOVE_IN_BADI_IN- VIEW_BADI_RESULT
PUT • UTILITIES_MES-
SAGE_TAB (For suc-
cess/error message)
• MR_OVERRIDE_IMPL =
TRUE (Set this flag
MR_OVERRIDE_IMPL to
specify that BADI is
implemented for Meter
Reading Override.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 439
Fetch Meter Reading Data

Business Add-In: Fetch Meter Reading Data

BAdI Definition Semantic Name Input Parameters Output Parameters

BADI_UTIL_MR_DATA_FETC Utilities Fetch MR data from • UTILIT- • Input Parameters


S/4HANA
H IES_MOVE_IN_BADI_IN- • Output Parameters
PUT
• UTILITIES_OVER-
VIEW_BADI_RE-
SULT
• UTIL_CON-
TRACTS_ME-
TER_READ_TAB
• UTIL_CON-
TRACTS_SO_TAB_I
N
• UTILITIES_MES-
SAGE_TAB (For
success/error mes-
sage)

2.3.1.5 Collections

Overview of Business Add-Ins that exist for the Utilities Collections work center view functionality.

Utilities Collection Customer Overview

Business Add-In: UtilitiesCollectionCustomerOverview

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesCollectionCus- UtilitiesExtensibility http:// UtilitiesCustomerOver- UtilitiesCustomerOver-


tomerOverview sap.com/xi/AP/CRM/ viewBADIInput viewBADIInput
Global

Utilities Contact Center Administrator Guide


440 PUBLIC S/4HANA Edition for Utilities Contact Center
UtilitiesDunningHistory

Business Add-In: UtilitiesDunningHistory

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesDunningHis- UtilitiesExtensibility http:// UtilitiesServiceDun- UtilitiesServiceDun-


tory sap.com/xi/AP/CRM/ ningHistoryBadiInput ningHistoryBadiInput
Global

UtilitiesAccountHistory

Business Add-In: UtilitiesAccountHistory

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesAccountHistory UtilitiesExtensibility http:// UtilitiesAccountHistor- UtilitiesAccountHistor-


sap.com/xi/AP/CRM/ yBADIInput yBADIInput
Global

UtilitiesCorrespondenceHistory

Business Add-In: UtilitiesCorrespondenceHistory

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesCorresponden- UtilitiesExtensibility http:// UtilitiesServiceCorres- UtilitiesServiceCorres-


ceHistory sap.com/xi/AP/CRM/ pondenceHistoryBa- pondenceHistoryBa-
Global diInput diInput

UtilitiesCorrespondenceHistoryActions

Business Add-In:UtilitiesCorrespondenceHistoryActions

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesCorresponden- UtilitiesExtensibility http:// UtilitiesServiceCorres- UtilitiesServiceCorres-


ceHistory sap.com/xi/AP/CRM/ pondenceHistoryBa- pondenceHistoryAc-
Global diActionInput tionBadiResult

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 441
UtilitiesWriteOffs

Business Add-In: UtilitiesWriteOffs

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesWriteOffs UtilitiesExtensibility http:// UtilitiesWriteOffsBA- UtilitiesWriteOffsBA-


sap.com/xi/AP/CRM/ DIIn DIIn
Global

UtilitiesSecurityDepositActions

Business Add-In: UtilitiesSecurityDepositActions

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesSecurityDepo- UtilitiesExtensibility http:// UtilitiesSecurityDepo- UtilitiesSecurityDe-


sitActions sap.com/xi/AP/CRM/ sitActionsBADIInput positActionBADIRes-
Global ponse

UtilitiesSecurityDeposit

Business Add-In: UtilitiesSecurityDeposit

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesSecurityDepo- UtilitiesExtensibility http:// SecurityDepositBADIIn SecurityDepositBADIIn


sit sap.com/xi/AP/CRM/
Global

UtilitiesReturns

Business Add-In: UtilitiesSecurityDeposit

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesSecurityDepo- UtilitiesExtensibility http:// UtilitiesReturnsBA- UtilitiesReturnsBA-


sit sap.com/xi/AP/CRM/ DIInput DIInput
Global

Utilities Contact Center Administrator Guide


442 PUBLIC S/4HANA Edition for Utilities Contact Center
UtilitiesCreditWorthiness

Business Add-In: UtilitiesCreditWorthiness

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesCreditWorthi- UtilitiesExtensibility http:// UtilitiesCreditWorthi- UtilitiesCreditWorthi-


ness sap.com/xi/AP/CRM/ nessBADIInput nessBADIInput
Global

2.3.1.6 Service Orders

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.

Overview Fetch and Refresh

Business Add-In: Overview Fetch and Refresh

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesServiceOrderO- UtilitiesExtensibility http:// UtilitiesOverviewBA- UtilitiesServiceOrder-


sap.com/xi/AP/CRM/ dIInput BadiInput
verview
Global

Utilities Service Order Create

Business Add-In: Utilities Service Order Create

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesServiceOrders UtilitiesExtensibility http:// UtilitiesServiceOrder- UtilitiesServiceOrder-


sap.com/xi/AP/CRM/ BadiInput BadiInput
Global

 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:

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 443
• CREATE
• CHANGE
• CANCEL

Utilities Service Order Change

Business Add-In: Utilities Service Order Change

Enhancement Implementation Input Parameter Output Parameter

BADI_UTIL_SERVICE_ORDER • UtilitiesServiceOrderBadiInput • UtilitiesServiceOrderBadiInput


• ACTION_CODE = 02 • ACTION_CODE = 02
• UTILITIES_MESSAGE_TAB (For
success/error message)

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

2.3.1.7 Utilities 360

Business add-ins for functionality available under Utilities 360 work center view.

Utilities 360 Object Hierarchy

Business Add-In: Utilities 360 Facet Object Hierarchy

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

Utilities360facetOb- UtilitiesExtensibility http:// Utilities360ViewRoo- Utilities360ObjectHier-


jectHierarchy sap.com/xi/AP/CRM/ tElements archyBadiResult
Global

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:

• Utillities360FacetRoot - Utilities 360 Root – More Indicator


• Utillities360FacetObjectHierarchyCCADetails - Collective Contract Account Details
• Utillities360FacetObjectHierarchyCADetails - Contract Account Details

Utilities Contact Center Administrator Guide


444 PUBLIC S/4HANA Edition for Utilities Contact Center
• Utillities360FacetObjectHierarchyPremiseDetails - Premise Details
• Utillities360FacetObjectHierarchyContractDetails - Contract Details
• Utillities360FacetObjectHierarchyInstallationDetails - Installation Details
• Utillities360FacetObjectHierarchyDeviceDetails - Device Details
• Utillities360HighlightsAlerts - Alerts – [Deprecated]
• Utilities360Highlights - Highlights - [Deprecated]
• Utilities360Highlight - Highlights

Utilities 360 Facet Object Hierarchy Overview

Business Add-In: Utilities 360 Facet Object Hierarchy

Enhancement
Implementa- Business Ob- Input Parame- Output Param-
tion ject Namespace Interface Method ter eter

Utilities360fac- UtilitiesExtensi- http:// IF_BADI_UTIL_ EXE- Utilities360Ob- Utilities360Ob-


etObjectHier- bility sap.com/xi/AP/ jHierBAdIInput jectHierarchy-
360_OBJ_HI- CUTE_360_OB-
archyOverview CRM/Global BadiResult
ERARCHY JECT_HIERAR-
CHY

UtilitiesCustomerHistory

Business Add-In: BadiUtilitiesCustomerHistory

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesCustomerHis- UtilitiesExtensibility http:// UtilitiesOverviewBA- UtilitiesOverviewBa-


tory sap.com/xi/AP/CRM/ dIInput diResult2
Global

Following are the table details from output structure:

• UTIL_CONTRACTS_TAB - For Contracts Table


• UTIL_PAYMENTS_TAB - For Payments Table
• UTIL_INVOICES_TAB - For Invoice table
• UTIL_SRV_ORDS_TAB - For Service Order Table

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 445
Utilities 360 Recent History - Get Utilities Business Contact

Business Add-In: UtilitiesBusinessContactGet

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesBusinessCon- UtilitiesExtensibility http:// UtilitiesBusinessCon- UtilitiesBusinessCon-


tactGet sap.com/xi/AP/CRM/ tactFetchBadIInput tactBadiResult
Global

Utilities Locks

Business Add-In: Utilities Locks

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesOverviewLocks UtilitiesExtensibility http:// UtilitiesLocksBadiRe- UtilitiesLocksBadiRe-


sap.com/xi/AP/CRM/ sult sult
Global

Utilities Object Hierarchy

Business Add-In: Utilities Object Hierarchy

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

Utilities360ObjectHier- UtilitiesExtensibility http:// Utilities360ObjectHier- Utilities360ViewAc-


archyAction sap.com/xi/AP/CRM/ archyActionBadiInput tionBadiResult
Global

 Restriction

Note the following limitation for Utilities 360 list view.

• The list view displays the data for contract account, premise, contracts, and devices. The field
extensibility is not supported, as it is not possible to identify for which category an extension field
belongs to. If implemented also, the extension fields are mapped to a wrong association.

Utilities Contact Center Administrator Guide


446 PUBLIC S/4HANA Edition for Utilities Contact Center
2.3.1.8 Alerts

Overview of business add-in that exists for alerts.

Alerts - Get Utilities Alerts

Business Add-In: Alerts - Utilities Alerts Get

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesAlertsGet UtilitiesExtensibility http:// UtilitiesAlertsFetchBa- UtilitiesAlertsBadiRe-


sap.com/xi/AP/CRM/ dIInput sult
Global

Alerts - Prefilling extension fields to the selection parameter

Business Add-In: Alerts - UtilitiesAlertsPreGet

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesAlertsPreGet UtilitiesExtensibility http:// UtilitiesAlertsFetchBa- UtilitiesAlertsBadiRe-


sap.com/xi/AP/CRM/ dIInput sult
Global

2.3.1.9 Exception Management

Overview of business add-in that exists for exeption management.

Exception Management - Get Utilities BPEM

Business Add-In: Exception Management - Utilities BPEM Get

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesBPEMGet UtilitiesExtensibility http:// UtilitiesBPEMFetchBa- UtilitiesBPEMBadiRe-


sap.com/xi/AP/CRM/ dIInput sult
Global

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 447
UtilitiesBPEMActions

Business Add-In:UtilitiesBPEMActions

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesBPEMActions UtilitiesExtensibility http:// UtilitiesBPEMBadiAc- UtilitiesBPEMAction-


sap.com/xi/AP/CRM/ tionInput BadiResult
Global

2.3.1.10 Promise to Pay

Overview of business add-ins that exist for promise to pay.

Utilities P2P Get

Business Add-In: UtilitiesP2PGet

BAdI Definition Semantic Name Business Object Namespace Input Parameter Output Parameter

UtilitiesP2PGet Get Utilities P2P UtilitiesExtensibil- http:// UtilitiesP2PFetch- UtilitiesP2PBadiR-


ity sap.com/xi/AP/CR BadIInput esult
M/Global

Utilities P2P Modify

Business Add-In: UtilitiesP2PModify

BAdI Definition Semantic Name Business Object Namespace Input Parameter Output Parameter

UtilitiesP2PModify Modify Utilities UtilitiesExtensibil- http:// UtilitiesP2PModi- UtilitiesP2PBadiR-


P2P ity sap.com/xi/AP/CR fyBadIInput esult
M/Global

Utilities Contact Center Administrator Guide


448 PUBLIC S/4HANA Edition for Utilities Contact Center
2.3.1.11 Payment Data

Overview of business add-ins that exist for payment data.

Utilities Payment Data Overview

Business Add-In: UtilitiesPaymentDataOverview

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesPaymentDa- UtilitiesExtensibility http:// UtilitiesPaymentData- UtilitiesPaymentData-


sap.com/xi/AP/CRM/ FetchBAdIInput BAdIResult
taOverview
Global

Utilities Payment Data Actions

Business Add-In: UtilitiesPaymentDataActions

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesPaymentDa- UtilitiesExtensibility http:// UtilitiesPaymentDa- UtilitiesPaymentDa-


sap.com/xi/AP/CRM/ taActionBAdIInput taActionBAdIResult
taActions
Global

2.3.1.12 Rate Category

Overview of business add-in that exists for rate category.

Utilities Contracts Installation Facts Modify

Business Add-In: UtilitiesContractsInstallationFactsModify

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesContractsIn- UtilitiesExtensibility http:// UtilitiesRateCategory- UtilitiesRateCategory-


sap.com/xi/AP/CRM/ ChangeBADIInput ChangeBADIOutput
stallationFactsModify
Global

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

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 449
2.3.1.13 Service Notification

Overview of business add-ins that exist for service notification.

Utilities Service Notification Overview

Business Add-In: UtilitiesServiceNotificationOverview

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesServiceNotifi- UtilitiesExtensibility http:// UtilitiesServiceNotifi- UtilitiesServiceNotifi-


sap.com/xi/AP/CRM/ caionFetchBAdIInput cationBadiResult
cationOverview
Global

Utilities Service Notification Actions

Business Add-In: UtilitiesServiceNotificationActions

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesServiceNotifi- UtilitiesExtensibility http:// UtilitiesServiceNotifi- UtilitiesServiceNotifi-


sap.com/xi/AP/CRM/ caionModifyBAdIInput cationBadiResult
cationActions
Global

2.3.1.14 Rate Change

Overview of business add-in that exists for rate change.

Utilities Contract Installation Facts

Business Add-In: UtilitiesContractInstallationFacts

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesContractInstal- UtilitiesExtensibility http:// UtilitiesInstallation- UtilitiesInstallation-


sap.com/xi/AP/CRM/ FactsBADIInput FactsBadiResult
lationFacts
Global

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

Utilities Contact Center Administrator Guide


450 PUBLIC S/4HANA Edition for Utilities Contact Center
2.3.1.15 Utilities Addresses

Overview of business add-in that exists for Utilities Addresses.

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

Utilities Addresses - Display

Business Add-In: Utilities Addresses - UtilitiesCustomerAddressGet

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesCustomerAd- UtilitiesExtensibility http:// UtilitiesAddressFetch- UtilitiesAddressGetBa-


sap.com/xi/AP/CRM/ BadIInput diResult
dressGet
Global

Utilities Addresses - Actions

Business Add-In: Utilities Addresses - UtilitiesCustomerAddressActions

Enhancement Imple-
mentation Business Object Namespace Input Parameter Output Parameter

UtilitiesCustomerAd- UtilitiesExtensibility http:// UtilitiesAddressAction- UTILITIES_AD-


sap.com/xi/AP/CRM/ BadiInput DRESS_ACTN_RE-
dressActions
Global SULT

2.3.1.16 Switch Document for Enrollment Process

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.

Business Add-In: Logical Port for Notification Service

BAdI Definition Semantic Name

COD_UTILITIES_QUOTE_NOTIF_PORT

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 451
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.

2.3.1.17 Enrollment Product Proposal

Business add-in exit for extending implementation for product proposal in the enrollment process.

Product Proposal for Enrollment Process

Business Add-In: Product Proposal for Enrollment Process

Enhancement Implementation Input Parameter Output Parameter

BADI_UTILITIES_PROD_PROPOSAL BADI_UTILITIES_PROD_PROPOSAL_C BADI_UTILITIES_PROD_PROPOSAL_C

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.

2.3.1.18 Customer Search

Business Add-In for the customer search feature.

Customer Search

Use the Customer Search add-in to extend the customer search feature.

Business Add-In - Customer Search

Enhancement Implementation Business Object Namespace

UtilitiesAccountSearch UtilitiesAccountSearch http://sap.com/xi/AP/CRM/Global

Utilities Contact Center Administrator Guide


452 PUBLIC S/4HANA Edition for Utilities Contact Center
2.3.1.19 Move Processes(GAF)

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.

Follow the below steps for the mapping process:

1. Add custom fields in SAP 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 SAP Cloud for Customer custom field in
the field-name and corresponding value in field-value.

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

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 453
2.3.2 UI Extensions for Utilities Online Transactions

Use the step-by-step guide to create project-specific 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, Write-Offs, and Security Deposit in different screens, the inport FromContractAccount to be used.

Prerequisites

You are using the SAP Cloud Applications Studio(PDI) version that corresponds to the SAP Cloud for Customer
release version.

Utilities Contact Center Administrator Guide


454 PUBLIC S/4HANA Edition for Utilities Contact Center
2.3.2.1 Step 1 - Create a PDI Solution

Create a new PDI solution, maintain the mandatory fields and save the new solution.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 455
For the new solution, select solution type as Customer Specific Solution as shown in the graphic

below:

2.3.2.2 Step 2 - Add Item under Solution Explorer

Add a new item under the Solution Explorer.

Utilities Contact Center Administrator Guide


456 PUBLIC S/4HANA Edition for Utilities Contact Center
2.3.2.3 Step 3 - Specify Name of Extension Object in
Business Object Extension

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)

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 457
2.3.2.4 Step 4 - Add Extension Fields to the Newly Added
Extension Business Object
In the previous step (step 3), you have added the extension business object into your solution. This will now
appear under the solution explorer with .xbo extension. Double click on this file extension to open the editor
where you can add the new extension fields under the desired node.

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.

2.3.2.5 Step 5 - Add Same Extension Fields to UI Screens


In the previous step (step 4), you have added extension fields to the extension business object in the backend
system. In this step, you will need to add the same extension fields to UI screens.

To add the extension fields to UI screen, right click on the .xbo file extension and choose Enhance Screen (see
screenshot below) .

Utilities Contact Center Administrator Guide


458 PUBLIC S/4HANA Edition for Utilities Contact Center
This (Enhance Screen option) will show the list of floor plans where you can add the new extension field. You
can select the appropriate floor plan where you need to define extension fields.

2.3.2.6 Step 6 - Select Section Group in UI Screen Where


You Want to Add Extension Fields

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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 459
4. Activate the floor plan. With this you can see the new extension field added to the section group.

Open the UI screen to see the new extension field (as seen in the screenshot below).

Utilities Contact Center Administrator Guide


460 PUBLIC S/4HANA Edition for Utilities Contact Center
2.3.2.7 Step 7 - Create Service Interface to S/4HANA using
Web Service

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

2.3.2.8 Step 8 - Create a Communication Scenario to


Integrate Web Service with S/4HANA System

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

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 461
2.3.2.9 Step 9 - Select Valid BAdI Implementation in
Solution Explorer

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.

Utilities Contact Center Administrator Guide


462 PUBLIC S/4HANA Edition for Utilities Contact Center
2.3.3 (Optional) Extend Your Solution

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.

The implementation-friendly extensibility concept can be summarized as follows:

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

2. Select the business object to extend.

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.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 463
2. Add the extension field to the UI designer screen.
1. Select the UI as COD_UTILITIES_FINANCIAL_OVERVIEW_EXTENSIBILITY_EC.
2. Enter the extended UI path as /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/
COD_UTILITIES_FINANCIAL_OVERVIEW_EXTENSIBILITY_EC.EC.uicomponent.

3. Implement the UtilititesFinancialAccountOverviewenhancement.


1. Add the enhancement implementation.

Utilities Contact Center Administrator Guide


464 PUBLIC S/4HANA Edition for Utilities Contact Center
2. Enter the details.

3. Implement the logic in the ABSL script.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 465
The code snippet is as follows:

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.

Utilities Contact Center Administrator Guide


466 PUBLIC S/4HANA Edition for Utilities Contact Center
2. Activate the implementation by clicking the implementing class that has all the methods that need
logic to be added for changing the standard behavior.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 467
A sample code snippet for ERP implementation method in Account_overview_post is as
follows:

The data sent from ERP is passed to the extension field from PDI, and displayed in SAP Cloud for
Customer:

2. Implement the enhancement for Actions.


1. Add the extension field in the node for onetime payment.

Utilities Contact Center Administrator Guide


468 PUBLIC S/4HANA Edition for Utilities Contact Center
2. Extend the field to the UI by selecting the UI
as COD_UTILITIES_FINANCIAL_OVERVIEW_EXTENSIBILITY_EC, and the
extended UI path as /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/
COD_UTILITIES_FINANCIAL_OVERVIEW_EXTENSIBILITY_EC.EC.uicomponent

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

2.3.4 Utilities Web Services for Extensibility Purposes

For a complete list of utilities web services, see SAP Cloud for Customer.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 469
2.3.5 Custom Action

You can now create Custom Actions for the following options:

• Utilities Exceptions(Both in Premise and Customer screens)


• Utilities Financials
• Payments
• Open items
• Invoices
• Payment Plan
• Utilities Collections
• Dunning History
• Correspondences
• Utilities 360
• Object Hierarchy (Corresponding BADI for custom actions is Utilities360ObjectHierarchyAction)
• Utilities Service Orders
• Utilities Service Notifications

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)

Utilities Contact Center Administrator Guide


470 PUBLIC S/4HANA Edition for Utilities Contact Center
2. Create script file for the custom action by right clicking on the xbo
Click on the Create check box (Within the corresponding node for the newly created custom action) and
Click on OK.

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 471
This will result in the creation of an absl file as shown below:

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.

Utilities Contact Center Administrator Guide


472 PUBLIC S/4HANA Edition for Utilities Contact Center
2.4 Troubleshooting

References for troubleshooting issues with integration setup.

For detailed information on troubleshooting in PI system, see http://wiki.scn.sap.com/wiki/display/TechTSG/


%28PI%29+7.3.1+Troubleshooting+Guide

Utilities Contact Center Administrator Guide


S/4HANA Edition for Utilities Contact Center PUBLIC 473
3 Cloud for Utilities Edition for Utilities
Contact Center

SAP Cloud for Customer Utilities Contact Center for Cloud for Utilities 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 Cloud for Utilities IS-Utilities (IS-U) and SAP Cloud for
Utilities 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 Cloud for Utilities
system.

The following table details the software compatibility matrix for SAP Cloud for Customer Utilities Contact
Center:

Minimum Software Requirements


SAP Cloud for Customer
Cloud for Utilities Edition
SAP Cloud for Customer Software Components Cloud for Utilities SAP Cloud Integration

2205 SAP Cloud for Customer IS- S4H OP 2020 FPS2 SAP Cloud for Utilities
Utilities for Customer Service Solu-
tion Integration with SAP S/
4HANA

3.1 Configuration and System Setup

The topics below provide a detailed overview of the configuration required to setup the utilities contact center.

Scope and Configure Cloud for Utilities [page 475]


Administrators can configure the utilities contact center using scoping, scoping questions, and fine-
tuning activities.

Configure Middleware [page 483]


Learn about the configuration of middleware.

Configure Integration with Cloud for Utilities [page 485]


An overview of how to configure integration with Cloud for Utilities system.

Related Information

Assign Work Centers to Business Users [page 478]


Work center assignment to business users based on their roles.

Utilities Contact Center Administrator Guide


474 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
3.1.1 Scope and Configure Cloud for Utilities

Administrators can configure the utilities contact center using scoping, scoping questions, and fine-tuning
activities.

Scoping [page 475]


To set up your SAP Cloud for Customer system to support Utilities Contact Center solution, scope your
implementation project accordingly.

Replicate Utilities Master Data [page 477]


You can execute reports to transfer data from IS-Utilities system to the Utilities Contact Center cloud
solution.

Assign Work Centers to Business Users [page 478]


Work center assignment to business users based on their roles.

Configure the Alerts Tab [page 478]


As an administrator, use adaptation to add the Alerts tab.

Configure Utilities 360 [page 480]


As an administrator, you can configure to manage views for Recent History and Hierarchy sections
under Utilities 360 screen of a customer.

Assign Front Office Processes [page 480]


Assign the front office processes that you need to launch from SAP Cloud for Customer in the
Implementation Guide customizing.

Configure Smart Energy Water [page 481]


To integrate the Smart Energy Water (SEW) with SAP Cloud for Utilities system, the Communication
Preferences and Consumption Graph, Outage Map, and Compare must be configured.

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

3.1.1.1.1 Configure the Replication of Point of Delivery

As an administrator, configure the replication of Point of Delivery (PoD).

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 475
In the Questions step navigate to Industry Solution Utilities Cloud for Utilities and under Technical
Master Data Replication, select the scoping question Do you want to replicate point of delivery data from your
external application to your cloud solution?

3.1.1.1.2 Configure to use Premise External ID as the


Internal ID in Cloud for Customer

As an administrator, configure to use premise external ID as internal ID in cloud solution.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Cloud for Utilities and under Technical
Master Data Replication, select the scoping question Do you want to use Premise External ID as the Internal ID in
C4C?

3.1.1.1.3 Enable the Contract Account Object Labels

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 Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Cloud for Utilities and under Utilities
Enhancements, select the scoping question Do you want to enable the contract account object labels to display
external ID and name?

3.1.1.1.4 Enable the Premise Object Labels

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 Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Cloud for Utilities and under Utilities
Enhancements, select the scoping question Do you want to enable the premise object labels to display house
number, street name, and house supplement?

3.1.1.1.5 Configure Premise Search in Live Activity

As an administrator, you can configure to use premise basic search in live activity.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

Utilities Contact Center Administrator Guide


476 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
In the Questions step navigate to Industry Solution Utilities Cloud for Utilities and under Utilities
Enhancements, select the scoping question Do you want to enable local search for the Utilities-Premise
Category in Enterprise Search and Live activity?

3.1.1.1.6 Configure the Creation of BPEM Clarification


Case

As an administrator, configure the creation of BPEM clarification case from your cloud solution that is
completely integrated with your SAP Cloud for Utilities.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Cloud for Utilities and under Utilities
Exception Management, select the scoping question Do you want to enable creation of BPEM Clarification Case?

3.1.1.1.7 Configure Manual Posting

As an administrator, you can enable manual posting in Utilities Financials.

Go to Business Configuration Implementation Projects . Select your project and click Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Cloud for Utilities and under Utilities
Manual Posting, select the scoping question Do you want to enable Manual Posting in ‘Utilities Financials’?

3.1.1.2 Replicate Utilities Master Data

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 295] and Contract Account Replictaion [page
297].

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 477
3.1.1.3 Assign Work Centers to Business Users

Work center assignment to business users based on their roles.

Assign Work Centers to Business Users

Supported Work Centers and Tab Screens

Work Center Folder Work Center Name Technical Name

COD_UTILITIES_WCF Utilities

Contract Account COD_CONTRACTACCOUNT_WCVIEW

Customer Search COD_CUSTOMER_SEARCH_EXT_WCVIEW

Premise COD_PREMISE_WCVIEW

COD_SALES_WCF Sales

Sales Quotes COD_QUOTE_WCVIEW

Sales POD SALESPOD_WCVIEW

CODACCOUNTWC Customers

 Note
The utilities specific screen Utilities
360is available with this scoping.

Accounts CODACCOUNTWCV

Contacts COD_CONTACT_WCV

Individual Customers COD_SEOD_ACCOUNTWL_WCVIEW

COD_SEOD_AGENT_QUEUE_WCF Tickets SEOD_TICKET_SADL_WCVIEW

Live Activity Center LIVE_ACTIVITY_CENTER

3.1.1.4 Configure the Alerts Tab

As an administrator, use adaptation to add the Alerts tab.

After you add the tab, you can enable it as a side pane in screens. Click your user profile and navigate to
Settings Company Settings and then set the Enable Side Pane toggle to Yes.

Utilities Contact Center Administrator Guide


478 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
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.

Alerts in Move Process

You can enable the display of alerts in the expanded mode through a scoping question. To configure the
scoping question go to Business Configuration Implementation Projects . Select your project and click
Edit Project Scope.

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 479
In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Alerts, select the scoping question Do you want expanded Alerts in Move Processes?

3.1.1.5 Configure Utilities 360

As an administrator, you can configure to manage views for Recent History and Hierarchy sections under
Utilities 360 screen of a customer.

To configure the default view in the Hierarchy section, follow these steps:

1. Navigate to Administrator Industry Settings Utilities Settings for Utilities 360 .


2. Click Edit icon to enter into the edit mode.
3. On the Hierarchy page, you can manage the default view for Hierarchy in Utilities 360 to be shown on the
screen by selecting the default view type from the dropdown.

4. Click Save.

3.1.1.6 Assign Front Office Processes

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), assign the relevant front office processes that you need to launch from
SAP Cloud for Customer to the utilities launch object. 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:

• ISUACCOUNT – Contract Account


• ISUPARTNER – Customers (Accounts and Individual Customers)

Utilities Contact Center Administrator Guide


480 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
• PREMISES – Premise

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

Configure Mashup for Front Office Process (FOP) [page 494]

3.1.1.7 Configure Smart Energy Water

To integrate the Smart Energy Water (SEW) with SAP Cloud for Utilities system, the Communication
Preferences and Consumption Graph, Outage Map, and Compare must be configured.

Follow the steps to configure Communication Preferences and Consumption Graph, Outage map, and Compare
tabs from Cloud for Utilities.

1. To create Mashup Web services, follow the steps:


• Go to Administrator Mash up Web Service New REST Service .
• Add all the mandatory parameters to fetch the token.
• General information – Enter the Service Name
• Service Information- Select Authorization Method as Basic, HTTP method as GET, Service Protocol
as XML, and enter the Username, Password, and URL
• Input parameters- add Parameters as required.

 Note

Maintain the parameter names as UtilityAccountNumber for Contract Accounts and


CustomerNumber for Customer.
• Ensure the mandatory field is checked if the parameters is required to retrieve the token.
• Ensure to add all parameters as required.
• Constant values are given preference over actual values.

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 481
• Click Activate to enable web service.

 Note

Ensure that web service is active.

2. Maintain Admin Settings.


• Go to Administrator Industry Settings Setting for SEW Integration .
• Select the Mashup Web Service ID that you created from the list.
• Enter the Consumption URL, Notification URL, Utility ID, and P ID.

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

Utilities Contact Center Administrator Guide


482 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
3.1.2 Configure Middleware

Learn about the configuration of middleware.

Configure SAP Cloud Integration [page 483]


This section describes the configuration required for SAP Cloud Integration.

3.1.2.1 Configure SAP Cloud Integration

This section describes the configuration required for SAP Cloud Integration.

Inbound: Create Binding for inbound services in Cloud for Utilities

When a service gets triggered form SAP Cloud for Customer, a corresponding Cloud for Utilities service gets
executed in Cloud for Utilities through SAP Cloud Integration. Therefore, you need to create a binding in
SOAMANAGER that generates a calculated URL. This must be configured in the Receiver channel of SAP Cloud
Integration.

3.1.2.1.1 Simplified Web Service Configuration for Account


Overview Service

1. Open SOAMANAGER from S/4HANA and select Simplified Web Service Configuration.

2. In the field Search Pattern search for the inbound S/4HANA service name
ISU_C4C_ACCOUNT_OVERVIEW and click GO.

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 483
3. Under Configure Service Definitions, select the check box to authenticate the service from the options as
per the requirement.

4. Select the service and click Show Details option to get the calculated URL and check for the same URL
when configuring the SAP Cloud Integration Receiver Channel.

Utilities Contact Center Administrator Guide


484 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
5. In Account Overview Integration Flow check for the URL maintained in the SOAMANAGER.

3.1.3 Configure Integration with Cloud for Utilities


An overview of how to configure integration with Cloud for Utilities system.

 Note

You must have defined the required integration set-up to connect with Cloud for Utilities and PI system.

1. Setup the PI value configuration to execute the utilities contact center Cloud for Utilities specific web
services. For the list of web services, see the worksheet for Cloud for Utilities in the Attachments tab.

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 485
2. Define the PI value mapping between the cloud business system ID and the Cloud for Utilities logical
system ID.
3. Replicate the required business partners to the cloud solution. For more information, see http://
help.sap.com/mdg80/

 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 Cloud for Utilities to the cloud system.

 Note

The contracts are replicated from Cloud for Utilities system using an online call; there is no specific
report to be executed for replicating contracts to the cloud solution.

Related Information

Data Replication from IS-Utilities [page 64]


The reports listed in this section must be executed for transfer of data from IS-Utilities system to the
Utilities Contact Center cloud solution.

3.1.3.1 Utilities Business Partner Replication

The Utilities Business Partner Replication enables master data integration between SAP Cloud for Customer
and SAP Cloud Platform MDM.

For more information on integration with SAP Cloud Platform Master Data for business partners, refer the
related link.

Related Information

https://help.sap.com/viewer/246fb358c1c7413289c03b8c72734209/latest/en-US/
3e0b477a09454e68ae2beda7b9654ec6.html

3.1.3.2 Implementation Guide (IMG) on IS-Utilities

Perform and maintain the configuartion for IMG related to SAP Cloud for Customer

Create Configurable Hierarchy [page 487]

Assign Front Office Processes [page 480]

Utilities Contact Center Administrator Guide


486 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
Assign the front office processes that you need to launch from SAP Cloud for Customer in the
Implementation Guide customizing.

Enrollment - Configuring Switch Document Creation and Notification [page 488]


Detailed information for creating switch document in the cloud solution.

3.1.3.2.1 Create Configurable Hierarchy

The steps to creating the configurable object hierarchy are listed below:

1. In your SAP Cloud for 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 Cloud for Utilities system.

3.1.3.2.2 Assign Front Office Processes

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), assign the relevant front office processes that you need to launch from
SAP Cloud for Customer to the utilities launch object. 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:

• ISUACCOUNT – Contract Account


• ISUPARTNER – Customers (Accounts and Individual Customers)
• PREMISES – Premise

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 .

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 487
Related Information

Configure Mashup for Front Office Process (FOP) [page 494]

3.1.3.2.3 Enrollment - Configuring Switch Document


Creation and Notification

Detailed information for creating switch document in the cloud solution.

Configure Switch Document Creation in Cloud Solution

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.

Configuration for Creating Switch Document

Parameter Value

Service in Cloud Solution CO_CQP_SOR_OUT

S/4HANA Service II_UTILITIES_LEAN_QUOTE_SI_IN1

PI Outbound Service CustomerQuoteProcessingSalesOrderRequestOut

PI Inbound Service Utilities_LeanQuote_SI_In

Operation Mapping in PI C4C_S4_UtilitiesQuote_SwitchDocumentRequest

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

Configure Notification for Switch Document in Cloud Solution

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

Utilities Contact Center Administrator Guide


488 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
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.

Configure Notification for Switch Document

Parameter Value

Service in cloud solution II_CQP_SLO_NOTIFICATION_IN

S/4HANA Service CO_CUSTOMER_QUOTE_PROCESSING_U

PI Outbound Service CustomerQuoteProcessingUpdatingSalesQuoteWithSale-


sOrderIn

PI Inbound Service CustomerQuoteProcessingUpdatingSalesQuoteWithSale-


sOrderIn_In

Operation Mapping in PI S4_C4C_Utilities_CustomerQuoteProcessingUpdatingSales-


Quote¬-WithSalesOrderIn

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

Configuration in S/4HANA System

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:

1. Go to transaction code SOAMANAGER in the S/4HANA system.


2. Choose Service Administration as Web Service Configuration.
3. Search for consumer proxy CO_CUSTOMER_QUOTE_PROCESSING_U. Click to view the details.
4. Choose Create a Manual configuration.
5. Enter information based on your middleware configuration. Here is an example value that needs
to be adjusted according to your configuration. Example URL Path: /XISOAPAdapter/MessageServlet?
channel=:ABC_004: S4_SOAP_Utilities_LeanQuote_Notification_Send&sap-client=238
6. To confirm that the logical port was created and configured correctly, ping the Web service. If the ping is
successful, a confirmation message appears.

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

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 489
3.1.3.3 Data Replication from IS-Utilities

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

Delta (Creation Delta (Modifi-


of New Ob- cation of Exist- Unidirectional/ Scoping and
Object Initial Load jects) ing Objects ) Bidirectional Fine Tuning

Business Part- Yes Yes Yes Bidirectional Yes

ner - MDM

Contract Ac- Yes Yes Yes Unidirectional Yes

count Replica- (Only from IS-


tion Utilities to
Cloud Solution)

Contract Ac- Not Applicable Not Applicable Not Applicable Unidirectional Yes
(Only from IS-
count Online
Utilities to
Cloud Solution)

Point of Deliv- Yes Yes Yes Unidirectional Yes

ery Replication (Only form IS-


Utilities to
Cloud Solution)

Contracts Not Applicable Not Applicable Not Applicable Not Applicable Not Applicable

Connection Ob- Yes Yes Yes Unidirectional Not Applicable

ject (IS-Utilities to
Cloud solution)

Premise Yes Yes Yes Unidirectional Not Applicable

(IS-Utilities to
Cloud solution)

Utilities Contact Center Administrator Guide


490 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
3.1.3.3.1 Technical Objects Replication

Technical Objects Replication Report: ISU_C4C_TECH_OBJECTS_REPL

Report for Initial Load - ISU_C4C_TECH_OBJECTS_REPL

Schedule periodic runs for the initial load report from Cloud for Utilities 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

Follow these steps to run the report:

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 is set to sy-langu if empty. Also the From-Date is 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 is 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.

Delta Replication - Connection Object

Create or change of a connection object triggers delta replication. Follow these steps to trigger a delta
replication for connection object data:

1. In the transaction code SM30, enter the table / view SWFDVEVTY2.


2. Add the entries for the events CHANGED and CREATED for the object CONNOBJ.

 Note

Creating or changing a connection object triggers the delta replication for connection objects.

Delta Replication - Premise

Follow these steps to trigger a delta replication for premise data:

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 491
1. In the transaction code SM30, enter the table / view SWFDVEVTY2.
2. Add the entries for the events CHANGED and CREATED for the object PREMISES.

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

Delta Replication - Point of Delivery

Follow these steps to trigger a delta replication for point of delivery data:

1. In the transaction code SM30, enter the table / view SWFDVEVTY2.


2. Add the entries for the events CHANGED and CREATED for the object ISUPOD.

 Note

Creating or changing a connection object triggers the delta replication for point of delivery data.

Technical Object Replication Via Parallel Processing Technique

This enables the replication of technical objects for initial load with faster response time via parallel processing
technique.

Report ISU_C4C_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 that 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.

• Enhancement Spot: COD_UTIL_TECH_OBJS_REPLICATION


• BAdI: COD_UTIL_TECH_OBJS_REPLICATION

Utilities Contact Center Administrator Guide


492 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
• Interface: IF_COD_UTIL_TECH_OBJS_REPL
• Method: POD_ADJUST_DATA

Configuration in Cloud for Utilities System

To run any of the above mentioned reports in theCloud for Utilities 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:

1. Go to transaction code SOAMANAGER in the Cloud for Utilities system.


2. Choose Service Administration as Web Service Configuration.
3. Search for consumer proxy CO_UTILITIES_TECHNICAL_OBJEST. Click to view the details.
4. Choose Create a Manual configuration.
5. Enter information based on your middleware configuration. Here is an example value that needs to be
adjusted according to your configuration. Example URL Path: XISOAPAdapter/MessageServlet?
senderParty=&senderService=Q5J_340&receiverParty=&receiverService=&interface=Utilities_Technical_
Objests_Repl_Out&interfaceNamespace=http%3A%2F%2Fsap.com%2Fxi%2FCODERINT
6. To confirm that the logical port was created and configured correctly, ping the Web Service. If the ping is
successful, a confirmation message appears.

3.1.3.3.2 Contract Account Replication

Contract Account Replication Report: ISU_C4C_ACCOUNT_EXTRACT. Use this report to replicate the contract
accounts to the cloud solution.

Setting Up SAP Cloud for Utilities for Contract Account Replication

Set up SAP Cloud for Utilities to replicate contract accounts to SAP Cloud for Customer.

For more information on how to set up SAP Cloud for Utilities for Contract Account Replication, refer the
related link.

Related Information

https://help.sap.com/viewer/DRAFT/685d789fde7247da9e5c87f2b7c79907/latest/en-US/
41d1472b09094aefa4f9ae023ff06193.html

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 493
3.1.3.3.3 Code Lists Mapping

Code list mapping must be maintained for the fields specified in the following sections

Automatic Code List Mapping

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.

Related Information

Configure Automatic Code List Mapping

3.1.3.4 Configure Mashup for Front Office Process (FOP)

Follow these steps to create and configure a new mashup for integrating front office processes with your SAP
Cloud for Utilities system.

1. Go to the Administrator work center and click Industry Settings Utilities Settings for Front Office
Process .
2. Click 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.

Utilities Contact Center Administrator Guide


494 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
 Note

You also need to assign the launch object in the Implementation Guide Customizing for SAP Cloud for
Customer Utilities. For more information, see the reference in the related links section.

Related Information

Mashups
Assign Front Office Processes [page 480]
Assign the front office processes that you need to launch from SAP Cloud for Customer in the
Implementation Guide customizing.

3.2 Functional Scenarios


Learn about the functional scenarios in the Utilities Contact Center.

Customer Search [page 495]


Search for utilities customers in the cloud solution and in the SAP Cloud for Utilities system.

Alerts [page 496]


You can view static content under the Alerts side panel across the Customer, Premise, and Contact
Account screens in Utilities Contact Center solution. The Alerts framework is also available at every
stage of move processes.

Premise [page 497]


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.

Contract Accounts [page 506]


This work center view displays all contracts for a selected contract account.

Utilities Views in Customers [page 519]


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.

Front Office Process [page 523]


Configure the Front Office Process in your SAP Cloud for Customer.

3.2.1 Customer Search


Search for utilities customers in the cloud solution and in the SAP Cloud for Utilities system.

The search that you perform launches an online search for business partners in the Cloud for Utilities system.
Use the advanced search based on customer identification, address details or specific utilities information

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 495
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
Cloud for Utilities 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.

3.2.2 Alerts
You can view static content under the Alerts side panel across the Customer, Premise, and Contact Account
screens in Utilities Contact Center solution. The Alerts framework is also available at every stage of move
processes.

3.2.2.1 Configure the Alerts Tab


As an administrator, use adaptation to add the Alerts tab.

After you add the tab, you can enable it as a side pane in screens. Click your user profile and navigate to
Settings Company Settings and then set the Enable Side Pane toggle to Yes.

Utilities Contact Center Administrator Guide


496 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
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.

Alerts in Move Process

You can enable the display of alerts in the expanded mode through a scoping question. To configure the
scoping question go to Business Configuration Implementation Projects . Select your project and click
Edit Project Scope.

In the Questions step navigate to Industry Solution Utilities Utilities Call Center and Service and under
Utilities Alerts, select the scoping question Do you want expanded Alerts in Move Processes?

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

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 497
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.

Premise Quick View to Display Active Services and Active Customer

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

Utilities Contact Center Administrator Guide


498 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
and the current active customer under this premise quick view.

3.2.3.1 Views in Premise

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.

3.2.3.1.1 Overview

This screen has three subsections, namely the Map 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

In this screen, the table displays all the customers related to that premise.

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 499
3.2.3.1.2 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, 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.

Meter Reading

In the Utilities Contact Center, you can create and update meter readings. On selection of a device 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 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 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

For AMI, the create and edit actions are disabled as the meter reading entry is captured automatically from
backend.

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

Interim Meter Reading

You can now enter or estimate an interim meter reading with or without billing. You must specify the
appropriate meter reading reason and type.

Utilities Contact Center Administrator Guide


500 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
Meter Reading Estimate, Override, and Reset

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.

Meter Reading Order

The meter reading table displays a combination of meter reading result and meter reading order, sorted by
date, device, manufacturer serial number, 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’s 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’s 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 equipment.

Validations for Meter Reading Create

• Reset option in the UI dialog for New Meter Reading.


• If meter readings are blank, then meter reading orders are created for meter reading reasons 02 and 09.

View Information About the Validity of a Meter

The validity period of meter of a premise or an installation are displayed under Meter Information table.

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 501
Utilities Contact Center Administrator Guide
502 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
View Device Location Details

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 pop up.

Advanced Metering Infrastructure (AMI)

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:

• Customers Utilities 360 Object Hierarchy Device Details .

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 503
• Utilities Premise Connection Details Device Details .
On the Connection Details page, click Ping to receive the status of the meter from the call center. The
status comes with details that can be used for analysis. 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.

The following details are retrieved from the SAP 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 active 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.

Related Information

Code Lists Mapping [page 77]


Code list mapping must be maintained for the fields specified in the following sections.

Utilities Contact Center Administrator Guide


504 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
3.2.3.1.3 Tickets

This 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 SAP 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.

3.2.3.1.4 Central

This tab displays cards such as Customer, Recent Tickets, and Recent Meter Readings.

You can perform the following actions:

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

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 505
3.2.3.2 Premise Object Title

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.

3.2.4 Contract Accounts

This work center view displays all contracts for a selected contract account.

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.

Alternate Contract Account Work Center

This new work center provides you the capability to use value help search in advance search.

 Note

Collective Contract Account hyperlink is disabled in contract account work center list to improve the
performance.

Utilities Contact Center Administrator Guide


506 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
Possibilities for Creating New Contract Accounts

You can create new contract accounts using the Create Contract Account in the toolbar for Customers.

Possibilities for Editing Contract Account

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.

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

Contract Account Replication [page 71]


Contract Account Replication Report: COD_UTILITIES_ACCOUNT_EXTRACT. Use this report to replicate
the contract accounts to the cloud solution.

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 507
3.2.4.1 Views in Contract Account

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.2.4.1.1 Details

This view displays the consolidated general, financial, and more information specifically to the selected
contract account.

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.

3.2.4.1.2 Central

This tab displays cards such as Recent Invoices, Last Payment, Premises, Locks, Recent Tickets, Open Items,
Customer Credit Worthiness, Security Deposit, and Dunning.

You can perform the following actions:

• To go to that particular tab, click the card title.

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

Utilities Contact Center Administrator Guide


508 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
• The Customer Credit Worthiness card displays the score for the current month and the comparison with
the previous month.

3.2.4.1.3 Tickets

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.

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 509
 Note

If required, release the contract account field in Service Request Industry Extension BO to consume in a
custom oData service.

3.2.4.1.4 Locks and Contracts

This screen displays all the locks related to the contract account and contract.

This screen has the following three 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

Utilities Contact Center Administrator Guide


510 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
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.

Select a contract and use Actions Edit Block to edit details such as Billing Reason and Release Reason for
a contract.

Contract Locks

When you select a contract in the Contracts table, the corresponding locks for the contract are displayed in the
Contract Locks table. 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.

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

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 511
3.2.4.1.6 Open Items

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.

3.2.4.1.7 Account History

This screen displays history of all financial transactions pertaining to the contract account.

For the selected line item, you can perform the Reversal action.

3.2.4.1.8 Collection

This screen displays the collections details pertaining to the open contract account.

Utilities Contact Center Administrator Guide


512 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
The details that appear in the Collections tab are:

• 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. Write-off data provides information on a
business partner's payment history.

3.2.4.1.9 Security Deposit

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.

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 513
3.2.4.1.10 Communication Preference

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.

Utilities Contact Center Administrator Guide


514 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
Related Information

Configure Smart Energy Water [page 25]


Configure the Communication Preferences, Consumption Graph, Outage map, and Compare tabs from SAP
Cloud for Customer to integrate the Smart Energy Water (SEW) with SAP ERP system .

3.2.4.1.11 Consumption Graph

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

Configure Smart Energy Water [page 25]


Configure the Communication Preferences, Consumption Graph, Outage map, and Compare tabs from SAP
Cloud for Customer to integrate the Smart Energy Water (SEW) with SAP ERP system .

3.2.4.1.12 Billing Plans

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.

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 515
3.2.4.1.13 Outage Map

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.

Utilities Contact Center Administrator Guide


516 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
Related Information

Configure Smart Energy Water [page 25]


Configure the Communication Preferences, Consumption Graph, Outage map, and Compare tabs from SAP
Cloud for Customer to integrate the Smart Energy Water (SEW) with SAP ERP system .

3.2.4.1.14 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

Configure Smart Energy Water [page 25]


Configure the Communication Preferences, Consumption Graph, Outage map, and Compare tabs from SAP
Cloud for Customer to integrate the Smart Energy Water (SEW) with SAP ERP system .

3.2.4.1.15 Convergent Invoice

View all convergent invoices for contract account in Convergent Invoice tab.

The convergent invoice is also enabled in central tab to view the recent invoices of contract account.

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 517
Create new invoice for contract account by selecting the New option. The create functionality works only when
the IS-U invoices has been created successfully and the corresponding line items appears as billable items.

Click Invoice No. to display all billing documents for the invoice.

3.2.4.2 Contract Account Object Title

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.

Utilities Contact Center Administrator Guide


518 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
3.2.5 Utilities Views in Customers

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.

Toolbar Options for Utilities

The following utilities specific options are available under Customer:

• Object Hierarchy - Displays the complete object hierarchy for a selected contract account.
• Create Contract Account - Launches a dialog box with mandatory fields required for creating a new
contract account.
• Launch FOP - Launches the front office process that you have defined front office process in the Cloud for
Utilities system and assigned to your utilities solution.

Utilities Screens in Customer

Following utilities screen is scoped-in for customer:

• Utilities 360

3.2.5.1 Utilities 360

A 360-degree overview of the object hierarchy for all the 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 subnodes for this collective contract account.

 Note

• If records for business partners are more than a hundred, an icon for More is displayed.
• The number of Contract accounts/child contract accounts in hierarchy view or list view is limited to
100 by default.

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 519
Utilities Hierarchy

Utilities hierarchy consists of 3 views such as Configurable Hierarchy, Hierarchy view, and List view. The
features of utilities hierarchy are as follows:

• 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 any object in the hierarchy to display further details in the corresponding details screen.
For example, for a contract account, the Dunning Procedure and Payment Terms are some of the details
displayed in the details screen.
• The contract account (or collective contract) account, premise, contract, installation, and device are
displayed for each top level hierarchy node in Utilities Hierarchy.

Configurable Hierarchy View


The configurable hierarchy displays utilities object structure you have created in theCloud for Utilities 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 as follows:

1. In your Cloud for Utilities-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 Cloud for Utilities system

You can select a configurable hierarchy view from the list for an individual customer or an account.

Utilities Contact Center Administrator Guide


520 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
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.

Alternate views
The list view or hierarchy view displays the utilities object structure you have created in the Cloud for Utilities
system, in your cloud solution. 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.

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 521
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.

Utilities Contact Center Administrator Guide


522 PUBLIC Cloud for Utilities Edition for Utilities Contact Center
Related Information

Configure Utilities 360 [page 480]


As an administrator, you can configure to manage views for Recent History and Hierarchy sections under
Utilities 360 screen of a customer.

3.2.6 Front Office Process

Configure the Front Office Process in your SAP Cloud for Customer.

Launch the front office processes that you have configured in your 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 utilities solution profile. For more information, see Configuring Front Office Process.

3.2.6.1 Configure 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:

• Assign Front Office Processes [page 60]


• Configure Mashup for Front Office Process (FOP) [page 85]

Utilities Contact Center Administrator Guide


Cloud for Utilities Edition for Utilities Contact Center PUBLIC 523
Important Disclaimers and Legal Information

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

Videos Hosted on External Platforms


Some videos may point to third-party video hosting platforms. SAP cannot guarantee the future availability of videos stored on these platforms. Furthermore, any
advertisements or other content hosted on these platforms (for example, suggested videos or by navigating to other videos hosted on the same site), are not within
the control or responsibility of SAP.

Beta and Other Experimental Features


Experimental features are not part of the officially delivered scope that SAP guarantees for future releases. This means that experimental features may be changed by
SAP at any time for any reason without notice. Experimental features are not for productive use. You may not demonstrate, test, examine, evaluate or otherwise use
the experimental features in a live operating environment or with data that has not been sufficiently backed up.
The purpose of experimental features is to get feedback early on, allowing customers and partners to influence the future product accordingly. By providing your
feedback (e.g. in the SAP Community), you accept that intellectual property rights of the contributions or derivative works shall remain the exclusive property of SAP.

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.

Bias-Free Language
SAP supports a culture of diversity and inclusion. Whenever possible, we use unbiased language in our documentation to refer to people of all cultures, ethnicities,
genders, and abilities.

Utilities Contact Center Administrator Guide


524 PUBLIC Important Disclaimers and Legal Information
Utilities Contact Center Administrator Guide
Important Disclaimers and Legal Information PUBLIC 525
www.sap.com/contactsap

© 2023 SAP SE or an SAP affiliate company. All rights reserved.

No part of this publication may be reproduced or transmitted in any form


or for any purpose without the express permission of SAP SE or an SAP
affiliate company. The information contained herein may be changed
without prior notice.

Some software products marketed by SAP SE and its distributors


contain proprietary software components of other software vendors.
National product specifications may vary.

These materials are provided by SAP SE or an SAP affiliate company for


informational purposes only, without representation or warranty of any
kind, and SAP or its affiliated companies shall not be liable for errors or
omissions with respect to the materials. The only warranties for SAP or
SAP affiliate company products and services are those that are set forth
in the express warranty statements accompanying such products and
services, if any. Nothing herein should be construed as constituting an
additional warranty.

SAP and other SAP products and services mentioned herein as well as
their respective logos are trademarks or registered trademarks of SAP
SE (or an SAP affiliate company) in Germany and other countries. All
other product and service names mentioned are the trademarks of their
respective companies.

Please see https://www.sap.com/about/legal/trademark.html for


additional trademark information and notices.

THE BEST RUN

You might also like