Goods receipt for unpacked items

PB2_GR_EXT

The Goods Receipt app is used to process a number of different documents. The configuration elements used for the different documents all use the same naming standard and use an abbreviation identifying the document being processed:

• INB - unpacked inbound delivery

• OBD - outbound delivery (for a stock transport order)

• PO - purchase order

• SA - scheduling agreement

• RTN - customer return

In the tables below, *** should be replaced with the abbreviation. Screenshots from one type of document will be shown as an example.

Selection options

Configuration element	Available structures/fields
SELECT_OPTS	Generic fields: DOC_NUMBER - this field works for inbound delivery number, purchase order number, external identification number of delivery (LIFEX), (or for automotive customers, the inbound delivery group (BORGR_GRP)) VENDOR - Vendor number MATERIAL - SAP material number (finds the matching deliveries and then displays all the items on those deliveries) PLANT or WERKS - Plants STORE_LOC or LGORT - Storage locations LFDAT or LFDAT_RANGE - Delivery date range Additional selection fields are possible, and also in some cases required, based on the particular document types being selected. See the notes below for more information on what is possible and/or required for each document type.
SELECT_OPTS_ACTIONS	BACK - back to previous screen. CLEAR_INPUT -clear all input fields. VAR_CHOOSE – select saved variants. VAR_SAVE – save the selection entries as a variant. SELECT – proceed to next screen.

Note

The selection screen uses some common fields which are used for all the different document type selections as well as some fields that can be defined exclusively for a particular document type using the prefix assigned for that document type.

The following are the list of fields available for each document type.

INB - Unpacked inbound deliveries

The following fields are only used for inbound deliveries (and from release 5.8.0 can be prefixed with "INB_" if required):

• KOSTK - Overall putaway status (default value of "BLANK,A,B,C")

• PKSTK - Packing status (default value of "BLANK")

• LVSTK - WM overall TO status (default values of "BLANK,C")

• WBSTK - Goods receipt status (optional, default values of "A,B" are set in code for INB unless overwritten from the selection screen)

• KOQUK - Pick confirmation status (optional, default values of "BLANK,C" set in code for INB unless overwritten from the selection screen)

Additional fields available for inbound deliveries can be added to the AMD (and from release 5.8.0 can also be prefixed with "INB_" if you want to use them exclusively for INB selection):

• DELIVERY or VBELN or INBOUND - Inbound delivery number

• EXTERNAL_ID or LIFEX - External identification number of delivery

• PO_NUMBER or EBELN - PO number

• SHIPMENT or TKNUM - Shipment number

• TRSTA - Transport planning status

• CREATED_BY or ERNAM - Created by userid

• CREATED_ON or ERDAT or ERDAT_RANGE - Created on date

• SHIPPING_POINT or VSTEL - Shipping/Receiving point

• REFERENCE or XBLNR - Reference

RTN - Return deliveries

The following fields are only used for return deliveries and are therefore prefixed with "RTN_":

• RTN_KOSTK - Overall putaway status (default value of "BLANK,A,B,C")

• RTN_PKSTK - Packing status (default value of "BLANK")

• RTN_WBSTK - Goods receipt status (default value of "A")

• RTN_LVSTK - WM overall TO status (default values of "BLANK,A")

Additional fields available for return deliveries can be added to the AMD and can also be prefixed with "RTN_" if you want to use them exclusively for RTN selection:

• DELIVERY or VBELN - return delivery number

• DEL_GROUP or SAMMG - delivery group number

• SHIPMENT or TKNUM - Shipment number

• ROUTE - route

• KUNNR or CUSTOMER or KUNWE or SHIP_TO - Ship-to number

• KUNAG or SOLD_TO - Sold-to number

• PICKING_DATE or KODAT or KODAT_RANGE - Picking date

• WADAT or GI_DATE - Planned goods issue date

• LOADING_DATE or LDDAT or LDDAT_RANGE - Loading date

• TP_DATE or TDDAT or TDDAT_RANGE - Transport planning date

• DELIVERY_TYPE or LFART - Delivery type

• TRSTA - Transport planning status

• CREATED_BY or ERNAM - Created by SAP userid

• CREATED_ON or ERDAT or ERDAT_RANGE - Created on date

