Show TOC

 Block Transportation Unit Appointment

 

To set a block on a transportation unit appointment.

Technical Data

Entity Type

Service Operation

Release State

released

Technical Name

TransportationUnitAppointmentBlockRequestConfirmation_In

Namespace

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

Application Component

SCM-EWM

Web Service Definition (Back End)

/SCWM/BIF_YRD_TAPP_BLOCK_RC

Direction

inbound

Mode

synchronous

Idempotency

no

Change/Update Behavior

not applicable

P2P Communication Enabled

true

Business Context and Use

The Block 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 a synchronous operation. If your system is set up to work with asynchronous operations, you can also use the Block Execution Transportation Unit Appointment  asynchronous inbound operation, which is paired with the Confirm Block Transportation Unit Appointment  asynchronous outbound operation.To unblock the transportation unit appointment, use the Unblock 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

If successful, the operation returns a log along with the transportation unit appointment and the blocking information as output.

Error Handling

Consider the following during error handling:

  • The system raises an error message if you call the Block 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 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.

Message Types

  • TransportationUnitAppointmentBlockConfirmation_sync

  • TransportationUnitAppointmentBlockRequest_sync

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