Connect Vehicle Appointment

To receive a request to connect transportation unit appointments to a vehicle appointment.

Technical Data

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

Business Context and Use

The Connect Vehicle Appointment inbound operation is a request to the Site Logistics Processing process component to connect a vehicle appointment and transportation unit appointments. This operation is needed when a planner wants to connect transportation units to a vehicle. For example, the planner intends to connect a road trailer to a road vehicle, or railway cars to a locomotive. In these cases, the planner must connect the transportation unit appointments with the vehicle appointment. The connection of a vehicle appointment can refer to a planned or an actual connection between transportation units and a vehicle.

Example

A planner wants to optimize the dock appointments for a vehicle with several transportation units that are moved within a yard or that need to leave the yard. In this case, he or she can use the Connect Vehicle Appointment operation to connect the vehicle appointment to transportation unit appointments.

Related Operations

This is an asynchronous operation. If your system is set up to work with synchronous operations, you can also use the Connect Vehicle Appointment synchronous operation.

Related Operations

This is an asynchronous operation. If your system is set up to work with synchronous operations, you can also use the Connect Vehicle Appointment synchronous operation.

The related confirmation operation of the Connect Vehicle Appointment asynchronous inbound operation is the Confirm Connect Vehicle Appointment outbound operation. The related compensation operation for the Connect Vehicle Appointment inbound operation is the Disconnect Vehicle Appointment asynchronous inbound operation.

Features

The operation requires the following data as input:

Yard resource appointment ID of the vehicle appointment
List of transportation unit appointments that you want to connect to the vehicle appointment
Ordinal numbers of the transportation unit appointments

Error Handling

Typical Errors

In systems based on SAP EWM: If you get the error message Vehicle activity &1 was not found in the data (/SCWM/SHP_RCV 286), no vehicle was found for the yard resource appointment ID. Check if the yard resource appointment ID is correct.

Forward Error Handling

The Connect Vehicle Appointment inbound operation supports Forward Error Handling . Errors of the error category DCE (Determination and Conversion Error) might occur.

Message Types

VehicleAppointmentConnectRequest

Prerequisites

The vehicle appointment and the connected transportation unit appointments must exist in the back-end system. The vehicle appointment and the transportation unit appointments must have the status Planned or Active . Before you call the Connect Vehicle Appointment operation, you must use the External Lock operation.

Notes on SAP Implementation

Configuration and Authorizations

For more information, see the Vehicle Appointment business object.

Terminology

Note that in a back-end system with SAP Extended Warehouse Management (SAP EWM), connected transportation units are referred to as “assigned transportation units”.

Enhancements

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

Enhancements

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