• SHIPPING_POINT or VSTEL - Shipping/Receiving point

• SALES_ORG or VKORG - Sales organisation

• DIST_CHANNEL or VTWEG - Distribution channel

• DIVISION or SPART - Division

• DOOR or LGTOR - Door

• UNLOADING_POINT or ABLAD - Unloading point

• PRIORITY or LPRIO - Priority

• FKSTK - Billing status

• BESTK - Confirmation status

• TRSTA - Transportation planning status

• REFERENCE or XBLNR - Reference

OBD - Outbound deliveries (for stock transport orders)

This uses slightly different logic from the inbound and return deliveries. All fields in structures EKKO, EKPO and EKET can be used, in addition to the standard fields supplied, to select the transport orders that have outbound deliveries. The app does not use the values in LIKP or LIPS to select deliveries. From release 5.8.0 the prefix "OBD_" can be used to make fields exclusive to the OBD selection.

PO - Purchase orders

All fields in structures EKKO, EKPO and EKET can be used, in addition to the standard fields supplied, to select purchase orders. The prefix "PO_" can be used to make fields exclusive to the PO selection.

In addition the following fields are defaulted in code unless overwritten from the selection screen:

• EREKZ - Final invoice indicator (optional, default in code for PO items to exclude those with final indicator but only if a value in the AMD config element "USE_FINAL_INV_EREKZ" is set)

• ELIKZ - Delivery completed indicator (optional, default in code for PO items to exclude those completed)

• LOEKZ - Deletion indicator in purchasing item (optional, default in code to only select items with no deletion indicator)

SA - Scheduling agreement

The same logic as for PO - Purchase orders. The prefix "SA_" can be used to make fields exclusive to the SA selection.

Note

Specific document types can be excluded from selection in several ways:

• Remove the "Doc Type" from the list in DOCUMENT_TYPE.

• In the SELECT_OPTS, add and mark with a checkbox "X" the field ***_EXCL where *** is the appropriate "Doc Type". This can be hidden in AMD or displayed to allow user selection.

Document type list

Configuration element	Available structures/fields
LIST_DOCTYPE	DOC_TYPE - code for the document type to be used in the configuration sets. DOC_TYPE_DESC - description of the document types. DOC_COUNT - number of documents selected for each document type.
LIST_DOCTYPE_ACTIONS	BACK - back to previous screen.
LIST_DOCTYPE_HEADER	TOTAL_DOC_COUNT - total document count for all included document types.
LIST_DOCTYPE_HEADER_EX	n/a
LIST_DOCTYPE_SORT	n/a - document types are displayed in the order given in DOCUMENT_TYPE.

Document list

Inbound deliveries

Outbound deliveries

Scheduling agreements

Purchase orders

Customer returns

Configuration element	Available structures/fields
LIST_INB	Primary: /TCTM/LIKP_S (LIKP) Secondary: /TCTM/VBUK_S (VBUK) Additional fields: VEND_NAME - name of vendor
LIST_OBD	Primary: /TCTM/BAPIEKKOL (HEADER) Secondary: /TCTM/LIKP_S (LIKP), /TCTM/VBUK_S (VBUK) Additional fields: PLANT_NAME - name of supplying plant
LIST_PO	Primary: /TCTM/BAPIEKKOL (HEADER) Secondary: n/a Additional fields: VEND_NAME - name of vendor PLANT_NAME - name of supplying plant
LIST_SA	Primary: /TCTM/BAPIMEOUTHEADER_S (HEADER) Secondary: n/a Additional fields: VEND_NAME - name of vendor
LIST_RTN	Primary: /TCTM/LIKP_S (LIKP) Secondary: /TCTM/VBUK_S (VBUK) Additional fields: KUNNR_NAME - name of ship-to
LIST_***_ACTIONS	BACK - back to previous screen.
LIST_***_HEADER	See structures for each document type above.
LIST_***_HEADER_EX	n/a
LIST_***_SORT	See primary structure for each document type above.

Document input

