IMPLEMENTATION GUIDE | PUBLIC
2020-05-21
© 2020 SAP SE or an SAP affiliate company. All rights reserved.
Look Up Retail Products
THE BEST RUN
Content
1
2
Implementation Details for Look Up Retail Products. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
PUBLIC
Look Up Retail Products
Content
1
Implementation Details for Look Up
Retail Products
To begin using all the features in the Look Up Retail Products app, you may need to perform some additional
configuration tasks according to your requirements. The following section provides details on required and
optional tasks you need to carry out after Look Up Retail Products is installed.
Optional Configuration Tasks
The following configuration tasks are optional and can be implemented according to your business needs.
Task step
Description
Set the ruling price condition
The ruling price condition is required to read the most current price for prod­
ucts from the back-end system. The default ruling price condition profile deliv­
ered by SAP is VKPF. You must ensure that this condition is active and assigned
to the store through the following Customizing activity:
●
Logistics - General
Store Operations
Inventory Management - UI5 Apps
In-Store Merchandise and
Define Basic Settings for UI5 Apps
If you do not see the VKPF condition type in the list, or if you would like to cre­
ate your own condition type, use the following Customizing activities to create
the required pricing rule condition type:
1.
Create the condition type.
Sales and Distribution
Basic Functions
Pricing
Pricing Control
Define Condition Types
2. Assign the VKPF condition type to the VKP001 pricing procedure.
Sales and Distribution
Basic Functions
Pricing
Pricing Control
Define and Assign Pricing Procedures
3. Use the Customizing activity described above to assign the ruling price
profile to the store.

Note
Once set, the ruling price is relevant for any of the UI5 apps and does not
need to be configured again for another one.
Look Up Retail Products
Implementation Details for Look Up Retail Products
PUBLIC
3
Task step
Description
Configure settings to retrieve product im­
You can choose to retrieve product images either by binary string or by URL ad­
ages
dress. Implement BADI_RTST_ARTICLE_IMAGE (BAdI: Definition of Product
Image Retrieval Format) to set the format you will use to retrieve product im­
ages. You can find the BAdI at the following location:
Logistics General
Store Operations
Management - UI5 Apps
In-Store Merchandise and Inventory
Business Add-Ins
Image retrieval by binary string
If you choose to retrieve product images by binary string but you do not imple­
ment BADI_RTST_ARTICLE_IMAGE, the DMS implementation of BAdI: Image
Retrieval for UI5 Apps (RETAIL_ST_SUPP_DATA_QUERY) will be used to re­
trieve product images by default.
Whether you accept or choose the default option, you can still change the de­
fault image retrieval provider (DMS) to another one of your choice. You do this
by implementing RETAIL_ST_SUPP_DATA_QUERY. Refer to the item below for
details about the settings you need to make.
Image retrieval by URL address
If you decide to use the retrieval by URL address option to retrieve product im­
ages, you must still implement BADI_RTST_ARTICLE_IMAGE to retrieve the
product images. If this BAdI is not implemented, the implementation of
BADI_ARTICLE_DATA_PROVIDER is used to retrieve the product images by
URL address.
4
PUBLIC
Look Up Retail Products
Implementation Details for Look Up Retail Products
Task step
Description
When you use the Document Management System (DMS) provided by SAP as
the product image provider, you must configure settings to enable product im­
age downloads in BAdI: DMS Configuration for Image Retrieval By UI5 Apps. You
can find the BAdI at the following location:
Logistics General
Store Operations
Management - UI5 Apps
In-Store Merchandise and Inventory
Business Add-Ins
Then do the following:
1.
Create a document for a desired image.
In DMS, execute transaction CV01N, and make the following settings:
○
Document Type = DRW
○
Document Part = 000
○
Document Version = -
Press Enter and make the Document Status = WR (Work Request).
2. Upload the desired image file and make the following settings:
○
WSAPPLICATION = THU
○
Defined storage category = DMS_C1_ST
3. Link the document to a related product number in the back-end system.

