Status

  Approved

OwnerBIRSE-ext, Gary 
Stakeholders
Jira Request ID

ERP-407 - Getting issue details... STATUS

Jira Development ID

ERP-797 - Getting issue details... STATUS

High- Level Specification

ParameterValue
Application SystemSAP S4/HANA SyWay
Business Process Reference

06.10 Manage Inventory and Logistics

06.11 Manage Warehouse and Logistics

Functional Overview

This mobile app will allow barcodes to be decoded and will also provide an Data Capture option.

Barcode Decoding

Based on scanning a barcode, the application will show the raw content of the barcode, the barcode symbology and all the individual field content based on GS1 application identifiers.

Barcode decoding will be used for troubleshooting any barcodes that cannot be processed by the Logistics Mobility Solution.

Data Capture

The application will also provide a Data Capture option where multiple barcodes can be scanned to allow the barcode content to be stored on SAP in a custom table.

When the app is executed on a desktop, a reporting option will allow users to display the details of the scanned barcodes and transfer the results to a spreadsheet.

The Data Capture option will be useful to the business in a variety of scenarios including the capture of SSCC numbers for a specific selection of materials, for reporting or further processing on SAP on a desktop.

The application is to be named “Barcode Decoder”.

Scope and Objectives

Allows any barcode to be decoded and allows data capture of multiple barcodes.

Process Flow Diagram

Step

Description

Comment

1Scan a barcodeRaw data, symbology and field content of barcode is displayed.
2Use Data Capture option to scan multiple barcodes.Field content of all barcodes scanned is stored on SAP.
3Report captured dataField content of all barcodes scanned is shown and can be transferred to a spreadsheet.

Assumptions

None

Dependencies

None

Security, Integrity and Controls

None

Configuration Requirements

None

Language Requirements

This app will be available in all SyWay languages. 

See KDD055 - Multi-Language Support.

Special Requirements

None

Design Rationale

Functional Requirements

Initial Screen

The application will prompt for the user to scan a barcode.

A “Data Capture” button will allow the user to go to Data Capture mode where all scanned barcodes will be stored in a transaction list (Like other handheld apps) and finally saved and stored on SAP in a custom table.

A reporting option “Report Captured Data” will show only when the app is executed in desktop mode.


When a barcode is scanned, the barcode value will be decoded to derive all field content based on GS1 application identifiers.

See below for the GS1 application identifiers that need to be included in the decoding logic.

The application will display the raw content of the barcode, the symbology and all field values.


Data Capture

When the Data Capture option is selected, the screen will change to show that this mode is enabled. 

The user must enter a group name as this will later allow selection of the scanned information on the desktop. The group number can be any alphanumeric value and there is no validation on this field other than it being a mandatory field. 

The group name field will initially show the text “Enter a group name.”.

At the time of posting if no group name has been entered then show the error “Enter a group name.”.

Any barcode scanned will still be decoded with the existing decode logic but now scanned data will be stored in a scanned list like other handheld apps. In the scanned list the user will have the option to delete individual scans or all scans and to finally post the scanned data to SAP.

The scanned list will only show the SSCC number when present in the barcode or the entire barcode content when an SSCC is not present, but all decoded fields from the barcode scanned will be stored. 


Processing Data

At the time of saving the data captured, additional information will be determined based on the SAP database and then all scanned data and additional data will be added to a custom table in SAP.

Additional Data (IM and EWM)

Determine if the HU is an IM HU or an EWM HU and calculate the cumulated content. See ERP-1003.

Field

Description

User 

User posting the data capture

Date

Date of posting

Time

Time of posting

Device

Device ID used to perform data capture

Type

“HU-IM” or "HU-EWM" when the scanned ID is identified as an existing HU in SAP. Otherwise show “<Unknown>”

Symbology

The Symbology of the barcode. e.g. GS1 Data Matrix

Material

The material number for the HU. If the HU has more than one material then show the text “*MIX*”.

Batch

The batch number for the HU. If the HU has more than one batch then show the text “*MIX*”.


Additional Data IM HUs

Packaging Material

For HUs, the packaging material VEKP-VHILM

Higher-Level HU

For HUs, show the HU number of any parent HU (VEKP-UEVEL)

Highest-Level HU

For HUs, repeatedly read VEKP for each higher-level HU (VEKP-UEVEL) until the HU with no higher-level HU is found. Show the HU of this highest-level HU.

NB. For single level HUs, the higher and highest HU numbers will be the same.


Additional Data EWM HUs

Packaging Material

For EWM HUs, the packaging material /SCWM/HUHDR-PMAT_GUID

Higher-Level HU

For EWM HUs, show the HU number of any parent HU  - use class/method - /SCWM/CL_API_HANDLING_UNIT→READ_BY_HUIDENT , parameter ET_HUTREE to read higher level HU 

Highest-Level HU

For EWM HUs, use /SCWM/HUHDR-GUID_HU_TOP to get the highest level HU number or use class/method - /SCWM/CL_API_HANDLING_UNIT→READ_BY_HUIDENT , parameter ET_HUTREE to read highest level HU 

