Show TOC

 Change Transportation Unit Appointment

 

To request Site Logistics Processing to change the details of a transportation unit appointment.

Technical Data

Entity Type

Service Operation

Release State

released

Technical Name

TransportationUnitAppointmentChangeRequestConfirmation_In

Namespace

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

Application Component

SCM-EWM

Web Service Definition (Back End)

/SCWM/BIF_YRD_TAPP_CHANGE_RC

Direction

inbound

Mode

synchronous

Idempotency

no

P2P Communication Enabled

true

Business Context and Use

The Change Transportation Unit Appointment (synchronous) inbound operation is a request to Site Logistics Processing to change an existing transportation unit appointment.

Related Operations

The Notify of Transportation Unit Appointment Change (asynchronous) outbound operation informs the external system about the change of a transportation unit.

If your system is set up to work with asynchronous operations, you can use the paired Change Transportation Unit Appointment and Confirm Change Transportation Unit Appointment  operations.

Features

You can use this inbound operation to perform to following actions:

  • Change the appointment data (planned processing period) of a transportation unit

  • Assign or reassign inbound or outbound deliveries or delivery items to the transportation unit

  • Move a transportation unit to checkpoints, parking spaces, and doors within the yard.

The request message specifies the following data as input:

  • Yard resource appointment ID of the transportation unit appointment

  • Transportation unit appointment type code to change the direction (inbound or outbound) of the transportation unit appointment

The transportation unit appointment type code (448 = inbound, 449 = outbound) makes it possible to change the direction of the transportation unit as long as no deliveries are assigned.

  • Planned start of processing period

  • Planned end of processing period

  • Gross weight

  • Property information (alternative transportation unit identification)

  • Planned yard bin

It is derived from the warehouse number and the yard bin of the checkpoint, parking space, or door. By providing a planned yard bin you can create a warehouse task to move the transportation unit to a checkpoint, a parking space, or door.

  • Yard bin

It is derived from the warehouse number and the yard bin of the checkpoint, parking space, or door. By providing a yard bin you can confirm the warehouse task to move the transportation unit to a checkpoint, a parking space, or door.

  • Inbound or outbound delivery references with delivery IDs and delivery item IDs to assign or reassign deliveries or delivery items

The action code of the inbound and outbound delivery reference structure is used, where 1 means assign and 2 means reassign.

The response message returns a log with possible error messages and the transportation unit appointment. You receive an error message in the following cases:

  • You call this operation for a transportation unit appointment that is completed.

  • You call this operation to assign an inbound delivery to an outbound transportation unit appointment or an outbound delivery to an inbound transportation unit appointment.

  • No transportation unit is found for the yard resource appointment ID. Check if the yard resource appointment ID is correct.

Message Types

  • TransportationUnitAppointmentChangeConfirmation_sync

  • TransportationUnitAppointmentChangeRequest_sync

Prerequisites

The transportation unit appointment already exists and has the status "planned" or "active".

To move a transportation unit in the yard, the transportation unit must have the status "active".

Before changing the details of a transportation unit appointment, set an external lock on it with the External Lock inbound operation.

Notes on SAP Implementation

Enhancements

The following Business Add-Ins (BAdIs) are available for this operation:

  • XI Message: TU Assignment Request, Confirmation (/SCWM/EX_SR_BIF_TAPP_RC)

  • XI Message: TU Assignment - Scheduling Condition (/SCWM/EX_SR_BIF_TAPP_SCHED) to influence the shipping relevance of the message when creating or deleting a transportation unit assignment