Show TOC

 Find Vehicle Appointment by Elements

 

To search for and retrieve vehicle appointments by elements that meet the search criteria.

Technical Data

Entity Type

Service Operation

Release State

released

Technical Name

VehicleAppointmentByElementsQueryResponse_In

Namespace

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

Application Component

SCM-EWM

Web Service Definition (Back End)

/SCWM/BIF_YRD_VAPP_QR

Direction

inbound

Mode

synchronous

Idempotency

no

Change/Update Behavior

not applicable

P2P Communication Enabled

true

Business Context and Use

You can use the Find Vehicle Appointment by Elements synchronous inbound operation in the following cases:

  • Use case 1: PlanningA planner for a retail warehouse uses a 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. The planner receives 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 can use the Find Transportation Unit Appointment by Elements operation to receive the information about all the found transportation units, for example, assigned deliveries, or see whether dock appointments already exist. Similarly, the planner can receive a list of the dock appointments that are scheduled for the next day by using the Find Dock Appointment by Elements operation. All these operations are synchronous.

  • Use case 2: Identifying an arriving vehicle at check-inA vehicle approaches the checkpoint guard at the entry of the yard. The guard looks at the monitor that was filled in the morning with a list of all vehicles and all connected transportation units or transportation units that are expected for that day. This was done by the software by means of the  Find Vehicle Appointment by Elements operation and the Find Transportation Unit Appointment by Elements  operation. On the screen, the guard can see all the details of the vehicles and transportation units that are supposed to pass the gate that day. For example, the details include the deliveries fulfilled by the vehicles, the license plate of the vehicles, and the carrier company. If the vehicle is not on the monitor, the guard can search for the related vehicle appointments, for example, by the license plate or by the carrier data using the same the  Find Vehicle Appointment by Elements operation. Upon verifying the papers, there might be some questions on a delivery that is included in one of the transportation units. For this, the guard can have a look at the entire delivery details by calling the Find Inbound Delivery by Elements operation. The guard can serach by the delivery ID if it is available through the information attached to the transportation unit or by the date or the carrier information.

Related Operations

You can process the output data of this operation by using other operations of the Vehicle Appointment object.

Features

You can find vehicle appointments, for example,  by using the following elements as search criteria:

  • Time horizon of the vehicle appoint processing period

  • Yard resource appointment ID and external ID of the vehicle appointment

  • Internal and external ID of the carrier of the vehicle appointment

  • License plate and means of transport of the vehicle appointment

  • Means of transport of the assigned transportation units

  • Internal and external ID of the carrier of the assigned transportation units

For the first use case, for example, you can use the time horizon as the selection criterion.

If successful, the operation returns the complete vehicle appointment data including the assigned transportation unit appointments of all selected vehicle appointments.

Message Types

  • VehicleAppointmentByElementsQuery_sync

  • VehicleAppointmentByElementsResponse_sync

Notes on SAP Implementation

Processing

See the latest SAP notes release in this area that may be relevant for proper functioning of this operation.

Enhancements

The XI Message: Vehicle Appointment Query, Response (/SCWM/EX_SR_BIF_VAPP_QR) Business Add-In (BAdI) is available for this operation.