Configuration element	Available structures
INPUT_INB_HEADER	Primary: /TCTM/LIKP_S (LIKP) Secondary: /TCTM/VBUK_S (VBUK)
INPUT_OBD_HEADER	Primary: /TCTM/LIKP_S (LIKP) Secondary: /TCTM/VBUK_S (VBUK)
INPUT_PO_HEADER	Primary: /TCTM/BAPIEKKOL (HEADER) Secondary: n/a
INPUT_SA_HEADER	Primary: /TCTM/BAPIMEOUTHEADER_S (HEADER) Secondary: n/a
INPUT_RTN_HEADER	Primary: /TCTM/LIKP_S (LIKP) Secondary: /TCTM/VBUK_S (VBUK)
INPUT_***_HEADER_ACTIONS	BACK - back to previous screen. SAVE - update the delivery header and continue to items. CLEAR_INPUT - clear all input fields. TEXT_VIEWER_HDR - jumps to text view app if configured (class /TCTM/WM_APP_604_ACTIONS). DOCUMENT_CAPTURE - jumps to document capture app if configured.
SUPPRESS_***_HEADER	Allows this screen to be supressed / by-passed. If toggle = ON, this screen is supressed. If toggle = OFF, this screen is not suppressed.

Document item list

Configuration element	Available structures
LIST_INB_ITEM	Primary: /TCTM/LIPS_S (LIPS) Secondary: /TCTM/LIKP_S (LIKP), /TCTM/VBUP_S (VBUP), /TCTM/MAKT (MAKT), /TCTM/MARA (MARA), /TCTM/MARC (MARC), /TCTM/MARD (MARD), /TCTM/MLGN (MLGN), /TCTM/BAPIEKKOL (PO), /TCTM/BAPIEKPOC (PO_ITEM), WUEB (WUEB) Additional fields: RECEIPT_QTY - Quantity open at start of transaction (field class /TCTM/WM_APP_500_FIELDS_INB) OPEN_QTY - Running total of remaining quantity to be receipted (field class /TCTM/WM_APP_500_FIELDS_INB) BASKET_QTY - Quantity in the basket (field class /TCTM/WM_APP_500_FIELDS_INB)
LIST_OBD_ITEM	Primary: /TCTM/LIPS_S (LIPS) Secondary: /TCTM/LIKP_S (LIKP), /TCTM/MAKT (MAKT), /TCTM/MARA (MARA), /TCTM/MARC (MARC), /TCTM/MARD (MARD), /TCTM/MLGN (MLGN), /TCTM/BAPIEKKOL (PO), /TCTM/BAPIEKPOC (PO_ITEM), WUEB (WUEB) Additional fields: OPEN_QTY - Running total of remaining quantity to be receipted (field class /TCTM/WM_APP_500_FIELDS_OBD) BASKET_QTY - Quantity in the basket (field class /TCTM/WM_APP_500_FIELDS_OBD)
LIST_PO_ITEM	Primary: /TCTM/BAPIEKPOC (ITEM) Secondary: EKKO (EKKO), EKPO (EKPO), /TCTM/BAPIEKKOL (HEADER), /TCTM/MAKT (MAKT), /TCTM/MARA (MARA), /TCTM/MARC (MARC), /TCTM/MARD (MARD), /TCTM/MLGN (MLGN) Additional fields: DISP_QTY - Quantity open at start of transaction OPEN_QTY - Running total of remaining quantity to be receipted (field class /TCTM/WM_APP_500_FIELDS_PO) BASKET_QTY - Quantity in the basket (field class /TCTM/WM_APP_500_FIELDS_PO)
LIST_SA_ITEM	Primary: /TCTM/BAPIMEOUTITEM_S (ITEM) Secondary: EKKO (EKKO), EKPO (EKPO), /TCTM/BAPIMEOUTHEADER_S (HEADER), /TCTM/MAKT (MAKT), /TCTM/MARA (MARA), /TCTM/MARC (MARC), /TCTM/MARD (MARD), /TCTM/MLGN (MLGN) Additional fields: DISP_QTY - Quantity open at start of transaction OPEN_QTY - Running total of remaining quantity to be receipted (field class /TCTM/WM_APP_500_FIELDS_SA) BASKET_QTY - Quantity in the basket (field class /TCTM/WM_APP_500_FIELDS_SA)
LIST_RTN_ITEM	Primary: /TCTM/LIPS_S (LIPS) Secondary: /TCTM/LIKP_S (LIKP), /TCTM/MAKT (MAKT), /TCTM/MARA (MARA), /TCTM/MARC (MARC), /TCTM/MARD (MARD), /TCTM/MLGN (MLGN) Additional fields: STATUS_A - processing status (field class /TCTM/WM_APP_500_FIELDS_RTN) STATUS_B - processing status (field class /TCTM/WM_APP_500_FIELDS_RTN) STATUS_C - processing status (field class /TCTM/WM_APP_500_FIELDS_RTN) STATUS_Z - processing status (field class /TCTM/WM_APP_500_FIELDS_RTN) BASKET_QTY - Quantity in the basket (field class /TCTM/WM_APP_500_FIELDS_RTN)
LIST_***_ITEM_ACTIONS	BACK - back to previous screen. VIEW_BASKET - view basket.
LIST_INB_ITEM_ACTIONS	BACK - back to previous screen. VIEW_BASKET - view basket. POST_GR - Receipt all (class /TCTM/WM_APP_500_ACTIONS_INB).
LIST_RTN_ITEM_ACTIONS	BACK - back to previous screen. VIEW_BASKET - view basket. TEXT_VIEWER_HDR - view header text (class /TCTM/WM_APP_604_ACTIONS).
LIST_***_ITEM_HEADER	See structures for each document type above.
LIST_***_ITEM_HEADER_EX	n/a
LIST_***_ITEM_SORT	See primary structure for each document type above.

