To read details of a handling unit.
Entity Type |
Service Operation |
Software Component Version |
EWM 7.02 |
released |
|
HandlingUnitByIDQueryResponse_In |
|
http://sap.com/xi/EWM/Global |
|
SCM-EWM |
|
Web Service Definition (Back End) |
/SCWM/BIF_HU_QR |
B2B |
|
inbound |
|
synchronous |
|
no |
|
not applicable |
|
true |
The
Read Handling Unit
inbound operation receives detailed handling unit information and information about the stock content of a handling unit (HU). You can use this operation in the following business contexts, for example:
You need an operation to retrieve packaging information.
You combine this operation with operations that provide handling unit IDs as output. The
Read Handling Unit
inbound operation can then be used to retrieve detailed handling unit information.
For more information, see the Handling Unit business object.
The
Read Handling Unit
inbound operation requires a handling unit ID or range of IDs for which handling units are selected (HandlingUnitSelectionByID element). Note that when you provide handling unit IDs, you must ensure that the ID contains a total of 20 characters. You may need to include leading zeros.
Example
If you want to retrieve detailed information for the handling unit 8000971413, you must provide the value “00000000008000971413” in the SelectionByHandlingUnitInternalID element.
Depending on your system configuration, you provide one of the following types of handling unit ID as input for the operation:
Standard ID (SelectionByHandlingUnitStandardID element): If you have configured your packaging material type so that the number assignment to the handling unit follows an external standard, use the standard ID for the handling unit.
Internal ID (SelectionByHandlingUnitInternalID element): If the number assignment of your handling unit does not follow any external standards, use the internal ID for the handling unit.
The
Read Handling Unit
operation returns the following information:
Handling unit ID and type
Physical aspects of the handling unit, such as its dimension, volume, or weight
System statuses, such as whether the handling unit is loaded or unloaded, or whether it is blocked
ID of the warehouse where the handling unit is located
The life-cycle status of the handling unit (HandlingUnitLifeCycleStatusCode element)
Packaging material of the handling unit (LoadCarrrier and AdditionalPackagingMaterial elements)
Handling units that are contained within the handling unit (LowerLevelHandlingUnit element)
Only the handling units of the first lower level are returned.
Customer-specific statuses that are set for a handling unit (UserStatus element)
These are statuses that are not available in the standard system, but are defined as your customer-specific statuses. The
Read Handling Unit
inbound operation retrieves all statuses starting with character “E” as customer-specific statuses.
Detailed information about the content of the handling unit (Load element), such as the product, quantity, or serial number
The information about blocked handling units is coded as follows:
The HandlingUnitMovementBlockedIndicator element gets the value “1” (true) when the status “IHUS2” is set in the back-end system (the handling unit is blocked for movement).
The HandlingUnitChangesBlockedIndicator element gets the value “1” (true) when the status “IHUS3” is set in the back-end system (the handling unit is blocked for changes).
The HandlingUnitContentChangesBlockedIndicator element gets the value “1” (true) when the status IHUS1 is set in the back-end system (the handling unit is blocked for changes of its content).
The information about loaded and unloaded handling units is coded as follows:
The LoadedIndicator element gets the value “1” (true) when status “IHU05” is set for the handling unit in the back-end system.
The UnloadedIndicator element gets the value “1” (true) when status “IHU04” is set for the handling unit in the back-end system.
The information about the life-cycle status of the handling unit is coded as follows: The HandlingUnitLifeCycleStatusCode element gets the following values:
Value “1” if the status “IHU01” (Planned) is set for the handling unit in the back-end system
Value “2” if the status “IHU02” (In Stock) is set for the handling unit in the back-end system
Value “3” if the status “IHU03” (Goods Issue Posted) is set for the handling unit in the back-end system
HandlingUnitByIDQuery_sync
HandlingUnitByIDResponse_sync
You have implemented the
Goods Movements
(SCM-EWM-GM) application component in SAP Extended Warehouse Management (SAP EWM). In particular, you have made the required settings for handling units in Customizing for
Extended Warehouse Management
under
Cross-Process Settings -> Handling Units
.
You can control the generation of a handling unit ID when a handling unit is created in Customizing for
Extended Warehouse Management
under
Cross-Process Settings -> Handling Units -> Define Packaging Material Types
. Check this Customizing setting before you select or search for handling units by providing standard IDs or internal IDs (see
Features
section).
The Business Add-In (BAdI)
BAdI for HandlingUnitQueryResponse
(/SCWM/HU_BIF_QR) is available for this operation.
The Business Add-In (BAdI)
BAdI for HandlingUnitQueryResponse
(/SCWM/HU_BIF_QR) is available for this operation.