Show TOC

App Implementation: Adjust StockLocate this document in the navigation structure

System Landscape Requirements

In order to be able to implement this app, your system landscape has to be enabled for SAP Fiori. Depending on the database type serving as the basis in your system landscape, it has to be set up for SAP Fiori and has to meet the respective prerequisites:

Database SAP Fiori System Landscape Setup Prerequisites

ABAP environment

Setup of SAP Fiori System Landscape for SAP Business Suite with ABAP Environment

Installation Requirements (Transactional Apps)

HANA database

Setup of SAP Fiori System Landscape for SAP Business Suite with SAP HANA Database

Installation Requirements (Fact Sheets)

The SAP product version in the back-end system serving as the the basis for the app must be the following:

Required Back-End Product (Product Version Stack)
  • EHP4 FOR SAP ERP 6.0 - SPS 05 (11/2009)
  • EHP4 FOR SAP ERP 6.0 / NW7.01 - SPS 05 (11/2009)
  • EHP5 FOR SAP ERP 6.0 - SPS 08 (05/2012)
  • EHP6 FOR SAP ERP 6.0 - SPS 04 (08/2012)
Each SAP Fiori app consists of front-end components and back-end components:

  • The front-end components of the app consist of the user interfaces and content required for launching the app on the SAP Fiori launchpad. These components have to be installed on your front-end server.

  • The back-end components of the app mainly consist of the OData services required for the app. These components have to be installed in your back-end system.

The front-end and back-end components of the app are delivered with the following SAP product versions as part of the listed software components. The required software components for the app are contained in the listed product instances:

App Component

Required SAP Product Version (Support Package Stack)

Available Instances Containing Software Component

Software Component Required for App (Support Package)

Front-End Components

 SAP Fiori transactional apps 1.0 for SAP ERP ( 05 (07/2015) )
  • Retail UI ERP 6.04 NW740
  • Retail UI ERP 6.04 NW731

UIX02RT4 100 (0002 )

Back-End Components

SAP Fiori transactional apps 1.0 for SAP ERP (05 (07/2015))

Retail INT ERP 6.04

GBX02RT4 604 (0002 )

For more information about the installation of front-end components, see http://help.sap.com/fiori_implementation.

The app offers the possibility to upload documents. For security reasons, we strongly recommend that you install an appropriate virus scanner in your respective back-end system and define sufficiently restrictive scan profiles to prevent the upload of malicious content. For more information about virus scanning and scan profiles for SAP Fiori apps, see Virus Scanning.

Required SAP Notes

On the back-end server, the following SAP notes must be implemented for this app:

SAP Note Number

Description

1991734 Information published on SAP site

FIORI Retail Store Stock Adjust: Change History

On the front-end server, the following SAP notes must be implemented for this app:

SAP Note Number

Description

1991734 Information published on SAP site

FIORI Retail Store Stock Adjust: Change History

Implementation Tasks

The following sections list tasks that have to be performed to implement the required components of the app. The tables contain the app-specific data required for these tasks.

You can find the data required to perform these tasks in the SAP Fiori apps reference library at:

https://fioriappslibrary.hana.ondemand.com/sap/fix/externalViewer/index.html?appId=F0586

Front-End Server : Activate OData Services

Component

Technical Name

OData Service (Version Number)

RETAILSTORE_STOCK_CORR_SRV (001 )

For more information about how to activate the OData service, see Front-End Server: Activate OData Services .

Front-End Server: Activate SAP UI5 Application

Component

Technical Name

SAP UI5 Application

 RT_STOCK_COR

For more information about how to activate the SAP UI5 application (ICF service), see Front-End Server: Activate ICF Services.

Enable App for Access in SAP Fiori Launchpad

To define the access of single users to this app in the SAP Fiori launchpad, technical content is delivered, such as catalogs and example roles.

You can find an overview of the delivered technical content for this SAP Fiori app in the SAP Fiori apps reference library.

For more information about how to procede with this content, see Enable App for Access in SAP Fiori Launchpad.

Front-End Server and Back-End Server: Assign OData Service Authorizations to Users

