Show TOC

 Read Handling Unit

 

To read details of a handling unit.

Technical Data

Entity Type

Service Operation

Software Component Version

EWM 7.02

Release State

released

Technical Name

HandlingUnitByIDQueryResponse_In

Namespace

http://sap.com/xi/EWM/Global

Application Component

SCM-EWM

Web Service Definition (Back End)

/SCWM/BIF_HU_QR

Category

B2B

Direction

inbound

Mode

synchronous

Idempotency

no

Change/Update Behavior

not applicable

P2P Communication Enabled

true

Business Context and Use

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.

Features

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

Message Types

  • HandlingUnitByIDQuery_sync

  • HandlingUnitByIDResponse_sync

Notes on SAP Implementation

Configuration

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 .

Note on Standard IDs and Internal IDs

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).

Enhancements

The Business Add-In (BAdI) BAdI for HandlingUnitQueryResponse (/SCWM/HU_BIF_QR) is available for this operation.

Enhancements

The Business Add-In (BAdI) BAdI for HandlingUnitQueryResponse (/SCWM/HU_BIF_QR) is available for this operation.