Document item input

Configuration element	Available structures
INPUT_INB_ITEM	Primary: /TCTM/LIPS_S (LIPS) Secondary: /TCTM/LIKP_S (LIKP), /TCTM/VBUP_S (VBUP), /TCTM/MAKT (MAKT), /TCTM/MARA (MARA), /TCTM/MARC (MARC), /TCTM/MARD (MARD), /TCTM/MLGN(MLGN), /TCTM/BAPIEKKOL (PO), /TCTM/BAPIEKPOC (PO_ITEM), WUEB (WUEB)
INPUT_OBD_ITEM	Primary: /TCTM/LIPS_S (LIPS) Secondary: /TCTM/LIKP_S (LIKP), /TCTM/MAKT (MAKT), /TCTM/MARA (MARA), /TCTM/MARC (MARC), /TCTM/MARD (MARD), /TCTM/MLGN(MLGN), /TCTM/BAPIEKKOL (PO), /TCTM/BAPIEKPOC (PO_ITEM), WUEB (WUEB)
INPUT_PO_ITEM	Primary: /TCTM/BAPIEKPOC (ITEM) Secondary: EKKO (EKKO), EKPO (EKPO), /TCTM/BAPIEKKOL (HEADER), /TCTM/MAKT (MAKT), /TCTM/MARA (MARA), /TCTM/MARC (MARC), /TCTM/MARD (MARD), /TCTM/MLGN (MLGN)
INPUT_SA_ITEM	Primary: /TCTM/BAPIMEOUTITEM_S (ITEM) Secondary: EKKO (EKKO), EKPO (EKPO), /TCTM/BAPIMEOUTHEADER_S (HEADER), /TCTM/MAKT (MAKT), /TCTM/MARA (MARA), /TCTM/MARC (MARC), /TCTM/MARD (MARD), /TCTM/MLGN (MLGN)
INPUT_RTN_ITEM	Primary: /TCTM/LIPS_S (LIPS) Secondary: /TCTM/LIKP_S (LIKP), /TCTM/MAKT (MAKT), /TCTM/MARA (MARA), /TCTM/MARC (MARC), /TCTM/MARD (MARD), /TCTM/MLGN (MLGN)
INPUT_***_ITEM_ACTIONS	BACK - back to previous screen. CLEAR_INPUT - clear all input fields. SAVE – proceed to post this item. ADD_TO_BASKET - add item to basket. VIEW_BASKET - view basket.

Batch detail input

Note

This is a pop-up screen to add the production and expiration dates if required by the system.

Configuration element	Available structures / fields
INPUT_***_BATCH_DETAIL	PROD_DATE - production date EXPIRYDATE - expiration date
INPUT_***_BATCH_ACTIONS	CONTINUE - proceed. CANCEL - return back to previous input screen.