You must assign OData service authorizations for the app to your users.

Note

Several authorization default values are connected to the OData service. To ensure that all these default values are assigned to a user, you have to follow the instructions given under the documentation links provided.

Make the assignment on the back-end server and on the front-end server :

  • On the back-end server, a dedicated authorization role (PFCG role) for the OData service is delivered as an example. You can copy this role and adjust it to your needs.

  • On the front-end server , you must assign the OData service authorization to a new or existing role, such as a business role that has been adjusted according to your needs.

OData Service (Version Number)

Back-End Server: Delivered Authorization Role (PFCG Role)

Front-End Server : Assignment to Authorization Role

RETAILSTORE_STOCK_CORR_SRV (001 )

In addition, this role contains authorizations to display the related business data.

  • SAP_STORE_STOCK_COR_APP

Note

In addition, this role contains authorizations to display the related business data.

OData service authorization must be assigned.
Prerequisites for Implementation

Before implementing the app, you must ensure the following:

  • Software component EA-RETAIL 604 is installed with the latest SP on the back-end server

  • SAP Enterprise Search is deployed and TREX-based models are imported

  • Software component UIX02RT4 SP 02 is installed on the front-end server

  • Business function Retail, In-Store Merchandise and Inventory Management is configured, and master data is prepared

Configuration Tasks

To be able to implement the app, you must perform the following configuration tasks in the back-end system:

Required Configuration Tasks

The following configuration tasks are required to enable the Adjust Stock app.

Set the retail store ruling price condition

Sales prices are retrieved from the SAP ERP back-end system in the following order of priority:

  • VKPF - Retail store ruling price (Highest priority)

  • VKAO - Promotion price condition (High priority)

  • VKPO - Normal sales price condition (Lowest priority)

In the Adjust Stock app, the Retail store ruling price condition VKPF is required to read the most current price for products from the back-end system. You must configure this condition as follows:

  1. Add the VKPF condition type to the list of condition types.

    Start of the navigation path Sales and Distribution Next navigation step Basic Functions Next navigation step Pricing Next navigation step Pricing Control Next navigation step Define Condition Types End of the navigation path

  2. Assign the VKPF condition type to the VKP001 procedure.

    Start of the navigation path Sales and Distribution Next navigation step Basic Functions Next navigation step Pricing Next navigation step Pricing Control Next navigation step Define and Assign Pricing Procedures End of the navigation path

  3. Assign the VKPF condition type to the ruling price.

    Start of the navigation path Logistics General Next navigation step SAP Retail Store Next navigation step Sales Prices Next navigation step Basic Settings for Sales Prices End of the navigation path .

Configure settings to enable TREX-based SAP Enterprise Search

Ensure that the MATERIAL model is available.

Define a business process for product shrinkage

In the Customizing activity for SAP Retail Store under Start of the navigation path Goods Movement Next navigation step Grouping of Business Transactions for Other Goods Movements End of the navigation path, define a business transaction with key 0002 for product shrinkage and assign this business transaction to the store.

Optional Configuration Tasks

The following configuration tasks are optional and can be implemented according to your business needs.

Configure settings to download product images

If you are using the Document Management System (DMS) provided by SAP as the product image provider, configure the required settings to enable product image downloads as follows:

  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.

    Defined storage category = DMS_C1_ST

  3. Link the document to a related product number in SAP ERP.

For more information, see http://help.sap.com/businesssuite Start of the navigation path SAP Product Lifecycle Management Next navigation step SAP PLM as part of SAP ERP Central Component Next navigation step Application Help Next navigation step Document Management End of the navigation path .

If you are not using DMS as the product image provider, provide a BAdI implementation to specify your product image provider.

Configure settings to retrieve supplemental product data

You can use Business Add-ins (BAdIs) to retrieve supplemental product data such as warranty or other relevant information for the product. You find these in Customizing for SAP Retail Store under Start of the navigation path In-Store Merchandise and Inventory Management - UI5 Apps Next navigation step Look Up Retail Products End of the navigation path.

Note