Note
Because the BAdIs for the configuration for product images can be shared
by all the UI5 store operations apps, if you define this BAdI once for one
app, it can be used by any other app without further customizing for that
app.
Provide information about nearby stores
Provide location information about nearby stores through GeoCoding. If you
still want to use transaction WSD_CBP you need to implement the BAdI
RETAIL_ST_PL_GET_NB_STORE_ENH.
Setup similar products (variants of ge­
Create variants of generic articles through transaction MM41. This transaction
neric articles)
relates products to other similar products.
Additional Configuration-Related Information
The following are additional details about the Look Up Retail Products app.
● In addition to activating the service node for the app, you must also activate the Retail Store Reuse Library
BSP service (RTST_REUSES1).
● When users access the app, the system checks whether they are assigned to a store. If they are not, a list
of stores is displayed. This list comes from authorization object W_SRS_APPL. Users can change their store
assignment anytime in the app through the Settings icon. The assigned store is persisted in table
FPB_PERSPARM.
Look Up Retail Products
Implementation Details for Look Up Retail Products
PUBLIC
5
● For incoming shipments, the purchase order is the only supported document type. You can set the validity
period for the document type through the Define Basic Settings for Look Up Retail Products Customizing
activity at the following location:
Logistics - General
Store Operations
In-Store Merchandise and Inventory Management - UI5 Apps
Look Up Retail Products
Provide the following values:
○ Customizing Schema - Identifies the group setting the user has set. You can define, multiple
customizing schema, for exmaple, groups of stores.
○ Description - Defines the name of the schema.
○ Is Standard - Sets a default schema.
○ Max. Prod. - Defines the maximum number of search results to return in a product search.
○ Ship. Rec. Days Ago - Shows the number days prior to the current day the shipment was recorded. For
example, if we are Wednesday and you enter 2 in the Ship. Rec. Days Ago field, you will see the received
shipments for Tuesday and Monday.
○ Ship. Exp. in Days - Shows the number days ahead of the current day the shipment is expected to
arrive. For example, if we are Wednesday and you enter 2 in the Ship. Exp. in Days field, you will see the
received shipments for Thursday and Friday.
○ Future Promo. Days - Defines the number of days during which there is a promotion from today and on.
For example, if today is Monday and you enter 1 in the Future Promo. Days field, you will see the
promotions on Tuesday.
○ Promo. History Days - Defines the history of promotions in number of days. For example, if today is
Monday and you enter 3 in the Promo. History Days field, you will see the history of promotions from
Sunday to Friday.
○ Future BonusBuys Days - Defines the number of upcoming bonus buys in days. For example, if today is
Monday and you enter 3 in the Future BonusBuys Days field, you will see the bonus buys from Tuesday
to Thursday.
○ BonusBuy Hist. Days - Defines the history of bonus buys in number of days. For example, if today is
Monday and you enter 3 in the BonusBuy Hist. Days field, you will see the history of promotions from
Sunday to Friday.
○ Map Enablement Flag - Displays a map of nearby stores that have the selected article.
○ Map Unit - Specifies the unit of measure for the map display.
○ Distance Filters - Defines a series of distances (radius). The distance is measured according the the
unit of measure selected in the Map Unit field. The first distance in the series is a default value. For
example, you can enter 10, 20, 50, 100 which will appear in a dropdown list that allows the user to
select a radius (10 will be the default value).
● To integrate with SAP Jam, each app user must have their own account in SAP Jam. They must also
register their SAP Jam account email address on the Gateway system. For more information, see https://
help.sap.com/viewer/p/SAP_JAM.
● You can use transaction SLG1 to check the application log in the back-end system. To do so, make the
following settings:
○ Object = W_SRS_MOB
○ Sub-object = MOBILE_PL
● To integrate with an SAP Customer Activity Repository system, the following is required:
○ In Customizing, set the RFC connection from the back-end system to the SAP Customer Activity
Repository system
Sales and Distribution
POS Interface
Inbound
SAP Customer Activity Repository Integration
Define Basic Settings for Integration with SAP Customer Activity Repository
6
PUBLIC
Look Up Retail Products
Implementation Details for Look Up Retail Products
 Note
This setting links the back-end system to the SAP Customer Activity Repository (CAR) system and
only needs to be set once for each back-end system. Once it is set, any of the UI5 apps can take
advantage of integration with SAP CAR without having to configure this setting again.
○ Activate integration with SAP CAR by implementing BAdI: Activate Integration with In-Store MIM UI5
App under
Sales and Distribution
Integration
Business Add-Ins
POS Interface
Inbound
SAP Customer Activity Repository
 Note
This activates integration with the SAP Customer Activity Repository (CAR) system and only needs
to be set once for each back-end system. Once it is set, any of the UI5 apps can take advantage of
integration with SAP CAR without having to implement the same BAdI again.
● Configure your hardware input devices. For information about how to configure your input devices, see .
General Details About the Look Up Retail Products App
The following are general details about the Look Up Retail Products app.
● The default setting for maximum for search results is 50. This is to optimize app performance. You can
change this value in the Basic Settings for Look Up Retail Products Customizing activity however allowing a
higher number of search results can impact the app performance.
Look Up Retail Products
Implementation Details for Look Up Retail Products
PUBLIC
7
Important Disclaimers and Legal Information
Hyperlinks
Some links are classified by an icon and/or a mouseover text. These links provide additional information.
About the icons:
●
●
Links with the icon
: You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your
agreements with SAP) to this:
●
The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.
●
SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.
Links with the icon
: You are leaving the documentation for that particular SAP product or service and are entering 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.
Beta and Other Experimental Features
Experimental features are not part of the officially delivered scope that SAP guarantees for future releases. This means that experimental features may be changed by
SAP at any time for any reason without notice. Experimental features are not for productive use. You may not demonstrate, test, examine, evaluate or otherwise use
the experimental features in a live operating environment or with data that has not been sufficiently backed up.
The purpose of experimental features is to get feedback early on, allowing customers and partners to influence the future product accordingly. By providing your
feedback (e.g. in the SAP Community), you accept that intellectual property rights of the contributions or derivative works shall remain the exclusive property of SAP.
Example Code
Any software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax
and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of
example code unless damages have been caused by SAP's gross negligence or willful misconduct.
Gender-Related Language
We 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.
Videos Hosted on External Platforms
Some videos may point to third-party video hosting platforms. SAP cannot guarantee the future availability of videos stored on these platforms. Furthermore, any
advertisements or other content hosted on these platforms (for example, suggested videos or by navigating to other videos hosted on the same site), are not within
the control or responsibility of SAP.
8
PUBLIC
Look Up Retail Products
Important Disclaimers and Legal Information
Look Up Retail Products
Important Disclaimers and Legal Information
PUBLIC
9
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