Basket list

Configuration element	Available structures
LIST_INB_BASKET	Primary: /TCTM/BAPI2017_GM_ITEM_CREATE (BAPI_ITEM) Secondary: /TCTM/LIKP_S (LIKP), /TCTM/LIPS_S (LIPS), /TCTM/MAKT (MAKT), /TCTM/MARA (MARA), /TCTM/MARC (MARC), /TCTM/MARD (MARD), /TCTM/MLGN (MLGN)
LIST_OBD_BASKET	Primary: /TCTM/BAPI2017_GM_ITEM_CREATE (BAPI_ITEM) Secondary: /TCTM/LIKP_S (LIKP), /TCTM/LIPS_S (LIPS), /TCTM/MAKT (MAKT), /TCTM/MARA (MARA), /TCTM/MARC (MARC), /TCTM/MARD (MARD), /TCTM/MLGN (MLGN)
LIST_PO_BASKET	Primary: /TCTM/BAPIEKPOC (ITEM) Secondary: /TCTM/BAPI2017_GM_ITEM_CREATE (BAPI_ITEM), EKKO (EKKO), EKPO (EKPO), /TCTM/BAPIEKKOL (PO), /TCTM/BAPIEKPOC (PO_ITEM), /TCTM/MAKT (MAKT), /TCTM/MARA (MARA), /TCTM/MARC (MARC), /TCTM/MARD (MARD), /TCTM/MLGN (MLGN)
LIST_SA_BASKET	Primary: /TCTM/BAPIMEOUTITEM_S (ITEM) Secondary: /TCTM/BAPI2017_GM_ITEM_CREATE (BAPI_ITEM), EKKO (EKKO), EKPO (EKPO), /TCTM/BAPIMEOUTHEADER_S (HEADER), /TCTM/MAKT (MAKT), /TCTM/MARA (MARA), /TCTM/MARC (MARC), /TCTM/MARD (MARD), /TCTM/MLGN (MLGN)
LIST_RTN_BASKET	Primary: /TCTM/LIPS_S (LIPS) Secondary: /TCTM/LIKP_S (LIKP), /TCTM/MAKT (MAKT), /TCTM/MARA (MARA), /TCTM/MARC (MARC), /TCTM/MARD (MARD), /TCTM/MLGN (MLGN)
LIST_***_BASKET_ACTIONS	EXIT - returns to selection. EMPTY_BASKET - clear the basket. SAVE - process the basket for posting. ADD_NEW_ITEM - return to lists for next item. DELETE - remove the basket item from basket.
LIST_***_BASKET_HEADER	See structures for each document type above.
LIST_***_BASKET_HEADER_EX	n/a
LIST_***_BASKET_SORT	See primary structure for each document type above.
SUMMARISE_***_BASKET	Configuration option to allow different ways of updating the basket, where the item has previously been processed and the item details are the same: If set to blank, you will receive an error message if item is already in the basket. You need to remove the existing item before the new one can be added. If set to A, then the quantity in the basket for the matching item will be increased by the quantity entered. If set to B, then a new basket entry will be created, resulting in multiple basket entries for the item.

Basket input

