Show TOC

 Change Vehicle Appointment

 

To change the details of a vehicle appointment.

Technical Data

Entity Type

Service Operation

Release State

released

Technical Name

VehicleAppointmentChangeRequestConfirmation_In

Namespace

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

Application Component

SCM-EWM

Web Service Definition (Back End)

/SCWM/BIF_YRD_VAPP_CHANGE_RC

Direction

inbound

Mode

synchronous

Idempotency

no

Change/Update Behavior

not applicable

P2P Communication Enabled

true

Business Context and Use

You can use the Change Vehicle Appointment (synchronous) inbound operation to change the details of a vehicle appointment.

Use Case: Planning

A planner for a retail warehouse uses an application to modify appointments for inbound transportation units. First, the planner wants to see the vehicles that are scheduled for the next day, so he or she executes the Find Vehicle Appointment by Elements operation, using the next day's date as the search criterion. He or she gets back a list of the vehicles scheduled for that day and also a list of the IDs of assigned transportation units.

As a next step, the planner updates the transportation unit appointment and the vehicle appointment with the new information using the Change Vehicle Appointment operation.

Related Operations

You can use the asynchronous Notify of Vehicle Appointment Change outbound operation to inform a third party about changes to vehicle appointments.

Related Operations

You can use the asynchronous Notify of Vehicle Appointment Change outbound operation to inform a third party about changes to vehicle appointments.

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

Features

The request message for the  Change Vehicle Appointment (synchronous) inbound operation requires the following data in the VehicleAppointment element as input:

  • Vehicle appointment ID

  • External lock ID

  • Planned start of the processing period

  • Planned end of the processing period

  • Gross weight measure

  • Property information (alternative vehicle identification)

If successful, the operation returns a log along with the details of the vehicle appointment data, including:

  • Yard resource appointment ID

  • Execution status code

  • Planned start processing period

  • Planned end processing period

  • Processing period

  • Carrier party

  • Gross weight

  • Blocking and locking information

  • Invoice before goods issue requested indicator

  • Resource (data about the vehicle, such as its license plate, owner, and so on)

  • Activity information (business process steps of the vehicle, status of the vehicle)

  • Property information (alternative vehicle identification)

  • Transportation unit (TU) assignments for the vehicle

If unsuccessful, the operation returns a log with error details.

Message Types

  • VehicleAppointmentChangeConfirmation_sync

  • VehicleAppointmentChangeRequest_sync

Prerequisites

The  External Lock  inbound operation must be used before any change operation for this business object.

The vehicle appointment must exist in the back-end system, and must have the status 'planned' or 'active'.

Notes on SAP Implementation

Required Configuration and Master Data

The Shipping/Receiving functionality within EWM must be active.

Relevant Industries

You can use the Change Vehicle Appointment (synchronous) inbound operation for external transportation and execution systems, transport logistics, and cross-industry warehousing sectors.

Enhancements

The  XI Message: Vehicle Assignment Request, Confirmation (/SCWM/EX_SR_BIF_VAPP_RC) Business Add-In (BAdI) is available for this operation.

Enhancements

The  XI Message: Vehicle Assignment Request, Confirmation (/SCWM/EX_SR_BIF_VAPP_RC) Business Add-In (BAdI) is available for this operation.