NB. For single level HUs, the higher and highest HU numbers will be the same as the HU itself.


Scanned data.


Each field of scanned data in a GS1 barcode, as identified in the existing GS1 Decoder logic, will be stored in a dedicated field in the custom table.


GS1 Fields

AI00 SSCC

AI240 Material

AI10 Batch

AI37 Count

AI11 Date of Manufacture (YYMMDD)

AI17 Expiry Date (YYMMDD)

AI422 Country of Origin


Data Capture Report

When the GS1 Decoder app is executed in desktop mode, a button will be available for “Data Capture Report”. This option will allow the user to report on the previously captured data based on a selection by Userid, date and group name.

The report results will list all fields in the custom table and provide the option to download to Excel.

Recommended UI Technology

This app will be developed using Neptune DXP Open Edition. The app will appear on the Neptune launchpad.

Application Screen

Wireframe or Mock-Up

See example screens in Functional Requirements section.

 Screen Behavior

See example screens in Functional Requirements section.

Screen Navigation

Standard navigation.

Data Integration


FieldTable-Field NameComments / Calculation / Field Manipulation / Input / Output / Validation rule / Value help
Barcode scannedCustom table

Barcode content will be decoded and stored in custom table.

Custom Tables

Data Capture table

FieldDescriptionData Type/LengthValidation rule / Value help 
GroupGroup NameCHAR 20
UsernameUser CHAR
DateDate of postingDATE
TimeTime of postingTIME
Device IDDevice of postingCHAR 

HU Type

Type of barcodeCHAR 10HU-IM or HU-EWM or Unknown

Symbology

Symbology of barcode scannedCHAR 20

HU

HU numberCHAR 18

Packaging Material

Packaging material of scanned HUCHAR 40

Plant

Plant of HUCHAR 4

Higher-Level HU

Higher-Level HU of scanned HUCHAR 18

Highest-Level HU

Highest-Level HU of scanned HUCHAR 18

Material

Material of scanned HUCHAR 40

Batch

Batch of scanned HUCHAR 10

AI00 SSCC

SSCC number on barcodeCHAR 18

AI240 Material

Material number on barcodeCHAR 40

AI10 Batch

Batch number on barcodeCHAR 10

AI37 Count

Count on barcodeCHAR 20
AI11 Production DateProduction date on barcodeDATE
AI17 Expiry DateExpiry Date on barcodeDATE
AI422 Country of OriginCountry of Origin on barcodeCHAR 3ISO 3166-1 numeric value for country. e.g. 250 for France

Master data

None

FieldDescriptionData Type/LengthValidation rule / Value help 




 Configuration table

None

FieldDescriptionData Type/LengthValidation rule / Value help 




Tooltips

None

Front-End

This app can be executed on a mobile device or in desktop mode.

Mobile Services

Not applicable.

Authentication & Authorization

None

Accessibility

Not applicable.

Volumetrics

The data capture option should support the scanning of hundreds of barcodes, as required.

Data captured will normally be used in the short term. Longer term it will be possible to purge records to reduce the table size. e.g. Records more than 10 years old.

Performance Consideration

Not applicable.

Error Handling

Errors to appear in a pop up window that needs to be acknowledged by the user.

Testing

How to Test

Test Conditions and Expected Results

IDConditionExpected Result
1Scan a GS1 Data Matrix label from Loftware.Barcode symbology and correct GS1 field content is shown.
2Scan an as-is QR code.Barcode symbology and content is correctly shown.
3Scan a barcode from a vendor labelBarcode symbology and content is correctly shown.
4Use the data capture option to scan several GS1 Data Matrix barcodesBarcodes are correctly captured and stored on SAP.
5Use the Data Capture report option to report the values scanned.Barcode details are correctly reported and can be opened in a spreadsheet format.

Test Considerations/Dependencies

None

Other Information

None

Development Details

Package

Package NameParent Package




UI Implementation

UI Type

UI Name

Fiori Catalogue

Design Rationale Reference





API Implementation

API TypeAPI NamePurpose / High Level LogicAPI ProductDesign Rationale Reference






Other Development Objects

Object TypeObject NamePurpose/High Level LogicDesign Rationale Reference








Appendix


See also

Change log

Version Published Changed By Comment
CURRENT (v. 13) Mar 12, 2026 12:40 BIRSE-ext, Gary
v. 12 Mar 12, 2026 12:34 BIRSE-ext, Gary
v. 11 Mar 12, 2026 12:33 BIRSE-ext, Gary
v. 10 Mar 12, 2026 12:20 BIRSE-ext, Gary
v. 9 Mar 12, 2026 11:36 BIRSE-ext, Gary
v. 8 Mar 12, 2026 11:17 PANDIT-ext, Sunil
v. 7 Mar 12, 2026 11:14 PANDIT-ext, Sunil
v. 6 Mar 11, 2026 17:02 BIRSE-ext, Gary
v. 5 Mar 11, 2026 13:23 BIRSE-ext, Gary
v. 4 Mar 11, 2026 13:22 BIRSE-ext, Gary

Go to Page History