Solution Guide Service
Solution Guide Service
4 Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
4.1 Scope and Configure Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
4.2 Create Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Configure Ticket Creation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Configure Reporter at Ticket Creation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
4.3 Manage Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Managing the Ticket List or Queue. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57
Use Ticket Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Status Handling in Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61
Assign Involved Parties to Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Number Range in Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Apply Access Restrictions to Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Time Points. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Credit Check in Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73
Organize Tickets with a Ticket Hierarchy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Determine Skills in Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Define Service Location in Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Route Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Set Up Service Level Agreements for Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Create Service Categories for Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
4.4 Process Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Respond to Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Use Items in Tickets in Field Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Use Activities in Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Ticket Summary Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Ticket Summary and Signature. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Check Item Availability from Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .102
Flexible Offline Pricing for Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Use Surveys in Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Warranty in Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Contract Determination in Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Ticket Scheduling in Field Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112
12 Contracts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
12.1 Scope and Configure Service and Sales Contracts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
12.2 Create Contracts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
Create a Contract. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
Create a Contract from a Template. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
Create Contracts from Accounts and Individual Customers. . . . . . . . . . . . . . . . . . . . . . . . . . . 434
Create a Contract from an Opportunity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
Create a Related Contract. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .435
Assign Territories to Contracts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
12.3 Maintain Contracts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
Maintain Involved Parties for Contracts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
Maintain Contract Items. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .440
Maintain Contract Covered Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
Modify Contract Types Using the Data Workbench. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
Copy and Paste Product Mass Entries in Service Contracts. . . . . . . . . . . . . . . . . . . . . . . . . . . 443
Service Contract Summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .443
Manage Access Restriction for Contracts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
Use Contract Queries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
Manage Territory in Contracts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .444
Use Incoterms in Contracts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
12.4 Service Contracts and Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
Display a Ticket from a Service Contract. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
Service Contract Determination in Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447
Service Determination Relevance of Item Covered Objects in Ticket Header. . . . . . . . . . . . . . . 447
Compare Service Determination Relevance of Item Covered Objects in Ticket Header. . . . . . . . 448
Choose Item Processing Codes for Quantity Service Contracts. . . . . . . . . . . . . . . . . . . . . . . . 448
12.5 Service Contract Determination and Assignment in Tickets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
Compare Service Determination Relevance of Item Covered Objects in Ticket Header. . . . . . . . .451
Use the Contract Determination Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
Use Release Authorized Parties in Contract Determination. . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
Include Eligible Parties for Call-Offs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
12.6 Service Contact Determination Logic. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
12.7 Contract Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
SAP ECC Inbound Replication for Contracts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
12.8 Contracts Offline. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
Offline Service Contract Covered Objects Item Determination. . . . . . . . . . . . . . . . . . . . . . . . . 461
Use Offline Contract Deviation Sync Transfer Details. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
15 Contacts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .679
15.1 Scope and Configure Contacts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .680
15.2 Customer Merge. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .689
Rules for Transaction Reassignment During Merge. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 690
Merge Criteria for Tab Screens. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 692
Status Management in Account Merge. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 696
Map Obsolete Records to Primary Record For More Insights. . . . . . . . . . . . . . . . . . . . . . . . . . .697
View Result Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698
15.3 Contact Team. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .698
15.4 Maintain International Address Versions for Contact-Account Relationships. . . . . . . . . . . . . . . . . . 699
15.5 Contact Relationships and Buying Center Relationships. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 699
15.6 Buying Center. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 700
15.7 Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 701
15.8 Social Media Profiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 704
15.9 Integration with LinkedIn Sales Navigator to Access Relationships and Key Contacts. . . . . . . . . . . .706
16 Employees. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708
16.1 Scope and Configure Employees. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708
16.2 Employee Sales Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719
16.3 Edit or Delimit Employees. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .721
16.4 External ID Visible in Employee Details View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 721
16.5 Maintain Employee Job Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 721
16.6 Create Employee Delegates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 725
16.7 Employee Work Distribution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 727
18 Activities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 882
18.1 Scope and Configure Activities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .882
18.2 Appointments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 890
Set Out-of-Office Indicator for Appointments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 891
Display Private Appointments with a Lock Icon. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 891
Generate and Send Activity Summaries Using Rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 892
18.3 E-Mails. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 893
Create Default E-Mail Signatures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 894
Create E-Mail Templates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 895
Send E-Mail Delivery Receipts Using Rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 897
View E-Mails with Original Formatting and Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 898
Report on Unassociated E-Mails. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 899
18.4 Phone Calls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 900
Add Surveys or Tasks to Phone Calls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 901
Generate and Send Activity Summaries Using Rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 902
Report on Phone Call Surveys or Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 904
18.5 Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 907
Mass Update Task Processors from the List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 907
18.6 Activity Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 908
Create Activity Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 909
Add Activities to Activity Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 910
18.7 Activities Offline. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 910
18.8 Activities FAQ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 917
21 Approvals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 943
21.1 Enable Approval Processes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 945
21.2 Configure Prerequisites for Defining Approvals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 947
21.3 Configure Approvers Under Work Distribution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 947
21.4 Configure Approval Conditions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .948
21.5 Configure Validity for Approval Processes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 948
21.6 Configure S-MIME E-Mail Notifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 949
21.7 Configure E-Mail and Fax Settings for E-mail Notifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 949
21.8 Create Workflow Notifications to Set Reminders. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 950
21.9 Monitor Approval Processes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 950
21.10 Edit or Delete Approval Processes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 951
23 Surveys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 976
23.1 Scope and Configure Surveys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .976
23.2 Survey Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 979
General (Checklist) Surveys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 980
Product Surveys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .981
Competitor Product Surveys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .982
Registered Product Surveys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 983
Competitor Surveys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 984
Satisfaction Surveys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 985
Survey Categories. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 986
23.3 Design Surveys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .986
This guide aims to provide you with sufficient knowledge of the capabilities we support in SAP Service Cloud
and help you accomplish your daily tasks.
With SAP Service Cloud, your service agents would have your customer information at their fingertips. Using
available collaboration tools and knowledge base you would know which service resources are available to
address a customer need immediately. Technicians can order spare parts, check inventory, manage tasks, and
complete service jobs on their mobile devices.
Create new Tickets [page 23] and update existing ones automatically. With native integration with SAP Jam™
Collaboration, you can search and share content from within agent workspaces and stay up-to-date on the
latest service requests, comments, discussions, and decisions online. SAP Service Cloud automatically assigns
tasks to a ticket based on relevant attributes to help guide agents through complex processes and create
workflow rules with ease that can generate notifications, update fields, and trigger requests for multilevel
approvals based on context and time.
Create serialized Registered Products [page 161] with customer, location, and warranty information and add to
a ticket, a maintenance plan, or replicate equipment from SAP ERP as registered products.
Use Resource Scheduler [page 227] to allocate technicians to tasks and enable real-time visibility of work
tickets in the technician calendar via desktop or mobile devices.
Use Skills Management [page 264] to schedule on-site visits efficiently by knowing which technicians are
available to meet service needs.
For more information about initial setup of your system, setting up the solution on mobile devices, integrating
analytics, and customizing the solution to your needs, see the appropriate guide on the SAP Cloud for
Customer page on the SAP Help Portal.
Customer service relies on certain core functions that must be enabled in other scoping areas, including under
Sales.
You can find more detailed information on the scoping process in the setup guide referenced in the Related
Links section at the end of this topic.
Go to Business Configuration Implementation Projects . Highlight the appropriate project and choose
Edit Project Scope.
You can find most of the features used in customer service under Service. However, some settings are located
under Sales and other elements. Scoping settings for specific service features are located with the feature
information throughout this guide.
Scoping
Many of the scoping elements are automatically selected and cannot be deselected.
This table lists the sales and marketing scoping elements and sub-elements that should be deselected in a
customer service only implementation.
Campaign Management
New Business
Opportunities
This table lists features you can use in customer service that must be enabled in other areas.
Note
For additional information on each respective business topic, refer to the topic descriptions within the
system.
Mass communication with customers using e-mail blast Sales Campaign Campaign Management Target
Groups
Ticket routing based on territory assignment Sales Account and Activity Management Territory
Management
Connection between your legacy system and SAP Cloud for Communication and Information Exchange Business
Customer
Process Management Application Programming
Interface
Services
Integration with SAP ERP or SAP CRM Communication and Information Exchange Integration
E-Mail Security
Questions
Once you select the desired elements, you enable features at a more granular level in the Questions step.
Review the questions under each scoping element to further define the capabilities of your solution. Based on
best practices, the system has preselected features that you can accept or, where possible, adjust. Some
features are mandatory for your scope and cannot be changed. Enable specific features by marking them In
Scope.
Allow users to e-mail target groups directly for mass mes Sales Campaign Campaign Management Campaigns
saging
Campaign Execution Do you want to execute campaigns
Note
Management .
You can also migrate account hierarchies. For more informa account hierarchies?
tion, see Migrating Account Hierarchies in the Related In
formation section.
Record customer interactions while resolving tickets Sales Account and Activity Management Activity
Create and use a template to send custom-formatted mass Sales Account and Activity Management Activity
e-mail messages to all members of a target group at the
Management E-Mail Blast Do you want to send
same time
personalized mass e-mails to many accounts at the same
time?
Schedule visits to a customer's physical location and record Sales Account and Activity Management Activity
information about the visit in the solution
Management Visits You go to your customers' physical
locations periodically. Do you want to record information from
Route tickets to service agents based on territory assign Sales Account and Activity Management Territory
ment
Management Do you want to use territory management?
Send sales quotes to customers as part of the ticket resolu Sales New Business Communications for New
tion process
Business Sales Quote Forms (multiple questions)
Integration with SAP Jam, including use as a knowledge base Communication and Information Exchange People
Check for duplicate accounts, individual accounts, and con General Business Data Business Partners Handling
tacts
of Business Partners Duplicate Check for Business
Partners
Clean up your records by merging account and individual General Business Data Business Partners Handling
customer records
of Business Partners Business Partner Merge (multiple
questions)
Associate time entries with a ticket and submit time reports General Business Data Employees and Service Agents
for manager approval
Employees Enable Time Recording and Time
Recording - General (multiple questions)
Enter address information for accounts in multiple character Built-in Services and Support Business Environment
sets — for example, in the Greek or Roman alphabets, or in
Addresses and Languages International Address Versions
Cyrillic or Thai script, among others.
Do you want to specify textual master data using
Once you activate this feature, you can configure the fine-
tuning activity International Address Versions to specify the
alternative alphabets or scripts to be used in your solution.
Enable encryption and signature approval for e-mail Built-in Services and Support System Management
Related Information
Administrators must enable core functions under Customer Care and other elements in order to set up
Employee Support.
Employee Support shares many core functions with customer service. If you are scoping a system for
employee support, you must first configure these core functions under Customer Care. You must also enable
certain functions under Sales and other element areas.
Restriction
Scope core functions under Customer Care before you can enable an Employee Support system.
You can find more information on the core functions you need to scope under Customer Care and elsewhere in
the Scoping Customer Service topic referenced in the related links section.
The options you choose during the scoping phase of your implementation project are used by the system to
generate an activity list that you need to complete to go live.
To begin, go to Business Configuration Implementation Projects . Highlight the appropriate project and
choose Edit Project Scope.
Certain functions can be enabled in either customer care, or employee support. Please be aware that if you
activate an option in one area the same function is also deployed for the other area, because they share the
same settings.
Functions That You Can Enable Either Under Customer Care or Employee Support
Employee Support Knowledge Base Knowledge Base Customer Care Service Request Management
Employee Support Knowledge Base Knowledge Base Customer Care Service Request Management Enable
Options Enable SSO for Knowledge Base Integration SSO for Knowledge Base Integration
Employee Support Knowledge Base Knowledge Base Customer Care Service Request Management Open
Options Open KB Details in New Browser Window KB Details in New Browser Window
Employee Support Ticket Management Entitlement Customer Care Service Request Management Service
Determination
Employee Support Ticket Management Profanity Customer Care Service Request Management
Employee Support Communication Channel - Email Customer Care Service Request Management
E-Mail Channel Options Maintain Service Requests Automatic Creation of Service Requests from E-Mails
Employee Support Analysis for Employee Support Customer Care Service Request Management Service
Related Information
Learn how the system creates tickets, how to work with the ticket list, and how to respond to tickets to resolve
customer issues.
Tickets are a record in the system of a request for some type of service or support from an account, customer,
or employee. This record allows you to track interactions with the service requestor, as well as details like how
much time has passed since the ticket was created, what actions were taken to resolve the issue, priority,
associated products, or warranties, and much more. Tickets are also sometimes referred to as service
requests.
● The solution creates a ticket from an incoming support request. This request could arrive from any one of a
number of channels, such as social media, a phone call, or an e-mail. Tickets can also be created
automatically from service contracts, or by sensor data on connected products.
● The system may do some automatic processing of the request to classify and route the ticket.
● As an agent, you might add crucial information such as customer contact information from a phone call, or
specify how quickly the issue must be resolved.
● Use the knowledge base, collaborate with colleagues in real time, or work with other systems to access the
information required to resolve the problem.
● Some tickets may require a visit by a service technician. Schedule an appointment and arrange for repair
parts as needed.
● Respond to the requestor. Communicate the solution to the customer through the same channel used to
make the initial request, or any other preferred contact point.
Administrators can configure tickets using scoping, scoping questions, and fine-tuning activities.
Recommendation
We recommend that you review all the scoping questions in the areas that are relevant and that you have
included in your scope. When you select a question, more information appears on the tabs in the details
section of the screen.
Scoping questions and fine-tuning activities that are straightforward may not be included in this list.
To use tickets, administrators must add tickets to the scope of the project.
Go to Business Configuration Implementation Projects Your Project Edit Project Scope Questions
Service Customer Care Service Request Management .
Some ticket-related options do appear under other scoping elements. Scoping paths are provided for each
option.
Administrators can configure ticket creation using the quick create form, or create tickets in detail sview.
To create new tickets using ticket detail view, select the option labeled: Create tickets in detail view. If this
option left unselected, the default behavior is to create new tickets with the quick create form.
Administrators can explore how to incorporate conditions into the approval process for tickets, such as who
would be allowed to approve the ticket.
The administrator can set the work distribution for tickets. These can be: Approver of Ticket, Direct Approvers,
Manager of Agent Responsible for Ticket, Manager of Service Technician for Ticket, or Responsible for Account.
You can edit the approval process by editing steps, adding additional steps, and by changing the order of the
steps. You must define who receives approval tasks. You can also define conditions by which an approver is to
receive an approval task.
Once you scope approval for tickets, then you detail the approval process. For this step, you define the approval
conditions and an approver before the approval process is ready to use. Navigate to Administrator
Approval Process . See Creating an Approval Process for details.
Note
At least one approval process must be active. To define an approval process, copy the default approval
process and adapt the approval validity, ensuring one process has an unlimited validity.
The administrator can configure the number range for your tickets via fine tuning.
You can maintain Number Range in a ticket for Customer and Employee Support. Go to Business Configuration
and search for Ticket. Your search would display the Tickets for Customer Support and Tickets for Employee
Support activities.
Document types represent ticket types in your application. Your administrator can help you create custom
ticket types via fine tuning.
To configure Document Types in a ticket for Customer and Employee Support, go to Business Configuration
and search for Ticket. Your search would display the Tickets for Customer Support and Tickets for Employee
Support activities.
Note
The process variant is pre-set with the corresponding setting, based on whether you opened the
activity under Tickets for Customer Support or Tickets for Employee Support.
Note
You can't delete document types that are used in your tickets.
In addition to the standard status and status schemas for tickets, you can specify custom ones as well by
mapping them to a valid combination of life cycle status and assignment status. The administrator can
configure this activity via fine tuning.
You can change visibility, and sequence of the standard statuses. With the status schemas, you can realize
different processes in your company. For Example: you can create a status schema for your internal employee
support, as well as a status schema that is valid for the interaction with your partners.
To maintain status schemas in a ticket for Customer and Employee Support, go to Business Configuration and
search for Ticket. Your search displays the Tickets for Customer Support and Tickets for Employee Support
activities.
○ Only the Open Life Cycle Status can be selected as initial status.
○ You can select the Closed Life Cycle Status but you can't set it to visible.
Note
Use party determination to configure whether the reporter information is copied from the account data linked
to the ticket.
Context
Your administrator can choose whether the ticket reporter is copied from the account contact information,
entered as the currently logged in user, or entered manually.
Procedure
1. Go to Business Configuration and search for Ticket. Your search returns the Tickets for Customer Support
and Tickets for Employee Support activities.
2. Based on your scenario, click either of the links and navigate to Maintain Involved Parties.
3. Select the Reporter role, and then select Maintain Determinations.
4. Select the steps used to populate the ticket reporter field.
Tip
Each of these steps is evaluated in the order shown. The first value found is used to fill the reporter
field. For example, if you select all four steps, and there is no account associated with the ticket, then
If the ticket is created as a follow-up, or copied from an existing ticket, then the reporter and other
party information is copied from the source object.
To use your own ticket statuses in your processes and schemas, the administrator would have to create the
statuses first in the Ticket Status Dictionary and assign them to life cycle and assignment status.
To maintain entries for ticket status schemas, you first create them in the Ticket Status Dictionary. Go to
Business Configuration Implementation Projects Open Activity Lists Fine Tune and search for Tickets
for Customer Support. Click Maintain Status Dictionary Entries, and using the Add Row button, maintain the
status and create additional status for tickets here.
Use the status values you create in ticket status dictionary and then go to Ticket Status Schemas to assign
them to a ticket.
The following table lists the pre delivered status values that you can select in the ticket and the possibilities to
change them in the ticket. When you create your statuses keep these possibilities in mind.
You can change the description of the pre delivered statuses, but you can't delete them.
● Completed
Note
You, as a customer, can't
change this status.
Besides these, our solution also provides you with various statuses for tickets integrated with SAP ERP. The
SAP ERP ticket statuses are as follows:
To add a status click Add Row, enter a description, select the wanted life cycle and assignment status, and save
your changes.
To delete a status, select the corresponding status line, click Delete, and save your changes.
To enable ticket item defaulting based on item processing codes, the administrator has to configure item
processing codes via business configuration.
When you create a ticket item and set a ticket type to it, the system assigns it a processing code based on the
code mapping maintained in the rules table. The administrator has the ability to edit these mappings in the
rules table.
Each of the processing codes in turn are associated with and mapped to certain values and flags, such as
Pricing Relevant, ERP Relevant, Scheduling Method. You have the ability to set these values and flags in the
system using the business configuration activity list.
So when you select a ticket type when creating a ticket item, then the system displays default values in the
fields based on the item processing code set in the system. However, at this point, the user has the ability to
edit these fields and change the default values.
Follow the steps below to set-up item processing codes for your business.
1. Go to Business Configuration Open Activity List Fine-Tune Show All Activities Tickets for
Customer Support Maintain Item Processing Codes .
2. Select Add Row.
3. To create item processing codes, populate the required fields. Enter a description.
4. Select the required System Processing Type and the Invoicing Method.
○ System Processing Type
With the System Processing Type you trigger the accounting records for costs and goods movement in
your company.
○ Billing Request creates a request for billing.
○ Complaint Request can be used to report complaints on external document items. This feature
requires SDK development in order to be exposed as a front-end capability.
○ External Procurement creates an SAP ERP sales order with procurement items (item category
TAS), based on actual quantity.
Note
Please note that advance shipment doesn’t work with fixed price.
○ Time and Material is the default setting and takes the confirmed (actual) time and quantity for
billing.
○ Not Relevant
5. Save your entries.
Note
Custom processing codes begin with Z. The rest of the codes are provided by the solution.
Example
If an item processing code is flagged as Pricing Relevant, then a ticket item will be set by default as relevant for
pricing. However, this only applies if the ticket type is also set as Pricing Relevant. The default pricing flag at
ticket item level can be changed by the user. In this case, the pricing flag is re-determined.
The administrator can select the Sales Order processing type code available for Ticket items under Item
Processing Codes activity in fine tuning. Customers can use this processing code while creating Sales Orders in
SAP ERP.
Navigate to Business Configuration Implementation Projects Open Activity List , and search and select
Tickets for Customer Support or Tickets for Employee Support.
Click Maintain Item Processing Codes and select Sales Order to set the processing code.
Your administrator would have to maintain Involved Parties in a ticket for Customer and Employee Support via
fine tuning.
Context
You can automatically determine all involved parties for business transactions and their related documents
using party roles and determination rules. This allows you to streamline account team assignments, and
ensure that business partners are correctly assigned to business objects in a way that matches your company
processes.
Procedure
1. Go to Business Configuration and search for Ticket. Your search would display the Tickets for Customer
Support and Tickets for Employee Support activities.
2. Based on your scenario, click either of the links and navigate to Maintain Involved Parties. You can decide
which party roles you want to use in your application. However some party roles are set as mandatory by
default and you cannot deactivate these.
3. Add or edit party roles and under Party Role Assignments click Add Row.
4. Select a Party Role from the dropdown list.
5. Decide whether the role should be, for example, active, mandatory, unique, or should be forbidden for
manual changes.
For item processing determination, you can configure which processing codes can be determined based on the
product, product category, or ticket type
When creating an item in a ticket, after you enter the product, the determination of the ItemProcessingCode is
triggered based on the settings you've maintained in the Item Processing Determination fine tuning table.
Follow the steps below to set-up and assign item processing codes with the item processing determination for
your business.
1. Go to Business Configuration Open Activity List Fine-Tune Show All Activities Tickets for
Customer Support Maintain Item Processing Determination .
2. Select Add Row.
3. To create item processing determination, populate the required fields, such as Usage Type and Item
Processing Codes.
4. Save your entries and activate the rule.
The administrator can configure custom involved parties for a ticket. You can then determine custom involved
parties from Installed Base or Registered Product, using the party determination framework.
Use the determination option for Installed Base and Registered Product for custom parties to provide flexibility
to customers where they can add custom involved parties to a ticket and also take advantage of the party
determination framework for custom involved parties.
To add a custom involved party, navigate to Business Configuration Activity List Tickets for Customer
Support Involved Parties .
You can choose to determine the Service Technician and Service Technician Team using party determination
rules instead of copying this information from the associated registered product, installed base, and installation
point, when creating ticket from them. Your administrator can enable this option by selecting the related
question in business configuration.
Navigate to Business Configuration Edit Project Scope Questions Service Customer Care Service
Request Management , and under the Business Option section, enable the question: Use rules to determine
technician and team when creating new ticket from registered product, installed base, or installation
point?
Context
Restriction
Your organization can choose to route tickets either with routing rules, or by organizational structure, but
not both.
Procedure
1. Go to Administrator Service and Social Work Distribution , then select one of these options:
The first time you set up business rules you must configure the rules table. By default, the first 20 fields on
the screen appear as columns in the table. Use the left and right arrow buttons to remove any unwanted
default columns and add only the fields you wish to use. You can have up to 15 columns in the table,
including the results column.
Tip
Use only the columns required for assigning objects. Extra columns can impact performance. You can
add additional columns and rules at any time.
3. Choose Insert Row above the rules table. A new row with an asterisk in each field of the row is added to the
table.
You can add values to more than one field in a row. The fields in one row evaluate with a logical AND
relationship. The field values must all evaluate to true in order for the rule to evaluate to true.
4. Click the asterisk symbol (*) in a cell to enter a value for that field. The rules table offers a variety of logical
operators to define your values.
Tip
We recommend that you take full advantage of operators to consolidate your rules for better
performance.
For example, if your rules determine assignments based on zip codes, use the Between operator to set
up a range of zip codes in sequence. Use the Include operator to group zip codes that have the same
prefix.
The Comparison Operations document in the Related Links section provides detailed information on
operators in your solution.
The system compares rows using the logical OR operator. The system compares each rule, top to bottom,
until ONE evaluates to true.
Tip
Among other properties, you can specify customer language as a ticket routing rule criteria, to assign
tickets to a team or a territory.
To enable your changes, you must activate the new rules. Otherwise, the system uses the previous rule set.
Related Information
http://help.sap.com/saphelp_nw73/helpdata/en/50/9eecf3152c4fb08d50e94faaf4a277/content.htm
Assign local administrators to geographical areas for which they can create rules.
Context
Only administrators with global access rights can create and edit restrictions for local administrators.
Procedure
1. Go to Administrator Service and Social Work Distribution Ticket Routing Rules to open the rules
table.
2. Choose Add Row above the Local Administrators Restrictions table.
3. Enter a Country and Region to allow for rule creation.
4. Choose a local administrator for that country and region.
The local administrator can create rules that apply only to the specified country and region.
5. Continue to add rows for each local administrator you wish to assign.
6. Choose Save when finished.
Administrators can define work distribution rules to enable routing of tickets to particular team or agent
queues.
Prerequisites
Restriction
Your organization can choose to route tickets either with routing rules, or by organizational structure, but
not both.
Context
Work items are tickets in the system created from customer messages. You can also create organizational work
distribution rules to manage escalation routing and routing based on social media channels.
By default, all incoming customer service tickets are visible to all employees with the corresponding access
rights. The Organizational Work Distribution and Employee Work Distribution views enable you to manage the
distribution of customer tickets within your service organization. You create rules that allow the system to
evaluate the tickets and distribute them to the responsible team or the responsible processing agent.
Procedure
The system processes work distribution rules according to their priorities. If you have maintained multiple
rules for a work category, the system only uses the first rule that applies. By default, new rules are added to
the bottom of the list, and so have the lowest priority. To change the priority, move a rule up or down in the
table.
To ensure that all tickets are routed properly, we recommend that you create a default rule at the
bottom of the rule list. The default rule should be applicable to the properties of any incoming
customer message. If no other routing rules apply, the default rule routes tickets.
4. Enter the name, choose, or enter the ID of the responsible customer service org. unit, or service agent and
enter the validity period for the rule.
5. Go to the Rule Details section and specify the parameters for the rule.
Each of the following parameters appears as a tab. Using the parameters, you can specify which parameter
is to be included in the rule or excluded from the rule.
○ ABC Classification
○ Country
○ Product Category
○ Service Category
○ Account (Includes all individual customers and customer accounts)
○ Service Priority Code
○ Escalation Status
○ Channel Type
Note
The social media channel type is only supported by SAP Cloud for Social Engagement.
○ Channel
6. Choose Check to verify that your rule is consistent and then save your entries.
7. Move the rule up or down in the list to set priority in the processing sequence.
Context
Procedure
Configure the settings for the new service level in the four tabs: General, Reaction Times, and Operating
Hours. The Changes tab is for change history and is blank for new entries.
Restriction
Automatic alerts for overdue milestones are not currently supported in SAP Cloud for Customer.
5. Add details for a milestone. Select an entry in the Milestones table and then add rows to the Details of
Milestone table as needed. Select Type of Service, Priority, and Net Labor Time for each row.
You can maintain multiple service types and priorities for a milestone. Add a new row for each priority.
Tip
For Net Labor Time if you enter the duration in hours, the system only considers operating hours. If you
enter the duration in days, the system uses the Weekly Configuration, but not the time ranges. You
enter this information on the Operating Hours tab in the next step.
Example
Your working days are from Monday to Friday, from 8:00 to 18:00 and the reporting date is
Wednesday 1.1.2014, 15:00
○ If you enter a duration of 2 days the system calculates a due date on Friday, 3.1.2014,15:00.
○ If you enter a duration of 48 hours the system calculates a due date on Wednesday,8.1.14,
13:00.
6. Set the Working Day Calendar, Time Zone, Weekly Configuration, and Time Ranges on the Operating Hours
tab.
Time Ranges allows you to set the hours when your service staff is available. Operating Hours may not be
available, depending on your configuration. If you do not enter operating hours, the system assumes that
service is available 24/7.
7. Select Save to save the new service level. The service level is saved in the system and added to the Service
Levels tab.
8. Activate the new service level. Select the row for the newly created service level and select Change Status,
then choose Active. Status options include: Active, Blocked, and Obsolete.
Administrators can set up rules that automatically assign service levels to tickets.
Context
When you create or edit a service request or ticket, the system uses rules to evaluate which service level to
apply. When a rule is found that matches the ticket, the system applies the appropriate service level. The
service level pushes details about reaction times and due date calculations to the ticket.
Procedure
1. Go to Administrator Service and Social SLA Setup Determine Service Level to open the rules
table.
2. Set up the rules table with Adapt Columns.
The first time you set up business rules you must configure the rules table. By default, the first 15 fields on
the screen appear as columns in the table. Use the left and right arrow buttons to remove any unwanted
default columns and add only the fields you wish to use. You can have up to 15 columns in the table,
including the results column.
Tip
Use only the columns required for assigning objects. Extra columns can impact performance. You can
add additional columns and rules at any time.
3. Choose Insert Row above the rules table. A new row with an asterisk in each field of the row is added to the
table.
You can add values to more than one field in a row. The fields in one row evaluate with a logical AND
relationship. The field values must all evaluate to true in order for the rule to evaluate to true.
4. Click the asterisk symbol (*) in a cell to enter a value for that field. The rules table offers a variety of logical
operators to define your values.
Tip
We recommend that you take full advantage of operators to consolidate your rules for better
performance.
For example, if your rules determine assignments based on zip codes, use the Between operator to set
up a range of zip codes in sequence. Use the Include operator to group zip codes that have the same
prefix.
The Comparison Operations document in the Related Links section provides detailed information on
operators in your solution.
The system compares rows using the logical OR operator. The system compares each rule, top to bottom,
until ONE evaluates to true.
Enable your changes by activating the new rules. Otherwise, the system uses the previous rule set.
Related Information
http://help.sap.com/saphelp_nw73/helpdata/en/50/9eecf3152c4fb08d50e94faaf4a277/content.htm
Administrators can learn about external pricing call configuration to retrieve the complete pricing result from
SAP on premise systems to your cloud solution.
If external pricing is selected, a synchronous call is required to retrieve the complete pricing result from the
SAP on premise system to your cloud solution. Replicated sales documents also require a synchronous pricing
update once the sales document is updated during save.
If the document was previously replicate, with this configuration, you can disable the synchronous pricing call
to the system,. In addition, you can disable the synchronous call completely, which is also valid for quotes
created in your cloud solution. For both configuration options, the pricing status is calculated successfully
through the asynchronous call from the external system. The user can still trigger pricing synchronously by
clicking the asynchronous call action.
To configure external pricing call, go to fine-tuning activity Ticket Tickets for Customer Support
Document Types :
● If an item processing code is flagged as Pricing Relevant, then the ticket item would be set as relevant for
pricing, by default.
● The default pricing flag on ticket item level can be changed by the user.
● The pricing flag is re-determined if the item processing code is changed by the user.
Administrators can configure the solution to prevent closing main tickets with open sub-tickets.
Go to Business Configuration Implementation Projects Your Project Edit Project Scope Questions
Service Customer Care Service Request Management Questions Ticket Completion
To prevent closing main tickets with open sub-tickets, choose In Scope for the question: Do you want to prevent
users from completing main tickets when sub-tickets remain open?
The administrator must enable Skills via business configuration to use the feature in ticket.
Go to Service Customer Care Service Request Management Questions and select the question: Do
you want to enable Skills Functionality in Ticket?
Go to Business Configuration Implementation Projects Your Project Edit Project Scope Scoping
Questions Service Customer Care Service Request Management Ticket Summary Templates and
check the box next to the question: Do you want to use locally-stored templates for ticket summary
reports?
As an administrator, you can create employee work distribution rules to enable the system to evaluate work
items and to determine the responsible service agent.
Context
In this case the work items are tickets in the system created from customer messages. You can also create
organizational work distribution rules to manage escalation routing and routing based on social media
channels.
Procedure
The system processes work distribution rules according to their priorities. If you have maintained multiple
rules for a work category, the system only uses the first rule that applies. By default, new rules are added to
the bottom of the list, and so have the lowest priority. To change the priority, move a rule up or down in the
table.
4. Enter the name, choose or enter the ID of the responsible customer service agent, and enter the validity
period for the rule.
5. Go to the Rule Details section and specify the parameters for the rule.
Each of the following parameters appears as a tab. Using the parameters, you can specify which parameter
is to be included in the rule or excluded from the rule.
○ ABC Classification
○ Country
○ Product Category
○ Service Category
○ Account (Includes all individual customers and customer accounts)
○ Service Priority Code
○ Escalation Status
○ Channel Type
Note
The social media channel type is only supported by SAP Cloud for Social Engagement.
○ Channel
6. Choose Check to verify that your rule is consistent and then save your entries.
7. Move the rule up or down in the list to set priority in the processing sequence.
Administrators and users can create templates for standard ticket response text.
Context
Follow the steps to create and set up a template for ticket response.
Procedure
1. Go to Service Templates .
2. Add a new template and enter the required information: Name, Subject, Channel Type, and Template Text.
For response templates, select Text-Based for Template Type.
You can edit the template text as needed when you add placeholders.
Note
Use document-based templates to create branding that surrounds the reply text. Branding templates
can be linked to specific communications channels.
3. Select Save and Open to view template details for further editing.
4. Add placeholders (optional). Add a row to the placeholder table. Define a placeholder tag in the first
column and select a field in the second column to populate the placeholder.
Placeholders names are surrounded by the pound sign (#). For example, define a placeholder name
#CustID# and select the field Customer ID to insert the customer ID number into the template text. Once
you define your desired placeholders, you can insert them into the template text. When the user selects the
template, the solution fills in the placeholders with ticket data.
5. Set template as Corporate to make it available to all users (optional).
The administrator would set up your system to use Microsoft Outlook to respond to service tickets.
Context
You must scope Microsoft Outlook in your solution to use the tool for responding to your customers.
1. Go to Business Configuration Edit Project Scope Questions Service Customer Care Service
Request Management Group: E-mail replies via Microsoft Outlook (1) .
2. Set the question to In Scope.
3. Instruct all agents to download and install the SAP Cloud for Customer Add-In for Microsoft Outlook from
the Download page.
Results
Service agents can now use Microsoft Outlook to respond to tickets. Agents can also respond with the built-in
response editor by deselecting the Use Microsoft Outlook checkbox in Interactions.
Administrators can set up document types and item processing codes for available-to-promise (ATP) check.
Context
Procedure
1. Configure document types. Go to Business Configuration Implementation Projects and select Open
Activity List. Select All Activities, then search for ticket. Select Tickets for Customer Support, then select
Maintain Document Types. Select the ATP Relevant checkbox for each document type you wish to enable
2. Configure item processing codes. Go toGo to Business Configuration Implementation Projects and
select Open Activity List. Select All Activities, then search for ticket. Select Tickets for Customer Support,
then select Maintain Item Processing Codes. Select the ATP Check Relevant checkbox for each processing
code you wish to enable for ATP check.
The administrator can restrict some business roles from creating new tickets, by configuring authorization via
Access Restriction. This feature restricts ticket creation to selected employees, based on their role.
Navigate to Administrator General Settings Users Business Roles and select the necessary business
role to set up access restrictions for ticket creation.
Note
The administrator would configure contract types and usage restrictions based on additional criteria such as
ticket type.
You can create different contract document types with restricted coverage based on the context they are used
in. You can associate specific contract types with specific ticket types to auto assign the appropriate contract
for a ticket type.
Users can specify usage restrictions for each contract item. When a user creates a work ticket, the system
automatically applies the specified usage restrictions based on the ticket type.
Scoping the Stock allows you to view all stock-related information for service technicians, service team, or
service organizations. To use the stock option in a ticket, the administrator would have to assign the Stock work
center to the field service technician business role.
To scope stock for your solution, go to Scoping Business Configuration Implementation Projects Edit
Project Scope Service Entitlement Management Stock Location and select the checkbox. Next, go to
the Questions tab to select the option for using the Stock work center to enable you to view the stock location
data.
To assign the Stock work center to the field service technician business role, go to Administration Work
Center and View Assignments tab. Assign the Stock work center to the field service technician business role
with COD_STOCKLOCATION_WCF ID code.
The administrator has to scope and enable Knowledge Base Integration in SAP Cloud for Customer solution.
Context
Enabling this feature turns on the solution finder feature of the workspace where your external knowledge base
is integrated.
Procedure
4. In the Scoping Elements list, select Service Customer Care Service Request Management .
5. Enable Knowledge Base Integration by selecting In Scope for that question.
6. Click Next .
7. Click Next .
Context
Procedure
Example
For example, if the URL for the RSS or Atom feed for your knowledge base vendor is https://
KBvendor.com/search?q=test, then the system would extract the parameter, q, with the constant, test.
You would need to delete the constant value so it remains blank.
As the administrator, once you've created the web service for your knowledge base, create a data mashup to
specify the mapping between the search parameters used by the system and the web service input
parameters.
Caution
1. Add the knowledge base web service you created, as a source for the data mashup.
Click the Sources tab.
Tip
Depending on the size of your screen, you may have to scroll within the left pane to see the Sources tab.
By default, the Parameters tab is active.
2. Drag and drop the RSS/Atom Services building block onto the central authoring canvas.
3. In the dialog box, select the web service you created for your knowledge base.
4. Using the cursor, draw a connection between the bottom of Mashup In-Port and the top of Fetch Feed boxes
of the new service.
5. With Fetch Feed selected, in the properties pane on the right, select SearchExpression for the search term
parameter.
6. Now with Mashup In-Port selected, in the properties pane on the right, enter a search expression that
you're sure would return results.
7. Click Preview Result.
The results of your search expression are displayed in the result pane.
8. If the results are what you expected, click Next .
If all the information for the mashup is correct and OK, save it by clicking Finish.
Caution
The administrator would scope and configure SAP Jam as a knowledge base for ticket responses.
Note
Your system must be integrated with SAP Jam for Feed content before you can use SAP Jam as a
knowledge base.
To scope, go to Service Customer Care Service Request Management Questions . In the scoping
questions for the Knowledge Base Group, select and scope the question Do you want to use SAP Jam as a
knowledge base provider?
As the administrator, once you've enabled SAP JAM for collaborating in a ticket, set up SAP JAM in your
system.
Tip
We recommend using dynamic on-boarding, without explicit user mapping. There are several ways to
achieve this. Refer to the screenshot and find the appropriate option that addresses your user provisioning:
To use SAP JAM to collaborate and resolve a ticket, the administrator must first enable the feature, and
integrate it with our solution.
Go to Scoping Business Configuration Implement Project Edit Project Scope Communication and
Information Exchange People Collaboration, Intranet and External Services Communities and Document
Management Questions . Under SAP JAM Integration, select the question: Do you want to integrate SAP
JAM with your cloud solution?
Each of the item processing codes maintained in fine tuning for Tickets is associated with and mapped to
certain values and flags. These can be Pricing Relevant, SAP ERP Relevant, or Scheduling Method. The
administrator can set these values and flags in the system using the business configuration activity list.
Maintain system processing type code for External Procurement, which would in turn create a SAP ERP sales
order with procurement items (item category TAS). This can also be used for SAP ERP sales order with regular
items (TAN).
The administrator would have to scope this feature via business configuration. Using this feature, you are able
to select a ticket processor across all teams.
Enabling the feature lets you override any consistency check that is otherwise required for a ticket processor
and the respective service team. When this option is selected, the system would not delete the ticket
processor, even if the processor does not belong to the respective team.
Administrators can trigger workflow rules based on the value of the Pricing Status and ERP Release Status
fields, or on keywords contained in ticket subject and body.
● Create workflow rules based on the values in the Pricing Status and ERP Release Status fields. These
triggers allow you to set up rules that automatically release a ticket to an SAP ERP system, or request
pricing information.
● Keywords contained in the subject or body text of a ticket can also trigger workflow actions. For example,
route tickets based on whether certain text appears in the ticket. The text or keywords can be entered by
the customer or the agent. For tickets generated from e-mail channels, the body text of the e-mail message
is copied into the ticket description. Therefore, defining rules based on the ticket description is equivalent
to monitoring for keywords in the body of incoming messages.
You can create a ticket manually from the Tickets or Work Ticket work centers, and employee support (within
our solution) based on incoming communication from various available channels.
Click the Create icon (at the bottom of the screen) to create a new ticket. We recommend data input in the
Type, Source, and Subject fields. Of course, the Subject field is mandatory. The Source field dropdown let's you
select the source of the incoming communication that led to the ticket creation. The dropdown list displays
communication channels based on what is configured and integrated in your system.
Note
When you create a ticket manually, you are able to use certain source types. The remaining source types
are assigned to a ticket when the tickets are created via available channels.
● Ticket
● Copy e-mail to multiple Tickets
● Create from un-associated e-mails
● Sub Tickets (from Related Items tab)
The ticket gets automatically associated to the object from where you created.
Administrators can configure ticket creation using the quick create form, or create tickets in detail sview.
To create new tickets using ticket detail view, select the option labeled: Create tickets in detail view. If this
option left unselected, the default behavior is to create new tickets with the quick create form.
Use party determination to configure whether the reporter information is copied from the account data linked
to the ticket.
Context
Your administrator can choose whether the ticket reporter is copied from the account contact information,
entered as the currently logged in user, or entered manually.
Procedure
1. Go to Business Configuration and search for Ticket. Your search returns the Tickets for Customer Support
and Tickets for Employee Support activities.
Tip
Each of these steps is evaluated in the order shown. The first value found is used to fill the reporter
field. For example, if you select all four steps, and there is no account associated with the ticket, then
the currently logged in user is used as the reporter. If no steps are selected, then the reporter must
always be entered manually.
If the ticket is created as a follow-up, or copied from an existing ticket, then the reporter and other
party information is copied from the source object.
Learn about the options and parameters you have for handling ticket setup and management in the solution.
You have a wide variety of options for classifying, organizing, linking, and routing tickets in the solution. Your
administrator or service manager sets many of these options based on how your organization uses tickets.
The Tickets tab displays all tickets in the solution. The Queue is a subset of the ticket list containing open and in
process tickets assigned to you.
Depending on the type of user interface client you use, and your company's needs, your system may be set up
with Tickets, the Queue, or both work centers. Once you log on to the system, navigate to Service Tickets
to view tickets in the system. If you have the Queue work center available, the work center displays tickets
assigned to you for processing. The My Queue list displays by default. You have further options to see a list of
open and in-process tickets from this tab by choosing a different search filter. If you only see Tickets, you can
use search filters to duplicate the Queue to list open and in process tickets assigned to you.
Note
You cannot delete tickets from the system, but tickets with status set to Irrelevant are removed from all
queues.
Tip
You can find all ticket processing options in the Actions menu.
Update ticket subject and priority in the work list without having to open the ticket detail view.
Context
You, as an administrator can enable editing in the work list by logging into the fiori client, navigating to your
user profile menu and selecting Settings Company Settings Enable Editing in Dataset in Fiori Client .
Procedure
Select a new priority from the menu. Subject is a text field you can edit as usual.
4. Select Save to save your changes and exit edit mode.
You can link tickets to related objects such as accounts, customers, contacts, and opportunities. Related
tickets appear in the Tickets tab in the object detail view.
You can search, sort, and filter the related tickets list. Choose default views to see:
● All Tickets
● Tickets I Created
● Tickets Involving This (Object) in Any Role
View tickets where the current account, contact, or individual customer is involved in a secondary role.
Context
When you open the tickets tab for an account, contact or individual customer, the default view for the list
shows you tickets where the account, contact, or individual customer has the primary role. You can select a
view with broader parameters to see tickets that include the current account, contact, or individual customer in
a secondary role, such as the bill-to or ship-to party.
Procedure
The filter label reflects the type of object you’re viewing - Account, Contact, or Individual Customer.
Select a ticket Type to define the kind of ticket you are creating in the system.
SAP provides one standard ticket type each for Employee Support and Service Request. You can define your
own ticket types and associated processes. Administrators can define new ticket types in business
configuration, where this is referred to as document types.
Note
You can only configure settings for the document or ticket type that you create.
Based on the ticket type, you can define the status schema; whether it is relevant for external pricing, contract
use, work tickets, or ATP (available to promise).
Example
If you'd like to handle inquiries, feedback, or complaint processes differently in your organization, you would
create three different ticket types.
Document types represent ticket types in your application. Your administrator can help you create custom
ticket types via fine tuning.
To configure Document Types in a ticket for Customer and Employee Support, go to Business Configuration
and search for Ticket. Your search would display the Tickets for Customer Support and Tickets for Employee
Support activities.
The process variant is pre-set with the corresponding setting, based on whether you opened the
activity under Tickets for Customer Support or Tickets for Employee Support.
Note
You can't delete document types that are used in your tickets.
You can maintain dictionary entries for the user status, combine the dictionary entries, assign them to status
schemas, and finally assign the status schemas to ticket types.
In a Ticket, for the user status dropdown list, only those entries that you've maintained via configuration
display.
Note
You can set the status for multiple tickets in the Tickets tab.
Example
Example
● Not Relevant
● Not Released to ERP
● Released to ERP
To use your own ticket statuses in your processes and schemas, the administrator would have to create the
statuses first in the Ticket Status Dictionary and assign them to life cycle and assignment status.
To maintain entries for ticket status schemas, you first create them in the Ticket Status Dictionary. Go to
Business Configuration Implementation Projects Open Activity Lists Fine Tune and search for Tickets
for Customer Support. Click Maintain Status Dictionary Entries, and using the Add Row button, maintain the
status and create additional status for tickets here.
Use the status values you create in ticket status dictionary and then go to Ticket Status Schemas to assign
them to a ticket.
The following table lists the pre delivered status values that you can select in the ticket and the possibilities to
change them in the ticket. When you create your statuses keep these possibilities in mind.
You can change the description of the pre delivered statuses, but you can't delete them.
● Completed
Note
You, as a customer, can't
change this status.
Besides these, our solution also provides you with various statuses for tickets integrated with SAP ERP. The
SAP ERP ticket statuses are as follows:
● Release to SAP ERP: Once your work on the ticket is complete, you can set the action to Finish Work. The
ticket is now ready to be released to SAP ERP.
● Release Pending: When the ticket is in process the ticket has the Release Pending status.
● Release Discarded: If there are issues when data is sent to SAP ERP, errors display in the error log of the
ticket.
● Released: If there are no issues in the ticket data when released to SAP ERP, the status updates to
Released.
To add a status click Add Row, enter a description, select the wanted life cycle and assignment status, and save
your changes.
To delete a status, select the corresponding status line, click Delete, and save your changes.
In addition to the standard status and status schemas for tickets, you can specify custom ones as well by
mapping them to a valid combination of life cycle status and assignment status. The administrator can
configure this activity via fine tuning.
You can change visibility, and sequence of the standard statuses. With the status schemas, you can realize
different processes in your company. For Example: you can create a status schema for your internal employee
support, as well as a status schema that is valid for the interaction with your partners.
To maintain status schemas in a ticket for Customer and Employee Support, go to Business Configuration and
search for Ticket. Your search displays the Tickets for Customer Support and Tickets for Employee Support
activities.
Note
○ Only the Open Life Cycle Status can be selected as initial status.
○ You can select the Closed Life Cycle Status but you can't set it to visible.
Note
The Assignment Status of a ticket tells you who the ticket is assigned to and has several options.
● Processor Action: The ticket is created by the requestor and the processor has to react to the ticket, for
example, the customer creates a ticket and the first level support reacts to the ticket.
● Planner Action: The ticket is forwarded to a planner or technician who has to do the work, such as
repairing a technical issue, or delivering services. This assignment status sets also the Requires Work flag
in the ticket.
● Requestor Action: The ticket is in process and the support colleague asks the customer to do
something on his or her side to solve the issue.
● Provider Action: The first level support cannot solve the ticket alone and needs help from the second
level support or a third party provider. He or she can use this status and the ticket is forwarded
automatically to the corresponding destination, for example, an external system.
● Not Assigned: Can only be used with Life Cycle Status Closed.
You can assign involved party to a ticket at creation or after creating the ticket.
You can automatically determine involved parties for a ticket using determination rules and master data. Add a
role and party based on maintained configuration. You can activate or deactivate these roles in configuration.
However some party roles are set as mandatory by default and you cannot deactivate them.
While creating a ticket for a registered product, party information such as Customer and Service Technician, is
copied to the ticket from the registered product. For some parties the information is based on involved party
determination rules defined for the ticket.
Your administrator would have to maintain Involved Parties in a ticket for Customer and Employee Support via
fine tuning.
Context
You can automatically determine all involved parties for business transactions and their related documents
using party roles and determination rules. This allows you to streamline account team assignments, and
ensure that business partners are correctly assigned to business objects in a way that matches your company
processes.
Procedure
1. Go to Business Configuration and search for Ticket. Your search would display the Tickets for Customer
Support and Tickets for Employee Support activities.
2. Based on your scenario, click either of the links and navigate to Maintain Involved Parties. You can decide
which party roles you want to use in your application. However some party roles are set as mandatory by
default and you cannot deactivate these.
3. Add or edit party roles and under Party Role Assignments click Add Row.
4. Select a Party Role from the dropdown list.
5. Decide whether the role should be, for example, active, mandatory, unique, or should be forbidden for
manual changes.
6. Save your changes.
7. Then click Maintain Determinations where you can edit the determination for the newly added party role.
8. For Delete Role Assignments, select the line you want to delete and click Delete.
Use party determination to configure whether the reporter information is copied from the account data linked
to the ticket.
Context
Your administrator can choose whether the ticket reporter is copied from the account contact information,
entered as the currently logged in user, or entered manually.
Procedure
1. Go to Business Configuration and search for Ticket. Your search returns the Tickets for Customer Support
and Tickets for Employee Support activities.
2. Based on your scenario, click either of the links and navigate to Maintain Involved Parties.
3. Select the Reporter role, and then select Maintain Determinations.
4. Select the steps used to populate the ticket reporter field.
Tip
Each of these steps is evaluated in the order shown. The first value found is used to fill the reporter
field. For example, if you select all four steps, and there is no account associated with the ticket, then
the currently logged in user is used as the reporter. If no steps are selected, then the reporter must
always be entered manually.
If the ticket is created as a follow-up, or copied from an existing ticket, then the reporter and other
party information is copied from the source object.
Add a contact for custom involved party of category Other Party directly in a ticket.
Go to Tickets Involved Parties and set contact field for custom parties.
The administrator can configure custom involved parties for a ticket. You can then determine custom involved
parties from Installed Base or Registered Product, using the party determination framework.
Use the determination option for Installed Base and Registered Product for custom parties to provide flexibility
to customers where they can add custom involved parties to a ticket and also take advantage of the party
determination framework for custom involved parties.
To add a custom involved party, navigate to Business Configuration Activity List Tickets for Customer
Support Involved Parties .
You can choose to determine the Service Technician and Service Technician Team using party determination
rules instead of copying this information from the associated registered product, installed base, and installation
point, when creating ticket from them. Your administrator can enable this option by selecting the related
question in business configuration.
Navigate to Business Configuration Edit Project Scope Questions Service Customer Care Service
Request Management , and under the Business Option section, enable the question: Use rules to determine
technician and team when creating new ticket from registered product, installed base, or installation
point?
Ticket Number is created and assigned at the creation of the ticket. Administrators can define number ranges
for tickets. When you create a ticket the system automatically determines the next free number of the defined
number range.
Number range for tickets may not always be in sequence. Depending on where the ticket is created the
corresponding number ranges is picked up and assigned. Hence they may not be in the sequence.
Sometimes there maybe missing ticket numbers. Ticket number is created and assigned at the creation of the
ticket. If the Ticket fails to save due to user cancellation or any other process this number would be lost
explaining the missing ticket numbers.
The administrator can configure the number range for your tickets via fine tuning.
You can maintain Number Range in a ticket for Customer and Employee Support. Go to Business Configuration
and search for Ticket. Your search would display the Tickets for Customer Support and Tickets for Employee
Support activities.
Apply consistent access restrictions to the various ticket work centers. The administrator sets this up in the
system.
When access restrictions are applied to any ticket work center, they apply to context access. This results in the
most lenient access all tickets-related work centers that share the access context.
Tickets SEOD_TICKETMD_SADL_WCVIEW
Queue SEOD_QUEUE_SADL_OWL
Remember
All work centers assigned to a business user or business role that share the same access context should
have the same level of access restriction.
The administrator can restrict some business roles from creating new tickets, by configuring authorization via
Access Restriction. This feature restricts ticket creation to selected employees, based on their role.
Navigate to Administrator General Settings Users Business Roles and select the necessary business
role to set up access restrictions for ticket creation.
Time Points comprise of various time lines in a ticket providing you with information about when certain ticket
tasks were created, highlighting deadlines, and the time range when a ticket for a particular stage of processing
needs to be completed.
The following list provides you with options of ticket tasks that you might want to capture in your ticket:
Request Receipt Time Point Time point at which a request is received, and when Ticket is
reopened.
Warranty start reference time point Together with a duration from the date profile, the warranty
start reference time point determines the start date of a war
ranty, which is assigned to a ticket.
Escalation Time Point Time point when the ticket was escalated. Deescalation initi
alizes the time point.
Due Date for Completion Time point at which something shall be completed.
Due Date for On-site Arrival Time point at which the technician shall be at the customers
site.
On-site Arrival Date Time point at which the technician arrived at the customers
site.
Due Date for Resolution Time point at which the issue shall be fixed for the customer.
Resolved On Date Time point at which the issue was fixed for the customer.
Due Date for Initial Review Time point at which an initial reaction should take place (Set
to In Process)
Due Date for Response Ticket creator(such as: Customer) will be continuously in
formed about the Ticket status and progress. As long as the
ticket is in “Processor Action”, the processor needs to send
an update, such as:. every 2 hours.
Response by Processor Reference Time Point Reference Time point for calculation of Due Date for Re
sponse
Response by Processor Time Point Time point at which the processor sends an update to the re
quester (such as: Customer). Sets also the reference time
point.
Response by Requester Time Point Time point at which the requester (such as: Customer)
sends an update onto the Ticket. Sets also the reference
time point.
Request Closed at Time Point Time point at which a request is considered as finally closed.
Request Finished at Time Point Time point at which the processing of a request is com
pleted.
Request Initial Receipt Time Point Time point at which a request is received for the first time
(customer reports incident)
Request in Process at Tme Point Time point at which an order is taken up for processing.
You can check the credit status, credit limit, and credit exposure for your customers before providing them any
service.
In a ticket, selecting Actions Request External Pricing would provide you information for Credit Status,
Credit Limit, and Credit Exposure from the SAP ERP system.
Note
4.3.9.1 Sub-Tickets
Sub-tickets enable you to group multiple tickets under one main ticket. For example, several tickets created
due to the same root cause can be grouped under one main ticket and closed once the underlying issue is
resolved.
From the ticket detail view, Sub-Tickets tab you can perform the following actions with sub-tickets, both online
and while working in offline mode:
You can quickly add the current ticket as a sub-ticket by entering a ticket ID in the Main Ticket field in the
header area on the Overview tab.
Administrators can configure the solution to prevent closing main tickets with open sub-tickets.
Go to Business Configuration Implementation Projects Your Project Edit Project Scope Questions
Service Customer Care Service Request Management Questions Ticket Completion
To prevent closing main tickets with open sub-tickets, choose In Scope for the question: Do you want to prevent
users from completing main tickets when sub-tickets remain open?
In tickets, skills are determined from customers, registered products, products, and installed base. Skills can
be determined in tickets only in the online mode.
The Skills tab of Tickets displays the list of all skills that are determined or added at the tickets header level. If
any of the entities ( customers, registered products, products, or installed base) is updated in a ticket, skills are
redetermined. You can modify a skill by selecting or deselecting the Mandatory checkbox. You can also delete a
skill. If a skill is updated manually, it is not updated during redetermination.
If you want to add additional skills, you have to add them manually. To add skills manually to tickets, on the
Skills tab, click Add and in the Add Skills window, enter the required details.
If you want to make the skill mandatory, select the Mandatory checkbox.
When you add a new skill, skills are redetermined in the ticket.
Example
There is a ticket for a customer named BlueDrive, and French is maintained as a language skill for this
customer. The ticket also has a registered product associated to it. The Serial ID is SOLGRD 98907870. For
this registered product, the Processing Unit Repair skill is maintained. Therefore, based on the customer
and the registered product, these two skills (French and Processing Unit Repair) are determined for the
ticket.
When an item is added in a ticket, skills from the ticket header are determined for the item as well. Skills
maintained for a product are also determined at the ticket item level.
If you want to add additional skills, you have to add them manually. To add skills manually to a ticket item, on
the Skills tab, click Add and in the Add Skills window, enter the required details.
Note
If you want to make the skill mandatory, select the Mandatory checkbox.
If an item is in Ready or equivalent status, you cannot update or determine the skill.
The administrator must enable Skills via business configuration to use the feature in ticket.
Go to Service Customer Care Service Request Management Questions and select the question: Do
you want to enable Skills Functionality in Ticket?
The Service Location in a ticket refers to the location or address where the service would be performed. The
address can be defined as: Address of a Business Partner (Ship-To-Party), Address of an Installation Point or
Installed Base or Registered Product, Document-specific address in the ticket.
Set up ticket routing based either on organizational structure or team and territory.
Note
Among other properties, you can specify customer language as a ticket routing rule criteria to assign
tickets to a team or a territory.
Context
Restriction
Your organization can choose to route tickets either with routing rules, or by organizational structure, but
not both.
Procedure
1. Go to Administrator Service and Social Work Distribution , then select one of these options:
The first time you set up business rules you must configure the rules table. By default, the first 20 fields on
the screen appear as columns in the table. Use the left and right arrow buttons to remove any unwanted
default columns and add only the fields you wish to use. You can have up to 15 columns in the table,
including the results column.
Use only the columns required for assigning objects. Extra columns can impact performance. You can
add additional columns and rules at any time.
3. Choose Insert Row above the rules table. A new row with an asterisk in each field of the row is added to the
table.
You can add values to more than one field in a row. The fields in one row evaluate with a logical AND
relationship. The field values must all evaluate to true in order for the rule to evaluate to true.
4. Click the asterisk symbol (*) in a cell to enter a value for that field. The rules table offers a variety of logical
operators to define your values.
Tip
We recommend that you take full advantage of operators to consolidate your rules for better
performance.
For example, if your rules determine assignments based on zip codes, use the Between operator to set
up a range of zip codes in sequence. Use the Include operator to group zip codes that have the same
prefix.
The Comparison Operations document in the Related Links section provides detailed information on
operators in your solution.
The system compares rows using the logical OR operator. The system compares each rule, top to bottom,
until ONE evaluates to true.
Tip
Among other properties, you can specify customer language as a ticket routing rule criteria, to assign
tickets to a team or a territory.
To enable your changes, you must activate the new rules. Otherwise, the system uses the previous rule set.
Related Information
http://help.sap.com/saphelp_nw73/helpdata/en/50/9eecf3152c4fb08d50e94faaf4a277/content.htm
Assign local administrators to geographical areas for which they can create rules.
Context
Only administrators with global access rights can create and edit restrictions for local administrators.
Procedure
1. Go to Administrator Service and Social Work Distribution Ticket Routing Rules to open the rules
table.
2. Choose Add Row above the Local Administrators Restrictions table.
3. Enter a Country and Region to allow for rule creation.
4. Choose a local administrator for that country and region.
The local administrator can create rules that apply only to the specified country and region.
5. Continue to add rows for each local administrator you wish to assign.
6. Choose Save when finished.
Administrators can define work distribution rules to enable routing of tickets to particular team or agent
queues.
Prerequisites
Restriction
Your organization can choose to route tickets either with routing rules, or by organizational structure, but
not both.
Context
Work items are tickets in the system created from customer messages. You can also create organizational work
distribution rules to manage escalation routing and routing based on social media channels.
By default, all incoming customer service tickets are visible to all employees with the corresponding access
rights. The Organizational Work Distribution and Employee Work Distribution views enable you to manage the
distribution of customer tickets within your service organization. You create rules that allow the system to
evaluate the tickets and distribute them to the responsible team or the responsible processing agent.
Procedure
The system processes work distribution rules according to their priorities. If you have maintained multiple
rules for a work category, the system only uses the first rule that applies. By default, new rules are added to
the bottom of the list, and so have the lowest priority. To change the priority, move a rule up or down in the
table.
Note
To ensure that all tickets are routed properly, we recommend that you create a default rule at the
bottom of the rule list. The default rule should be applicable to the properties of any incoming
customer message. If no other routing rules apply, the default rule routes tickets.
4. Enter the name, choose, or enter the ID of the responsible customer service org. unit, or service agent and
enter the validity period for the rule.
5. Go to the Rule Details section and specify the parameters for the rule.
Each of the following parameters appears as a tab. Using the parameters, you can specify which parameter
is to be included in the rule or excluded from the rule.
○ ABC Classification
○ Country
○ Product Category
○ Service Category
○ Account (Includes all individual customers and customer accounts)
○ Service Priority Code
○ Escalation Status
○ Channel Type
The social media channel type is only supported by SAP Cloud for Social Engagement.
○ Channel
6. Choose Check to verify that your rule is consistent and then save your entries.
7. Move the rule up or down in the list to set priority in the processing sequence.
Service levels determine the initial response and completion due time for processing customer support tickets.
Service Levels
Use service levels to ensure that your organization delivers adequate service, on time, to all your customers.
Define service levels for your organization in accordance with business priorities, to deliver a competitive cost
model, and to measure performance and quality of customer service. Service levels include rules that impact
tickets, which end up in your Queue.
Determination rules are the conditions that determine how a service level is applied. The values and sequence
(top to bottom) set out in the determination rules table is used for selecting and applying a service level for
customer tickets.
Restriction
To implement service level agreements, configure both service levels and determination rules. You can
restrict service levels to:
Context
Procedure
Configure the settings for the new service level in the four tabs: General, Reaction Times, and Operating
Hours. The Changes tab is for change history and is blank for new entries.
2. Enter a name, ID, and description for the new service level on the General tab.
3. Add milestones on the Reaction Times tab.
4. Select a milestone type.
Restriction
Automatic alerts for overdue milestones are not currently supported in SAP Cloud for Customer.
5. Add details for a milestone. Select an entry in the Milestones table and then add rows to the Details of
Milestone table as needed. Select Type of Service, Priority, and Net Labor Time for each row.
You can maintain multiple service types and priorities for a milestone. Add a new row for each priority.
Tip
For Net Labor Time if you enter the duration in hours, the system only considers operating hours. If you
enter the duration in days, the system uses the Weekly Configuration, but not the time ranges. You
enter this information on the Operating Hours tab in the next step.
Example
Your working days are from Monday to Friday, from 8:00 to 18:00 and the reporting date is
Wednesday 1.1.2014, 15:00
6. Set the Working Day Calendar, Time Zone, Weekly Configuration, and Time Ranges on the Operating Hours
tab.
Time Ranges allows you to set the hours when your service staff is available. Operating Hours may not be
available, depending on your configuration. If you do not enter operating hours, the system assumes that
service is available 24/7.
7. Select Save to save the new service level. The service level is saved in the system and added to the Service
Levels tab.
8. Activate the new service level. Select the row for the newly created service level and select Change Status,
then choose Active. Status options include: Active, Blocked, and Obsolete.
Administrators can set up rules that automatically assign service levels to tickets.
Context
When you create or edit a service request or ticket, the system uses rules to evaluate which service level to
apply. When a rule is found that matches the ticket, the system applies the appropriate service level. The
service level pushes details about reaction times and due date calculations to the ticket.
Procedure
1. Go to Administrator Service and Social SLA Setup Determine Service Level to open the rules
table.
2. Set up the rules table with Adapt Columns.
The first time you set up business rules you must configure the rules table. By default, the first 15 fields on
the screen appear as columns in the table. Use the left and right arrow buttons to remove any unwanted
default columns and add only the fields you wish to use. You can have up to 15 columns in the table,
including the results column.
Tip
Use only the columns required for assigning objects. Extra columns can impact performance. You can
add additional columns and rules at any time.
You can add values to more than one field in a row. The fields in one row evaluate with a logical AND
relationship. The field values must all evaluate to true in order for the rule to evaluate to true.
4. Click the asterisk symbol (*) in a cell to enter a value for that field. The rules table offers a variety of logical
operators to define your values.
Tip
We recommend that you take full advantage of operators to consolidate your rules for better
performance.
For example, if your rules determine assignments based on zip codes, use the Between operator to set
up a range of zip codes in sequence. Use the Include operator to group zip codes that have the same
prefix.
The Comparison Operations document in the Related Links section provides detailed information on
operators in your solution.
The system compares rows using the logical OR operator. The system compares each rule, top to bottom,
until ONE evaluates to true.
Enable your changes by activating the new rules. Otherwise, the system uses the previous rule set.
Related Information
http://help.sap.com/saphelp_nw73/helpdata/en/50/9eecf3152c4fb08d50e94faaf4a277/content.htm
Service categories are used to capture consistent information, to allow for reporting and benchmarking, and
for determining service level assignments.
A second reason why categorization plays a central role is that it gradually builds up valuable knowledge on the
individual customer service business: Frequencies of categorizations among the respective business
transaction documents can be analyzed and interpreted in terms of business requirements and market
demands.
Creating and defining categories helps build valuable knowledge about the customer and also collects data
that can be analyzed to understand business requirements and market demands.
Context
The administrator can create Service Categories to channel incoming service incidents to different service
catalogs, as defined in the system.
Procedure
1. To create and organize service categories and incident categories (subcategories) within service category
catalogs, go to Administrator Service and Social Settings and choose Service Categories.
2. Click New, then choose Service Category Catalog to open the New Service Category Catalog editor.
3. On the General tab, enter the following data:
a. In the General section, enter the catalog name, valid from/to date, and description.
b. In the Usage section, select the business documents that use the catalog.
Tip
We recommend starting with a Process category type at the top level of your catalog structure,
followed by the other category types as sub level categories.
There is no limit to the number of service-category levels you can create in a service catalog. However,
we recommend that you do not create more than four sublevels as an increased number of levels may
make it more difficult to navigate.
5. To edit a category, select the category from the Categories table and edit the details, such as category
name, type or ID.
Tip
A service category catalog can no longer be edited after the valid-from date is reached. In this case,
simply create a new catalog version.
6. Click Change Status, then Release to release the new service category catalog.
7. Click Save.
8. Click Close to return to the Service Categories view.
9. The new service category catalog is added to the list in the Service Categories view. To open the service
category catalog from this list, click the appropriate catalog ID link.
Results
You can create a comma separated value (CSV) file to upload your entire service category catalog, rather than
creating each entry manually in the system. This method also supports uploading multiple languages in the
same file.
Create a spreadsheet with the following data pattern and save in CSV format.
<CategoryID>;<CategoryType>;<ParentCategoryID>;<Language1>;<Name1>;<Description1>
;<Language2>;<Name2>;<Description2>...
Service category catalog files are Microsoft Excel files in comma separated value (CSV) format. Enter
values as shown in the table.
For a complete list of supported language codes, refer to SAP Cloud for Customer System and Software
Requirements .
Points to remember:
● The category ID and Parent Category ID must be different, or else the upload stops with an error.
● For category IDs, the prefix CA_ is reserved for categories created manually in the system, and is never
used for category IDs in upload files.
● Use a semicolon as a separator in the CVS file. The semicolon as a value separator allows you to use
commas in entry text.
● The same restrictions on ID apply to uploaded records as to manually created categories.
● Use additional columns to add multiple languages. Repeat the same data pattern for each additional
language.
● Uploading a catalog replaces the current catalog, if any. The system can have only one service category
catalog.
Note
Points to remember:
Caution
The upload file is limited to a combined total of 25,000 category entries in all languages. If you require a
larger service category catalog, please contact SAP support.
Related Information
To create a new version of a catalog, click on the catalog and select New then Version.
● You can have only one active catalog per usage, for example for service requests, at any one time.
The following example shows the correct way to use catalog versions.
Example
Catalog 1 V2 from 1 January 2011 to 31 December 9999 also for service requests
The following example shows the wrong way to use catalog versions. In this case, there are overlapping periods
for the same usage, service requests.
Example
Catalog 1 V2 from 1 August 2010 to 31 December 2010 also for service requests
Remember
● Before deleting or changing categories in your catalog, consider where those ticket categories are
used. Be sure to update your workflow rules, self-service portal, custom solutions, APIs, or any other
instance that includes a list of categories.
Consider the following when deleting a catalog or changing the status of a catalog:
● You can set a released catalog back to In Preparation if the valid-from date has not yet been reached.
● Catalogs that have already been released and are in use cannot be deleted or modified. To remove the
catalog from use, create a new version of the catalog, limit the valid-to date to today’s date, and release it.
Explore your options and tools that help you work with tickets in the solution.
The solution provides many tools and options that help you deliver excellent customer service. Respond to
tickets, set up an on-site appointment for a work ticket, or check warranty or contract terms. The information
in this section helps you with your daily ticket processing tasks.
Once you start work on a ticket you can communicate back or respond to the customer to let them know:
Respond either on the original communication channel or switch to a new, more appropriate communication
channel, depending on the customer preference.
Compose your reply with the built-in response editor, or use an external e-mail application, depending on your
company preference.
The response editor includes basic text formatting options. You can apply templates and add images to your
response.
Tip
Drag and drop images into your response, or browse for an image, or enter a URL for an on-line image.
To keep reply file size down, the current reply does not include images from previous messages in the thread.
You can view all images in the thread in the interactions list.
Response templates are text-only snippets containing frequently used content. These templates increase your
efficiency by speeding up text entry for ticket responses.
Your organization can create corporate response templates visible to all agents. Each user can also create
personal templates based on their own habits and preferences. Response templates can include placeholders
that are automatically resolved by the system when adding them to a response. When you select a template,
the system displays templates that match the current communication channel. For example, when composing
an e-mail the system shows e-mail templates and not messaging or social media templates. Users and
Administrators can define queries to show only specific templates. For example, show only response templates
matching the ticket language.
Administrators and users can create templates for standard ticket response text.
Context
Follow the steps to create and set up a template for ticket response.
Procedure
1. Go to Service Templates .
2. Add a new template and enter the required information: Name, Subject, Channel Type, and Template Text.
For response templates, select Text-Based for Template Type.
You can edit the template text as needed when you add placeholders.
Note
Use document-based templates to create branding that surrounds the reply text. Branding templates
can be linked to specific communications channels.
3. Select Save and Open to view template details for further editing.
4. Add placeholders (optional). Add a row to the placeholder table. Define a placeholder tag in the first
column and select a field in the second column to populate the placeholder.
Placeholders names are surrounded by the pound sign (#). For example, define a placeholder name
#CustID# and select the field Customer ID to insert the customer ID number into the template text. Once
you define your desired placeholders, you can insert them into the template text. When the user selects the
template, the solution fills in the placeholders with ticket data.
5. Set template as Corporate to make it available to all users (optional).
Service agents can use Microsoft Outlook and the SAP Cloud for Customer add-in for Microsoft Outlook to
compose and send replies to tickets.
Your Administrator can configure your system to use an external e-mail editor for ticket replies, in this case,
Microsoft Outlook. Replies sent via an external e-mail editor appear as replies on the Interactions tab, rather
than as ticket activities. Once Outlook integration is enabled you can choose to reply from Outlook, or using the
built-in response editor. When you reply with Outlook, you compose and send in a new Outlook window. To
associate the reply with the ticket, include the ticket number in the subject line.
Context
You must scope Microsoft Outlook in your solution to use the tool for responding to your customers.
Procedure
1. Go to Business Configuration Edit Project Scope Questions Service Customer Care Service
Request Management Group: E-mail replies via Microsoft Outlook (1) .
2. Set the question to In Scope.
3. Instruct all agents to download and install the SAP Cloud for Customer Add-In for Microsoft Outlook from
the Download page.
Results
Service agents can now use Microsoft Outlook to respond to tickets. Agents can also respond with the built-in
response editor by deselecting the Use Microsoft Outlook checkbox in Interactions.
You can set the status for multiple tickets in the Tickets list.
Related Information
Track the total time a ticket spends with an agent and the total time with the customer.
You can track the total elapsed time a ticket has spent in any status mapped to processor action. Use this
information to track service level agreement (SLA) and milestone compliance.
● Pause the SLA clock while ticket is in customer action status. Resume when ticket returns to agent. This
feature allows you to track the total time with the agent against the SLA terms. Applies to Completion Due,
Resolution Due, and On-Site Arrival milestones.
● Time with agent and with customer appears in ticket details. Processor and requester durations are
adjusted on status change. Use reports to check for SLA and milestone compliance.
Ticket Items can be used in multiple scenarios such as work tickets, complaint tickets, or simple billing
requests. If you have enabled SAP ERP integration (required for Field Service scenarios), you are able to create
items for Services, Expenses, Pricing, Shipping, Parts, and Time. Alternatively, only complaint and billing
request items are available to you.
Note
You must maintain configuration for Item Processing Codes and Item Processing Determination to use this
feature.
Field Technicians can create items in the Items tab, and based on assignments maintained via business
configuration, the product would get assigned to the related tabs such as Service, Parts, Time, Expenses.
Administrators can assign Products to Usage in master data to filter product search by Service, Time, Part, and
Expenses in the corresponding Work Tickets tab. Administrators can also assign Products to display in the
related tabs such as: Service, Time, Parts, and Expenses based on the associated Processing Codes.
● Field Service or Work Tickets: items can be created for billing requests, services, parts, expenses.
● Complaint Tickets: items can be created for complaint requests, complaint follow-up documents.
● Normal Tickets: items can be created for billing requests.
Services and Parts are invoiced based on the planned quantity and agreed pricing conditions. Time items are
used for pricing only (Timesheet).
Time and Material Service (based on actual costs of parts and time)
Services are used for resource planning only. Time and Parts are invoiced based on the actual quantity. Time
and Parts are also used as cost.
Planned Services is used for resource planning, and actual service and parts is used for billing. Parts are
invoiced based on the actual quantity. Time items are only used for costing. This scenario lets you differentiate
between the actual services that are invoiced to the customer, and the actual time (labor and travel) spend on a
service assignment.
To enable ticket item defaulting based on item processing codes, the administrator has to configure item
processing codes via business configuration.
When you create a ticket item and set a ticket type to it, the system assigns it a processing code based on the
code mapping maintained in the rules table. The administrator has the ability to edit these mappings in the
rules table.
So when you select a ticket type when creating a ticket item, then the system displays default values in the
fields based on the item processing code set in the system. However, at this point, the user has the ability to
edit these fields and change the default values.
Follow the steps below to set-up item processing codes for your business.
1. Go to Business Configuration Open Activity List Fine-Tune Show All Activities Tickets for
Customer Support Maintain Item Processing Codes .
2. Select Add Row.
3. To create item processing codes, populate the required fields. Enter a description.
4. Select the required System Processing Type and the Invoicing Method.
○ System Processing Type
With the System Processing Type you trigger the accounting records for costs and goods movement in
your company.
○ Billing Request creates a request for billing.
○ Complaint Request can be used to report complaints on external document items. This feature
requires SDK development in order to be exposed as a front-end capability.
○ External Procurement creates an SAP ERP sales order with procurement items (item category
TAS), based on actual quantity.
○ Item Planning and Item Confirmation allows custom integration scenarios based on planned
quantity or actual quantity.
○ Part Consumption from Technician Stock marks the item as taken out of the stock of the technician
and triggers the required billing and costing.
○ Part Advance Shipment to Customer Consignment Stock marks the item to be shipped to the
customer’s consignment stock before the technician plans to visit the customer.
○ Part Consumption from Customer Consignment Stock marks the item as consumed material from
the customer consignment stock. It triggers also the required billing and costing.
○ Part Return from Customer Consignment Stock marks the item as the to be returned material
(partly or completely) from the customer consignment stock.
○ Time creates a CATS time posting based on actual quantity. The line item in Billing Request is
based on Invoice Method.
If no integration with SAP ERP exists, the Type field is hidden and always defaulted to this value.
○ Invoicing Method
With the Invoicing Method you decide how the item shall be invoiced in SAP ERP:
○ Fixed Price takes the planned quantities for billing.
Note
Please note that advance shipment doesn’t work with fixed price.
○ Time and Material is the default setting and takes the confirmed (actual) time and quantity for
billing.
○ Not Relevant
5. Save your entries.
Custom processing codes begin with Z. The rest of the codes are provided by the solution.
Example
If an item processing code is flagged as Pricing Relevant, then a ticket item will be set by default as relevant for
pricing. However, this only applies if the ticket type is also set as Pricing Relevant. The default pricing flag at
ticket item level can be changed by the user. In this case, the pricing flag is re-determined.
These are some system processing code types maintained by SAP in the back-end system, but not visible on
the UI.
PART ADVANCE SHIPMENT TO CUSTOMER CONSIGN Creates a sales order of type Consignment Fill-up
MENT STOCK (0004)
PART CONSUMPTION FROM CUSTOMER CONSIGNMENT ● Creates a MM goods movement from customer con
STOCK (0003) signment stock
● Line item in Billing Request, based on Invoice Method
PART RETURN FROM CUSTOMER CONSIGNMENT STOCK Creates a sales order of type Consignment Pick-up
(0005)
ITEM PLANNING (0008) & ITEM CONFIRMATION (0009) Allows custom integration scenarios based on planned
quantity or actual quantity
EXTERNAL PROCUREMENT (0010) Creates an ECC sales order with procurement items (item
category TAS), based on actual qty
For item processing determination, you can configure which processing codes can be determined based on the
product, product category, or ticket type
When creating an item in a ticket, after you enter the product, the determination of the ItemProcessingCode is
triggered based on the settings you've maintained in the Item Processing Determination fine tuning table.
Follow the steps below to set-up and assign item processing codes with the item processing determination for
your business.
1. Go to Business Configuration Open Activity List Fine-Tune Show All Activities Tickets for
Customer Support Maintain Item Processing Determination .
2. Select Add Row.
3. To create item processing determination, populate the required fields, such as Usage Type and Item
Processing Codes.
4. Save your entries and activate the rule.
All Work Tickets relevant for Field Service must have SAP ERP integration enabled.
● If an item processing code is flagged as ERP Relevant, the ERP Release status of a ticket item is set to Not
Released.
● If an item processing code is not flagged as ERP Relevant, the ERP Release status of a ticket item is set to
Not Relevant.
● The ERP Release status can be changed either way from Not Relevant to Not Released by using the item
actions.
● Phone call activities are generated automatically from calls in the live activity center. The system
associates call activities with tickets based on incoming call information. You can also add phone calls to a
ticket manually.
Related Information
Provide customers with ticket summary reports showing actions and resolution and any parts or services
required.
Preview or attach the Adobe Acrobat (PDF) format summary report file to the ticket and send it to the
customer. Include an optional customer signature as an acknowledgment or approval of work done.
Your administrator can customize the output by modifying the form templates with your company branding.
You can create multiple output templates for different uses that include specific ticket information for each
scenario.
Administrators can create and edit templates for ticket summary reports.
Prerequisites
Under Downloads, you have installed Adobe LiveCycle Designer and the Add-In for Adobe LiveCycle Designer.
Context
Use form templates to define the content and layout of ticket summary report documents. Summary reports
are generated in portable document format (PDF) documents that can be printed, or sent as e-mail
attachments.
You can create country-specific form template variants. Language variants are determined by the user logon
language, or in certain cases, by the preferred language of the receiving business partner. For example, an
employee in a German company sends a summary report to a business partner in France. The solution
searches for a French language variant of the form template and uses this template to generate the document.
If a language variant is not available in the recipient language, then the form template in the fallback language
English is used.
Customers and partners can use the SAP Cloud Application Studio development tool to implement custom
logic for selecting a template variant.
Restriction
You cannot delete a form template once it is used to output a report because the template is referenced in
the document output history.
Recommendation
We recommend that you edit form templates provided by SAP or partners instead of creating new form
templates. Editing provided templates means that you do not have to adapt any output settings and you
can also manage all versions of the template. Form template versions that you customize are not
overwritten by SAP or partner upgrades.
Procedure
As a starting point, select a template with characteristics similar to the form you want to create.
3. Enter a name and description, and select a language.
If you are creating a country-specific form template, select the country. If the template is not country-
specific, leave this field blank.
4. If you want to use master templates to determine the layout of the template, select the Form Master
Template checkbox. If you use a company-specific form master template, the header, footer, and sender
address used in the form are defined and consistent. If a company-specific master template in not
available in the solution, the system uses a default master template.
5. Select the form template variant you want to edit and choose Open Adobe LiveCycle Designer .
For more information about using Adobe LiveCycle Designer, see the Adobe product documentation.
6. Save your changes.
7. Click Publish.
Publishing makes your new template version available for all users.
Next Steps
You can find more information on form templates in the guide entitled Setting-Up SAP Cloud for Customer
System on the SAP help portal at https://help.sap.com/cloud4customer.
You can generate a ticket summary and capture a signature for it. This feature is also available in the offline
mode.
Note
Currently all published templates (irrespective of the country) are listed in the list of available templates.
This feature is available in English only.
Go to Business Configuration Implementation Projects Your Project Edit Project Scope Scoping
Questions Service Customer Care Service Request Management Ticket Summary Templates and
check the box next to the question: Do you want to use locally-stored templates for ticket summary
reports?
Check in SAP ERP system if ticket items are available to promise (ATP).
If you are using the Fiori client, you can check if ticket items are available to promise in your SAP EPR system.
Trigger ATP Check in the Actions menu in ticket detail view. Availability date and quantity information appears
on the Items tab under ATP.
Administrators can set up document types and item processing codes for available-to-promise (ATP) check.
Context
Procedure
1. Configure document types. Go to Business Configuration Implementation Projects and select Open
Activity List. Select All Activities, then search for ticket. Select Tickets for Customer Support, then select
Maintain Document Types. Select the ATP Relevant checkbox for each document type you wish to enable
for ATP check.
2. Configure item processing codes. Go toGo to Business Configuration Implementation Projects and
select Open Activity List. Select All Activities, then search for ticket. Select Tickets for Customer Support,
then select Maintain Item Processing Codes. Select the ATP Check Relevant checkbox for each processing
Service technicians can request estimated pricing information for ticket service parts or products while
working in offline mode. Service uses a subset of the offline pricing fields and functionality. The enablement
steps are the same whether using offline pricing for Sales or Service.
The following four fields are used for offline pricing in service tickets:
● Sales Organization
● Distribution Channel
● Product
● Country
Restriction
Flexible offline pricing supports multiple fields, price, discount, and surcharge determination.
Reuse existing pricing procedures for supported fields from ERP by simply exporting them from SAP ERP and
uploading them in SAP Cloud for Customer.
Caution
Lean offline pricing that you may have implemented is deprecated and is supported only until 1805. Once
you have enabled the new flexible offline pricing, the previous lean offline pricing will no longer work.
Note
You need to make sure that your SAP Cloud for Customer ERP add-on (CODERINT) should be in
CODERINT 6.0 SP26 level or above.
Related Information
You can Request External Pricing in Ticket, External Pricing Conditions in Ticket, Re-Pricing Based on Actual
Quantities in Ticket, Manual Pricing Changes in Ticket, Header Pricing Information in Ticket, or Release to SAP
ERP with Pricing Conditions.
When you create a new ticket, based on the selected ticket type, you can request for pricing in the Items tab. In
the Items tab, fill in data for Planned Total and Actual Total and select Actions Request External Pricing .
The Net Price field gets populated.
Based on the data entered in the Planned Quantity and Actual Quantity fields, the system can calculate the
Actual Total, Planned Total, and Net Price of the ticket item.
You can change the actual quantity and request for pricing again. You can also manually change the price of the
item in the Items tab.
Administrators can learn about external pricing call configuration to retrieve the complete pricing result from
SAP on premise systems to your cloud solution.
If external pricing is selected, a synchronous call is required to retrieve the complete pricing result from the
SAP on premise system to your cloud solution. Replicated sales documents also require a synchronous pricing
update once the sales document is updated during save.
If the document was previously replicate, with this configuration, you can disable the synchronous pricing call
to the system,. In addition, you can disable the synchronous call completely, which is also valid for quotes
created in your cloud solution. For both configuration options, the pricing status is calculated successfully
through the asynchronous call from the external system. The user can still trigger pricing synchronously by
clicking the asynchronous call action.
To configure external pricing call, go to fine-tuning activity Ticket Tickets for Customer Support
Document Types :
● If an item processing code is flagged as Pricing Relevant, then the ticket item would be set as relevant for
pricing, by default.
● The default pricing flag on ticket item level can be changed by the user.
● The pricing flag is re-determined if the item processing code is changed by the user.
You can set item coverage in the Items tab and request for pricing estimate in the offline mode.
This would help you provide price estimates to your customers on the spot in the offline mode, based on the
ticket item coverage.
Service technicians can request estimated pricing information for ticket service parts or products while
working in offline mode. Service uses a subset of the offline pricing fields and functionality. The enablement
steps are the same whether using offline pricing for Sales or Service.
The following four fields are used for offline pricing in service tickets:
● Sales Organization
● Distribution Channel
● Product
● Country
Restriction
In addition to the limitations listed in the Solution Scope section, component-level breakdown for pricing is
not available for service tickets.
Learn more about how to request external pricing for sales quotes with SAP ERP, SAP CRM or SAP S/4HANA
on premise solution.
Your administrator has correctly set-up external pricing. You create a quote, request the pricing from the
external system by clicking Actions Request Pricing . Similarly, you can use the action Simulate to
retrieve external pricing for a sales order.
The external system then simulates a complete document, and you receive the results in your quote or order.
In the solution, you can adapt the following header hidden fields and make them visible for external pricing:
On the detailed tab of the sales quote Products tab, the following fields are displayed:
● Product Pricing – Displays the pricing overview for the selected Product.
● Total Pricing – Displays the pricing overview for the complete sales quote.
● Adjusted Item Price – Considers item and header price elements
● Adjusted Item Value – Considers item and header price element times requested quantity.
Note
Fields List Price and Product Discount (%) are not available in the product table for external pricing.
Follow-up Documents
You have an integration with an external system, process your sales orders, and can capture the references to
the follow-up documents in the quote. Navigate to Sales Documents External Follow-Up Documents .
If you have scoped external pricing, adapt and translate the condition types and pricing procedures from the
external system to your own needs in the External Pricing fine-tune activity.
Also, set the External Pricing checkbox for the corresponding sales quote document types.
If your solution includes integration to an external system and you've chosen to enable external pricing, you can
configure the external price elements at the item and header levels for sales quotes to provide quick access to
view and edit the pricing data. By configuring these elements, you can also remove the Product Pricing and
Total Pricing tabs from the Products tab of the sales quote. Execute these steps to define the configuration:
● Checklists for work tickets – This type of survey can be site safety checklists, equipment checklists, and
other instances requiring a procedural aid, or guidelines. You can generate a summary of a survey and
attach it to the ticket to provide a record of the responses. Summaries enable tracking of service policies
and regulations.
● Customer satisfaction surveys – Once you complete a ticket you can send a link to a satisfaction survey
requesting customer feedback.
Related Information
You can define registered product surveys for specific products or product categories. Registered Product is
determined in a survey based on the ticket context and product category.
You can assign a warranty to a registered product or installation point, and determine its coverage in a ticket.
A warranty gets determined in the ticket header. Warranty determination is based on installation point,
registered product, service date, and ticket incident category. You can assign warranty coverage in a ticket,
which is determined on the ticket header, with inheritance to items. It influences external pricing (item) based
on the accounting indicator in SAP ERP.
A contract is determined and automatically added to a work ticket during ticket creation. This also applies to a
SLA (service level agreement), which might form as part of a contract that you would be able to view after
ticket determination in the ticket header.
● Contract determination in a ticket occurs based on ticket header information and item data.
● There is no direst dependency between the contract determination given by ticket header and the
contracts determined by the ticket items.
● It is possible to maintain multiple contracts in item level.
● Contract hierarchy is supported.
● Setting different contract determination logic and parameters is possible via BaDI implementation.
The administrator would configure contract types and usage restrictions based on additional criteria such as
ticket type.
You can create different contract document types with restricted coverage based on the context they are used
in. You can associate specific contract types with specific ticket types to auto assign the appropriate contract
for a ticket type.
Users can specify usage restrictions for each contract item. When a user creates a work ticket, the system
automatically applies the specified usage restrictions based on the ticket type.
You can search for tickets associated with contract (on header and item level).
Note
Based on the selected query, there are different field compositions for advanced search and result
columns.
The covered object is equal to the reference object in the ticket – for that reason the agent can easily navigate
from the ticket contract hyperlink directly to the contract to inform customers about their entitlements.
Context
A customer has an issue with a product and contacts the service representative providing them their contract
id or contract name. To react quickly to the customer’s request, the representative wants to view only the
tickets only for a particular customer contract.
Procedure
4. From the ticket overview, select Summary Preview to review billing details.
5. If desired, add notes to the ticket.
6. Save your entries.
For quantity contracts, you can select the quantity contract item and search in its Release History for
related tickets to see remaining quantity.
You can also navigate to the Ticket tab of the contract to see all tickets related to the contract.
Related Information
Learn how administrators can embed the tickets table tab in a contract overview section.
To have a highly flexible query for contract related tickets, we recommend embedding tickets section in
contracts.
You can now view the embedded Tickets table including all of its queries.
Once you've determined that a ticket needs service, add service items in the Items tab based on service
requirement.
● Manual scheduling requires a resource planner to assign a service technician for the requested service.
Start and end times define time constraints for the planning phase and this data is inherited from the
header. The expected duration for any service is calculated from the planned quantity of the item. Define a
service team that would perform this service.
● Auto Dispatch scheduling automatically searches for an available service technician.
● Appointment Offering scheduling allows the service agent/technician to select appointment slots for their
customer, when creating a service appointment. You have to first enable this option via fine tuning.
Once you maintain the ticket details, you can trigger the demand creation by setting the work progress of the
ticket item to Release for Scheduling. This creates a demand and sends it to resource planning.
Note
In the ticket, maintain the service team and requested time range.
This action sends the demand to the resource scheduler tab and sets the item to In Scheduling. Once the
demand gets scheduled, the status changes to Ready and gets linked to the assignment.
The planned duration for this demand is calculated based on planned quantity. If this UoM is not a time based
unit, then use the conversion rules for the product.
In the ticket, maintain the service technician team and requested time range.
The scheduling method can be configured for the item processing codes for service items relevant for
scheduling.
Context
This is the general flow of tasks and activities for scheduling in Tickets.
Procedure
This feature offers your customers the ability to preselect time slots for a service appointment.
The service agent can offer the customer the ability to choose their appointment time slot and date range.
However, you would need to enable this option first.
When you select the scheduling method for a repair item as Appointment, and choose Release for Scheduling,
the Appointment button gets enabled.
Note
Only items with In Scheduling work progress status are relevant for appointment booking. The Appointment
button, is otherwise disabled. So to change the status of a ticket item to In Scheduling, you would have to
execute an item based action.
On the Appointment Offering screen, you can select a date range and a time slot. Click the Get Appointment
button to get a list of available appointment offerings within your selected date range and time.
Next, select the time your customer requests and save the appointment time to ensure that the time slot is
booked.
In the Assignments tab, you can view the appointment you scheduled. Here's a short video with more
information on the Appointment Offering feature.
Fixed Flag
As the name suggests, this feature restricts editing the time slot or technician based on the type of fixed flag
selection. You can choose this option when choosing an appointment.
The Fixed flag helps avoid any unintended changes to a set time slot. You can choose from these options:
● Fixed Time
Selecting this option would restrict the appointment time. So if the time slot is fixed to morning, then you
can move the appointment to a different hour within the morning time slot of the same day. However, you
cannot move the appointment to the evening or another day. In this case, you would still have the option of
changing the technician.
● Fixed Time and Technician
Selecting this option would restrict the appointment time and the technician. Hence in addition to the time
slot, you cannot change the technician.
You have the option of consuming stock from the Work Tickets tab.
The stock feature provides information on available parts in stock for servicing and repair. The stock data is
replicated from SAP ERP to SAP Cloud for Customer based on the mapping of service technician, service team,
and service organization with the plant and storage location.
● You have an option of adding stock from the Work Tickets work center.
● You also have the option of adding Van Stock Products as Ticket items.
● In the Item Processing Determination fine-tuning activity for tickets, you can maintain the item processing
type depending on Stock type.
Note
If you change the stock location, then selected products get cleared.
Scoping the Stock allows you to view all stock-related information for service technicians, service team, or
service organizations. To use the stock option in a ticket, the administrator would have to assign the Stock work
center to the field service technician business role.
To scope stock for your solution, go to Scoping Business Configuration Implementation Projects Edit
Project Scope Service Entitlement Management Stock Location and select the checkbox. Next, go to
the Questions tab to select the option for using the Stock work center to enable you to view the stock location
data.
To assign the Stock work center to the field service technician business role, go to Administration Work
Center and View Assignments tab. Assign the Stock work center to the field service technician business role
with COD_STOCKLOCATION_WCF ID code.
In the Parts tab, choose the Add from Stock Location action. This displays the My Stock Locations screen, so
you can choose the quantity from your available stock list. A technician can only consume parts from their own
stock.
Next, you can set the work progress status to Finished, then Release to ERP and save your updates.
Learn about the tickets approval process and how to define work distribution and edit conditions.
If your administrator has configured approvals, a task is triggered to forward the ticket or hinder it from moving
to the next stage.
Administrators can set up multilevel approval processes. Based on the configuration settings, user can:
Administrators can explore how to incorporate conditions into the approval process for tickets, such as who
would be allowed to approve the ticket.
The administrator can set the work distribution for tickets. These can be: Approver of Ticket, Direct Approvers,
Manager of Agent Responsible for Ticket, Manager of Service Technician for Ticket, or Responsible for Account.
Activate the approval process for tickets by navigating to Business Configuration Implementation Projects
Edit Project Scope Service Customer Care Service Request Management Group: Approval for
Tickets . Go to Questions and check the boxes for the questions: Do you want to use a multi step approval
for tickets? and Do you want that the system submits automatically a ticket for approval?
You can edit the approval process by editing steps, adding additional steps, and by changing the order of the
steps. You must define who receives approval tasks. You can also define conditions by which an approver is to
receive an approval task.
Once you scope approval for tickets, then you detail the approval process. For this step, you define the approval
conditions and an approver before the approval process is ready to use. Navigate to Administrator
Approval Process . See Creating an Approval Process for details.
Note
At least one approval process must be active. To define an approval process, copy the default approval
process and adapt the approval validity, ensuring one process has an unlimited validity.
You have the option to set approval conditions for a ticket based on additional fields.
The following fields have been added to the ticket approval condition fields:
● Payment Terms
● Incoterms
● Delivery Priority Code
● Incoterms Location
● Billing Block
● Delivery Block
● Order Block
● Credit Status
● Agent ID
● Service Technician ID
● Created On
● Created By
Product List is a list of products or product categories that can be assigned to a customer, sales area, sales
territory, product (required products), or product category. The Service Item category type of product list is
used in a ticket.
Product list in a ticket can be determined from: Maintenance Plans, Reference Product, or Generic Product List.
Related Information
Context
A planner or service technician would be able to plan or confirm items in a ticket based on a predefined list of
parts, service, or expenses.
Procedure
1. Create a new ticket with Service Items type product list. Add a customer and reference product.
Results
The referenced Product and Customer from the ticket header is used for product list determination, and those
products are displayed. Product Categories from Product List are resolved.
You can add products to a ticket from a product list, or if a ticket is created from a maintenance plan, then
items are added to the ticket from the product list assigned to that maintenance plan.
Context
When a ticket is created from a maintenance plan, the product list maintained in the maintenance plan can be
used to assign products.
Context
When you edit a ticket, the solution locks that ticket until you save your changes. The lock prevents others from
making conflicting changes at the same time. Normally, the solution unlocks the ticket when you save your
changes. If you make changes, but don’t save, the ticket remains locked. For example, you could be called away
before saving, or become disconnected from the network. You, as an administrator, can unlock the ticket to
allow editing and changes in case the person that last worked on the ticket is unavailable.
Caution
Unlocking a ticket deletes any unsaved changes made by the person that opened the ticket for editing.
Procedure
The heart of customer service is resolving issues quickly and accurately. Use a knowledge base and collaborate
with colleagues to find the answers to your customer issues. If a customer requires new equipment to resolve
an issue, you can create sales quotes, opportunities, and other follow-up items from a ticket. Managers can
review aggregated ticket data to improve organizational efficiency.
The knowledge base may be pre-populated with articles based on any tags associated with the ticket. If
browsing in your knowledge base is enabled, you can search the knowledge base for relevant articles.
● Choose an article to preview it. Then attach it to the ticket by hovering over the article and choosing Attach,
and send the response back to your customer.
● When you attach an article from the knowledge base, a URL will be entered into the reply box. Choose
Reset to clear your search terms and return to the original list of recommended solutions.
Enable agents to search for solutions and attach articles to responses without having to leave the workspace by
integrating an external knowledge base.
By integrating an external knowledge base, you enable agents to search for solutions and attach articles to
responses without having to leave the workspace. The workspace will also include a list of recommended
articles based on an automatic search of the knowledge base using the product and other keywords identified
via text analysis as the search parameters.
Prerequisites
● You have an external knowledge base that supports the OpenSearch standard with an RSS or Atom based
search API.
● You know the URL for the API (from your knowledge base vendor).
● You know the search term input parameter for the API (from your knowledge base vendor).
Note
The administrator has to scope and enable Knowledge Base Integration in SAP Cloud for Customer solution.
Context
Enabling this feature turns on the solution finder feature of the workspace where your external knowledge base
is integrated.
Procedure
4. In the Scoping Elements list, select Service Customer Care Service Request Management .
5. Enable Knowledge Base Integration by selecting In Scope for that question.
6. Click Next .
7. Click Next .
Context
Procedure
Example
For example, if the URL for the RSS or Atom feed for your knowledge base vendor is https://
KBvendor.com/search?q=test, then the system would extract the parameter, q, with the constant, test.
You would need to delete the constant value so it remains blank.
As the administrator, once you've created the web service for your knowledge base, create a data mashup to
specify the mapping between the search parameters used by the system and the web service input
parameters.
Caution
1. Add the knowledge base web service you created, as a source for the data mashup.
Click the Sources tab.
Depending on the size of your screen, you may have to scroll within the left pane to see the Sources tab.
By default, the Parameters tab is active.
2. Drag and drop the RSS/Atom Services building block onto the central authoring canvas.
3. In the dialog box, select the web service you created for your knowledge base.
4. Using the cursor, draw a connection between the bottom of Mashup In-Port and the top of Fetch Feed boxes
of the new service.
5. With Fetch Feed selected, in the properties pane on the right, select SearchExpression for the search term
parameter.
6. Now with Mashup In-Port selected, in the properties pane on the right, enter a search expression that
you're sure would return results.
7. Click Preview Result.
The results of your search expression are displayed in the result pane.
8. If the results are what you expected, click Next .
If all the information for the mashup is correct and OK, save it by clicking Finish.
Caution
For Administrators: Find out how to create a data mashup to connect the articles in your external knowledge
base to your solution.
The administrator would scope and configure SAP Jam as a knowledge base for ticket responses.
Note
Your system must be integrated with SAP Jam for Feed content before you can use SAP Jam as a
knowledge base.
As an administrator, after you've enabled SAP Jam as a knowledge base, choose a Jam group to use as your
knowledge base.
Go to Administrator Service and Social Knowledge Base SAP Jam Settings , enter the SAP Jam group
that you want to use as knowledge base.
Note
If the knowledge base name is left blank, the solution finder queries all groups to which the user has access.
The solution provides several ways to collaborate with your colleagues. How you collaborate depends on which
optional features your organization has purchased and configured.
Feed Native collaboration option for the solution. You can post up
dates, follow other users and items, and view feed updates
sent by other users.
SAP Jam Feed SAP Jam replaces and enhances the native feed function.
You can post in forums, upload content, create polls and sur
veys and much more.
You can collaborate using SAP JAM groups with some ticket capabilities.
You can:
Bring your partners on a single collaboration platform to increase partner engagement and loyalty. Use
dedicated communities to connect with your partner contacts to exchange ideas, collaborate and deliver
superior content.
As the administrator, once you've enabled SAP JAM for collaborating in a ticket, set up SAP JAM in your
system.
Tip
We recommend using dynamic on-boarding, without explicit user mapping. There are several ways to
achieve this. Refer to the screenshot and find the appropriate option that addresses your user provisioning:
To use SAP JAM to collaborate and resolve a ticket, the administrator must first enable the feature, and
integrate it with our solution.
Go to Scoping Business Configuration Implement Project Edit Project Scope Communication and
Information Exchange People Collaboration, Intranet and External Services Communities and Document
Management Questions . Under SAP JAM Integration, select the question: Do you want to integrate SAP
JAM with your cloud solution?
Learn about the product list feed, which allows you to follow product lists that are relevant to you.
When an administrator creates product lists, an action appears in the product list feed displayed in Feed or
within the product list on the Feed tab.
Users can view feed product list changes by using the follow action.
Your Administrator can configure various reports that allow you to view ticket data on your home page, in
dashboards, and as reports. You can also download report data and work with the numbers in Microsoft Excel.
You can find more information on working with analytics in the SAP Cloud for Customer Business Analytics
Guide, available at https://help.sap.com/cloud4customer.
Quickly identify the solution that solved the issue and closed the ticket.
Use the Solution Center tab to track the solutions used in ticket resolution. Identify the link, note, or
attachment that solved the issue associated with a ticket. This streamlined information access can help find
the solution to similar issues. Future releases may use this data to train machine learning algorithms to
enhance the accuracy of recommended solutions.
Any changes you make to a ticket after it has been created can be viewed in the Changes tab of the Ticket work
center. This tab helps you track attribute updates made in a ticket.
When you want to see the changes made within a certain time frame, fill in the appropriate date range and
select the attribute for which you want to see the changes, and click Go. The system brings up the changes and
selecting each change will display its details.
For the ticket change history, we maintain a white list to indicate which fields will be displayed.
While working on a ticket, you may discover the customer requires additional products, an upgrade, or other
services. Create a follow-up item to associate the new request with the existing ticket.
Find follow-up items created from and associated with this ticket in the Related Items tab. You may need to
adapt or personalize the ticket detail layout to make the Related Items tab visible in your solution.
The following table outlines the types of requests, lists examples, and indicates how to create them in the
different client interfaces.
Create Ticket
Customer wants pricing for product ac Price quote (sales quote)
Fiori Client: + Sales Quote
cessories
Create Opportunity
Customer interested in additional prod Product information (lead) Fiori Client: + Lead
ucts
HTML Client: Follow-Up Items
Create Lead
The depersonalization function allows you to remove personal data from a business object to ensure
compliance with the applicable data protection requirements. Depersonalization is only available for users with
access to the Data Protection and Privacy work center.
When you depersonalize a ticket, the system makes the personal information associated with that ticket
anonymous. All references within the ticket are removed. Hence, when you open a ticket after
depersonalization, you will not see any information related to the contact, customer, or employee associated
with the ticket. This depends on the Read-Access-Login information.
Example
When you search for a ticket and view it's related information, your name or ID is captured by the system
and displays in the Change History or Notes tab.
This information will also become anonymous when you depersonalize a ticket.
● Documents
● Notes
● Attachments
● Change History
● Involved Parties
Note
Once a ticket is depersonalized, you cannot edit or delete it. However, you can search for tickets in the
Depersonalized status. If the Data Privacy Status search parameter is not visible, you can add it through
Personalization or ask your administrators to Adapt the layout.
This topic displays the scope of integration between SAP Cloud for Customer and SAP ERP via high level
integrated functional scenarios.
When a Field Service technician adds the required services and parts, the type impacts how the integration
works with SAP ERP. If the type is Part then a goods movement is issued to SAP ERP for the use of the part. If
the type Service is used, then automatic time recording is integrated with SAP ERP. A billing request for the
parts and services gets created in SAP ERP.
These process flow diagrams display areas where you would integrate our solution with SAP ERP. Service areas
with focus on Tickets pertains to our solution Guide.
Learn how to integrate work ticket created in SAP Cloud for Customer with SAP ERP.
Prerequisites
● Scope the option in Cloud: Integration with External Applications and Solutions Integration into Sales,
Service, and Marketing Processing Do you want to create follow-up documents for service requests from
your cloud solution to an external application?
● Create a controlling scenario in IAOM1, and set the controlling type as Single-Object Controlling in IAOM2
transaction in SAP ERP.
● Create each service technician or employee working on service tickets as a customer inSAP ERP.
● To identify the right consignment stock to be used by the technician, maintain the derivation log-in in
SM30 in COD_V_PLANT_SRV.
● To identify the right activity type for CATS confirmation, maintain the material used on item level in SM30
in COD_V_MAT_ACTTY.
● Schedule jobs to ensure that booking from CATS are accounted to an internal order.
Context
Work tickets created in SAP Cloud for Customer lets you do the following:
Although, there are multiple activities performed for a single ticket, all the confirmations in ERP are created
with reference to a single internal order.
Procedure
To use your own ticket statuses in your processes and schemas, the administrator would have to create the
statuses first in the Ticket Status Dictionary and assign them to life cycle and assignment status.
To maintain entries for ticket status schemas, you first create them in the Ticket Status Dictionary. Go to
Business Configuration Implementation Projects Open Activity Lists Fine Tune and search for Tickets
for Customer Support. Click Maintain Status Dictionary Entries, and using the Add Row button, maintain the
status and create additional status for tickets here.
Use the status values you create in ticket status dictionary and then go to Ticket Status Schemas to assign
them to a ticket.
The following table lists the pre delivered status values that you can select in the ticket and the possibilities to
change them in the ticket. When you create your statuses keep these possibilities in mind.
You can change the description of the pre delivered statuses, but you can't delete them.
● Completed
Note
You, as a customer, can't
change this status.
Besides these, our solution also provides you with various statuses for tickets integrated with SAP ERP. The
SAP ERP ticket statuses are as follows:
● Release to SAP ERP: Once your work on the ticket is complete, you can set the action to Finish Work. The
ticket is now ready to be released to SAP ERP.
● Release Pending: When the ticket is in process the ticket has the Release Pending status.
● Release Discarded: If there are issues when data is sent to SAP ERP, errors display in the error log of the
ticket.
● Released: If there are no issues in the ticket data when released to SAP ERP, the status updates to
Released.
To add a status click Add Row, enter a description, select the wanted life cycle and assignment status, and save
your changes.
To delete a status, select the corresponding status line, click Delete, and save your changes.
After choosing parts required to complete the service for a ticket, you have the option to Release to ERP. This
action triggers the stock update process in SAP ERP.
You have to replicate stock data from SAP ERP to SAP Cloud for Customer to be able to use the stock feature in
our solution.
In the Parts tab, you can add parts with the actual quantity. Next, set the work progress status to Finished and
release to SAP ERP and save.
Note
After you Release to ERP, Material Management (MM) movement occurs in SAP ERP.
Scoping the Stock allows you to view all stock-related information for service technicians, service team, or
service organizations. To use the stock option in a ticket, the administrator would have to assign the Stock work
center to the field service technician business role.
To scope stock for your solution, go to Scoping Business Configuration Implementation Projects Edit
Project Scope Service Entitlement Management Stock Location and select the checkbox. Next, go to
the Questions tab to select the option for using the Stock work center to enable you to view the stock location
data.
To assign the Stock work center to the field service technician business role, go to Administration Work
Center and View Assignments tab. Assign the Stock work center to the field service technician business role
with COD_STOCKLOCATION_WCF ID code.
Advance Shipment order is created in our solution, but processed in SAP ERP.
Context
The process flow diagram displays the advance shipment flow in a Ticket.
1. The service agent creates a ticket and plans an advance shipment item. Go to Service and Repair tab
Release to ERP to release the item for processing to SAP ERP.
2. The document flow gets updated with the SAP ERP consignment fill-up order and can be viewed in the
Document Flow tab.
3. The consignment order is processed in SAP ERP.
4. Next, the field technician confirms the advance shipment item. Go to Parts tab Confirm Part .
5. The part consumption and part return item gets created. You can view this in the Parts tab.
6. Release to SAP ERP and save. Follow-up processes occur in SAP ERP.
We do not have the option to notify the technician about the delivery via workflow.
Request for Finance and Costing is made in SAP Cloud for Customer, but processed in SAP Cloud for
Customer.
In our solution, you have to select the Invoicing Method to implement the Finance and Costing process in SAP
ERP. Go to Tickets Service and Repair General Data Invoicing Method field.
You can Request External Pricing in Ticket, External Pricing Conditions in Ticket, Re-Pricing Based on Actual
Quantities in Ticket, Manual Pricing Changes in Ticket, Header Pricing Information in Ticket, or Release to SAP
ERP with Pricing Conditions.
When you create a new ticket, based on the selected ticket type, you can request for pricing in the Items tab. In
the Items tab, fill in data for Planned Total and Actual Total and select Actions Request External Pricing .
The Net Price field gets populated.
Based on the data entered in the Planned Quantity and Actual Quantity fields, the system can calculate the
Actual Total, Planned Total, and Net Price of the ticket item.
You can change the actual quantity and request for pricing again. You can also manually change the price of the
item in the Items tab.
Administrators can learn about external pricing call configuration to retrieve the complete pricing result from
SAP on premise systems to your cloud solution.
If external pricing is selected, a synchronous call is required to retrieve the complete pricing result from the
SAP on premise system to your cloud solution. Replicated sales documents also require a synchronous pricing
update once the sales document is updated during save.
To configure external pricing call, go to fine-tuning activity Ticket Tickets for Customer Support
Document Types :
● If an item processing code is flagged as Pricing Relevant, then the ticket item would be set as relevant for
pricing, by default.
● The default pricing flag on ticket item level can be changed by the user.
● The pricing flag is re-determined if the item processing code is changed by the user.
You can Request External Pricing only if pricing relevant parameters are set.
Once you've set the necessary parameters, you can Releases to ERP to trigger a billing request. Request
External Pricing is enabled as a workflow action.
Note
Release to ERP is possible even if all ticket items are not relevant for pricing.
Related Information
Administrators can trigger workflow rules based on the value of the Pricing Status and ERP Release Status
fields, or on keywords contained in ticket subject and body.
● Create workflow rules based on the values in the Pricing Status and ERP Release Status fields. These
triggers allow you to set up rules that automatically release a ticket to an SAP ERP system, or request
pricing information.
● Keywords contained in the subject or body text of a ticket can also trigger workflow actions. For example,
route tickets based on whether certain text appears in the ticket. The text or keywords can be entered by
the customer or the agent. For tickets generated from e-mail channels, the body text of the e-mail message
You can add multiple registered products in the ticket header, link a single registered product or installation
point to a ticket item, and integrate with SAP ERP.
When you add a Registered Product in a ticket that integrates with SAP ERP:
● You can add a Registered Product in the Ticket header, which is included in the Internal Order. The
equipment number in the ticket header is also included in Internal Order.
● You can add a Registered Product in the Ticket item, which is included in the Billing Request item. The
equipment number in the ticket item is also included in Billing Request.
This topic describes scenarios where integration occurs between Item Processing Codes and SAP ERP.
● If an item processing code is flagged as ERP Relevant, the ERP Release status of a ticket item is set to Not
Released.
● If an item processing code is not flagged as ERP Relevant, the ERP Release status of a ticket item is set to
Not Released.
● The ERP Release status can be changed between Not Relevant and Not Released using item actions.
The administrator can select the Sales Order processing type code available for Ticket items under Item
Processing Codes activity in fine tuning. Customers can use this processing code while creating Sales Orders in
SAP ERP.
Navigate to Business Configuration Implementation Projects Open Activity List , and search and select
Tickets for Customer Support or Tickets for Employee Support.
Click Maintain Item Processing Codes and select Sales Order to set the processing code.
Use available BaDI in SAP ERP to create custom processing types or ticket items.
● Custom processing type for Item Planning: item can be released to SAP ERP based on a planned quantity.
Work progress status isNot Relevant.
● Custom processing type for Item Confirmation: item can only be released to SAP ERP when work progress
status is Finished.
● Use BaDI in SAP ERP interface to implement project specific integration flows.
The available to promise (ATP) feature in a ticket, for our solution requires integration with the SAP ERP
system. The request for ATP is made in the Items tab of our solution, but the request or check is processed in
SAP ERP.
Administrators can set up document types and item processing codes for available-to-promise (ATP) check.
Context
Procedure
1. Configure document types. Go to Business Configuration Implementation Projects and select Open
Activity List. Select All Activities, then search for ticket. Select Tickets for Customer Support, then select
Maintain Document Types. Select the ATP Relevant checkbox for each document type you wish to enable
2. Configure item processing codes. Go toGo to Business Configuration Implementation Projects and
select Open Activity List. Select All Activities, then search for ticket. Select Tickets for Customer Support,
then select Maintain Item Processing Codes. Select the ATP Check Relevant checkbox for each processing
code you wish to enable for ATP check.
Each of the item processing codes maintained in fine tuning for Tickets is associated with and mapped to
certain values and flags. These can be Pricing Relevant, SAP ERP Relevant, or Scheduling Method. The
administrator can set these values and flags in the system using the business configuration activity list.
Maintain system processing type code for External Procurement, which would in turn create a SAP ERP sales
order with procurement items (item category TAS). This can also be used for SAP ERP sales order with regular
items (TAN).
To enable ticket item defaulting based on item processing codes, the administrator has to configure item
processing codes via business configuration.
When you create a ticket item and set a ticket type to it, the system assigns it a processing code based on the
code mapping maintained in the rules table. The administrator has the ability to edit these mappings in the
rules table.
Each of the processing codes in turn are associated with and mapped to certain values and flags, such as
Pricing Relevant, ERP Relevant, Scheduling Method. You have the ability to set these values and flags in the
system using the business configuration activity list.
Follow the steps below to set-up item processing codes for your business.
1. Go to Business Configuration Open Activity List Fine-Tune Show All Activities Tickets for
Customer Support Maintain Item Processing Codes .
2. Select Add Row.
3. To create item processing codes, populate the required fields. Enter a description.
4. Select the required System Processing Type and the Invoicing Method.
○ System Processing Type
With the System Processing Type you trigger the accounting records for costs and goods movement in
your company.
○ Billing Request creates a request for billing.
○ Complaint Request can be used to report complaints on external document items. This feature
requires SDK development in order to be exposed as a front-end capability.
○ External Procurement creates an SAP ERP sales order with procurement items (item category
TAS), based on actual quantity.
○ Item Planning and Item Confirmation allows custom integration scenarios based on planned
quantity or actual quantity.
○ Part Consumption from Technician Stock marks the item as taken out of the stock of the technician
and triggers the required billing and costing.
○ Part Advance Shipment to Customer Consignment Stock marks the item to be shipped to the
customer’s consignment stock before the technician plans to visit the customer.
○ Part Consumption from Customer Consignment Stock marks the item as consumed material from
the customer consignment stock. It triggers also the required billing and costing.
○ Part Return from Customer Consignment Stock marks the item as the to be returned material
(partly or completely) from the customer consignment stock.
○ Time creates a CATS time posting based on actual quantity. The line item in Billing Request is
based on Invoice Method.
If no integration with SAP ERP exists, the Type field is hidden and always defaulted to this value.
○ Invoicing Method
With the Invoicing Method you decide how the item shall be invoiced in SAP ERP:
○ Fixed Price takes the planned quantities for billing.
Note
Please note that advance shipment doesn’t work with fixed price.
○ Time and Material is the default setting and takes the confirmed (actual) time and quantity for
billing.
○ Not Relevant
5. Save your entries.
Note
Custom processing codes begin with Z. The rest of the codes are provided by the solution.
If an item processing code is flagged as Pricing Relevant, then a ticket item will be set by default as relevant for
pricing. However, this only applies if the ticket type is also set as Pricing Relevant. The default pricing flag at
ticket item level can be changed by the user. In this case, the pricing flag is re-determined.
This topic presents an overview of supported features and limitations for service in offline mode.
Note
Involved Parties Y
Tasks Y Y Y
Follow-up Docu Y* Y
ments*
Visits Y
Items Y Y Y
Services Y Y Y
Parts Y Y Y
Time Y Y Y
Expenses Y Y Y
Work Description Y Y
Sub-Tickets Y Y Y
Time Entries Y Y Y
Notes Y Y Y
Attachments Y Y
Assignments Y
Ticket ID Y
Subject Y Y
Description Y Y
Overview Priority Y Y Y
Escalation Status Y
Status Y Y
Work Progress Y
Contract Y
Ticket Type Y Y
Territory Y
Assigned To Y Y
Service Technician Y Y Y
Approval Status
Service Technician Y Y
Team
Channel
Channel Type
Channel ID
Source Y
Customer Customer Y Y Y
Contact Y Y Y
E-Mail Y
Phone Y
Mobile Y
Fax Y
Gender Y
Job Title
Department
Language
Category Y
Address Y
Individual Cus Y
tomer
Account Y
Building/Floor/ Y Y Y
Room
Street Y Y Y
House Number Y Y Y
City Y Y Y
State Y Y Y
Postal Code Y Y Y
Role Y Y Y
Address Y
Email Y
Phone Y
Mobile Y
Main Contact Y Y Y
Product Product Y Y Y
Installed Base ID Y Y Y
Installation Point Y Y Y
Serial ID Y Y
Warranty Y
Coverage Y
Reference Date
Warranty To Y
Warranty From Y
Product Category Y
Survey Y Y
Description Y Y
Work Description Y Y
Incident Category Y Y
Resolution Cate Y Y
gory
Cause Category Y Y
Object Category Y Y
Timeline Created On Y
Created By Y
Changed On Y
Changed By Y
Requested Start Y Y Y
Date
Requested End Y Y Y
Date
Completion Due Y
Completion Date Y
Reported On Y Y
Reported By
Next Response Y
Due
Reported On Y
Due On-site Y
Arrived On-site Y Y
Resolution Due Y
Resolved On Y Y
Customer Up
dated
Escalated On Y
Sales Organization Y
Sales Unit
Division Y
Distribution Chan Y
nel
External Ticket ID Y
Service Level
Requires Work
Sales Order Y Y Y
Interaction Notes Y
Line Y
Parent Line Y
Product Y Y
Description Y
Work Progress Y
Processing Y Y
Invoicing Method Y Y
Serial ID Y Y
Planned Quantity Y Y
Actual Quantity Y Y
Planned Total
Actual Total
Product Category Y
Requested Start Y Y Y
Actual Start Y Y Y
Actual End Y Y Y
Confirmed Deliv
ery Date
Total Delivery
Quantity
Service Technician Y Y
Installation Point Y Y
Net Price
Changed On
Pricing Relevant
Coverage Y Y
Customer Infor Y Y
mation
Status Y Y
Ticket Y
Service Technician Y
Notes Y
● Accounts
● Contacts
● Individual Customers
Involved Party: Y
● Add
● Delete
● Refresh
Sub-Tickets
Setting status enabled Y
Block Y
Obsolete Y
Items Activate Y
Block Y
Obsolete Y
Delete Y
Block Y
Obsolete Y
Items Activate Y
Block Y
Obsolete Y
Delete Y
Note
Capture Signature is replaced with Generate Summary. Users can capture signature when generating a
ticket summary.
Once you resolve a customer support issue, you close the ticket. Closed tickets are referenced by numerous
other objects in the solution and contain valuable information that can be used to resolve new issues and for
analytics. Closed tickets provide a record of customer interactions, warranty usage information, response
performance information and much more.
Tickets that are created accidentally, or generated by the system, but contain no real support issue can be set
to the status of Irrelevant, which removes the ticket from all queues.
Where unassociated e-mail messages come from and how to deal with them.
If your system is configured to support e-mail as a channel for creating customer service tickets, then any
incoming e-mails that the system cannot automatically convert to a new ticket or assign to an existing ticket
get added to the list of unassociated e-mails. These e-mails must be manually processed by agents.
There are several reasons why an e-mail could not be automatically associated with a ticket. For example, your
system may be configured to require manual processing or there may be more than one contact with the same
sender e-mail address. The system displays the reason in the e-mail details to assist you determining whether
the e-mail should be converted to a new ticket or assigned to an existing ticket.
You'll find the list of unassociated e-mail messages under: Service Unassociated E-Mails .
E-mail messages containing unsupported formatting codes may cause escape codes to appear in the message
content.
Unsupported formatting codes can appear as gibberish or nonsense when you are reviewing the incoming
message.
You can use the time-based workflow and email/notification workflow to create scheduled tasks.
Example
Select the business object - Ticket (you can select any other business object such as, opportunity, lead,
activity, quote, order and so on) and perform the following steps:.
1. Configure workflow trigger to a time based event (24 hours after the Ticket "Changed On" date
2. Configure workflow condition where if the Ticket Processor is "blank".
3. Configure workflow action to send email, create BTM notification, and/or field update of a header field of
the Ticket
If the workflow action is more complex such as updating a node field, creating node entries, creating follow-
ups, or the if the workflow condition needs to evaluate a BO (business object) node field (BO node event like
when a record is saved), then you will need to combine the workflow engine with some SDK ABSL/reuse
functions to achieve the advanced logic you want to evaluate.
Use Case - You want the workflow engine to trigger an email notification
when a particular Involved Party member, Ticket line item, and/or
attachment is added/removed/edited from the Ticket.
Use Case - You want the workflow engine to trigger business logic such as
creating a note entry in the Ticket
For the workflow engine to trigger business logic such as creating a note entry in the Ticket, insert a default
product in Ticket line item, and/or create a follow-up Opportunity, then do the following:
1. Create a custom header action on the Ticket. In the custom header action add the logic you want to
create/edit in the Ticket node. You may even want to create a Reuse function to make the logic more
generic and accept parameters and be consumed in other places besides this custom action
2. Create a custom indicator on the Ticket header.
3. Create a beforesave exit on the Ticket header where if the indicator is set true call the custom action. Once
the custom action is executed, then set the indicator back to false d. Set-up a workflow condition where it
would evaluate if the Ticket header indicator is true or false, if it is true, then call the workflow action which
could be a simple email/notification/field update or again combine it with example #1 to call a custom
follow-up action.
Using the above two examoles, you can cover just about any business logic automation scenario with a few
lines of code and point and click configuration with the workflow engine.
Prerequisites
1. Draft the content of the eßmail notification. This content can be simple text or branded HTML e-mail.
There are also macros/placeholders that can mail merge the business object data into the email or task.
For example, you can create a generic template e-mail with HTML content and placeholders. When the
email notification is triggered, it can replace the #CUSTOMERNAME# placeholder in the template with the
business object data.
2. Define the conditions or rules that define when an e-mail notification is sent. This rules engine is very
flexible so it can evaluate any of the business object fields and create simple to complex multi-condition
statements. For example, you can create a rule that when the service request status changes from Open to
In Progress OR processor = Default Team, then send the e-mail notification
Procedure
1. Under Administrator (workcenter) Workflow Rules Workflow Notification Rules (screen) , click New
or Edit an existing rule.
2. Choose a business object, type of notification, content of notification, business object data you want in the
notification, and the HTML template to format the notification.
3. Configure rules and conditions you want the notification to be sent.
4. Configure the recipients of the notification.
5. Test the notification.
A registered product is an instance of a product that is associated with a specific customer and generally has a
serial number.
When a ticket is created, the registered product information allows the service agent to identify the customer
product and any associated warranties or service entitlements. Additional information, such as product
location is used in the service process.
● Create serialized registered products with customer, location, and warranty information
● Create a ticket that refers to a registered product
● Create a hierarchy of registered product items
● Add registered products to a maintenance plan
● Maintain measurement logs and readings for registered products
● Maintain attributes for a registered product
Administrators can configure registered products using scoping, scoping questions, and fine-tuning activities.
Note
Scoping questions and fine-tuning activities that are straightforward may not be included in this list.
The Registered Product user interface constitutes of two business objects—Installation Point and Individual
Product.
The leading business object is Installation Point. The Installation Point business object has multiple categories.
Registered Product is an installation point of category registered product.
When working with registered products, use the entities created for installation point for the following
scenarios:
Related Information
As an administrator, allow for additional configurations for registered products to the scope of the project.
Navigate to Business Configuration Implementation Projects Your Project Edit Project Scope
Questions Service Entitlement Management , and then select Registered Products and Installed Base. In
the Questions for Registered Products and Installed Base section, under the Additional options for Registered
Product, Installed Base and Installation Points business option, go to You can maintain additional configurations
for Functional Location/Registered Product and select the In Scope checkbox.
Go to Business Configuration Implementation Projects Your Project Edit Project Scope Questions
Service Entitlement Management , and then select Registered Products and Installed Base. From Questions
for Registered Products and Installed Base, select You can manually register serialized products sold.
Note
If you select the You can manually maintain installed bases business option, the option for Registered
Products (You can manually register serialized products sold) also gets selected.
Navigate to Business Configuration Implementation Projects Your Project Open Activity List Fine-
Tune Additional configurations for Registered Product .
On the Additional configurations for Registered Product page, under Registered Product Categories, click the
Maintain Registered Product Categories link.
On the Registered Product Categories page, under Create or Delete Registered Product Category, click Add.
Enter the required details, such as the name of the registered product category and its description.
When you create a registered product category, by default, the Serial ID field is mandatory. However, you can
mark this field as optional for a specific registered product category.
Marking the Serial ID field optional enables replication of equipment from ERP that does not have a Serial ID.
However, for a successful replication, make sure that code list mapping of the equipment is maintained in ERP.
As an administrator, you can create and maintain a status profile for a registered product, and then assign user
status to the profile.
After you assign a status profile to a registered product, you cannot modify it. To assign user status to a status
profile, navigate to Business Configuration Implementation Projects Your Project Open Activity List
Fine-Tune Additional configurations for Registered Product .
On the Additional configurations for Registered Product page, under Registered Product User Status, click the
Maintain Registered Product User Status link.
On the Status Profiles page, click Add Row, and then enter the required details such as staust profile name and
description. Select the status profile, and in the Assign User Status to Status Profile section, define the user
status.
As an administrator, configure involved parties for registered products using the fine-tuning activity.
Using the Involved Parties for Registered Product, Installed Base and Installation Points fine-tuning activity, you
can decide the party roles that you want to use in your application. However, you cannot deactivate the party
roles that are set as mandatory by default.
Note
The party roles that you add using this fine-tuning activity are also applied to installed base and installation
points.
Navigate to Business Configuration Implementation Projects Your Project Open Activity List Fine-
Tune Involved Parties for Registered Product, Installed Base and Installation Points .
On the Involved Parties for Registered Product, Installed Base and Installation Points page, click Add Row, and
select the party role that you want to add.
By default, the location of a registered product is taken from the customer address. However, as an
administrator, you can default the location from the ship-to party address instead.
To use the ship-to party address as the default address, administrators must enable the registered product
location determination.
As an administrator, you can define custom document types for attachments for registered products.
Context
The Attachment tab, due to a backend change in the registered product attachments, may require an adoption
task to enable this feature for your users.
Procedure
2. Search for All Configuration Elements Customer-Defined Document Types For Attachments .
3. Open Customer-Defined Document Types For Attachments and select each Document Type Code. Under
the Usage section, verify if Registered Product (Obsolete) is selected.
5. Click Save. Your users can now create attachments of custom document types in registered products.
As an administrator, create workflow rules for registered products. To create workflow rules, you must have
access to the Workflow work center.
Related Information
As an administrator, use the Installation Point Migration Template to migrate registered products to your
system.
Navigate to Business Configuration Overview , and search for the Migration of Installation Points activity.
Use this object to migrate registered products into your system. (Registered Product is an installation point of
category registered product.)
Create registered product description in different languages, by specifying the language code. The fields that
appear for registered product description are as follows:
● Installation Point ID: The installation point ID for which you add the description.
● Registered Product Description Language: The language in which the registered product description is
created. The entered text displays when the user logs in to the system in that language.
Example: If the user creates an entry for Reg Prod Description English in EN, Reg Prod Description English
appears in the Registered Product Description field. Similarly, for a Reg Prod Description French entry in FR,
the Reg Prod Description French value appears in the Registered Product Description field.
● Registered Product Description Content:The actual description of the registered product.
Create registered product detailed description, to store data in notes and customer information of registered
products, in different languages, by specifying the language code. The fields that appear for registered product
description are as follows:
● Installation Point ID: The installation point ID for which detailed description is added.
● Text type: The value of the text type for notes and customer information. The following table describes the
values and the text type:
10006 Notes
● Language: The language in which the text is created. The entered text appears when the user logs in the
particular language.
Example: If the user creates an entry for Notes English in EN, for 10006 text type, Notes English appears in
the Notes section. Similarly, for a Notes French entry in FR for 10006, Notes French appears in the Notes
section.
● Text content: The actual content of the notes or customer information.
For more information about the activity, on the Migrate Installation Points page, under You Can Also, click Show
Migration Object Documentation.
The A2X web services available for registered products are—Query Registered Products and Manage Registered
Products. However, use the A2X services only to query registered products. For manage scenarios, use the A2A
services.
The Query Registered Products service has two versions. Use version 2 of this service. You can use the following
parameters to query registered products:
● Installation Point ID
● Serial ID
● Involved Parties
● External ID
● Registered Product Category
Create a list of attributes for registered products on which readings will be recorded.
Context
As an administrator, configure extension fields as read-only for blocked and obsolete registered products and
installed bases in the offline mode.
Currently, the extension fields for Blocked and Obsolete registered products and installed bases become
editable in offline mode even when they are read-only in online mode. If you change the values of these
extension fields offline, and try to sync the changes online, the sync fails.
You can avoid sync failure by creating a rule using Key User Tool.
Note
We've used a registered product as an example. A similar rule can be created using an installed base.
1. Open a Registered Product in Active or In Preparation status. Choose Adapt Edit Master Layout from
the menu.
2. Hover your cursor over the extension field and click Change Properties Option as shown here.
3. Click Rule.
4. Choose Create New Rule and create a new rule as shown here.
As an administrator, add extension fields to the header area of the Registered Product detail view.
● Installation Point
● Individual Product
When you add extension fields to a registered product, we recommend that you add them to the Installation
Point – General Information business object.
Note
The extension fields added to the Installation Point – General Information business object cannot be
enabled on the registered product quick create.
Information added to the header area appears automatically in the Registered Product 360º view report. If
you want to include information from fields added to the Customer section, edit the form template with
Adobe LiveCycle Designer.
As an administrator, use the Data Workbench service to import, export, and update registered products data
(from SAP Cloud for Customer).
Note
Extension fields added to Registered Product: General Information cannot be added to the registered
product data workbench service. Similarly, address determination (main address/ship-to address/bill-to
address) of a registered product from the customer/ship to party is not supported. You also cannot enter
the warranty start and end date, as these fields are calculated based on the warranty ID.
For more information about data workbench services, see the Data Workbench user guide.
As an administrator, you can enable code list restrictions for the extension fields added in a registered product.
1. In the Administrator Code List Restrictions tab, click Code List Restrictions.
2. Click New.
3. Select Installation Point/Registered Product in the BO field.
4. Maintain restrictions for the extension field and then save your update.
Context
When you create a registered product, the relevant information is automatically copied from the customer. For
example, the customer location and involved parties such as Ship-to-Party, Bill-to-Party, and service
technician.
When you create a registered product from the agent workspace, the customer and product information in the
ticket are automatically copied into the form.
Procedure
When creating a new registered product, the service technician is determined from the account. The accounts
team can have multiple service technicians as defined in Party Role Definition. The following parameters are
considered:
Create a new registered product with information such as Customer, Serial ID, and Location.
If there are changes made to the following fields on Registered Products, the system administrative data (such
as the Changed On field) is not updated:
Know more about options such as assigning skills, getting GPS coordinates for locations, updating locations,
and using barcode scanning for registered products.
You can assign skills for registered products in the Registered Product tab.
4. Click OK.
Geo location data of a registered product is inherited from the associated customer.
When you create a registered product and add a customer, the registered product inherits the customer
address along with the latitude and longitude information. The address is then displayed as a hyperlink.
Clicking the address link displays the location in a map. The address hyperlink is displayed even if the complete
address is not maintained; however, the latitude or longitude information for the registered product must be
available.
By default, the location of a registered product is taken from the customer address. However, as an
administrator, you can default the location from the ship-to party address instead.
To use the ship-to party address as the default address, administrators must enable the registered product
location determination.
Navigate to Service Entitlement Management Registered Products and Installed Base Additional
options for Registered Product, Installed Base and Installation Points , and select Registered Product uses
customer address as the default location. Do you want to use the ship-to-party address instead?
The Update Location action on Registered Product enables you to update location from the main address, bill-to
address, or ship-to address.
Based on your business configuration settings, the registered product location is determined either from the
customer address or the ship-to-party address. For updating the location, the same source (customer or the
ship-to-party address as chosen in the business configuration) is used. You can choose the address (main
address, ship-to-party address, or bill-to-party address) that should be picked from that source.
Use your device camera to scan the barcode and register a product.
Note
Use the Overview tab to modify customer information, product location details, user status and user status
profile information, and so on. You can also create a new ticket and add a maintenance plan.
Click Edit to maintain the User Status Profile and User Status for a registered product. After assigning a status
profile to a registered product, you cannot change it.
Based on your business configuration settings, the registered product location is determined either from the
customer address or the ship-to-party address. For updating the location, the same source (customer or the
ship-to-party address as chosen in the business configuration) is used. To update the location of a registered
product, follow these steps:
● On the Overview tab of the selected registered product, click Update Location From, and then select the
source address based on your business configuration settings.
Example
If the location determination is based on customer, using the Update Location From option takes the
location from the customer.
Generate a Summary
Click Actions, and then select Preview to generate a summary for the selected registered product. The
summary displays the following details of the registered product:
● General Data
● Address
● Notes
As an administrator, you can create and maintain a status profile for a registered product, and then assign user
status to the profile.
After you assign a status profile to a registered product, you cannot modify it. To assign user status to a status
profile, navigate to Business Configuration Implementation Projects Your Project Open Activity List
Fine-Tune Additional configurations for Registered Product .
On the Additional configurations for Registered Product page, under Registered Product User Status, click the
Maintain Registered Product User Status link.
On the Status Profiles page, click Add Row, and then enter the required details such as staust profile name and
description. Select the status profile, and in the Assign User Status to Status Profile section, define the user
status.
Use the Involved Parties tab to maintain detailed technician information for a specific or preferred technician,
based on skill requirement, for the servicing of a registered product.
● You can maintain roles and party here. SAP provides some standard roles, but you can create custom roles
and custom parties. Maintain it in a party determination schema as an administrative task.
● While creating a ticket for a registered product, party information such as Customer and Service
Technician, is copied to the ticket from the registered product. For some parties the information is based
on involved party determination rules defined for the ticket.
As an administrator, configure involved parties for registered products using the fine-tuning activity.
Using the Involved Parties for Registered Product, Installed Base and Installation Points fine-tuning activity, you
can decide the party roles that you want to use in your application. However, you cannot deactivate the party
roles that are set as mandatory by default.
Note
The party roles that you add using this fine-tuning activity are also applied to installed base and installation
points.
On the Involved Parties for Registered Product, Installed Base and Installation Points page, click Add Row, and
select the party role that you want to add.
Registered product items are visible in a hierarchical list. You can add new or existing registered products at
different levels in this list.
For registered product items, using the Move and Remove actions, update multiple records as the actions affect
the selected item and its associated items. Therefore, updating more than 50 items using the actions from the
UI affects performance.
Tip
The administrator should trigger this action via Migration Workbench or Mass Data Maintenance in
Business Configuration to perform the move or remove actions.
Actions such as Locate and New Ticket, available in the installed base items list, are not available in the
registered product items hierarchy list.
The Tickets tab displays all the associated tickets for a registered product.
A service technician can open a ticket from the tab and view the work details. This tab is also useful to keep a
track of the history of tickets for a registered product. This information helps the technician provide better
service based on the information available for the registered products.
Use the tab when a technician is at a site for a service, and gets a request to service additional registered
products at the same location. The technician can create a new ticket from this tab. The new ticket
automatically populates all the customer information. The technician has to provide only the description or a
specific information related to the service.
The Attachments and Changes tabs for registered products have standard functionalities.
Attachments Tab
You can work with standard attachments. Custom document types are also supported for registered products.
Changes Tab
You can track and view all updates and changes made to a registered product in this tab.
Note
As an administrator, you can define custom document types for attachments for registered products.
Context
The Attachment tab, due to a backend change in the registered product attachments, may require an adoption
task to enable this feature for your users.
Procedure
2. Search for All Configuration Elements Customer-Defined Document Types For Attachments .
4. If Registered Product (Obsolete) is selected, deselect it, and then select Installation Point/Registered
Product.
5. Click Save. Your users can now create attachments of custom document types in registered products.
You can replicate equipment classification for a registered product from SAP ERP to the solution. The
Attributes tab displays the classification data, including attributes and sets that are replicated from SAP ERP.
Note
Replicate the attribute sets and attributes first. These attributes are different from the measurement
attributes.
Related Information
If serial ID for a specific registered product category is marked as optional, then you can create registered
products without serial IDs under that category. Therefore, products from SAP ERP that do not have a serial ID,
can also be replicated. This feature of an optional serial ID can be used with or without SAP ERP integration.
The following is a default function of this feature, when creating a registered product:
Navigate to Business Configuration Implementation Projects Your Project Open Activity List Fine-
Tune Additional configurations for Registered Product .
On the Additional configurations for Registered Product page, under Registered Product Categories, click the
Maintain Registered Product Categories link.
On the Registered Product Categories page, under Create or Delete Registered Product Category, click Add.
Enter the required details, such as the name of the registered product category and its description.
When you create a registered product category, by default, the Serial ID field is mandatory. However, you can
mark this field as optional for a specific registered product category.
Marking the Serial ID field optional enables replication of equipment from ERP that does not have a Serial ID.
However, for a successful replication, make sure that code list mapping of the equipment is maintained in ERP.
1. While you add a registered product category, select the Serial ID Optional checkbox.
2. Click Save.
Assign one or more measurement logs to a registered product. Capture measurement readings throughout
product life cycle.
Create a list of attributes for registered products on which readings will be recorded.
Context
Procedure
As an administrator, create workflow rules for registered products. To create workflow rules, you must have
access to the Workflow work center.
Related Information
Create a ticket for multiple registered products, so you don't have to add the registered products to the created
ticket one by one.
In the Registered Products worklist, select the registered products of the same customer or contact with the
Active status. Then choose New Ticket from the action menu to create a ticket for all the selected registered
products. All the selected registered products are added to the Products tab of the ticket.
You can get information for registered products by using reports and tracking your regictered products.
You can create reports for registered products using the installation point data source. For example, you can
get a list of all registered products for a specific customer or based on the status of registered products.
● Generate a PDF for a registered product using the Equipment 360º view
● Download registered product repair history to an MS Excel® spreadsheet file. The repair history helps the
service technician to get an overview of the registered product and the performed repair.
● View additional default queries in registered products (my registered products, registered products of my
team, and so on)
● View a list of all contracts in which the registered product is a covered item
● View a list of all maintenance plans in which a registered product is a maintenance item
Use Depersonalize in Registered Products to remove personal data from obsolete registered products.
Depersonalization is available only to users with access to the Data Protection and Privacy work center.
When you depersonalize data in Registered Products, the information related to creation of the data is removed.
The change-related fields display the details of the user who initiated the depersonalization and the date on
which it was initiated. The following details are also deleted from the system:
● Involved parties
● Address
● Notes and customer information
● Attachments
● Created by
● Created by of measurement logs (if any)
● Created by of measurement readings (if any)
Note
From the UI, you cannot select more than 10 registered product records for depersonalization. However, if
you use the OData service to depersonalize, you can select any number of records at a time.
Know more about the functionalities that help you to use the Registered Products feature in Service.
A typical scenario depicts a customer call to set up servicing for a registered product.
Click New Ticket from the side panel to create a ticket for setting up a service appointment. You can search for
the registered product by the customer name or by the unique serial ID for the registered product.
When creating a ticket from the registered product UI, information maintained in various tabs of the registered
product gets populated into the new ticket fields.
Under the product section of a ticket, you can see the following:
● Product details
● Serial ID
● Installation point ID (the unique ID for the registered product)
Note
A contract is a legally binding service agreement between parties stating their respective obligations and
responsibilities.
When you create a contract, you can add registered products (or covered objects) in the contract from here. On
the Registered Products user interface, you can see all the contracts and details of that contract associated for
a registered product.
A contract provides all the required information, such as subject matter of contract, registered products (or
covered objects), signature date and validity period, in one place.
Assign measurement logs (using measurement attributes) to a registered product and record readings for the
logs. These logs form the basis for condition evaluation in maintenance plan.
This feature is useful for scenarios where an action is based on a reading. The Measurements tab maintains
the reading types (or measurement logs) and its corresponding readings.
Example
You can create a log named Odometer Reading by using the Distance Traveled measurement attribute.
Multiple measurement logs can be maintained for a registered product.
Example
After servicing the car the technician can maintain the odometer reading along with the date on which
this reading was taken.
Measurement log templates enable you to define common measurement attributes at the product level. The
templates are inherited for each registered product created as reference of the product.
Let's take a common use case scenario to describe why we would maintain measurement parameters for a
registered product.
Example
When multiple coffee machines are sold to a company, you can maintain measurement attributes for all the
coffee machines. You can use the Measurement Log Template under the Products tab to maintain the
attributes. When a registered product is created from this product, the measurement log maintained in the
measurement log template automatically carries over to the registered product. The log template helps a
technician has to service more than one coffee machine at a site. The technician can create a new reading
log for each machine using the Measurements tab.
Plan for periodic maintenance of registered products by adding them as maintenance items in the
maintenance plan.
A maintenance plan consists of maintenance items, also known as registered products, for which rules can be
set. Based on the set parameters, when the conditions are met, the system creates tickets automatically for
scheduling maintenance service for a registered product.
You can do the following from a maintenance plan for a registered product:
● View list of all maintenance plans in which a registered product is a maintenance item.
● Display Last Maintenance Date for a registered product when the maintenance ticket is completed.
○ To view the last maintenance date field, open a registered product and navigate to Maintenance Plans
tab and select a maintenance plan.
● From the maintenance plan UI, add registered products in bulk to a maintenance plan asynchronously as a
background job. You can view the following:
○ A message indicating the bulk addition.
○ The list of added items (after you refresh the page).
○ Logs for this action in the Maintenance Items Logs tab.
From the installed base section on registered product overview, you can add or replace an installed base for a
registered product that is in Active or In Preparation status.
1. Select the Active or In Preparation registered product for which you want to make the changes.
2. In the Overview tab, click Edit.
3. In the Installed Base section, from Value Selection, select the installed base that you want to add.
4. Click Save.
Learn about creating an opportunity for a registered product, creating registered products from an account,
and creating a survey based on the registered products for a specific account.
Create opportunities from registered products using the Opportunities tab of a registered product or using the
Registered Products tab when you select multiple products.
This feature allows you to create opportunities more easily when increasing your line of business from existing
products.
From an open registered product, select the Opportunities tab then select New to begin creating the
opportunity. When the opportunity quick create window opens, the serial ID and the customer fields auto
populate for the registered product you selected. You can then add any other details for the new opportunity.
To create a new opportunity with multiple registered products, follow these steps:
1. Log on to the system as the administrator and navigate to Registered Product tab.
2. From the displayed registered product list, select the row for which you want to create an opportunity.
3. Click the Actions icon and select New Opportunity.
4. On the New Opportunity screen, enter the required details.
5. Save the entries. If you select Save and Open, the Opportunity Overview tab is displayed.
To collect information regarding products that have been installed at a specific account, use a registered
product survey.
Create a registered product survey like regular product survey, but without adding products to it. Instead, when
you assign a survey to a visit, it automatically includes the registered products that have been set for the
assigned account.
Related Information
Search for Registered Products Using the Serial ID and Installation Point Value Help [page 191]
Search for registered products using the Serial ID value help and Installation Point value help in
scenarios such as creating a new ticket or adding a new covered object in contracts.
On the Registered Products lists screen, the basic search supports searching with the following fields:
● Description
● Reference Product Description
● Serial ID
● Customer
● Contact
● Country
● Postal Code
● City
● Street
Note
Fields such as Contract, Country, Postal Code, City, and Street in the Serial ID value help are
personalization hidden and can be enabled as required.
Using Search, with the type ahead feature, in an input field (with value help) displays search results based on
the supported fields in the basic search of that value help.
You can search for a registered product using the following search criteria:
● Registered Product ID
● External ID
● Registered Product Category
● Sales Territory
● Service territory
● Country
● State
Search for registered products using the Serial ID value help and Installation Point value help in scenarios such
as creating a new ticket or adding a new covered object in contracts.
A serial ID is not a unique field by itself—only a combination of product and serial ID is unique. Therefore, it is
possible that duplicate serial IDs exist. If you select a duplicate serial ID, a message indicating to enter a
product appears. In such cases, you can do one of the following:
You can replicate equipment from SAP ERP to SAP Cloud for Customer as registered products.
An SAP ERP equipment is mapped to the registered product in SAP Cloud for Customer. The Equipment ID
field, maintained in SAP ERP is replicated to the External ID field in the solution.
Information replicated from SAP ERP include customer and location details, sales and distribution, user status,
involved parties and warranty dates.
If SAP ERP integration is enabled, the warranty dates maintained for the equipment in SAP ERP is replicated to
SAP Cloud for Customer warranty dates.
If the warranty ID for equipment is maintained in SAP ERP, it is replicated to the External Warranty ID field in the
solution.
You can change the relationship between equipment during SAP ERP replication, irrespective of the status of
the parent or child entity. For example, an equipment E1 is in blocked status, and a new (or existing) equipment
E2 is added under E1 in SAP ERP. This change gets replicated toSAP Cloud for Customer.
Note
From the UI, you cannot assign an equipment to another, when either is in blocked or obsolete status.
You can replicate an equipment without a customer, from SAP ERP to SAP Cloud for Customer.
Note
When changes are made in the SAP Cloud for Customer UI, you cannot create a registered product without
a customer. Additionally, if you make any changes to the registered product (that was replicated from SAP
ERP without a customer), you cannot save the registered product without a customer.
If a user changes the data of an inactive equipment in SAP ERP, the change gets replicated to SAP Cloud for
Customer. This behavior is supported for changes to reference material of equipment as well. This is applicable
only for an SAP ERP replication scenario.
Note
Similar updates are not possible within the solution from the UI or Migration Work Bench.
You can update the fields, listed in the following table, when replicating a registered product from SAP ERP,
even if the registered product is in blocked or obsolete status:
● Serial ID ● Warranty
● Reference Product ● External Warranty ID
● Registered Product Category ● Sales Organization
● Description ● Distribution Channel
● Status ● Division
● Status Profile ● Sales Office
● User Status ● Sales Group
● Involved Parties (all role code) ● Notes
● Reference Data ● Customer Information
● Address Fields
A registered product in SAP Cloud for Customer is replicated from SAP ERP, and is in blocked status.
Change or update the description, material, or serial number in the corresponding equipment in SAP ERP,
which is in inactive status. The changes in SAP ERP trigger update to the description, product, or serial ID
of the same Registered Product in SAP Cloud for Customer.
The Registered Products feature is available in offline mode with limited functionalities. Learn more about them
in the following sections.
This topic describes the supported features and limitations for registered products in offline mode.
Note
Edit
Registered Overview Y Y Y
Product*
*Objects have
restrictions or
some tabs
missing
Involved Party Y Y Y
List Overview Y
Quick Create Y Y
Actions Y Y
Items Y
Tickets Y
Contracts Y
Attachments Y Y
Attributes Y Y
Block Y
Obsolete Y
Items Activate Y
Block Y
Obsolete Y
Delete Y
● Warranty, Sales & Distribution, and User Status sections on the Overview tab is unavailable.
● Address determination is unavailable.
● Registered Product Summary (PDF Preview) is unavailable.
● Add Maintenance Plan action is unavailable.
● Update Product Location action is unavailable.
List
Items
When you download accounts to your device in offline mode, the associated registered products can be
downloaded to your offline device.
Your administrator must set up the relevant offline data download rules.
This section provides you with solutions to some commonly asked questions.
You cannot edit the status profile field after you update the status profile information and save the registered
product. However, you can change its user status.
The registered product information helps the service agent to identify the customer product, location, and any
associated warranty that is crucial for the service process and reporting purposes.
As a service agent, you can create and ticket from the registered product UI. Also, while creating a ticket you
can search for a registered product and add it to the ticket.
Based on the configuration settings, some of the information maintained in the registered product such as
location or party information, are carried over to the ticket.
Warranty is assigned to a registered product. The start and end dates of the warranty coverage for a registered
product gets determined based on its reference date. The reference date is the default start date and the
warranty duration determines the end date.
An installation point is the physical location of the object that requires servicing or maintenance based on the
service or maintenance plan for that object. It also consists of product and text information for an installation
point.
● Functional Location
● Product
● Text
● Registered Product
Administrators can configure installation points using scoping, scoping questions, and fine-tuning activities.
Note
Scoping questions and fine-tuning activities that are straightforward may not be included in this list.
As an administrator, allow additional configurations for functional locations to the scope of the project.
Navigate to Business Configuration Implementation Projects Your Project Edit Project Scope
Questions Service Entitlement Management , and then select Registered Products and Installed Base. In
the Questions for Registered Products and Installed Base section, under the Additional options for Registered
Product, Installed Base and Installation Points business option, go to You can maintain additional configurations
for Functional Location/Registered Product and select the In Scope checkbox.
Administrators can create workflow rules to send emails and notifications, or to update fields.
Context
To create workflow rules, you must have access to the Workflow work center.
Procedure
○ Employee Responsible
○ Contact Person of Customer
○ Owner
○ Service Technician
6. Review and confirm the rule.
Administrators can maintain involved parties for installation points by activating applicable party roles.
Using the Involved Parties for Registered Product, Installed Base and Installation Points fine-tuning activity, you
can decide the party roles that you want to use in your application. However, you cannot deactivate the party
roles that are set as mandatory by default.
Note
The party roles that you add using this fine-tuning activity are also applied to installed base and registered
products.
Navigate to Business Configuration Implementation Projects Your Project Open Activity List Fine-
Tune Involved Parties for Registered Product, Installed Base and Installation Points .
On the Involved Parties for Registered Product, Installed Base and Installation Points page, choose Add Row, and
select the party role that you want to add.
Go to Business Configuration Implementation Projects Your Project Edit Project Scope Questions
Service Entitlement Management , and then select Registered Products and Installed Base. From Questions
for Registered Products and Installed Base, select You can maintain Installed Bases and Installation Points.
Administrators can use the Data Workbench service to import, export, and update installation points data from
SAP Cloud for Customer.
Note
For numeric installation point IDs, export on the Belongs To Installation Point ID field cannot be done using
the Starts With option.
To learn more about Data Workbench service, view the SAP Cloud for Customer Data Workbench
documentation in the SAP Cloud for Customer Help Center.
From the Installation Point tab, you can create a new installation point only with the category of functional
location.
In addition to the common features, this category of installation point supports warranty, sales and distribution
data, and replication from SAP ERP. The customer information and installed base sections are prepopulated
when you create an installation point from an installed base.
Installation points that are categorized as registered products are only displayed in the Registered Product tab.
You can assign a registered product to an installation point. You can also assign an existing registered product
to a current installation point.
To assign an installation point, with product or text category, to an installed base, create the installation point
from the Installed Base.
Note
You can add a functional location to an installed base using a migration template.
Go to Business Configuration Implementation Projects Your Project Edit Project Scope Questions
Service Entitlement Management , and then select Registered Products and Installed Base. From Questions
for Registered Products and Installed Base, select You can maintain Installed Bases and Installation Points.
Administrators can maintain involved parties for installation points by activating applicable party roles.
Using the Involved Parties for Registered Product, Installed Base and Installation Points fine-tuning activity, you
can decide the party roles that you want to use in your application. However, you cannot deactivate the party
roles that are set as mandatory by default.
The party roles that you add using this fine-tuning activity are also applied to installed base and registered
products.
Navigate to Business Configuration Implementation Projects Your Project Open Activity List Fine-
Tune Involved Parties for Registered Product, Installed Base and Installation Points .
On the Involved Parties for Registered Product, Installed Base and Installation Points page, choose Add Row, and
select the party role that you want to add.
Administrators can create workflow rules to send emails and notifications, or to update fields.
Context
To create workflow rules, you must have access to the Workflow work center.
Procedure
○ Employee Responsible
○ Contact Person of Customer
○ Owner
○ Service Technician
6. Review and confirm the rule.
Administrators can use the Data Workbench service to import, export, and update installation points data from
SAP Cloud for Customer.
Note
For numeric installation point IDs, export on the Belongs To Installation Point ID field cannot be done using
the Starts With option.
To learn more about Data Workbench service, view the SAP Cloud for Customer Data Workbench
documentation in the SAP Cloud for Customer Help Center.
Items consist of objects that need servicing, maintenance, or repair. Items must be assigned to installation
points in your SAP solution.
You can maintain the hierarchy structure of an installation points by creating a functional location and
assigning items to it. You can maintain another functional location as the parent of an installation point using
the Belongs to Installation Point ID field. You can also create a new functional location or registered product, or
add an existing registered product as an item to the functional location.
If a functional location contains equipment, then that equipment also appears in the list on the Items tab.
In the Installation Points worklist, choose Export to Microsoft Excel ® from the action menu to export all entries
of the installation points based on the query you choose.
Use Depersonalize in Installation Points to remove personal data from obsolete installation points.
Depersonalization is available only to users with access to the Data Protection and Privacy work center.
When you depersonalize data in Installation Point, the information related to creation of the data is removed.
The change-related fields display the details of the user who initiated the depersonalization and the date on
which it was initiated. The following details are also deleted from the system:
● Involved parties
● Address
● Notes
● Created By
● Attachments
Note
From the UI, you cannot select more than 10 installation point records for depersonalization. However, if
you use the OData service to depersonalize, you can select any number of records at a time.
On the Installation Points screen, the basic search supports searching with the following fields:
● ID
● Description (for all categories of installation Points)
● Serial ID
● External ID
SAP ERP functional location is mapped to Installation Points (with functional location category) in SAP Cloud
for Customer as they carry similar information.
When you replicate the functional location from SAP ERP, most of the party information relevant for installation
point is replicated to SAP Cloud for Customer. The Functional Location ID maintained in SAP ERP is replicated
to the External ID field in SAP Cloud for Customer.
Note
Information for Notes and Customer displayed in SAP Cloud for Customer is replicated from SAP ERP as
well.
When replicating a functional location with a hierarchy, the entire hierarchy tree is replicated. The External ID
field in the Items tab indicates that the functional location has been replicated from SAP ERP.
SAP Cloud for Customer allows updates for the Functional Location fields irrespective of status, when a change
is triggered in SAP ERP.
If you change the data of inactive equipment without changing the status, the change gets replicated to the
SAP Cloud for Customer solution. This behavior is supported for changes to reference material of equipment
as well. It is applicable only to the SAP ERP replication scenario.
Note
Similar updates are not possible in the solution from the UI or the migration work bench.
You can update the following functional location fields when replicating functional location from SAP ERP, even
if the functional location is in blocked or obsolete status:
● Status
● Status Profile
● User Status
Example
A functional location in SAP Cloud for Customer is replicated from SAP ERP that is in blocked status. Change
or update the description, material, or serial number in the corresponding equipment in SAP ERP, which is in
inactive status. The changes in SAP ERP triggers update to the description, product, or serial ID of the same
functional location in SAP Cloud for Customer.
As an administrator, allow additional configurations for functional locations to the scope of the project.
Navigate to Business Configuration Implementation Projects Your Project Edit Project Scope
Questions Service Entitlement Management , and then select Registered Products and Installed Base. In
the Questions for Registered Products and Installed Base section, under the Additional options for Registered
Product, Installed Base and Installation Points business option, go to You can maintain additional configurations
for Functional Location/Registered Product and select the In Scope checkbox.
The Installation Points feature is available in offline mode with limited functionalities. Learn more about them in
the following sections.
This topic presents an overview of supported features and limitations for installation points in offline mode.
Note
Edit
Installation Overview Y Y Y
Points
Items Y Y Y
Involved Parties Y Y Y
● List
○ My Queries based on team/territory is unavailable.
○ Export to excel is unavailable.
○ Advanced Search for Warranty and Service Technician fields is unavailable.
This section provides you with solutions to some commonly asked questions.
No. In SAP Service Cloud, a functional location is an installation point of type Functional Location and is shown
in the Installation Point UI.
Installed base management enables you to maintain a hierarchical representation of items installed at
customer sites. The items contained within are installation points with various installation points types such as
registered product, products, text, and functional location.
The Belongs to Installation Point ID field (if filled) indicates that the installation point is part of the structure (as
a child) of another installation point (registered product or functional location).
Example
Belongs to Installation Point ID for registered product Coffee Machine CM01 displays 21. When you click 21, the
UI for Installation Point 21 is launched, which is a functional location Floor 1. The Items tab of Floor 1 shows
CM01, which means that coffee machine CM01 is under Floor 1.
Items in Registered Product display the included child items in a hierarchy, while in Installation Point, this is a
flat list and only a single item level displays.
In SAP ERP, a functional location can have equipment and other functional locations included under its
hierarchy. Similarly, equipment can have other equipments in a hierarchy under it too. This is supported in SAP
Service Cloud.
A registered product can have other registered products as items and an installation point (functional location)
can have other functional locations or registered products as items.
For a registered product scenario, where installed base is not scoped in, items can consist of registered
products only.
For an installed base scenario, items such as registered products, products, and text can be added directly
under a registered product in the installed base hierarchy.
The functional location is included as a separate entity that results from the replication from SAP ERP
integration and can be created separately within the Installation Point tab. However, it cannot be added as an
installed base item.
Certain information can be maintained at the installed base header level. For example, Involved Parties,
Attachments, Notes and Competitor Products. The status of the installed base changes to In Preparation after it
is saved.
Example
You can maintain an installed base for Company ABC where your servers are installed.
Here's what you can do with the Installed Base management feature:
Administrators can configure installed base using scoping, scoping questions, and fine-tuning activities.
Note
Scoping questions and fine-tuning activities that are straightforward may not be included in this list.
Go to Business Configuration Implementation Projects Your Project Edit Project Scope Questions
Service Entitlement Management , and then select Registered Products and Installed Base. From Questions
for Registered Products and Installed Base, select You can maintain Installed Bases and Installation Points.
Note
When you select the You can maintain Installed Bases and Installation Points business option, the option for
Registered Products (You can manually register serialized products sold) also gets selected.
As an administrator, configure involved parties for installed base using the fine-tuning activity.
Using the Involved Parties for Registered Product, Installed Base and Installation Points fine-tuning activity, you
can decide the party roles that you want to use in your application. However, you cannot deactivate the party
roles that are set as mandatory by default.
Note
The party roles that you add using this fine-tuning activity are also applied to registered products and
installation points.
Navigate to Business Configuration Implementation Projects Your Project Open Activity List Fine-
Tune Involved Parties for Registered Product, Installed Base and Installation Points .
On the Involved Parties for Registered Product, Installed Base and Installation Points page, click Add Row, and
select the party role that you want to add..
As an administrator, use the Data Workbench service to import, export, and update installed base data (from
SAP Cloud for Customer).
You can also use the Installed Base migration template to migrate installed bases to your system. Navigate to
Business Configuration Overview , and search for the Migration of Installed Bases activity.
Context
To create workflow rules, you must have access to the Workflow work center.
Procedure
○ Employee Responsible
○ Contact Person of Customer
○ Owner
○ Service Technician
6. Review and confirm the rule.
Related Information
As an administrator, you can configure whether to automatically update the location of an item when the
customer of the item is updated in Installed Base.
To enable the auto-update, navigate to Business Configuration Implementation Projects Your Project
Edit Project Scope Scoping Questions Service Entitlement Management Registered Products and
Installed Base and check the scoping question: Automatically update location of Items when updating
customer of items for Installed Base?
● If the scoping question: Functional Location/Registered Product uses customer address as the default
location. Do you want to use the ship-to-party address instead? is also checked, when you choose Update
Customer of Items, the location of item is automatically updated to the ship-to-party main address of the
item. In case ship-to-party is not maintained, location of the item is updated to empty.
● If the scoping question: Functional Location/Registered Product uses customer address as the default
location. Do you want to use the ship-to-party address instead? is not checked, the location of item is
automatically updated to the main address of the customer.
Create a new installed base with nformation such as Name, Customer, and Owner.
Know more about viewing installed base details, working with involved parties, getting GPS coordinates for
locations, and creating and viewing tickets for installed bases.
On the Overview tab, view the installed base details such as involved parties and location.
The Involved Party section in the Overview tab displays the name of the customer associated with the installed
base.
You can add an installed base to a specific item from here. You can also add an involved party from the items
tab.
Note
You can have only one involved party associated with one role.
● Customer
● Owner
● Service Technician
● Service Technician team
● Bill-To
● Ship-To
● Payer
Using the Involved Parties tab you can maintain roles and party. SAP provides some standard roles, but you can
create custom roles and custom parties. Maintain it in a party determination schema as an administrative task.
As an administrator, configure involved parties for installed base using the fine-tuning activity.
Using the Involved Parties for Registered Product, Installed Base and Installation Points fine-tuning activity, you
can decide the party roles that you want to use in your application. However, you cannot deactivate the party
roles that are set as mandatory by default.
Note
The party roles that you add using this fine-tuning activity are also applied to registered products and
installation points.
Navigate to Business Configuration Implementation Projects Your Project Open Activity List Fine-
Tune Involved Parties for Registered Product, Installed Base and Installation Points .
On the Involved Parties for Registered Product, Installed Base and Installation Points page, click Add Row, and
select the party role that you want to add..
Geo location data of an installed base is inherited from the associated customer.
When you create an installed base and add a customer, the installed base inherits the customer address along
with the latitude and longitude information. The address is then displayed as a hyperlink. Clicking the address
link displays the location in a map.
In the Tickets tab, view a list of all tickets created for an installed base and its items.
You can also create a new ticket for an installed base item (in Active status only). All associated installed base
information is carried over to the new ticket.
Youcan also create a new ticket for an installed base and maintain competitor products for it. Select an item
and choose New Ticket to create a ticket. The information about item, customer, service technician, and
service technician team get copied over to the ticket.
Note
By default, the location of an item is the location of the installed base. However, you can change this.
Use the Competitor Products tab to add and maintain a list of competitor products for an installed base and
keep track of all the competitor products.
Maintaining this information helps in sales-related decisions and in gathering various insights for use in
analytics. Click the Add buttonto get a list of all competitor products maintained in the system. You can select
the appropriate product and maintain a list on this screen for the selected installed base.
A contract is a legally binding service agreement between parties stating their respective obligations and
responsibilities.
When you create a contract, you can add installed bases as covered objects in the contract. On the Installed
Base user interface, you can see all the contracts associated with an installed base.
A contract provides all the required information, such as subject matter of contract, installed bases (or covered
objects), signature date and validity period, in one place.
The Installed Base tab on Accounts lists all the installed bases where an account is added in any role (including
Z parties).
You can also view the list of installed bases where individual customers are added in any role.
In the Installed Base worklist, choose Export to Microsoft Excel ® from the action menu to export entries of
installed bases based on the query you choose.
Context
To create workflow rules, you must have access to the Workflow work center.
Procedure
○ Employee Responsible
○ Contact Person of Customer
○ Owner
○ Service Technician
6. Review and confirm the rule.
Related Information
An installed base item is an installation point of a specific category. The Category field differentiates types of
items.
When you create an installed base and add items to it, the customer for that installed base gets copied over to
the items. However, if you change the customer for that installed base, the customer for the related items will
not get updated automatically. The items will still display the previous customer information. So if you want the
You can choose if you want to update the customer information for all the items. Sometimes, the customer
information for an installed base and that for the items is maintained separately. In that case, you can keep that
information as is.
● Registered Product - a unique instance of a product that generally has a serial ID. You can maintain a
warranty for a registered product. One registered product can be part of only one installed base at a time.
● Product - an instance of a product.
● Text - a flexible category which can represent, for example, a location or a grouping.
You can add a hierarchy of sub items under each of the displayed top level/line items. From the Add Item menu
button, you can choose the catogory of items that you want to add.
Actions
Activate
After you create a new item, it acquires the In Preparation status by default. To enable ticket creation and other
service-related activities, you have to select the item and choose Activate.
Block
In instances of an issue associated with an item, you might want to set a temporary pause to stop any work
done on it—use Block to achieve this.
Obsolete
You can delete an item only when it is in In Preparation status. Deleting an item deletes the instance of that item
that was created in the system. When you remove an item from the hierarchy, it gets delinked from that
installed base. However, it does not get removed from the system. So the standalone item continues to exist in
the system. A search in the Installation Point tab displays that item.
Note
We suggest removing items with Product and Text categories as these are not useful as standalone items,
unless they are part of an installed base. However, a Registered Product can exist as a standalone item as it
has a lot of features associated with it.
New Ticket
Note
By default, the location of an item is the location of the installed base, but you can change this.
Using the Move and Remove actions can update multiple records as the actions affect the selected item and its
sub items. Therefore, updating more than 50 items using the actions from the UI can affect performance.
Tip
The administrator should trigger these actions via Migration Workbench or Mass Data Maintenance in
Business Configuration.
Item Details
This section displays details such as location, involved parties, and warranty parameters, of the selected line
item.
● For an item with category Product, you can edit the quantity.
● For an item with category Registered Product, you can edit the name field.
● Edit options for an item with category Text is unavailable.
You can edit Location information for products, registered products, and text item categories.
In the Involved Parties section, you can add an additional involved party to any item category.
The Warranty section displays associated warranty information for installed base items for registered product
category only. You can edit this information here as well.
All the items belonging to the selected installed base are displayed. You can search using the basic search or
the advanced search to locate an item.
Move Active or In Preparation installed base items within the same or another installed base.
Note
The option is disabled based on an item status. For example, you cannot move items that are in obsolete/
blocked status.
You can move an item directly under the root of the target installed base or under any other item in the target
installed base. If the selected item has further items under it, the item is moved with its entire hierarchy to the
new installed base.
You can also move an item by using Add Item Existing Registered Products in the Items tab. Selecting a
registered product that is already assigned to another installed base moves the registered product to the
current installed base.
Select an installed base item in the hierarchical list and click the Activate Items actions to mass activate the
selected item and the items under it.
The items get activated irrespective of their statuses. The activation is carried out asynchronously in the
background. To view the changes, close the Installed Base screen and open it again. Click the Item Logs tab to
view the status of mass activation.
You can also mass activate items using the Actions button. Select an installed base and then from the Actions
button, click Activate All Items.
Note
As an administrator, you can configure whether to automatically update the location of an item when the
customer of the item is updated in Installed Base.
To enable the auto-update, navigate to Business Configuration Implementation Projects Your Project
Edit Project Scope Scoping Questions Service Entitlement Management Registered Products and
Installed Base and check the scoping question: Automatically update location of Items when updating
customer of items for Installed Base?
● If the scoping question: Functional Location/Registered Product uses customer address as the default
location. Do you want to use the ship-to-party address instead? is also checked, when you choose Update
Use Depersonalize in Installed Base to remove personal data from obsolete installed bases.
When you depersonalize data in Installed Base, the information related to creation of the data is removed. The
change-related fields display the details of the user who initiated the depersonalization and the date on which it
was initiated. The following details are also deleted from the system:
● Involved parties
● Address
● Notes
● Created By
● Attachments
The installed base items are not depersonalized automatically. If you want to depersonalize an installed base
with items, you have to first depersonalize the items from their respective OWLs and then depersonalize the
installed base.
Note
From the UI, you cannot select more than 10 installed base records for depersonalization. However, if you
use the OData service to depersonalize, you can select any number of records at a time.
The Installed Base feature is available in offline mode with limited functionalities. Learn more about them in the
following section.
This topic presents an overview of supported features and limitations for installed base in offline mode.
Note
Not all the validations or determinations available online are available offline.
*Objects have
restrictions or
some tabs
missing
Involved Party Y Y
Items Y Y Y
Competitor Products
List Overview Y
Quick Create Y Y
Overview Y Y
Involved Parties Y Y Y
Actions Y Y
Competitor Products Y
Location Y Y
Involved Parties Y Y
Warranty Y
Block Y
Obsolete Y
Items Activate Y
Block Y
Obsolete Y
Delete Y
● When creating follow up ticket from Installed Base, determinations (such as location, service technician)
are not available.
● My Queries, based on team / territory is unavailable.
● Attachments are unavailable.
● Address determination is unavailable.
● Multilanguage support for Installed Base and Registered Product notes is not supported.
● Reported On Date in the Tickets tab of installed base is not available in offline mode.
● The Status Profile and User Status are not available in quick create and the Items tab of installed base in
offline mode.
● Export installed base list to Microsoft Excel is not supported in offline mode.
Items
● Hierarchical List for Installed Base items is unavailable. A flat list is displayed for the Items.
● Adding lower level items to an item is unavailable.
● Moving and removing items is unavailable.
● General Data dynamic fields based on category not supported.
● Add Existing Registered Product on installed base Items tab is not supported.
● Add/Delete of Involved Parties for installed base items is not supported offline.
● Creating follow up service tickets from installed base items is not supported.
This section provides you with solutions to some commonly asked questions.
There is no limit to the number of levels that can be created in an installed base hierarchy. However, too many
levels may become difficult to maintain. Decide on an optimal number based on your scenario.
Registered Products, Installed Base, and Installation Point tabs are displayed at various locations in the
solution. However, each display is used in a unique way and for a variety of purposes. the following table
describes the significance of each display:
Tab Significance
Installed Base Use this tab if you need a hierarchical representation and a
consolidated view of installed items. When you enable the
Installed Base feature, the Registered Products tab is auto
matically enabled as registered product can be an item in an
installed base.
Installation Points Use this tab to enable replication of SAP ERP functional loca
tions to SAP Cloud for Customer. You can also use this tab
as standalone without the SAP ERP integration. This view
displays installation points of functional location, product,
and text categories. When you enable the Installed Base fea
ture, the Installation Points tab gets enabled.
The resource scheduler feature in SAP Service Cloud helps in efficient planning and scheduling during the
service process.
The planner can see the available field service resources at any given time to work on a specific task. This
information is represented in a Gantt chart which offers various features to aid the planning process.
Once a service item is released for scheduling, a demand gets created. For each time-frame chosen in the
Gantt chart, the demands that require scheduling, are displayed. The technicians can easily see a list of tasks
assigned to them and record their progress. This is also supported on mobile so technicians can start working
on these assignments while on the move.
On the Resource Scheduler screen, when a team is chosen, the employees assigned to this team display in the
Gantt area.
● Demand List
Demands are displayed on the left of your screen. By default, this list displays service items pertaining to
the team of the logged on user.
● Gantt Chart
Team member names are listed along with their availability on the Gantt chart. Different time frame views
are available such as: Day/Week/Work Week/Month.
● Details Section
Details for the selected demand and assignments are displayed at the bottom of your screen.
Resource Scheduler offers integration with SAP Multiresource Scheduling (MRS) solution and SAP
Multiresource Scheduling, option for SAP S/4HANA solution as well.
Administrators can configure the Resource Scheduler features in SAP Service Cloud to help in efficient
planning and scheduling during the service process.
Recommendation
We recommend that you review all the scoping questions in the areas that are relevant and that you have
included in your scope. When you select a question, more information appears on the tabs in the details
section of the screen.
Scoping questions and fine-tuning activities that are straightforward may not be included in this list.
Administrators must scope Resource Scheduler so employees can schedule a service for a customer, and also
pick and assign a technician for the task. Use fine tuning to configure available features in Resource Scheduler.
1. Go to Business Configuration Implementation Projects Your Project Edit Project Scope Scoping
Service General Business Data Resource Scheduler , and check the box.
Note
2. In the Questions tab and select the appropriate option for using different features of resource scheduler.
3. Go to Business Configuration Implementation Projects Open Activity List Fine-Tune and search
for Demand Processing to configure available fine tuning options.
Administrators can set and define colors for displaying assignments in Resource Scheduler.
Go to Business Configuration Implementation Projects Open Activity List , and search for Demand
Processing. Choose Maintain Colors for Display of Assignments and maintain the necessary settings.
As an administrator, you can maintain colors for the respective status and time (past, present, or future).
Additionally, you can also define time types to start automatic time entry when setting the status.
Define external status codes for an assignment activity using fine tuning. The status reflects the progress of
the work in details.
Go to Business Configuration Implementation Projects Open Activity List , and search for Demand
Processing. Choose Maintain External Status Codes for Assignment Activity and maintain the necessary
settings.
Example
You can define a status as Start Travel. When you select this status, you can start the time recoding
automatically (also defined and associated in the fine tuning activity) with a time type Travel.
As an administrator, you can configure the attributes and colors for the assignment bar (fill and border colors)
in Resource Scheduler.
To configure, navigate to Business Configuration Implementation Projects Your Project Open Activity
List Fine-Tune Demand Processing Maintain Color Profile for Assignment Bar .
On the Maintain Color Profile for Assignment Bar page, in the Assignment Bar Color Profile section, select the
field for which you want to maintain the color profile. The available fields for the background and border bar
areas are as follows:
● Ticket Type
● Assignment External Status
● Ticket Priority
● Ticket Item Processing Code
In the Set Color section, you can maintain colors for past, present, and future assignments.
As there are no default color profiles available, if a color profile is not defined, no colors are visible on the
Resource Scheduler Gantt chart.
Points to Remember
Administrators can maintain mapping between service request type and color for display in the Resource
Scheduler Gantt chart.
Go to Business Configuration Implementation Projects Open Activity List , and search for Demand
Processing.
Choose Maintain Service Request Type Color Mapping. Then choose Add Row and select the Service Request
Type from the dropdown and select a color to associate with the service type. Save your selection.
Note
Multiple ticket types can have the same color to group similar jobs.
Administrators can maintain slots for appointment offering via fine tuning.
Go to Business Configuration Implementation Projects Open Activity List , and search for Demand
Processing. Choose Maintain Slots for Appointment Offering and maintain the Appointment Slot Code,
Description, and time for each slot.
Depending on how you maintain the appointment slots here, the service agent/technician can select
appointment slots when creating a service appointment for their customer.
You can maintain a full day time slot with an assigned duration of 8:00 to 18:00 hours.
As an administrator, you can maintain color for regular working hours, on duty, and overtime hours.
Additionally, you can also configure the behavior for On Duty and Overtime hours for the initial drag and drop of
a demand on the Gantt chart. You can also maintain color codes for these working hours.
Color coding these new working hour types helps identify each type on the Gantt chart. You can drag and drop
demands to these additional work hour slots as well.
The default value is Available which allows the user to drag and drop a demand on the hours shown as Regular,
Overtime, and On Duty. Unavailable means that the user cannot drag and drop a demand to these hours.
Note
After the initial drag and drop, you have the flexibility to move assignments over on to these hours.
Go to Business Configuration Implementation Projects Open Activity List , and search for Demand
Processing. Choose Maintain Working Hours Type and maintain the necessary settings.
In the Maintain Fields for Assignment Bar activity, the administrator can maintain a list of fields that you want
displayed in the Assignment Bar of the Resource Scheduler Gantt chart.
In addition to selecting the list of fields to display in the Assignment bar, you can also define the sequence of
these fields via fine tuning activity.
Define and maintain the order in which attributes are displayed in the additional column via fine tuning. The list
displays in the same order in the Assignment bar of the Gantt chart.
Go to Business Configuration Implementation Projects Open Activity List Fine Tune , and search for
Demand Processing. Choose Maintain Fields for Assignment Bar.
In the Sort Sequence column, maintain values that correspond to the order of display in the assignment bar in
Gantt chart.
Note
This configuration does not affect the Group By Day mode. When you Group by Day, Start time, Customer,
and City values display in the Assignment bar.
The administrator can create workflow rules for assignments, such as sending e-mail notification to the
customer or technician when an assignment is created or assignment status is updated.
Note
The administrator has to create the workflow rules and e-mail templates.
As an administrator, you can manipulate the path of a status flow (from open to begin travel, begin work,
complete work, or canceled) via code list restrictions. Create a new code list restriction and maintain the status
values you want displayed for assignments.
Go to Administrator General Settings Code List Restrictions New , and maintain the desired status
values. You would be able to see the choice of options in the Status drop down list in assignment.
Administrator can enable the Grouping of Assignments feature in the system to use it. Enabling this feature
would let you use the Group by Day and Group by Demand features in the solution.
This feature enables you to group multiple assignments for better visualization, and also work on the group as
a whole, except when you move an assignment manually. You can group assignments for each technician that
To use the Group Assignments feature, select the related question by navigating to: Scoping General
Business Data Resource Scheduler . In the Questions tab, select: Do you want to enable Grouping for C4C
Resource Scheduler?
This topic explains the process of how the customer can prevent technicians from working on unreleased
assignments.
Currently, the resource planner creates an assignment based on a work ticket with defined parameters for the
service duration and time frame. The planner then assigns the demand to a service technician and saves the
assignment. By default, the service technician can start working on these assignments. However, if the planner
wants to restrict the service technicians from working on unreleased assignments, then you must follow these
steps:
1. Navigate to Resource Scheduler Assignment and open an assignment in Open/In Process status.
2. Go to Adapt Edit Master Layout and hover over the Status field to view options.
3. Next, click Change Properties Rule hyperlink.
4. Click the Create New Rule icon and create a new rule (see below), and then choose Apply.
The Status field displays as read-only for all unreleased assignments, and is enabled and editable for all
released assignments.
As an administrator, if you have chosen to restrict the service technicians from working on unreleased
assignments, you can release an assignment automatically for it to become available to the service technician.
To release an assignment automatically, define an MDRO run. Based on the time defined in the run, all
assignments within the defined time slot gets released automatically.
Go to Administrator Service and Social Configure Assignment Release Run , and create NEW MASS
DATA RUN OBJECT TEMPLATE RUN. Then create a new MDRO run and set the parameters.
The system creates assignments everyday until a demand is completely fulfilled (based on certain rules), which
is helpful for planning demands of long duration. The dispatcher does not have to create assignments
manually.
Administrators can enable the complete fulfillment feature via scoping. Go to Business Configuration
General Business Data Resource Scheduler Questions , and select the question: Do you want the system
to create assignments automatically till a demand is fulfilled?
Administrators can maintain a threshold value based on the non-working hours and all-day events taken into
account when creating assignments as per complete fulfillment logic.
In scoping, if you have chosen to create assignments automatically, until a demand is fulfilled, you can maintain
a threshold value based on the Non working hours or All-day events that are taken into account when the
system creates assignments on multiple days, until a demand is completely fulfilled.
The default threshold value is 72 hours, which means the system would not create assignments during Non
working hours or All day events for up to 72 hours, and would continue to create assignments during the hours
following that. If Non working hours or All day events are found for more than 72 hours at a stretch,
assignments are created up to the start of this period and remaining hours (if any) are sent back to the demand
list.
Go to Business Configuration Implementation Projects Open Activity List , and search for Demand
Processing. Choose Maintain Threshold for Complete Fulfillment, then define the threshold hours and save.
This feature places an assignment to the nearest thirty-minute time slot when moving or resizing an
assignment, hence making the move easy for the user.
Administrators can enable the Time Snapping feature via scoping. Go to Business Configuration
Implementation Projects Edit Project Scope General Business Data Resource Scheduler , and enable the
question: Do you want the system to place an assignment (snap) to the nearest 30 minutes’ slot when moving
assignment on the Gantt chart?
If you do not want the hours from a canceled assignment to be sent back to the demand list, then you must
enable this feature via scoping.
Go to Business Configuration Implementation Projects Edit Project Scope General Business Data
Resource Scheduler , and enable the question: When a technician cancels an assignment, should the
planned duration not be sent back to the demand list?
You can integrate SAP Multiresource Scheduling with Resource Scheduler for scheduling demands. The
following topics walk you through the integration steps.
The administrator can enable MRS integration via business configuration in the SAP Cloud for Customer
system.
Context
Perform business configuration to enable MRS integration in the SAP Cloud for Customer system. Launch the
solution in Silverlight and go to Business Configuration Implementation Projects Edit Project Scope
General Business Data Resource Scheduler .
If you have enabled SAP Multiresource Scheduling integration for SAP Cloud for Customer, do not use the
native Resource Scheduler feature in SAP Cloud for Customer.
Procedure
Related Information
For SAP Cloud for Customer and MRS integration content, see the Application Help document set on the SAP
Help portal: http://help.sap.com/mrs.
● Configuration Guide Basic Configuration for SAP Multiresource Scheduling Configuration of SAP
Cloud for Customer Integration
● Configuration Guide Specific Configuration for SAP Multiresource Scheduling Setting up
Appointment Booking Appointment Booking
● Master Guide and Upgrade Information Setting Up Your System Landscape Setting Up a System
Landscape with SAP Cloud for Customer
As the administrator, perform fine tuning activities for Define Document Types, Ticket Status Schema, Involved
Parties, and Item Processing Codes.
Context
Procedure
1. Go to Open Activity List Fine Tune , and search for Tickets for Customer Support. Click the activity to
open and view the various steps mentioned to set up your tickets for service request functionality.
2. Open Document Types to display the types of header you can set for the service tickets. Here you can set
the different document types and associate it with the status schema. You can maintain custom status
schema and link it to the document type here.
3. To define document types, go to Ticket Status Schema. Define statuses and map it to a life cycle status.
Here you can define the header ticket status.
Example
For item processing type, the scheduling relevant flag is not enabled. Items that unassociated with the Service
tab will not let you enable it in the items section of a service ticket.
The administrator has to create a communication system in SAP Cloud for Customer to enable interaction with
MRS.
Context
Procedure
1. Go to Administrator Communication Systems under the Integration section, and create an entity. In
the communication systems screen, enable the SAP Business Suite flag for the MRS system ID and provide
PI or HCI as the host name, as you would be accessing either of these systems.
2. Next, define the Business System ID,Logical System ID, and the Preferred Application Protocol, required for
communication between SAP Cloud for Customer and the HCI or PI systems. Save your entries.
3. Next, create the communication arrangement.
The administrator can create communication arrangements for demand replication to, and employee
replication from an external system. The external system here is MRS.
1. Now, you have to create communication arrangement for this communication system. Navigate to
Administrator Communication Arrangements . Since MRS integration is scoped, the Demand
Replication to External System communication scenario becomes available here.
2. When you click this communication scenario, you would view a set of inbound and outbound services as
follows:
Outbound Communications:Replicate Demand to External System Replicate Demand Assignment Status to External System Inbound Communication:Replicate
Note
Associate the service URLs on these communications to the HCI or PI system you are using.
3. Click View All. In the Technical Data tab, you can maintain various aspects of the communication such as
authentication method, and several other settings.
Note
You would set this communication arrangement for the entities in MRS you are interacting with.
Next, set up another communication arrangement for Employee Replication from External System. In this
communication arrangement, the employees from MRS are replicated to SAP Cloud for Customer.
Note
Follow these steps to enable the employee replication inbound into SAP Cloud for Customer.
Go to Administrator Org Structures , and set up and define your MRS organization structures and
activate them. Enable the Service Organization and Customer Service flags under the Functions tab, to display
the tickets for the service technician team.
The administrator can set up the organization structure, perform ID mapping to the corresponding IDs in MRS
for organization units, employees, and employee setup.
This is the next step after setting up the Org. structure. Perform ID mapping to the corresponding IDs in MRS.
For Employees
For replicating employees from the business system, choose ERP Employees from the Mapping Of dropdown
list, and choose Go to display the list of employees you have replicated from MRS. Mapping of external ID to
SAP Cloud for Customer occurs automatically. This information is displayed in the Origin column in the ID
Mapping for Integration screen.
Employee Setup
Employee replication from MRS to SAP Cloud for Customer is handled via iDocs. To set up employee, perform
the steps mentioned in the http://scn.sap.com/docs/DOC-57644 Initial Load and https://websmp205.sap-
ag.de/%7Esapidb/012002523100007331492015E/C4C_QSG_1505.pdf Quick Setup documents.
As an administrator, you can transfer employees from MRS to SAP Cloud for Customer.
Context
As a final prerequisite step, perform transfer of employees from MRS to SAP Cloud for Customer.
Procedure
4. Navigate to Employees People tab, to view the replicated employee. When you click to display
employee details, you can view the External ID, and the External System the employee got replicated from.
You can integrate SAP Multiresource Scheduling for SAP S/4HANA with Resource Scheduler for scheduling
demands. The following topics walk you through the integration steps.
Integrate SAP Cloud for Customer with SAP Multiresource Scheduling, option for SAP S/4HANA to select the
appointment offering functionality.
Scoping
The Appointment Offering feature is available within SAP Cloud for Customer, and also from SAP Multiresource
Scheduling, option for SAP S/4HANA. For using the feature from SAP Multiresource Scheduling, you must first
select the appropriate scoping question in business configuration.
Launch the solution in Silverlight and navigate to Business Configuration Implementation Projects Edit
Project Scope General Business Data Resource Scheduler Questions , and in the MRS Integration
group, select the question: Do you want to integrate with MRS on SAP S/4HANA?
The appointment offering feature in SAP Multiresource Scheduling behaves a bit differently. In MRS, from the
appointment offering search dialog screen, the available time slots display. When a slot is selected in the SAP
Cloud for Customer solution, it gets blocked in MRS for the corresponding service technician team. However,
an actual assignment is not scheduled until the MRS optimizer is executed.
This section contains links to relevant SAP Multiresource Scheduling, options for SAP S/4HANA content.
For SAP Cloud for Customer and SAP Multiresource Scheduling, option for SAP S/4HANA integration content,
see the Product Assistance document set on the SAP Help portal: https://help.sap.com/mrs_s4hana .
Then go to the
● Configuration Guide Basic Configuration Settings Setting up the Integration with SAP Cloud for
Customer
● Configuration Guide Specific Configuration Settings Setting up Appointment Booking Setting up
Appointment Booking for Work Tickets
8.4 Create Work Ticket and Add Service Items for Resource
Scheduling
Note
In the ticket, maintain the service team and requested time range.
This action sends the demand to the resource scheduler tab and sets the item to In Scheduling. Once the
demand gets scheduled, the status changes to Ready and gets linked to the assignment.
4. The planned duration for this demand is calculated based on planned quantity. If this UoM is not a time
based unit, then use the conversion rules for the product.
In the ticket, maintain the service technician team and requested time range.
Resource Scheduler is a built-in scheduling tool for creating assignments based on demands from work tickets
with real-time integration with technician calendars.
The Resource Scheduler allows the resource managers and service managers to view the availability of
technicians in the team and assign work to them based on their skills. When you scope resource scheduler in
business configuration, you can create and send service ticket items as demands to the resource scheduler.
1. In the Resource Scheduling tab, on the left half of the screen, you can define responsibility for your team.
You can set one query as default, so that when you access the resource scheduler tab, the data is fetched
and displayed at once. The left side of the screen displays all the demands for your team, while the right
section displays the names of all team members and their availability.
2. Using drag and drop, you can assign a task or demand to a technician in the Gantt chart that can display
multiple technicians. A detail section at the bottom of the screen displays details of demands and
assignments. Once you save your plan, the assignments are created.
3. The resource scheduler displays all status updates made to the assignments. After an assignment is
completed, an employee can confirm the same in the ticket section. The assignments can also be seen in
the corresponding employee calendar.
4. You can rearrange or shorten assignments. Lengthen or shorten the time by grabbing the sides of the
assignment display in the employee calendar. The unaccounted balance time displays in the Demands list
allowing you to reassign them. Once you save your changes, the updated assignment displays in the
Assignments tab.
Note
The Assignments tab has a map and list view and displays all your assignments.
Choosing a team begins the search for unscheduled demands. You can define queries to structure the
resources and find the correct data. Using drag-and-drop, you can assign the demand to a resource for a
specific time frame. After the demand is complete, it disappears from the demands list.
When you choose a team, the employees assigned to this team, who have working times assigned, are
displayed in the Gantt chart. The Gantt chart shows an overview of assigned demands with color codes, via
status and time. You can assign every system status to multiple free definable user status, which can be
When you click a demand in the demand list, the demand details display immediately in the details area below
the Gantt chart. All existing assignments display as well.
Note
You can define searches to filter demands, or show demands from a different time period. The unplanned
demands valid for the used time frame of the Gantt area are displayed.
To do so:
1. Choose multiple demands in the demands list and double click on a cell in the Gantt chart.
2. Assignments are created for the selected demands in an order and display in the Gantt chart.
3. If a demand does not fit within the available work hours for that day, the entire demand is returned back to
the demand list.
Note
Behavior is different in case complete fulfillment is scoped in. For more details, see topic Complete
Fulfillment in Resource SchedulerComplete Fulfillment in Resource Scheduler [page 253].
This section explains how demands appear in the demand list based on queries and time frame.
Demands
On the Gantt chart, using drag and drop, assign a demand to a resource for a specific time period. On the
resource scheduler screen, clicking on a demand, in the demand list, displays its details in the details area
below the Gantt chart.
On the resource scheduler screen, when assigning demands via drag and drop, longer demands, which do not
fit into the available working hours for that day end at the end of the working hour. The remaining time displays
in the demand list. The scheduler can then assign the remaining time of the assignment to the same or
different resource. To assign the long running demands at once, you can use the complete fulfillment feature.
This section explains how to work with the demands list in resource scheduler. Every ticket item relevant for
service and dispatching indicates a required task that needs performing. Once you release the item for
scheduling, it appears in the demands list.
Search Query
Use search queries to find demands and resources. You can define searches to show planned demands or
demands in a different time period. Based on your query, all relevant demands for your team would be
displayed in the Gantt Chart. You can search with a customer name as well.
● All Demands:
Displays all demands irrespective of their status.
● My Team’s Demands:
Displays all demands that require scheduling.
● To-be-Scheduled Demands:
Displays all to-be-scheduled and partially scheduled demands. The default list is the same as My Team’s
Demands. Additionally, using advanced search, you can also display the to-be-scheduled demands for
other teams as well.
Note
For all the search queries, if user changes the time window in the Gantt chart, the demand list gets
refreshed based on the new time window.
Advanced Search
In addition to the standard queries, there are many other fields such as Ticket Type/Ticket Priority/City and
others, which can be used to filter the data further. A few fields such as Service Team/Status are shown based
on the selected search query.
If the user searches by Requested Start and Requested End dates, the list of demands that fall within the given
dates are displayed, independent of the current time window. In this case, changing the time window in the
Gantt chart does not refresh the demands list.
Note
Serial ID in the advanced search refers to the main registered product in a ticket.
Additional fields from advanced search are also available in the demand list (via personalization) and demand
details sections.
In the Resource Scheduler tab, you can enable a set of fields relevant for demand list using personalization.
Navigate to More button and select Settings Personalize Add Fields . Choose the fields you want to
enable or disable, and select OK to complete personalization.
The Gantt chart provides an overview of assigned demands in preset color codes for status and time.
Working time is maintained at employee or service provider master data level. These times show up in the
Resource Scheduler to ensure that technicians are assigned tasks within their working time only.
Members of this team without a working time assigned are not shown as plannable resource for the dispatcher.
Hence they cannot be assigned any service tasks.
To show the availability of the resources, working hours are maintained for the employees. Non-working hours
are indicated as blocked (grayed out) in the Gantt chart. In addition, the duration for any regular appointment
is also shown as blocked in the Gantt chart.
Besides regular working hours, you can additionally maintain On Duty and Overtime hours for an employee.
Color coding these working hour types helps identify each type on the Gantt chart. You can drag and drop
demands to these additional work hour slots as well.
Working time is a recurring pattern repeated every week that contains the time zone and working day calendar.
Members of a team without an assigned working time are not shown as resources who can be scheduled in the
resource scheduler. Besides regular working hours, you can also maintain On Duty and Overtime hours for an
employee. Color coding these additional working hour types helps identify each type on the Gantt chart.
As an administrator, you can maintain color for regular working hours, on duty, and overtime hours.
Additionally, you can also configure the behavior for On Duty and Overtime hours for the initial drag and drop of
a demand on the Gantt chart. You can also maintain color codes for these working hours.
Color coding these new working hour types helps identify each type on the Gantt chart. You can drag and drop
demands to these additional work hour slots as well.
The default value is Available which allows the user to drag and drop a demand on the hours shown as Regular,
Overtime, and On Duty. Unavailable means that the user cannot drag and drop a demand to these hours.
Note
After the initial drag and drop, you have the flexibility to move assignments over on to these hours.
Go to Business Configuration Implementation Projects Open Activity List , and search for Demand
Processing. Choose Maintain Working Hours Type and maintain the necessary settings.
Different time frame views are available on the Gantt chart to show relevant data in day/week/work week/
month view. Planning is done in the day view.
Note
Clicking on a day in the Gantt chart displays the day view of the chosen day. However, the month view is read-
only view. You can define the default start-up view in user specific settings.
You can enable the assignment tool tip in the Resource Scheduler tab. Navigate to More button and select the
Settings Show Tool-tip for Assignment . After enabling the assignment tool tip, hover over any
assignment in the Gantt chart to view its details.
Assignments in the Gantt chart can be shown in different colors based on the status. It is also possible to set a
border color for the assignment based on ticket type. This visualization helps the dispatcher in judging the
status and type of assignment at a glance.
Administrators can set and define colors for displaying assignments in Resource Scheduler.
Go to Business Configuration Implementation Projects Open Activity List , and search for Demand
Processing. Choose Maintain Colors for Display of Assignments and maintain the necessary settings.
Choose Add Row and maintain a color code, description, and color for your assignment display in the resource
scheduler. Choose Save to save and enable your settings.
In the Edit Assignment dialog box, the End Date Time field is visible and can be edited.
Edit Assignments:
From the Gantt chart, when you select an assignment and navigate to More Edit Assignment , in the
displayed dialog box the end time field is editable. On change of start date and time, the system recalculates
the assignment end date and time. On change of end time, the system recalculates the assignment duration
(resize).
The end date is read-only and is set based on the start date.
Note
If the start date is set to a date, which falls outside the temporary team assignment for an employee, a
message displays.
When editing an assignment on the Gantt chart, the system performs employee organizational unit, and
temporary assignment validity checks in the background and displays warning messages. If the start date is set
to a date, which falls beyond the temporary team assignment for an employee, a message displays.
When an employee is temporarily assigned to another team, the employee shows up in the employee list Gantt
chart, for the duration of the temporary team assignment.
The employee does not appear in the temporary assigned list beyond the assignment validity period.
For the duration of the temporary assignment, the employee working hours in the primary team displays as
unavailable, and is grayed out.
For auto dispatch and appointment offering options, the employee is considered unavailable in the primary
team, for the duration of the temporary assignment.
Once grouping of assignments is enabled in the system, you can group multiple assignments for better
visualization, and also work on the group as a whole. Group assignments for each technician that have been
scheduled for the same day, and have the same customer, ticket type, and location.
When you select Group Mode, all relevant demands get clubbed together and appear as one on the Gantt chart.
Clicking on Normal Mode takes you back to displaying the demands separately.
On the Gantt chart, the group displays as a static background color. On selecting a group, the list of all
assignments in that group gets displayed in the details area at the bottom of the screen. After grouping, the
planner can move the group to another technician or change the starting time. The planner has better
visualization, as at a glance, the group indicates that there is work to be done by a technician at the same
customer site. With this functionality, further planning becomes more efficient.
Moving a group is based on certain conditions such as: status of assignments in the group, employee working
hours etc.
You can move assignments around to different resources or time periods as long as their status is Open.
Administrator can enable the Grouping of Assignments feature in the system to use it. Enabling this feature
would let you use the Group by Day and Group by Demand features in the solution.
This feature enables you to group multiple assignments for better visualization, and also work on the group as
a whole, except when you move an assignment manually. You can group assignments for each technician that
has been scheduled for the same day, and have the same customer, ticket type, and location. The same
parameters would apply for Group by Demand.
To use the Group Assignments feature, select the related question by navigating to: Scoping General
Business Data Resource Scheduler . In the Questions tab, select: Do you want to enable Grouping for C4C
Resource Scheduler?
The administrator can choose the list of fields to be displayed in the Assignment Bar on the Gantt chart.
These fields are available by default: Start Time, Item Description, and Ticket ID. However, in fine tuning, you
can choose to display Customer Name and City fields as well.
Note
Navigate to Business Configuration Implementation Projects Activity List Fine Tune , and search for
Demand Processing. In the Maintain Fields for Assignments Bar activity, select the fields you’d like to display in
the assignment bar.
In the Resource Scheduler Gantt Chart, the text in assignment bar is displayed in white color. Keep this in
mind when you define the background color for the assignment bar.
This feature places an assignment to the nearest thirty-minute time slot when moving or resizing an
assignment, hence making the move easy for the user.
Administrators can enable the Time Snapping feature via scoping. Go to Business Configuration
Implementation Projects Edit Project Scope General Business Data Resource Scheduler , and enable the
question: Do you want the system to place an assignment (snap) to the nearest 30 minutes’ slot when moving
assignment on the Gantt chart?
Weekday labels (such as Mon, Tue), are displayed in the Gantt chart in all the views: Day, Week, Work Week, and
Month. The date format for the date (displayed next to the weekday) takes the display format from the user
settings.
Note
In Resource Scheduler, public holidays are not supported. (There is no visualization for this or any other
criteria/rules).
Complete Fulfillment allows the system to create assignments everyday until a demand is completely fulfilled,
based on certain defined rules. This helps plan demands with long duration. The dispatcher does not have to
create the assignments manually.
Complete Fulfillment
To use this feature, your administrator would have to enable this via business configuration scoping and if
required, maintain the threshold value in the fine tuning activity.
Sometimes assignments cannot be created due to certain reasons. In such scenarios, the system plans as per
validity/availability. The remaining hours are sent back to the demand list, and a message displays stating the
same.
These are some examples why assignments may not get created:
● If non-working hours or all-day events exist at a stretch for more than the defined threshold value.
● If temporary team assignment ends.
● If the employee validity expires.
Note
Complete fulfillment follows all criteria of manual scheduling. For example, if there are existing
assignments/appointments, the new assignments created via fulfillment will overlap with them.
Administrators can maintain a threshold value based on the non-working hours and all-day events taken into
account when creating assignments as per complete fulfillment logic.
In scoping, if you have chosen to create assignments automatically, until a demand is fulfilled, you can maintain
a threshold value based on the Non working hours or All-day events that are taken into account when the
system creates assignments on multiple days, until a demand is completely fulfilled.
The default threshold value is 72 hours, which means the system would not create assignments during Non
working hours or All day events for up to 72 hours, and would continue to create assignments during the hours
following that. If Non working hours or All day events are found for more than 72 hours at a stretch,
assignments are created up to the start of this period and remaining hours (if any) are sent back to the demand
list.
Go to Business Configuration Implementation Projects Open Activity List , and search for Demand
Processing. Choose Maintain Threshold for Complete Fulfillment, then define the threshold hours and save.
All assignments are displayed in the Assignment tab, where the technician can view and work on jobs assigned
for the day.
Assignments can be viewed ordered by time and can be displayed on a map as well. The technician can directly
jump to the ticket, the assignment, or the master data and enter their specific data required to process jobs.
The service technicians can easily see their assignments in the employee calendar and can work on tasks
assigned to them for the day. They can update the assignment status as they progress with their task.
Service technicians can update the assignment status as they progress with their task.
Context
A service item with work progress status as In Scheduling creates a demand with To be Scheduled status. A
demand is set to Scheduled or Partially Scheduled when an assignment is created.
Procedure
Results
The assignment is now available in the workflow, which means that emails can be triggered by the release
status.
The administrator can create workflow rules for assignments, such as sending e-mail notification to the
customer or technician when an assignment is created or assignment status is updated.
Note
The administrator has to create the workflow rules and e-mail templates.
You can add the My Assignments tile to your home page for quick access. This will help you navigate to your
assignment list directly.
A key user can add the tile for a service technician. This tile loads the service technician's Assignment work
center and loads the My Assignments list by default.
Clicking on the address of an assignment on the Assignment List or Overview tab navigates to the address on
the map. This feature is helpful when using mobile devices (for driving directions) to get to the assignment
location.
When a technician cancels an assignment in the Assignment tab, the initial planned duration of the assignment
is sent back to the demand list as unplanned hours.
If you do not want the hours from a canceled assignment to be sent back to the demand list, then you must
enable this feature via scoping.
Once this option is enabled, after a canceled assignment, the hours are not sent back to the demand list. So
these hours are not available for rescheduling.
Note
Define code list restrictions to make Canceled as the final status for an assignment. If code list restriction is
not set, then the technician is able to change the status back from canceled to open. As a result, duplicate
hours are added to the planner list.
If you do not want the hours from a canceled assignment to be sent back to the demand list, then you must
enable this feature via scoping.
Go to Business Configuration Implementation Projects Edit Project Scope General Business Data
Resource Scheduler , and enable the question: When a technician cancels an assignment, should the
planned duration not be sent back to the demand list?
Time types can be assigned to the assignment user (based on assignment status) via fine tuning.
If time types are assigned to user status, then it is used to start a new time entry when user status is set for an
assignment. The new time entry displays in the Time Entriestab, and its corresponding ticket.
Example
You can define a status as Start Travel. When you select this status, you can start the time recoding
automatically (also defined and associated in the fine tuning activity) with a time type Travel.
As an administrator, you can maintain colors for the respective status and time (past, present, or future).
Additionally, you can also define time types to start automatic time entry when setting the status.
Define external status codes for an assignment activity using fine tuning. The status reflects the progress of
the work in details.
Go to Business Configuration Implementation Projects Open Activity List , and search for Demand
Processing. Choose Maintain External Status Codes for Assignment Activity and maintain the necessary
settings.
Example
You can define a status as Start Travel. When you select this status, you can start the time recoding
automatically (also defined and associated in the fine tuning activity) with a time type Travel.
Use the Appointment Offering and Auto Dispatch features in Resource Scheduler to preselect time slots or
create automatic scheduling in the system,
This feature offers your customers the ability to preselect time slots for a service appointment.
The service agent can offer the customer the ability to choose their appointment time slot and date range.
However, you would need to enable this option first.
When you select the scheduling method for a repair item as Appointment, and choose Release for Scheduling,
the Appointment button gets enabled.
Note
Only items with In Scheduling work progress status are relevant for appointment booking. The Appointment
button, is otherwise disabled. So to change the status of a ticket item to In Scheduling, you would have to
execute an item based action.
On the Appointment Offering screen, you can select a date range and a time slot. Click the Get Appointment
button to get a list of available appointment offerings within your selected date range and time.
Next, select the time your customer requests and save the appointment time to ensure that the time slot is
booked.
Once you save, the item status displays as Ready, which means that the assignment for that item has been
created. You can view details of this item in the General Data tab, at the bottom of the screen. You would also
see that the system has assigned a technician for the appointment based on the requested time slot and date.
In the Assignments tab, you can view the appointment you scheduled. Here's a short video with more
information on the Appointment Offering feature.
Fixed Flag
As the name suggests, this feature restricts editing the time slot or technician based on the type of fixed flag
selection. You can choose this option when choosing an appointment.
The Fixed flag helps avoid any unintended changes to a set time slot. You can choose from these options:
● Fixed Time
Selecting this option would restrict the appointment time. So if the time slot is fixed to morning, then you
can move the appointment to a different hour within the morning time slot of the same day. However, you
cannot move the appointment to the evening or another day. In this case, you would still have the option of
changing the technician.
● Fixed Time and Technician
Selecting this option would restrict the appointment time and the technician. Hence in addition to the time
slot, you cannot change the technician.
Administrators can maintain slots for appointment offering via fine tuning.
Go to Business Configuration Implementation Projects Open Activity List , and search for Demand
Processing. Choose Maintain Slots for Appointment Offering and maintain the Appointment Slot Code,
Description, and time for each slot.
Depending on how you maintain the appointment slots here, the service agent/technician can select
appointment slots when creating a service appointment for their customer.
Example
You can maintain a full day time slot with an assigned duration of 8:00 to 18:00 hours.
Use the Auto Dispatch scheduling method to create automatic scheduling in the system.
After a ticket item has been released for scheduling, auto dispatch allows the system to create assignments in
the background without any user intervention.
The general criteria to create automatic assignments is based on the availability of technicians, and the
number of existing assignments in the system. The system searches for a technician who is available in the
required time frame with the least number of assignments. If multiple technicians match the criteria, then the
system randomly picks one.
You can use the native feature in SAP Service Cloud for Appointment Offering, or integrate with SAP
Multiresource Scheduling option for SAP S/4HANA for Appointment Offering. For manual scheduling, you can
integrate with SAP Multiresource Scheduling.
For more information (integrate with SAP Multiresource Scheduling option for SAP S/4HANA for Appointment
Offering) see Enable SAP Multiresource Scheduling, Option for SAP S/4HANA for Appointment Offering
Feature in Resource Scheduling [page 242]
For more information (to integrate with SAP Multiresource Scheduling) see Enable SAP Multiresource
Scheduling (MRS) Integration with Resource Scheduler [page 236]
This section provides you a quick overview of offline features available for Resource Scheduler.
This topic presents an overview of supported features and limitations for Resource Scheduler- Assignments in
offline mode.
Note
Scheduler
Assignments
Status Y Y
Ticket Y
Service Technician Y
Notes Y
Assignments
● Changing the status of an assignment in offline mode does not start automatic time entry.
● Code list restriction for Assignment External status code is not supported offline.
● Assignments are not supported in offline calendar.
This section provides you with solutions to some commonly asked questions.
1. Manual Scheduling:
Demands created using this method are scheduled manually. The planner can choose when and for whom
to create the assignments.
2. Appointment Offering:
The service agent can offer customers the ability to choose their appointment time slot and date range.
The system creates an assignment based on the chosen parameters.
3. Auto Dispatch:
The system automatically creates an assignment in the background, when you schedule using this
method.
After dropping a demand on the Gantt chart, you may want to update it. You can edit an assignment in two
ways:
Your ability to edit an assignment (move an assignment, or update its duration) depends on the Fixed flag. The
Edit Assignment action gives you the option to change the fixed flag and edit the assignment.
Note
You can edit an assignment only if it is in Open status. If you edit assignments that are created via
Appointment Offering, then they are treated as regular assignments from then on. this means, that the
restriction of the appointment offering slot will no longer apply.
If there is a need to restrict editing of an assignment, you can use the release flag for this purpose.
A configuration step can be performed. With the configuration in place, your technicians can only see an
assignment but not edit it unless the planner has released the assignment.
To release an assignment, select the relevant assignment in the resource scheduler Gantt chart and select Edit
Assignment option. Then choose the release action. You can also release an assignment automatically using
the MDRO run option.
The Fix flag limits shifting an assignment to a different time or time period. In some cases, it can be moved to
another resource.
Skills Management enables an organization to maintain the skills structure and skills requirements for various
entities.
You can evaluate skills during the scheduling process to identify the best person to work on a specific task. It
also helps in planning for the required trainings, keeping the work force up to date, and avoiding certificate
expirations (such as access authorizations).
Administrators can configure skills management using scoping and scoping questions.
Note
Scoping questions that are straightforward may not be included in this list.
Navigate to Business Configuration Implementation Projects Your Project Edit Project Scope Next
Scoping . In the Scoping Element list, expand General Business Data Skills Management , and then
select Skills Management.
Navigate to Business Configuration Implementation Projects Your Project Edit Project Scope Next
Scoping . In the Scoping Element list, expand Service Customer Care , and then select Service Request
Management. From Questions for Service Request Management, select Do you want to enable Skill Functionality
in Ticket?.
As an administrator, use the Data Workbench service to import, export, and update employee, account,
individual customer, and installed base skills data.
For more information about data workbench services related to Skills and Data Workbench in general, see the
Data Workbench user guide.
Know more about creating and assigning skills, determining skills in tickets, verifying skills in resource
scheduler, using the data workbench service, and creating reports to manage skills.
Context
Status change at a skill group level reflects in all the skills and skill groups under it. To create a skill group or a
skill, follow these steps:
Procedure
1. On the Skills page, click New and select one of the following:
Option Description
Assign skills to customers, installed base, employees, registered products, and products.
Procedure
If you want to make the skill mandatory, select the Mandatory checkbox.
4. Click Add.
Procedure
1. Navigate to the Installed Base tab, and select the installed base ID for which you want to add a skill.
2. On the details page, click the Skills tab.
3. Click Add and in the Add Skills window, enter the required details.
If you want to make the skill mandatory, select the Mandatory checkbox.
4. Click Add.
Procedure
To set the validity of the skill, select the relevant dates in the Valid From and Valid To fields.
4. Click Add.
Procedure
If you want to make the skill mandatory, select the Mandatory checkbox.
4. Click Add.
Procedure
If you want to make the skill mandatory, select the Mandatory checkbox.
In tickets, skills are determined from customers, registered products, products, and installed base. Skills can
be determined in tickets only in the online mode.
The Skills tab of Tickets displays the list of all skills that are determined or added at the tickets header level. If
any of the entities ( customers, registered products, products, or installed base) is updated in a ticket, skills are
redetermined. You can modify a skill by selecting or deselecting the Mandatory checkbox. You can also delete a
skill. If a skill is updated manually, it is not updated during redetermination.
If you want to add additional skills, you have to add them manually. To add skills manually to tickets, on the
Skills tab, click Add and in the Add Skills window, enter the required details.
When you add a new skill, skills are redetermined in the ticket.
Example
There is a ticket for a customer named BlueDrive, and French is maintained as a language skill for this
customer. The ticket also has a registered product associated to it. The Serial ID is SOLGRD 98907870. For
this registered product, the Processing Unit Repair skill is maintained. Therefore, based on the customer
and the registered product, these two skills (French and Processing Unit Repair) are determined for the
ticket.
The Skills tab at the ticket item level displays the list of skills for that item. You can modify a skill by selecting or
deselecting the Mandatory checkbox. You can also delete a skill.
If you want to add additional skills, you have to add them manually. To add skills manually to a ticket item, on
the Skills tab, click Add and in the Add Skills window, enter the required details.
Note
If you want to make the skill mandatory, select the Mandatory checkbox.
If an item is in Ready or equivalent status, you cannot update or determine the skill.
Navigate to Business Configuration Implementation Projects Your Project Edit Project Scope Next
Scoping . In the Scoping Element list, expand Service Customer Care , and then select Service Request
Management. From Questions for Service Request Management, select Do you want to enable Skill Functionality
in Ticket?.
When an item in a ticket is released for scheduling, the system uses the skills at the item level to suggest the
technicians. When you select a demand and select Check Skills, the technicians with all the mandatory skills
are highlighted in bold font and with an asterisk (*) mark.
You can also assign a demand to a technician different from what the system suggests.
To verify whether the correct technician is highlighted, select the technician and in the details section, click
Skills. You can also verify the skills on the Employees UI by selecting the employee and clicking the Skills tab.
Navigate to Business Configuration Implementation Projects Your Project Edit Project Scope Next
Scoping . In the Scoping Element list, expand Service Customer Care , and then select Service Request
On Resource Scheduler, select the required demands, and then select Check Skills. The technicians with all the
mandatory skills are highlighted in bold font and with an asterisk (*) mark.
The technicians with all the mandatory skills for the assignment are highlighted in bold font and with an
asterisk (*) mark. Checking skills for an assignment helps when an existing assignment has to be rescheduled.
In such a scenario, the user can know the resources that have the required skills to perform the task.
If the planner requires to move the assignment to another technician, the planner can use this information to
identify the required skills.
For example, to view updates in employee skills, go to the Changes tab of an employee.
Currently, the Changes tab of Tickets, Installed Base, Registered Products, and Products do not display the
updates for skills.
Use data sources and create reports in the Business Analytics work center to manage skills. For example, you
can create a report to get the list of employees whose validity of a skill expires in the next one month.
● Skills of Employees
● Installed Base and Skills
● Installation Point and Skills
● Skills
Related Information
This section provides you with solutions to some commonly asked questions.
For the appointment offering scheduling method, appointment slots are displayed for the available technicians
who have the mandatory skills.
For the auto-dispatch scheduling method, the system creates appointments for the first technician available
with the mandatory skills. If no resources are found that match the required skills, assignment is not created,
and a message is displayed.
Time entries help employees record and manage the time they spend performing their activities. A time report
is a collection of time entries, which can be defined for a date or date range and can be submitted for approval
to one or more approvers.
Employees can create time entries and import them into a time report. They can also record time for different
time types such as: work, travel, administration, vacation and so on; and for tickets or independent of a ticket.
This helps managers track productive time, which could be time spent on tickets as well as non productive time
such as: training, vacation and so on, by the employees.
To use the Time Recording feature, administrators would first have to enable this feature via scoping.
As an administrator, you must enable time recording, configure time types, and configure e-mail notifications
using workflow rules before users can work with time recording.
The administrator would have to scope Time Recording to log the time.
Go to Business Configuration Implementation Projects Your Project Edit Project Scope Scoping
Service General Business Data Employees Questions , and select to enable the question: Do you wish
to enable Time Recording feature?.
You can define the time types available for use in time reporting with the fine tuning activity: Time Types for
Time Recording. Your administrator would have to enable the fine tuning activity.
Go to Business Configuration Implementation Projects Open Activity List Fine Tune , and search for
Time Types for Time Recording activity. In the Time Types for Time Recording fine tune activity screen, choose
the Add button and add a time type code and a description for it.
Example
Use codes such as 01, 02, or 03, and descriptions can be based on relevant task types; such as: Billable Hours,
Non-Billable Hours, Travel, or Training.
You can create various page layouts based on different attributes for Time Entries and Time Reports. Your
administrator would have to set these attributes for you.
The administrator can set up time item rounding rules, when creating time items from time entries.
Log on to system using administrator credentials and navigate to Administrator Service and Social Time
Recording Define Rules for Time Item Rounding .
The administrator would have to enable the standard multistep approval process for time reports.
Go to Business Configuration Implementation Projects Your Project Edit Project Scope Questions
General Business Data Employees and Service Agents Employees and under the Enable Time Recording
section, select the question: Do You want to use a multi-step approval for time recording?
Your administrator has to enable additional approver option for a time report by maintaining this in the
approval process.
Go to Administrator Approval Processes and select the new work distribution rule: Approver of Time
Report in the Time Report approval process.
Your administrator can enable auto submit time report for approval using business configuration, so you can
auto submit for approval as soon as the time report is saved.
Select the scoping question to enable auto submitting a time report for approval.
Go to Edit Project Scope First Implementation Questions. Drill down to General Business Data
Employees and Service Agents Employees , and select the question: Do you want the system to
automatically submit a time report for approval?
The administrator can assign time types to assignment status to trigger time recording from assignment.
You can assign time types to different assignment statuses in the fine tuning activity. Navigate to Business
Configuration Implementation Projects Open Activity List Fine-Tune , and search for Demand
Processing. Maintain the external status codes for assignment here.
The administrator has to confirm a business configuration scoping question to enable auto determination of
Time Item Product based on time entries.
If you select the option, then the time item product is determined automatically. However, if you do not select
it, then select the product for time item manually from the list of displayed products.
Navigate to Edit Project Scope First Implementation Questions for Employees Enable Product
Determination for Time Recording , and select the question: Do you want to enable rule based product
determination for a ticket from Time Recording?
You can determine Time Item Product, based on different attributes of Time Entries (Time Type, Start Time,
End Time), and Ticket ( Service Org., Time Type).
You have the option of implementing a BAdI while creating time item from time entry to modify or copy
information using custom logic and implementation.
This is PDI enabled BAdI and can be implemented using SAP Cloud Applications Studio by adding an item to
the solution as follows:
4. Once the add item window displays, follow the steps mentioned in the screenshot below.
Note
5. Follow next steps and add values (mentioned below) to create the Enhancement Implementation.
The administrator can assign code list restrictions to time types and assign various time type values to
different roles.
Go to Administrator General Settings Code List Restrictions , and apply code list restrictions to time
types in the business object Time Entry.
The administrator has the ability to decide whether the rounding should happen at the time or service item
level. This will avoid rounding at the time item (child) and service item (parent) level at the same time.
To enable this feature, navigate to Edit Project Scope: First Implementation General Business Data
Employees and Service Agents Employees , and in the Questions tab select the option: Do you want to round
off the quantity at Service Item Level?
It is possible to integrate with SAP ERP for CATS time entry in the system.
You can release approved time entries to CATS in SAP ERP. For this integration, you need to maintain mapping
between time types of the time entries in our system, and activity types in SAP ERP.
Note
Time entries, with reference to tickets, can be released only if the corresponding ticket has already been
released to SAP ERP.
The administrator has to enable this function via business configuration, which lets you release time entries
independent of the related ticket status.
You can release approved time entries to CATS in SAP ERP. For this integration, you need to maintain mapping
between time types of the time entries in our system, and activity types in SAP ERP.
Note
Time entries, with reference to tickets, can be released only if the corresponding ticket has already been
released to SAP ERP.
The approved time efforts from FSM are replicated to C4C as approved time entries. These approved time
entries can be imported to a time report. Then you can Submit for Approval for the time report with
incorporated time entries with the approved status.
Employees can create time entries and import the created time entries into a time report. Time Entries can be
created from within a ticket, or can be independent of any ticket.
Note
Administrators can add new time types to the list of predefined time types using fine tuning.
Changes Tab for Time Entries and Time Reports [page 294]
Related Information
When creating a time entry, you can choose the time type for that entry. Administrators can add new time
types to the list of predefined time types using fine tuning.
● During time recording, employees can record time for different time types such as: working, travel,
administration, vacation, and so on.
● If time types are assigned to user status in an assignment, the fine tuning section, this time type is used to
start a new time entry when this user status is set at the assignment level. The new time entry displays in
the time entries work center and corresponding ticket.
● If no time type is assigned to a user status for an assignment, no new entry is created. However, a possible
running one is stopped.
● Approved time entries can be released to SAP ERP. In SAP ERP, there is a mapping between Time Type and
SAP ERP Activity Type.
You can define the time types available for use in time reporting with the fine tuning activity: Time Types for
Time Recording. Your administrator would have to enable the fine tuning activity.
Go to Business Configuration Implementation Projects Open Activity List Fine Tune , and search for
Time Types for Time Recording activity. In the Time Types for Time Recording fine tune activity screen, choose
the Add button and add a time type code and a description for it.
Example
Use codes such as 01, 02, or 03, and descriptions can be based on relevant task types; such as: Billable Hours,
Non-Billable Hours, Travel, or Training.
The administrator can assign code list restrictions to time types and assign various time type values to
different roles.
Go to Administrator General Settings Code List Restrictions , and apply code list restrictions to time
types in the business object Time Entry.
Note
When creating new time entries, date defaults to current date, and time zone defaults to the time zone
based on user settings. Employees can change the default data for the time entry.
Note
From the Ticket work center, navigate to Ticket Time Entries New to create a new time entry directly
from a ticket.
From the Time Entries work center, navigate to Create New Time Entries
Note
You can also create time entries on behalf of your team members based on the access restriction.
Employees can use the Start Recording and Stop Recording button to record their time.
Once the recording starts a new time entry is created. When the employee stops the recording the
corresponding time entry is updated with the end time and the total duration. Users can adjust these time
entries later.
● From the Time Entry tab by navigating to Time Entries Start Recording .
● From the Ticket work center by navigating to Time Entries Start Recording .
If your administrator has already assigned time types to a user status for assignment, in the fine-tuning
section, this time type is used to start a new time entry, once you set the status for the assignment.
The new time entry displays in the Time Entries work center, and the corresponding ticket.
The administrator can assign time types to assignment status to trigger time recording from assignment.
You can assign time types to different assignment statuses in the fine tuning activity. Navigate to Business
Configuration Implementation Projects Open Activity List Fine-Tune , and search for Demand
Processing. Maintain the external status codes for assignment here.
You can merge multiple time entries to create a single time item. In the same way, you can also split a single
time entry into multiple time items for billing.
Navigate to Tickets tab and select a time entry. Go to Time Entries More Merge to Time Item or Time
Entries More Split into Time Items .
As a manager, you can manually change the status of the time entries to Released.
Once the status is set to released, it cannot be changed or deleted. This status can also be used when the time
entries are released to a third party system.
Note
Release time entries to SAP ERP CATS when submitting a time report for approval, without depending on the
related ticket status.
The administrator has to enable this function via business configuration, which lets you release time entries
independent of the related ticket status.
You can easily create new time entries by copying the existing ones.
Note
When copying from an existing time entry in a ticket, the ticket ID gets copied over to the newly created
time entry.
A Time Entry, whether created manually or automatically can be converted to a time item when you are ready
to bill the customer for the time spent on an assignment.
In the solution, ticket items are integrated with SAP ERP for billing processes. For billing of time, spent on a
ticket or ticket items, time items can be used. After a time entry is created, it can be converted to a time item of
a ticket for billing purpose.
Click Create Time Item action, and select the Time Item (Product with usage Time). This product can either be
selected by the user or can be set up by the administrator for automatic selection of the product.
● You can create a time item from the Time Entries tab:
○ Select a time entry and choose Create Time Items.
○ Select the ticket ID and product for creating the time item. A list of products with Usage field displays.
● You can create a time item from a ticket:
○ System creates a complete time item with start and end dates.
You have the option of implementing a BAdI while creating time item from time entry to modify or copy
information using custom logic and implementation.
This is PDI enabled BAdI and can be implemented using SAP Cloud Applications Studio by adding an item to
the solution as follows:
4. Once the add item window displays, follow the steps mentioned in the screenshot below.
Note
5. Follow next steps and add values (mentioned below) to create the Enhancement Implementation.
The administrator has the ability to decide whether the rounding should happen at the time or service item
level. This will avoid rounding at the time item (child) and service item (parent) level at the same time.
To enable this feature, navigate to Edit Project Scope: First Implementation General Business Data
Employees and Service Agents Employees , and in the Questions tab select the option: Do you want to round
off the quantity at Service Item Level?
When the user converts a time entry to a time item, the time item can be rounded off to the nearest defined
time. This depends on how much rounding you have defined in the rounding rules under administrator settings.
By default, rounding off occurs at the time item level. Select a configuration question to enable rounding at the
service item level.
Note
Rounding is now enabled at the parent service item level for time entry, when converting to time item. Your
administrator can create rules to round off time entry duration while creating time items. See Configure
Time Item Rounding Rules [page 292] for more information.
The administrator can set up time item rounding rules, when creating time items from time entries.
Log on to system using administrator credentials and navigate to Administrator Service and Social Time
Recording Define Rules for Time Item Rounding .
You can convert a time entry to a time item product for billing purposes. You can choose a time item manually
or it can be determined automatically by the system based on the time item product determination rule set in
business configuration.
You have the flexibility to determine the time item product for a ticket based on different attributes of time
entries (such as time type), and tickets (such as service organization).
Note
See Configure Product Determination for Time Recording [page 293] for more information.
Example
Based on the Service Organization of the ticket and time type of the time entry, different products can be
assigned as ticket time item.
The administrator has to confirm a business configuration scoping question to enable auto determination of
Time Item Product based on time entries.
If you select the option, then the time item product is determined automatically. However, if you do not select
it, then select the product for time item manually from the list of displayed products.
Navigate to Edit Project Scope First Implementation Questions for Employees Enable Product
Determination for Time Recording , and select the question: Do you want to enable rule based product
determination for a ticket from Time Recording?
You can determine Time Item Product, based on different attributes of Time Entries (Time Type, Start Time,
End Time), and Ticket ( Service Org., Time Type).
In the field service scenario, technician has to track time spent on various tasks to bill customers appropriately;
and also maintain their time entries for creating time reports.
To facilitate and make time recording easy for the technicians, auto time recording can be used. Using this
feature, the technician can record time for a ticket, or independent of a ticket. Once the recording starts, a new
time entry for the corresponding ticket gets automatically created. When the technician stops the recording
the corresponding time entry is updated with the end time and duration. Technicians can adjust the time
entries later.
● You can edit time entries after stopping the time recording.
● If you edit the time entry before stopping the recording, then recording stops and your edits are given
precedence.
● If you start a time recording on one date and stop in another, the system creates a time entry with duration
only. Time entries can be created for one date only.
● You can have only one auto time recording at a time.
An employee can start and stop time recording from the Time Entries and Tickets tab.
Procedure
1. To record time automatically from the time entries tab, navigate to the Time Entries tab and choose the
Start Recording button to begin recording time.
2. Choose a time type, which displays the current date, time, and time zone. The system indicates the time
entry for which auto recording is going on.
3. To record time automatically from the tickets tab, navigate to the Tickets Time Entries tab and then
Tickets tab and choose the Start Recording button to begin recording time. In this scenario, the system
assigns the ticket ID for the recorded time entry.
Use the Changes tab in Time Recording work center to track different attribute changes for time entries and
time reports.
When you scope Time Entries, the Changes tab is enabled by default.
When you scope Time Reports, the Changes tab is enabled by default, and also displays a list of time report
attributes.
This tab helps you track attribute updates made to time reports.
You have the option of sorting time reports by the start date and start time in the Time Recording tab.
Use time entries for a Ticket in the Standard Ticket PDF Form Template used in Preview Summary and Add
Summary for Ticket.
When you create a new time entry, you can extend the ticket search using the Ticket with my Involvement query
parameter.
You can assign an existing time entry to a ticket after the time entry is created. For default queries in ticket, use
My Open Work Tickets, All Tickets, My Tickets, and My Work Tickets queries, you can assign time entries to a
ticket.
You can quickly filter the tickets based on involvement while assigning ticket for a time entry. To access the
query, navigate to Time Reports Time Entries New Ticket ID .
User can be added as the technician either in the ticket header level, or as a technician at the ticket item level.
You can assign page layout for time entries using configuration.
You can create various page layouts based on different attributes for Time Entries and Time Reports. Your
administrator would have to set these attributes for you.
For more information on enabling and using page layout options, see the Adaptation Quick Guide (HTML5).
When the T&M Journals are approved in FSM and replicated to C4C, the time entries status is unchanged. The
time entries can be imported to the corresponding C4C time report for further approval and releasing to ERP.
You can directly know if a time item has been created for this time entry or not.
Time report is like a time sheet or time card used for a date or date range.
A time report is a collection of time entries, which can be submitted for approval to one or more approvers.
Approvers can view the time reports submitted for approval and decide whether to approve or reject a time
report.
There can be only one time report for a given date or date range. One time entry can belong to only one date. A
single time report for each employee for a date or date range makes it easy for the manager to look at their
team members recorded time.
Time reports are used for approval purpose only. Manager or approver can see the time entries entered by the
employees through time reports.
When a time report is accepted all the time entries get accepted and same is true for rejection.
Every time a time entry is added to a time report, the total duration for a time report (summation of the
duration of all the time entries for the time report) is calculated.
The administrator can set standard work flow rules to set up notifications or emails based on changes in the
time reports.
Users can create time reports for a given date range. When a time report is created for the first time, user has
to import time entries into the time report, which were created before the creation of time report. All time
entries created later get added to the corresponding time reports automatically.
Note
You can also create time reports on behalf of your team members based on the access restriction.
Users can record productive and non productive hours for a work ticket and create time entries and reports
and submit time reports for manager approval.
Once a time entry is added or edited for a time report, the status of the time entry as well as the time report
changes to In Preparation.
User has the flexibility to add, edit, or delete the time entries after the time report is approved, or rejected.
When user updates an entry in a report, the time entries and the time report change to In Preparation status;
thus allowing the employee submit the report for approval again.
If a new time entry is added in a time report containing one or more time entries with approved or rejected
status, the existing status of those time entries don't change. When such time report is submitted for approval
again, the status of the In Preparation time entries changes to Approval Pending. ( The approver knows that
those time entries were approved or rejected before.)
You can define the time types available for use in time reporting with the fine tuning activity: Time Types for
Time Recording. Your administrator would have to enable the fine tuning activity.
Go to Business Configuration Implementation Projects Open Activity List Fine Tune , and search for
Time Types for Time Recording activity. In the Time Types for Time Recording fine tune activity screen, choose
the Add button and add a time type code and a description for it.
Example
Use codes such as 01, 02, or 03, and descriptions can be based on relevant task types; such as: Billable Hours,
Non-Billable Hours, Travel, or Training.
You can use standard approval process for time reports approval . The approver can see the notification and
accept or reject the time report from the notification itself, or can navigate to the time report for approval.
There are options of accepting or rejecting a time report from the time report approval tab. Hence the approver
does not have to go back to the notification after reviewing the time report details.
Time reports are used for approval or rejection only. Managers or approvers can see the time entries (entered
by the employees) in a time report. When a time report gets approved, all entries within the report get accepted
as well. The same behavior holds true for time report rejection. Once a time entry is added or edited for a time
report, the status of the time entry as well as the time report changes to In Preparation.
You have the flexibility to add, edit, or delete the time entries even after a time report is approved or rejected.
When you update an entry in a report, both the time entries and the time report status changes to In
Preparation. At that point, the employee can submit the report for approval again.
If a new time entry is added to a time report that contains one or more time entries with approved or rejected
status, then the existing status of those time entries does not change. So when the time report is submitted for
approval again, the time entries with In Preparation status changes to status Approval Pending. (This is done so
that the approver knows that those time entries were approved or rejected before.)
When a Time Report is accepted, all the time entries except ones with status Released are approved. When a
Time Report is rejected, all the time entries except the ones that are Released, are rejected.
Note
This behavior helps the approver know that those time entries were approved or rejected before.
Users can withdraw a time report even after submitting it for approval, hence allowing them to make necessary
corrections in the time report and re-submit it for approval.
As part of the time report submission process, as soon as the user submits a report for approval, the approver
receives a notification for the same. However, if the time report gets withdrawn, then the notification gets
withdrawn from the approver's notification list.
The administrator would have to enable the standard multistep approval process for time reports.
Go to Business Configuration Implementation Projects Your Project Edit Project Scope Questions
General Business Data Employees and Service Agents Employees and under the Enable Time Recording
section, select the question: Do You want to use a multi-step approval for time recording?
Your administrator can enable auto submit time report for approval using business configuration, so you can
auto submit for approval as soon as the time report is saved.
Select the scoping question to enable auto submitting a time report for approval.
Go to Edit Project Scope First Implementation Questions. Drill down to General Business Data
Employees and Service Agents Employees , and select the question: Do you want the system to
automatically submit a time report for approval?
Select the approval process option to send a time report to a set of approvers. You can add multiple approvers
for a time report from the Approver Parties tab.
Go to Time Recording Approver Parties to add additional approvers for a time report.
Your administrator has to enable additional approver option for a time report by maintaining this in the
approval process.
Go to Administrator Approval Processes and select the new work distribution rule: Approver of Time
Report in the Time Report approval process.
As a user, you would be able to see time reports of another team, which you've been delegated. In the Time
Reports work center, when you view reports using the Delegated Time Reports criteria, you are able to see all
time reports delegated to you.
If a time entry is associated with a ticket, the following ticket fields are displayed in the time entries list within a
time report:
● Ticket Item ID
● Ticket Item Description
● Ticket main Installation Point ID
● Ticket main Serial ID
● Ticket main Product ID
● Ticket main Product Description
● Ticket Customer ID
● Ticket Customer Name
● Ticket ID
Note
You can see the key data related to the ticket for time entry in the list itself and do not need to navigate to the
ticket.
You are able to depersonalize data for Time Entry and Time Reports. So all associated personal information for
employee is no longer visible. However, you are able to search for and display the time entry or time report as a
record, without any personal information.
● Employee
● Party Node
● Reporter (only for Time Report)
The following table displays delete or depersonalize functions available for Time Entry and Time Reports:
Our solution delivers two data sources for analytics using information from time recording.
They are:
You can generate analytics for both the data sources based on the following key figures:
● Time Entry
Total Duration, Date, and Today.
● Time Report
Start Date, End Date, and Today.
Note
An administrator is able to generate standard reports for time entries and time reports from the Business
Analytics work center in the administrative section of the SAP Cloud for Customer solution.
This topic presents an overview of supported functions for offline time recording.
Note
● The Time Entry tab is enabled for mobile offline for display/edit/create scenarios.
The SAP Service Cloud solution enables customer service communication across multiple contact channels
such as: phone, e-mail, chat, messaging, portal, and several social media channels. The service process begins
with incoming complaints/queries/requests from these sources. The customers communicate with agents
using these channels.
The Ticket creating process begins with incoming customer communication via different communication
channels. Our solution supports the following channels.
E-mail messages routed to the system automatically generate service tickets that are sent to service agents for
processing.
In order to respond to an e-mail message, the customer's e-mail address must be stored in the system
database. You have the option to reply to a ticket, or compose a new e-mail. If you choose to reply, the previous
customer message will be copied, and the reply will be sent to all recipients of the last e-mail.
If your system is set up to support it, you can respond to tickets from the agent workspace using Microsoft
Outlook. To do this, you must download and install the SAP Cloud for Customer Add-In for Microsoft Outlook.
Your administrator can expose different e-mail addresses to customers. For each address, your company must
evaluate whether to use the business-to-business (B2B), or business-to-customer (B2C) process, based on
your master data policies, and set up e-mail forwarding accordingly.
For Administrators: find out how to set up e-mail channels in your solution.
Context
As an administrator, you can enable e-mail as a communication channel for either customer service or
employee support.
Procedure
This setting enables e-mail as a communication channel for both customer service and employee support.
There is an equivalent setting under customer support. Either element can be selected and enables both
scoping elements.
The administrator would have to configure from domains used to respond to support tickets.
E-mail addresses that you use as the sender address in e-mail responses must belong to allowed domains. Add
allowed domains in the table for Allowed Sender E-Mail Domains.
Procedure
Restriction
Ensure the domain of this outbound e-mail address is an allowed domain. See previous step - Add
Allowed Domains for E-Mail Addresses.
The administrator would set up and maintain HTML-based templates for outgoing e-mail messages.
Context
Branding templates are applied to all outbound e-mail messages sent from the channel, adding it around the
response prepared by the agent.
A branding template is a simple HTML file with a #TEXT# placeholder. The placeholder is usually located
between a standard header and footer. The header and footer can include your brand logos and any standard
text or disclaimers. Create the branding template file with your preferred HTML editor. You can configure a
different branding template for each channel.
E-mail messages sent to your customer are the sum of: the agent response to the ticket, plus any response
template selected by the agent, plus the branding template defined for the channel.
Procedure
1. Go to Service Templates .
2. Choose New.
3. Enter the template name.
4. Select E-Mail as the template channel type.
5. Select Document-Based as the template type.
6. Select Branding Template.
7. Enter the e-mail Subject line.
8. Browse to the HTML file to be used as the template and save your entries.
Tip
To change the file used for the template, click Replace, then browse to and select the new file.
Your administrator would have to add the inbound e-mail addresses that you use for customer interactions and
ticket routing.
Context
When an e-mail message is received in the solution, the system creates a ticket for the corresponding e-mail
channel. If you implement routing rules, the solution routes the ticket for the selected channel as specified.
Procedure
The solution categorizes incoming e-mail messages with an unrecognized address as Unassociated E-Mail
and no ticket is created. You can add a default e-mail account to each channel. If the sender address is
unknown, the solution assigns the default account to the message and creates a ticket.
This standard pattern enables all messages pertaining to a specific ticket to be associated with (threaded
to) that ticket. You can choose between two subject line patterns for reply messages:
Restriction
After you select the message subject pattern for a channel, it cannot be changed, because any existing
messages would no longer thread properly.
You can add a branding template to your e-mail channels to control the look and feel of e-mails sent by
agents. Every time an agent sends an e-mail from one of those channels, the solution embeds the content
within the branding HTML.
Tip
Related Information
The administrator would configure the encryption settings for incoming and outgoing e-mail messages.
Procedure
1. Go to Business Configuration Your Project Edit Project Scope Questions Built-in Services and
Support System Management Security .
2. Under Group: E-Mail Security, set the question Do you want to use encryption and signatures for e-mails? to
In-Scope.
3. Set the encryption levels for individual e-mail addresses in fine-tuning. Go to Business Configuration
Activity List Fine-Tune E-Mail Encryption and Signature Check .
○ Incoming E-Mails Scenarios: Specify for each e-mail scenario whether incoming e-mail messages are
verified using a signature. Choose Check (and Reject if Untrusted) if you require a high-level or security.
Select Do Not Check if you do not have security requirements. Set the signature for the following
scenarios:
○ SAP Service Cloud: E-Mail Security, B2B Scenario
○ SAP Service Cloud: E-Mail Security, B2C Scenario
○ Outgoing E-mail Scenarios: Specify for each e-mail scenario whether the outgoing e-mail messages
are encrypted and signed. Set the encryption and signature for the following scenarios. The
recommended values are Encrypt if Possible and Sign.
○ SAP Service Cloud: E-Mail Security, B2B Scenario
○ SAP Service Cloud: E-Mail Security, B2C Scenario
The settings you select in Fine-Tuning are only enabled if you activate them.
7. Save your settings.
Use the SAP Cloud for Customer Add-In for Microsoft Outlook to respond to tickets. Your administrator would
set this up in the system.
Agents can use the editing features available in Microsoft Outlook when responding to tickets, and view e-mails
as interactions in the associated ticket.
To enable Microsoft Outlook for Service in scoping, go to: Business Configuration Your Project Edit
Project Scope Questions Service Customer Care Service Request Management Group: E-mail
replies via Microsoft Outlook (1). Before
using Microsoft Outlook to respond to tickets, agent must complete the following steps:
1. Download and install the add-in for Microsoft Outlook. Click on Downloads in the header bar and download
Add-In for Microsoft Outlook.
2. Enable the service scenario in the add-in settings in Microsoft Outlook.
3. (Optional) Add any shared e-mail accounts used for responding to tickets to Microsoft Outlook. Agents
must remember to select the correct account when responding to a ticket.
4. (Optional) Set the shared e-mail account as the default, so you don't have to select it manually when
replying.
● If this feature is enabled, when an agent responds to a ticket via e-mail, a new Microsoft Outlook window
opens to compose the response message.
● Include the ticket number in the subject line so that the e-mail is associated with the ticket as an
interaction.
● When you enable the service scenario in the Add-In for Microsoft Outlook settings, e-mails sent from
Microsoft Outlook are not recorded in SAP Cloud for Customer as activities. Instead, they are recorded only
as ticket responses.
● If your administrator enables this feature, service agents are still able to respond to tickets without using
Microsoft Outlook by deselecting the Use Microsoft Outlook option.
Administrators can define a default profile for all users who use the SAP Cloud for Customer Add-In for
Microsoft Outlook.
Context
You can send around guidelines for users to set up their profiles for the add-in. However, it may be easier to
simply define a default profile for your company. Users can then adapt it to their own workstyle later, if they
choose.
Procedure
The settings you see are the same ones that can be made directly in the add-in.
2. Make the settings to define the default profile for the add-in for all users at your company.
3. Save your settings.
When your company upgrades to the next release and as each user logs on, your default profile overwrites
any settings they may have made previously.
In addition to each end user being able to install the add-in manually, administrators can use an MSI file to
install the add-in on multiple clients remotely.
Context
Procedure
1. As an administrator, you can download the MSI file from the SAP Software Download Center at https://
support.sap.com/software/installations.html .
2. Search for C4C_OUTLK_ADDIN_MSI and download it.
For example, you could use the following command line for silent installation:
As an administrator, you can set up your system to exclude e-mail marked as either private or e-mail marked as
confidential from being synchronized to SAP Cloud for Customer.
Context
Procedure
As an administrator, you can set up your system to prevent notes and attachments from being synchronized to
and from SAP Cloud for Customer for appointments and visits.
Context
Note
These settings always affect both appointments and visits. For example, it is not possible to prevent
synchronization for appointments and not for visits.
Procedure
1. Log on as an administrator and choose Administrator General Settings Users Business Roles .
2. Use the filter to show all active business roles.
3. Select and edit the role for which you want to prevent synchronization of notes and attachments.
4. In the user role, add the appropriate business action restriction:
○ To prevent synchronization of attachments for appointments and visits
(GW_APPT_ATTACH_UPLOAD_DOWNLOAD)
○ To prevent synchronization of notes for appointments and visits
(GW_APPT_NOTES_UPLOAD_DOWNLOAD)
Use business communication monitoring to verify that e-mail messages are transmitted successfully. Your
administrator would have to set up the feature in the system.
Check that your business documents were sent and received, and by which process. Identify technical errors
and resolve them to prevent problems in follow-on processes or with your business partner.
Users can save a query for in-bound e-mail monitoring by following these steps in the system.
Context
Use business communication monitoring to verify that e-mail messages are transmitted successfully.
Procedure
3. In the advanced filter click Service Interface More Options search parameter.
4. Click Add Option button and add some or all service interfaces, depending on the business scenario
requirement:
○ ServiceRequestingIn: For B2C E-mail Scenario
○ EmailServiceRequestingIn: For B2B E-mail Scenario
5. Select any other search parameter option necessary for your query.
6. Once done, click Save Query to save the e-mail monitoring query for future use. You can mark this as
default query.
SAP Cloud for Customer provides you with a native e-mail editor that you can use to send and receive e-mail
communications. Additionally, you continue to have the option to use Microsoft Outlook or integrate with any
other third-party e-mail communication option.
The inline e-mail editor is a useful feature when you have to copy content from tickets or other ticket-related
tabs. The feature is available in the Interactions tab, and your administrator would have to enable it.
Note
You can either use the existing e-mail editor or the inline e-mail editor.
The following are some features for the inline e-mail editor:
Note
Inline e-mail editor does not support the option to forward inline images.
The administrator must enable the inline e-mail editor option via scoping.
Navigate to Administrator Service and Social Tickets Ticket Configuration and check the box for
Enable Inline Editor option.
As an Administrator, you can configure which tools appear on the response editor. Limiting formatting tools
can provide a large performance improvement.
Procedure
When responding to or forwarding an e-mail, the service agent can click the Load Inline Images button to load
all inline images from the e-mail chain. This helps the agent set context to the e-mail response.
The system displays a notification in case of e-mail server connectivity issues. This helps inform the service
agents.
Note
Create a support incident to make a request for enabling this feature in your system.
Redesigned e-mail feeder in Responsive UI provides more writing space for e-mails. You can resize the e-mail
feeder as well, which impacts the RichTextEditor accordingly. Additionally, you can reuse the font and letter size
options from the previous use until you clear the cache.
You can save the content in an e-mail editor as draft. The Save as Draft action checks all validations required for
the e-mail to be saved without any errors. Additionally, you can save an inline image in a draft e-mail.
Service agents would be able to save e-mail as drafts and edit them later.
Note
Note
You can use the available BAdI option to enable or disable all reply options such as: Reply, Forward, or Reply
with Outlook for e-mail. Additionally, you can set the To address option to a default address.
On the Interactions tab, using the available BAdI, you can hide or make visible the Reply and Send options for an
e-mail, based on certain ticket criteria. You can also set the To address field as default to a specific person.
You can respond to an email with inline images using drag and drop, paste from clipboard, and insert images
from your local storage. This facilitates in better communication and ease of use.
Note
Inline images will not be continued in the email chain on successive replies. Only web links get carried over
in successive emails.
Our solution provides you with a Reply with Outlook option button in the Interactions tab for your ease of use.
As a service agent, go to Tickets Interactions and click the Reply with Outlook option button to launch the
outlook email client and communicate with the customer.
Note
Agent must have configured the external email client option to view the Reply with Outlook button.
Navigate to Business Configuration Implementation Projects Edit Project Scope Communication and
Information Exchange Office and Desktop Integration Integration with Local E-Mail Applications
Questions , and select the Integration with Local E-Mail Applications option.
Note
Content of an email is limited to a length of 2000 characters when responding to an email via Outlook.
Use the available BAdI (DISABLE_FEEDER_SEND) option to enable or disable the Send action for an e-mail
response. Once disabled, the agent can use the Save as Draft option and save the e-mail response, but not send
it. You can use this feature based on roles and authorization.
Note
The following are some use case scenarios for disabling the Send option for e-mail response:
● Use the feature with the approval process to restrict sending out a response without an approval.
● Use the feature with skills to restrict agents from sending out e-mail responses without review.
Note
BAdI logic does not apply for any external e-mail editor.
Once you've added your e-mail channels, you can create work distribution rules to route the resulting tickets to
teams or agents. For detailed information, search for the topic Defining Rules for Ticket Routing.
● Post a question.
● Post a broadcast message and handle.
● Create or update their social media profile.
● Create a top level social media activity.
Disclaimer
The Solution may enable access to certain Third Party Web Services. “Third Party Web Services” means (i) any
and all web services made available by third parties (other than SAP, SAP SE and/or any of their affiliated
companies) that are accessible through or enabled by the Solution, and (ii) any and all application
programming interfaces, web service definition files, and other materials made available by or on behalf of
such third party web service providers to facilitate the access to and use of such web services. The following
terms apply to all Third Party Web Services:
● Licensee is solely responsible for obtaining all account and authentication credentials required to access or
use the Third Party Web Service’s API or the Third Party Web Service.
● Use of the Third Party Web Service’s API is subject to Licensee’s acceptance of the Third Party Web
Service’s terms and conditions, which must be obtained from the Third Party Web Service provider. SAP is
not a party to the agreement between the Licensee and the Third Party Web Service provider
● Licensee is solely responsible for executing any agreements required in connection with the use of the
Third Party Web Services, including any agreements to process and transfer personal data required under
applicable law.
● The Third Party Web Service’s API and the Third Party Web Service are excluded from all SAP
representation, warranties, indemnifications and support obligations.
● Licensee expressly agrees to indemnify SAP, its officers, employees, agents and subcontractors from and
against all claims, liabilities, losses, damages and costs (including reasonable attorney fees) suffered by
SAP arising from the use of any Third Party Web Services by Licensee or its Affiliates.
● SAP may throttle, suspend or terminate the Licensee’s access to the Third Party Web Service’s API
through the Product if Licensee violates or causes SAP to violate Third Party Web Service provider’s terms
of service or other applicable Third Party Web Service provider agreements or policies (including, without
limitation, exceeding any data or usage limits).
Add Facebook as a channel to create tickets and route them to service agents.
Customers can send either public messages by commenting on your company's Facebook wall or send private
messages by messaging your company using Facebook.
Your response is automatically public if the customer message was public, or private if the customer message
was private.
Example scenarios:
● If you reply to a Facebook message, your response is sent to Facebook as a reply to the customer's original
message.
● If your company's Facebook page allows nested commenting and your solution is configured to support it,
you can reply to comments on a post. Your response appears underneath the original comment.
Administrators must set up a Facebook App for use with SAP Cloud for Customer, to access your Facebook
pages and import Facebook posts, comments, or Facebook Messenger messages.
Prerequisites
● You have a Facebook account and have the developer access to this account.
● You've created a Facebook App to use with your pages.
Context
You must set up a Facebook App for use with SAP Cloud for Customer. The App is used to access various pages
you want to monitor and to extract posts from. By using one or more applications, most rate limit errors can be
eliminated.
Facebook must review your App before it can be used. The review process can take up to 3 weeks. Be sure
to allow for this time when planning your implementation. For more information on the Facebook review
process, see the related links at the end of this topic.
Note
The following is an example of the steps you can follow to create a new Facebook App. Texts and field labels
can be different. For more information, refer to Facebook developer documentation.
Procedure
4. Go to PRODUCTS Facebook Login Settings and enter Valid OAuth Redirect URIs. The URL should
be in this format: https//myXYZ.crm.ondemand.com/sap/byd/oauth/facebook.
5. Note down App ID and App Secret as you need to enter these values in SAP Cloud for Customer when
creating Facebook channels.
Related Information
https://developers.facebook.com/docs/apps/review/
https://developers.facebook.com/blog/post/2018/07/02/app-review-deadlines-approaching/
https://blogs.sap.com/2019/07/19/facebook-page-and-sap-cloud-for-service-integration-requires-facebook-
app-review/
The system can retrieve messages from a Facebook page, and agents can post their responses back to that
page. As a prerequisite to this task, you must set up a social media channel for the Facebook page.
To view or edit existing Facebook channels, click the channel ID in the list to view the details screen.
Prerequisites
Procedure
You can find these values on your Facebook for Developers page.
b. Select a date and time for the initial import run. The initial import is the first import of messages from a
channel.
This setting indicates a specific date and time from which messages are imported once an import run
has been scheduled for the channel. It allows you to front load the system with, for example, all
messages from the last 30 days.
c. Choose whether to remove the assigned processor for reopened tickets from Facebook using the
Remove Assigned Processor switch.
If the switch is on, the Assigned To field of the reopened ticket from Facebook is empty, which means
the original processor of this ticket is removed. If the switch is off, the processor who closed the ticket
is directly assigned to the ticket when it's reopened from Facebook.
5. Click Connect with Channel.
Column Description
Caution
You must select this in order to enable the system to receive inbound mes
sages from Facebook.
Block Responses This disables outbound messages from the system to the Facebook page.
Select this option if you're just testing a page to avoid any inadvertent responses
or broadcast messages.
Channel ID You can define the channel ID in a way that is meaningful to you. For example, all
Facebook channels have a similar naming convention.
Caution
This is the only chance you have to define the channel ID. After you save your
entries, the field switches to read-only and can no longer be edited.
Channel This is the display name throughout the system for the channel. For example, in
the ticket or customer details.
It's automatically populated with the Facebook account name associated with the
channel and can't be edited.
Note
This language setting is used for text analysis to extract keywords and senti
ments.
It doesn't mean that messages posted in other languages to this channel will
not be retrieved though text analysis will still be performed in the native lan
guage of the channel, so keyword and sentiment results may vary.
Ticket Type Ticket is created with a specified ticket type. If no ticket type is specified,
service request is applied as the default value.
Customize Status for Reopened By default, a social ticket reopened by a customer's comment or direct message is
Ticket set to the In Process status. When this switch is turned on, you can set a custom
status for all the completed social tickets reopened from this channel.
Note
○ Before you can enable this feature for tickets reopened through direct
messages, you need to select Add to Completed Ticket from the Direct
Messages dropdown menu.
○ Follow-up workflow rules based on the custom status are not applicable.
Your administrator would set up and trigger a Social Media extraction run.
Context
Set up social media channels to import your content from SAP Social Media Analytics and create different
tickets types.
Procedure
3. In the list, when you click the Channel Id field, the Social Media Channel Import Run screen displays.
4. Clicking the Channel field would take you to that social media channel page, such as: Facebook.
5. Log in to Facebook or Twitter or YouTube as a standard user and go to the specific page and enter a post
there.
6. Next, you would have to schedule the extraction run from the Social Media Channel Import Run
screen and schedule it to run immediately. You can also schedule a run for every 3 minutes.
7. Once you schedule the extraction run, the messages from the Facebook or Twitter or YouTube are
extracted into our system. The social media messages are extracted and created within our solution as
Tickets. You would be able to see the new ticket by going into the Tickets work center, or if you want to look
If you want to support Facebook direct messaging, then you must enable the Facebook Direct Message
Integration scoping element in your solution. You can also use the nested Facebook comments feature for
which you would have to enable nested comments on your company's Facebook page.
To enable Facebook Direct Message Integration, go to Business Configuration Edit Project Scope [Your
implementation project] Questions Service Customer Care Service Request Management Facebook
Direct Message Integration , and select the question: Do you want to support direct messages for Facebook
channels?
To enable the Reply to Facebook Comments feature, select the question: Do you want to allow agents to reply
to Facebook comments?
Procedure
The list of the Social Media Channels that are set up in the system appears.
2. To view or edit existing Facebook channels, click the channel ID in the list to view the details screen.
Add Twitter handle to create tickets and route them to service agents.
● You can use Twitter to send a private message provided user follows the Twitter handle of the company
used in the response.
● You can retweet a message to Twitter that is posted by a customer. Hover your mouse over the message in
Interactions and choose Retweet. The message would be posted on your company Twitter page.
● You can set the channel to active.
If you reply to a tweet, your response would be sent to Twitter as a reply to the original tweet from the
customer.
Public responses to Twitter tickets are limited to 280 characters, including spaces. If you enter a message
greater than 280 characters, the response is not sent . The solution counts the remaining available characters
as you type.
Administrators must set up a Twitter application for use withSAP Cloud for Customer, to access your Twitter
account and extract Tweets.
Prerequisites
● You have requested the Read, Write and Direct Messages permissions for your Twitter application.
● You have a Twitter account and developer access to that account.
● You have created a Twitter application for use with your handle(s).
Context
You can avoid most rate limit errors by using one or more applications. The following is an example of the steps
you can follow to create a Twitter application.
Note
Texts and field labels may be different. For more information, see the Twitter developer documentation
http://dev.twitter.com/docs.
Procedure
Next Steps
For both the Website and the Callback URL, you should enter your SAP Cloud for Customer tenant URL (http://
<your tenant>.ondemand.com)
Once you have created the application and saved your settings, you need to note the Consumer key and
Consumer secret as you'll need to enter these values in SAP Cloud for Customer when creating Twitter
channels.
Administrators can configure Twitter handles as communication channels to support your service organization.
Channels can be configured to create tickets and route them to service agents.
To retrieve messages and enable agents to respond via Twitter handle, administrators must set up a social
media channel for that handle. Once you have connected your channel, create and schedule the import run for
message extraction. Finally, define the routing rules for the channel so that tickets get assigned to the right
teams or agents.
To view or edit existing Twitter channels, click on the channel ID in the list to view the details screen.
Your administrator would set up and trigger a Social Media extraction run.
Context
Set up social media channels to import your content from SAP Social Media Analytics and create different
tickets types.
Procedure
3. In the list, when you click the Channel Id field, the Social Media Channel Import Run screen displays.
6. Next, you would have to schedule the extraction run from the Social Media Channel Import Run
screen and schedule it to run immediately. You can also schedule a run for every 3 minutes.
7. Once you schedule the extraction run, the messages from the Facebook or Twitter or YouTube are
extracted into our system. The social media messages are extracted and created within our solution as
Tickets. You would be able to see the new ticket by going into the Tickets work center, or if you want to look
at the messages you could also go to Service - Social Media Messages and view the extracted messages
there.
8. To create mass processing of messages, create a few messages on Facebook or Twitter or YouTube by
different users and trigger the extraction run. This would result in the mass creation of Tickets.
Context
Go to Administrator Service and Social Settings then under Social Media, choose Social Media Channels
and click New.
Procedure
If the switch is on, the Assigned To field of the reopened ticket from Twitter is empty which means the
original processor of this ticket is removed. If the switch is off, the processor who closed the ticket is
directly assigned to the ticket when it is reopened from Twitter.
3. Click Connect with Channel.
4. The Twitter log-on page will open in a new browser window.
5. Log in to your Twitter account and authorize the application.
6. Once you see the message that your account has been authenticated, you can close the window and return
to the system.
Setting Description
ID You can define the channel ID in a way that is meaningful to you. For example,
all Twitter channels may have a similar naming convention.
Caution
This is the only chance you have to define the channel ID. After you save
your entries, the field switches to read-only and can no longer be edited.
Channel This will be the display name throughout the system for the channel. For exam
ple, in the message or customer account details.
It is automatically populated with the Twitter account name associated with the
channel and cannot be edited.
Note
This language setting is used for text analysis to extract keywords and sen
timent. Messages posted in other languages to this channel will still be re
trieved, but text analysis will be performed in the native language of the
channel so keyword and sentiment results may vary.
Block Responses This disables outbound messages from the system to the Twitter handle.
You should select this option if you are just testing a page to avoid any inadver
tent responses or broadcast messages.
Twitter Account for Responses This allows you to add a separate response handle to the channel—so that re
sponses sent by agents come from a different account than the one used to re
trieve the original customer message. This essentially allows you to define one
account as your primary response handle by setting the same response ac
count for several, or all of, your Twitter channels.
Prerequisites: You have created a channel for the Twitter account you plan to
use as the response handle.
Restriction
The response account applies only to public messages sent to your Twitter
accounts. Responses to direct messages must originate from the receiv
ing account, because Twitter does not allow proxy responses to direct
messages.
Customize Status for Reopened By default, a social ticket reopened by a customer's comment or direct mes
Ticket sage is set to the In Process status. When this switch is turned on, you can set a
custom status for all the completed social tickets reopened from this channel.
Note
○ Before you can enable this feature for tickets reopened through direct
messages, you need to select Add to Completed Ticket from the Direct
Messages dropdown menu.
○ Follow-up workflow rules based on the custom status are not applica
ble.
Next Steps
● Create and schedule a social media message import run for the channel.
● Create a routing rule for the channel.
Related Information
Create a YouTube social media channel to process comments from YouTube video pages into service tickets,
which can be routed for processing.
Configure YouTube accounts as communication channels to support your service organization. Channels can
be configured to create tickets and route them to service agents.
Set up a social media channel for the YouTube account to retrieve comments from a YouTube video, and enable
agents to post responses back to that video page. Once you've connected your channel, complete the following
steps:
● Create and schedule a social media message import run for message extraction.
● Create routing rules for the channel so that tickets get assigned to the right teams or agents.
Administrators would create a Google project to access the various video pages you want to monitor and to
extract comments.
Context
Create a Google account and note the client ID and client secret, as this information will be required when you
set up a YouTube channel.
Procedure
Administrators can create a YouTube channel to enable processing and routing messages.
Prerequisites
Before you can set up a social media channel for your YouTube account, you must do the following:
● Create a Google account and note the client ID and client secret.
● Create a YouTube channel with the Google Account to process comments on your YouTube channel.
Procedure
1. Go to Administrator Service and Social Social Media , and choose Social Media Channels
New .
2. Define the Advanced Settings.
a. Enter the <Client ID>, and <Client Secret>.
b. Choose whether to remove the assigned processor for reopened tickets from YouTube using the
Remove Assigned Processor switch.
If the switch is on, the Assigned To field of the reopened ticket from YouTube is empty which means the
original processor of this ticket is removed. If the switch is off, the processor who closed the ticket is
directly assigned to the ticket when it is reopened from YouTube.
3. Enter the <Client ID>, and <Client Secret> in under Advanced Settings section.
4. Choose Connect with Channel, and log in with your Google account e-mail address. Accept the conditions.
The new YouTube channel is now authenticated and connected to your system.
5. Choose Get Channel Details and enter the following information:
Value Description
ID You can define the channel ID in a way that is meaningful to you. For ex
ample, all YouTube channels may have a similar naming convention.
Note
This is the only chance you have to define the channel ID. After you
save your entries, the field switches to read-only and can no longer
be edited.
Channel Name This would be the display name throughout the system for the channel.
For example, in the ticket or customer details.
Block Responses This disables outbound messages from the system to the YouTube
video page.
You should select this option if you are just testing a page to avoid any
inadvertent responses or broadcast messages.
Customize Status for Reopened Ticket By default, a social ticket reopened by a customer's comment or direct
message is set to the In Process status. When this switch is turned on,
you can set a custom status for all the completed social tickets reop
ened from this channel.
Note
○ Before you can enable this feature for tickets reopened
through direct messages, you need to select Add to Completed
Ticket from the Direct Messages dropdown menu.
○ Follow-up workflow rules based on the custom status are not
applicable.
Your administrator would set up and trigger a Social Media extraction run.
Context
Set up social media channels to import your content from SAP Social Media Analytics and create different
tickets types.
3. In the list, when you click the Channel Id field, the Social Media Channel Import Run screen displays.
4. Clicking the Channel field would take you to that social media channel page, such as: Facebook.
5. Log in to Facebook or Twitter or YouTube as a standard user and go to the specific page and enter a post
there.
6. Next, you would have to schedule the extraction run from the Social Media Channel Import Run
screen and schedule it to run immediately. You can also schedule a run for every 3 minutes.
7. Once you schedule the extraction run, the messages from the Facebook or Twitter or YouTube are
extracted into our system. The social media messages are extracted and created within our solution as
Tickets. You would be able to see the new ticket by going into the Tickets work center, or if you want to look
at the messages you could also go to Service - Social Media Messages and view the extracted messages
there.
8. To create mass processing of messages, create a few messages on Facebook or Twitter or YouTube by
different users and trigger the extraction run. This would result in the mass creation of Tickets.
Add WeChat as a channel to create tickets and route them to service agents.
Customers can associate the WeChat account with either an individual customer (in B2C scenario) or with the
contact of an account (in B2B scenario) in the solution. Then they can directly create service tickets from
WeChat, and the service agents can post response back to WeChat from service tickets.
Note
To associate WeChat account with the contact of an account, the following scenarios are supported:
● One contact has only one WeChat account and the account follows one or more WeChat official
accounts.
● One contact has more than one WeChat accounts and each WeChat account follows different WeChat
official accounts.
One contact has more than one WeChat accounts and more than one WeChat accounts follow the same
WeChat Official account.
Before proceeding with the WeChat integration, ensure that the following prerequisites are met:
● You have registered a WeChat official account with Subscription Account type from the WeChat Official
Account platform.
● The API you need is included in our solution. For the list of APIs provided by our solution, see OData at
https://help.sap.com/doc/d0f9ba822c08405da7d88174b304df84/LATEST/en-US/index.html.
● You have set up an intermediate app server to send and receive messages between WeChat Server and our
solution.
You can deploy the intermediate app server on SAP Cloud Platform or any third-party cloud platform.
For the process flow example and the sample code for B2C scenario, see: https://blogs.sap.com/2018/02/28/
integration-of-wechat-and-c4c-service-ticket-on-html5-client/ .
For the process flow example and the sample code for B2B scenario, see: https://github.com/kellynlee/
C4CODataSampleCode .
Administrators can create a mashup service for WeChat to enable the interaction between the intermediate
server and the solution.
Context
Create a mashup service for WeChat and note down the Service ID as it is required when you create the WeChat
Channel.
Procedure
Procedure
Setting Description
Caution
After you save your entries, the field switches to read-only and can no longer be
edited.
MashUp Service ID The service ID of the mashup service you have created for the WeChat Channel.
Customize Status for Reop By default, a social ticket reopened by a customer's comment or direct message is set
ened Ticket to the In Process status. When this switch is turned on, you can set a custom status for
all the completed social tickets reopened from this channel.
Note
○ Before you can enable this feature for tickets reopened through direct mes
sages, you need to select Add to Completed Ticket from the Direct Messages
dropdown menu.
○ Follow-up workflow rules based on the custom status are not applicable.
After you have created a WeChat channel, you can view and edit the channel. Go to Administrator Service
and Social Social Media Channels and choose the Channel ID of the WeChat channel you want to view or
edit.
You can integrate our solution with different external systems for the purpose of creating service tickets. This
requires you to create custom channels.
Create a custom channel type to communicate with external systems to generate service tickets.
Context
Procedure
Set up a custom channel in order for the system to retrieve messages from and enable agents to respond via a
custom channel type.
To set up a custom channel, choose Administrator Service and Social Settings Social Media Channels .
You need the ID of the mashup web service you have previously created to respond to a custom channel.
Tip
Listen Only Mode disables outbound messages from the system to the custom channel. You should
select this option if you are testing a page to avoid any inadvertent responses or broadcast messages.
Configure your SAP Cloud for Customer system to communicate with any channel.
To enable your system to send response messages to an external system, the external system should expose a
web service. The web service should accept the content type Form and parameter name = “content”. The
parameter content contains the JSON string, which has the response message. The JSON string appears in the
following format:
"original_id": “<Identifier from social media channel e.g. Bazaar Voice (String)>”
"sma_id": “<Unique ID for service request fromSAP Service Cloud, if one exists (String)>”
"service_req_no": “<Unique ID for service request from SAP Service Cloud, if one exists(String)>”
"sma_create_datetime": “<Date Time at which media message was created (UTC String)>”
sma_id Social media activity (Internal ID from SAP Cloud for Social
Engagement or SAP Service Cloud) Identifier.
Example
Content =
{"original_id":"083020120506","sma_id":"12942","service_req_no":"8789","author_name":"","author_emai
l":"","sma_create_datetime":"2012-10-09T22:55:30Z","private_ind":"FALSE","text":"tests49"}
Follow-On Tasks
Procedure
5. Save your entries and activate the communication system. Select Actions Set to Active .
Procedure
Administrators would have to create a mashup web service to respond to a custom channel.
You have set up the channel type, and must have a web service URL that accepts the standard response JSON
interface.
Each channel you set up using SAP Social Media Analytics is connected to only one SAP Social Media Analytics
topic. Each topic requires a separate web service.
Example
If you have three topics defined on SAP Social Media Analytics that you want to use to monitor your custom
channel, you must set up three separate web services, and three separate social media channels.
The custom channel used for responding to the messages captured via SAP Social Media Analytics can be the
same. For more information on setting up Twitter social media channels using SAP Social Media Analytics, see.
Procedure
Next Steps
As a follow-on task, add a custom channel. For details, see Add a Custom Channel [page 346]
Your administrator would set up and trigger a Social Media extraction run.
Context
Set up social media channels to import your content from SAP Social Media Analytics and create different
tickets types.
3. In the list, when you click the Channel Id field, the Social Media Channel Import Run screen displays.
4. Clicking the Channel field would take you to that social media channel page, such as: Facebook.
5. Log in to Facebook or Twitter or YouTube as a standard user and go to the specific page and enter a post
there.
6. Next, you would have to schedule the extraction run from the Social Media Channel Import Run
screen and schedule it to run immediately. You can also schedule a run for every 3 minutes.
7. Once you schedule the extraction run, the messages from the Facebook or Twitter or YouTube are
extracted into our system. The social media messages are extracted and created within our solution as
Tickets. You would be able to see the new ticket by going into the Tickets work center, or if you want to look
at the messages you could also go to Service - Social Media Messages and view the extracted messages
there.
8. To create mass processing of messages, create a few messages on Facebook or Twitter or YouTube by
different users and trigger the extraction run. This would result in the mass creation of Tickets.
Get more information on adding support for Instagram using Sprinklr integration.
If you are interested in Instagram integration to SAP Cloud for Customer, you can request more information at:
https://www.sprinklr.com/the-way/sprinklr-app/sap-hybris-cloud-customer/
This document is intended for customers and partners who want to integrate their third party Computer
Telephony Integration (CTI) adapters and widgets with SAP Cloud for Customer.
SAP Service Cloud can integrate with external computer telephony integration (CTI) solutions to support
service processes. Download and install the CTI connector, and save the CTI Client Adapter shortcut to your
desktop.
Your administrator can customize the CTI adapter behavior by downloading the project source code for the
SAP Cloud for Customer CTI Client Adapter from the Service Marketplace Software Download area.
Depending on your CTI provider your administrator may also have the option to use widget-based integration
to the solution. Widget-based integration eliminates the need for an external telephony client app and the
adapter download.
This video demonstrates how to set up computer telephony integration with your SAP Cloud for Customer
system.
See how the system processes out and inbound call information and passes call information to and from your
CTI system.
SAP Cloud for Customer supports initiating outbound calling from any screen within our solution via click-to-
call feature.
Note
Maintain computer telephony integration (CTI) vendor integration to use the call feature. Call handling is
done on CTI vendor application.
Note
Maintain computer telephony integration (CTI) vendor integration to use the call feature. Call handling is
done on CTI vendor application.
You have the option to integrate third party CTI options with our solution using a third party adapter or widget.
Integrate External Telephone System Widget with SAP Cloud for Customer [page 365]
When using a widget based integration for external telephony system, we provide you with the following
options.
Adapter integration lets you integrate their third party Computer Telephony Integration (CTI) adapters with
SAP Cloud for Customer solution.
Related Information
Integrate External Telephone System Widget with SAP Cloud for Customer [page 365]
11.3.2.1.1 Prerequisites
These items are required to integrate your CTI solution to SAP Cloud for Customer.
Client-Side Only client-side Integration is supported so you must have a client-side application to
Application communicate via the built in adapter.
Agents using the CTI solution must have this client-side application running on their
desktop.
Microsoft® Visual In order to enable the outbound call feature, you need to use Microsoft® Visual Studio
Studio to edit the CTI Connector project.
SAP Cloud for The adapter must be installed and run on each agent's desktop.
Customer CTI Client
Adapter The installation file for the CTI Client Adapter is available on the Downloads page of
SAP Cloud for Customer.
Note
If you want to use the https protocol to connect to your CTI client, you must start
the adapter with administrator rights (right-click and select run as administrator).
If you are not using https, you can start the adapter normally.
SAP Service Access to SAP Service Marketplace is required to download the CTI Connector project
Marketplace used for enabling outbound calls.
Note
Access restrictions for Live Activity are determined from the Queue workcenter. Therefore any user or role
assigned Live Activity must also be assigned Queue.
A high level overview of the architecture that allows CTI integration with SAP Cloud for Customer.
Inbound calls are achieved using a parameterized URL that your client-side application passes to the SAP
Cloud for Customer CTI Client Adapter. This allows the call attached data to display in the Live Activity pane in
the solution.
Outbound calls are achieved by using a DLL which passes the dial out phone number from SAP Cloud for
Customer to your CTI solution and in which you have included the necessary dial-out logic.
Inbound call integration uses a parameterized URL call from the CTI desktop client to the SAP Cloud for
Customer CTI Client Adapter to pass information like the ANI, DNIS, and CAD to the solution.
The following table lists the parameter names and the information each parameter contains:
Type CALL
CHAT
Note
Supported values are currently lim
ited to: BCM1234, AVAYA5678,
CISCO9876, GEN8923 (Genesys),
SIE5281 (Siemens). Use
CID=BCM1234 for other providers.
call
Inbound
Outbound
UpdateActivity
Transfer
CALL_ALLOCATED
CALL_CONNECTED
CALL_DISCONNECTED
CHAT_ALLOCATED
CHAT_CONNECTED
CHAT_DISCONNECTED
Note
All of these parameters are included in the following extension spot, available in the SDK:
ES_COD_CTI_CALL_HANDLING
Your customer requires that the following data is passed from your CTI solution to their SAP solution:
http://localhost:36729/?
CID=BCM1234&ANI=408-361-3611&DNIS=1-800-455-5555&BP=1000655&SerialNo=XY234567T&Tick
etID=8003456&
ExternalReferenceID=56432156787890&Custom_1=value1&Custom_2=value2&Custom_3=valu31&
Custom_4=value4.
urlparam1 =
“ANI=408-361-3611&DNIS=1-800-455-5555&BP=1000655&SerialNo=XY234567T&TicketID=8003
456&”;
urlparam2 = urlparam1 +
ExternalReferenceID=56432156787890&Custom_1=value1&Custom_2=value2&Custom_3=valu3
1&Custom_4=value4”;
“url = http://localhost:36729/?CID=BCM1234&” + urlparam2;
HttpWebRequest webReq = (HttpWebRequest)WebRequest.Create(url);
HttpWebResponse WebResp = (HttpWebRequest)webReq.GetResponse();
In this example, Urlparam is split into multiple strings only for better readability.
Context
To enable outbound calls, the SAP Cloud for Customer CTI Client Adapter uses the DLL,
CODCTIConnector.dll, which contains a method for handling outbound calls. You must build your own DLL
and in it specify your dial-out logic.
In order to facilitate this process, SAP provides the Microsoft Visual Studio project, CTI Connector. This project
contains the class, OutboundCallHandler, which contains the method, dialOut. The phone number to dial is
passed from the solution (when an agent initiates a call via Live Activity) as the parameter for the method.
Procedure
1. Download the CTI Connector project from the Help Portal product page here: https://help.sap.com/
http.svc/rc/67be88de0bdd4e53b662fae4f15a2b81/1805/en-US/SAPC4CCTIConnectorSetup.zip and
install it.
2. Open the project in Microsoft Visual Studio.
3. Add the logic in the dialOut method to pass the phone number to the CTI solution (see the following
example for details).
4. Build the DLL and deploy it in CTI Client Adapter file structure.
To deploy the DLL, copy the DLL to C:\Program Files (x86)\SAP\SAP Cloud for Customer CTI
Client.
OutboundCallHandler.cs:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.IO;
using System.Runtime.InteropServices;
namespace SAP.COD.CTI.Connector
{
public class OutboundCallHandler
{
Logger logUtil;
//Add constructor to initiate logging
public OutboundCallHandler()
{
logUtil = new Logger();
}
//Destructor
~OutboundCallHandler()
{
logUtil.Close();
}
public bool dialOut(string dialData)
{
logUtil.writeLog(“Dialed number:” + dialData);
//Add the logic to connect to the CTI system here
return true;
}
}
}
>>> MISSING TARGET TEXT FOR TEXT-ID: 'XTXT_a11y_SPExampleEnd' <<<
Top of Page
This feature lets you implement and enable the outbound calling feature in SAP Cloud for Customer.
Prerequisites
Ensure Live Activity Center configuration has appropriate settings for the provider. The provider type should be
CTI Adapter and provider URL field should be left blank.
Context
These instructions are pertinent to customers who have integrated using CTI adapter. (Customers using their
own call system need not follow these steps). Follow these steps to enable the Click to Call feature in the Fiori
client via CTI adapter.
An older version of CTI Adapter (prior to May 2018 release) will not work with Fiori client.
3. Download the CTI Connector project from https://help.sap.com/http.svc/rc/
67be88de0bdd4e53b662fae4f15a2b81/1805/en-US/SAPC4CCTIConnectorSetup.zip on the Help Portal.
4. Extract the zip file and import the project to Microsoft Visual Studio.
5. Open file OutboundCallHandler.cs and add the logic in the dialOut method to pass the phone number and
context information to the CTI solution.
6. Next, save the file and build the project to generate a new SAPCODCTIConnector.dll file.
7. Once the SAPCODCTIConnector.dll file is generated, copy the DLL to: C:\Program Files (x86)\SAP
\SAP Cloud for Customer CTI Client to deploy the DLL.
8. Restart the adapter.
To make outbound calls, you must have a CTI provider such as SAP Contact Center or an equivalent third-party
product.
After you complete this process, end-users will be able to call customers directly from the solution without
having to navigate to another system.
Tasks
Example
If you are using a computer telephony integration (CTI) solution with SAP Cloud for Customer, you can enable
chat integration in the Live Activity pane.
The Live Activity pane provides capabilities to identify the customer by email address. Live Activity works with
integration software running locally on the agent’s desktop. The SAP Cloud for Customer CTI Adapter
software acts as an adapter which communicates information to the Live Activity pane. You can download the
adapter from the Download area within SAP Cloud for Customer.
The CTI Adapter runs a local server on the agent’s system. This acts as a communication bridge with external
CTI solutions. Posting information to CTI Adapter pushes information to Live Activity pane.
A localhost GET/POST request is used to provide information to an agent about an incoming chat.
http://localhost:36729/?
Type=CHAT&CID=BCM1234&Event=CHAT_ALLOCATED&[email protected]&ExternalRefere
nceID=12345678
A localhost GET/POST request can also be used after the chat has ended to post the chat transcript.
http://localhost:36729/?
Type=CHAT&CID=BCM1234&Event=CHAT_DISCONNECTED&[email protected]&ExternalRef
erenceID=12345678&Transcript=<chat message transcript>
The following fields can be passed to the CTI adapter with the GET request:
Type CALL
CHAT
Note
Supported values are currently lim
ited to: BCM1234, AVAYA5678,
CISCO9876, GEN8923 (Genesys),
SIE5281 (Siemens). Use
CID=BCM1234 for other providers.
call
Inbound
Outbound
UpdateActivity
Transfer
CALL_ALLOCATED
CALL_CONNECTED
CALL_DISCONNECTED
CHAT_ALLOCATED
CHAT_CONNECTED
CHAT_DISCONNECTED
Simulate an incoming call in Live Activity with the SAP Cloud for Customer CTI Client Adapter.
Prerequisites
● Download, install, and launch the SAP Cloud for Customer CTI Client Adapter.
● Log on to SAP Cloud for Customer and open Live Activity.
Context
Use the CTI Client Adapter to simulate an inbound phone call to test the connection to Live Activity.
Procedure
1. Open the SAP Cloud for Customer CTI Client Adapter window on your computer.
2. Choose Simulate.
3. Enter the information you want to use for the inbound call or chat in the SIMULATION window.
4. Choose Simulate to simulate an inbound phone call.
The information you entered in the simulation window appears in Live Activity as an incoming phone call.
Live activity Center includes anchors for custom embedded components. You can create custom component
with the Cloud Applications Studio such as softphone controls, mashups, and third party integration.
Set up the solution to use native CTI support, rather than the CTI adapter plug-in.
Context
As of August 2015, you no longer have to use the CTI Adapter plug-in if you are using SAP Contact Center as
your CTI provider. You simply activate CTI integration from Live Activity Configuration.
Procedure
Currently the only provider with embedded CTI support is SAP Contact Center.
4. Enter a unique provider ID.
This is the URL supplied by your CTI provider for you to access the communication system.
6. Choose Save and Close when finished.
Once your solution is configured for native CTI support you must adapt or personalize the UI to enable this
functionality.
Procedure
Procedure
1. Log on in the Silverlight client, or launch in Silverlight from the Adapt menu.
2. Open the Live Activity pane and select Personalize from the pane settings menu at the top right.
When using a widget based integration for external telephony system, we provide you with the following
options.
The following are highlights for external telephony integration with SAP Cloud for Customer:
● Using any of the options is a common approach for any Computer Telephony Integration (CTI) vendor,
which includes SAP Contact Center, Avaya, Cisco, Genesys, and New Voice Media. It is a project-based
Remember
Test the stability of either option before making a choice. CTI vendors provide embedded widgets, and call
handling depends entirely on the capability of the widget. Widget based integration is fairly new and
requires additional testing to ensure its usability.
Related Information
With local adapter integration, calls are handled in a separate Computer Telephony Integration (CTI)
application. You must run the local adapter on the agent's desktop, which is available for download from SAP
Cloud for Customer Downloads section.
With CTI Adapter integration, the adapter communicates with the desk phone. Every agent has to download the
CTI Adapter on their laptop. Our solution provides an empty method in the CTI Adapter that partners would
have to maintain with their end point value. Every time a call comes in or goes out, it gets routed to the end
point (number where the call should go), as defined by the partner.
With CTI Adapter integration, you only see the call display window in the solution.
The adapter based integration is a reliable and tested method, which is available in HTML5 and Responsive UI
environments.
Note
You can use the SAP Contact Center widgets to make both, inbound and outbound calls from our solution.
Widget integration provides you improved call handling function and higher agent efficiency.
We also support other CTI vendor widgets such as: Avaya, Cisco, Genesys, and New Voice Media. Third party
CTI vendor widgets require additional configuration.
Widget integration lets you embed a third party widget into our solution, which provides you a unified call
handling experience.
Prerequisites
Context
Widget integration provides the agent with a smooth desktop experience with call handling in SAP CRM. The
widget integration scenario is better suited for desktop use. You do not have to install local adapter on the
agent's desktop.
Ensure that you maintain the following to enable and use a widget for incoming and outbound calls in our
solution.
1. Maintain URL in the Live Activity Configuration (URL of the third party widget).
2. For incoming calls pass the call signature using window.postMessage(). For outgoing calls third party
vendors should accept our call signatures by listening to our window.postMessage().
In this scenario, the agent handles a phone call and voice streaming via embedded widget.
Note
Voice streaming within embedded widgets uses Web RTC, which has certain restrictions that must be
tested.
When you click on a phone number to start a call, it passes the call parameters to the widget which in turn
makes the call.
Note
You can use voice streaming via laptop. There is no need for a desk phone.
You have the advantage of navigating to any work center and its associated tabs within our solution irrespective
of the live call.
The agent can log in to the widget (hosted on cloud) and can call via widget. No telephone device is necessary.
You can also route the calls to a desk phone via widget. This is the traditional method where the widget
communicates to a desk phone. In this scenario, voice streaming would works via desk phone and not the
laptop.
In this scenario, the widget calls a desk top phone. Voice streaming can occur via desk phone or a separate
application.
Example
If there is a Company A widget and phone, there is no need for a separate CTI adapter. The widget works
like the CTI adapter. The call is made to the widget, which passes call parameters and routes the call to the
phone. Then the telephone device makes the call. The widget parses all signatures to the desk phone or
laptop, and the desk phone is making the call-out or call-in.
● Agent accepts a phone call via embedded widget or a third party phone application.
● Activities such as: Accept or Reject Phone Calls occurs in the embedded widget.
The administrator would have to maintain widget configuration for Live Activity.
Context
Besides integrating with SAP Contact Center (SAP CTI provider) or a third party CTI Adapter, you now have the
option to integrate via widget.
Procedure
This URL is provided by your third party provider for accessing the telephony communication system
within the solution.
Integrate third party widgets with SAP Cloud for Customer solution for inbound calls.
Prerequisites
Configure widget integration settings via Live Activity Configuration. Refer to Configure Widget Integration
[page 369] on steps to configure widget integration.
Context
Integrate third party widgets such as, Cisco, Avaya and others to enable inbound calling within our solution.
Procedure
1. Update your widget to maintain and pass inbound call parameters to SAP Cloud for Customer. Refer to
Context Parameters for Incoming Calls [page 371] for maintaining the inbound call parameters.
2. Specify your Widget URL in Live Activity Configuration settings.
3. Adjust Live Activity display window size. See Configure Dimensions for Live Activity Display Window [page
384] on how to configure the Live Activity display window size.
4. Ensure you select the Display Provider Control flag in Live Activity Configuration to display your widget in
the call display window of our solution.
Results
Example
/**
* construct the payload in XML format
* @param sDestination
* @param sOriginator
* @returns payload in xml format
* @private
*/
c4c.cti.integration.prototype._formXMLPayload = function(parameters){
var sPayload = "<?xml version='1.0' encoding='utf-8' ?> <payload> " ;
for(var key in parameters){
var tag = "<" + key + ">" + parameters[key] + "</" + key +">";
sPayload = sPayload + tag;
}
sPayload = sPayload + "</payload>";
return sPayload;
};
/**
* Send information to C4C
* @param parameters
*/
c4c.cti.integration.prototype.sendIncomingCalltoC4C = function (parameters) {
var payload = this._formXMLPayload(parameters);
this._doCall(payload);
};
/**
* post to parent window
* @param sPayload
* @private
*/
c4c.cti.integration.prototype._doCall = function (sPayload) {
window.parent.postMessage(sPayload, "*");
};
With an incoming phone call, call information is passed to our solution based on certain parameters.
When you click on the incoming call display window, our solution displays the Live Activity Center window with
associated information for that incoming phone number.
In our solution, an incoming call information is passed based on ANI (incoming phone number), Search for
Business Partners such as: Contact, Account, and Individual Customers.
Solution search could identify a unique customer, multiple customers, or may not identify any customer at all.
The following list displays the various parameters passed from the CTI Adapter or Widget for an incoming call.
The system would either call all the properties (mentioned below), or a subset depending on parameters
maintained in the adapter or widget.
Type CALL
CHAT
Note
Supported values are currently lim
ited to: BCM1234, AVAYA5678,
CISCO9876, GEN8923 (Genesys),
SIE5281 (Siemens). Use
CID=BCM1234 for other providers.
call
Inbound
Outbound
UpdateActivity
Transfer
CALL_ALLOCATED
CALL_CONNECTED
CALL_DISCONNECTED
CHAT_ALLOCATED
CHAT_CONNECTED
CHAT_DISCONNECTED
Example
<payload>
<ANI>PHONENUMBER</ANI>
<TicketID>TICKETID</TicketID>
<ExternalReferenceID>EXTERNALREFID</ExternalReferenceID>
<Serial>SERIALID</Serial>
<DNIS>DIALLEDNUMBER</DNIS>
<BP>BPID</BP>
<Custom_1>CUSTOM1</Custom_1>
<Custom_2>CUSTOM2</Custom_2>
<Custom_3>CUSTOM3</Custom_3>
<Custom_4>CUSTOM4</Custom_4>
</payload>
Integrate third party widgets with SAP Cloud for Customer solution for outbound calls.
Prerequisites
Configure widget integration settings via Live Activity Configuration. Refer to Configure Widget Integration
[page 369] on steps to configure widget integration.
Context
Integrate third party widgets such as, Cisco, Avaya and others to enable inbound calling within our solution.
Procedure
Update widget to maintain and accept outbound call parameters from SAP Cloud for Customer. Refer to
Context Parameters for Outbound Calls [page 392] for maintaining the inbound call parameters.
Results
Example
Sample Code
/**
* Initialize the window listener from C4C
*/
c4c.cti.integration.prototype.init = function(){
this._callbackFunction = null;
this._addOnMessageEvent();
};
/**
* add onMessage listner
* @private
if (window.addEventListener) {
} else {
window.attachEvent("onmessage", $.proxy(this._onMessage, this));
}
};
/**
*
* @param evt
* @private
*/
c4c.cti.integration.prototype._onMessage = function(event){
if(this._callbackFunction){
this._callbackFunction(event);
}
}
};
When you make a phone call from the solution, the system triggers several context parameters related to the
phone number that is passed to the Live Activity Center. The Live Activity Center in turn creates a phone call
activity for this outbound call and also passes this information to the CTI adapter or third party widget (based
on which one you've integrated to), embedded in the call display window. This context is used to track the
phone activity and link it to call details such as the call transcript or link to the recording.
When you make a call from a phone number within the system, it gets routed to the adapter or widget, which
has a blank method that should be configured by the partner. Based on what value the partner has configured
in the blank method, the system routes the phone call to the end point (defined by the partner). Click-to-Call
can be made with or without context.
With Context
When the partner defines the blank method, calls are made using all or a sub-set of parameters provided by
our solution (see list below). This indicates that calls are made with context.
The following list displays the various parameters passed to the CTI Adapter or Widget for a call. The system
would either call all the properties (mentioned below), or a subset. This depends on what the system is sending
which in turn is based on where the call originated.
ObjectUUID UUID of the Object from where the call was triggered
ObjectTypeCode Object Type Code from where the call was triggered
ESObjectID Enterprise Search Object ID of from where the call was trig
gered
ObjectThingType Object Thing Type from where the call was triggered
IsBTDRef True if the originating object is linked to the phone call activ
ity
ActivityUUID (this value is based on the business object UUID of the phone call activity created
from where the call is made)
Without Context
When the partner does not define the call parameters, calls are made using a set of three basic default
parameters provided by our solution (see list below). This indicates that calls are made without context.
● PhoneNumber
● LoggedInUserID
● ActivityUUID
The call widget or adapter display window shows information based on the parameter fields maintained by the
customer or partner.
The following are samples of the outgoing call payload options:1. When context is passed, the payload
would consist of the following or a subset of it.
BusinessPartnerID: "1666454",
ObjectID: "4008867",
ObjectUUID: "00163E07C01D1EE7B98941B0821ABD2B",
ObjectTypeCode: "118",
ESObjectID: "COD_SERVICE_REQUEST_ES_CO",
ObjectThingType: "COD_SRQ_AGENT_TT",
IsBTDRef: "X",
Direction: "OUT",
LoggedInUserID: "SOCIALADMIN01",
ActivityUUID: "00163E07C0211ED7BC99F84A3DF7622E"
}
When no context is passed:
LoggedInUserID: "SOCIALADMIN01",
ActivityUUID: "00163E07C0211ED7BC99F84A3DF7622E"
The service agent can make outbound calls directly from the computer telephony integration (CTI) widget
interface within the solution; and can also record the call activity in SAP CRM.
You can initiate outbound calls directly from the CTI widget within the solution. The widget display screen
shows and records the call as an outbound call.
SAP Cloud for Customer does not have a native Computer Telephony Integration (CTI) capability; instead is
able to integrate to other CTI solutions to support service processes.
Note
Scope phone as a communication channel via business configuration to use the phone call feature.
The CTI Client sends phone activity and attached data captured via IVR to our solution in the Live Activity
screen via CTI Client adapter.
Live Activity feature looks up the customer or ticket using the data received and creates a new customer or
ticket. In the incoming phone activity display window you are able to accept, reject, end, or transfer calls via CTI
Client provided by the CTI vendor.
The administrator must enable phone as a communication channel via business configuration to use the call
feature in our solution.
Go to Business Configuration First Implementation Edit Project Scope Service Customer Care
Service Request Management Questions , and select the question: Do you want to support Computer
Telephony Integration (CTI)?
Inbound call integration uses a parameterized URL call from the CTI desktop client to the SAP Cloud for
Customer CTI Client Adapter to pass information like the ANI, DNIS, and CAD to the solution.
Additional parameters can be added to the URL so that extra information can be passed to SAP Cloud for
Customer.
The following table lists the parameter names and the information each parameter contains:
Type CALL
CHAT
Note
Supported values are currently lim
ited to: BCM1234, AVAYA5678,
CISCO9876, GEN8923 (Genesys),
SIE5281 (Siemens). Use
CID=BCM1234 for other providers.
call
Inbound
Outbound
UpdateActivity
Transfer
CALL_ALLOCATED
CALL_CONNECTED
CALL_DISCONNECTED
CHAT_ALLOCATED
CHAT_CONNECTED
CHAT_DISCONNECTED
Note
All of these parameters are included in the following extension spot, available in the SDK:
ES_COD_CTI_CALL_HANDLING
Your customer requires that the following data is passed from your CTI solution to their SAP solution:
http://localhost:36729/?
CID=BCM1234&ANI=408-361-3611&DNIS=1-800-455-5555&BP=1000655&SerialNo=XY234567T&Tick
etID=8003456&
ExternalReferenceID=56432156787890&Custom_1=value1&Custom_2=value2&Custom_3=valu31&
Custom_4=value4.
Example
urlparam1 =
“ANI=408-361-3611&DNIS=1-800-455-5555&BP=1000655&SerialNo=XY234567T&TicketID=8003
456&”;
urlparam2 = urlparam1 +
ExternalReferenceID=56432156787890&Custom_1=value1&Custom_2=value2&Custom_3=valu3
1&Custom_4=value4”;
In this example, Urlparam is split into multiple strings only for better readability.
With an incoming phone call, call information is passed to our solution based on certain parameters.
When you click on the incoming call display window, our solution displays the Live Activity Center window with
associated information for that incoming phone number.
In our solution, an incoming call information is passed based on ANI (incoming phone number), Search for
Business Partners such as: Contact, Account, and Individual Customers.
Solution search could identify a unique customer, multiple customers, or may not identify any customer at all.
The following list displays the various parameters passed from the CTI Adapter or Widget for an incoming call.
The system would either call all the properties (mentioned below), or a subset depending on parameters
maintained in the adapter or widget.
Type CALL
CHAT
Note
Supported values are currently lim
ited to: BCM1234, AVAYA5678,
CISCO9876, GEN8923 (Genesys),
SIE5281 (Siemens). Use
CID=BCM1234 for other providers.
call
Inbound
Outbound
UpdateActivity
Transfer
CALL_ALLOCATED
CALL_CONNECTED
CALL_DISCONNECTED
CHAT_ALLOCATED
CHAT_CONNECTED
CHAT_DISCONNECTED
Example
<payload>
<ANI>PHONENUMBER</ANI>
<TicketID>TICKETID</TicketID>
<ExternalReferenceID>EXTERNALREFID</ExternalReferenceID>
<Serial>SERIALID</Serial>
<BP>BPID</BP>
<Custom_1>CUSTOM1</Custom_1>
<Custom_2>CUSTOM2</Custom_2>
<Custom_3>CUSTOM3</Custom_3>
<Custom_4>CUSTOM4</Custom_4>
</payload>
You can configure the size of the phone activity display window in the Live Activity tab.
Configure the phone activity display window dimensions so you are able to see all displayed information
without using scroll bars.
Simulate an incoming call in Live Activity with the SAP Cloud for Customer CTI Client Adapter.
Prerequisites
● Download, install, and launch the SAP Cloud for Customer CTI Client Adapter.
● Log on to SAP Cloud for Customer and open Live Activity.
Context
Use the CTI Client Adapter to simulate an inbound phone call to test the connection to Live Activity.
Procedure
1. Open the SAP Cloud for Customer CTI Client Adapter window on your computer.
2. Choose Simulate.
3. Enter the information you want to use for the inbound call or chat in the SIMULATION window.
4. Choose Simulate to simulate an inbound phone call.
Results
The information you entered in the simulation window appears in Live Activity as an incoming phone call.
A warm transfer consists of an incoming or outgoing call that gets transferred to other consecutive agents. The
persistent unique Original External ID, and incremental External IDs for each transfer identifies a warm transfer.
Read on to know more about a typical warm transfer scenario.
An agent receives a call from a customer. The system identifies the customer based on the phone number, and
is also able to associate it to the related ticket. The agent is unable to help the customer and transfers the call
to Agent 2 after adding notes to the call activity.
Agent 3 receives the call and is able to see the call context from Agent 2 and Agent 1 in theLive Activity screen.
Agent 3 handles the call and helps the customer.
● confirmed caller
● notes
● linked ticket
Note
Update CTI vendor integration with our solution to be able to pass additional information.
You can view the entire warm transfer flow in the Document Flow tab.
If your organization assigns tickets with an external system you can also receive assignment notifications in the
same way as incoming call notifications.
Organizations that assign tickets with an external system can use an API call to send a notification message to
the assignee.
Notification works with both CTI Adapter integration or third-party widget integration in the same way as a call
or chat is integrated with Live Activity.
When you assign a ticket with notification, the Live Activity notification popup opens displaying the Ticket ID.
When you click the pop-up, the ticket detail view opens for the corresponding ticket.
Sample Code
XML
Sample Code
JSON
{
"payload": {
"Type": "NOTIFICATION",
"ObjectID": "OBJECTID",
"ObjectUUID" : "UUID of the Object"
"EventType":"Push",
"ThingType": "Thing Type of the object"
You can make a phone call from any screen within our solution with the click of a mouse. With CTI integration
enabled, outbound calls also create a phone activity linked to the call.
Example
If the call is made from Ticket Customer phone number, the phone activity is linked to the
corresponding Ticket and Customer.
With CTI integration enabled when making the outbound call, the system can track and link the call with related
information for that phone number.
Example
To display the Live Activity Center screen and search for related objects during the call, click the call status
window (displays during a call).
Note
Remember
● You must have the Live Activity work center assigned to you.
● Enable CTI integration.
The administrator must enable phone as a communication channel via business configuration to use the call
feature in our solution.
Go to Business Configuration First Implementation Edit Project Scope Service Customer Care
Service Request Management Questions , and select the question: Do you want to support Computer
Telephony Integration (CTI)?
You can easily make outgoing phone calls from your system using the Click-to-Call feature via CTI integration.
Note
Note
You must have the Live Activity Center assigned to use the Click to Call feature. This feature is available only
in the Fiori Client.
This feature lets you implement and enable the outbound calling feature in SAP Cloud for Customer.
Prerequisites
Ensure Live Activity Center configuration has appropriate settings for the provider. The provider type should be
CTI Adapter and provider URL field should be left blank.
Context
These instructions are pertinent to customers who have integrated using CTI adapter. (Customers using their
own call system need not follow these steps). Follow these steps to enable the Click to Call feature in the Fiori
client via CTI adapter.
Procedure
An older version of CTI Adapter (prior to May 2018 release) will not work with Fiori client.
3. Download the CTI Connector project from https://help.sap.com/http.svc/rc/
67be88de0bdd4e53b662fae4f15a2b81/1805/en-US/SAPC4CCTIConnectorSetup.zip on the Help Portal.
4. Extract the zip file and import the project to Microsoft Visual Studio.
5. Open file OutboundCallHandler.cs and add the logic in the dialOut method to pass the phone number and
context information to the CTI solution.
6. Next, save the file and build the project to generate a new SAPCODCTIConnector.dll file.
You can configure the size of the phone activity display window in the Live Activity tab.
Configure the phone activity display window dimensions so you are able to see all displayed information
without using scroll bars.
When you make a phone call from the solution, the system triggers several context parameters related to the
phone number that is passed to the Live Activity Center. The Live Activity Center in turn creates a phone call
When you make a call from a phone number within the system, it gets routed to the adapter or widget, which
has a blank method that should be configured by the partner. Based on what value the partner has configured
in the blank method, the system routes the phone call to the end point (defined by the partner). Click-to-Call
can be made with or without context.
With Context
When the partner defines the blank method, calls are made using all or a sub-set of parameters provided by
our solution (see list below). This indicates that calls are made with context.
The following list displays the various parameters passed to the CTI Adapter or Widget for a call. The system
would either call all the properties (mentioned below), or a subset. This depends on what the system is sending
which in turn is based on where the call originated.
ObjectUUID UUID of the Object from where the call was triggered
ObjectTypeCode Object Type Code from where the call was triggered
ESObjectID Enterprise Search Object ID of from where the call was trig
gered
ObjectThingType Object Thing Type from where the call was triggered
IsBTDRef True if the originating object is linked to the phone call activ
ity
ActivityUUID (this value is based on the business object UUID of the phone call activity created
from where the call is made)
Without Context
When the partner does not define the call parameters, calls are made using a set of three basic default
parameters provided by our solution (see list below). This indicates that calls are made without context.
● PhoneNumber
● LoggedInUserID
● ActivityUUID
Example
The following are samples of the outgoing call payload options:1. When context is passed, the payload
would consist of the following or a subset of it.
BusinessPartnerID: "1666454",
ObjectID: "4008867",
ObjectUUID: "00163E07C01D1EE7B98941B0821ABD2B",
ObjectTypeCode: "118",
ESObjectID: "COD_SERVICE_REQUEST_ES_CO",
ObjectThingType: "COD_SRQ_AGENT_TT",
IsBTDRef: "X",
Direction: "OUT",
LoggedInUserID: "SOCIALADMIN01",
ActivityUUID: "00163E07C0211ED7BC99F84A3DF7622E"
LoggedInUserID: "SOCIALADMIN01",
With the ability to store the External ID in a phone activity, you can access additional information on a customer
phone call such as call transcript or a link to the call recording.
With enabled CTI integration, the third party vendor can communicate with customers via phone activity. When
the CTI vendor initiates a phone call, The External ID from the CTI vendor gets populated in the phone call
activity details as a reference. This ID helps identify the phone activity associated with it. Besides the External
ID, the vendor also has the ability to save other details of a phone call such as the call transcript, or a link to the
call recording. Our solution provides you with the ability to store the external ID in the system so the vendor can
recall the phone call activity associated with it.
Required Configuration: To enable the ability to store External ID in phone activity, create a new
communication system using the required fields and update Live Activity settings with the new communication
system ID.
Note
Go to Administration Service and Social Communication Channels Live Activity Configuration , and
enter External ID.
The phone activity UUID value is passed from our solution to the CTI vendors for all outbound calls made within
our solution. This provides you with integration flexibility and ease of use.
The third party CTI vendors can update the phone calls made from our solution with additional information
such as: call transcript and link to the call recording. Additionally, they can use the phone activity UUID value to
update all phone call activities using OData APIs provided by our solution.
Example
The phone activity UUID lets you update a phone call with an end time or URL with the call recording.
Note
The feature works with CTI third party vendors and Widget based integration; and can be viewed in SAP
Fiori Client only.
You can search in the Live Activity display window using the unique customer ID. Additionally, you can store the
External ID for an outbound phone call.
Search by Customer ID
When the service agent clicks on a customer, by default the system searches based on that unique customer
ID, which helps save time by displaying related information for that contact number.
Example
Search results display Customer and Related Tickets for that customer.
Note
The agent can always override this default search parameter with a manual search.
Our solution allows search for both: regular and mobile telephone numbers, which is the default behavior.
The system searches for both, regular and mobile phone numbers, providing higher work efficiency by saving
time and providing better customer identification.
The following table displays the various parameters and contexts used for a call:
Ticket Customer ● Business Partner Caller is identified from The result list displays Ticket and Customer
ID the business partner the related ticket and
Card Overview
● Ticket ID ID caller
● Phone Number
● Enterprise Search
Object ID
Ticket Quick View ● Business Partner Caller is identified from The result list displays Ticket and Customer
ID the business partner the related ticket and
● Ticket ID ID caller
● Phone Number
● Enterprise Search
Object ID
Customer Quick View ● Business Partner Caller is identified from The result list displays Customer
ID the business partner the caller
● Phone Number ID
Contact Quick View ● Business Partner Caller is identified from The result list displays Customer
ID the business partner the caller
● ID
●
●
Lead Overview ● Business Partner Caller cannot be identi No result list displays Lead and Customer
ID fied as the business as lead cannot be
● Phone Number partner cannot be searched on
● Lead ID searched
Phone Activity List ● Phone Activity Caller is searched The result list displays Phone Activity (from
UUID based on phone num based on phone num where call is made)
● Phone Number ber ber search.
* Enterprise Search Object ID in Click-to-Call comprises of object IDs for Account, Contact, Individual Customer, and
Registered Product. When making a call from a ticket, the system uses these search parameters to call up
related information.
A warm transfer consists of an incoming or outgoing call that gets transferred to other consecutive agents. The
persistent unique Original External ID, and incremental External IDs for each transfer identifies a warm transfer.
Read on to know more about a typical warm transfer scenario.
An agent receives a call from a customer. The system identifies the customer based on the phone number, and
is also able to associate it to the related ticket. The agent is unable to help the customer and transfers the call
to Agent 2 after adding notes to the call activity.
Agent 2, receives the call, and can see the notes added by the first agent, the confirmed customer, and linked
ticket in the Live Activity center. Unable to help the customer, Agent 2 takes additional notes and transfers the
call to a third agent.
Agent 3 receives the call and is able to see the call context from Agent 2 and Agent 1 in theLive Activity screen.
Agent 3 handles the call and helps the customer.
● confirmed caller
● notes
● linked ticket
Note
Update CTI vendor integration with our solution to be able to pass additional information.
Live Activity Search in the Fiori client works in the same way for inbound and outbound calls.
When a phone call is passed to the solution, two searches can take place:
1. An automatic search on the ANI information (for inbound calls) is used to display any matching caller
information on the incoming call notification.
2. Default search when the Live Activity Center opens based on information passed by your interactive voice
response (IVR) system.
If they are passed by the IVR system, the default search includes the following parameters:
● Phone number: returns any contacts, accounts or individual customers containing a matching phone
number
● Serial ID: returns any matching registered products
● Ticket ID: returns any matching tickets
Additional information passed from the IVR system appears at the top right of the Live Activity Center. The
default search ignores this additional information.
Note
You can configure the search parameters to exclude Serial ID and Ticket ID.
Select business object types to check for a matching phone number when the system receives an incoming
phone call.
Context
As an Administrator, you can select business objects searched for a match for the caller ID number of an
incoming phone call. This search checks all fields in selected object types for a matching phone number. The
default search only checks the Phone field. Optimize performance by searching only objects relevant to your
business usage.
Customize the search from: Administrator Service and Social Communication Channels Live Activity
Configuration
Contacts
Individuals
Tickets
*Utilities-Contract Accounts
*Utilities-Customer
*Utilities-Point of Delivery
*Utilities-Premise
* These objects are only available for search if you purchased the Utilities Call Center option.
Procedure
1. Choose Search All Fields on the Live Activity Configuration screen to override the default search
parameters and search the object types configured in the table.
2. Edit the Search Objects table to define your search scope.
3. Choose Save when finished.
With an incoming phone call, call information is passed to our solution based on certain parameters.
When you click on the incoming call display window, our solution displays the Live Activity Center window with
associated information for that incoming phone number.
In our solution, an incoming call information is passed based on ANI (incoming phone number), Search for
Business Partners such as: Contact, Account, and Individual Customers.
Solution search could identify a unique customer, multiple customers, or may not identify any customer at all.
The following list displays the various parameters passed from the CTI Adapter or Widget for an incoming call.
The system would either call all the properties (mentioned below), or a subset depending on parameters
maintained in the adapter or widget.
Type CALL
CHAT
Note
Supported values are currently lim
ited to: BCM1234, AVAYA5678,
CISCO9876, GEN8923 (Genesys),
SIE5281 (Siemens). Use
CID=BCM1234 for other providers.
call
Inbound
Outbound
UpdateActivity
Transfer
CALL_ALLOCATED
CALL_CONNECTED
CALL_DISCONNECTED
CHAT_ALLOCATED
CHAT_CONNECTED
CHAT_DISCONNECTED
Example
<payload>
<ANI>PHONENUMBER</ANI>
<TicketID>TICKETID</TicketID>
<ExternalReferenceID>EXTERNALREFID</ExternalReferenceID>
<Serial>SERIALID</Serial>
<DNIS>DIALLEDNUMBER</DNIS>
<BP>BPID</BP>
<Custom_1>CUSTOM1</Custom_1>
<Custom_2>CUSTOM2</Custom_2>
<Custom_4>CUSTOM4</Custom_4>
</payload>
When you make a phone call from the solution, the system triggers several context parameters related to the
phone number that is passed to the Live Activity Center. The Live Activity Center in turn creates a phone call
activity for this outbound call and also passes this information to the CTI adapter or third party widget (based
on which one you've integrated to), embedded in the call display window. This context is used to track the
phone activity and link it to call details such as the call transcript or link to the recording.
When you make a call from a phone number within the system, it gets routed to the adapter or widget, which
has a blank method that should be configured by the partner. Based on what value the partner has configured
in the blank method, the system routes the phone call to the end point (defined by the partner). Click-to-Call
can be made with or without context.
With Context
When the partner defines the blank method, calls are made using all or a sub-set of parameters provided by
our solution (see list below). This indicates that calls are made with context.
The following list displays the various parameters passed to the CTI Adapter or Widget for a call. The system
would either call all the properties (mentioned below), or a subset. This depends on what the system is sending
which in turn is based on where the call originated.
ObjectUUID UUID of the Object from where the call was triggered
ObjectTypeCode Object Type Code from where the call was triggered
ESObjectID Enterprise Search Object ID of from where the call was trig
gered
ObjectThingType Object Thing Type from where the call was triggered
IsBTDRef True if the originating object is linked to the phone call activ
ity
ActivityUUID (this value is based on the business object UUID of the phone call activity created
from where the call is made)
Without Context
When the partner does not define the call parameters, calls are made using a set of three basic default
parameters provided by our solution (see list below). This indicates that calls are made without context.
● PhoneNumber
● LoggedInUserID
● ActivityUUID
The call widget or adapter display window shows information based on the parameter fields maintained by the
customer or partner.
Example
The following are samples of the outgoing call payload options:1. When context is passed, the payload
would consist of the following or a subset of it.
BusinessPartnerID: "1666454",
ObjectID: "4008867",
ObjectUUID: "00163E07C01D1EE7B98941B0821ABD2B",
ObjectTypeCode: "118",
ESObjectID: "COD_SERVICE_REQUEST_ES_CO",
IsBTDRef: "X",
Direction: "OUT",
LoggedInUserID: "SOCIALADMIN01",
ActivityUUID: "00163E07C0211ED7BC99F84A3DF7622E"
LoggedInUserID: "SOCIALADMIN01",
ActivityUUID: "00163E07C0211ED7BC99F84A3DF7622E"
For incoming or outbound calls, when you click the call activity display window, the Live Activity Center screen
displays. You can perform some tasks in this screen.
Search Results:
Based on the defined parameters, the search results display all associated information for that specific phone
number.
The agent can confirm a customer by clicking the icon. This means that the customer becomes the default CTI
Customer.
Note
You can click on the phone call link symbol to link to that specific ticket. The Linked Ticket ID displays in the Call
Information section.
Note
Notes:
New:
From the Live Activity Center screen, you can create a new Ticket, Individual Customer, Contact, or Account.
As a service agent, you can revert back to the default search result any time.
When you click to display the Live Activity center from an incoming call, the system displays an information list
based on associated information for that telephone number. Based on your need, you may search for other
information in the Live Activity center Search field. However, you always have the option to go back to the first
search result displayed by the system. The Reset Default Search tooltip for the icon next to the Search field, lets
you go back to the system displayed search result.
Live Activity Center provides you with the option to identify customers for incoming calls by using custom logic
with BAdI Exits.
You can override the default search for caller identification and implement your own logic to identify the caller.
From there the process is similar to a regular phone call.
For a phone call activity, the system uses the caller returned by the defined BAdI logic instead of default search.
Namespace: http://sap.com/xi/AP/FO/Activity/Global
Sample Code
/*
Add your SAP Business ByDesign scripting language implementation for:
Enhancement Option: CTICustomerIdentification
Operation: CUSTOMER_IDENTIFICATION
Note:
- To use code completion, press CTRL+J.
*/
import AP.FO.Activity.Global;
/*
InputData.ANI;
InputData.BusinessPartnerID;
InputData.CustomField1;
InputData.CustomField2;
InputData.CustomField3;
InputData.CustomField4;
InputData.CustomField5;
InputData.CustomField6;
InputData.DNIS;
InputData.ExternalReferenceID;
InputData.PhoneActivityUUID;
InputData.SerialNumber;
*/
return result;
Use a BAdI exit to configure different CTI providers for widget-based integration in the Fiori client.
Administrators maintain the widget URL and other related properties on the Live Activity Configuration screen.
The BAdI : "CTI_WIDGET_URL", allows you to overwrite the default configuration maintained in Live Activity
Configuration to influence the widget details at runtime. This BAdI is triggered only once, when the user logs in.
Based on the output from the PDI, the widget and call popover are loaded. The BAdI is not called again until the
user logs in again or reloads the browser.
Namespace: http://sap.com/xi/AP/FO/Activity/Global
PROVIDER_ID This parameter does not influence any behavior in the Live
Activity Call flow.
PROVIDER_URL Widget URL - loaded in the call popover for call handling
DISPLAY Display Provider Control flag. If this is true ("X"), the provider
control is shown in the call popover. If false (" "), the provider
control is hidden.
Sample Code
/*
Add your SAP Business ByDesign scripting language implementation for:
Enhancement Option: CTICustomWidgetConfig
Operation: UPDATE_WIDGET_DETAILS
Note:
- To use code completion, press CTRL+J.
*/
import AP.FO.Activity.Global;
Customers can send a text message to your company support number and trigger the following actions:
● Create a ticket
● Provide additional information about a ticket
As a service agent, you can respond to the SMS messages associated with a ticket.
To use messaging as a communication channel for creating and responding to customer service tickets,
administrators must scope Messaging via Business Configuration.
Go to Business Configuration Edit Project Scope Sales Account and Activity Management Activity
Management Questions , and select to enable the Activity Types question: Do you want to record
messaging activity?.
With this setting, incoming SMS messages automatically generate a new ticket, or are appended to an existing
open ticket. In addition, an individual customer profile is generated from the sender phone number if the phone
number is not matched to any existing customers or account contacts.
Administrators can set up your SAP Cloud for Customer system to include messaging services, such as SMS,
as communication channels for creating and responding to customer service tickets.
Each time a customer sends a text message to a specified routing number (short code), a ticket is created and
routed to a team, or agent queue based on the defined rules.
Note
Due to the nature of SMS messaging, SMS channels are supported for individual customers only; and not
for accounts.
Follow the tasks described in the following topics to configure SMS channels.
Administrators can create a new communication system and maintain the required details.
Note
Activate the new communication system and make note of the system ID that you would have specify when
creating the communication arrangement.
The Administrator would create a new communication arrangement with Messaging Service as the
communication scenario.
● The System Instance ID under Define Business Data would be the same as the one you entered when you
created the communication system.
● Under Define Technical Data, click Edit Credentials, and maintain a password for the system ID. Make a note
of this user ID and password, as you would have to provide this information to the gateway provider to
obtain the routing numbers, also known as short codes.
The administrator would have to provide the gateway provider with inbound and outbound endpoint URLs who
would require them to provision the short codes.
● The inbound endpoint URL, which would be used by the gateway provider for posting incoming SMS
messages. This is a REST web service call, via HTTP Post method. Basic Authentication is required while
making this REST call.
Example
https://my1234.sapbydesign.com)/sap/ap/srt/rest/sap/II_CODCRM_SRQ_FROM_MS_ACT_IN/sap/
PROCESS_MESSAGING_SERVICE/
● User ID and password that you maintained when you set up the communication arrangement.
Request your gateway provider to supply an endpoint URL for outbound SMS messages.
The administrator would have to create a mashup web service to reply to inbound SMS messages.
Go to Administrator Business Flexibility Mashup Web Services . Maintain the following when creating a
new mashup web service:
● If you are using SAP SMS 365 as the gateway provider, choose New and select Rest Service. Other gateway
providers may use a different type of service.
● The solution only supports the POST method with an XML Body payload.
● In the General Information area, enter the service name, and set the status to active.
● In the Service Information area, enter the required parameters based on the API properties of the gateway
provider. It would include the outbound endpoint URL, and the following hash tags and square brackets as
place holders that would be replaced by the actual parameters:
○ [#SUBJECT]
○ [#PHONE_NUMBERS]
○ [#MESSAGE]
○ [#SHORTCODE]
● In the case of SAP SMS 365, the gateway utilizes body XML format, which, when properly formatted
appears as follows:
Version=2.0
Subject=[#SUBJECT]
List=[#PHONE_NUMBERS]
Note
If UTF8 encoding is not needed, remove this tag from the payload. Do NOT set EncodeUTF8 to FALSE.
The following is an example of an XML body payload for SAP SMS 365 with UTF8 encoding enabled:
Version=2.0
Subject=[#SUBJECT]
List=[#PHONE_NUMBERS]
Text=[#MESSAGE]
SplitText=YES
OriginatingAddress=[#SHORTCODE]
DCS=UTF8
EncodeUTF8=TRUE
Note
Make a note of the Service ID number the system assigned to this service. Enter the service ID when you
set up your messaging channels.
Maintain the Channel ID, Channel Name Short Code, Ticket Type (default ticket type would be used if not
maintained), and Ticket Options.for this channel. Enter the mashup service ID you noted in the previous task
for outbound messages from this channel.
Specify the ID of the mashup service you configured for your gateway provider.
You can use business communication monitoring to verify whether SMS messages have been transmitted
successfully or not. If technical errors occur, they can be identified and resolved to prevent problems in follow-
on processes or with your business partner
SAP Cloud for Service can integrate third-party chat solutions to support service processes.
Once chat is integrated with your solution your customers can interact with you in the following ways:
● Send a message on social media or via email. The service agent responds with a chat URL and requests the
customer to enter the chat.
● Click a chat link to chat with the service agent currently processing the customer ticket. At the end of the
chat, the ticket is updated with the chat transcript.
Example
Your customer, Christina, is browsing your company web pages looking for support. She finds the chat button
and selects it. An initial information form displays asking for her name, email address, subject/topic, and other
optional fields. Christina enters her information in all the required fields. Then the system adds additional
information for you, the agent, who will be helping the Christina, and sends this to the agent or processor with
the appropriate skill set. You, the service agent, send Christina a URL to begin the chat session. She then sees
the welcome prompt for chat.
Note
Depending on your system configuration, the chat transcript may be available to you after the live chat has
ended in the ticket interactions.
Restriction
The transcript does not include emoji that appear in the chat.
Administrators would have to configure and enable a Chat Provider as a communication channel.
Context
Enable and add Chat as a communication channel to route and respond to tickets.
Procedure
Fields Description
Channel ID Any ID
Set up a support portal using either SAP HANA Cloud Portal or an external support portal provider.
For Customer Service you could set up a support portal using either SAP HANA Cloud Portal or an external
support portal. However, for Employee Support, in addition to above options, you can also use the ASKHR
solution from Employee Central.
A support portal enables your customers or employees to create and update tickets in SAP Cloud for Customer
using a browser-based interface.
Note
For setting up Support Portal, see documentation for the topic Setting up Your Partner Portal in the
related information section.
Set up a support portal for customers or employees to create and update tickets.
Enable your customers and employees to report incidents and create support requests with a web-enabled
portal based on SAP HANA Cloud Platform.
Note
● The portal site template is responsive - designed to run on mobile and desktop browsers
● No configuration necessary on your SAP Cloud for Customer system - Integration via oData APIs
● Fully customizable solution - incorporate your own branding
● Use example widgets as-is, or adjust as needed for your implementation
● Template files, full instructions, and optional widgets available for download on Github.
Support rich text content, images, and extension fields in tickets created from self-service portals.
Your organization maintains a website that enables your customers to create service requests. These requests
must support both rich text capabilities and extension fields. SAP Service Cloud now supports these customer-
generated tickets with a series of enhancements:
● New business activity type: Memo. Use the memo activity to capture content entered on the website. The
data is then transferred to the ticket object.
● Memo list view and detail view
● Interactions – display memo activities in list view with rich text content and extension fields
● Response Editor – supports rich text content
The Memo activity is ideal for new customers starting a new implementation. If you already use portal
capabilities, once you start using the new Memo activity, the data is stored in the Memo Activity and not
directly in the Ticket. You can roll out the Memo activity to your users and consider it for your reporting use
cases.
Once you enable memo activities, you cannot switch back to the previous method of creating portal tickets.
Therefore, we recommend that you start with your test tenant to check if the memo activity meets all your
requirements. To enable the memo activity in your solution, create an incident requesting that SAP enable
memo activities for portal tickets.
The depersonalization function allows you to remove personal data from a business object to ensure
compliance with the applicable data protection requirements. Depersonalization is only available for users with
access to the Data Protection and Privacy work center.
The following table displays delete or depersonalize functions available for different communication channels:
Chat Yes
Messaging Yes
Learn about sales and service contracts which allow you to quickly create and maintain agreements, maintain
contracts header, item, and covered objects, as well as create contracts from opportunities and sales orders.
Note
Administrators and end-users will find details for both service and sales contracts in this solution guide.
Any pertinent details that apply strictly to service contracts or solely for sales contracts will clearly
identified. This document in available in both the Solution Guide for SAP Cloud for Sales as well as the
Solution Guide for SAP Cloud for Service.
With service contracts you can manage customer support agreements between you and your customers for
items according to the warranty coverage. With the solution you can track details about the type of support
that your customers are eligible for as long as the customer has an active contract. Your contract
administration team will define the contract details, such as entitlements (for service contracts), limited
products, and pricing. In addition, depending on the contract template, other details such as support coverage
based on hours, service level agreements (SLAs), as well support types may also be included in the contract.
Use sales contracts to determine contracts for quantity sales contracts with SAP ERP integration and contract
determination on item level for quotes and orders. One of the principle features of sales contracts includes bi-
directional quantity sales contract integration with SAP ERP. In addition, with sales contracts, contract
determination on item level for orders and quotes is also available.
The Contracts work center supports you in creating service and sales contracts based on the required details
as well as displaying overview details about active contracts. As soon as you have finalized a contract with a
customer and it is active, the contract is determined during ticket creation and automatically added to the
ticket. If the contract contains SLAs (service level agreements), you will see them after the determination in the
ticket.
As a manager, with contract analysis you can view and analyze contract data such as, contract items, contract
value, release history, and more.
Administrators can configure service and or sales contracts using scoping, scoping questions, and fine-tuning
activities.
Administrators can configure sales contracts using scoping, scoping questions, and fine-tuning activities.
Go to Business Configuration Implementation Projects Edit Project Scope Scoping Sales New
Business Sales Contracts Business Option: Sales Contracts Questions. Place a checkmark in the
desired sections and save your entries.
Administrators can create custom document types to streamline filtering, define reports, or facilitate
assignments.
Administrators set-up documents types for sales and service contracts to enable data exchange with external
applications such as SAP ERP. Some standard document types are delivered by the solution. Administrator can
create document types that are transferable to SAP ERP configured as External Data in the solution.
Go to Business Configuration Implementation Projects Your Project Open Activity List Fine-Tune
Opportunities Document Types Maintain Document Types to edit your opportunity types.
Administrators can define quote, sales and service contract document types for SAP ERP with SAP Cloud for
Customer quotes, sales, and service contracts.
The fine-tuning of Document Types allows multiple settings for SAP ERP integration. You can leverage each
document type as a special business scenario/use case. Depending on your requirements, you can create
multiple document types for your desired business scenarios.
Go to Business Configuration Implementation Projects Your Project Open Activity List Fine-Tune
Activity Name: Sales Contracts, Service Contract, or Sales Quotes Document Types Maintain Document
Types. Select your Document Type and modify it to your business solution requirements.
External Pricing – A check in the box enables an external application such as SAP ERP, synchronously requests
prices. The transaction simulation determines not only pricing, but sales quotes, free goods, product
availability, and credit status based on SAP ERP customizing for this document type. From SAP Cloud for
Customer, you trigger the external application, by clicking Action Request External Pricing.
Replication – Administrators define the sales quote and the sales and service contract transfer behavior from
your SAP on-premise system to your cloud solution by selecting one of the following options:
● Bi-directional – Sales quote edits in your cloud solution are replicated to your SAP on-premise system,
syncing both quotes.
Remember
Your SAP on-premise system is the leading system for these sales quotes, sales, and, service contracts.
Quotes created in your cloud solution can be replicated to your SAP on-premise system from Action
Submit. Quotes created in SAP ERP can be edited in SAP Cloud for Customer and the changes are
replicated in SAP ERP.
● Inbound – Quote edits completed in your cloud solution are not replicated to your SAP on-premise system.
Those quotes are overwritten if further replications are triggered from your SAP on-premise system.
Note
We recommend that you control editable fields and actions from the page layout and only open
extension fields that do not require replication. (Creation of the sales quote is only possible in SAP ERP
and changes performed in SAP Cloud for Customer are not sent to SAP ERP).
● Empty – Leaving this field blank indicates the sales quote stays in SAP Cloud for Customer, but this option
still allows you to request external pricing.
Note
This configuration only applies to new sales quotes as well as sales and service contracts. Existing sales
quotes and sales and service contracts behave using the inherited document type configuration. Existing
sales quotes and sales and service contracts behave as specified from the previous active document type
configuration.
Asynchronous Pricing – Administrators can modify the settings for external pricing. A synchronous call is
required to retrieve the complete pricing result from the SAP on-premise system to your cloud solution.
With this configuration, if the document was previously replicated, administrators can disable the synchronous
pricing call to the external system. In addition, you can disable the synchronous call completely, which is valid
for quotes created in your cloud solution. For both configuration options, the pricing status needs to be
calculated successfully through the asynchronous call from the external system. Select the option that suits
your business needs.
● Empty – Leaving this field blank triggers an automatic (once replicated) synchronous pricing call activation
(You see pricing-related errors, but configuration has performance impacts.).
● After replication – If document was replicated successfully, an automatic synchronous pricing call is
deactivated.
● Always – An automatic synchronous pricing call is always deactivated (leads to a performance advantage,
but possible pricing call error messages are no longer displayed directly in the UI, only asynchronously). No
matter the configuration, you can trigger pricing synchronously by clicking Action Request External
Pricing. With this configuration, avoid quote approvals that include external pricing elements.
Note
To avoid data inconsistencies between SAP ERP and SAP Cloud for Customer, only replicated contracts are
used in tickets.
Remember
Only new and sales and service contracts and sales quotes inherit changes in the document type
configuration. Existing contracts and sales quotes behave as specified in past active document type
configuration.
Administrators can explore and learn how to define contract item types.
Item types determine how an item category behaves in a contracts. Item item types are not necessary, but are
relevant if you replicate quotes with an on premise system and administrators should remember to configure
document types.
You can define alternative item types for the item types delivered in the standard solution. These alternative
item types are then displayed for the corresponding items under the Products tab for contracts. You can use
these custom item types to process items based on SAP ERP item categories. You can also use item types for,
in order simulations to retrieve external pricing.
1. To quickly navigate to the fine-tuning activity, go to Business Configuration Overview Sort by:
Activities Search and type Sales Quotes.
2. Click Contracts Item Types Maintain Item Types .
3. Click Add Row.
4. Enter the desired details and save your entries.
If you want to define an item as a free sample or free good that should not affect pricing, flag it as Not
Relevant for Pricing. When an item that is not relevant for pricing is added to a quote, it does contain a price.
However, you can still add a price for this product manually.
As an administrator, you can configure the sales area defaults for service and sales contracts.
Configure Sales Area Defaulting for service contracts by navigating to Business Configuration
Implementation Projects Edit Project Scope Questions Service Entitlement Management Service
Contract Management Business Option: Sales Area Determination for Contracts.
Configure Sales Area Defaulting for sales contracts by navigating to Business Configuration
Implementation Projects Edit Project Scope Questions New Business Sales Contracts Business
Option: Sales Area Determination for Contracts.
Administrators can configure multiple document and item types for contracts.
To edit involved parties, go to Business Configuration Implementation Projects Your Project Open
Activity List Fine-Tune Service Contracts Item Type Determination Rules Maintain Item Type
Determination Rules for Contracts .
Administrators can maintain involved parties for different types of items, such as leads or activities. In this step,
you can assign party roles and use determination rules for involved parties.
To edit involved parties, go to Business Configuration Implementation Projects Your Project Open
Activity List Fine-Tune Sales Contract Item Types Involved Parties Maintain Involved Parties.
Explore how administrators can activate or deactivate determination steps for your party roles for sales
contracts.
1. Go to Business Configuration Activity List Service Contracts (or Sales Contracts) Maintain Involved
Parties .
2. Go to Party Role Account.
3. Click Maintain Determinations.
4. Flag the determination steps.
5. Save and activate the desired determination.
Administrators can configure active contract determination based on contract validity criteria for requested
dates in related tickets.
Configure this option by navigating to Business Configuration Edit Project Scope Questions Service
Customer Care Service Request Management Group: Entitlement Usage for Service Requests. Place a
check mark for question Do you want to determine activated service contracts, based on the contract validity
period at the time of the requested date in the ticket?
The following use cases are relevant when your business requires date considerations for future and past
tickets.
Future tickets are ones you create with a future request date. Contracts, which are currently in Ready status,
can be determined by ticket creation. A typical use case is tickets created in advance by maintenance plan. The
determination occurs if the status is Active at the requested future date of the service work ticket.
Administrators need to configure number ranges to define the range of numbers assigned to sales and service
contracts.
Learn how to set up usage restrictions for contracts to limit coverage based on additional criteria.
If you want to automatically restrict contracts to certain ticket types the first step is to create usage restrictions
in the Contracts fine tuning activity.
Upgrade, downgrade, or hide the severity level of errors and warnings for contracts.
You can configure message severity using the sales or service contract fine-tuning activity in the following
location: Business Configuration Implementation Projects First Implementation Project Open Activity
List Fine-Tune Sales Contracts (or Service Contracts) Message Severity Configuration.
When a covered object is maintained at item level, this contract item is only determined if this covered object
was set as reference object (in a ticket).
Configure this option by navigating to Business Configuration Edit Project Scope Questions Service
Entitlement Service Contract Management Group: Covered Objects on Item Level . Select the Do you want
to work with covered objects on an item level? question.
Administrators can configure the release authorized party for sales and or service contracts.
Go to Business Configuration Activity List Service (or Sales) Contracts Involved Parties and click
the Active flag to activate Authorized Party. Next, in the Involved Parties tab, add the customer which is the
authorized party.
Administrators can learn how to configure contract determination in tickets by scoping the system to
determine the search strategy.
Navigate to Business Configuration Edit Project Scope Questions Service Customer Care Service
Request Management Group: Entitlement Usage for Service Requests. .
Select the Do you want to determine contracts in tickets (disregarding customer account) based only on
Registered Products or Installation Points as reference? question.
Open a contract and navigate to Attachments, click Add to view the list of attachment types.
Administrator can configure contract types and usage restrictions based on additional criteria such as ticket
type.
You can create different contract document types with restricted coverage based on the context they are used
in. You can associate specific contract types with specific ticket types to auto assign the appropriate contract
for a ticket type.
Users can specify usage restrictions for each contract item. When a user creates a work ticket, the system
automatically applies the specified usage restrictions based on the ticket type.
Learn how to set-up item processing codes used for quantity contracts.
Context
Item processing codes are essential when working with quantity contracts. They determine how items (and
their related products) are handled in the following business process. Specifically if there is an increase,
decreases, or no impact in ticket items. Follow the steps below to set-up item processing codes for your
business.
Procedure
1. 1. Navigate to Business Configuration Open Activity List Fine-Tune Show All Activities Tickets for
Customer Support Maintain Item Processing Codes.
2. Select Add Row.
3. To create item processing codes, populate the required fields.
4. Save your entries.
You configure payment terms in the solution, based on company business needs. Payment terms define when
an invoice must be paid, and whether a discount is applicable, depending if payments were made within the
agreed upon time period.
Configure payment terms for contracts by navigating to Business Configuration Implementation Projects
Open Activity List Fine-Tune Find: Accounts Payment Terms Maintain Payment Terms.
● Contracts Header, view the Payment Terms. Click the dropdown to select the correct payment term.
● Contracts Items tab, view the payment section in General Data. Click the dropdown to select the correct
payment term.
General availability has been made for administrators to configure contract item determination to use in offline
mode. Navigate to Business Configuration Edit Project Scope Questions Service Customer Care
Service Request Management and place a check mark for question Do you want to determine contract
items for tickets in offline mode?
Administrators can use the Data Workbench to modify sales and service contract types even after they are
created.
Administrators can configure a restriction so that business role users cannot perform Excel exports for service
and sales contracts.
Configure Excel export authorization restrictions by navigating to Administrator Business Roles Select
role (that includes the Contracts work center) Fields & Actions Business Actions Restrictions Add row
and search for Microsoft Excel.
The depersonalization function allows users to remove personal data from a business object, such as
contracts, to ensure compliance with the applicable data protection requirements.
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.
Remove personal data in contracts by navigating to Contracts All Contracts (or select desired contracts
Actions Depersonalize.
Users can create a contract and add details such as name, service level, dates, and involved parties. Additional
details such as covered objects, items, pricing, are added in their respective sections in the contract.
You can create the contract, request pricing, and send it to the customer for review before activating it upon
receipt of the customer’s signature. Further details such as covered objects, items, pricing, are added in their
respective sections in the contract.
As long as contracts are in negotiations, such as an internal or external review process with customers, the
contract status will remain with status In Preparation, meaning the contract is created but not ready to be used
in service tickets.
You also have the option to select from existing contract templates which were are usually created by your
contract administrator or manager. As an end-user, the contract template will help you save time by pre-
populating fields especially for standard customer contract requests.
Some companies only have a fixed (standard) number of contracts with a defined portfolio of services in their
market offering. Therefore, customized contracts won’t be created and the contract representative will select
one of the company’s standard contracts.
Note
If you enter a serial ID, the corresponding product is added automatically. You can also use the value
help to search for the serial ID or you can register it. To register a product select New Registration from
the value help.
4. Select Add and the customer’s desired product (covered object) are appended to the contract.
Note
Depending on how the product item was created in the solution, details such as the serial ID, registered
products, product category, will be automatically populated in the contract fields.
When adding product items to a covered object, select the Product Value Selection Show
Advanced Filter from the Products tab. This allows you to quickly filter filters such as Product
Category ID and Product Category Description.
5. Navigate to the Itemstab to assign for example, an entitlement product ‘Extended warranty’ for the
previously added covered object.
Note
In this case, a product ‘Extended Warranty´ has been added as a contract item. The desired warranty
for example, ‘Warranty 50%’ is automatically added.
6. Assign an entitled services & parts product, for example ‘Repair Hours'.
Note
This agreement gives the customer the right in case of an incident (within contract validity) to raise a
claim of a 50% discount for all of the repair hours required to fix the product issue.
Administrators can explore and learn how to define contract item types.
Item types determine how an item category behaves in a contracts. Item item types are not necessary, but are
relevant if you replicate quotes with an on premise system and administrators should remember to configure
document types.
You can define alternative item types for the item types delivered in the standard solution. These alternative
item types are then displayed for the corresponding items under the Products tab for contracts. You can use
these custom item types to process items based on SAP ERP item categories. You can also use item types for,
in order simulations to retrieve external pricing.
1. To quickly navigate to the fine-tuning activity, go to Business Configuration Overview Sort by:
Activities Search and type Sales Quotes.
2. Click Contracts Item Types Maintain Item Types .
3. Click Add Row.
4. Enter the desired details and save your entries.
Note
If you want to define an item as a free sample or free good that should not affect pricing, flag it as Not
Relevant for Pricing. When an item that is not relevant for pricing is added to a quote, it does contain a price.
However, you can still add a price for this product manually.
As an administrator, you can configure the sales area defaults for service and sales contracts.
Configure Sales Area Defaulting for service contracts by navigating to Business Configuration
Implementation Projects Edit Project Scope Questions Service Entitlement Management Service
Contract Management Business Option: Sales Area Determination for Contracts.
Configure Sales Area Defaulting for sales contracts by navigating to Business Configuration
Implementation Projects Edit Project Scope Questions New Business Sales Contracts Business
Option: Sales Area Determination for Contracts.
Administrators need to configure number ranges to define the range of numbers assigned to sales and service
contracts.
Upgrade, downgrade, or hide the severity level of errors and warnings for contracts.
You can configure message severity using the sales or service contract fine-tuning activity in the following
location: Business Configuration Implementation Projects First Implementation Project Open Activity
List Fine-Tune Sales Contracts (or Service Contracts) Message Severity Configuration.
Create contracts using templates, which automatically populate data in selected fields.
Context
Procedure
Note
The contract type (sales or service) is defaulted and equal to the type applied by the user in the last
contract setup.
Note
You can create contracts directly from the opportunity and some relevant details are copied to the contract. If
desired, you can bypass creating an opportunity and create a contract (proposal) directly.
Context
In some cases, a customer might during their decision and proposal process inquire about a service contract
before purchasing it which is why an opportunity is created for a contract.
For the companies providing contracts, opportunities are an indispensable prerequisite for calculating the
company revenue forecast.
Procedure
Create a related contract by copy everything into a new contract except the contract ID, external reference,
signed on, begins on, ends on and internal comment.
Context
Related Contracts are associated and processed, for example, in contract renewal process.
Procedure
1. Go to Contracts and open the contract from which you want to create the related contract.
2. Go to Related Contracts tab and choose New.
3. Enter the entries, such as Signed On, Begins On, and Ends On.
4. Save the entries.
Users can assign one territory to a contract, as well as search for and display territory changes in contracts.
To assign a single territory to a contract (noting that only one territory per contract is allowed),
Note
Follow the procedures to define a realignment run for contracts and territories.
Learn how to maintain access context for the Contracts work center.
1. Open the business role by clicking the work center Administrator General Settings Business Roles
and select the hyperlink of the business roles you want to assign an access context to.
2. Click the Access Restrictions tab.
3. Select the CONTRACT_WCVIEW assign territory access context to it.
4. In the Read Access field, select Unrestricted or Restricted.
Note
Choosing Unrestricted means that the user has access to all business data related to the tab. Choosing
Restricted means that the user only has access to specific business data, depending on the access
context.
Note
Not every work center tab has access context that can be modified.
From the Restriction Rule dropdown, select the desired rule for the contract work center tab:
Note
Choose only No Access if the Write Access has been set to Restricted and this selection means that the
user has no write access to the work center tab.
7. If you choose to restrict the Write Access, from the Restriction Rule dropdown, select the desired rule you
wish to restrict.
Once users have created contracts, they can modify contract details such as updating or adding the involved
parties, covered objects, billing plan, customer call notes, as well as assigning territories assignment. When
working with contracts, users benefit from the basic and advanced search to easily query contracts.
Copy and Paste Product Mass Entries in Service Contracts [page 443]
Users can can copy items from Excel using the copy and paste function in the product table.
Users can maintain involved parties on header level and item level.
1. From the Products tab, use personalize or adapt to add Item Involved Parties.
2. Administrators must go to fine-tuning activity Sales Quotes Involved Item Parties .
3. Party roles on item level are copied from header parties. If you do not need party roles for reporting or
follow-up processes, we recommend deactivating them in the item party schema.
Note
Ship-to parties are maintained in the sales quote product table. Please keep the activation in the item
schema in case a copy and follow-up action should also copy the item party.
Open a contract and navigate to Attachments, click Add to view the list of attachment types.
Create a contract for an account. In the contract header, set the flag Include Authorized Parties. Next you can
add the party role Authorized Party.
Note
When working with contracts in accounts, users can set up details that consider account hierarchies for
contracts.
Learn how configure and use the determine customer for ship-to party roles in account relationships for
contracts.
Remember
Administrators need first maintain involved parties. Go to Business Configuration Activity List
Service (and or Sales) Maintain Involved Parties . Go to party role account and click Maintain
Determinations and flag the determination steps for the account.
Follow the steps to determine customer for ship-to party roles in account relationships for contracts.
Administrators can learn which party roles can be activated or deactivated for contracts with territories.
Territories can be considered for party determination for the following roles:
Note
1. Navigate to the Fine-Tune party role Service Contracts Maintain Involved Party Party Role
Assignment.
2. Click Add Row.
Note
Note
You can only remove custom party roles from your party schema. Removal of the Activate flag can be
used as an alternative.
Note
Only active party roles appear in the Involved Parties value help.
You can explore the types of items used in contracts, how to structure and renumber contract items, as well as
add contract items from templates.
When covered objects are maintained at item level, the contract item will only be determined if this covered
object was set as reference object (in a ticket).
If there is no entry for a covered object on item level, this contract item can also be determined. The
determination is then derived from either the covered objects of the next higher item level or by the covered
objects stored on header level.
If you don’t maintain covered objects on header and on item-level, then all objects are covered.
Example
● Contract Gold
○ Covered objects tab (Header Level): [Covered Objects] A, B, and C
In SAP ERP there are covered objects (internally known as technical objects) only on item level. To be
compatible, we recommended a design the cloud contract as follows:
In SAP ERP, the logic is: no technical object assigned on contract item level implicates the contract item is valid
for all technical objects.
You can maintain a covered object for an item in a contract and also remove one or more covered object for an
item in a contract. Highlight the items you wish to remove, and then select More Remove .
You can search for contracts using the Contracts list table. This query searches for covered objects at the
header or item level. Other functions include:
● Copy: When users copy a contract, the covered objects maintained at item level are also copied.
● Change: Any modifications to covered objects on item level (including creation, modifications, and or
removal) are displayed in the contract Changes tab.
When covered objects are maintained at item level, the contract item will only be determined if this covered
object was set as reference object (in a ticket).
If you don’t maintain covered objects on header and on item-level, then all objects are covered.
Example
● Contract Gold
○ Covered objects tab (Header Level): [Covered Objects] A, B, and C
○ Items tab
Line 10 Extended Warranty - Covered Object tab: >no entry< [= ´A´, ´B´ and ´C´ are covered]
○ Item 20 Extended Support Covered Objects tab: >´A´<
[= [only] product ´A´ is covered]
○ Item 20-10 (subset) Covered Object tab: ´no entry´
[= [only] ´A´ is covered
In SAP ERP there are covered objects (internally known as technical objects) only on item level. To be
compatible, we recommended a design the cloud contract as follows:
In SAP ERP, the logic is: no technical object assigned on contract item level implicates the contract item is valid
for all technical objects.
You can maintain a covered object for an item in a contract and also remove one or more covered object for an
item in a contract. Highlight the items you wish to remove, and then select More Remove .
You can search for contracts using the Contracts list table. This query searches for covered objects at the
header or item level. Other functions include:
● Copy: When users copy a contract, the covered objects maintained at item level are also copied.
● Change: Any modifications to covered objects on item level (including creation, modifications, and or
removal) are displayed in the contract Changes tab.
Administrators can use the Data Workbench to modify sales and service contract types even after they are
created.
Users can can copy items from Excel using the copy and paste function in the product table.
This task allows you to quickly paste Items, Covered Objects, Entitled/ Excluded Services & Parts. Ensure that
the copied data exactly matches the order of columns in the user interface.
1. Open a contract.
2. Go to the Items tab of a contract.
3. Click the Paste icon and the paste field appears.
4. Click in the Paste supported source data, such as Excel field.
5. Use your keyboard paste function, such as Ctrl + V (or Shift + Insert) to paste the data in the field.
For users with assigned Business Roles, you can set Read and/or Write Access Rules for Contracts via Access
Restrictions.
02 Sales data of Employee Access only if Employee Sales Data (Sales Organization,
Division, Distribution Channel) is equal to the Sales Data
used in Contract.
03 Employee, Sales Data of Employee Access only if the employee forms part of at least one of the
Involved Parties of the contract or the Employee Sales Data
(Sales Organization, Division, Distribution Channel) is equal
to the Sales Data used in the Contract.
04 Sales Organization of Employee Access only if the Sales Organization is equal to the Sales
Organization used in the Contract.
05 Employees for Managers Managers have access to all the contracts of the employees
they are responsible for.
06 Employee, Accounts (Account Team) Access if the employee is directly assigned as involved party
in the contract and/or if employee is assigned to the
Account Team of the Contract Account.
You can use the predefined contract queries to display relevant contracts or download contracts for offline.
Contracts are included as part of the realignment runs while single territory per account is configured. When
the territory of an account is updated, the territory of the associated contracts is also updated. The update
interval for open contracts is 8 minutes and for closed contracts is 30 minutes.
Incoterms inform sales contracts the respective obligations, costs, and risks involved in the delivery of goods
from the seller to the buyer.
Learn about covered objects, the reference object in the ticket and how agents can navigate from the ticket
contract hyperlink directly to the contract, search for contracts, embed tickets in contracts, and determine
relevance of covered objects in ticket header.
Service Determination Relevance of Item Covered Objects in Ticket Header [page 447]
Administrators can configure Determination Relevance of Covered Objects.
Compare Service Determination Relevance of Item Covered Objects in Ticket Header [page 448]
Users can compare values entered as ticket references (such as Products, iBase, and Serial ID) to
covered objects assigned to contract items to determine an applicable contract.
Choose Item Processing Codes for Quantity Service Contracts [page 448]
Learn about item processing codes and how the target, release, and remaining quantities are
calculated as well as the affect on your service tickets (items).
Users can display tickets directly from a service contract by navigating to Contract and searching for or
selecting a contract. From the contract, navigate to the Ticket tab.
You can search for tickets associated with contract (on header and item level).
Note
Based on the selected query, there are different field compositions for advanced search and result
columns.
The covered object is equal to the reference object in the ticket – for that reason the agent can easily navigate
from the ticket contract hyperlink directly to the contract to inform customers about their entitlements.
Context
A customer has an issue with a product and contacts the service representative providing them their contract
id or contract name. To react quickly to the customer’s request, the representative wants to view only the
tickets only for a particular customer contract.
Procedure
4. From the ticket overview, select Summary Preview to review billing details.
5. If desired, add notes to the ticket.
6. Save your entries.
For quantity contracts, you can select the quantity contract item and search in its Release History for
related tickets to see remaining quantity.
You can also navigate to the Ticket tab of the contract to see all tickets related to the contract.
Related Information
Administrators can embed the tickets table tab in a contract overview section.
To have a highly flexible query for contract related tickets, we recommend embedding tickets section in
contracts.
You can now view the embedded Tickets table including all of its queries.
Contract are determined and automatically added to a work ticket during ticket creation. This also applies to a
SLA (service level agreement), which might form as part of a contract that you would be able to view after
ticket determination in the ticket header.
● Contract determination in a ticket occurs based on ticket header information and item data.
● There is no direst dependency between the contract determination given by ticket header and the
contracts determined by the ticket items.
● It is possible to maintain multiple contracts in item level.
● Contract hierarchy is supported.
● Setting different contract determination logic and parameters is possible via BaDI implementation.
With the configuration, users can create a new contract and choose one of the following Determination
Relevance of Covered Objects types:
● Limited to Item Covered Objects - This selection is the system default. If a user enters in the ticket
processing a Serial ID as a Ticket Reference Object, the contract determination on ticket header is only
considered for contracts where this Serial ID is listed as a covered object on contract item.
● Consider Header Covered Objects - If a user chooses this selection (or leaves the field blank), and enters
ticket processing such as a Serial ID as a Ticket Reference Object, the contract determination on ticket
header is only considered for contracts where this Serial ID is listed as a covered object on contract header
Users can compare values entered as ticket references (such as Products, iBase, and Serial ID) to covered
objects assigned to contract items to determine an applicable contract.
When working with tickets that have a contract, the solution considers covered object assigned to contract
items. It also considers covered objects assigned to the contract header referencing covered objects that fit.
Learn about item processing codes and how the target, release, and remaining quantities are calculated as well
as the affect on your service tickets (items).
With quantity contracts, you can administer contract determination for defined products which should be
restricted in a period to a specific target quantity.
In general, code types are used in tickets (items) to determine how items (and their related products) are
handled in the business process. Therefore, if you have contracts in the system, the code types you choose
when setting up item processing codes have a considerable influence on the way your business works with
quantity contracts. Mainly, the choices made will result in how the target, release, and remaining quantities are
calculated, so consider these factors when setting up your solution.
Whether the item processing code increases, decreases, or has no impact in ticket items, you’ll find various
service transaction processing type codes depending on your solution set-up. Depending on the item
processing code, different handling for quantity call off (release) in contract items are relevant.
Learn about the item processing codes that have a (decrease) impact in quantity contracts.
The following item processing codes defined in fine-tuning have a (decrease) impact on defined product
quantities in quantity contracts if they are used in tickets:
Example
A ticket is created and the technician provides a service, for example, using a spare part or time in accordance
with the contract covered objects. Once the service occurs and is recorded in the solution, you will see a
modification in the target definitions resulting in an increase in the release quantity and a reduction in the
remaining quantity.
Learn about the item processing code that has an (increase) impact in quantity contracts.
The following item processing code defined in fine-tuning has an (increase) impact on defined product
quantities in quantity contracts if they are used in tickets:
Example
The service technician provided a service in accordance with the contract covered objects. The stock for
example, a boiler was returned. Once the service occurs and is recorded in the solution including the boiler
return, you will see a modification in the target definitions resulting in a decrease in the release quantity and an
increase in the remaining quantity.
Learn about the item processing code that have no impact in quantity contracts.
The following item processing codes defined in fine-tuning have no impact on defined product quantities in
quantity contracts if they are used in tickets.
In the first example, the technician provided a service in accordance with the contract covered objects. The
stock, for example, one boiler was already sent as ´Part Advance Shipment to Customer Consignment Stock
part´ to the customer. This has had an impact on the product quantity of the quantity contract.
For this reason a ticket item with type ´Part Consumption from Customer Consignment Stock´ won´t have any
further impact on the product quantity of the quantity contract resulting in the release quantity and remaining
quantity staying the same.
Example
In the second example, the technician creates a complaint item about a product. As there is not yet a clear
picture about the next steps for this ticket item, there is not an impact on target definitions. The same applies
for external procurement for example in a DIY (Do it yourself).
Learn how the systems uses contract determination to search for and reference to existing contracts created in
the system as well as the assignment of tickets in contracts. Contracts are determined orders if they have the
same product, customer (sold-to party) and org. data (sales org unit, distribution channel, and division).
Compare Service Determination Relevance of Item Covered Objects in Ticket Header [page 448]
Users can compare values entered as ticket references (such as Products, iBase, and Serial ID) to
covered objects assigned to contract items to determine an applicable contract.
Users can compare values entered as ticket references (such as Products, iBase, and Serial ID) to covered
objects assigned to contract items to determine an applicable contract.
When working with tickets that have a contract, the solution considers covered object assigned to contract
items. It also considers covered objects assigned to the contract header referencing covered objects that fit.
Explore how you can use the contract determination log to view which sales and services contracts were
determined and why.
Note
The log is available for sales orders, sales quotes, and work tickets.
Create a contract for an account. In the contract header, set the flag Include Authorized Parties. Next you can
add the party role Authorized Party.
Note
Users can assign quantity contracts to eligible parties for call-off quantities in sales orders and sales quotes.
Users can choose from one of the following in Overview section of a sales contract.
Note
To use include authorized parties, go to fine-tuning Sales Contract Involved Parties and activate the
party role Authorized Party.
During contract determination, the number of contract items is reduced by excluding specific contract items in
stages using the elimination process in the check logic.
The main goal is always to find the most applicable contract(s), as well inapplicable, blocked, or obsolete
contracts. This allows the service technician to make an informed decision about the correct contract to use
for a service ticket.
Learn the contract determination logic for account hierarchy, installed base, and installation point (service
reference objects).
To gain a better understanding, here are examples of account hierarchy contract determination.
The service technician creates a service ticket and adds the customer account details. If the customer has a
contract covering all products and all serial numbers, the contract is always applicable.
The service technician creates a service ticket and adds the customer account details. The contract is not
found, because it is too specific. If the product P1 is entered, the contract is found because it matches exactly.
The contract is also found if the Serial ID is entered, because all Serial IDs are covered.
The service technician creates a service ticket. If the customer and the product are entered in the ticket, the
contract is not found, because it is too specific. If the Serial ID S1 is entered in the ticket, the contract is found,
because it matches exactly.
The service technician enters the customer in the service ticket. The solution logic determines that Product P1
and contract C1 are applicable. For product P2, contract C2 is applicable. For product P3, no contract is
determined.
The service technician enters the customer account in the service ticket. Two contracts are found, both are
applicable, and neither one is most applicable. Therefore, no automatic assignment is needed. The service
technician receives a message to manually select a contract.
Learn the contract determination logic for Installation Point (service reference objects).
The service technician enters the Installation Point ID in the ticket and the solution states no contract exists. A
contract does exist with an Installation Point, which is located one hierarchy overhead, meaning this contract is
also applicable.
The most applicable contract is the contract of the Installation Pointt element, which was entered in the ticket.
If no contract exists, the most applicable contract is for the Installation Point element is located at the next
hierarchy level.
Learn about the contract determination logic sequences that are relevant for customer-centric.
In a service request header, the contract usage restriction code is considered in the determination logic. The
contract has at item level a list of one or more contract usage restriction codes.
Note
When your business uses customer-centric contract determination, the customer (account) is relevant in
the search criteria.
If the contract usage restriction code of the service request header is covered in one of the list of the contract
items. Then the contract is the most applicable. If no contract item has a list of contract usage restriction code,
then all contract usage restriction codes are covered and this contract is also applicable.
Enter the installation point and Installed base in the service ticket and the solution first searches for contracts
and items
Note: When your business uses object-centric contract determination, the customer (account) is not a relevant
search criterion.
Note: The solution locates contracts and items for customers (accounts) which are different from the
customer in the service ticket.
The solution analyzes the contracts and items and ranks them in order of significance.
Example
A machine has an incident at customer A at site ABC for product 123 but the applicable contract (with product
123 as covered object) determined was made for customer B. If you create a ticket entering product 123 the
relating contract is determined although the customer in the ticket is A.
A service ticket is created using the customer ID. The solution does not recommend a contract. The customer
does have a contract located in the hierarchy, meaning the contract is also applicable.
The most applicable contract is the contract for the customer entered in the ticket. If no contract exists, the
most applicable contract is for the customer at the next hierarchy level.
Each customer from the hierarchy has their own contract. If in the ticket the company St. Ingbert, has been
entered, the contract for company St. Ingbert is the most applicable. The two other contracts for company
Germany and company Europe are also applicable.
The contract for company St. Ingbert is blocked and the ticket processor enters customer company St.
Ingbert. Then, the contract for the company Germany is the most applicable and the contract for company
Europe is also valid.
The contract for company St. Ingbert is blocked. The contract for company Germany is also blocked. The ticket
processor enters customer company St. Ingbert. Then, the contract for the company Europe is the most
applicable contract.
When working with contracts in accounts, users can set up details that consider account hierarchies for
contracts.
Define Quote and Contract Document Types for SAP ERP Integration [page 459]
Administrators can define quote, sales and service contract document types for SAP ERP with SAP
Cloud for Customer quotes, sales, and service contracts.
Administrators can define SAP ECC contract transfer behavior in business configuration for contracts.
For each document type an administrator should select one of the following contract replication types:
Remember
If none of the replication selections are made (blank selection), contract changes are not transferred to or
from SAP ECC.
Administrators can define quote, sales and service contract document types for SAP ERP with SAP Cloud for
Customer quotes, sales, and service contracts.
The fine-tuning of Document Types allows multiple settings for SAP ERP integration. You can leverage each
document type as a special business scenario/use case. Depending on your requirements, you can create
multiple document types for your desired business scenarios.
Go to Business Configuration Implementation Projects Your Project Open Activity List Fine-Tune
Activity Name: Sales Contracts, Service Contract, or Sales Quotes Document Types Maintain Document
Types. Select your Document Type and modify it to your business solution requirements.
External Pricing – A check in the box enables an external application such as SAP ERP, synchronously requests
prices. The transaction simulation determines not only pricing, but sales quotes, free goods, product
Replication – Administrators define the sales quote and the sales and service contract transfer behavior from
your SAP on-premise system to your cloud solution by selecting one of the following options:
● Bi-directional – Sales quote edits in your cloud solution are replicated to your SAP on-premise system,
syncing both quotes.
Remember
Your SAP on-premise system is the leading system for these sales quotes, sales, and, service contracts.
Quotes created in your cloud solution can be replicated to your SAP on-premise system from Action
Submit. Quotes created in SAP ERP can be edited in SAP Cloud for Customer and the changes are
replicated in SAP ERP.
● Inbound – Quote edits completed in your cloud solution are not replicated to your SAP on-premise system.
Those quotes are overwritten if further replications are triggered from your SAP on-premise system.
Note
We recommend that you control editable fields and actions from the page layout and only open
extension fields that do not require replication. (Creation of the sales quote is only possible in SAP ERP
and changes performed in SAP Cloud for Customer are not sent to SAP ERP).
● Empty – Leaving this field blank indicates the sales quote stays in SAP Cloud for Customer, but this option
still allows you to request external pricing.
Note
This configuration only applies to new sales quotes as well as sales and service contracts. Existing sales
quotes and sales and service contracts behave using the inherited document type configuration. Existing
sales quotes and sales and service contracts behave as specified from the previous active document type
configuration.
Asynchronous Pricing – Administrators can modify the settings for external pricing. A synchronous call is
required to retrieve the complete pricing result from the SAP on-premise system to your cloud solution.
Replicated sales documents also require a synchronous pricing update once the sales document is updated
during a save in SAP Cloud for Customer.
With this configuration, if the document was previously replicated, administrators can disable the synchronous
pricing call to the external system. In addition, you can disable the synchronous call completely, which is valid
for quotes created in your cloud solution. For both configuration options, the pricing status needs to be
calculated successfully through the asynchronous call from the external system. Select the option that suits
your business needs.
● Empty – Leaving this field blank triggers an automatic (once replicated) synchronous pricing call activation
(You see pricing-related errors, but configuration has performance impacts.).
● After replication – If document was replicated successfully, an automatic synchronous pricing call is
deactivated.
● Always – An automatic synchronous pricing call is always deactivated (leads to a performance advantage,
but possible pricing call error messages are no longer displayed directly in the UI, only asynchronously). No
matter the configuration, you can trigger pricing synchronously by clicking Action Request External
Pricing. With this configuration, avoid quote approvals that include external pricing elements.
To avoid data inconsistencies between SAP ERP and SAP Cloud for Customer, only replicated contracts are
used in tickets.
Remember
Only new and sales and service contracts and sales quotes inherit changes in the document type
configuration. Existing contracts and sales quotes behave as specified in past active document type
configuration.
Offline service contract features include search and match of ticket parameters to the applicable contract
parameters.
Note
Offline Service Contract Covered Objects in Item Determination is available for both test and productive use.
To enable this phased delivery feature, create an incident or contact your SAP Cloud for Customer
representative.
Reference Product ID of Ticket Item Against Product ID (also as category) of Without Product Category Hierarchy
Contract Covered Object (Item)
Reference Installation Point ID of Ticket Against Installation Point ID of Contract Without Installation Point Hierarchy
Item Covered Object (Item)
General availability has been made for administrators to configure contract item determination to use in offline
mode. Navigate to Business Configuration Edit Project Scope Questions Service Customer Care
Service Request Management and place a check mark for question Do you want to determine contract
items for tickets in offline mode?
No deviation (typical use case) - Proposed [e.g. offline] Contract = ´[online] Contract´ ´Conflict´ constellation:
MOST APPLIBALE CONTRACT: applicable ´ Proposed Contract ´ [= that is the most applicable Contract in
online mode] was transferred from offline to online field ´Contract´
APPLICABLE CONTRACT: applicable ´Proposed Contract´ [~ and no most applicable exists in online mode]
was transferred from offline to online
Deviation:\u000BRecommendation is to set up Workflow Rules for Tickets with critical Contract Transfer
Detail Values (such as ´inapplicable proposed contract…´, ´no contract proposed´) to filter and check final
Contract Assigment to these Ticket Items:
TRANSFERRED BUT MOST APPLICABLE EXISTS: applicable ´Proposed Contract´ [~ but most applicable
Contract exists in online mode but was not taken] was transferred from offline to online.
INAPPLICABLE CONTRACT NOT TRANSFERRED: inapplicable ´Proposed Contract´ [=in online mode this
contract can not (!) be determined] which was not transferred from offline to online.
NO CONTRACT PROPOSED BUT MOST APPLICABLE CONTRACT EXISTS: no ´Proposed Contract´ [~ but
most applicable Contract exists in online mode] was transferred from offline to online
Resolution of Deviation: underlying Question is: Should the online or the offline determined contract ´rule´?
If online contract item should be used (normally better since offline is only a proposal) then trigger action
Redetermine, select manually the contract item in OVS or use value:
If offline contract item should be used (rare use case) then set the “Contract Transfer Detail”:
PROPOSED CONTRACT MANUALLY ACCEPTED: Accept offline proposal [= a) no ´ Proposed Contract ´ was
manually assigned offline (e.g. no contract warranty due to customer fault) nevertheless even if online
applicable contracts exist: then no contract should be set online. b) an applicable ´ Proposed Contract ´ was
determined offline and this one should be used although other/ most applicable contract(s) online exist(s)]
\u000BINAPPLICABLE PROPOSED CONTRACT ENFORCED inapplicable ´Proposed Contract [=in online
mode this contract can not (!) be determined] which nevertheless was transferred from offline to online and
there enforced to online field ´ Contract ´
Learn how the system uses contract pricing to determine the price of a material based on the contract.
The contracts solution retrieves complete price information including tax from the SAP ERP external system.
Context
Your administrator has set-up external pricing in your solution so that you can retrieve complete price
information from SAP ERP for your service contracts.
Complete all of the steps below before you request external pricing from SAP ERP.
1. Open the contract which should already include the covered objects and items.
2. Navigate to the Items.
3. Select Billing Plan to add the customer’s desired details, such as how and when they want to billed for the
contract services.
These prices will vary depending on how your administrator has set-up the solution.
4. Navigate to Pricing where you can enter various types of discounts per line item.
5. Save your entries.
6. Select Request External Pricing in order to retrieve the pricing from the external SAP ERP system.
Now all of the details the customer needs in order to sign the contract are available.
7. Select Preview Send and the customer will receive a preview of the contract document.
Once the customer signs the contract it should be sent back to your company.
8. Select Activate and the contract status is changed to Active or Ready (if the contract is agreed but only
valid for a future date).
9. Select Transfer and the contract is sent to SAP ERP where all details are stored and a contract is created.
The solution will provide you with transfer status information and the External ID from SAP ERP.
The contract ID displayed in the contract header is the number created by SAP Hybris Cloud for Service.
The External Reference is any number or set of characters the customer desires to use and is entered
manually in the header by the contract administrator or associate.
Create reports using the data collected from your contracts to better understand them and make
improvements.
Administrators can include item covered objects in report by navigating to Business Analytics Design Data
Sources Contract Item Covered Objects .
Administrators can configure a restriction so that business role users cannot perform Excel exports for
contracts.
Configure Excel export authorization restrictions by navigating to Administrator Business Roles Select
role (that includes the Contracts work center) Fields & Actions Business Actions Restrictions Add row
and search for Microsoft Excel.
Having trouble using contracts? Check this list of questions and answers for help.
Yes, creation or adaption of customer fields are possible and will be considered for contract template usage.
Learn about contract service level priorities and Service Level Objective (SLO)s.
Example: If arrival at the customer site is guaranteed by a standard service level is eight (8) hours, but the
contract service level is one (1) hour, then the contract service level will be used in the ticket.
Your administrator can set-up work flow solutions to be used for renewal purposes.
These work flows can be set-up using notifications and/or opportunities informing you in advance when
contracts are due to expire. In addition, with the Contracts Expiring Soon query you can filter for contracts
where the Ends On date lies between the current date and the current date plus 28 days.
When you activate a contract, the system performs several checks to ensure that the contract is valid.
● A contract which must have a start and end date and the end date must be after the start date
● The covered objects you have entered added parties. The system checks whether they exist in the system
Learn what happens to contract determination, when about the service ticket objects are modified.
The service technician creates a ticket and adds the mandatory business objects such as the customer
account.
One of the following fields is changed at item level and item service reference objects level of the ticket. The
contract item determination starts automatically for the ticket item:
Learn about the search criterion used in contract determination for tickets.
The service technician creates a ticket and adds the mandatory business objects such as the customer
account.
If one of the following fields is changed at ticket header level, the contract determination is started
automatically for the header and service reference objects, including all ticket items:
Users can view SAP ECC statuses in the Contracts overview. The External Status, External Reference Status
(relevant only for sales quantity contracts call-offs), and External Invoice Status are available on the header and
item level.
Learn how the common tasks such as search, navigation menu, feeds, calendar, side pane, dashboard, and so
on, work in the solution.
Knowing how to navigate around the solution with the visible elements that you see and interact with is critical
in managing your data in the solution.
A navigation menu provides easy access to the core functionalities and makes browsing easier by providing a
main menu of options.
By default, the navigation menu has a hierarchical structure with a main level and a sublevel. You can view the
navigation menu in a flat design and see all the objects at the same level. With flat design, you can navigate
quickly and easily. Please ask your administrator to enable the flat design.
A flat design navigation menu shows all objects at the same level.
You avoid additional clicks and can quickly find and navigate to the desired object. For example, for a sales user,
all the objects such as leads, opportunities, and so on, show up at the same level in the navigation menu.
Your administrator can enable flat navigation menu by selecting the checkbox Enable Flat List Navigation Menu
in Fiori Client in the Company Settings screen. Once turned on, the setting affects all users.
Note
Some work center views like Target Group are assigned to multiple work centers and hence might appear
twice. Please check the work center view assigned to the business role.
With semi-collapsed navigation, you can quickly launch object lists without opening or closing the navigation
menu.
Note
The new navigation menu is the only menu option available in the solution. The old navigation menu has been
retired.
The new navigation menu is available in the semicollapsed mode upon sign-in. The new navigation menu
provides consistent user experience across all SAP C/4HANA products.
The administrator can enable the feature from the user profile menu under Settings Company Settings ,
by turning on the toggle button for the company setting. Enable Semi-Collapsed Navigation menu upon Sign-in.
The new tab navigation bar supports automation IDs. Automation ID is used to locate an element and uniquely
identifies an element or tab from the other tabs. Automation ID is useful when you want to find a specific user
interface element among other elements. For example, it’s useful when you want to find a specific item in a
collection.
Caution
Any automation scripts that follow the click to navigate action, must be adjusted.
Learn to quickly access your recently opened objects with recent history.
Get a more streamlined experience in finding and retrieving recently accessed objects in the different work
centers with the Recent History tab in the navigation menu. Recent history records all the recent objects
opened by you and displays it in a single list for quick access. Recent history tracks all the standard and custom
objects, and objects opened in offline mode. You can choose to see all objects or filter by specific object.
The library allows you to store documents, pictures, or other files directly in the solution.
Note
The existing library will be deprecated in February 2020. The features will continue to be available in the
new library.
In the library, you can view, edit, or delete files. Version tracking and exclusive editing rights using a check in/
check out policy ensure that the files are always up-to-date, and searching and linking functions allow you to
easily find and share your files with colleagues.
You can sort the documents by ascending or descending order, title, version, changed on date and locked
status. You can also do advanced search and save a query or organize queries.
Selecting a document shows the information about the document in a new window. The Overview tab gives you
recent updates of the documents as well as version information. Use flags, favorites, and tags for the
documents in the library. Notes provide you with information regarding the latest notes update on the
document. You can edit and add a new note or update an existing one.
Related Information
Procedure
Procedure
1. From the Library, select the document you want to edit. Only editable content like a .doc file can be
checked out for editing, not images. Versioning must be enabled.
2. Select Check out. You can now edit and save the document.
3. After editing, upload a new version of the document by choosing Actions Check In and browsing to
the updated file.
Procedure
1. Under Library, choose the + icon. The Add Document window appears.
2. Browse to the file location. If necessary, change the automatically populated title.
3. Select Enable Versioning to track the history of the document. An increase in the version number of the
document represents a revision.
4. Save your entries.
Note
The existing library will be deprecated in February 2020. By then, any documents that have not been
migrated will be automatically migrated to the new library upon upgrade.
Before users can organize documents using folders, administrators must enable the new library and migrate all
the content from the existing library.
Procedure
For more details, please check Create Business Roles and Assign Work Centers and Views.
Note
Along with the new library work center, access context 2027 is available for you to apply access
restrictions.
3. Go to the (New) Library work center, from the actions at the bottom right, click Migrate Documents from
Library. A background job is scheduled at the back end to migrate all the documents from the existing
library.
The background job is triggered every four hours. Depending on the volume of the documents to be
migrated, the time required to complete the migration varies.
Next Steps
Once the migration completes, you can disable the existing library work center view (ID:
COD_MARKETINGINFO) for applicable business users or roles.
Tip
After the old library is removed from the project scope, it is recommended that you trigger the migration in
the new library once again, just in case users might have created new documents in the old library during
migration.
You can build up to three levels of folders to group documents in the new library. A breadcrumb trail allows you
to keep track of your current location and easily navigate back to an upper level of folder in the hierarchy.
Restriction
Pre-delivered views are only used to filter top-level documents and folders in the library. For example, if you
switch the view from Created by Me to Changed by Me within a folder, you will be directed back to the top
level in the library and see a list of top-level documents and folders that have been changed by you.
As the owner of a document or folder, you can define whether the document or folder is public or private.
Access to a private document or folder can be restricted to specific sales data, accounts, employees, and
territories.
In addition, you can authorize other employees to administer the document or folder by checking their Grant
User Access fields.
Items that have access to a parent folder can access all the child folders and documents within the folder.
Items with such Inherited Access cannot be edited or deleted.
Note
You cannot change the administration right for an employee with inherited access. In a case like this, you
must add the employee explicitly for editing.
Inherited access can also be granted due to access control that has been configured by your administrator.
Within the new library, you can organize documents using the Move act