Professional Documents
Culture Documents
for
Customer Assistance
V1.0
Solution Design Document
Version Control
Table of Contents
1. Overview ......................................................................................................................................... 5
2. Business Process ............................................................................................................................. 5
CA-1: Receipt and Classification of Customer Concern ...................................................................... 5
Inquiries .......................................................................................................................................... 5
Requests ......................................................................................................................................... 7
Complaints ...................................................................................................................................... 8
Action needs to perform in C2M ................................................................................................. 10
3. Acronyms ...................................................................................................................................... 12
4. Glossary ......................................................................................................................................... 13
5. To-Be solution ............................................................................................................................... 14
5.1. Receipt and Classification of Customer Concern .................................................................. 14
Business Requirement Mapping ................................................................................... 14
Functional Process Flow ................................................................................................ 15
Solution Description ...................................................................................................... 15
Design Components ...................................................................................................... 52
High-Level Test Acceptance Criteria ............................................................................. 76
6. Generic Configurations ................................................................................................................. 77
6.1. Case Type .............................................................................................................................. 77
6.2. Characteristic Type................................................................................................................ 78
6.3. IWS Configuration ................................................................................................................. 80
6.4. Data Area .............................................................................................................................. 81
6.5. Custom Fields ........................................................................................................................ 82
6.6. Service Task Type .................................................................................................................. 82
6.7. Business Objects ................................................................................................................... 83
6.8. Service Scripts ....................................................................................................................... 85
6.9. Algorithm Types .................................................................................................................... 87
6.10. Algorithms ......................................................................................................................... 89
6.11. Plug-in scripts .................................................................................................................... 90
6.12. Feature Configurations ..................................................................................................... 91
6.13. Extendable Lookups .......................................................................................................... 91
6.14. External System................................................................................................................. 92
7. Integration Flow ............................................................................................................................ 95
8. Gap Analysis .................................................................................................................................. 97
1. Overview
This document aims to describe the specific functionalities and information about the Customer
Assistance process. This design is based on the respective business processes and requirements that
have been discussed in the Requirements Analysis workshops.
As a part of the Customer Assistance Process, the Management of Customer Concern is defined to
efficiently address customer concerns regarding the different customer process-related services. To
provide timely and accurate responses to customer queries, the process is drafted to ensure the
correctness of the information that shall be given to the customer.
2. Business Process
This section explains the design specifications for various business processes related to Customer
Assistance module.Each of the requirements will be given an identifier so that it can be tracked
during the design and testing phases. The business process for each of the requirements will be
captured end-to-end, which will be explained in detail below.
The types of inquiries that will be handled by the Company are any of the following:
CASE
RECORD CONCERN TYPE CONCERN SUB-TYPE
TYPE
Inquiry Billing & Payments Inquiry on a Service’s Reading Date
Inquiry Billing & Payments Inquiry on Bill / DN Delivery
Inquiry Billing & Payments Inquiry on Bill Amount and Bill Details
Inquiry Billing & Payments Inquiry on Bill Computation
Inquiry Billing & Payments Inquiry on Consumption
Inquiry Billing & Payments Delinquency Management Status
Inquiry Billing & Payments Bill Presentment Process
Inquiry Billing & Payments Inquiry on Delinquency Management Process
Inquiry Billing & Payments Inquiry on Payment
Inquiry Billing & Payments Payment Process
Inquiry Billing & Payments Payment Status
Inquiry Billing & Payments Schedule / Status of Bill / DN Delivery
Inquiry Billing & Payments Paperless Billing Subscription (and Cancellation)
Inquiry Billing & Payments Cash Advance Refund Inquiry
Customer Assistance Design Document Page 5 of 109
Solution Design Document
All inquiries will be settled on the same day. The receiving personnel shall strive to provide the
information being requested by the customer. If the information is not readily available, the
receiving personnel shall be responsible for determining how the query can best be answered, by
company policies and procedures, and provide this information to the customer within the same
day.
For Service Irregularity (SI) cases, inquiries on the responsible service office or contact person will be
handled by the receiving office. However, if the concern on the SI case already pertains to details of
the case or bill, the customer shall be advised to contact the responsible office directly.
Requests
As a part of the Customer Assistance Process, the Management of Customer Requests is defined to
efficiently address customer requests related to customer service processes. To satisfy the needs of
the customers, the process is drafted to ensure timely and quality provision of the requested service
of the customer.
The types of requests that will be handled by the Company are any of the following:
The receiving office shall be responsible for creating record for these requests. The processing of
requests for Line Conductor Cover Installation, Line Conductor Cover Removal, Escort Services,
Temporary Power Interruption, etc. will be the responsibility of the Corporate Business Group, Home
and Micro Business Group and BIZ Partners Group.
Complaints
As a part of the Customer Assistance Process, the Management of Customer Complaints is defined to
efficiently address customer Complaints related to customer service processes. To satisfy the needs
of the customers, the process is drafted to ensure timely and quality provision of the requested
service of the customer.
The types of complaints that will be handled by the Company are any of the following:
CASE RECORD
CONCERN TYPE CONCERN SUB-TYPE
TYPE
COMPLAINT Billing & Payments High Billing
COMPLAINT Billing & Payments Low Billing
COMPLAINT Billing & Payments Undelivered Bill
COMPLAINT Billing & Payments Vacant with Consumption
COMPLAINT Billing & Payments Disconnected with Consumption
COMPLAINT Billing & Payments Flat Streetlight High Billing
COMPLAINT Billing & Payments Erroneous BA Bill
COMPLAINT Billing & Payments Erroneous Payment Posting
COMPLAINT Billing & Payments Erroneous AWA Tagging
COMPLAINT Billing & Payments Unposted Payment
COMPLAINT Meter Concerns Blurred Meter Glass
COMPLAINT Meter Concerns Broken Meter Glass Cover
Customer Assistance Design Document Page 8 of 109
Solution Design Document
• As much as possible, all customer complaints should be made in writing except when the
complaint is regarding power interruption or operating trouble related.
• A written protest letter shall be requested from the customers making a complaint.
• The letter shall include the details on the exact nature of the complaint, any justification or proof
that will support the customer’s claim, the desired action of the customer to resolve the
complaint, customer identity and location and contact information for customer feedback.
However, if the customer does not wish to write the letter, the complaint shall still be received
and recorded.
• The receiving personnel shall check with the customer the accuracy of the complaint that was
taken.
• The receiving personnel shall ensure that customer complaints are referred to the appropriate
responsible office for handling.
• Complaints on Power Outages and other Distribution Facility related troubles shall be handled by
Customer Care Group, HMB, BIZ, and CBG.
• All concern types as well as the actions for each are listed in the attached concern inventory file
below.
CIS_CA_DesignMatr
ix.xlsx
• All action/transaction (e.g. billing adjustment, discount application, etc.) updates and resolution
details will be sent to CXE by C2M.
Complaints
• As much as possible, the customers shall be updated on the actions being done to resolve
their complaints.
• Feedback to the customer shall be given within fifteen (15 days) from receipt of the
complaint through a letter (Feedback Letter or FL).
• If the resolution of the complaint will take more than fifteen (15) days, an initial feedback
letter shall be provided to the customer.
• Once the concern is resolved, Meralco will provide the final feedback letter to the customer.
• The recipient and receipt date and time of the feedback letter shall be recorded.
• The Concern Record shall be considered closed when no further communication is received
from the customer within fifteen (15) days from receipt of the final feedback letter.
• Receiving a copy of the feedback letter shall be filed for records purposes.
Requests
• The requesting customer shall be informed of the status and details of the request in writing
within five (5) working days from receipt of the request.
Generally, a Concern Record shall be considered closed upon provision of final feedback to the
customer and recording of the feedback receipt details. As for complaints, a customer shall be
given fifteen (15) days starting from receipt of the final feedback to raise his issues about the
matter. In case no feedback was received from the customer within that period then the
Concern Record shall already be considered closed. Additionally, if the concern is resolved in
CXE, an interface with C2M should take place to lift the suspension of Management of Unpaid
Bills (MUB).
C2M must observe permanent deletion of personal data collected and processed for the
management of customer inquiries, requests, and complaints, especially when the concern
record is already closed. Per the DPA of 2012, personal data must be permanently deleted once
the purpose for collecting/processing such has already been fulfilled.
3. Acronyms
Acronym Description
CA Customer Assistance
Acronym Description
FO Field Order
IVR Interactive Voice Response
SA Service Agreement
SI Service Irregularity
4. Glossary
SNO Feature Name Description
5. To-Be solution
This section explains the intended solution and the specifications for various process components in
respective C2M functionality. Process components for each business process will be detailed end to
end. The scope of each business process and related components in each of the business flows will
be explained in detail.
Solution Description
Design Overview
• Customer Assistance process as described in the Flow diagram starts with accepting and lodging
the consumer concerns
• A consumer concern can be related to any of the services it is using like Billing, Payments,
Metering, etc.
• CXE System handles the entire lifecycle of the consumer concern request processing.
• For every user concern request, CXE System will create a Concern Record in its system.
• CXE System will then gather relevant information for the concern.
• For Inquiries, there shall be no need for interface between CXE and C2M. But there are other
concerns for which CXE system will have to communicate with C2M system. Such concerns are
Complaints or Requests.
• For the communication purpose with C2M system, Interfaces are proposed.
• Interfaces are the medium for the communication in between C2M system and any external
system.
• Classification of customer concerns and Interfaces is available in the Business Process section.
• CXE will use the CXE Case Number (CaseNumber) of its system as the Primary Key to
Communicate with C2M. The CXE Case Number shall be stored together with the Life Cycle
record or transaction that will be created after the interface.
• The same Key will be used by C2M System to send the updates on concern back to the CXE
System.
• The following sections will cover up the proposed solution to handle the C2M dependent action
items for the different Concern Types.
• There will be a facility to manually create a Service Task or CA record.
• Users will be allowed to bypass or skip some events or processes in the child activity as needed.
• The outline of the solution design for the communication process in between CXE and C2M
System primarily involves following processes:
• Interfaces are the main design components; it has a business logic to process and an XML
wrapper over it.
• XML wrapper contains Data Fields. Data Fields are the main place holder in the interface for the
incoming and outgoing data
• Data Fields are designed as per the requirement.
• Data Fields can be put in Input/Output groups to separate the fields.
• Set of Data Fields is known as Payloads/Schema of the interface.
• Interfaces will be exposed to the External System by a Service URL. Payload information will be
kept in a file and will be shared to the External System. This document will be the part of
Integration documents for different services.
• The following diagram is the sample payload and common field related information for interface
between CXE and C2M. Common field will be used by both system for syncing the data.
• Based on the requirement and scope, the interfaces can be divided into 2 major categories
Inbound and Outbound.
• For any communication where the Target system is C2M it will be the handled by an Inbound
Interfaces. Whereas for Outbound Interface C2M system will work as Source System.
• Communication of C2M with the External System is ruled by another layer which is known as the
middle/Integration Layer.
• Following diagram explains the role of different layers and the Interface hierarchy:
• As explained, interfaces are the main component used for communication with C2M.
• Handling of the concerns in C2M further requires processes, sub-process, and the action items to
be triggered.
• An Inbound Interface to the C2M further triggers the action items in C2M system. This will be
fully an automated activity.
• The action items can belong to the different module like Billing, Payments, Metering, Field
Orders, MUB (Credit & Collection) etc.
• A detailed explanation of the action items/process is available in the module specific SDD.
• Details of the concerns processes is available in the following file. This file also has the detail of
the processes involved for handling of the concerns in C2M.
CIS_CA_DesignMatr
ix.xlsx
• As it is clear from the file, the handling of the concerns in C2M will be driven by the processes.
• In this document, handling of the concerns will be explained processes wise rather concern wise
as concerns may have common set of the processes.
• Now based on the handling of the concerns in C2M, concerns can be categorized primarily in
following two types:
1. Handling through Life-Cycle Process Initiation – For some consumer concerns handling is
required a lifecycle process initiation in C2M. Process Initiation will be automated. Handling
of the process will be done within the lifecycle process.
2. Handling through Transaction in C2M – This category will cover up the consumer concerns
for which initiation of a transaction in C2M system is required. For example, FO initiation,
Device Event Initiation, Account data updating, Person mobile number updating etc. Here
also Initiation of the transaction in C2M will be automated.
Following is the list of some common Processes/Sub-Processes which are involved directly or
internally in the handling of the concerns, In the following sections these are explained in detail.
Figure 5: Life Cycle process Flow Diagram for handling Billing Concerns
Figure 6: Life Cycle process Flow Diagram for handling Metering Concerns
lifecycle process to handle the process. Initiation of this dedicated lifecycle process will be
automatically triggered by the Inbound interface request.
❖ The moment concerns will get closed, the removal of suspension of the delinquency process
is required.
❖ This activity plays a very important role in handling of many concerns.
❖ A detailed explanation of this process is given in the module-MUB SDD and in CA SDD.
❖ Check the following details of the concerns for which this process is used directly/internally.
SNo Concern Sub Reference MUB On- C2M Proposed Input Fields
Type Document holding
/removal
of on-
holding
process
initiation
1 High Billing CA Module SDD, Triggered
On-holding of in another
MUB/removal of Lifecycle
on-holding of process
MUB: Solution
Description,
Section: 5.1.3.6.3.
2 Low Billing CA Module SDD, Triggered
On-holding of in another
MUB/removal of Lifecycle
on-holding of process
MUB: Solution
Description,
Section: 5.1.3.6.3.
3 Disconnected CA Module SDD, Triggered
with On-holding of in another
Consumption MUB/removal of Lifecycle
on-holding of process
MUB: Solution
Description,
Section: 5.1.3.6.3.
4 Vacant with CA Module SDD, Triggered
Consumption On-holding of in another
MUB/removal of Lifecycle
on-holding of process
MUB: Solution
Description,
Section: 5.1.3.6.3.
5 Undelivered CA Module SDD, Triggered
Bill On-holding of in another
MUB/removal of Lifecycle
on-holding of process
MUB: Solution
Description,
Section: 5.1.3.6.3.
6 Flat CA Module SDD, Triggered
Streetlight On-holding of in another
High Billing MUB/removal of Lifecycle
on-holding of process
MUB: Solution
Description,
Section: 5.1.3.6.3.
Customer Assistance Design Document Page 23 of 109
Solution Design Document
On-holding of Lifecycle
MUB/removal of process
on-holding of
MUB: Solution
Description,
Section: 5.1.3.6.3.
16 IPA Extension CA Module SDD, Triggered
On-holding of in another
MUB/removal of Lifecycle
on-holding of process
MUB: Solution
Description,
Section: 5.1.3.6.3.
17 RCOA – CA Module SDD, Triggered
Desist from On-holding of in another
Disconnection MUB/removal of Lifecycle
on-holding of process
MUB: Solution
Description,
Section: 5.1.3.6.3.
18 MUB CA Module SDD, Triggered
Suspension On-holding of Via CXE
MUB/removal of
on-holding of
MUB: Solution
Description,
Section: 5.1.3.6.3.
19 Payment CA Module SDD, Triggered
Reallocation On-holding of in another
MUB/removal of Lifecycle
on-holding of process
MUB: Solution
Description,
Section: 5.1.3.6.3.
20 Credit CA Module SDD, Triggered
Transfer On-holding of in another
MUB/removal of Lifecycle
on-holding of process
MUB: Solution
Description,
Section: 5.1.3.6.3.
21 Credit CA Module SDD, Triggered
Allocation On-holding of in another
MUB/removal of Lifecycle
on-holding of process
MUB: Solution
Description,
Section: 5.1.3.6.3.
Table 9: Concerns List: Handling involves On-holding of MUB/removal of on-holding of MUB process
5.1.1.3.1.12 Discount
❖ To handle certain concern while in the lifecycle process initiation or handling of the Discount
process is required.
❖ Detail of the process of Discount can be checked in the Billing and SI Module SDD.
❖ The following concerns are related to this process.
❖ A step-by step explanation of the lifecycle process which involves this process is mentioned
in the file (CIS_CA_DesignMatrix), which is attached in this document.
❖ Details required to proceed with the creation of the discount shall be inputted in C2M.
Table 20: Concerns List: Handling involves Bill Due Date Related process
Module SDD,
Section: 5.1. Field
Order Generation &
Initiation
20 Denial of Service Order
Violation Management
Module SDD,
Section: 5.1. Field
Order Generation &
Initiation
21 Request for Service Order
Meter Management
Replacement Module SDD,
Section: 5.1. Field
Order Generation &
Initiation
22 Request for Service Order
Meter Test Management
Module SDD,
Section: 5.1. Field
Order Generation &
Initiation
23 Request for Service Order
Special Meter Management
Reading Module SDD,
Section: 5.1. Field
Order Generation &
Initiation
24 RCOA - Service Order
Special Meter Management
Reading Module SDD,
Section: 5.1. Field
Order Generation &
Initiation
25 RCOA – Service Order
Disconnection Management
Module SDD,
Section: 5.1. Field
Order Generation &
Initiation
26 RCOA – Service Order
Reconnection Management
Module SDD,
Section: 5.1. Field
Order Generation &
Initiation
Table 21: Concerns List: Handling involves FO Related process
5.1.1.3.2.1 IPA
This process is required to initiate/create the IPA (INSTALLMENT PAYMENT AGREEMENT) process in
C2M. Detail explanation of the process is documented in the MUB SDD. Related concerns are listed
below.
File: CIS_CA_DesignMatrix which is attached in this document can be referred to check the steps
designed for handling of such concerns.
• The name of person who updated the records and date of records that were updated will be
recorded in the lifecycle.
Table 24: Concerns List: Handling involves Account update Related process
12
• The Collection Process (aka MUB in Meralco) is triggered for all accounts automatically by
the Account Debt Monitoring (ADM) batch.
• In the Collection Class Control, the collection conditions are defined.
o The conditions are defined using Collection Condition Priority and Condition
Algorithm
o Based on the screen, Condition Algorithm are validations that will happen to the
Collection Process for the defined Collection Class Control (e.g., Check if severance
process exists for SA in debt class, check if account is on budget, always return true)
Customer Assistance Design Document Page 45 of 109
Solution Design Document
while Collection Condition Priority defines the level of priority the validation
algorithm will happen.
o In the Debt Criteria, the MUB process steps are defined for each Condition
Algorithm.
▪ Arrears Priority – priority of the execution of the Collection Process
Template based on minimum Arrears Amount
▪ Collection Process Template – MUB step
▪ Arrears Amount
▪ Days – number of days before MUB process is triggered
• One Debt Class may be defined for each collection process scenario (the example used is
that a collection handling is defined for all Standard Utility Debt Class, but a different
Collection Class Control can be defined for other Debt Classes such as Charity, OTC, Deposit,
Non-bill Budget, etc.). In the example of Standard Utility Debt Class, all Standard Utility Debt
Classes have the same collection rules.
o Under an Account, there may be multiple SA types associated to the Debt Class.
▪ For each SA under the Debt Class, the SA Info, Premise, Total Current
Balance, and breakdown of SA Arrears by days old and amount (the example
SAs provided are gas residential, electric residential and water residential)
o For each Account record, different Debt Classes may be defined.
o Each Debt Class for the Account has Current Balance and Payoff Balance details.
▪ Current Balance – Amount the company is charging the customer
▪ Payoff Balance – Amount required for payment to not initiate collection
process
o Only the delinquent amounts are considered for the collection process
o In the scenario for 1CAN: Many SINs scenario, the different SAs under the Debt Class
may be the different Electric Service Agreements.
o Delinquent amount refers to the amount that fulfills the criteria for Collection/MUB
process in the Collection Class Control and Debt Criteria
o Payments to be made to the account will be distributed based on the priorities
defined for each Debt Class and SA.
o The example Debt Classes for an Account can be as following:
▪ Charitable Contribution – different SA type where payoff balance is zero
because customer is not required to pay
▪ Payment Arrangement – different SA type
▪ Standard Utility Debt – different debt class with multiple SAs
▪ Write-off – handled of balances that the company cannot recover anymore
• The customization will be if Meralco were to pursue a service-level MUB. Which will be as
follows:
SA Type Details and Payment Priority + Delinquent Pay Priority. To illustrate solution to a SA,
SA has a Payment Priority and Delinquent Pay Priority. These priorities must be defined per
SA and based on those; the payment will be distributed. Delinquent Pay Priority serves as a
sub priority level in case two SAs have the same Payment Priority. If Meralco will go with the
service-level MUB, the priority for each service should be defined.
Collection Process for Bills with Balances Tagged under a Concern Record
• For the scenario when an amount is tagged with concern when MUB is active for an
account.
• MUB Handling for OOTB Solution. For the OOTB solution, the moment MUB is triggered, all
balances of delinquent SAs under the account will be added to represent the Collection
Amount.
o The Collection Amount which is the overall balance the customer needs to pay while
the Amount Still Owing is the amount that should be paid for the Account to come
out of the collection/MUB process.
o Currently, the OOTB does not support SA Level MUB.
• System Configuration to Support SA Level MUB. To support Meralco’s requirement of
suspending MUB for a certain SA when the balance is tagged under a concern, the system
will be designed so that the balance in Amount Still Owing will automatically be transferred
to a Dispute Service Agreement with a different Dispute Debt Class with altered trigger dates
for collection process events.
• Proposed solution is to shift the trigger date for each Collection Event under the Collection
Process to 100 years ahead so they will not be triggered in the near future. This amount
should stay in that particular SA and Debt Class until the concern is resolved or cancelled.
o These actions will be part of the the life cycle in C2M triggered by a concern type.
o To identify the specific amount which must be pushed to a dispute SA, for each
concern, the particular SA ID for which the dispute must be raised so that the
balance may be pushed from the initial SA to the dispute SA. They confirmed that a
specific Bill ID/Bill Segment amount can be identified because every Bill Segment ID
is linked to a SA ID.
o There should be only one Bill Segment ID per case, and this case will have one
process. This is connected to the request to have only one Bill Segment ID per
payload.
o To revert the trigger dates to resume the MUB process. As per proposed solution
there will be a monitor algorithm in the case life cycle in the CA module will keep
watch on the status until it is resolved. Once resolved, the monitor algorithm will
change the trigger date back to the current date. Succeeding events will also be
reverted, following the parameters set for the period between events. If a specific
MUB event period has already started before the concern was raised, once the
concern is resolved, it will consider the buffer/remaining days for the event and
resume from there again.
• A different handling will be needed wherein the amount will be manually identified from the
SA and placed in a Dispute SA. In the case of rebilling, if a certain amount will now be
collectible and part of the MUB process again, the balance will have to be manually moved
from the Dispute SA to another SA.
o If it does not exists create collection process and change Collection trigger dates
to 100 +Years - MUB Process.
❖ If request is meeting Scenario:2 create concern sub type case.
o Process initiated to create concern sub type case.
o If the case lifecycle has steps/status for Hold MUB, then C2M System checks for
Active MUB.
▪ If Active MUB exists change collection trigger dates to 100+Years
- MUB Process.
▪ If it does not exists create collection process and change
Collection trigger dates to 100 +Years - MUB Process.
o Related concern sub type process continued.
o To execute Release of holding of MUB:
▪ Identify customer eligible buffer time from collection process
template and add buffer time to current date and change
collection trigger dates – MUB Process.
❖ Service task will keep waiting for concern closure.
❖ Service task will have a Monitor process configured; it will work as follows:
o If case is not completed-> Waiting for concern closure-> Monitors in
Progress Case-> Related concern sub type process continues.
❖ Once the Case gets completed.
❖ Monitor logic will complete Service Task.
❖ The End.
For correction
Perform corrections
Resolve complaint
Provision of Feedback to
Customer
Requirements
submitted
Incomplete requirements
Advise the customer to submit all
necessary requirements
Not approved
Approved
Resolve request
Provision of Feedback to
Customer
Design Components
Configurations and development of the following components are required:
1. Algorithms
2. Algorithm Types
3. Business Objects
4. Case Types
5. Characteristic Type
6. Custom Fields
7. Data Area
8. External System
9. IWS Configuration
10. Lookups
11. Message Sender
12. Outbound message Type
13. Plug-in scripts
14. Service Scripts
15. Service Task Type
In the following section components, which are required to meetup the design of the solution is
explained. Section Component Type has a brief introduction about the component whereas in the
sub-section an example of that type of component is specified.
Service task types define properties common to specific types of service tasks. Service task types
represent different types of tasks that can be performed by:
RELATED Cm-CAConcernTaskTypeTransBO
TRANSACTION BO
DETAILED
DESCRIPTION
Configuration Mapping
GBILL BILL
Long
Description
MAINTENANC F1-STASKTYPE
E OBJECT
APPLICATION F1-STASKTYPE
SERVICE
BO Option
Long Description Main Business Object for CA Create Concern service task
MAINTENANCE F1-SVCTASK
OBJECT
APPLICATION CM-CACONCERNTASKBOA
SERVICE
BO Option
Every Business Object has the placeholder to design a Lifecycle over it. The Lifecycle can be designed
to meetup the Business requirement. To achieve this different lifecycle status has to be designed
and configured into the system over a Business Object.
In the status placeholders are available to plugin Algorithms (technical component used to execute
business logic). Triggering point of these algorithms are event driven. For example, entering into an
status, or exiting a status can be the example of such events. At these events the custom algorithms
will be hit and get executed.
Switching from a status to another status can be handled in both ways I.e.by User or through
System. In create concern scenario it will be handled through System only.
BO: Cm-CACreateConcernServiceTask has a Lifecycle process which is for overall handling of the
concern. In the following section different status are explained in detail.
Status PENDING
Description Pending
Script
Access Mode Pending
Status Condition Initial
Transitory State No
Alert No
Display Sequence 10
Batch Control
Comment
Algorithms
System Event Sequence Algorithm Existing/new
Monitor 10 F1-TRN-DF-NS Existing
Next Statuses
Status Action Label Seq Use as Transition Condition Transition Role
Default
1 Validate 10 Yes OK System
Required Characteristics
Description Required
Apart validations a to-do will be initialized at this status for the responsible office to input the
optional data required for the concern.
A Monitor algorithm will be plugged-in to this status which will keep on checking whether the
optional data which is required for the concern is provided or not.
Validate
Status VALIDATE
Description Validation
Script
Access Mode In-Progress
Status Condition Interim
Transitory State Yes
Alert No
Display Sequence 20
Batch Control
Comment
Algorithms
System Event Sequence Algorithm Existing/new
Enter 10 CM_CAREQVALD New
Next Statuses
Status Action Label Seq Use as Transition Condition Transition Role
Default
1 Process Customer 10 Yes OK System
Contact and Case
2 Error 20 No Exception System
3 HOLD MUB 30 No Approved System & User
Required Characteristics
Description Required
An Algorithm is required at this status. This algorithm will perform the following logic:
a) This Algorithm component will check Active C&C(MUB) process is present or not.
b) If present change its Collection Event Trigger Dates to +100 Years.
c) If not present create Collection Process and changes its collection Event Trigger Dates to
+100 years.
A monitor algorithm will be plugged-in to this status, which will keep on monitoring the closure of
the lifecycle process(case). The moment case gets closed Service Task will be completed and the
same will be informed to the CXE system.
Status PROCESS
Description Create Concern Sub Type Case
Script
Access Mode In-Progress
Status Condition Interim
Transitory State Yes
Alert No
Display Sequence 40
Batch Control
Comment
Algorithms
System Event Sequence Algorithm Existing/new
Enter 10 CM_SVCSUCESS New
Next Statuses
Status Action Label Seq Use as Transition Condition Transition Role
Default
1 Complete 10 Yes OK System
2 Error 20 No Exception System
Required Characteristics
Description Required
Status RELEASEMUB
Description RELEASE MUB
Script
Access Mode In-Progress
Status Condition Interim
Transitory State Yes
Alert No
Display Sequence 50
Batch Control
Comment
Next Statuses
Status Action Label Seq Use as Transition Condition Transition Role
Default
1 Complete 10 Yes OK System & User
2 Error 20 No Error System
Required Characteristics
Description Required
Status DISCARD
Description Discarded
Script
Access Mode Complete
Status Condition Final
Transitory State No
Alert No
Display Sequence 80
Batch Control
Comment
Algorithms
System Event Sequence Algorithm Existing/new
Next Statuses
Status Action Label Seq Use as Transition Condition Transition Role
Default
Required Characteristics
Description Required
Complete
Status COMPLETE
Description Complete
Script
Access Mode Complete
Status Condition Final
Transitory State No
Alert No
Display Sequence 100
Batch Control
Comment
Algorithms
System Event Sequence Algorithm Existing/new
Next Statuses
Status Action Label Seq Use as Transition Condition Transition Role
Default
Required Characteristics
Description Required
Status ERROR
Description Error
Script
Access Mode Error-CCB
Status Condition Final
Transitory State No
Alert No
Display Sequence 90
Batch Control
Comment
Algorithms
System Event Sequence Algorithm Existing/new
Next Statuses
Status Action Label Seq Use as Transition Condition Transition Role
Default
Required Characteristics
Description Required
Script CM_CACONCERN
Description To receive the IWS for CA Concern
DETAILED
DESCRIPTION
Script Type Service Script
APPLICATION SERVICE F1-DFLTS
Table 37: Service Script Details
The Step section has the logic to handle the Concern, This section covers the initial scanning of the
input data and deciding the action itmes for the concern.
Following Schema will be exposed to the CXE system, by putting a wrapper on it, This wrapper will
be called IWS Service, Detailed information of this component can be checked in the following
process where the navigation option is captured to create an IWS Service.
IWS Service
Following is the Navigation path for the Deployment of the Service, this step will be executed just
after the Add IWS service process is completed.
Once the deployment is done IWS Service page will look as follows, a LINK for the WSDL of the
service will appear on the page. WSDL will provide the interface to access the Business Process
behind the IWS Service.
Invoke OutMessageType BO -> It will find the External System and the Message Sender->Message
Sender->hit the Outbound Service
Outbound Message BO is a technical component, primarily used for Outbound Interfaces. Check the
following flow to understand the role of this component
Invoke OutMessageType BO -> It will find the External System and the Message Sender->Message
Sender->hit the Outbound Service
5.1.1.16.2. BO Schema
Message Sender
Message Sender is a technical component used for the configuration of the Outbound Service-
related information.
Customer Assistance Design Document Page 73 of 109
Solution Design Document
This includes many parameters like the URL of the outbound service, credentials to access the
service, timeout parameters etc.
Invoke OutMessageType BO -> It will find the External System and the Message Sender->Message
Sender->hit the Outbound Service
6. Generic Configurations
Following are the various configuration we must keep in C2M to run the CA Business Process.
The information below will only contain the C2M Master Data Configuration for the business process
covered in this document. Complete C2M Master Data Configuration, including Organization
Elements and Master Data Structures, will be documented in the C2M Configuration Workbook.
Case Types Life Cycle process in C2M. This process can be configured as an entity and
lifecycle processes can be designed on it.
Table 39: Case Type details
Characteristic Type Characteristic type entities are used to capture additional information for
an entity.
IWS Configuration Inbound Web Services are configured in the system over Schema-based
components like Service Scripts, Business Services, and Business Objects.
IWS is configured to provide the wrapper over these components for
integration purposes. This Configuration provides a WSDL to share with an
external system.
Data Area This component is used to configure the standard set of fields to be induced
in the Schema based component to configure their schema.
Table 41: Data Area Details
Custom Fields While designing the schema of a component if the field level information is
not available in the system then new fields have to be configured in the
C2M system. These fields are known as custom fields. Field name initials will
be CM. This makes the identification of such fields easy.
Table 42: Custom fields Details
Service Task Type This Configuration is required to design a lifecycle process on a set of data.
This data usually comes from external systems.
Table 43: Service task Type Details
Business Object This component is schema-based. It provides the lifecycle process on a set
of data. This data belongs to the set of predefined tables. A set of
predefined tables can be configured under the Maintenance Object entity
configuration.
Table 44: Business Object
Service Scripts This component is schema-based. Using this component we can write the
Business Process Logic.
Table 45: Service Script
Algorithm Type Algorithm types and algorithms are the components that are used to
execute a custom logic at predefined process spots in C2M. Like Case Type
Enter Processing/Validations/Exit Processing or Customer Class pre
Billing/post Billing/Payment Freeze Spots. A Custom logic first has to be
developed and then it will be plugged into the spot for which it is
developed.
6.10. Algorithms
Relationship Type Description
Algorithm Type Algorithms are the objects created for Algorithm Type. By Using Algorithm
Type we define a structure by selecting a spot and plug-in the developed
logic.
Plug-in Script This component is used to write the business logic. This component is part
of the development process. The entire process can be coded in the step
section.
Feature This component is used to configure multiple related values for a Key. This
Configuration key will be termed as Feature Name and using this we can get all these
values.
Table 49: Feature Configuration
Extendable Lookup This component is used to configure multiple related values for an entity.
Just like feature configuration, there will be a key to which a set of values
are configured
Table 50: Extendable Lookup
External System This component is used to configure any external system as an entity in
C2M. This component provides the placeholder to configure the URL to
access the External system as well as the credentials and other settings
options available. Login password will be aligned with MERALCO’s password
standard.
7. Integration Flow
This section has the details of the Integration processes involved in entire Customer Assistance
process.
Receipt of Remaining This service will Inbound service Real- R&C C2M
to create
Balance of Deactivated sync up the Time
negative/positive
Prepaid Services, remaining adjustment at
Interface Name: balance in C2M Side.
receiveRamainingBalance between R&C
This will be a sync
and C2M system up request.
for pre-paid
Triggering of the
Services service will be
done by R&C
system.
Based on the
amount it will be
decided whether
the amount to be
released to the
customer or will
it be demanded
from the
customer.
8. Gap Analysis
This section explains the details of the gaps (customizations required in the C2M) identified
to implement the business requirements which are not part of the out of box C2M
functionality to the module detailed in this document.
CA Module SDD,
On-holding of MUB/removal of on-holding of MUB:
Solution Description, Section: 5.1.3.6.3.
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
2 Low Billing Billing Module SDD, Billing Adjustment, Section: 5.7.8.1
CA Module SDD,
On-holding of MUB/removal of on-holding of MUB:
Solution Description, Section: 5.1.3.6.3.
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
3 Disconnected with Billing Module SDD, Billing Adjustment, Section: 5.7.8.1
Consumption
CA Module SDD,
On-holding of MUB/removal of on-holding of MUB:
Solution Description, Section: 5.1.3.6.3.
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
4 Vacant with Consumption Billing Module SDD, Billing Adjustment, Section: 5.7.8.1
CA Module SDD,
On-holding of MUB/removal of on-holding of MUB:
Solution Description, Section: 5.1.3.6.3.
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
5 Erroneous BA Bill Billing Module SDD, Billing Adjustment, Section: 5.7.8.1
CA Module SDD,
On-holding of MUB/removal of on-holding of MUB:
Solution Description, Section: 5.1.3.6.3.
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
6 Flat Streetlight High Billing Billing Module SDD, Billing Adjustment, Section: 5.7.8.1
CA Module SDD,
On-holding of MUB/removal of on-holding of MUB:
Solution Description, Section: 5.1.3.6.3.
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
7 Blurred Meter Glass Billing Module SDD, Billing Adjustment, Section: 5.7.8.1
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
8 Broken Meter Glass Cover Billing Module SDD, Billing Adjustment, Section: 5.7.8.1
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
9 Broken / Missing Terminal Seal Billing Module SDD, Billing Adjustment, Section: 5.7.8.1
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
10 Burnt Meter Billing Module SDD, Billing Adjustment, Section: 5.7.8.1
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
11 Deformed / Detached Parts Billing Module SDD, Billing Adjustment, Section: 5.7.8.1
Inside Meter
Service Order Management Module SDD, Section: 5.1. Field
Order Generation & Initiation
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
12 Dial Pointers Out of Alignment Billing Module SDD, Billing Adjustment, Section: 5.7.8.1
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
13 Fast / Slow Meter Billing Module SDD, Billing Adjustment, Section: 5.7.8.1
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
14 Interchanged Meter Billing Module SDD, Billing Adjustment, Section: 5.7.8.1
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
15 Meter Running Even w/o Load Billing Module SDD, Billing Adjustment, Section: 5.7.8.1
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
16 Meter with Dirt Inside Billing Module SDD, Billing Adjustment, Section: 5.7.8.1
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
17 Meter with No Display Billing Module SDD, Billing Adjustment, Section: 5.7.8.1
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
18 Stopped Meter Billing Module SDD, Billing Adjustment, Section: 5.7.8.1
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
19 Undelivered Bill CA Module SDD,
On-holding of MUB/removal of on-holding of MUB:
Solution Description, Section: 5.1.3.6.3.
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
20 Erroneous Payment Posting CA Module SDD,
On-holding of MUB/removal of on-holding of MUB:
Solution Description, Section: 5.1.3.6.3.
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
21 Unposted Payment CA Module SDD,
On-holding of MUB/removal of on-holding of MUB:
Solution Description, Section: 5.1.3.6.3.
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
22 Denial of Violation CA Module SDD,
On-holding of MUB/removal of on-holding of MUB:
Solution Description, Section: 5.1.3.6.3.
Customer Assistance Design Document Page 101 of 109
Solution Design Document
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
23 Erroneous SI Bill CA Module SDD,
On-holding of MUB/removal of on-holding of MUB:
Solution Description, Section: 5.1.3.6.3.
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
24 Request for Billing Adjustment CA Module SDD,
(BA) Discount On-holding of MUB/removal of on-holding of MUB:
Solution Description, Section: 5.1.3.6.3.
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
25 Request for Service Irregularity CA Module SDD,
(SI) Discount On-holding of MUB/removal of on-holding of MUB:
Solution Description, Section: 5.1.3.6.3.
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
26 Request for IPA CA Module SDD,
On-holding of MUB/removal of on-holding of MUB:
Solution Description, Section: 5.1.3.6.3.
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
27 Payment Extension CA Module SDD,
On-holding of MUB/removal of on-holding of MUB:
Solution Description, Section: 5.1.3.6.3.
Customer Assistance Design Document Page 102 of 109
Solution Design Document
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
28 IPA Extension CA Module SDD,
On-holding of MUB/removal of on-holding of MUB:
Solution Description, Section: 5.1.3.6.3.
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
29 MUB Suspension CA Module SDD,
On-holding of MUB/removal of on-holding of MUB:
Solution Description, Section: 5.1.3.6.3.
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
30 Payment Reallocation CA Module SDD,
On-holding of MUB/removal of on-holding of MUB:
Solution Description, Section: 5.1.3.6.3.
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
31 Credit Transfer CA Module SDD,
On-holding of MUB/removal of on-holding of MUB:
Solution Description, Section: 5.1.3.6.3.
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
32 Credit Allocation CA Module SDD,
On-holding of MUB/removal of on-holding of MUB:
Solution Description, Section: 5.1.3.6.3.
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
33 RCOA – Desist from MUB Module SDD, Section: 5.18 Suspension of
Disconnection Disconnection Field Order
CA Module SDD,
On-holding of MUB/removal of on-holding of MUB:
Solution Description, Section: 5.1.3.6.3.
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
34 RCOA – Disconnection MUB Module SDD, Section: 5.12 Customer Request for
Disconnection
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
37 Request for Assistance in Billing Module SDD, Section: 5.7.7 Non-Commodity Billing
Maintenance of Customer
Facilities Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
38 Testing Billing Module SDD, Section: 5.7.7 Non-Commodity Billing
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
39 Miscellaneous Billing Module SDD, Section: 5.7.7 Non-Commodity Billing
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
40 Others (Service Application) – Billing Module SDD, Section: 5.7.7 Non-Commodity Billing
Request for Equipment Rental
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
41 Others (Service Application) – Billing Module SDD, Section: 5.7.7 Non-Commodity Billing
Request for Mechanical /
Chemical Testing Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
42 Request for Escort Services Billing Module SDD, Section: 5.7.7 Non-Commodity Billing
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
43 Request for Cleaning of Billing Module SDD, Section: 5.7.7 Non-Commodity Billing
Transformer Vault
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
44 Stolen Meter Billing Module SDD, Section: 5.7.7 Non-Commodity Billing
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
45 Request for Official Receipt Payments Module SDD, Section: 5.11. OR/AR Number
Generation, 5.37 Payment receipt request workflow
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
46 Bill Deposit Refund (Contract Payments Module SDD,
Terminated) Section: 5.13. Cash Refund,
Section: 5.14. Check Refund,
Section: 5.15. Refund Through Fund Transfer, Section: 5.20.
Early Refund of Bill Deposit
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
47 Bill Deposit Refund (Good Payments Module SDD,
Credit Standing) Section: 5.13. Cash Refund,
Section: 5.14. Check Refund,
Section: 5.15. Refund Through Fund Transfer, Section: 5.20.
Early Refund of Bill Deposit
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
48 Refund of Credit (Account) Payments Module SDD,
Section: 5.13. Cash Refund,
Customer Assistance Design Document Page 105 of 109
Solution Design Document
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
49 Refund of Meter Deposit Payments Module SDD,
Section: 5.13. Cash Refund,
Section: 5.14. Check Refund,
Section: 5.15. Refund Through Fund Transfer, Section: 5.20.
Early Refund of Bill Deposit
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
50 Lifting of Check Blacklist Payments Module SDD, Section: 5.21. Check Blacklist
Removal Workflow
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
51 Lifting of APA Blacklist Payments Module SDD, Section: 5.10. APA Blacklist
Removal Workflow
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
52 Erroneous Contract Data CA Module SDD
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
53 Request for Meter Service Order Management Module SDD, Section: 5.1. Field
Replacement Order Generation & Initiation
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
54 Request for Special Meter Service Order Management Module SDD, Section: 5.1. Field
Reading Order Generation & Initiation
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
55 Update on Account Details SA Module SDD, Section 6.1.3.1.1, Section 8 Integration
Flow,ServiceDetailsUpdates
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
56 Bill Duplicate Request Billing Module SDD, Section: 5.7.5. Bill Printing
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
57 Erroneous AWA Tagging Payment Module SDD, Section: 5.30. AWA Tagging
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
58 RCOA - Special Meter Reading Service Order Management Module SDD, Section: 5.1. Field
Order Generation & Initiation
Integration Document:
OUC2M_Integration_Specification_DCA_CreateConcern-
v0.03
Table 54: Cross Reference Business Documents
Note: In addition to the above table, all security and other technical requirements are to be referred to the CIS Scope of Work
(SOW)'s technical key specification requirements.
10. Open/Closed Points
Status
BR ID Description Pending With Comments
(Open/Closed)
TECH MAHINDRA
MERALCO
Technology
Customer Services
1 Nathaniel I. Que TechLead Oct 07, 2022
Platforms
Technology
6 Julie K. Garcia IT Platforms Delivery
Lead Oct 10,2022
Ruth Irina C.
10 Workstream PM Process & Standards
Francisco Oct. 11, 2022
Workstream
11 Cheryl M. Barretto Process & Standards
Lead Oct 12, 2022
Project Management
Title: Project Manager / C2M Overall Lead Title: CIS Overall Project Manager
By executing this, Nimish Harshadrai Gandhi the signatory, Nico Seassar C. Hernandez the signatory,
By executing this, _____________________
warrants that the signatory is duly authorized to execute this warrants that the signatory is duly authorized to execute this
(state the complete document name & version) on behalf of (state the complete document name & version) on behalf of
TechM. Meralco.