The Adjust Stock and Look Up Retail Products apps share the defined BAdIs for supplemental data. If you already defined this BAdI for one app (for example, for Look Up Retail Products), you do not need to define it again for use in the Adjust Stock app.

For more information, see App Extensibility: Adjust Stock

Additional Configuration-Related Information

The following are additional configuration-related details about the Adjust Stock app.

  • When users access the Adjust Stock app, the system checks whether they are assigned to a store. If they are not assigned to a store, a list of stores is displayed. This list comes from authorization object W_SRS_APPL. Users can change their store assignment anytime by choosing the Settings icon. The assigned store is persisted in table FPB_PERSPARM, which the Adjust Stock app reuses from the SAP In-Store Merchandise and Inventory Management application (Retail In-Store MIM).

  • To integrate with SAP Jam, each user of the Adjust Stock app must have their own account in SAP Jam. They must also register their SAP Jam account email address on the SAP Gateway system. For more information, see http://help.sap.com/sapjam.

  • You can use transaction SLG1 in the back-end SAP ERP Retail system to check the application log. To do so, make the following settings:

    • Object = W_SRS_MOB

    • Sub-object = MOBILE_SC

General Details About the Product List in the Adjust Stock App

The following section describes specific details about the product list.

  • You add products to the list by pressing the '+' icon and then entering text into the Search field. You can add a single or multiple products to the list this way.

  • You delete products from the list by pressing the checklist icon at the top of the page. You can delete a single or multiple products from the list this way.

  • The Open section contains a list of products for which a count or an adjustment was started, but no data was submitted to the SAP ERP backend.

  • The Completed section contains a list of products that have been counted or adjusted and submitted to the SAP ERP backend.

  • You can control the recency of products displayed in the product list by defining a validity period in the Define Basic Settings for Stock Adjustment Customizing activity under Start of the navigation path SAP Retail Store Next navigation step In-Store Merchandise and Inventory Management - UI5 Apps Next navigation step Adjust Stock End of the navigation path. This ensures that only products in the defined validity period are displayed in the product list.

  • You can predefine a product list for a user by importing records into table ARTICLE_SC_HEAD or, by writing a report. The business key of the product list consists of the store ID, the user ID, and the product number.

  • You can remove products that no longer fall within the defined validity period from the product list by using the RETAIL_ST_SC_CLEANUP_STAGE_TAB function. You can create a report and schedule it in a background job to execute this task. You can set the cleanup frequency according to your business needs, however you should consider that the longer your validity period, the more records will accumulate in the table and if you schedule the cleanup to run less frequently this will impact the performance of the Adjust Stock app.

General Details About the Counting Feature in the Adjust Stock App

The following section describe specific details about the counting feature.

  • The counting function is product-based. Users enter counts for one product at a time and submit the counts per product.

  • Any product that already has an existing counting document cannot be selected for counting again or to receive a stock adjustment, regardless of its storage location.

  • The stock quantity displayed for a product comes from SAP ERP for Retail and includes the counted or adjusted values applied by the Adjust Stock app.

  • If the user changes the storage location or stock type for a product, the old values will not be retained. Any product counts or adjustments are applied to the new storage location or stock type.

  • Document numbers generated after users submit a product count or adjustment to the back-end system are not visible on the UI. If required, you must get it from the back-end ERP system.

  • Counts are saved under the product location, for example a specific shelf. Users can create as many locations as they want by choosing the Add Product Location button.

General Details About the Adjustment Feature in the Adjust Stock App

The following section describes specific details about the stock adjustment feature.

  • Adjustments are product-based. Users can enter an adjustment quantity for one product at a time and submit the adjustment per product.

  • Currently only the stock adjustment related to shrinkage, known as business transaction 0002, is supported in the Adjust Stock app. You must customize the movement type as described in the Configuration Tasks section.

  • Document numbers generated after users submit a product count or adjustment to the back-end system are not visible on the UI. If required, you must get it from the back-end ERP system.

More Information

For more information about app implementation, see http://help.sap.com/fiori_implementation Start of the navigation path App Implementation Information for SAP Fiori End of the navigation path.