You can enable SAP POS to access the SAP Retail Store Sales Order application
through a browser window launched in SAP POS. This allows cashiers to perform order-related activities such as creating, searching, displaying, changing, verifying, cancelling, fulfilling
or returning items.
You can enable the Sales Order Processing capability by creating a browser definition using the instructions provided in POS Browser Maintenance. In the Sales Order Processing
section
of the POS Browser Maintenance
screen, choose Enable
. This allows SAP POS to open the specified browser window and start SAP Retail Store via a URL.
Note
When the Sales Order Processing
option is enabled, SAP POS adds additional parameters required by COM UI
(such as store number, dialogue mode entry screen or material search, document number and POS type) to the specified URL and
then starts SAP Retail Store.
SAP Retail Store COM UI
URL consists of static and non-static elements. The static elements are fixed and do not change. The non-static elements are dynamically created by SAP POS at the time of the transaction.
Example
The following is an example of the SAP Retail Store URL:
https://us4298.wdf.sap.corp:44398/sap/bc/gui/sap/its/ z_wssa_entry?sap-client=410&~store_no=R310&~pos_type=01&~dialogue_mode=01 &~DOC_NUMBER=0000004711
In this example, the http://us4298.wdf.sap.corp:44398/sap/bc/gui/sap/its/ z_wssa_entry?sap-client=410 part is static. This is specified in the URL field
in POS Browser Maintenance
configuration screen in the
SAP POS Configurator application.
The ~store_no=R310&~pos_type=01&~dialogue_mode=01&~DOC_NUMBER=0000004711 is the non-static, or dynamic excerpt. This is the part of the URL that is dynamically created by the POS because certain parameters such as ~dialogue_mode and ~DOC_NUMBER are only known at the time of the transaction.
The following table shows the SAP Retail Store URL and parameters.
Parameter |
Type |
Possible Values |
---|---|---|
|
Specifies the server and port |
|
|
Type of deployment path for the Internet Service on that server |
|
|
Service alias for the Internet Communication Framework (ICF) |
|
|
Client numbers |
|
|
Store number |
|
|
2-digit character |
01=SAP POS 02=SAP Enterprise POS |
|
2-digit character |
01=Entry screen 02=Product Look Up |
|
10-digit character with leading zeros if numeric |
SAP Retail Store COM UI can be launched from SAP POS in two ways:
Through a menu button on SAP POS mapped to a manager code that launches the browser
Through the Item Entry Control
(IEC) functionality that uses an entered value (such as a document number) to trigger a manager code that launches the browser
Note
When Sales Order Processing is enabled and SAP POS accesses the SAP Retail Store COM UI, it extracts HTML from the displayed page that contains the document header. The document header contains the document number, document category, amount, and currency code. This document provides information about the retail order. These fields are presented in a fixed length record which is identified by a predefined text and is embedded as a comment within the HTML on the page.
Example
The text POS_RETURN_DOC_
identifies the start of the document header. The fixed length record is similar to POS_RETURN_DOC_000000471101+00000002535400EUR
.
The following table describes the fields extracted by SAP POS from the fixed length record containing the document header.
Parameter |
Type |
Possible Values |
---|---|---|
|
10-digit character |
Example: 0000004711 |
|
2-digit character |
01=Sales Order 11=Invoice 12=Credit Memo xx=any value other than 01, 11, and 12 A |
|
1-digit character |
+ = Positive amount - = Negative amount |
|
14-digit character, the last four are decimals, no decimal point |
Example: 00000002535400 (= 253,54) |
|
3-digit character |
Example: EUR |
Once access to the Customer Order
functionality within SAP Retail Store has been attained, the POS cashier can navigate within the sales order to perform any of the following functions:
Create an order
Search for an order
Display an order
Change an order
Identify an order
Verify an order
Cancel an order
Fulfill an order
Return an order
They can also create, search, and change customer information.
To leave the Sales Order
application, cashiers can choose the Done
button on the SAP POS screen. When they do this, SAP POS scans the current HTML page for a document number (order number) and switches back to the SAP POS screen
when the document number (order number) is found. The order details (order number and payment amount) are displayed on the screen and the payment amount can be finalized by the customer and included in the current sales transaction as a non-merchandise item. (The non-merchandise amount includes any taxes
generated by the order within the amount.) This process can be repeated for multiple documents for either sales orders, billing documents, or credit memos.