Block Execution Transportation Unit Appointment

To receive a request to block a transportation unit appointment.

Technical Data

Entity Type	Service Operation
Release State	released
Technical Name	TransportationUnitAppointmentBlockRequest_In
Namespace	http://sap.com/xi/EWM/Global
Application Component	SCM-EWM
Category	B2B
Direction	inbound
Mode	asynchronous
Idempotency	not applicable
Change/Update Behavior	not applicable
P2P Communication Enabled	no

Business Context and Use

The Block Execution Transportation Unit Appointment inbound operation is a request to the Site Logistics Processing process component to set a block for a transportation unit appointment. A transportation unit that is blocked cannot be processed until it is unblocked. Users cannot check in, check out, load, or unload a blocked transportation unit, nor can they post goods issues or goods receipts of a blocked transportation unit appointment.

Related Operations

This is an asynchronous operation. If your system is set up to work with synchronous operations, you can also use the Block Transportation Unit Appointment synchronous inbound operation.

To unblock the transportation unit appointment, use the Unblock Execution Transportation Unit Appointment operation.

Features

The operation requires the following data as input:

Universal unique identifier (UUID) of the block
Yard resource appointment ID of the transportation unit appointment
Blocking reason code

Error Handling

General Considerations

Consider the following during error handling:

The system raises an error message if you call the Block Execution Transportation Unit Appointment operation for a transportation unit appointment that was not locked with External Lock operation previously.
The system raises an error message if you call the Block Execution Transportation Unit Appointment operation for a transportation unit appointment that is already blocked.
If no transportation unit was found for the yard resource appointment ID, the system returns an error message. Check if the yard resource appointment ID is correct.

Forward Error Handling

The Block Execution Transportation Unit Appointment inbound operation supports Forward Error Handling . Errors of the error category DCE (Determination and Conversion Error) might occur.

Consider the following during error handling:

The system raises an error message if you call the Block Execution Transportation Unit Appointment operation for a transportation unit appointment that was not locked with External Lock operation previously.
The system raises an error message if you call the Block Execution Transportation Unit Appointment operation for a transportation unit appointment that is already blocked.
If no transportation unit was found for the yard resource appointment ID, the system returns an error message. Check if the yard resource appointment ID is correct.

Forward Error Handling

The Block Execution Transportation Unit Appointment inbound operation supports Forward Error Handling . Errors of the error category DCE (Determination and Conversion Error) might occur.

Message Types

Transportation Unit Appointment Block Request

Prerequisites

The transportation unit appointment must exist in the back-end system, and it must have the status Planned or Active . Before you call the Block Execution Transportation Unit Appointment operation, you must use the External Lock operation.

Notes on SAP Implementation

Configuration

You must define the valid blocking reason codes in Customizing for Extended Warehouse Management under Cross Process Settings -> Shipping and Receiving -> General Settings -> Define Reasons for Status .

For more information about configuration, see the Transportation Unit Appointment business object.

Enhancements

The Business Add-In (BAdI) BAdI for TransportationUnitAppointment...RequestConfirmation (/SCWM/EX_SR_BIF_TAPP_RC) is available for this operation.