CUSTOMER SAP Customer Checkout 2.0 Feature Pack 09 Document Version: 2.0 Feature Pack 09 – 2/28/2020 SAP Customer Checkout Configuration Guide © 2020 SAP SE or an SAP affiliate company. All rights reserved. THE BEST RUN
CUSTOMERSAP Customer Checkout 2.0 Feature Pack 09Document Version: 2.0 Feature Pack 09 – 2/28/2020
SAP Customer Checkout Configuration Guide
© 2
020
SAP
SE o
r an
SAP affi
liate
com
pany
. All r
ight
s re
serv
ed.
THE BEST RUN
Content
1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2 Synchronization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72.1 Scheduling Synchronization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82.2 Setting Last Synchronization Date. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3 POS System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103.1 Info. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103.2 General. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113.3 Tax. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .133.4 Sales Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143.5 Master Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243.6 Consent version code. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253.7 Sequence Numbers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263.8 Sequence Number Consumer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273.9 Field Mapping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .273.10 Setting up Central Drawer Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
4 Accounting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .294.1 Credit Card Type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .294.2 Tax Rates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .304.3 Payment Terms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .314.4 Petty Cash. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314.5 Financial Transaction Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324.6 Period-End Close Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324.7 Day-End Closing Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
5 Sales. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365.1 Price Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365.2 Stock Location. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385.3 Customer Return Reason Code. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395.4 Discount Purpose. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395.5 Customer Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .405.6 Article ID of Voucher. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405.7 Decimal Places. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415.8 Tip Handling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42
Tip Handling Deactivated. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Do not record tips. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
2 CUSTOMERSAP Customer Checkout Configuration Guide
Content
Record tips. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Tip Handling Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Adjusting the Tip Handling Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Tip Amounts on Receipts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
5.9 Expenses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455.10 Loyalty Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46
6 Currency. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486.1 Currency. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486.2 Exchange Rates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526.3 Cash Replenishment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
7 Quick Selections. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55
8 Dialog Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56
9 Technical. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599.1 POS System Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Backup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59Web Browser. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61Hardware. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
9.2 Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629.3 Signature settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Exporting and Deleting Signature Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .659.4 Shutdown Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
10 Hardware. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6710.1 Receipt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6710.2 Print Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6910.3 Print Templates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
Setting Up DIN A4 Printing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Customizing Print Templates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74Creating User-Defined Translations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78Adding Fonts to Print Templates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78Image-Based Receipt Printing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
10.4 Plug-Ins. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8110.5 External Line Display Plug-In. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Changing Size and Position Manually. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83Advanced External Display Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
10.6 Test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8410.7 Output Locations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
SAP Customer Checkout Configuration GuideContent CUSTOMER 3
Direct Assignment or Removal of Output Location in SAP Customer Checkout. . . . . . . . . . . . . . 86Setting a Printer as Output Location. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
10.8 Special Attributes in JPOSPlugin.properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8710.9 Using Multiple Printers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
11 Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9111.1 SAP ERP System Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
SAP ECC Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91SAP Business ByDesign Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97SAP Business One Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99SAP Customer Checkout manager Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
11.2 SAP Customer Checkout manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105Monitoring. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109Receipt management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111Webservice Endpoint. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113Central Customer Management in Combination with Other SAP Back-End Systems. . . . . . . . . . 115
11.3 Voucher. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115SAP Customer Checkout Manager Voucher Module. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
11.4 SAP Event Ticketing Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
12 Users and Roles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
13 Additional Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11913.1 Additional Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11913.2 Alternative ID Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
14 Plug-Ins. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12014.1 Bluecode Plug-In. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120
15 About. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12315.1 About. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12315.2 License. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12315.3 Lifecycle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12415.4 External System Connected. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12515.5 Configuration Export/Import. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12515.6 Exporting/Importing Users and Roles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12615.7 Import Vouchers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12615.8 Schedule Check for Updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12615.9 Data Reset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
16 Overview of Localization Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12916.1 Country/Region. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12916.2 Currency. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12916.3 Customer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
4 CUSTOMERSAP Customer Checkout Configuration Guide
Content
16.4 Tax. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13016.5 Time and Date. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13116.6 Unit of Measure and Currency Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13116.7 Unit Price. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
17 Attachment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13217.1 Mail Monitoring Filter Keys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Error Events. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132Warning Events. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133Info Events. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .133Debug Events. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .134
18 POS Software Certification According to NF 525 (France). . . . . . . . . . . . . . . . . . . . . . . . . . . .13518.1 Technical Event Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13618.2 Archiving. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13618.3 Signature. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13718.4 Configuring SAP Customer Checkout in Compliance with French NF 525 Regulations. . . . . . . . . . . 137
Specifying Key Length for Signature Manually. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139Overview: Automatic Settings for French Certification According to NF 525. . . . . . . . . . . . . . . . 139Calculation Change for Period-End Closings with SAP Customer Checkout FP08 or Higher Version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
18.5 Replacing Certification Number Using a Plug-In. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
19 POS Security Regulation 2020 for Germany. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14219.1 Installing and Configuring a Technical Safety Entity (TSE). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Ordering TSE Hardware from Diebold Nixdorf. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143Installing the TSE Hardware. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .144
19.2 Data Export for DSFinV-K Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145Data Export for DSFinV-K Interface in SAP Customer Checkout. . . . . . . . . . . . . . . . . . . . . . . . 146
SAP Customer Checkout Configuration GuideContent CUSTOMER 5
1 Introduction
SAP Customer Checkout includes configuration settings that let you adapt the application to your requirements.
To access the configuration screens, you need a user with the admin role. The configuration screen consists of multiple tab pages, including the following:
Configuration tabs
Tab Description
Synchronization Synchronize data with the ERP system and schedule synchronization events
POS system Maintain general application settings, general information, ERP settings, and so on
Accounting Specify settings for credit cards, tax rates, financial transaction types, and so on
Sales Set price lists, specify how to handle discounts, returns, vouchers, quick selection and so on
Currency Enter your currency settings
Dialog Settings Manually configure the Search dialog box settings to determine which customers and articles appear in the search dialog box
Quick selections Displays name and synchronization date of the quick selection configuration used by SAP Customer Checkout manager
Technical Configure POS system settings and number ranges, update connections, databases, signature settings, etc.
Hardware Make settings for your connected hardware (receipt printer, line display, cash drawer), for receipts, hardware plug-ins, and so on
Integration Integrate your ERP solutions, the SAP Customer Checkout manager, vouchers and so on
User Configure users, user rights, the password policy, salespersons, and so on
Roles Define roles and their permissions
Additional Fields Define labels for fields and data used by plug-ins
Plug-Ins View information about plug-ins
About View version information, configure import/export, import or export users, schedule application updates, switch to productive mode, and so on
6 CUSTOMERSAP Customer Checkout Configuration Guide
Introduction
2 Synchronization
On the Synchronization tab, you can define the synchronization of data between SAP Customer Checkout and your ERP system.
Synchronization Types
SAP Customer Checkout provides the following types of synchronization:
● Complete synchronizationSends all available data from the SAP Customer Checkout database to the ERP system and receives all available data from the ERP system. Use this type of synchronization if you suspect that the database on the point of sale side is missing data from the ERP system.
● Regular synchronizationSends changes from the point of sale side and receives updates since the last synchronization event. This type of synchronization is carried out if you do not select Complete Synchronization during scheduling.
NoteIn addition to all changes since the last synchronization time, regular article synchronization also transmits all changes within the last two hours before the last synchronization event.
Data
You can synchronize the following data:
● Customer● Article● Document● Voucher● Discount ( necessary only when the ERP system is SAP Business ByDesign or SAP Business One, or when
using the SAP Customer Checkout manager as back-end system)● User (appears only when the central user management of the SAP Customer Checkout manager is
enabled)
Recurring Synchronizations
You can schedule the synchronization to run immediately, at a specified time and date, at recurring intervals (hourly, daily, weekly or monthly), automatically after startup, or by using a CRON expression in Quartz CRON format in a user-defined manner.
SAP Customer Checkout Configuration GuideSynchronization CUSTOMER 7
2.1 Scheduling Synchronization
You can define when and how often the synchronization should run.
Procedure
1. Choose Schedule synchronization for the relevant data type.2. Select when and how often synchronization is to be carried out, and choose OK to save your changes.3. Check in the Synchronization logging area to see if any errors occurred during the synchronization. If you
scheduled the synchronization immediately, you will immediately see an entry for your job. Otherwise, the entry appears after the job has run.
NoteSAP Business One only: The option Start Next Synchronization from is visible only when using the SAP Customer Checkout manager as back-end system. For customer and article synchronizations, you can manually set a value (integer positive number) from where the next synchronization job should start. For example, you can use this feature after setting the last synchronization date time to never. Furthermore, this feature is useful if an already-executed synchronization job failed because the back-end system was unavailable for a short while, after most records were already synchronized. If you start the synchronization without using Start Next Synchronization from, all records that are already synchronized are synchronized again. To avoid this, you can put a value in the field to indicate the point at which the next synchronization should begin.
This value is reset and cleared as soon as the next synchronization job is started.
To check how many synchronization records are already in the SAP Customer Checkout system, click Count. In general, we recommend that you use this feature only after you have set the last synchronization date time to never.
CautionUsing Start Next Synchronization from can lead to consequences, for example, missed records, on subsequent synchronization jobs. It is your responsibility and risk to verify the correct usage of this functionality.
8 CUSTOMERSAP Customer Checkout Configuration Guide
Synchronization
2.2 Setting Last Synchronization Date
In exceptional circumstances, you can manually set a last synchronization date for your data. Furthermore, you can also set the synchronization to Never (assuming that a synchronization job has never been performed before in the respective SAP Customer Checkout application).
Context
CautionManually setting last synchronization dates can lead to consequences on subsequent synchronization jobs. It is your responsibility and risk to verify the correct usage of this functionality and set the correct synchronization date.
ExampleAssuming that the last synchronization job for Customer was performed on January 01, 2017, and the current date is January 31, 2017. When you now (January 31, 2017) schedule a customer synchronization, SAP Customer Checkout synchronizes all customers that have been added, and edited during this period (from January 01 to January 31, 2017). With SAP Customer Checkout 2.0 Feature Pack 02, you can now manually set the last synchronization date and time. For example, when you manually set the last synchronization date to January 15, 2017, and schedule a synchronization job afterwards, the synchronization includes customer records that have been added or edited between January 15 and January 31, 2017. New and changed data between January 01 and January 15, 2017 is not included in this sychronization job (as the last synchronization job was manually set to January 15, 2017).
When you set the last synchronization date to never, SAP Customer Checkout assumes that no synchronization job has ever been performed before.
Procedure
1. Choose Set last synchronization date for the relevat data type.2. Select the date and time for the last synchronization, and choose OK.3. Verify in the Last synchronization area of the respective synchronization job that the correct date is shown.
NoteOnce a last synchronization date is manually set, an entry is created in the log files. This information is for auditing and monitoring purposes, and can be reviewed to determine when the last synchronization date was manually set, and by which user.
SAP Customer Checkout Configuration GuideSynchronization CUSTOMER 9
3 POS System
Configure general settings for the SAP Customer Checkout application and the connected ERP system.
POS System Subtabs
Subtab Description
Info Enter company information and address data
General Maintain general settings and add a logo
Tax Enter tax data, like your tax number and VAT number
Sales Screen Customize the sales screen with various settings
Master Data Define how master data appears
Sequence Numbers Define how IDs for a specific number of entities are generated by SAP Customer Checkout
Sequence Number Consumer Define the sequence number from which entities fetch their IDs
Field Mapping Map fields between SAP Customer Checkout and the ERP system to integrate the data model of SAP Customer Checkout with the data model of the respective ERP system
3.1 Info
Name, Description, Location, and Company Name are general information that does not appear to the user. You should, however, still maintain this information correctly.
POS system ID is the ID used throughout the application (for example, as the ID for the receipt ID). Each POS system must have a unique POS system ID.
NoteBefore the POS system ID can be changed, the current day-end closing must not contain any receipts. When you switch, a new day-end closing is created, based on the new POS system ID. However, if the current day-end closing contains receipts, the process is terminated. You first need to close the current day-end closing without posting a carryover of remaining amount to the subsequent day-end closing. Only then can you change the POS system ID.
10 CUSTOMERSAP Customer Checkout Configuration Guide
POS System
Address
Option Description
Country/Region Shows the tax rates and currency rounding rules used by the application. Config-ure tax rates on the Financials tab page and currency rounding in the Currency tab page of the configuration screen.
Street/House Number/Postal Code/CityPhone Number/Fax Number/E-Mail/Web URL
You should maintain these fields, but currently they provide no functionality.
3.2 General
General Settings
Option Description
Language The language and locale used in printed receipts and in the external line display. The default is German.
NoteSAP Customer Checkout supports printing in Japanese, simplified Chinese, and Arabic script using the image-based receipt printing feature. For further information, see Image-Based Receipt Printing [page 79].
Cash Balancing GL Account Value of the general ledger account from the SAP ERP system that is used for the cash balancing after performing a day-end closing.
If the SAP ERP system is SAP Business ByDesign or SAP Business One, the cash balancing GL account must be provided.
Cash Balancing General Ledger Account (Negative)
Value of the general ledger account from the SAP ERP system that is used for the negative cash balancing after performing a day-end closing. If this field is empty, the value from the field Cash Balancing General Ledger Account is used.
Currency Currency used by the application
SAP Customer Checkout Configuration GuidePOS System CUSTOMER 11
Option Description
Usage Mode Switch between local drawer management (default) and central drawer management. In central drawer management mode, the drawers are managed by SAP Customer Checkout manager. Once the mode is switched, day-end closing is performed and the current user is logged out.
NoteIf you switch from one mode to another, the current day-end closing must not contain any receipts. If the current day-end closing contains receipts, perform day-end closing without a carryover of the remaining amount before switching modes.
For further information, see Setting up Central Drawer Management [page 27].
Default cash-out type for day-end closing cash-out dialog
The cash-out type that is set as the default when a day-end closing is been performed.
Possible values:
● Amount to remain● Amount to be cashed out
Enable Sounds Enable/disable sound notification when articles are added to a receipt.
Use Time Recording without Login Enable/ disable the option to perform time recording transactions without a login in SAP Customer Checkout.
You can use another logo or disable the logo in the top left corner of the screen. By default, the SAP logo is enabled.
Application Logo
Option Description
Application Logo Logo to be left-aligned in the top-left corner of the screen.
The logo is automatically resized if it is larger than the maximum size. If you don't want to show a logo, select the empty entry from the list.
The following image formats are supported: PNG, GIF, JPG
Maximum size: 90px * 45px
Available application logos Accessible in edit mode only: List of usable logos that are already uploaded.
Add Logo Accessible in edit mode only: Upload an image file to the application.
The image is added to the Available application logos section and can be selected.
The following image formats are supported: PNG, GIF, and JPG.
You can edit the background image for the logon screen, the Sales screen, and the table screen in SAP Customer Checkout. You can upload a new image, remove an existing image, or use the standard SAP image.
12 CUSTOMERSAP Customer Checkout Configuration Guide
POS System
Option Description
Login screen background Here you can select the background image to be displayed when logging on to SAP Customer Checkout.
A background image for the logon screen is delivered by SAP Customer Checkout as standard.
Sales screen background Here you can select the background image to be displayed on the Sales screen in SAP Customer Checkout.
Table screen background Here you can select the background image to be displayed in Table Management mode in SAP Customer Checkout.
A background image for the table screen is delivered by SAP Customer Checkout as standard.
The following image formats are supported: PNG, JPG
The maximum screen size is 3MB.
3.3 Tax
Tax Settings
Option Description
Tax Authority Printed at the bottom of the receipt.
Tax Number Printed at the bottom of the receipt.
VAT Numbers Printed at the bottom of the receipt.
Tax Character Code List ID If the ERP system is SAP Business ByDesign, the tax character code list ID must be provided for transactions.
Is Company VAT Liable Displays the VAT amount of the company.
Enabled: The VAT has to be shown mandatorily in the receipt.
Disabled: VAT is not shown in the receipt.
SAP Customer Checkout Configuration GuidePOS System CUSTOMER 13
3.4 Sales Screen
Sales screen settings
Option Description
Static Discount Button Text Enable/disable a static discount pushbutton on the SALES screen. Click the button to add a header discount to the receipt with a single click. If this field is empty, the button doesn't appear. If this field contains a value, the pushbutton is displayed and the value in the field is used as the pushbutton label.
Static Discount Value The header discount percent that is applied to the receipt using the static discount button.
Amount limit for mandatory customer To require that a customer number be entered when a certain amount is exceeded, enter the amount here. If you leave this field blank, it will be optional to enter a customer. This threshold is also relevant for returns.
Payment Summary Defines the scope of counting as regards cards, debtor items, and vouchers. The following options affect user input, comparison scope, and user information:
Amount: Only amounts are taken into consideration.
Transactions: Only the number of transactions is taken into consideration.
Amount & Transactions: Both amounts and transactions are taken into consideration.
Show "Print last receipt" button on sales screen
(Only in retail mode and quick service mode) Activate/deactivate "Static Print" pushbutton on the sales screen. Once this option is activated, you can print the latest sales receipt.
NoteThe 'Print' pushbutton is available for the retail and quick service modes.
NoteDepending on the print setting options you have maintained in the configuration, these options will applied and used. For more information, see Customizing Print Templates [page 74].
Standard receipt mode (SAP Business One only) If you have enabled Show receipt mode select box on sales screen (see below), you can define here what receipt type is shown as standard in the selection box on the SALES screen:
● Invoice (shown as Direct sale on the SALES screen)● Reserve Invoice
14 CUSTOMERSAP Customer Checkout Configuration Guide
POS System
Option Description
UI Mode UI mode used for the SALES screen.
The following UI modes are possible:
● Quick ServiceIn quick service mode, SAP Customer Checkout provides a Sales screen, which is quick and easy to use and is adapted to the requirements of catering, especially for kiosks and fast food.
● Table ManagementIn table management mode, SAP Customer Checkout provides a sales and table management screen that is tailored to the catering area, particularly restaurants, bars, and cafés.
● RetailIn retail mode, SAP Customer Checkout provides a sales screen with barcode entry, which is adapted to the requirements in retail and merchandising.
Header discount combination strategy Determines how multiple coupons with relative header discount are taken into account.
Add
The header discounts are added together.
ExampleTwo coupons, each with 10% discount, are added to a sales receipt with a payment amount of EUR 100. The total header discount would be 20% and the payment amount would be reduced to EUR 80 (EUR 100 - (0.1 + 0,1) x EUR 100).
Multiply
The header discounts are multiplied.
ExampleTwo coupons, each with 10% discount, are added to a sales receipt with a payment amount of EUR 100. The total header discount would be 19% and the payment amount would be reduced to EUR 81 (EUR 100 x 0.9 x 0.9).
Confirm delivered quantities for sales items on receipt post
(SAP Business One reserve invoices only) Enable/disable the final confirmation of the delivered quantity for the sales items before the receipt is being posted.
Allow Payments for Invoice on Sales Screen
Enable/disable the creation of payment for invoice items on the SALES screen.
Allow Down Payment Invoice Payments on Sales Screen
Enable/disable the creation of down payments on the SALES screen.
SAP Customer Checkout Configuration GuidePOS System CUSTOMER 15
Option Description
Allow paid down payments on sales screen
(SAP Business One only)
Enable/ disable the selection of paid down payments on the SALES screen.
A down payment must already have been created in SAP Business One, and been fully or partially paid before it can be fetched in SAP CCO.
Allow Combination of Sales Items and Payments for Invoice/Down Payment Invoice Payments on Sales Screen
CautionThis feature is supported by SAP Customer Checkout; however, it is not supported by SAP Business One. Do not enable this feature.
Enable/disable option to add other articles to a receipt that contains a payment for invoice item or down payment item.
Allow Special Sales Items on Sales Screen
(SAP Business ByDesign only) Enable/disable the creation of special sales items on the SALES screen.
Allow Tax Rate Change on Sales Screen Enable/disable the option to change the tax rate of a sales item in the current receipt.
Allow Sales Items with Price 0.00 Enable/disable the option to post receipts that contain sales items with a price of 0.00.
Allow discount calculation for new gross amount
Enable/disable the option to enter the new gross amount in the absolute discount dialog. The respective discount is calculated by the application.
Allow negative discounts Enable/disable negative discounts at the receipt and sales item level.
If disabled, you cannot post receipts which contain negative discounts.
Always Split Sales Items Application behavior when an article is added to a receipt.
Enabled: When an article is added to a receipt, a sales item is created by default. The quantity can be adjusted manually, but no pushbutton is displayed.
Disabled: When an article is added to a receipt, a sales item is only created if the receipt does not already contain a sales item of the same article type. A button for splitting or not splitting the order appears on the Sales screen.
Use the cashier as default sales person Enable/disable adding the logged-in salesperson automatically to the receipt.
NoteOnly users that are assigned a salesperson role and ID can be added this way.
Enable Missing Salesperson Check for Receipt Sales
Enable/disable the prompt that requires the user to select a salesperson when a receipt without a salesperson is posted.
Enable missing customer count check for receipt sales (table service)
Enable/disable the prompt that requests users to enter the number of customers when posting a receipt in table service mode.
NoteThe prompt is displayed only if a customer count of 0 has been entered at the time of receipt posting.
16 CUSTOMERSAP Customer Checkout Configuration Guide
POS System
Option Description
Allow Payment of Receipt Using One Card Only
Enabled: Only one card is allowed as a payment item.
Disabled: Multiple cards are allowed as a payment item.
Allow Combination of Payment on Credit with Other Payment Items
Enabled: A receipt can contain a payment on credit and other payment items.
Disabled: A payment on credit cannot be used with other payment items.
Block, if drawer is opened Enabled: Blocks the application as long as the cash drawer is open.
The user cannot execute any action until the cash drawer is closed again. Does not apply to situations where an open cash drawer is necessary (for example, while counting cash during day-end closing).
Disabled: Does not block the application in case the cash drawer is open.
Allow credit notes on sales screen SAP Business One only: Enable/ disable the selection of credit notes on the SALES Screen.
A new credit note has to be created in SAP Business One before it can be fetched in SAP Customer Checkout.
Allow sales order on sales screen (SAP Business One only) Enable/disable the selection of sales orders on the SALES screen.
A sales order has to be created in SAP Business One before it can be fetched in SAP Customer Checkout.
Allow sales quotation on sales screen SAP Business One only: Enable/ disable the selection of sales quotations on the SALES Screen.
A sales quotation has to be created in SAP Business One before it can be fetched in SAP Customer Checkout.
Allow payments on account on sales screen
SAP Business One only: Enable/ disable the selection of payment on account on the SALES Screen.
A payment on account has to be created in SAP Business One before it can be fetched in SAP Customer Checkout.
Show receipt mode select box on sales screen
Enable/disable the display of the selection box for the receipt modes Direct Sale and Reserve Invoice on the SALES screen.
SAP Customer Checkout Configuration GuidePOS System CUSTOMER 17
Option Description
Allow receipt total gross amount of 0.00 by combination with business documents (manual cleaning might be needed)
(SAP Business One only):Enable/ disable the combination with business documents in a receipt on the SALES screen when total gross amount is 0.00.
NoteBy default, this option is disabled. Activating this option means manual clearing in SAP Business One might be needed. We recommend that you do not use this option unless you fully understand its implications.
When this field is activated, you can accept payments for one business document and clear them against another business account.
For example, you can pay for an existing AR invoice from SAP Business One and pay it using an existing credit note from SAP Business One. When this is done, if there is a payment made using any payment means (for example, cash, credit card, and so on), these documents are closed.
If there is no payment made using any payment means, these documents remain open until a manual clearing or automatically clearing is done in SAP Business One.
Examples:
● You have an AR invoice for 100 Euro in SAP Business One. You have a credit note for 90 Euro in SAP Business One.In SAP Customer Checkout, you fetch the AR invoice for 100 Euro, and pay for it using the credit note of 90 Euro and cash 10 Euro. Both documents (AR invoice and credit note) will then be closed in SAP Business One.
● You have an AR invoice for 100 Euro in SAP Business One. You have a credit note for 100 Euro in SAP Business One.In SAP Customer Checkout, you fetch the AR invoice for 100 Euro, and pay for it using the credit note of 100 Euro. Both documents (AR invoice and credit note) will remain open in SAP Business One.
Use ascending sort order for currency units on payment dialog
Enable/disable an ascending sort order for currency on payment dialog in the SALESscreen. If disabled, the currency on the payment dialog is shown in descending sort order.
Enable manual sets Enable/ disable the creation of manual sets on the SALES screen.
18 CUSTOMERSAP Customer Checkout Configuration Guide
POS System
Option Description
Allow adding a coupon whose rules do not match to a receipt
(Quick Service mode only) Enable/ disable the option to add a coupon to a receipt when discount rules (maintained in the SAP Customer Checkout manager) do not match the receipt.
Example:
Enabled: When you add a coupon to a receipt and the discount rules do not match to the receipt (do not affect the selected articles), the assignment of the coupon to the receipt is kept in the background. Once you add an article with rules that do match, the coupon is applied automatically to the respective sales item.
Forbid receipts with a sales item gross/ net amount sum of zero for one tax code
Enable/disable the use of receipts with a sales item gross/ net amount sum of zero (for example, 0 euro) for a non-zero tax code.
For example, this can occur when you add a sales item to the receipt (price: 10 EUR, tax code: A1), and additionally return another sales item (price: 10 EUR, tax code: A1). The sum of the receipt is now 0 EUR. If this option is enabled, the receipt cannot be posted.
NoteAs SAP Business ByDesign does not allow to post receipts with a sales item gross/ net amount sum of zero for non-zero tax code, this option is particularly important for SAP Business ByDesign.
Enable automatic sales set finding (Quick Service mode only) Enable/disable to automatically find a sales set in a sales receipt.
NoteFor more information, read the SAP Customer Checkout Manager Guide, and the SAP Customer Checkout User Guide.
Disable check for unposted receipts SAP Customer Checkout displays a warning when documents that have not yet been transmitted to the SAP back-end system are available. This warning can be deactivated.
Show voided and canceled sales items in the receipt (not relevant for retail mode)
(Only in retail mode) Determines whether voided and canceled sales items are displayed on receipts
SAP Customer Checkout Configuration GuidePOS System CUSTOMER 19
Option Description
Do not distribute header discount to already discounted sales items
This indicator ensures that only one discount is applied to each sales item. Header discount is applied only to sales items that have not yet been discounted.
ExampleA receipt has two sales items each with a gross amount of €100. The first sales item has an item discount of 50%, which reduces the gross amount to €50. A discount of 20% is granted at header level. In this scenario, the header discount is only applied to the second sales item because the first sales item has already been discounted. The payment amount for the receipt would be €130 (€100 x 0.5 + €100 x 0.8 = €130).
Display customer selection on the user interface for quick service and table management mode
Activates the selection and adding of customers in quick service and table management mode.
Show selection bar for customers on the UI If a customer is selected, the customer data is shown in the same area as the selection bar.
Enables the Add to receipt button in the customer search in quick service and table management mode.
Cash payment controls when customer is not selected
NoteThe settings maintained in this section are relevant only for the home currency and not for each currency maintained in the "Currency" tab. In this section, you can set specific rules that determine how the cash payment in SAP Customer Checkout should operate, when there is no customer selected on a receipt. The rules that have been set refer to all sales transactions (sales and return receipts).
Option Description
Maximum cash payment amount (in EUR) Maximum amount to be accepted in cash payment when no customer is selected. If no amount has been set, this option will not be used.
20 CUSTOMERSAP Customer Checkout Configuration Guide
POS System
Option Description
Intended action in event of exceeded limit The action to be performed if the maximum cash payment amount set has been reached.
The following options are possible:
● Inform: Informs the user (who is logged in at SAP Customer Checkout) that more than allowed cash payment is made. The user can decide whether to proceed or cancel the transaction.
● Block: Does not allow the user to continue with the transaction.
● Permission: Doesn't allow the user (who is logged in at SAP Customer Checkout) to proceed. An authorized user (for example, admin user) who has the permission Allow cash payment above limit has to provide the permission in order the action to be executed.
Customized message Message shown to the user on the "Sales" screen.
SAP Customer Checkout provides a default message. However, you can maintain this message manually.
NoteTo return to the default message, blank this field save your edits.
NoteIn case you have maintained several currencies to be supported for the payment, the rules apply to the total amount paid in cash after conversion to the home currency.
Example:
Assuming that your supported payment currencies are EUR and CHF, and you have set an exchange rate of 1 EUR = 1.2 CHF within the Exchange Rate tab. The maximum allowed cash payment amount is 1000 EUR.
On the SALES screen, you create a receipt with an amount of 1,200 EUR.
You pay 500 EUR in cash and 700 EUR are still open to be paid. You select 840 CHF.
In the payment options section, the amount after conversion of the currencies will be 1200 EUR in total (500 EUR + 700 EUR (=840 CHF)). This means that the receipt cannot be posted, as there is a maximum cash payment amount of 1000 EUR. SAP Customer Checkout doesn't check the amount of each individual currency, but does check the total amount in the home currency after conversion.
Cash payment controls when customer is selected
SAP Customer Checkout Configuration GuidePOS System CUSTOMER 21
In this section, you can set specific rules that determine how the cash payment in SAP Customer Checkout should operate, when a customer is selected on a receipt. The rules that have been set refer to all sales transactions (sales and return receipts).
NoteThe settings maintained in this section are relevant only for the home currency and not for each currency maintained in the Currency tab.
Option Description
Maximum cash payment amount (in EUR) Maximum amount to be accepted in cash payment when a customer is selected. If no amount has been set, this option will not be used.
Intended action in event of exceeded limit The action to be performed if the maximum cash payment amount set has been reached.
The following options are possible:
● Inform: Informs the user (who is logged in at SAP Customer Checkout) via a pop-up message that more than allowed cash payment is made. The user can decide whether to proceed or cancel the transaction.
● Block: Disables the user to further proceed with the transaction.
● Permission: Disables the user (who is logged in at SAP Customer Checkout) to further proceed. An authorized user (for example, admin user) who has the permission Allow cash payment above limit has to provide the permission in order the action to be executed.
Customized message Message to be displayed on the SALES screen for the user.
SAP Customer Checkout provides a default message. However, this message can be maintained manually.
NoteIn order to get back to the default message provided by SAP Customer Checkout, you have to delete the entry that you maintained manually (make this field blank), and save your edits.
NoteIn case you have maintained several currencies to be supported for the payment, the rules apply to the total amount paid in cash after conversion to the home currency.
22 CUSTOMERSAP Customer Checkout Configuration Guide
POS System
Example:
Assuming that your supported payment currencies are EUR and CHF, and you have set an exchange rate of 1 EUR = 1.2 CHF within the Exchange Rate tab. The maximum allowed cash payment amount is 1000 EUR.
On the SALES screen, you create a receipt with an amount of 1,200 EUR.
You pay 500 EUR in cash and 700 EUR are still open to be paid. You select 840 CHF.
In the payment options section, the amount after conversion of the currencies will be 1200 EUR in total (500 EUR + 700 EUR (=840 CHF)). This means, that the receipt cannot be posted, as we have set a maximum cash payment amount of 1000 EUR. SAP Customer Checkout will not check the amount of each currency by its own, but the amount in home currency after conversion in total.
Automatic lock
NoteAutomatic locks can be defined at three different levels:
● POS system● Role● Users
The different levels are arranged hierarchically. Settings at POS system level can be overwritten by settings at role and user level. Settings at role level can be overwritten by settings at user level.
Option Description
Lock time (in seconds) Locks the screen if the user is inactive for the length of time specified.
Logout time (in seconds) Logs the SAP Customer Checkout user out if he or she is inactive for the length of time specified.
Show warning before automatic lock/logout Warns the user 10 seconds before SAP Customer Checkout locks the screen or logs the user out.
NoteThis setting is only available at POS system level.
Action after posting Executes the selected action after a sales receipt is posted. Available actions:
● WithoutDoes not perform any action
● LockLocks the screen
● LogoutLogs the user out from SAP Customer Checkout
SAP Customer Checkout Configuration GuidePOS System CUSTOMER 23
3.5 Master Data
Master data settings
Option Description
Remove leading characters from article ID
Enable/disable removal of leading characters when the article ID is entered on the SALES screen or in the search dialog box. The original article ID can still be used.
NoteIf this option is enabled, the Length of Article ID option is required.
ExampleArticle ID: 000012345
Remove leading characters: 0
● The article ID can be entered as 000012345 or 12345.● If this field has no value, this function is not active. If the field has a value,
the function is enabled.
Length of article ID Number of characters used in the article ID; required if Remove Leading Characters from Article ID is enabled.
Remove leading characters from customer ID
Enable/disable removal of leading characters when the article ID is entered on the SALES screen or in the search dialog box. The original article ID can still be used.
NoteIf this option is enabled, the Length of Customer ID option becomes mandatory.
ExampleCustomer ID: 000012345
Remove leading characters: 0
● The customer ID can be entered as 000012345 or 12345.● If this field has no value, this function is disabled. Otherwise, the function
is enabled.
Length of customer ID Number of characters used in the customer ID; mandatory entry if the Remove Leading Characters from Customer ID option is enabled.
Allow Creation and Update of Customer Data
If enabled, users can create customers and edit customers using the customer search function.
Enable duplicate check for customer data
Enable/disable a duplicate check when a new customer has been created on the SALES screen.
24 CUSTOMERSAP Customer Checkout Configuration Guide
POS System
Option Description
Consent Required In SAP Customer Checkout manager, users, customers, loyalty users, and one-time customers have the Consent given and maintained indicator and the Consent document version field to document whether a person has consented to the processing of their personal data.
You can enable or disable this option to make the Consent given and maintained option a required entry field for users, customers, and loyalty users in SAP Customer Checkout.
Enabled: When creating and changing users, customers, loyalty users, and one-time customers, the Consent given and maintained indicator must be enabled.
NoteThis requires that the affected person has given consent for the processing of their personal data.
Disabled: When creating and changing users, customers, loyalty users, and one-time customers, the "Consent given and maintained" indicator need not be enabled.
3.6 Consent version code
The processing of personal data requires the consent of the person whose data is to be processed. Therefore, users, customers, loyalty users, and one-time customers have a data field in which the version of the consent can be saved. The versions of the consents can be managed in this code list.
Settings for the version code of consent
Option Description
Description Description of the version of the consent.
Code Code value of the version of the consent.
NoteIf a version code is in use, it cannot be deactivated and the code value cannot be changed.
SAP Customer Checkout Configuration GuidePOS System CUSTOMER 25
3.7 Sequence Numbers
Define how IDs for a specific number of entities are generated by the application. These entities consume sequence numbers. Each sequence number is defined by a pattern, which describes how numbers are generated. This allows you to create user-defined IDs for receipts, vouchers, and so on.
Sequence Numbers Settings
Option Description
Name Sequence number name.
Pattern Sequence number pattern. Uses Freemarker-based XSL to describe how the numbers are generated.
Current sequence The last sequence number that was generated.
Current number The last number that was used in the sequence number.
Initial number The initial number that generates the first number according to the settings.
(First number = Initial number + Increment size)
Increment Size The value by which the number is incremented.
Reset on change The pattern for the sequence number consists of a Freemarker part and a number part. If the Freemarker part changes according to the pattern, the number part can be reset to its initial value.
Example: Inserting the current year into the pattern via XSL resets the number with the turn of the year.
Enabled:
Resets the current number when the Freemarker part changes.
Disabled:
Does not reset the current number.
Allow gap Enabled:
Gaps between IDs may occur. Allows parallelization when fetching IDs, which can improve application performance.
Disabled:
Ensures that the IDs are fetched without gaps in a consecutive sequence. Forces the application to fetch IDs sequentially, which can diminish performance.
Delete Deletes the entry.
26 CUSTOMERSAP Customer Checkout Configuration Guide
POS System
3.8 Sequence Number Consumer
Define the sequence number from which entities fetch their IDs.
Sequence Number Consumer Settings
Option Description
Sequence number consumer The entity that consumes sequence numbers
Sequence number The sequence number assigned to the sequence number consumer
3.9 Field Mapping
For information about field mappings, see the SAP Customer Checkout Integration Guide.
3.10 Setting up Central Drawer Management
When using the central drawer management, every cashier has his or her own drawer and can switch between POS systems. Drawer data is synchronized with SAP Customer Checkout manager when the cashier logs out and logs on again. Drawers are managed using SAP Customer Checkout manager.
Context
CautionWhen using central drawer management, SAP Customer Checkout must be permanently connected with SAP Customer Checkout manager.
Procedure
1. Open the Integration tab.
NoteIf SAP Customer Checkout is connected with SAP Customer Checkout manager only, central receipt management is activated by default.
SAP Customer Checkout Configuration GuidePOS System CUSTOMER 27
2. Activate central user management and central receipt management.3. Open the POS system tab.4. In the General section, set the Usage Mode to Central drawer management.5. Go to the Day-End Closing screen and perform a day-end closing.
By default, when you log on, the application runs in single cashier mode. To end this mode correctly, a day-end closing must be carried out during a switch. If the current day-end closing does not contain any receipts, it is automatically set to ''Finished'' and an automatic logout occurs.
6. For each drawer used in your company, create a drawer in the drawer management of SAP Customer Checkout Monitor.
For more information, see the SAP Customer Checkout manager Guide.7. If required, provide users with the authorization to take over cash drawers that have the status in transit.
By default, users can only take over idle drawers. In some cases, it makes sense to also allow users to take over in-transit drawers, for example, if sales managers perform the day-end closings for their employees.
a. Open the User configuration.b. Select a user.c. Choose Edit and set Can take over in transit drawers to Allowed.d. Save your changes.
28 CUSTOMERSAP Customer Checkout Configuration Guide
POS System
4 Accounting
Configure a wide range of accounting settings.
4.1 Credit Card Type
Credit Card Types
Option Description
Type Code ERP Key for credit card from the SAP ERP system
Description Describes the credit card type; used for reference in other parts of the configuration screen. This value is displayed to the user in the Card Payment dialog box if no logo is provided.
Logo Image file used as logo in the Card Payment dialog box for this credit card type. If no logo is selected, the description is used instead.
Click the plus sign in edit mode to open Windows Explorer and select an image file.
Credit Card Number SAP Business ByDesign only: Enter a valid dummy credit card number for the credit card provider. When the config-ured ERP system is SAP Business ByDesign, the credit cards must be synchronized once during initial application setup. To execute synchronization, choose Post to External System . This creates the corresponding entry in the SAP Business ByDesign system. If synchronization is successful, the Posted to External System checkbox is selected. Each time this credit card is used in a receipt, this value is also sent to SAP Business ByDesign to identify the credit card.
Visible Defines whether the credit card is visible in the Card Payment dialog box on the SALES screen.
Posted to External System SAP Business ByDesign only: Displays the current status of synchronization with SAP Business ByDesign. The checkbox is selected if synchronization was successful.
SAP Customer Checkout Configuration GuideAccounting CUSTOMER 29
Option Description
Clearing house account ID SAP Business ByDesign only: Displays the clearing house account ID from the SAP Business ByDesign system.
NoteThis field can be manually edited. If no value is maintained manually, the default Clearing house account ID from the Integration tab is taken.
Active If a credit card type is enabled and allowed as payment method, it will be shown in CASHING-UP and Day-End Closing.
NoteThe distinction of Visible and Active is especially important when using an integrated terminal. In this mode only one general credit card type (e.g. Card Payment) has to be visible, but all other credit card types (e.g. Visa, Master, EC, etc.) have to be activated and not visible.
General Ledger Account Value of general ledger accounts used in SAP Business ByDesign or SAP Business One.
For SAP Business ByDesign these are required so that special sales items can be used.
SAP Business One requires these entries if you want to post cash balancing receipts at day-end closing to SAP Business One.
4.2 Tax Rates
Tax rates
Option Description
Country/Region Country/region in which this tax rate applies
Tax Rate Type Tax rate type used for sales items on printed receipts. You also see tax rate types on the pay-in and pay-out transaction screens, where you can select a tax rate for a transaction.
Tax rate characteristics code SAP Business ByDesign: Maintain the code values.
SAP ECC or SAP Business One: Enter the tax rate type.
30 CUSTOMERSAP Customer Checkout Configuration Guide
Accounting
Option Description
Percentage Tax rate in percent
Valid From Date as of this tax rate is valid and can be used by SAP Customer Checkout.
Valid to Date until this tax rate is valid and can be used by SAP Customer Checkout.
Description Description displayed on the SALES screen in the Create/Change Article dialog box for this tax rate.
Active Enabled: Tax rate is used in the application.
Disabled: Tax rate is not used in the application.
4.3 Payment Terms
Required settings for SAP Business ByDesign and SAP Business One.
Payment Terms
Option Description
Description Description used on the user interface
Code Code values used by SAP Business ByDesign or SAP Business One
4.4 Petty Cash
Required settings for SAP Business ByDesign and SAP Business One. Maintain these settings for each currency.
Petty Cash Accounts
Option Description
Currency Currency used for this entry.
Petty cash ID Account for cash payments in the current currency. In general, if the cash drawer is configured as an account in the ERP system, the cash drawer account number is maintained here.
Master petty cash ID Master account for cash payments in the current currency. In general, during a cash-in or cash-out transaction, the account to which the money from the cash drawer is credited or from which the money is moved to the cash drawer.
Description Description of configuration.
SAP Customer Checkout Configuration GuideAccounting CUSTOMER 31
4.5 Financial Transaction Types
SAP Business One and SAP ECC support posting to the ERP system for pay-in or pay-out transactions. Transation types are shown on the CASH-IN/CASH-OUT screen when the pay-in/pay-out function is used.
Financial Transaction Types
Option Description
Code Custom internal value for pay-in/pay-out.
Description Description shown in the Type list on the CASH-IN/CASH-OUT screen.
Financial transaction type The financial transactions for which this entry is valid: pay-in only, pay-out only, or both.
Active Enabled: The transaction type appears on the CASH-IN/ CASH-OUT screen.
Disabled: The transaction type doesn't appear on the CASH-IN/ CASH-OUT screen.
4.6 Period-End Close Settings
SAP Customer Checkout supports period-end closes with different periods (monthly, annual, etc). The starting points of fiscal years can be defined. In addition, you can select various settings for calculating the grand total.
NotePeriod-end closes are required for configuring SAP Customer Checkout according to French POS system requirements (NF 525).
Settings for Period-End Close
Setting Description
Period-end close activated Activates period-end closes for SAP Customer Checkout with the selected settings
Perform integrity check after annual period-end close Once you have performed an annual period-end close the system automatically performs an integrity check.
Daily period-end close Creates a period-end close for each day
Start of business day Specifies at what time the business day starts. This setting applies to all period-end closes.
Weekly period-end close Creates a period-end close for each week
32 CUSTOMERSAP Customer Checkout Configuration Guide
Accounting
Setting Description
Start of business week Specifies on which day the business week starts. This setting applies to all period-end closes.
Monthly period-end close Creates a period-end close for each month
Quarterly period-end close Creates a period-end close for each quarter
Annual period-end close Creates a period-end close for each year
Start of business year Specifies in which month the business year starts. This setting also applies to quarterly period-end closes.
Unlimited period-end close Creates a period-end close that never ends
Grand Total Settings
Setting Description
Grand Total per Receipt Activates calculation of grand total for each receipt
Calculation base Specifies whether calculations are to be made based on gross or net values
Calculation with absolute values Specifies whether the plus/minus sign is to be considered in the calculation
4.7 Day-End Closing Settings
The day-end closing settings allow you to configure automatic day-end closing and other settings that affect day-end closing.
Automatic day-end closing can be scheduled for a specific time at fixed intervals. No user interaction is needed to perform automatic day-end closing, and no receipts are printed (but they can be printed manually if required). When automatic day-end closing is carried out, all target values for payments and stocks are used unchanged as actual values in day-end closing.
Automatic day-end closing is not carried out exactly at the scheduled time. As soon as the planned time is reached, the following actions can trigger the execution:
● Posting a receipt● Receipt synchronization● Starting the application
(However, this is only the case if SAP Customer Checkout uses local drawer management)
Day-end closing is then executed automatically in the background.
SAP Customer Checkout Configuration GuideAccounting CUSTOMER 33
NoteAutomatic day-end closing cannot be used in combination with central drawer management.
General Settings for Day-End Closing
Setting Description
Default cash-out type for day-end closing cash-out dialog Cash-out type that is set as the default when day-end closing is performed.
NoteIn Central Drawer Management mode, only theRemaining Amount option can be used.
Possible values:
● Amount to remain● Amount to be cashed out
Allow change of the cash-out type during day-end closing process
If you activate this option, you can select between the Amount to be cashed out and Amount to remain types during the cash-out step of the day-end closing process.
If the option is deactivated, the system displays only the value configured in the Default cash-out type for day-end closing cash-out dialog.
NoteIn Central Drawer Management mode, this setting has no effect and the cash-out type cannot be customized.
Force a cash-in if there is no cash amount after a day-end closing
Forces the application to perform a cash-in, when there is no cash at a day-end closing.
ExampleWhen you perform a day-end closing and set the remaining cash amount to 0, you reset the SAP Customer Checkout application, and the cash amount to 0. To force the user to perform a cash-in, you must enable this option.
Automatic Day-End Closing Settings
Setting Description
Automatic day-end closing Enables or disables automatic day-end closing.
34 CUSTOMERSAP Customer Checkout Configuration Guide
Accounting
Setting Description
Automatic day-end closing mode Amount to be cashed out
During automatic day-end closing, a cash-out for the entire current cash balance is posted. The following day-end closing begins with a cash balance of 0.
Amount to remain
During automatic day-end closing, no money is withdrawn. Instead, the current cash balance is used in the next day-end closing.
Automatic day-end closing interval Automatic day-end closing can be run at daily, weekly, or monthly intervals.
Execution time Specifies the time at which automatic day-end closing is to be carried out.
Weekday Is only visible if weekly is selected as the interval. Specifies the day of the week on which automatic day-end closing is to be carried out.
Day of month Is only visible if monthly is selected as the interval. Specifies the day of the month on which automatic day-end closing is to be carried out.
Next automatic day-end closing date Date and time for the next scheduled run of automatic day-end closing, taking into account the current settings.
SAP Customer Checkout Configuration GuideAccounting CUSTOMER 35
5 Sales
5.1 Price Lists
In this section, you can manage price lists and define what price lists are to be synchronized with the ERP system. At least one price list has to be maintained to synchronize articles. Before a price list can be used, it has to be entered in the Price lists table.
NoteMultiple price lists are supported only if SAP Customer Checkout is integrated with SAP Business One or SAP Customer Checkout manager. SAP Business ByDesign only supports a single price list. SAP ECC does not support price lists, but SAP Customer Checkout can process condition types from SAP ECC in such a way that they can be used as price lists in SAP Customer Checkout.
NoteWhen using central price list management of SAP Customer Checkout manager, please note the following features:
● Price lists are automatically synchronized by SAP Customer Checkout manager through article synchronization. This section is read-only and not editable.
● If you do not specify a price list as a default price list in SAP Customer Checkout manager, SAP Customer Checkout uses the first active entry as the default price list.
● If the SAP Customer Checkout system detects changes in the price list assignment settings (that you have made in SAP Customer Checkout manager) while synchronizing articles, SAP Customer Checkout converts a delta synchronization into a full synchronization. This takes place only if you add or remove a price list to or from SAP Customer Checkout manager or if the Synchronize (in PoS) option is deactivated. However, if you activate (or deactivate) the price lists, or change the default settings for price lists in SAP Customer Checkout manager, the SAP Customer Checkout system only performs a delta synchronization and not a full synchronization.
● To view the users and roles assigned to a price list, select the relevant price list on the PRICE LISTS tab. The corresponding users and roles are displayed below the price lists table.
36 CUSTOMERSAP Customer Checkout Configuration Guide
Sales
Price Lists
Option Description
ID ID of the price list in the ERP system.
NoteIf SAP Customer Checkout is integrated with SAP ECC, price lists are assigned using the condition type (<KONDART>). Condition types that are to be used as price lists must use the Prices condition class and Quantity calculation type in the SAP ECC system.
CautionCondition types that are to be processed as discounts must be maintained in the table for condition types. For more information about condition types, see section Condition Type [page 96].
If a condition type has been incorrectly processed as a price list, you can deactivate it in the table for price lists.
Description Description of the price list in the ERP system. Is fetched during synchronization.
Gross price This setting determines price handling in SAP Customer Checkout, irrespective of price handling in the ERP system.
Enabled:
Prices from the ERP system are handled like gross prices.
Disabled:
Prices from the ERP system are handled like net prices.
Default One of the price lists must be the default price list. It is not possible to set multiple default price lists. The default price list is used if no customer is selected on the SALES screen, the selected customer has no price list, the selected customer's price list is not active, or the price list is unknown.
Active Enabled:
Price list is available in the application.
Disabled:
Price list is not available in the application.
Synchronize Enabled:
Price list is synchronized during article synchronization. If you enable this setting, you must execute a Complete Synchronization to fetch all prices from the ERP system.
Disabled:
Price list is not synchronized during article synchronization. To disable this setting, it is mandatory to delete all prices of the respective price list.
SAP Customer Checkout Configuration GuideSales CUSTOMER 37
5.2 Stock Location
Maintain stock locations so that when articles are sold or returned, the cashier can choose from the entries in the list.
These settings are relevant when the configured ERP system is SAP Customer Checkout manager, SAP Business ByDesign, or SAP Business One
Stock Location
Option Description
ID ID from SAP Customer Checkout manager, SAP Business ByDesign, or SAP Business One
Description Description displayed on user interface
Default for sales
Default for return
Mark an entry as the default value. This value is proposed first to the user. If no default stock location for returns is defined, the user sees the default stock location for sales.
Sales Allows the cashier to select a stock location for an article.
Return Allows the cashier to select a stock location for a returned article.
Stock Overview Shows the stock of this location in the stock overview. If you do not enable this setting for any location, the stock for all locations you maintain is shown in the stock overview.
Standard delivered quantity mode (only for reserve invoices)
The default delivery quantity for reserve invoices on the SALES screen. Possible values include:
● Zero (the delivery quantity has to be entered manually)● Equal to Quantity (the delivery quantity will be equal to the quantity of the
sales item for this selected stock location).
Example:
When a reserve invoice has been created for a sales item, the delivery quantity is set to the preconfigured standard delivered quantity mode of the default stock location for sales. If you change the stock location of the selected sales item (in the position field), the delivery quantity automatically changes to the preconfigured standard delivered quantity mode of this selected stock location, unless you have not changed the delivery quantity manually.
38 CUSTOMERSAP Customer Checkout Configuration Guide
Sales
5.3 Customer Return Reason Code
Customer return reason settings are relevant if the configured ERP system is SAP Business ByDesign or SAP Business One.
Customer Return Reason Code
Option Description
Description Description displayed on user interface
Code Code value sent to SAP Business ByDesign and SAP Business One for this return reason
Default Indicates whether the return reason is used as default value
If SAP Customer Checkout is integrated with SAP Business ByDesign or SAP Business One and the cashier selects a return reason, it is passed with the receipt to the ERP system. However, SAP Business One does not fully support this feature. Therefore, in SAP Business One, the discount purpose code is shown in the free text field of the sales.
5.4 Discount Purpose
Discount purpose settings are relevant if the configured ERP system is SAP Business ByDesign or SAP Business One.
Discount Purpose
Option Description
Description Description displayed on user interface
Code Code value sent to SAP Business ByDesign and SAP Business One for this discount purpose
Default Indicates whether the discount reason is used as default value
If SAP Customer Checkout is integrated with SAP Business ByDesign or SAP Business One and the cashier selects a discount purpose, it is passed to the ERP system together with the receipt. However, SAP Business One does not fully support this feature. Therefore, in SAP Business One, the discount purpose is shown in the free text field of the sales item and in the remarks field of the receipt.
SAP Customer Checkout Configuration GuideSales CUSTOMER 39
5.5 Customer Groups
SAP Customer Checkout includes predefined customer groups.
When you create a new customer in SAP Customer Checkout, you can assign the customer to a customer group. Using customer groups, you can determine which discounts are applicable for a customer.
In the Customer groups section, you can do the following:
● Add a new customer group● Delete customer groups
NoteYou can delete a customer group only if you've not yet used it.
● Edit the description
5.6 Article ID of Voucher
Article ID of Voucher
Option Description
Voucher Article ID Article ID of the voucher that creates a voucher on the SALES screen when entered as the article ID; must match the corresponding article ID of the voucher configured in the ERP system
Voucher Article Description Custom description printed on the receipt and used on the SAP Customer Checkout UI as the voucher description
Amount Sets the initial value of the voucher when it is created on the SALES screen; can be edited
Validity Period Date as of which this voucher is valid and can be used by SAP Customer Checkout
Voucher Receipt Header Defines the custom voucher receipt header on the printed voucher; if left blank, the default value (Voucher) is used
Default Defines this voucher as default voucher. If any vouchers are configured in this table, one of these must be the default voucher. It is not possible to define multiple default vouchers.
Ask for Voucher ID on Creation Defines whether the user is prompted to enter a custom voucher ID when a voucher is created on the SALES screen.
40 CUSTOMERSAP Customer Checkout Configuration Guide
Sales
Option Description
Enable voucher topups Enables/disables the voucher topup feature on the sales screen
NoteThis field is enabled by default.
Always Redeem Entire Voucher Defines whether the entire voucher value is entered automatically when a voucher of this type is used as payment
Print Voucher on Special Slip (Must Be Supported by Printer)
Defines whether the voucher is printed on a special slip; only possible if the printer supports this
Print Voucher for Internal Use Defines whether an additional voucher is printed for internal use (for example, as documentation)
Journal Account/ Financial Transaction Type
General ledger account number in the respective ERP system for the voucher type
Credit card alias code Key number in the respective ERP system for the voucher type
5.7 Decimal Places
In this section, you can manage the decimal places for the quantity, the absolute and relative discounts, and for taxes shown in the UI. Decimal places that are shown in the UI can differ from the decimal places that are used internally in the calculation logic.
NoteIf decimal places are modified in the Configuration, they are transmitted to all the fields of the SAP Customer Checkout (SALES, CASH-IN/ CASH-OUT, Day-End Closing, CASHING-UP) and the printed receipt.
Decimal Places
Option Description
Decimal Type This is the type of item where a change of decimal places is possible. SAP Customer Checkout supports four decimal types: quantity, absolute discount, relative discount, tax.
Formatter decimal places Determines how many decimal places are shown in the UI.
Calculation decimal places Determines how many decimal places are used internally in the calculation logic.
SAP Customer Checkout Configuration GuideSales CUSTOMER 41
5.8 Tip Handling
In this area, you can specify how to deal with tips.
A tip is an amount of money that a customer paid voluntarily on top of the price asked.
You can operate tip handling in various modes:
● Tip handling deactivated● Tip handling activated
○ Do not record tips○ Record tips
5.8.1 Tip Handling Deactivated
In this mode, all tip handling features are deactivated and tips are not taken into account during the sales process.
5.8.2 Do not record tips
In "do not record tips" mode, the amount of tips given upon payment is not traced. During day-end closing, it is possible to specify what tip amount is to be paid out. By default, tips can only be paid out if cash balancing is positive. Positive cash balancing limits the maximum possible pay-out for tips.
To bypass this limit, the following setting can be activated in the tip handling configuration: Allow tip payouts to create negative cash balancing. If this setting is activated, the cash balance limits the maximum pay-out for tips.
"Do not record tips" mode can be used in all three modes of operation (Quick Service, Table Management, and Retail).
5.8.3 Record tips
In "record tips" mode, the tip amount can be entered upon payment. For day-end closing, the totaled tip amounts are displayed broken down by payment method. During day-end closing, the user can specify what tip amount is to be paid out.
To use "record tips" mode, a separate article is required, hereafter referred to as a "tip article". The tip article is used for capturing tip payments within the application and for transferring receipts with tip payments to the SAP back-end system.
42 CUSTOMERSAP Customer Checkout Configuration Guide
Sales
Every tax-exempt and non-discountable article can be used as a tip article. If the tip article has other properties, this article is set to tax-exempt and non-discountable when the articles are synchronized in SAP Customer Checkout.
The tip article ID can be specified in the tip handling configuration.
Tip articles cannot be directly added to a receipt. In Retail mode, however, this is possible because the tip article is handled as a normal article in this mode.
Generally, "record tips" mode can be used in all three modes of operation (Quick Service, Table Management, and Retail). However, a tip payment cannot be created upon payment in Retail mode, and the tip article is handled as a normal article.
5.8.4 Tip Handling Configuration
The tip handing configuration contains the following settings:
Setting Description
Tip Handling Enabled: Tips are taken into account during day-end closing
Disabled: Tips are not taken into account during day-end closing
Tip Mode (only if tip handling is enabled)
Two modes are available:
● Do not record tipsTip payments are not traced. In this mode, you can decide during day-end closing what tip amount is to be paid out.
● Record tipsTip payments are traced and displayed during day-end closing. During day-end closing you can decide which tip amount to pay out.
General ledger account General ledger account that is transferred to the SAP back-end system for tip payment.
SAP Customer Checkout Configuration GuideSales CUSTOMER 43
Setting Description
ID of Tip Article ID of the article that is to be used as the tip article
NoteIf an article with this ID does not yet exist, it is created in SAP Customer Checkout when you save. This aims to ensure that SAP Customer Checkout can be set to tip tracing mode at any time. However, to enable receipts with tip article to be transferred to SAP Business One or SAP ByDesign, a corresponding article with a matching ID must be created there.
Allow tip payouts to create negative cash balancing If this setting activated, tip pay-out is not restricted to the positive cash balancing amount during day-end closing. The entire cash balance is available as pay-out amount.
This setting has an effect only if the tip handling mode is set to Unrecorded Tips.
5.8.5 Adjusting the Tip Handling Configuration
Context
Procedure
1. Select the Sales tab.2. On the Sales tab, select Tips.3. Choose Edit.4. Make the required changes to the tip configuration.5. Choose Save.
44 CUSTOMERSAP Customer Checkout Configuration Guide
Sales
5.8.6 Tip Amounts on Receipts
Depending on the tip handling mode, information about tip payments is printed on receipts in different ways:
Tip Handling Mode Print Output on Receipts
Tip handling deactivated No tip information
Do not record tips General tip information on cash desk closing receipts
Record tips Detailed tip information on cash desk closing receipts and sales receipts
SAP Customer Checkout shows the amounts posted for tips in the relevant currency on the receipt for day-end closing.
5.9 Expenses
In this section, you can make settings for expenses.
Expenses are pay-outs of cash for customers. Customers must pay the expenses when paying for the receipt. For example, a customer can request an expense for the purchase of articles at a vending machine and later pays the expense by credit card when paying for the receipt.
To ensure that expenses can be used, an article ID that is used for the expense must be maintained. Furthermore, you can specify a general ledger account for the article ID. This G/L account is then also sent when the article ID is used.
NoteSAP Customer Checkout supports expenses only in conjunction with SAP Business One, SAP ECC, and SAP Customer Checkout manager.
NoteSAP Customer Checkout supports expenses in Table Management and Quick Service modes only.
NoteFor the use of expenses in conjunction with SAP Business One or SAP ECC, an article must exist with the maintained article ID for expenses. If SAP Customer Checkout is only connected to SAP Customer Checkout manager, however, it is not necessary to create an article in SAP Customer Checkout manager with the maintained article ID for expenses.
SAP Customer Checkout Configuration GuideSales CUSTOMER 45
5.10 Loyalty Management
In this section, you can make settings for loyalty management.
Loyalty management allows you to award loyalty points to your customers for sales, which they can later use for purchases. SAP Customer Checkout offers logic for calculating points in two different ways, which can either be executed locally in SAP Customer Checkout or remotely in SAP Customer Checkout manager. Furthermore, the plug-in concept of SAP Customer Checkout allows you to implement your own calculation logic, which can be used for calculating, awarding, and using loyalty points.
You have to activate loyalty management in every SAP Customer Checkout application in which you want to use it.
NoteA prerequisite for using loyalty management is a permanent connection to SAP Customer Checkout manager. If a local calculation logic is selected in SAP Customer Checkout for calculating points, a loyalty configuration does not need to be created and used in SAP Customer Checkout manager.
NoteLoyalty management can be used together with SAP Business One, SAP Business ByDesign, or SAP ECC.
CautionLoyalty points can be used to reduce the receipt amount to be paid. Essentially, the payment amount can hereby be reduced to 0. SAP Business ByDesign rejects receipts for which the payment amount is 0. This means that receipts must not be reduced to a payment amount of 0 if you are working with SAP Business ByDesign.
Settings
Option Description
Loyalty management Indicates whether loyalty management is active.
46 CUSTOMERSAP Customer Checkout Configuration Guide
Sales
Option Description
Point calculation Specifies which logic is used for calculating points.
NoteThe plug-in concept of SAP Customer Checkout allows you to develop customer-specific logic for calculating and processing points. If the plug-in operates the relevant interfaces, the point calculation logic of the plug-in can be selected instead of the existing standard calculations.
Standard Calculation (Local)
Uses the standard logic of SAP Customer Checkout to calculate points.
Standard Calculation (Remote)
Uses the standard logic of SAP Customer Checkout manager to calculate points.
Loyalty points per EUR spent Indicates the exchange rate of the currency used in SAP Customer Checkout for loyalty points.
ExampleIn the following example, it is assumed that SAP Customer Checkout uses euro as the currency. If you select the value 10 for the exchange rate, 10 loyalty points are credited per euro spent for sales.
EUR per loyalty point used Indicates the exchange rate of loyalty points for the currency used in SAP Customer Checkout.
ExampleIn the following example, it is assumed that SAP Customer Checkout uses euro as the currency. If you select the value 0.01 for the exchange rate, customers can get a one euro discount on their purchases for 100 loyalty points collected.
SAP Customer Checkout Configuration GuideSales CUSTOMER 47
6 Currency
In SAP Customer Checkout, you can maintain multiple currencies.
The following currencies are pre-delivered by SAP Customer Checkout:
● EUR● CHF● GBP● PLN● SEK● DKK
SAP Customer Checkout uses the euro as the default currency. If you intend to use a different currency, you must maintain it in the Currency and Currency Unit tables.
CautionSales reports in SAP Customer Checkout manager can process only one currency. If SAP Customer Checkout Manager is connected to an SAP Customer Checkout application that uses multiple currencies, sales reports cannot be used.
6.1 Currency
You can maintain multiple currencies to use with SAP Customer Checkout. Using multiple currencies is supported only by SAP Business One and SAP Business ByDesign.
NoteThe currency that acts as the main currency must be set in the POS system tab of the configuration (for more information, see General [page 11]).
Currency
In this section, you add currencies:
Currencies
Option Description
Currency International three-letter currency code
48 CUSTOMERSAP Customer Checkout Configuration Guide
Currency
Option Description
Payment supported Enable the currency in SAP Customer Checkout
Decimals The number of decimal places that are shown for the currency in the UI
Delete Delete Entry
To add a currency, choose Edit at the top of the screen, enter the currency, and select the checkbox in the Payment Supported field. Save your changes.
Currency unit
In this section, you maintain the following currency unit settings:
Currency unit
Option Description
Money type Coin, Banknote
Unit Value of the currency unit
Logo Logo used for the currency unit in the payment dialog boxes throughout the application
NoteIn quick service and table management mode, the four notes with the lowest values of the configured currency always appear on the sales screen as symbols.
To edit the currency units, choose Edit at the top of the screen and select the currency for which you want to edit the currency units. The Currency Unit section is updated with any entries that exist for the selected currency.
To add a currency unit, choose Add below the Currency Unit table. Select a Money Type and enter a Unit.
To add a logo, click the plus sign to open Windows Explorer and select the image file to be used as the logo for this currency unit. The image file you provide is resized accordingly. The following image formats are supported: PNG, GIF, and JPG.
NoteSwiss currency (CHF) icons are included with SAP Customer Checkout. These icons will appear for the respective denominations not until the application was restarted, however.
SAP Customer Checkout does not deliver icons for the following currencies: GBP, PLN, SEK, DKK
SAP Customer Checkout Configuration GuideCurrency CUSTOMER 49
Currency Rounding
In this section, you maintain currency specific rounding rules:
Currency Rounding
Option Description
Country/Region Country/region to which rounding rules are applied. A rounding rule is used only if the country/region is the same as was maintained on the "POS system" tab of the configuration (for more information, refer to section Info [page 10]).
Currency The currency for which the rounding rule is used.
Description Description for the rounding rule.
Decimals Precision of the rounding rule. Determines how many decimal places are taken into consideration during rounding. If no special circumstances apply, use the value 2.
Rounding to The smallest possible unit to which can be rounded to.
Example:
If each rounded result should be a multiple of 0.05, maintain the value 0.05.
Rounding level The level at which the rounding rules are used.
Not used: No rounding rule is used.
Header:
The rounding rule is used on the total amount of the receipt.
Note: Header rounding values in SAP Customer Checkout are handled as discounts in SAP Business One.
Sales item:
The rounding rule is used on each sales item
Delete Delete the entry.
NoteIf a customer pays in a foreign currency that uses currency rounding, the Remaining amount in target currency in the payment dialog is always rounded up.
50 CUSTOMERSAP Customer Checkout Configuration Guide
Currency
Cash Replenishment
In this section, you can maintain the cash replenishment settings for your each of your currencies you have set as supported currencies:
Currency unit
Option Description
Minimum cash expected The minimum amount of cash that is expected to be in the drawer.
NoteIf you do not enter a value in this field (leave it blank), this feature is not used.
Maximum cash expected The maximum amount of cash that is expected to be in the drawer.
NoteIf you do not enter a value in this field (leave it blank), this feature is not used.
Frequency How often the user (logged in in SAP Customer Checkout) is to be informed when the minimum or maximum of cash limit is reached.
The following options are possible:
● One time per sales screen: Every time the user (who is logged in in SAP Customer Checkout) selects the SALES screen, this message is shown.
ExampleAssuming that the user (cashier) opens the SALES screen and is informed that there is too much cash in the drawer. The user performs several sales transactions (e.g. posting of five receipts). The user is not informed again that there is too much cash in the drawer until he or she selects another screen. Once the user selects another screen (for example, CASH-IN/CASH-OUT), and then returns to the SALES screen, the message is shown again.
● After every transaction: Every time a receipt is created in the SALES screen, the user is informed.
Note
ExampleAssuming that your supported payment currencies are EUR and CHF, and you have set the following cash replenishment amounts for your currencies:
Minimum cash expected (EUR): 100
Maximum cash expected (EUR): 1,000
Minimum cash expected (CHF): 100
SAP Customer Checkout Configuration GuideCurrency CUSTOMER 51
Maximum cash expected (CHF): 1,000
In your SAP Customer Checkout drawer, you have 50 EUR and 1,300 CHF.
The user who logs in to SAP Customer Checkout sees the following messages in the SALES screen:
Cash in EUR is too low. Current amount is 50. Minimum cash expected is 100.00.
Cash in CHF is too high. Current amount is 1,300.00. Maximum cash expected is 1,000.00.
The user can now decide how to continue: Whether to pay CHF out of the drawer (or perform a cash out), or to pay EUR into the drawer (or perform a cash in).
6.2 Exchange Rates
Use the Exchange Rates subtab to maintain exchange rates between different currencies.
NoteYou must maintain an exchange rate for each currency.
Exchange Rates
Option Description
Source currency code The currency code of the POS system. For more information, see section Currency [page 48].
Target currency code The target currency.
Middle rate The middle rate between source and target currency.
Calculation:
“amount in source currency” = “middle rate” * “amount in target currency”
Basic unit The basic unit which is used in the calculation. You cannot change this value
Valid from The date from which the exchange rate can be used in the application
Active Enable/disable the exchange rate in the application.
52 CUSTOMERSAP Customer Checkout Configuration Guide
Currency
6.3 Cash Replenishment
In this section, you can define custom messages for your cash replenishment setting that you have set within the Currency subtab. You can maintain what the SAP Customer Checkout application should show to the user (who is logged in in SAP Customer Checkout) when an amount of cash is less or greater than expected.
NoteThe custom message is shown for all currencies; that is, you cannot maintain a separate message for each currency.
Cash Replenishment Settings
Option Description
Custom message when an amount of cash is less than expected
Message to be shown on the SALES screen when the amount of cash is less than expected.
SAP Customer Checkout provides a default message. However, you can customize this message.
NoteTo return to the default message, blank this field save your edits.
Custom message when an amount of cash is greater than expected
Message to be shown on the SALES screen when the amount of cash is greater than expected.
SAP Customer Checkout provides a default message. However, you can customize this message.
NoteTo return to the default message, blank this field save your edits.
NoteIf the user (who is logged in in SAP Customer Checkout) hasn't assigned the Show day-end closing screen permission, he or she doesn't see the amount, but sees the following: N/A.
ExampleAssuming that your supported payment currency is EUR, and you have set the following cash replenishment amount for your currency:
Minimum cash expected (EUR): 100
Maximum cash expected (EUR): 1,000
In your SAP Customer Checkout drawer, you have 50 EUR.
SAP Customer Checkout Configuration GuideCurrency CUSTOMER 53
The user who logs in to SAP Customer Checkout sees the following message in the SALES screen:
Cash in EUR is too low. Current amount is N/A. Minimum cash expected is 100.00.
The user can now decide how to proceed, if he or she wants to put EUR into the drawer (or perform a cash in).
54 CUSTOMERSAP Customer Checkout Configuration Guide
Currency
7 Quick Selections
As of version SAP Customer Checkout 2.0 Feature Pack 09, configuration of quick selection buttons is possible in SAP Customer Checkout manager only. The local configuration feature for quick selection buttons has been removed. For more information, see the SAP Customer Checkout manager Guide.
SAP Customer Checkout Configuration GuideQuick Selections CUSTOMER 55
8 Dialog Settings
Configure the search dialog box settings for customers and articles. You can manually search fields to activate and show in the search dialog box.
Dialog Settings Subtabs
Subtab Description
Customer Search Dialog Settings Maintain the settings shown in the search dialog box for customers
Material Search Dialog Settings Maintain the settings shown in the search dialog box for articles
To determine which customers and articles appear in the search dialog box, you can edit the following settings:
Customer and Article Search Dialog Settings
Option Description
Column name Internal name of the column in the Search dialog box for customers and articles. SAP Customer Checkout provides some default customer and article columns.
Column alias The key of the translation label containing the name displayed in the Search dialog box for the column.
NoteChanges to the column alias name can be manually maintained in the userDefinedTranslations files stored in the translations folder.
Visible Defines whether the column is visible in the search dialog box on the SALES screen.
Column width Width of the display area for this column.
When no column width is defined, the default column width, 0, is used.
56 CUSTOMERSAP Customer Checkout Configuration Guide
Dialog Settings
Option Description
Basic search Enable/ Disable whether this column is searchable from the basic search dialog box.
Only two column options can be additionally enabled at the same time, as the full-text searchable field is set as default.
NoteColumns that are enabled to be searchable in the basic search, are searched by an AND relation (conjunction), i.e. all search criteria have to be fulfilled.
Advanced search Enable/disable whether this column is searchable from the advanced search dialog box.
Full-text searchable Enable/ Disable a full-text search of this column in the basic search dialog box.
NoteFull-text searchable columns are searched by an OR combination (disjunction), i.e. at least one search criteria has to fit.
Sortable Enable/ Disable whether this column can be sorted.
Position Defines at what position the column is shown in the Search dialog box.
Default sort column Sets a default sorting type for this column.
Indexed Defines whether the column is displayed in an order, either alphabetical or numerical.
RecommendationFor large data volumes, we recommend only enabling the searchable and sortable options, when an index has been set for this column. Also, we advise enabling only these search options:
● Full-text searchable● Sortable● Searchable
A misconfiguration of the search settings can lead to extended search time.
SAP Customer Checkout Configuration GuideDialog Settings CUSTOMER 57
Furthermore, SAP Customer Checkout lets you add and configure user-defined fields for searching customer and article data in the Search dialog box. User-defined fields can be manually configured in SAP Customer Checkout from the backend to keep track of additional information.
NoteThe handling of user-defined fields is supported only when SAP Customer Checkout with SAP Business One or SAP Customer Checkout manager is connected. When using SAP Business ByDesign or SAP ECC, a plugin has to be added to SAP Customer Checkout.
SAP Business One only: To map the user-defined fields from the back end to SAP Customer Checkout, an extended scenario step in SAP Business One Integration Framework is necessary. For more information about the extension step, see the SAP Customer Checkout Business One Integration Framework Scenario Extension Guide at https://partneredge.sap.com/en/products/scc/about.html .
SAP Customer Checkout manager only: To search article data with user-defined fields in SAP Customer Checkout, "central article management" has to be activated in the integration settings.
SAP Customer Checkout manager only: To search customer data with user-defined fields in SAP Customer Checkout, "central customer management" has to be activated in the integration settings.
You also need to maintain the required customer-defined values for customers and articles in SAP Customer Checkout manager.
SAP Customer Checkout provides the following types of user-defined fields:
● udfString: to store text values● udfDouble: to store numeric values● udfBoolean: for fields that are shown as a checkbox
The settings of user-defined fields can be maintained the same way as the default customer and article columns described in the table above.
NoteFor user-defined fields, the column alias name can be changed in the settings and is displayed identically for all languages. The translation of the column alias name for user-defined fields must be manually edited in the userDefinedTranslations files stored in the translations folder.
58 CUSTOMERSAP Customer Checkout Configuration Guide
Dialog Settings
9 Technical
In this section, you can configure database and hardware related settings for your POS system.
9.1 POS System Settings
9.1.1 Backup
Configure the data backup feature of SAP Customer Checkout. During the backup process, SAP Customer Checkout archives important application data to a configurable location.
For more information about how to create a backup, see Backing up Data in the SAP Customer Checkout User Guide.
When configuring the backup, consider the following:
● The location where the backup files should be stored● How long the backup files should be stored● The minimum amount of files that should be stored
NoteDo not store backup files on the same system from which the backup files originate. An acceptable location is, for example, a network folder that can be accessed from the system on which SAP Customer Checkout is installed. SAP Customer Checkout creates a log file in the location where the backup files are stored.
Since backup files are of a considerable size and because you might be creating backups of multiple POS systems, you can configure SAP Customer Checkout to automatically delete older backups.
CautionA separate subfolder is required for every POS system that is configured to create backups. If you do not adhere to this requirement, some of your backup files may get deleted.
Backup settings
Option Description
Backup folder Location where the backups are stored and processed. If you leave this option empty, the archives are stored in the SAP Customer Checkout installation folder.
SAP Customer Checkout Configuration GuideTechnical CUSTOMER 59
Option Description
Create subfolder for backups automatically
Automatically create subfolders for backups in the \backup subfolder of the SAP Customer Checkout installation folder.
Number of backup days The number of days files are kept, in relation to their creation date. If the backup process finishes successfully, any files that are older than the value you provide here are deleted. The default value is 7.
If this value is 0, and the number of backup files to be kept is also 0, all backup files are deleted (including the file that was created during backup).
Number of backup files to be kept The minimum number of backup files to keep. As long this value is not reached, no files are deleted.
This rule also saves files that would otherwise be deleted because they are older than the specified "number of backup days." The default value is 0.
9.1.2 Web Browser
Configure SAP Customer Checkout to run in a specific browser and to run in full-screen mode.
NoteSAP recommends that you use the Google Chrome web browser to run the application.
Browser Settings
Option Description
Path to web browser EXE-file Path to web browser, including the file name and extension.
Browser parameters Additional parameters to start the browser in full-screen mode (separate parameters using spaces).
To run SAP Customer Checkout in a specific browser without full-screen mode, remove all values from the input field.
NoteAdd %1 as the final parameter, which passes the application URL to the web browser. If you are using Google Chrome web browser, SAP recommends that you use the default values.
Default Updates the Browser parameters field with the default values for the Google Chrome web browser.
60 CUSTOMERSAP Customer Checkout Configuration Guide
Technical
9.1.3 Web
Configure the web settings of SAP Customer Checkout.
Web Settings
Option Description
Enable HTTPS Enable https protocol for communication between browser and local host.
Path to Keystore File Path to the https certificate file.
Keystore Password Password for the certificate file.
Web Server Port Port used by SAP Customer Checkout. If the port is already in use, you can change this value.
9.1.4 Network
Configure network settings of SAP Customer Checkout.
Network Settings
Option Description
Proxy Host Proxy host name.
Port of Proxy Port used by the proxy host.
Proxy Host for HTTPS Proxy host name when using HTTPS.
Port of Proxy for HTTPS Port used by the proxy host for HTTPS.
Non-Proxy Hosts Hosts for which the proxy is bypassed. Separate multiple hosts using the”|” character.
SAP Customer Checkout Configuration GuideTechnical CUSTOMER 61
9.1.5 Hardware
The Hardware section of the screen shows the names of the active hardware plug-ins. If no hardware plug-ins are used, you see the name of the fallback service. You cannot edit these settings.
Hardware settings
Option Description
Cash Drawer ID ID of the active cash drawer plug-in or the name of the fallback service
Line Display ID ID of the active line display plug-in or the name of the fallback service
POS Printer ID ID of the active POS printer plug-in or the name of the fallback service
9.2 Database
Configure database settings of SAP Customer Checkout.
Database Settings
Option Description
Data source Name of the database scheme
Database Database file name
Driver JDBC driver used to access the database
Protocol Protocol used in the JDBC connection string
User User name used to access the database
Password Password used to access the database
9.3 Signature settings
This section describes the configuration of signature settings for your POS system, as stipulated by POS Security Regulation 2020 in Germany. This section appears only if you have selected Germany as the relevant country on the POS system tab (Info subtab).
For more information on the POS Security Regulation, see POS Security Regulation 2020 for Germany [page 142]
62 CUSTOMERSAP Customer Checkout Configuration Guide
Technical
Once you have installed the TSE hardware and Web service (for more information, see Installing the TSE Hardware [page 144]), you can configure the TSE in SAP Customer Checkout.
1. Perform the initial signature activation.
NoteNote that you cannot deactivate the signature once it has been activated.
2. Enter all relevant data:
Option Description
TSE Device Select Diebold Nixdorf.
WebSocket URL Enter the same URL with port no. that you entered during TSE hardware installation.
"Admin" user password The initial password usually is 12345.
NoteAlternatively, you can request the passwords from Diebold Nixdorf.
"TimeAdmin" user password The initial password usually is 12345.
NoteAlternatively, you can request the passwords from Diebold Nixdorf.
Export path Enter the same export path that you entered during TSE installation.
NoteThis is the path at which the TSE stores and exports files.
Print QR code as additional text (Optional) You can also print the QR code appearing on the receipt as an additional text.
NoteThe law text stipulates that all data must be printed on receipts in human-readable form. You comply with this requirement by using this configuration option.
3. Save your changes.
SAP Customer Checkout Configuration GuideTechnical CUSTOMER 63
NoteSaving the TSE settings may take several seconds, as this triggers communication between SAP Customer Checkout and the TSE, and the certificate is also read.
4. Once the certificate has been read, the system displays additional TSE data:
Option Description
Number of remaining transactions Number of remaining transactions with TSE hardware
Certificate expiration date Displays the expiry date of the TSE hardware certificate
TSE serial number The TSE serial number is required for registering the POS with the tax authorities.
NoteIn addition to the TSE serial number, you also have to specify the serial number of the POS software. For more information, see About [page 123]
5. TSE configuration in SAP Customer Checkout is now completed.
NoteWhen you post a receipt on the Sales screen in SAP Customer Checkout, all TSE data is also printed on the receipt. This includes:
● QR code● Time of Start transaction● Time of End transaction● Transaction number● TSE serial number
NoteIn principle, all receipts (on sales, cash deposits, and cash expenses, etc.) are signed by SAP Customer Checkout. However, no TSE data and no QR codes are printed on receipts for cash deposits and expenses.
NoteIf the TSE is inactive, no TSE data is printed on the relevant posted receipt. In this case, the Sales screen in SAP Customer Checkout displays a suitable note.
64 CUSTOMERSAP Customer Checkout Configuration Guide
Technical
9.3.1 Exporting and Deleting Signature Data
In the signature settings you can export TSE and signature data as a file for the tax authorities.
Context
Procedure
1. Select Export and delete signature data.2. Once the signature data has been exported, it is deleted from the TSE and written to the export directory
you have defined.
The respective .tar file is stored in this export directory.
NoteIf an error occurs during the export, the data is only exported, but not deleted.
9.4 Shutdown Settings
SAP Customer Checkout can be shut down automatically at specified times.
If "Automatic shutdown" is activated, SAP Customer Checkout and the POS system on which SAP Customer Checkout is executed are shut down at the specified times. It is possible to run a data backup of SAP Customer Checkout while it is shutting down.
Shutdown Settings
Option Description
Automatic shutdown Specifies whether SAP Customer Checkout and the POS system are shut down.
Automatic shutdown interval The automatic shutdown can be executed at the following intervals:
● Daily● Weekly
Execution time Specifies the time at which automatic shutdown is to be performed.
SAP Customer Checkout Configuration GuideTechnical CUSTOMER 65
Option Description
Automatic shutdown mode The following options are possible:
● Backup data and shut down system Shuts down the SAP Customer Checkout application, executes a data backup, and then shuts down the POS system in which SAP Customer Checkout is run.
● Shut down system: Shuts down the SAP Customer Checkout application and then shuts down the POS system in which SAP Customer Checkout is run.
● Back up data and close application: Shuts down the SAP Customer Checkout application and performs a data backup.
● Close application: Shuts down the SAP Customer Checkout application.
66 CUSTOMERSAP Customer Checkout Configuration Guide
Technical
10 Hardware
In this section, you can configure hardware related settings for your POS system.
10.1 Receipt
Customize the receipt and enable additional printouts for specific scenarios.
Documents Settings
Option Description
Header text Header text of the receipt, located below the logo and above the rest of the receipt.
Footer text Footer text of the receipt, located below the barcode and above the tax number
Print customer information Whether customer information is to be printed on the receipt
Enable protocol printout for receipts with returns Defines whether a protocol that includes only the returned articles is to be printed when articles are returned.
Print additional receipt for payments on credit Whether an additional receipt is to be printed for payments on credit
Print additional receipt when articles are returned Defines whether an additional receipt is to be printed when at least one article is returned
Print additional receipt for payments by voucher Defines whether an additional receipt is to be printed when a voucher or free voucher is used
Print form for entertainment expenses on sales receipt Defines whether an additional form for entertainment expenses (for example, in the gastronomy and catering area) to be printed on the sales receipt.
Print software version Specifies whether the software version is printed on all receipts
Print POS system and group Defines whether POS system and group are to be printed on the receipt
Cashier info Defines how much cashier information is printed on the receipt
Salesperson info Defines how much salesperson information is printed on the receipt
SAP Customer Checkout Configuration GuideHardware CUSTOMER 67
Option Description
Cut paper during print transaction (not supported by all printers)
Cut the receipt paper within the print transaction.
Example:
For printers that are used at the same time from several SAP Customer Checkout applications (for example, network printers), set this value to true to make sure that the receipt cut has been set correctly.
For locally connected printers (for example, USB, serial, or Bluetooth printers), set this value to false, as not all printers support this functionality.
CautionWrong configuration settings might cause an incorrect receipt paper cut.
Aggregate split sales items on the order print If you want to aggregate split sales items (with corresponding articles and prices) for orders, activate "Aggregate split sales items on the order print".
Aggregate split sales items on the receipt print If you want to aggregate sales items (with corresponding articles and prices) for receipts, activate "Aggregate split sales items on the receipt print".
If an error occurs, use the alternative slip printer. If the slip printer cannot be used due to a technical error, SAP Customer Checkout can print the document on other configured slip printers.
Always print short text of sales items on the receipt If a short text is maintained for the article, this is printed instead of the article description.
Additional language for bilingual receipt printing Bilingual receipts can be printed. The first language is determined based on the language selected for the POS system. The second language can be selected from the dropdown list.
NoteThe second language is printed one font size smaller than the first language. We recommend selecting written languages that are difficult to read in small font sizes as the first language.
68 CUSTOMERSAP Customer Checkout Configuration Guide
Hardware
Option Description
Print a foreign-language name for the article If the foreign-language name is maintained in SAP Business One in the item master data, this name is also printed on the receipt.
NoteThis setting is only supported if SAP Customer Checkout is integrated with SAP Business One.
Enable right-to-left writing direction for ".xsl" print templates Changes the writing direction on receipts that use the ".xsl" print templates to right-to-left.
Print ID of the original sales receipt for returned articles If the ID of the receipt with which the article was sold is available for the returned article, it is also printed on the receipt.
Logo (Only in edit mode)
Logo to be printed at the top of the receipt; automatically resized to fit the receipt.
If you selecting the empty entry from the dropdown list, no logo is printed on the receipt.
Available logos (Only in edit mode) A list of logos already uploaded that can be used for the receipt.
Add logo (Only in edit mode)
1. Click Choose File to open Windows Explorer and select the image file you want to use as the logo.
2. Click Upload Selected Image.The image is added to the Available Logos section and can be selected.
10.2 Print Settings
In the print settings, you can define the basic configuration for the print templates (PRINT TEMPLATES tab) and printers (PLUG-INS tab).
NoteSlip printers that are connected to SAP Customer Checkout via the JPOS interface must be fully set up and configured before you can use them successfully via the print settings.
Select the Paper size, Print driver, Print language type, and the Printer to be used for the basic configuration. As some settings are prerequisites for other settings, all of the settings are not always available.
To apply your selected settings, choose Apply.
SAP Customer Checkout Configuration GuideHardware CUSTOMER 69
NoteIf you choose Apply, all settings on the PRINT TEMPLATES and PLUG-INS tabs are updated and the relevant print templates and printers are activated. Print templates that are no longer used according to the selected print settings are deactivated.
Print Settings
Setting Description
Print paper size 80 mm
Standard print paper size of most slip printers Selects suitable print templates for slip printers in the basic configura-tion.
A4
Standard print paper size of most office printers. Selects suitable print templates for office printers (A4) in the basic configuration.
Print driver JPOS
Restricts the selection of printers in the print settings to those printers that are addressed via the JPOS interface and connected correctly to SAP Customer Checkout.
Windows
Restricts the selection of printers in the print settings to those printers that are installed in the Windows operating system.
Print language type Latin
Written languages that use a variant of the Latin alphabet (such as German) normally do not require image-based receipt printing. Selects print templates for regular receipt printing in the basic configuration.
Non-latin
Written languages that use a non-Latin alphabet (such as Japanese) require image-based receipt printing in SAP Customer Checkout. Selects print templates for image-based receipt printing in the basic configuration.
Printer Selection of the printer that is to be used for the print templates in the basic configuration. Activates the selected printer on the PLUG-INS tab.
Only those printers can be selected that can be used with the print settings currently selected.
70 CUSTOMERSAP Customer Checkout Configuration Guide
Hardware
Setting Description
Test printer Offers a selection of test receipts for the print settings currently selected. Choose the pushbutton to perform a test print. If the selected printer is inactive, it is temporarily activated for the duration of the print operation.
10.3 Print Templates
Configure print templates and options for print templates for all hardware devices and software that you have installed as printers on the operating system. Print templates describe the layout for documents that can be printed with SAP Customer Checkout.
SAP Customer Checkout combines template data and application context data into a print job, which is then printed by the print engine. You can edit print templates to change the layout and the language of the respective document. Print templates use the defined hardware language (for more information, see section General [page 11]).
SAP Customer Checkout includes the following predefined print templates:
● Templates for printing on DIN A4, which are disabled by default● Templates for printing on a JPOS device
In SAP Customer Checkout, the following print template types are supported:
● Sales receipt● Voucher/voucher slip printing● Cashing-Up● Day-End Closing● Cash-in/Cash-out● No sales receipt● Order● Time recordings● Sales reports
For information about how to edit print templates, refer to the additional print template documentation provided by SAP.
NoteChanges to the print templates of SAP Customer Checkout can have consequences for the validity of the certification for NF 525 for France and the French overseas departments. For more information about the possible effects on the certification, see POS Software Certification According to NF 525 (France) [page 135].
General settings for print templates are described in the following table.
SAP Customer Checkout Configuration GuideHardware CUSTOMER 71
Print Template settings
Option Description
Name Unique name of the print template
PrintJobBuilder class PrintJobBuilder class for processing the print template.
The value include is a special keyword signifying that this entry is used only as a resource for other templates.
SAP Customer Checkout provides the following PrintJobBuilders:
● SalesReceiptPrintJobBuilder: Creates print jobs for receipts and returns
● VoucherPrintJobBuilder: Creates print jobs for vouchers● CashInOutPrintJobBuilder: Creates print jobs for cash-
in, cash-out, pay-in, pay-out● CashDeskClosingPrintJobBuilder: Creates print jobs for
day-end closing and cashing-up● NoSaleReceiptPrintJobBuilder: Creates print jobs for
null receipts (for example, if no cash transaction is executed)
● TimeRecordingPrintJobBuilder: Creates print jobs for time recording transactions
● OrderPrintJobBuilder: Creates print jobs for order receipts (for restaurant mode)
● SalesReportPrintJobBuilder: Creates print jobs for sales reports
● SalesReceiptOrderPrintJobBuilder: Creates print jobs for special sales receipts (in large font in the style of an order receipt and without payment information, for example, for receipts that authorize you to pick up food at events)
Printer (Required only for DIN A4 printing) Printer that is used for this print template.
Template type Print template type
JPOS: Freemarker based template with special escape annotations for formatting.
TXT: Freemarker based template to print on system printers without formatting (no color, tables, etc.)
FOP: Apache FOP\ -based template to generate well-structured DIN A4 documents.
72 CUSTOMERSAP Customer Checkout Configuration Guide
Hardware
Option Description
Path to template Path to the template file including filename and extension. For files that are located in the \cco\print_templates subfolder of the SAP Customer Checkout installation folder, you only need to provide the file name and extension.
You can also maintain a network path. This enables multiple SAP Customer Checkout applications to use the same print template. If the templates cannot be accessed (for example, due to network problems) and the templates are not in the application buffer, the default templates are used.
CautionDuring software updates, the original print templates delivered can be overwritten. To ensure that changes to print templates do not get overwritten, make any changes only on a copy of the print template. To use this copy, you then need to change the path to the print template configuration within SAP Customer Checkout ("Configuration" tab -> "Hardware" subtab -> Print Templates).
RecommendationAfter each update, make sure your print templates work correctly.
Active Enable/disable the print template.
Copies The number of documents that are printed when this print template is used.
Structure To show all available objects from the entries PrintJobBuilder class, choose Show. This information is necessary for creating or editing print templates.
Reset Resets the content of the template. This option is available only for the default print templates in the \cco\print_templates subfolder of the SAP Customer Checkout installation folder.
Resetting also overwrites default templates with any changes that may have been introduced with a software update.
Delete Deletes the entry The print template file for this entry is not deleted.
SAP Customer Checkout Configuration GuideHardware CUSTOMER 73
10.3.1 Setting Up DIN A4 Printing
You can enable printing in DIN A4 format for receipts, day-end closing documents, and cashing up documents.
Procedure
In the Print Templates subtab, choose Edit and make the following settings for each DIN A4 template:
These templates have the string "A4" in their template name.
a. In the Printer column, select the system printer.b. In the Active column, select the checkbox.c. Save your changes.
10.3.2 Customizing Print Templates
You can set options for each print template in the bottom table of the Print Templates section.
Procedure
1. Select the print template for which you want to set the options, and choose Edit.2. To view the available options, their descriptions, and valid option values, choose Help.3. To select an option, double-click in the Option name field and select it from the list.
74 CUSTOMERSAP Customer Checkout Configuration Guide
Hardware
Options
Option Name DescriptionUsed with the following PrintJobBuilders
Total amount Specifies the minimum or maximum amount above or under which this print template is to be used.
Example'>=100' or '<400' or '==100'
NoteThe numbers used for the total amount must be positive integers in the configured country/region format.
SalesReceiptPrintJobBuilder
Print automatically Automatically triggers printing for the respective print template.
NoteThe default value is Print always.
SalesReceiptPrintJobBuilder
Print on reprint button pressed Triggers printing for the respective template when the Reprint button is chosen on the SALES screen or in the receipt search.
SalesReceiptPrintJobBuilder
Print cancelled receipts Whether to print cancelled receipts (true) or not (false).
NoteThe default value is true.
SalesReceiptPrintJobBuilder
Print on paid with card Prints the respective template if the receipt is paid with card and the option value is true (default value).
Note
SalesReceiptPrintJobBuilder
SAP Customer Checkout Configuration GuideHardware CUSTOMER 75
Option Name DescriptionUsed with the following PrintJobBuilders
Print on paid in cash Allows you to print the respective print template if the receipt is paid in cash and the option value is set to true.
NoteIf no value is maintained manually, the default option value is set to true.
SalesReceiptPrintJobBuilder
Print on paid with voucher Allows you to print the respective print template if the receipt is paid with a voucher and the option value is set to true.
NoteIf no value is maintained manually, the default option value is set to true.
SalesReceiptPrintJobBuilder
Print on paid on account Allows you to print the respective print template if the receipt is paid on account and the option value is set to true.
NoteIf no value is maintained manually, the default option value is set to true.
SalesReceiptPrintJobBuilder
Duplex print Allows you to print the respective print template on both sides.
NoteYou can use this option only on system printers that support this feature.
SalesReceiptPrintJobBuilder
76 CUSTOMERSAP Customer Checkout Configuration Guide
Hardware
Option Name DescriptionUsed with the following PrintJobBuilders
Printer tray Allows you to select a printer tray for the respective print template.
NoteThis option is only possible for system printers that support this feature.
SalesReceiptPrintJobBuilder
Print voucher on special slip Allows you to mark this template as used by printing on slip station.
NoteThis option is only possible for printers with template type JPOS. Additionally, the voucher has to be configured and adapted to the respective tray and printer.
VoucherPrintJobBuilder
Print on day-end closing Allows you to print the cash-out and carry-over receipts during the day-end closing.
NoteIf no value is maintained manually, the default option value is set to true.
CashInOutPrintJobBuilder
Print the cashing up Allows you to mark this template as used by cashing-up and not day-end closing.
CashDeskClosingPrintJobBuilder
Print parked receipts Allows the parked receipt to be printed when the receipt is parked.
If no value is maintained manually, the default option value is set to true.
SalesReceiptPrintJobBuilder
4. Set the option value for the respective option of the print template and save your changes.
NoteDepending on the option you have selected for a print template, the available option values vary from each other.
SAP Customer Checkout Configuration GuideHardware CUSTOMER 77
For the options Print automatically and Print on reprint button pressed, you can select between the following option values:○ Print never: Disables receipt printing (sales receipts, returns).○ Print only sales receipt: Allows you to print only sales receipts in SAP Customer Checkout.○ Print only returns: Allows you to print only returns receipts in SAP Customer Checkout.○ Print always: Allows you to print all receipts in SAP Customer Checkout.
For the options Print cancelled receipts, Print on paid with card, Print on paid in cash, Print on paid with voucher, Print on paid on account, Duplex print, Print the cashing up, Print voucher on special slip, and Print parked receipts, you can set the option value to true or false.
10.3.3 Creating User-Defined Translations
User-defined translations let you replace any term in a specific hardware language.
Context
This feature is intended to allow you to customize receipts. If the language is supported by SAP Customer Checkout, a respective properties file exists in the \cco\translations subfolder of the SAP Customer Checkout installation folder.
Procedure
1. Open the properties file.2. To replace a term, add the key and the new value into the properties file.
You find the keys in the print templates.3. Save your changes.
10.3.4 Adding Fonts to Print Templates
You can add fonts to your print templates to create customized print templates within your SAP Customer Checkout application.
Context
78 CUSTOMERSAP Customer Checkout Configuration Guide
Hardware
Procedure
1. Open your print_templates subfolder located in the SAP Customer Checkout installation folder, and select the fonts folder.
2. Place the .ttf fonts file in the folder to use those fonts for your print templates.
10.3.5 Image-Based Receipt Printing
SAP Customer Checkout supports image-based receipt printing via the JPOS interface. Document content is hereby rendered as a complete image and then transmitted via the JPOS interface to the receipt printer as an image. Due to the rendering process, image-based receipt printing takes a little longer than regular receipt printing.
Image-based receipt printing enables SAP Customer Checkout to print Chinese, Japanese, and Arabic characters on receipts. In addition, SAP Customer Checkout can print aligned proportional fonts on documents using a table layout.
NoteAdjust the language for SAP Customer Checkout and for image-based receipt printing to use simplified Chinese, Japanese, or Arabic for receipt printing.
To enable image-based receipt printing, SAP Customer Checkout provides separate print templates for each receipt type. Layout, font style, and font size in the print templates for image-based receipt printing can be changed in a central configuration file.
All print templates and required files for image-based receipt printing end with the character string "80mm".
Print templates for image-based receipt printing can be used with two different template types. Template type JPOS_IMG can be used for printing on receipt printers. Alternatively, template type FOP can be used for printing on printers installed in Windows.
NoteTo enable image-based receipt printing, the printer must support printing of bitmap graphics in GIF format.
NoteIf the printed document is strongly pixelated, enter the following line in the jpos.xml file under the other property entries:
<prop name="GradationMethod" type="String" value="1"/>
If the printer has been installed correctly, the jpos.xml file can be found under the following path:
C:\SapCustomerCheckout\cco\POSPlugins\HW\jpos.xml
NoteIf you set up a receipt printer that is controlled using the JPOS interface as the default printer in your Windows operating system and use a print template for image-based receipt printing (ends with the
SAP Customer Checkout Configuration GuideHardware CUSTOMER 79
character string "80mm"), additional changes may be needed in the configuration file PrintAttributes80mm.xsl.
If characters are not printed on the left edge of the printout and the printout stops after the first page (although multiple pages would be expected), proceed as follows:
Procedure
1. Open the PrintAttributes80mm.xsl file in a text editor. This file is located in the installation directory of SAP Customer Checkout, normally under the path C:\SapCustomerCheckout\cco\print_templates\PrintAttributes80mm.xsl.
2. Change the entry from <xsl:attribute name="page-height">200cm</xsl:attribute> to <xsl:attribute name="page-height">29.7cm</xsl:attribute>
3. Change the entry from <xsl:attribute name="margin-left">0mm</xsl:attribute> to <xsl:attribute name="margin-left">5mm</xsl:attribute>
4. Save your changes in the file.5. Restart SAP Customer Checkout.
10.3.5.1 Adjusting the Print Resolution for Image-Based Document Printing
Context
Before you can successfully print image-based documents, the resolution for the rendered image may need to be adjusted to the technical specifications of the document printer.
The default resolution for image-based document printing in SAP Customer Checkout is 180 dpi. If the document printer has a higher resolution than the default resolution, the document printout may be too small. If the document printer has a lower resolution than the default resolution, parts of the document can be cut off or the document may fail to print.
Procedure
1. Open the file JPOSPlugin.properties in a text editor. This file is located in the installation directory of SAP Customer Checkout, normally under the path: C:\SapCustomerCheckout\cco\POSPlugins\HW\JPOSPlugin.properties.
2. Add the line hardware.posPrinter.[printer number].resolution=[resolution value] with the relevant values. For example: hardware.posPrinter.resolution=120. If you are using just one document printer or you want to use the same resolution for all document printers, you can refrain from entering a printer number.
3. Start SAP Customer Checkout.
80 CUSTOMERSAP Customer Checkout Configuration Guide
Hardware
10.3.5.2 Adjusting Layout, Font Style, and Font Size for Image-Based Document Printing
Context
You can also adjust layout, font style, and font size for image-based document printing in the central PrintAttributes80mm.xsl configuration file.
NoteChanges to table layout attributes only affect the print templates for cashing up and day-end closing.
Procedure
1. Open the PrintAttributes80mm.xsl file in a text editor. This file is located in the installation directory of SAP Customer Checkout, normally under the path C:\SapCustomerCheckout\cco\print_templates\PrintAttributes80mm.xsl.
2. Change the desired values and save your changes.3. Restart SAP Customer Checkout or execute the recovery function for a print template to activate the
changes for document printing.
10.4 Plug-Ins
In this section, you can activate and deactivate hardware plug-ins (for the receipt printer, cash drawer, and so on) that are located in the HW subfolder of the application.
All plug-ins in the HW subfolder when the application starts are shown in the table below.
Plug-In Settings
Column Description
ID ID of the plug-in.
Description Brief description of the type of hardware for which this plug-in is used.
Enabled Enable/ disable the respective hardware device to be set as the default and open automatically when starting the SAP Customer Checkout application.
SAP Customer Checkout Configuration GuideHardware CUSTOMER 81
Column Description
Status Displays the current status of the plug-in:
Red box: Not active
Green box: Active
Activate Activate or deactivate the hardware plug-in. The function and label of the button changes depending on the current status of the plug-in.
Activate: Activate the plug-in
Deactivate: Deactivate the plug-in
Reload Reload the plug-in.
10.5 External Line Display Plug-In
SAP Customer Checkout is delivered with a plugin for external line displays. This plugin can show sales information and advertisements on a second monitor.
:
1. In the Plug-ins subtab, activate the EXT_LINE_DISPLAY plugin. The external line display area appears in the upper-left corner of the screen.
2. To open the configuration menu, right-click in the external line display area. .
External Line Display Settings
Option Description
Text + Increase the font size. To increase the font size without using the menu, use the key combination ALT + ↑ .
Text - Decrease the font size. To decrease the font size without using the menu, use the key combination ALT + ↓ .
Columns + Increase the number of columns available to display information. To increase the number of columns without using the menu, use the key combination ALT + → .
Columns - Lower the number of columns available to display information. To lower the number of columns without using the menu, use the key combination ALT + ← .
Toggle full screen Toggle between full-screen mode and the default size on the current device.
Toggle bold Text Toggle between normal and bold text.
Toggle advertisement Toggle the advertisement display area.
Switch to device Switch the display area to another device (for example, a secondary monitor).
82 CUSTOMERSAP Customer Checkout Configuration Guide
Hardware
Option Description
Advanced configuration Open the advanced configuration (for more information refer to Advanced External Display Configuration [page 83]).
Save settings Save the current settings.
10.5.1 Changing Size and Position Manually
If you don't want to use the plugin in full-screen mode, you can manually change the size and position of the display.
To adjust the size, do the following:
● To increase the width of the display area, press and hold CTRL + →● To decrease the width of the display area, press and hold CTRL + ←● To increase the height of the display area, press and hold CTRL + ↑● To decrease the height of the display area, press and hold CTRL + ↓
To adjust the position, do the following:
● To move the display area to the right, press and hold SHIFT + →● To move the display area to the left, press and hold SHIFT + ←● To move the display area up, press and hold SHIFT + ↑● To move the display area down, press and hold SHIFT + ↓
To save your changes, right-click in the display area and choose Save settings.
10.5.2 Advanced External Display Configuration
Advanced Settings for External Line Displays
Option Description
Choose Image Folder Choose a folder from which images for the advertisement display area are loaded.
Switch delay (in ms) (Only when Slideshow is enabled) Choose the time interval, in milliseconds, between changing images.
Slideshow Enabled:
Display images from the image folder in sequence.
Disabled:
Do not show available images
SAP Customer Checkout Configuration GuideHardware CUSTOMER 83
Option Description
Choose Font File To use another font, choose a font file.
NoteOnly monospaced fonts give an accurate representation.
Choose Text Color Specify the text color.
Choose Background Color Specify a background color.
Idle message To show a user-defined idle message when no user is logged in, enter the message text here. If you don't set a message, the default message is used.
Welcome message To show a user-defined welcome message when no receipt information is displayed, enter the message text here. If you don't set a message, the default message is used.
Display date Enabled:
Display the current date below the welcome message.
Disabled:
Do not display the current date.
Save and Apply settings Saves the current settings and updates the external line display area.
Close Closes the dialog.
10.6 Test
Test hardware settings of SAP Customer Checkout.
Hardware tests
Hardware Test Settings
Option Description
Open Cash Drawer Opens the cash drawer for testing purposes.
Display Text Displays the value in the Test Text: field on the line display.
Print Text Prints the value in the respective Test Text: field.
Print Test Receipt Prints a test receipt with dummy values.
84 CUSTOMERSAP Customer Checkout Configuration Guide
Hardware
Restart Hardware
This area contains three buttons you can use to stop and restart the various hardware services, for example, to attempt to access hardware that has crashed. However, we generally recommend that you restart the application instead.
Buttons for Restarting Hardware
Option Description
Restart Cash Drawer Services Restarts all cash drawer services.
Restart Line Display Services Restarts all line display services.
Restart POS Printer Services Restarts all POS printer services.
10.7 Output Locations
Output locations specify which document printer is used to print a specific article or article group. This only applies to the document type “order”. The output location does not have any effect on other document types.
Output locations for articles and article groups are transferred to SAP Customer Checkout during article synchronization.
The following output locations are available:
Output Locations Description
kitchen Kitchen
This output location is usually assigned to all article groups in the "Meals" area.
bar Bar:
This output location is usually assigned to all article groups in the "Drinks" area.
SAP Customer Checkout Configuration GuideHardware CUSTOMER 85
10.7.1 Direct Assignment or Removal of Output Location in SAP Customer Checkout
Context
If you have interconnected SAP Customer Checkout with another SAP back-end system (for example, SAP Business One, SAP Business ByDesign, SAP ECC) and you are not using SAP Customer Checkout manager as SAP back-end system, you can assign or remove the output locations for articles and article groups directly in SAP Customer Checkout.
To assign the output locations to an article or article group, proceed as follows:
Procedure
1. Select the Hardware tab.2. Choose the Output location mapping for article groups or Output location mapping for articles subtab and
choose Edit in the lower right corner of the screen.3. Choose one of the following options:
○ To assign an output location, choose Add and assign the relevant article or article group to the desired output location.
○ To remove the assigned output location, select the relevant article or article group and choose Remove.4. Save your changes.
10.7.2 Setting a Printer as Output Location
You can set a printer as an output location. The output location is only valid for the document type "job" or for the associated PrintJobBuilder class "OrderPrintJobBuilder".
Context
Once you have set a printer as output location, all receipt items of a job (which are assigned to same output location via the article group) are printed at the specified output location.
86 CUSTOMERSAP Customer Checkout Configuration Guide
Hardware
Procedure
1. Select the "Hardware" tab.2. Choose the "Print Templates" tab and then choose "Edit" at the bottom right corner of the screen.3. Select the line with the print template "OrderPrintTemplateJPOS".
NoteFor every additional output location, you need to configure an additional print template based on OrderPrintJobBuilder. To do this, choose the "Create new print template" icon at the top right corner of the screen and proceed as follows:
1. Give your print template a meaningful name.2. Choose OrderPrintJobBuilder as the PrintJobBuilder class.3. Assign required printer to the print template.4. Enter the value "OrderPrintTemplateJPOS.ftl" in the field for the path.5. Set the print template to "active".
Next, go to step 6.
4. Select the printer that you want to set as the output location.5. Set the print template to "active".6. The bottom area of the screen contains the table for options. Choose the "New option" icon.7. Choose the "Output location" option.8. Select the required output location as the option value.9. Choose Save.
10.8 Special Attributes in JPOSPlugin.properties
Amongst other things, all slip printers addressed via the SAP Customer Checkout JavaPOS interface are entered in the JPOSPlugin.properties file.
SAP Customer Checkout Configuration GuideHardware CUSTOMER 87
To make addressing slip printers more flexible and robust, several new attributes are available. They are described as follows:
Attributes
Attribute Description
hardware.posPrinter.retryOnFailure Default value: false
Allows you to try to print again using the manufacturer-specific printer driver, if your first attempt to print was unsuccessful. The recommended value is false, as SAP Customer Checkout is already attempting to reprint.
However, for certain printer manufacturers it may be necessary to set this attribute to true. For technical reasons, this should only be done if the hardware.posPrinter.asyncMode attribute is also set to true.
hardware.posPrinter.asyncMode Default value: false
Allows you to operate the slip printer in asynchronous mode using the manufacturer-specific printer driver. The recommended value is false, as SAP Customer Checkout already manages all print jobs asynchronously.
88 CUSTOMERSAP Customer Checkout Configuration Guide
Hardware
Attribute Description
hardware.posPrinter.claimBeforePrinting Default value: false
Allows you to configure how receipt printers are addressed. Claim is a technical operation, which requests access to the printer via the printer driver.
For operating a local printer connected to the POS system via USB, for example, the recommended value is false.
For operating a printer connected to the POS system via a network, the recommended value is true.
For operating a printer connected to the POS system via a network and that is addressed by multiple POS systems, the recommended value is true.
NoteEvery slip printer can experience technical limitations when it comes to communicating via a network connection. These limitations can vary from manufacturer to manufacturer.
Some printers only support a limited number of sessions that can be exceeded, if several programs attempt to request printer resources.
If several SAP Customer Checkout applications access a receipt printer via a network, the value has to be set to true.
10.9 Using Multiple Printers
SAP Customer Checkout allows you to use multiple printers. You can assign specific print templates to printers, in order to print a specific receipt type only. This can be used in hospitality, for example, to print separate receipts in the kitchen and at the bar. SAP Customer Checkout can address up to 100 printers.
NoteSAP Customer Checkout can also address multiple external display devices and cash drawers. These must be entered like additional receipt printers in the <JPOSPlugin.properties> file.
To operate multiple receipt printers using JavaPOS, you must enter each printer in the JPOSPlugin.properties file.
SAP Customer Checkout Configuration GuideHardware CUSTOMER 89
For example, to enter an additional printer with the name POSPrinterX, enter the following line in the JPOSPlugin.properties file:
hardware.posPrinter.1.name=POSPrinterX
Accordingly, printer attributes have to be assigned number 1. If no other attributes are specified, the attributes are used without a number as the standard value. You must increase the number accordingly for any additional printers. The numbers 0 to 99 are permitted.
You can select the printers using the printer names assigned in the SAP Customer Checkout hardware configuration.
90 CUSTOMERSAP Customer Checkout Configuration Guide
Hardware
11 Integration
Configure integration settings of SAP Customer Checkout.
The content of the Integration tab page varies, depending on the ERP system. The options available for all four ERP systems are described here, followed by the options that are available for SAP ECC, SAP Business ByDesign, SAP Business One, and SAP Customer Checkout manager. For more information on using the SAP Customer Checkout manager as a backend system, see the SAP Customer Checkout Manager Guide.
Integration
Subtab Description
SAP ERP system settings Maintain all SAP ERP-specific settings that are related to the back-end system you want to connect to.
SAP Customer Checkout manager Maintain all settings that are related to SAP Customer Checkout manager.
Voucher Select a voucher module, connect to the SAP Customer Checkout manager, and maintain service endpoint settings for vouchers.
11.1 SAP ERP System Settings
Use the SAP ERP System Settings section to maintain general and service endpoint information.
● General Settings: In this section, provide general information related to your ERP system.● Maintain Service Endpoint Information: To enable SAP Customer Checkout to send information to your
ERP system, and back to SAP Customer Checkout, configure service endpoint information.
11.1.1 SAP ECC Integration
Configure SAP Customer Checkout for integration into SAP ECC.
General
Option Description
Store ID Store ID sent by SAP ECC system; establishes a store
IDoc Read Location Path to location where the application can read IDocs
SAP Customer Checkout Configuration GuideIntegration CUSTOMER 91
Option Description
Upload duplicate IDocs Enables/disables IDocs duplication
Delete IDocs After Processing Enables/disables deletion of IDocs after they are processed
Receiver Partner Number Receiver partner number for user; use the default value
Receiver Partner Type Receiver partner type in transaction WE20; usually KU
Receiver port Receiver port for SAP ECC system
Sender Partner Type Sender partner type in transaction WE20; usually KU
Sender port Sender port for SAP ECC system
Split sales items Enables/disables splitting of sales items of the same article type.
For example, with 5 sales items of the same article type, the sales items could be split as follows:
Enabled: 5 item lines with 1 sales item are sent to the SAP ECC system.
Disabled: 1 item line with 5 sales items of the same article type are sent to the SAP ECC system.
Send unit price for sales items Enables/disables sending of unit prices for sales items
Example: Unit price for one article = 5,00 euros
Enabled: 1 item with one article with an amount of 5; item price 5.00 euros.
Disabled: 1 item with one article with an amount of 5; item price 25.00 euros.
Threshold for splitting sales items Specifies the upper limit for the amount of sales items up to which the sales item is split. This setting is effective only if Split sales items is enabled.
Example: Upper limit = 500
Result: Sales item is split up to an amount of 499
Time format Time format used in the SAP ECC system, 12- or 24-hour format
92 CUSTOMERSAP Customer Checkout Configuration Guide
Integration
Option Description
Bundle cash payment items to one position Enabled:
If a receipt contains multiple payment items with cash, they are added together when the receipt is transferred to the SAP ECC system and sent as a single payment item.
Disabled:
Payment items with cash are not totaled and are sent unchanged to the SAP ECC system.
Remove leading zeros from article ID Enables/disables the display of leading zeros from the article ID
NoteIf you activate this option and have already synchronized items in your SAP Customer Checkout application, all articles are synchronized again.
Remove leading zeros from customer ID Enables/disables the display of leading zeros from the customer ID
NoteIf you activate this option and have already synchronized customers in your SAP Customer Checkout application, all customers are synchronized again.
Remove leading zeros from article ID When articles are synchronized, leading zeros are removed from the article ID. The article ID is saved in SAP Customer Checkout without leading zeros.
Remove leading zeros from customer ID When customers are synchronized, leading zeros are removed from the customer ID. The customer ID is saved in SAP Customer Checkout without leading zeros.
SAP Customer Checkout Configuration GuideIntegration CUSTOMER 93
Option Description
Reverse mapping for discountable articles Articles have an indicator that specifies whether the article is discountable. By default, SAP Customer Checkout considers articles for which this indicator is activated as discountable.
Activating the Reverse mapping for discountable articles indicator changes processing when articles are transferred to SAP Customer Checkout. Articles that are transferred with the Discountable indicator from the SAP ECC system are saved in SAP Customer Checkout as not discountable. Articles that are transferred without the Discountable indicator from the SAP ECC system are saved in SAP Customer Checkout as discountable.
Reverse mapping for enforced manual price entry Articles have an indicator that specifies whether the user has to enter a price manually when the article is sold. By default, SAP Customer Checkout considers manual entry of the price as required if this indicator is activated for an article.
Activating the Reverse mapping for enforced manual price entry indicator changes processing when articles are transferred to SAP Customer Checkout. Articles that are transferred with the Force manual price entry indicator from the SAP ECC system are saved in SAP Customer Checkout as articles for which manual price entry is not forced. Articles that are transferred without the Force manual price entry indicator from the SAP ECC system are saved in SAP Customer Checkout as articles for which manual price entry is forced.
Distribute header discount to item discount By default, SAP Customer Checkout sends header discount in receipts as header discount to the SAP ECC system. The SAP ECC system processes header discount by distributing it to the sales items in the receipt.
If Distribute header discount to item discount is activated, SAP Customer Checkout distributes the header discount to the sales items of the receipt before the receipt is sent to the SAP ECC system.
Alternative PoS ID Transfers the value entered instead of the POS ID to the SAP ECC system
Read customer service package size Number of customers processed together when synchronizing customers
Read material service package size Number of articles processed together when synchronizing articles.
94 CUSTOMERSAP Customer Checkout Configuration Guide
Integration
Option Description
Read voucher service package size Number of vouchers processed together when synchronizing vouchers.
RFC endpoint
Option Description
Application server URL or ID address of the application server
Client Client of the SAP ECC system
System ID ID of the SAP ECC system
System number Number of the SAP ECC system
SAProuter-String Router string for connecting to the SAP ECC system
Language Language used when logging into the SAP ECC system. Impacts the availability of articles, which must be maintained for a language to be available.
Connection timeout (in seconds) Connection timeout value of the SAP ECC system in seconds. Default value: 30 seconds
NoteIf the connection times out, it shows as failed.
User name User name that communicates with the SAP ECC system
Password Password for the user name
11.1.1.1 ECC Article Text
In this area, you can specify how additional article texts from SAP ECC are processed in SAP Customer Checkout.
If additional article texts are maintained for articles in SAP ECC, these can be added to the article description in SAP Customer Checkout. In the ECC article text table, you can specify which article texts are added to the article description in which order. Article texts that are to be added are identified based on the <QUALARTTXT> and <LFDNR> fields.
To ensure that the article text is processed in SAP Customer Checkout, the following conditions must be met:
● The corresponding values for <QUALARTTXT> and <LDFNR> must be maintained in SAP Customer Checkout.
● The language specified in the article must match the language set in SAP Customer Checkout.
SAP Customer Checkout Configuration GuideIntegration CUSTOMER 95
Article Texts
Field Description
Position Specifies the position of the text to be added to the article description. Lower values are added further forward and higher values further back.
Qualifier text (QUALARTTXT) Processing takes into account only article texts for which the corresponding combination of <QUALARTTXT> and <LFDNR> matches the values in the articles.Consecutive number (LFDNR)
11.1.1.2 Condition Type
In this area, you can configure how condition types from SAP ECC are processed in SAP Customer Checkout.
In the SAP ECC system, condition types can be maintained for articles. Condition types in SAP ECC comprise a condition class and a calculation rule. Based on the combination of condition class and calculation rule, SAP Customer Checkout determines whether the condition type is processed as a price, relative discount, or absolute discount. To ensure that SAP Customer Checkout can process condition types as discounts, the condition type must be entered in the table for condition types.
Condition Type
Field Description
Condition Type Name of condition type from the SAP ECC system
Cond. Class Discount or surcharge
The value transferred is to be processed as a discount.
Prices
The value transferred is to be processed as a price.
Calculation rule Percentage
The value transferred is to be processed as a relative value.
Quantity
The value transferred is to be processed as an absolute value.
How Condition Types Are Processed in SAP Customer Checkout
Condition Class Calculation Rule Processing
Discount or surcharge Percentage Is processed as a relative discount.
Discount or surcharge Quantity Is processed as an absolute discount.
96 CUSTOMERSAP Customer Checkout Configuration Guide
Integration
Condition Class Calculation Rule Processing
Prices Percentage Is not supported.
Prices Quantity Is automatically processed as a price and does not have to be maintained as a condition type.
NoteSuch an entry in the condition type table is redundant and can be removed.
11.1.2 SAP Business ByDesign Integration
Configure SAP Customer Checkout to be integrated with SAP Business ByDesign.
SAP Business ByDesign integration settings
Option Description
Company ID Company ID from SAP Business ByDesign system.
Project ID (Optional) Project ID from SAP Business ByDesign system
Sales Unit ID Sales unit ID from SAP Business ByDesign system
Inventory location ID Inventory managed location ID from SAP Business ByDesign system
Distribution channel code Distribution channel code from SAP Business ByDesign system
Discount price list ID Price list ID, which contains the discounted price for articles or materials in SAP Business ByDesign system
Clearing house account ID (Optional) Clearing House Account ID from SAP Business ByDesign system
Dummy business partner ID (Optional) Dummy Business Partner ID for credit card payments
Site ID Site ID in your SAP Business ByDesign system
ERP party internal ID Party internal ID of the communication arrangement maintained in SAP Business ByDesign configuration
SAP Customer Checkout Configuration GuideIntegration CUSTOMER 97
Option Description
Read customer service package size Number of customers synchronized together
Read material service package size Number of articles synchronized together
Read voucher service package size Number of vouchers synchronized together
Endpoint Port URL of the SAP Business ByDesign system. To enable SSL communication from the application side, change the protocol from http to https.
ECM Description Description of the e-commerce management/Web shop integration communication arrangement
ECM Host Host name of the e-commerce management/Web shop integration communication arrangement
ECM Path Path to the e-commerce management/Web shop integration communication arrangement
ECM Port Port used by the e-commerce management/Web shop integration communication arrangement
ECM Connection timeout (in seconds) Connection timeout value of the e-commerce management/Web shop integration communication arrangement in seconds. The default value is 30 seconds.
NoteIf the connection times out, it is shown as failed.
ECM User Name User name for e-commerce management/Web shop integration communication arrangement
ECM Password Password for e-commerce management/Web shop integration communication arrangement
POS Description Description of the point of sale communication arrangement
POS Host IP address or host name of the point of sale communication arrangement
POS Path Path to the point of sale communication arrangement
POS Port Port used by the point of sale communication arrangement
98 CUSTOMERSAP Customer Checkout Configuration Guide
Integration
Option Description
POS Connection timeout (in seconds) Connection timeout value of the point of sale communication arrangement in seconds. The default value is 30 seconds.
NoteIf a connection times out, it is shown as failed.
POS User Name User name for the point of sale communication arrangement
POS Password Password for the point of sale communication arrangement
11.1.3 SAP Business One Integration
Configure the integration of SAP Customer Checkout with SAP Business One.
SAP Business One Integration Settings
Option Description
System ID The system ID of the SAP Business One company that connects to SAP Customer Checkout.
SAP Customer Checkout Configuration GuideIntegration CUSTOMER 99
Option Description
Store ID (beta version) If you are not using stores in SAP Business One, leave this field blank.
CautionStore support is a new feature in SAP Customer Checkout, currently available as a beta version only. It may not include the expected functional range for all possible scenarios. Before implementation and use, we recommend that you analyze, test, and verify any actual productive scenarios and user requirements.
SAP Customer Checkout supports the use of stores in SAP Business One. You can assign SAP Customer Checkout to one store only, using a store ID.
Once you have assigned a store ID, all accesses and postings to SAP Business One use this ID. Business documents are all created for the assigned store.
Only business documents belonging to the assigned store can be called up from SAP Business One and processed. This is not possible for business documents belonging to other stores.
NoteSAP Customer Checkout always transmits all customer master data from SAP Business One, independent of the assigned store.
Check account The check account number used in the SAP Business One system.
NoteThis field is not currently used in SAP Customer Checkout.
100 CUSTOMERSAP Customer Checkout Configuration Guide
Integration
Option Description
Credit account The default general ledger account for credit cards in the SAP Business One system.
To find the G/L account:
1. Choose Administration Setup Banking Credit
Cards2. Copy the value of the "General Ledger Account" field.
If the "Credit Cards Setup" table contains more than one credit card entry, choose any of the values. For more information about credit cards, see the SAP Customer Checkout Integration Guide.
Dummy customer ID The BP code of the default customer for A/R invoices and payment.
To find the business partner code:
1. Choose Administration Setup Financials GL
Account Determination .On the "General" tab page, copy the BP code of the default customer for A/R invoices and payment.
Payment terms The SAP Business One payment terms you want to use for your SAP Customer Checkout application.
Dummy Salesperson Code Default salesperson code sent to the SAP Business One system in case you do not provide a salesperson.
Number range ID for customer creation SAP Business One customer number series code you want to use for customers created in SAP Customer Checkout
Distribution rule (Optional) The SAP Business One distribution rule you want to use.
1. Choose Financials Cost Accounting Distribution
Rules .Retrieve the information from the "Code" field.
SAP Customer Checkout Configuration GuideIntegration CUSTOMER 101
Option Description
Address mode Which customer addresses are added to receipts
You have the following options:
● Default: The default address as defined for the customer in SAP Business One
● Blank: No address is added● Base document: If a sales order or sales quotation from
SAP Business One creates a receipt in SAP Customer Checkout, the address from the sales order is added. On the Sales screen, however, the default customer address still appears.
Exchange rate posting Setting from the SAP Business One system that determines how exchange rates are processed in SAP Business One
Enable automatic batch number determination Enabled:
If an article that requires a batch number is added to the document, a selection dialog for batch numbers is not displayed. The batch number is assigned automatically based on the "first in, first out" principle via the integration framework for SAP Business One, before the document is transferred to SAP Business One.
NoteIf this option is activated and items are sold with a batch number, the corresponding receipts cannot be returned in SAP Customer Checkout. Such receipts must be returned in the SAP Business One system.
Disabled:
If an article that requires a batch number is added to the document, a selection dialog for batch numbers appears, which displays the available batch numbers from SAP Business One. The batch number must be assigned to the article manually.
102 CUSTOMERSAP Customer Checkout Configuration Guide
Integration
Option Description
Enable automatic serial number determination Enabled:
If an article that requires a serial number is added to the document, a selection dialog for serial numbers is not displayed. The serial number is assigned automatically based on the "first in, first out" principle via the integration framework for SAP Business One, before the document is transferred to SAP Business One.
NoteIf this option is activated and items are sold with a serial number, the corresponding receipts cannot be returned in SAP Customer Checkout. Such receipts must be returned in the SAP Business One system.
Disabled:
If an article that requires a serial number is added to the document, a selection dialog for serial numbers appears, which displays the available serial numbers from SAP Business One. The serial number must be assigned to the article manually.
Save messages in B1i message log Enables/disables the storage of messages in the message log for the integration component for SAP Business One
Create credit memo on negative receipt amount Enables or disables the creation of a credit memo if the receipt amount is negative.
NoteIf this option is enabled and the receipt amount is negative, a credit memo is created in the SAP Business One system.
Read customer service package size Number of customers synchronized together
Read material service package size Number of articles synchronized together
Read voucher service package size Number of vouchers synchronized together
Webservice endpoint Host IP address or host name of the SAP Business One system
Webservice endpoint Path Path to the SAP Business One system
Webservice endpoint Port Port number used by the SAP Business One system
SAP Customer Checkout Configuration GuideIntegration CUSTOMER 103
Option Description
Webservice endpoint connection timeout (in seconds) Connection timeout value of the SAP Business One system in seconds. Default value: 30 seconds
NoteIf the connection times out, it is shown as failed.
Webservice endpoint User name User who communicates with the SAP Business One system
Webservice endpoint Password Password for the user who communicates with the SAP Business One system
Check connection and authentication Verifies the connection to the SAP Business One system
NoteThis option is not available in edit mode.
REST endpoint Path Path to the SAP Business One system
SAP Business One Service Endpoint SAP Business One service endpoint; do not change the default value
REST endpoint Connection timeout (in seconds) Connection timeout value of the SAP Business One system in seconds. Default value: 30 seconds
NoteIf the connection times out, it is shown as failed.
11.1.4 SAP Customer Checkout manager Integration
When using the SAP Customer Checkout manager as a back-end system, all relevant service endpoint information has already been entered in the initial configuration steps, or can be maintained from the SAP Customer Checkout manager tab within the configuration.
104 CUSTOMERSAP Customer Checkout Configuration Guide
Integration
Option Description
Read customer service package size Number of customers synchronized together.
NoteWith SAP Customer Checkout 2.0 Feature Pack 01 this field has no relevance, as it is not yet possible to create customers in the SAP Customer Checkout manager.
Read material service package size Number of articles synchronized together.
Read voucher service package size Number of vouchers synchronized together.
For more information, see the SAP Customer Checkout manager Guide (section Using the SAP Customer Checkout manager as backend system).
11.2 SAP Customer Checkout manager
In this section, you can maintain all relevant settings when using the SAP Customer Checkout manager integrated to your SAP Customer Checkout application.
NoteFor more information, see the SAP Customer Checkout manager Guide.
SAP Customer Checkout Manager Settings
Option Description
Enable central update management Enables/disables the option to use SAP Customer Checkout manager for automatic software updates.
NoteTo use the SAP Customer Checkout manager for automatic software updates, you also need to set the schedule to check for updates in the About tab within the Configuration in SAP Customer Checkout.
For further information, see Schedule Check for Updates [page 126].
SAP Customer Checkout Configuration GuideIntegration CUSTOMER 105
Option Description
Enable central user management Enables/disables the option of using central user and role management in SAP Customer Checkout manager.
If central user management is activated, the user synchronization option is displayed and can be executed from the Synchronization tab.
Central Customer Management Enables/disables the option of using central customer management in SAP Customer Checkout manager.
NoteIf SAP Customer Checkout is interconnected with another SAP back-end system, you can also use central customer management in SAP Customer Checkout manager. For more information about the interaction of central customer management with other SAP back-end systems, see Central Customer Management in Combination with Other SAP Back-End Systems [page 115].
Enable central quick selection management Enables/disables the option of using SAP Customer Checkout manager for configuring quick selection options.
Enable central time recording Enables/disables the option of using central time recording in SAP Customer Checkout manager to perform time recording transactions in SAP Customer Checkout.
Enable central coupon management Enables/disables the option of using coupons created in SAP Customer Checkout manager.
106 CUSTOMERSAP Customer Checkout Configuration Guide
Integration
Option Description
Enable central article management Enables/disables the option of using central article management in SAP Customer Checkout manager.
NoteIf you are using SAP Customer Checkout manager as a back-end system, this option is automatically enabled and cannot be edited.
CautionWhen using an SAP Business One, SAP Business ByDesign, or SAP ECC (Retail) system, and you have enabled the central article management, articles are fetched from SAP Customer Checkout manager and not from the SAP ERP system. When you are posting a receipt to the SAP ERP system and you have selected an article from SAP Customer Checkout manager, the respective article ID must be identical in both systems (SAP Customer Checkout manager and SAP ERP system). If the article ID (fetched from the SAP Customer Checkout manager) does not exist in the SAP ERP system, an error is generated, and the receipt is not posted to the SAP ERP system.
SAP Customer Checkout Configuration GuideIntegration CUSTOMER 107
Option Description
Enable central price list management Enables/disables the option of using central price list management in SAP Customer Checkout manager.
NoteIf you are using SAP Customer Checkout manager as a back-end system, this option is automatically enabled.
CautionWhen using an SAP Business One, SAP Business ByDesign, or SAP ECC (Retail) system (to synchronize article data) and you have enabled central price list management, the price list ID created in SAP Customer Checkout manager must be identical to the price list ID in the respective SAP ERP system. Otherwise, synchronization of price lists will not work.
Enable SAP Event Ticketing integration Enables/disables the option of integrating SAP Customer Checkout with SAP Event Ticketing.
Once this field is activated, the SAP Event Ticketing integration subtab is displayed in the configuration.
NoteFor more information on integrating SAP Event Ticketing, see the SAP Customer Checkout manager Guide.
108 CUSTOMERSAP Customer Checkout Configuration Guide
Integration
11.2.1 Monitoring
In this section, you can maintain monitoring information (status message) about your SAP Customer Checkout application to be sent to SAP Customer Checkout manager. The SAP Customer Checkout application sends regular notifications about the state of the application to SAP Customer Checkout manager.
Monitoring Settings
Option Description
Enable central monitoring Enable/ disable the option to use the central monitoring of SAP Customer Checkout manager to send regular status messages from various SAP Customer Checkout applications.
NoteEven when this option is disabled, SAP Customer Checkout continues to send some event information to SAP Customer Checkout manager, including the following:
● App started● New instance of SAP Customer Checkout manager
SAP Customer Checkout Configuration GuideIntegration CUSTOMER 109
Option Description
Severity Determines the level of importance or relevance of a message from SAP Customer Checkout to be sent to SAP Customer Checkout manager.
Possible levels are:
● Information: all information sent from the SAP Customer Checkout application that is not critical (for example, starting the application or login).
● Warning: Information sent from the SAP Customer Checkout application that requires attention (for example, the lack of free disc space).
● Debug: all information sent from the SAP Customer Checkout application to analyze the coding.
● Error: Information sent from the SAP Customer Checkout application that contains errors or prevents transactions from executing (for example, failure of synchronization job).
NoteIf Information is set as the Severity, Warnings and Errors are also included and sent to SAP Customer Checkout manager.
NoteAs of a certain extent, the transfer of messages and system messages may affect the performance of SAP Customer Checkout. The transfer of such messages within large system landscapes can affect the performance of SAP Customer Checkout manager. We therefore recommend using a severity level no higher than Error or Warning.
Ping interval in seconds Length of time that elapses between messages sent from the SAP Customer Checkout application to SAP Customer Checkout manager.
Set this value to 0 to deactivate the ping.
110 CUSTOMERSAP Customer Checkout Configuration Guide
Integration
Option Description
Enable central monitoring system logging Enable/disable the option of sending all logging messages that are shown in the SAP Customer Checkout console to SAP Customer Checkout manager.
RecommendationWe recommend to deactivate this option, to save memory space.
NoteThis field depends on the selected SAP Customer Checkout monitoring level to be sent to SAP Customer Checkout manager.
11.2.2 Receipt management
When working with the SAP Customer Checkout manager, you can enable central receipt management to post all receipts from the SAP Customer Checkout application also to the SAP Customer Checkout manager.
NoteWhen the central receipt management option is activated in SAP Customer Checkout, the following transactions take place:
● Once you post a receipt in SAP Customer Checkout, it is also posted in SAP Customer Checkout manager and in the SAP ERP system.
● Returned receipts are fetched from the SAP Customer Checkout manager.● When you return a receipt in SAP Customer Checkout, the canceled items and canceled payments
items are not shown in the SAP Customer Checkout application.● When you perform a receipt job or a receipt synchronization, the transaction is also posted in the SAP
Customer Checkout manager.● When you repost a receipt from SAP Customer Checkout, the receipt is also reposted in the SAP
Customer Checkout manager.● When performing day-end closing, sales summaries are also transferred to SAP Customer Checkout
manager. Sales summaries that were not transferred successfully are transferred during receipt synchronization.
CautionBy default, parked and new receipts are not sent to the SAP Customer Checkout manager. However, if the Enable central receipt parking option is activated, parked receipts are also transferred to the SAP Customer Checkout manager.
SAP Customer Checkout Configuration GuideIntegration CUSTOMER 111
Receipt Management Settings
Option Description
Enable central receipt management Enable/ disable the option to post receipts centrally from the SAP Customer Checkout to the SAP Customer Checkout manager.
NoteWhen using the SAP Customer Checkout manager as a back-end system, you cannot edit this field, as the receipts posted from the SAP Customer Checkout application are automatically sent to the SAP Customer Checkout manager.
Transmit receipt for creation date The date from which created receipts are transmitted to the SAP Customer Checkout manager
If this value is set to null (or blank), all receipts are transmitted to the SAP Customer Checkout manager.
The default value is the current date.
Enable receipt fetching Enabled:
Fetches receipts from the SAP Customer Checkout manager.
NoteIf Enable receipt fetching is activated, the SAP ERP system is not checked for receipts.
Disabled:
Fetches receipts directly from the SAP ERP system without checking in the SAP Customer Checkout manager.
Enable central receipt parking Enabled:
Parked documents are transferred to SAP Customer Checkout manager. Parked receipts from other POS systems for which this option is also enabled can be accessed and resumed using SAP Customer Checkout manager.
Disabled:
Parked receipts are saved only locally in SAP Customer Checkout. Only locally parked receipts can be resumed.
To check whether a receipt has been successfully transmitted to the SAP Customer Checkout manager, you can use the Search magnifying glass icon in the upper-right corner of the SAP Customer Checkout screen. The receipt tab includes the field Transmitted to SAP Customer Checkout manager. A checkmark in this field indicates that the receipt has been posted successfully in the SAP Customer Checkout manager.
112 CUSTOMERSAP Customer Checkout Configuration Guide
Integration
You can find more information about the central receipt management concept in the SAP Customer Checkout Manager Guide.
11.2.3 Webservice Endpoint
In this section, you can maintain webservice endpoint data for working with SAP Customer Checkout manager.
If you have already entered data in the initial configuration (for example, when opting to use SAP Customer Checkout manager as a backend system), the data automatically appears in SAP Customer Checkout manager.
Webservice Endpoint Settings
Option Description
Host URL or IP address of SAP Customer Checkout manager system
Example:
http://127.0.0.1:8080/ccos
Host: http://127.0.0.1:
Path Path to SAP Customer Checkout manager system
Example:
http://127.0.0.1:8080/ccos
Path: /ccos/api
Port Port number used by SAP Customer Checkout manager
Example:
http://127.0.0.1:8080/ccos
Port: 8080
SAP Customer Checkout Configuration GuideIntegration CUSTOMER 113
Option Description
Tenant ID ID of tenant you want to connect with SAP Customer Checkout.
NoteIf you are using SAP Customer Checkout manager in multi-tenant mode, you can enter the corresponding tenant ID here.
NoteFor more information about multi-tenant mode, see the SAP Customer Checkout Manager Guide (under "Using SAP Customer Checkout manager in Multi-Tenant Mode").
Connection timeout (in seconds) Connection timeout value of SAP Customer Checkout manager system, in seconds. Default value: 30 seconds
NoteIf the connection times out, it is displayed as "failed".
User name User name for connecting with SAP Customer Checkout manager
Password Password for connecting with SAP Customer Checkout manager
Check connection and authentication Verifies the connection with SAP Customer Checkout manager.
NoteThis option is not available in edit mode.
114 CUSTOMERSAP Customer Checkout Configuration Guide
Integration
11.2.4 Central Customer Management in Combination with Other SAP Back-End Systems
You can also use the customer management feature in SAP Customer Checkout manager if SAP Customer Checkout is interconnected with another SAP back-end system.
Context
To use the customer management feature of the connected back-end system (e.g. SAP Business One), leave central customer management deactivated.
To use the customer management feature of SAP Customer Checkout manager, activate central customer management.
Procedure
1. Select the Integration tab and then the SAP Customer Checkout manager tab.2. Activate central customer management.3. Choose Save.
11.3 Voucher
In this section, you can configure voucher settings for SAP Customer Checkout. You can use SAP Customer Checkout manager to centrally manage vouchers in your SAP Customer Checkout application.
T
11.3.1 SAP Customer Checkout Manager Voucher Module
If you are using the SAP Customer Checkout manager application for the central management of your vouchers, all relevant service endpoint information is maintained in the SAP Customer Checkout manager subtab.
For more information, see section Webservice Endpoint [page 113] and also the SAP Customer Checkout manager Guide.
SAP Customer Checkout Configuration GuideIntegration CUSTOMER 115
11.4 SAP Event Ticketing Integration
This section describes the settings required for SAP Event Ticketing integration.
This tab is displayed only if the Enable SAP Event Ticketing integration field is activated in SAP Customer Checkout manager.
NoteFor more information, see the SAP Customer Checkout manager Guide.
Settings
Option Description
Material prefix Material ID used for the ticket. The material ID must also be available as an article in SAP Customer Checkout manager.
Tickets purchased in SAP Customer Checkout can be printed out. This requires installation of a separate SAP Event Ticketing print software: SAP Event Ticketing local
NotePlease note that the tickets are printed via SAP Event Ticketing local, and not via the SAP Customer Checkout system. For more information, see the documentation for SAP Event Ticketing local.
1. Go to https://wpb101103.hana.ondemand.com/wpb/pub/sap_event_ticketing/index.html?show=group!GR_EBE5546EE673D117B#cdoc!CD_5CDFA1D345915AA2&show=group!GR_EBE5546EE673D117B
2. Download the installation file for SAP Event Ticketing local.3. If necessary, extract the SAP_ET_local_1807_181202_setup.exe file from the archive and run the
installation.4. Start SAP Event Ticketing local by double-clicking the respective desktop shortcut or by selecting SAP
Event Ticketing local from the Windows start menu.5. Go to Settings and select the printplugin settings.6. Enter the following values into the relevant fields:
Field Value
DisplayLocaleMessages true
DisplayLocaleErrorMessages true
debug work
7. Save your entries.
Configuration of SAP Event Ticketing local
Option Description
Port Port number used by SAP Event Ticketing local
116 CUSTOMERSAP Customer Checkout Configuration Guide
Integration
Option Description
Connection timeout (in seconds) Connection timeout value for SAP Event Ticketing local (in seconds). Default value: 30 seconds
NoteIf the connection times out, it is displayed as "failed".
Check connection and authentication Verifies the connection with SAP Event Ticketing local.
NoteThis option is not available in edit mode.
SAP Customer Checkout Configuration GuideIntegration CUSTOMER 117
12 Users and Roles
In this section, you can configure users and roles to be used in SAP Customer Checkout.
For information about users and roles, see the SAP Customer Checkout Administration and Operations Guide, section User and Role Management.
When using the central user management of the SAP Customer Checkout manager, see the SAP Customer Checkout manager Guide.
118 CUSTOMERSAP Customer Checkout Configuration Guide
Users and Roles
13 Additional Fields
The Additional Fields and Alternative ID concepts allow SAP Customer Checkout to attach additional information to a range of entities used by the application without altering the database. This information is normally processed by a separate plug-in. In this section, you can customize how this information appears to the user.
13.1 Additional Fields
Settings for additional fields
Option Description
Name Name of the field
Entity Entity type to which additional information is attached
Type Field type of the additional field
Value List Valid only if Type is set to Value List (for a dropdown list)
List of values to be shown in a dropdown list
Translation Text that is shown to the user; includes translations
Editable by For future use, currently provides no functionality
Hidden for For future use, currently provides no functionality
Delete Deletes the entry
13.2 Alternative ID Types
In this section, you can link an alternative ID to a specific entity type. For example, users in the form of user entities can have an alternative ID.
Settings for Alternative ID Types
Option Information
Entity Name Entity type that has an additional alternative ID
Alternative ID Type Name of alternative ID type; also used as the label for the alternative ID on the user interface
Delete Deletes the entry
SAP Customer Checkout Configuration GuideAdditional Fields CUSTOMER 119
14 Plug-Ins
Plug-ins enable SAP Customer Checkout to provide additional custom functionality. Plug-ins must be stored in the /POSPlugins/AP subfolder of the installation directory.
NoteThe provision of additional features and changes to SAP Customer Checkout using plug-ins may affect the validity of certification for NF 525 for France and French overseas departments. For more information about the possible effects on the certification, see POS Software Certification According to NF 525 (France) [page 135].
Plug-in data
Option Description
ID Internal ID of the plug-in
Name Name of the plug-in
Version Version of the plug-in
Version check Currently provides no functionality
Settings Choose the cogwheel icon to access the plug-in-specific settings
Details Choose the blue pushbutton to display additional information about the plug-in
The following plug-ins are shipped with SAP Customer Checkout:
● RKSV plug-In (Austrian cash register ordinance (Registrierkassensicherheitsverordnung): For more information, see SAP Note 2428004 .
● Pepper plug-in: For more information, see https://partneredge.sap.com/en/products/scc/about.html● Bluecode plug-in: For more information, see Bluecode Plug-In [page 120]
14.1 Bluecode Plug-In
The SAP Customer Checkout sales process supports payments by Bluecode app.
Context
NoteBluecode is a European mobile payment solution that enables non-cash payments by smartphone. For more information, see https://bluecode.com/en .
120 CUSTOMERSAP Customer Checkout Configuration Guide
Plug-Ins
Customers and partners wanting to use Bluecode as a payment option require a separate contract with Bluecode.
SAP Customer Checkout requires the Bluecode plug-in for communication with Bluecode.
The Bluecode plug-in is shipped with SAP Customer Checkout and is located in the tools folder contained in the SAP Customer Checkout installation directory.
Procedure
1. Place the Bluecode plug-in into the /POSPlugins/AP subfolder of the SAP Customer Checkout installation directory.
Example: C:\SapCustomerCheckout\cco\POSPlugins\AP2. The Bluecode plug-in is displayed on the Plug-Ins tab.3. You can enter all required information under Settings.
Keys Description
Payment limit Maximum payment amount for Bluecode payments.
Default value: 100,000 in the current currency.
Payment card ID Enter the same ID for the card type that you have maintained in the Accounting tab.
API URL For further information, please see Bluecode documentation.
Copy payment item after failure Specifies the reaction in the event of a payment being triggered that cannot be completed.
Default value: 1. If you set the value to 0, the payment item is removed after a failed payment.
Branch ID For further information, please see Bluecode documentation.
API Password For further information, please see Bluecode documentation.
API User Name For further information, please see Bluecode documentation.
Membership kind For further information, please see Bluecode documentation.
NoteThis field can be used in combination with your own Bluecode app for identifying the customer during payment.
SAP Customer Checkout Configuration GuidePlug-Ins CUSTOMER 121
Keys Description
API Timeout For further information, please see Bluecode documentation.
4. Save your changes.5. Choose checkCredentials() to check whether the logon with Bluecode was successful.
122 CUSTOMERSAP Customer Checkout Configuration Guide
Plug-Ins
15 About
This section provides general information about the application and some general functionality.
15.1 About
This section provides specific information about the SAP Customer Checkout installation, version, and the Java Runtime Environment (JRE) used by SAP Customer Checkout.
About Section
Option Description
Serial number Software serial number of terminal
NoteIf you have connected the TSE required for POS Security Regulation 2020 in SAP Customer Checkout, you need this serial number for logging in with the tax authorities. For more information, see POS Security Regulation 2020 for Germany [page 142]
Release name
Build number Internal build number
Version Internal version number
Copyright Copyright information
15.2 License
In this section, you will find information about the current status of your SAP Customer Checkout license. You can deactivate license management and check the license.
As of SAP Customer Checkout 2.0 Feature Pack 08, you require a valid license for each SAP Customer Checkout application. Licensing information is maintained only in SAP Customer Checkout manager, where this information is then binding.
After every installation, you receive a temporary license that is valid for 28 days starting from the installation date. Before the temporary license expires, you must request a permanent license key. For more information, see the Licenses section of the SAP Customer Checkout manager Guide.
SAP Customer Checkout Configuration GuideAbout CUSTOMER 123
A license check (of the respective POS system to SAP Customer Checkout manager) is executed automatically every hour.
In this area, you have the Check license option. This executes a manual license check and the status of your SAP Customer Checkout license is updated.
15.3 Lifecycle
In this section, you can view information about the current status of SAP Customer Checkout and manage the application lifecycle.
Context
In this section, you can view information about the current status of SAP Customer Checkout and manage the application lifecycle. The current application lifecycle comprises two possible states, Test and Productive. SAP Customer Checkout is initially installed in test mode, which is intended for use during setup of the application and its environment. As long as the application remains in test mode, the Test mode flag is displayed on the sales screen and all printed receipts contain a note that they were printed in test mode. These flags and notes are removed once you switch to productive mode. In addition, you can also delete all master data and transaction data (receipts, customers, etc.) while the application is in test mode. To delete test data, choose Delete test data and confirm the prompt that appears. In the next dialog, you can change the respective values if necessary. To execute the deletion of test data, choose OK, Reset Data.
When the setup process is finished, switch the application to productive mode as follows:
Procedure
When switching to productive mode, you can decide whether to delete the existing test data.1. Choose Switch to productive mode.
○ Choose Yes, remove test data to delete all test data and to switch to productive mode.
NoteIf you select Yes, remove test data when switching to productive mode, SAP Customer Checkout resets all sequence numbers to their initial values.
○ Choose Yes, do not remove test data to retain all test data and switch to productive mode.
CautionIf you choose Yes, do not remove test data, SAP Customer Checkout is immediately set to productive mode without further prompt.
124 CUSTOMERSAP Customer Checkout Configuration Guide
About
○ Choose No, remain in test mode to remain in test mode.If you selected Yes, remove test data, further steps are necessary.2. In the dialog box that appears, verify and edit the application settings for productive mode.
The application settings displayed will most likely apply to an ERP test system. In this case, enter the values for the ERP system intended for productive use. For a description of the application settings, refer to chapter Integration [page 91].
3. Once you have entered the necessary data, choose OK, reset data.
SAP Customer Checkout now deletes all test data (customers, articles, and so on) from the database and restarts the application.
4. After the application has restarted, synchronize data with the ERP system again.
15.4 External System Connected
This section displays the name of the connected external ERP system.
15.5 Configuration Export/Import
In this section, you can export the current configuration to an XML file or import a configuration from an XML file.
You can use the configuration file to import the configuration from another SAP Customer Checkout installation. However, both installations must have been configured with the same key phrase during initial setup, since the key phrase is used for password encryption.
NoteIf you use the configuration file from a SAP Customer Checkout installation that is configured with a different key phrase, you have to reset the passwords in the integration settings after importing and restarting SAP Customer Checkout.
To export the current configuration, choose Export. The configuration file is stored in the default download folder of the Web browser used with SAP Customer Checkout.
To import a configuration, click Choose File. In the dialog box that appears, select the configuration file to be imported. After the import, you have to restart SAP Customer Checkout.
SAP Customer Checkout Configuration GuideAbout CUSTOMER 125
15.6 Exporting/Importing Users and Roles
As of SAP Customer Checkout 2.0 Feature Pack 09, the export/import feature for users and roles is available in SAP Customer Checkout manager only. For more information, see the SAP Customer Checkout manager Guide.
15.7 Import Vouchers
As of SAP Customer Checkout 2.0 Feature Pack 09, vouchers in SAP Customer Checkout can be imported via SAP Customer Checkout manager only. For more information, see the SAP Customer Checkout manager Guide.
15.8 Schedule Check for Updates
In this section, you can schedule update checks for SAP Customer Checkout or disable any scheduled checks.
You can store software updates in SAP Customer Checkout manager and configure SAP Customer Checkout to check this location for available updates. When a new version is available, SAP Customer Checkout downloads it to the update folder of the SAP Customer Checkout installation. The next time a user starts the application, SAP Customer Checkout prompts him or her to execute the update. You can perform checks manually or configure SAP Customer Checkout to check for updates automatically.
To schedule a check or configure automatic checks, choose Schedule Synchronization. You can trigger checks to start immediately, to start once on a defined date, at recurring intervals (Hourly, Daily, Weekly or Monthly), or, by using a CRON expression in Quartz CRON format, in a user-defined manner.
To cancel any configured checks, choose Cancel Scheduled Synchronization.
When using the SAP Customer Checkout manager, you can schedule software updates to be managed by the SAP Customer Checkout manager.
NoteTo manage software updates, you must also select Enable central update management in the SAP Customer Checkout manager subtab of the Integration tab in SAP Customer Checkout.
126 CUSTOMERSAP Customer Checkout Configuration Guide
About
15.9 Data Reset
In this section, you can remove articles from SAP Customer Checkout database that have been deleted from the ERP system but synchronized in the SAP Customer Checkout database.
Context
Articles Data Reset Details
Option Description
Set articles to ‘inactive’ Set all articles to status "inactive" in SAP Customer Checkout. Articles that are inactive are not shown during the standard sales process, and can no longer be used for sales.
Example: When a new article is created in the ERP system and synchronized with SAP Customer Checkout, it can then be used in SAP Customer Checkout for sales. When you delete this article in the ERP system, it remains in the SAP Customer Checkout database as active and is not deleted during synchronization. To ensure that deleted articles are not considered during the sales process, set them to inactive.
A full synchronization with the ERP system ensures that all relevant articles remain active, while inactive ones are deleted.
To ensure that all deleted articles are never considered in the sales process of SAP Customer Checkout, delete them using Delete unused articles.
Delete unused articles Delete unused articles that are marked inactive, from the SAP Customer Checkout database.
Example: When a new article is created in the ERP system and you synchronize the articles in SAP Customer Checkout, this article will be shown in SAP Customer Checkout as Active. If this new article is deleted in the ERP system, it will still be available in SAP Customer Checkout.
After executing the action ‘Set articles to Inactive and perform a full synchronization, only the deleted articles are marked inactive. In order to delete the unused and inactive articles, the action Delete unused articles has to be executed.
In this section, remove customers from SAP Customer Checkout database that have been are deleted from the ERP system but synchronized in the SAP Customer Checkout database.
SAP Customer Checkout Configuration GuideAbout CUSTOMER 127
Customer Data Reset Details
Option Description
Set customers to ‘obsolete’ Sets all customers in status obsolete in the SAP Customer Checkout. Customers that are obsolete are not shown in standard sales process of SAP Customer Checkout. Obsolete customers cannot be used in the sales process anymore.
Example: When a new customer is created in the ERP System and you synchronize this customer in the SAP Customer Checkout, this customer can be selected in SAP Customer Checkout for a sales process. When you delete this customer in the ERP system, the customer will still remain in the SAP Customer Checkout database as active and is not deleted in the SAP Customer Checkout database with synchronization. To ensure that all these deleted customers are not considered in the sales process of SAP Customer Checkout, execute this action and all customers will be set to obsolete.
Perform a full synchronization with the ERP system and all relevant customers are marked as Active while the deleted customers remain obsolete.
To ensure that all deleted customers will not be considered in the sales process of SAP Customer Checkout, you need to use the Delete unused customers option.
Delete unused customers Deletes unused customers, which are marked as obsolete, from the SAP Customer Checkout database.
Example: When a new customer is created in the ERP system and you synchronize the customers in SAP Customer Checkout, this customer will be shown in SAP Customer Checkout as Active. If this new customer is deleted in the ERP system, the customer will still be available in the SAP Customer Checkout.
After executing the action Set customers to obsolete and perform a full synchronization, only the deleted customers will be marked as obsolete. In order to delete the unused and obsolete customers, the action Delete unused customers has to be executed.
128 CUSTOMERSAP Customer Checkout Configuration Guide
About
16 Overview of Localization Settings
This section describes how to configure country- or region-specific settings in SAP Customer Checkout. The application is only available in the D-A-CH region.
NoteMost settings mentioned are provided with default values. SAP recommends that you validate all default settings for your specific situation, and customize them only as necessary.
16.1 Country/Region
By default, SAP Customer Checkout is set to "Germany". Tax rates depend on the country/region. You can change the country/region on the POS system tab.
16.2 Currency
SAP Customer Checkout is preconfigured with the following information:
● Currency is set to euro.Currency has to be maintained in two locations. To change the currency, first add the new currency on the Currency tab. Next, set the Currency used by the application in the POS system tab.
● Currency icons for notes and coins are all common euro denominations.You can change icons and units on the Currency tab.
NoteCurrency icons for Swiss francs are also included with SAP Customer Checkout. The icons are automatically loaded after an application restart, if you maintain the currency CHF and the respective denominations.
● Default Petty Cash values are for euros.You can change Petty Cash values on the Accounting tab.
● Default field mappings are for Euros.You can change field mappings on the POS system tab.
SAP Customer Checkout Configuration GuideOverview of Localization Settings CUSTOMER 129
NoteTo process payments with multiple currencies, do the following:
1. Maintain the currencies and exchange rates on the Currency tab.2. Add the respective Petty Cash values on the Accounting tab.3. If necessary, add the respective Field mappings on the POS system tab.
16.3 Customer
By default, customer information prints on receipts.
The information uses the following format:
<Customer ID>
<First Name> <Last Name>
<Street> <Street Number>
<Postal Code> <City>
<Telephone Number>
You can disable this setting on the Hardware tab.
16.4 Tax
SAP Customer Checkout is preconfigured with the following tax information:
● Tax rates for GermanyYou can change tax rates on the Accounting tab.
● Tax Character Code List ID for Germany (for SAP Business ByDesign)You can change the Tax Character Code List ID on the POS system tab.
You must maintain the Tax Authority, Tax Number and VAT number for your company. This information will be printed on receipts. You can change these values on the POS system tab.
130 CUSTOMERSAP Customer Checkout Configuration Guide
Overview of Localization Settings
16.5 Time and Date
SAP Customer Checkout uses the system default date and time format (including time zone). Users can change the date and time format by choosing another locale in the User Configuration, which you can access by clicking the user name in the top-right corner of the screen.
16.6 Unit of Measure and Currency Codes
If required, you can maintain field mappings for unit of measure and currency codes in the POS system tab.
16.7 Unit Price
By default, unit prices received from the external system are treated as net price.. You can change this behavior by enabling Gross price for the respective price lists in the Sales tab.
SAP Customer Checkout Configuration GuideOverview of Localization Settings CUSTOMER 131
17 Attachment
17.1 Mail Monitoring Filter Keys
Use filter keys, which are restricted to a specifc monitoring level, to monitor only specific events.
17.1.1 Error Events
Error Events
Filter Key Description
ERROR_POST_TO_EXTERNAL_SYSTEM_XSTATE Error while posting to external system
ERROR_POST_TO_EXTERNAL_SYSTEM_EXCEPTION Exception while posting to external system
ERROR_RETRIEVE_FROM_EXTERNAL_SYSTEM_XSTATE Error while fetching from the external system
ERROR_RETRIEVE_FROM_EXTERNAL_SYSTEM_EXCEPTION
Exception while fetching from the external system
ERROR_LOG Error log items
ERROR_DICOUNT_JOB_FETCH Error during synchronization while fetching discounts from the external system
ERROR_RECEIPT_JOB_CLOSING_POST Error while posting day-end closing
ERROR_VOUCHER_JOB_FETCH Error during synchronization while fetching vouchers from the external system
ERROR_MATERIAL_JOB_FETCH Error during synchronization while fetching articles from the external system
ERROR_CUST_JOB_POST Error during synchronization while posting customers to the external system
ERROR_CUST_JOB_FETCH Error during synchronization while fetching customers from the external system
ERROR_RECEIPT_JOB_POST Error during receipt synchronization while posting receipts to the external system
ERROR_VOUCHER_JOB_POST Error during voucher synchronization while posting vouchers to the external system
132 CUSTOMERSAP Customer Checkout Configuration Guide
Attachment
17.1.2 Warning Events
Warning Events
Filter Key Description
WARNING_LOG Warning log items
17.1.3 Info Events
Info Events
Filter Key Description
MISC Currently provides no functionality
APP_START Application start
APP_SHUTDOWN Application stop
INFORMATION_LOG Information log items
CUST_JOB_START Customer synchronization start
DONE_CUST_JOB_POST Posting to external system during customer synchronization has finished
CUST_JOB_END Customer synchronization end
MATERIAL_JOB_START Article synchronization start
MATERIAL_JOB_END Article synchronization end
RECEIPT_JOB_START Receipt synchronization start
RECEIPT_JOB_END Receipt synchronization end
VOUCHER_JOB_START Voucher synchronization start
VOUCHER_JOB_END Voucher synchronization end
DISCOUNT_JOB_START Discount synchronization start
DISCOUNT_JOB_END Discount synchronization end
DONE_DICOUNT_JOB_FETCH Fetching from external system during discount synchronization fetch has finished
PING Activity indicator from running application
UPDATE_DONE Update process has finished
DONE_RECEIPT_JOB_CLOSING_POST Day-end closing posting has finished
DONE_VOUCHER_JOB_FETCH Fetching from external system during vouchers synchronization has finished
DONE_MATERIAL_JOB_FETCH Fetching from external system during article synchronization has finished
SAP Customer Checkout Configuration GuideAttachment CUSTOMER 133
Filter Key Description
DONE_CUST_JOB_FETCH Fetching from external system during customer synchronization has finished
DONE_RECEIPT_JOB_POST Posting to external system during receipt synchronization has finished
DONE_VOUCHER_JOB_POST Posting to external system during voucher synchronization has finished
17.1.4 Debug Events
Debug Events
Filter Key Description
DEBUG_OPEN_DBSESSIONS Quantity of open database sessions
DEBUG_LOG Debug log items
134 CUSTOMERSAP Customer Checkout Configuration Guide
Attachment
18 POS Software Certification According to NF 525 (France)
SAP Customer Checkout is certified as POS software in France according to the stipulations by NF 525. Certain features supplied by SAP Customer Checkout in the scope of NF 525 certification require SAP Customer Checkout manager.
NotePartners and OEM dealers who want to resell SAP Customer Checkout in France or one of the French overseas departments French Guiana, French Polynesia, or French Southern and Antarctic Lands must note the following for the development and use of plug-ins and user-defined print templates.
Changes to program components that are required for operation according to NF 525 in France can mean that SAP Customer Checkout no longer fulfills the requirements for the certification for NF 525.
If you use plug-ins or print templates to make changes to program components of SAP Customer Checkout required for certification for NF 525, partners and OEM dealers need to check whether renewed certification for NF 525 may be required, and if necessary, perform certification for NF 525 for SAP Customer Checkout with the French authorities again.
After successful certification, the partner or OEM dealer receives a separate certification number for SAP Customer Checkout. The certification number must be part of all receipts printed from SAP Customer Checkout. For more information about how to replace the certification number, see Replacing Certification Number Using a Plug-In [page 141].
NF 525 requirements can be grouped into five areas: Period-end closing, technical event log, archiving, signature, and grand total.
Period-End Close
NF 525 stipulates that POS software must perform period-end closings in accordance with certain specifications. SAP Customer Checkout is able to perform all specified period-end closings.
Technical Event Log
When operating POS software, certain technical events have to be logged. For SAP Customer Checkout and SAP Customer Checkout manager all relevant technical events are logged and saved in SAP Customer Checkout manager.
Archiving
Period-end closings have to be archived. In SAP Customer Checkout, period-end closings can be archived and downloaded separately.
Signature
NF 525 rules of certification stipulate that certain technical objects must be signed. The intention of object signatures is to make their origin traceable and to ensure that the objects have not been manipulated.
SAP Customer Checkout is able to sign all required technical objects.
SAP Customer Checkout Configuration GuidePOS Software Certification According to NF 525 (France) CUSTOMER 135
Grand Total
POS software has to record all transactions that modify revenues. Recording has to be by summation of revenue-related transactions. SAP Customer Checkout supports summation of revenue-related transactions as stipulated.
18.1 Technical Event Log
NF 525 rules of certification stipulate which technical events must be logged. SAP Customer Checkout transmits all relevant technical events to SAP Customer Checkout manager, where they are saved. For this reason, SAP Customer Checkout in France must always be used combination with SAP Customer Checkout manager.
NoteShould the connection with SAP Customer Checkout manager be temporarily unavailable, event logs are stored locally. Once the connection with SAP Customer Checkout manager has been restored, event logs created during the interruption are transmitted to SAP Customer Checkout manager.
The user interface for viewing the technical event log is available in SAP Customer Checkout manager only.
NoteWhen a period-end closing is archived, all relevant technical events from the period are added to the archive. SAP Customer Checkout manager requests all technical events via an interface and saves them as a file.
18.2 Archiving
The regulations according to NF 525 stipulate that period-end closings must be archived. The archives must contain other information besides each archived period-end closing.
SAP Customer Checkout supports the archiving of period-end closings including all of the required additional information.
In SAP Customer Checkout, archives can be downloaded as a ZIP file. The ZIP file contains the following files:
● Overview of the period-end closing and all receipts of the period-end closing (including the signature of the period end-closing)
● The related technical event log for the period-end closing period● A document containing information about the archived data and files● The archive signature
136 CUSTOMERSAP Customer Checkout Configuration Guide
POS Software Certification According to NF 525 (France)
18.3 Signature
NF 525 rules of certification stipulate that certain technical objects must be signed. SAP Customer Checkout supports the signature algorithm for France stipulated by NF 525. Signatures are concatenated, so that the previous object's signature is included in that of the following object.
You can specify the signature algorithm in the SAP Customer Checkout configuration.
Objects signed by SAP Customer Checkout:
Object Description
Document Signs all documents
Period-end closing Signs all types of period-end closings activated in SAP Customer Checkout configuration
Technical event Signs all relevant technical events
Archive Each archive contains a signature file
Reprinted document Signs every reprinted document
NoteThe POS system operator's VAT number, tax number (SIRET number), postal code, and company name are required for the signature. For this reason, these details need to be maintained in the SAP Customer Checkout configuration.
18.4 Configuring SAP Customer Checkout in Compliance with French NF 525 Regulations
Context
SAP Customer Checkout can be configured to meet the POS software requirements stipulated by NF 525 regulations for France. Certain features supplied by SAP Customer Checkout in the scope of NF 525 certification require SAP Customer Checkout manager. For this reason, SAP Customer Checkout has to be integrated with and permanently connected to SAP Customer Checkout manager.
NoteApart from the integration of SAP Customer Checkout manager, additional configuration steps are required in SAP Customer Checkout manager itself. Please perform the steps described in chapter POS Software Certification in Compliance with NF 525 (France) in the SAP Customer Checkout Manager Guide.
SAP Customer Checkout Configuration GuidePOS Software Certification According to NF 525 (France) CUSTOMER 137
Procedure
1. Log in to SAP Customer Checkout.2. Open the configuration and choose the POS System tab.3. Choose the Info subtab.
If you configure France or one of its overseas territories of French Guiana, French Polynesia, or French Southern and Antarctic Territories as a country/region in SAP Customer Checkout, some of the settings required for NF 525 certification are made automatically.
NoteIf the signature requires a key length other than 2048 bits, you have to select the required key length manually in the SAP Customer Checkout configuration before configuring the country/region. For further information on manual key length specification for the signature, please see Specifying Key Length for Signature Manually [page 139].
4. Select Edit and specify the country/region in which you want to deploy SAP Customer Checkout.5. Choose Save.
SAP Customer Checkout has made the settings required for NF 525 certification in the "Accounting", "Technical", and "Integration" tabs, as well as in the data privacy configuration. For further information on automatic settings, please see Overview: Automatic Settings for French Certification According to NF 525 [page 139].6. Choose the POS System tab again, and then the Info subtab.7. Choose Edit and enter the company name and postcode.8. Choose Save.9. Choose the Tax subtab.10. Choose Edit and enter the tax number (SIRET number) and VAT number.11. Choose Save.
Results
SAP Customer Checkout is now configured according to French NF 525 regulations.
NoteBefore each receipt posting, SAP Customer Checkout checks whether all configuration settings stipulated by NF 525 are active.
138 CUSTOMERSAP Customer Checkout Configuration Guide
POS Software Certification According to NF 525 (France)
18.4.1 Specifying Key Length for Signature Manually
Context
The key length can only be changed if the signature still remains deactivated.
Procedure
1. Log in to SAP Customer Checkout.2. Open the configuration and choose the Technical tab.3. Choose the Signature Settings subtab and then Edit.4. Activate the signature and select the signature type.5. Select the key length.6. Choose Save.
18.4.2 Overview: Automatic Settings for French Certification According to NF 525
If you configure France or one of its overseas territories of French Guiana, French Polynesia, or French Southern and Antarctic Territories as a country/region in SAP Customer Checkout, the following settings are made automatically.
Period-End Closing Settings in "Accounting" Tab
Setting Value
Enable period-end close On
Perform integrity check after annual period-end close On
Daily period-end close On
Monthly period-end close On
Annual period-end close On
Unlimited period-end close On
Grand Total per Receipt On
SAP Customer Checkout Configuration GuidePOS Software Certification According to NF 525 (France) CUSTOMER 139
Setting Value
Calculation basis Gross amount calculation
Calculation with absolute values Off
Signature Creation in "Technical" Tab
Setting Value
Signature On
Signature type RSA (France)
Key length 2048
Generate key Signature key was generated
Receipt Settings in "Hardware" Tab
Setting Value
Print software version On
SAP Customer Checkout manager Settings in "Integration" Tab
Setting Value
Severity (for central monitoring) Information
Configuration Settings in Data Security Area
Auditable Entities
Entity name POS configuration
Log original values Activated
NoteOnly users with the "Manage personal data protection" authorization are able to view and administrate the "Data Security" area.
18.4.3 Calculation Change for Period-End Closings with SAP Customer Checkout FP08 or Higher Version
When configuring SAP Customer Checkout according to the French regulations of NF 525, the option Calculation with Absolute Values has been activated automatically for period-end closings, up to and including SAP Customer Checkout FP07.
140 CUSTOMERSAP Customer Checkout Configuration Guide
POS Software Certification According to NF 525 (France)
After changes to NF 525 regulations by the French legislator, all future period-end closings are no longer to be calculated with absolute values. This change is made automatically when SAP Customer Checkout is updated to SAP Customer Checkout FP08 or a higher version.
This has the following effects:
● The option Calculation with Absolute Values is deactivated.● Period-end closing that is still ongoing is performed and completed using the old calculation method● All period-end closings will use the new calculation method when the next period starts.● Since, by definition, the Unlimited Period-End Close cannot have a next period, it is completed with the
update of the current Unlimited Period-End Close and a corresponding technical event is generated in monitoring. The end time of the period is set to the time of the update. A new unlimited period-end close is started, which uses the new calculation method.
18.5 Replacing Certification Number Using a Plug-In
If you have certified SAP Customer Checkout according to NF 525 requirements again after changes have been made, you need to replace the certification number delivered with SAP Customer Checkout.
To replace the certification number, implement a plug-in or modify an existing plug-in accordingly:
1. Implement the method startup() in the main class of the plug-in.2. Add the following line of code to the method startup() and transfer your certification number as an
argument.3. SignerHelper.INSTANCE.setUserDefinedCertificationNumber(<YOUR CERTIFICATE
NUMBER>);
Finally, copy the .jar file of the plug-in to the /cco/POSPlugins/AP subdirectory of the SAP Customer Checkout installation directory.
Your certification number replaces the previous certification number if the plug-in is used in SAP Customer Checkout.
SAP Customer Checkout Configuration GuidePOS Software Certification According to NF 525 (France) CUSTOMER 141
19 POS Security Regulation 2020 for Germany
Since December 2019 in Germany, §146a AO was introduced by the law for protecting against manipulations of digital basic records. As a consequence, as of 1/1/2020, when goods and services are sold, electronic POS systems (electronic recording systems) in Germany must have a certified technical safety device/entity.
§146a AO includes the following sections, with which all companies must comply:
● Receipt printing obligation: Each POS system must print out receipts.● Technical safety entity (TSE): Each POS system must be connected to a technical safety entity certified by
the BSI. This means that each receipt is signed to prevent manipulation in the POS system.● Digital Interface of Cash Management for POS Systems (DSFinV-K): A unified digital cash management
interface for POS systems (structured data export) is necessary, which allows you to export all receipt data in a specific format.
In addition, each POS system must be registered with the tax authorities as of 1/1/2020.
Compliance with POS Security Regulation 2020 requires various steps and settings in SAP Customer Checkout and SAP Customer Checkout manager:
● First, download the latest version of SAP Customer Checkout from SAP Service Marketplace.
NoteThe settings for POS Security Regulation 2020 are available as of SAP Customer Checkout 2.0 Feature Pack 09.
● Install and configure the TSE. For more information, see Installing and Configuring a Technical Safety Entity (TSE) [page 143]
● Integrate the TSE in the SAP Customer Checkout configuration on the Signature settings subtab. For more information, see Signature settings [page 62]
● Use of TSE in SAP Customer Checkout (for more information, see the SAP Customer Checkout User Guide).
● Data export from SAP Customer Checkout and SAP Customer Checkout manager for DSFinV-K interface. For more information, see Data Export for DSFinV-K Interface [page 145] and the SAP Customer Checkout manager Guide.
See the following link for a webinar with all relevant information: https://sapvideoa35699dc5.hana.ondemand.com/?entry_id=0_n8cfifot
142 CUSTOMERSAP Customer Checkout Configuration Guide
POS Security Regulation 2020 for Germany
19.1 Installing and Configuring a Technical Safety Entity (TSE)
POS Security Regulation 2020 stipulates that every POS system be connected to a technical safety entity/device (TSE) certified by the BSI. The TSE signs each receipt, thus preventing manipulation of the POS.
As of version 2.0 Feature Pack 09, SAP Customer Checkout supports TSEs by Diebold Nixdorf.
TSEs usually consist of the following two components:
● Signature settings unit: Required for signing the receipt data● Data storage/memory unit: Stores all data transferred to the TSE
Each POS is assigned to exactly one TSE. This means that a POS cannot communicate with two different TSEs.
In SAP Customer Checkout, all receipts and purchase orders must be signed by the TSE.
The signing process takes place in two steps: Start and Finish Transaction.
The signature result must be printed on the receipt.
The following steps are required for TSE installation and configuration:
● Obtain TSE hardware from Diebold Nixdorf (for more information, see Ordering TSE Hardware from Diebold Nixdorf [page 143])
● TSE installation (for more information, see Installing the TSE Hardware [page 144])
19.1.1 Ordering TSE Hardware from Diebold Nixdorf
You can obtain TSE hardware from Diebold Nixdorf via Jarltech: https://www.jarltech.com/2007/artikel.php?language=de&sort=kategorie&kat_id=2718&gotoartikel=diebold_nixdorf_tse
You will also need the Diebold Nixdorf TSE driver and Web service. This can be downloaded from Jarltech (under Drivers, Tools and Instructions) at the following link: https://www.jarltech.com/2007/support.php?gotoartikel=diebold_nixdorf_tse&sort=kategorie&language=de&kat_id=2718&link=2&supportdata=diebold_nixdorf_tse-de
NoteThe password for the ZIP file is 123.
For more information on Diebold Nixdorf, see https://www.dieboldnixdorf.com/de-de/retail/campaigns/fiscalization/usb-stick
You can also download TSE drivers and Web services from Diebold Nixdorf. For questions about Diebold Nixdorf, please contact: Kai Jungclaus ([email protected])
SAP Customer Checkout Configuration GuidePOS Security Regulation 2020 for Germany CUSTOMER 143
19.1.2 Installing the TSE Hardware
Once you have received the TSE hardware, TSE drivers, and the Diebold Nixdorf (DN) Web service, you can start the installation and configuration process.
1. First, install the DN Web service COM port by executing the DN_CDC_Virtual_COM_Port-XXXX-setup.exe file.
2. Follow the default instructions from Diebold Nixdorf.3. Next, execute the DN-TSE-Webservice-XXXX-setup.exe file.4. Follow the default instructions from Diebold Nixdorf.
NoteDefine a port (for example: 10001) as TCP/IP socket port. Please ensure that the port is not already in use by another program.
5. Check whether the Web service is accessible by entering the following URL in a Web browser: localhost:10001 (if you used 10001 as the port number).
6. Next, connect the TSE hardware with your POS.
NoteThe POS now communicates with the TSE.
To validate the communication, run the following command: GetDeviceStatus
7. In the Diebold Nixdorf installation directory, enter the export path to which the TSE stores and exports files.
NoteThis file is usually located in the Diebold Nixdorf installation directory under the following path: C:\Program Files (x86)\DieboldNixdorf\TSE-Webservice\bin\dn_main\mf_ge.properties
8. Open the file using Notepad++ and enter the installation directory under the export.tar.directory parameter.9. Save your changes as an administrator.
CautionWe recommend that you use a central network directory that performs regular backups. You are required to keep data for the tax authorities after exporting and deleting data from the TSE.
10. Restart the DN Web service using the Windows start menu, to apply the export path.
NoteThe DN Web service is executed automatically each time Windows is started.
11. Re-enter the following URL in a Web browser, to check whether the Web service is correctly connected: localhost:10001 (if you used 10001 as the port number).
NoteThe TSE status should now be Connected.
144 CUSTOMERSAP Customer Checkout Configuration Guide
POS Security Regulation 2020 for Germany
19.1.2.1 Resetting User Data for TSEs
If you entered the wrong password three times during TSE integration into SAP Customer Checkout, you need the PUK to reset the users.
Context
Please use the Diebold Nixdorf Web service for resetting TSE user data.
Procedure
1. On the Diebold Nixdorf Web service, confirm the SetDefaultClientID option.2. Enter the PUK.
The initial PUK usually is 000000. Alternatively, you can request the PUK from Diebold Nixdorf.
Admin user ID: 01; TimeAdmin user ID: 02. Please reset both passwords.3. Now enter the new password and choose Unlock User.
19.2 Data Export for DSFinV-K Interface
The DSFinV-K interface specifies a type of structured data export in a specific format (IDEA format). This format is a legal requirement for enabling uniform data processing by tax authorities.
The DSFinV-K interface is also used for improving data verifiability and archiving, and additional purposes (such as reporting or comparisons).
The DSFinV-K interface is linked with the TSE and uses TSE data. It is, however, an independent entity.
There are two data export options for the DSFinV-K interface:
● In SAP Customer Checkout (for more information, see Data Export for DSFinV-K Interface in SAP Customer Checkout [page 146])
● In SAP Customer Checkout manager (for more information, see the SAP Customer Checkout manager Guide.
SAP Customer Checkout Configuration GuidePOS Security Regulation 2020 for Germany CUSTOMER 145
19.2.1 Data Export for DSFinV-K Interface in SAP Customer Checkout
SAP Customer Checkout enables you to export data for the DSFinV-K interface.
In SAP Customer Checkout, the data export is linked to day-end closing. Before you export the DSFinV-K file, ensure that a day-end closing has occurred.
Once you have completed day-end closing, you can generate the DSFinV-K file.
● Choose the magnifying glass icon in the upper right corner of the screen.● Select the Day-end closing tab.● Select the respective closing and choose Generate DSFinV-K.● The file download starts.
NoteThe generated .zip file contains a total of 20 documents.
These include the following:
○ 10 files for the single recording module (for example, document header data, line item data, tax items)
○ 7 files for the master data module (at the time of day-end closing, the settings relevant for the DSFinV-K interface are also exported; for example, tax rates)
○ 3 files for cash desk closing module (summary): This includes aggregated data, such as sales volumes in cash, on credit card, etc.
○ TSE data (transactions_tse.csv)
146 CUSTOMERSAP Customer Checkout Configuration Guide
POS Security Regulation 2020 for Germany
Important Disclaimers and Legal Information
HyperlinksSome links are classified by an icon and/or a mouseover text. These links provide additional information.About the icons:
● Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your agreements with SAP) to this:
● The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.● SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.
● Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering a SAP-hosted Web site. By using such links, you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this information.
Videos Hosted on External PlatformsSome videos may point to third-party video hosting platforms. SAP cannot guarantee the future availability of videos stored on these platforms. Furthermore, any advertisements or other content hosted on these platforms (for example, suggested videos or by navigating to other videos hosted on the same site), are not within the control or responsibility of SAP.
Beta and Other Experimental FeaturesExperimental features are not part of the officially delivered scope that SAP guarantees for future releases. This means that experimental features may be changed by SAP at any time for any reason without notice. Experimental features are not for productive use. You may not demonstrate, test, examine, evaluate or otherwise use the experimental features in a live operating environment or with data that has not been sufficiently backed up.The purpose of experimental features is to get feedback early on, allowing customers and partners to influence the future product accordingly. By providing your feedback (e.g. in the SAP Community), you accept that intellectual property rights of the contributions or derivative works shall remain the exclusive property of SAP.
Example CodeAny software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of example code unless damages have been caused by SAP's gross negligence or willful misconduct.
Gender-Related LanguageWe try not to use gender-specific word forms and formulations. As appropriate for context and readability, SAP may use masculine word forms to refer to all genders.
SAP Customer Checkout Configuration GuideImportant Disclaimers and Legal Information CUSTOMER 147
www.sap.com/contactsap
© 2020 SAP SE or an SAP affiliate company. All rights reserved.
No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP SE or an SAP affiliate company. The information contained herein may be changed without prior notice.
Some software products marketed by SAP SE and its distributors contain proprietary software components of other software vendors. National product specifications may vary.
These materials are provided by SAP SE or an SAP affiliate company for informational purposes only, without representation or warranty of any kind, and SAP or its affiliated companies shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP or SAP affiliate company products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty.
SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE (or an SAP affiliate company) in Germany and other countries. All other product and service names mentioned are the trademarks of their respective companies.
Please see https://www.sap.com/about/legal/trademark.html for additional trademark information and notices.
THE BEST RUN