Configuration element	Available structures
INPUT_INB_BASKET	Primary: /TCTM/LIPS_S (LIPS) Secondary: /TCTM/LIKP_S (LIKP), /TCTM/VBUP_S (VBUP), /TCTM/MAKT (MAKT), /TCTM/MARA (MARA), /TCTM/MARC (MARC), /TCTM/MARD (MARD), /TCTM/MLGN(MLGN), /TCTM/BAPIEKKOL (PO), /TCTM/BAPIEKPOC (PO_ITEM), WUEB (WUEB)
INPUT_OBD_BASKET	Primary: /TCTM/LIPS_S (LIPS) Secondary: /TCTM/LIKP_S (LIKP), /TCTM/MAKT (MAKT), /TCTM/MARA (MARA), /TCTM/MARC (MARC), /TCTM/MARD (MARD), /TCTM/MLGN(MLGN), /TCTM/BAPIEKKOL (PO), /TCTM/BAPIEKPOC (PO_ITEM), WUEB (WUEB)
INPUT_PO_BASKET	Primary: /TCTM/BAPIEKPOC (ITEM) Secondary: EKKO (EKKO), EKPO (EKPO), /TCTM/BAPIEKKOL (HEADER), /TCTM/MAKT (MAKT), /TCTM/MARA (MARA), /TCTM/MARC (MARC), /TCTM/MARD (MARD), /TCTM/MLGN (MLGN)
INPUT_SA_BASKET	Primary: /TCTM/BAPIMEOUTITEM_S (ITEM) Secondary: EKKO (EKKO), EKPO (EKPO), /TCTM/BAPIMEOUTHEADER_S (HEADER), /TCTM/MAKT (MAKT), /TCTM/MARA (MARA), /TCTM/MARC (MARC), /TCTM/MARD (MARD), /TCTM/MLGN (MLGN)
INPUT_RTN_BASKET	Primary: /TCTM/LIPS_S (LIPS) Secondary: /TCTM/LIKP_S (LIKP), /TCTM/MAKT (MAKT), /TCTM/MARA (MARA), /TCTM/MARC (MARC), /TCTM/MARD (MARD), /TCTM/MLGN (MLGN)
INPUT_***_BASKET_ACTIONS	BACK - back to previous screen. CLEAR_INPUT - clear all input fields. SAVE – proceed to post. ADD_TO_BASKET – update basket. DELETE – remove item from basket.

General configuration elements

Configuration element	Descriptions
FE_APP	Frontend class to use in running the transaction. Reference to the platform specific frontend application that should be used to run the transaction. Included in the App Master Data file supplied for setting up the initial transactions.
DOCUMENT_TYPE	Configure which types of SAP documents can be receipted using the app. Set a document type, along with the class required to receipt that type of document. For this app transaction the following are valid: PO - Purchase orders SA - Scheduling agreements INB - Unpacked inbound deliveries OBD - Outbound deliveries for stock transport order receipts RTN - Customer return deliveries including consignment pick-up The corresponding class to be assigned to each document type is /TCTM/WM_APP_500_DT_*** where *** is the document type.
PACK_MODE	OBSOLETE - no longer used.
MATERIAL_SEARCH_SEQ	Defines the search sequence for materials and the relevant conversion exits. Valid Values: M – Material D – Description E – EAN code (the EAN code for any unit of measure in the material master) B – Storage Bin (Plant/Data Stor 1 view of material master)
SERIAL_OVERRIDE_***	Serialisation Overrides
CALL_TRANSACTION_***	Defines transactions that can be called from this app automatically.
SUPPRESS_SUCCESS	Allows success messages to be suppressed. If toggle = ON, success messages are suppressed. If toggle = OFF, success messages are not suppressed.
MAX_***	Maximum number of documents to find in search results. Blank value results in no restriction on the number of records found during search.
PLANT_FILTER	Enables filtering of plants assigned to the warehouse, allowing you to include or exclude specific values in the list view.
SLOC_FILTER	This is a possible filter element that can be used, as required, to allow filtering of the storage locations (if these need to be restricted to a subset of locations that are allocated to the PreBilt warehouse). It has been created as an example and can be used or changed as required. It must be used in conjunction with a suitable field class assigned to the field.
VENDOR_FILTER	Enables filtering of vendors, allowing you to include or exclude specific values in the list view.
PLANT_LIST	Allows a static list to be maintained for plants. If the user needs to choose from a list of plants, the allowed values can be set here. The value and description of the plants are displayed as set up, and unlike a filter option, no validation will take place until the data is submitted to SAP.
SLOC_LIST	Allows a static list to be maintained for choosing a storage location. If the user is required to select from a list of storage locations, the allowed values can be set here. The value and description of the storage locations are displayed as set up, and unlike a filter option, no validation will take place until the data is submitted to SAP.
OBD_TYPES_LIST	OBSOLETE - no longer used.
BWART_LIST	Allows a static list to be maintained for choosing movement types to be selected by the user if required.
APP_TEXTS	Defines standard app text to be used in screen headers, buttons etc.
TEXT_OVERRIDE	Text override.
TRANS_INFO	Information about the transaction.