Find Vehicle Appointment by Elements
To search for and retrieve vehicle appointments by elements that meet the search criteria.
Entity Type |
Service Operation |
released |
|
VehicleAppointmentByElementsQueryResponse_In |
|
http://sap.com/xi/EWM/Global |
|
SCM-EWM |
|
Web Service Definition (Back End) |
/SCWM/BIF_YRD_VAPP_QR |
inbound |
|
synchronous |
|
no |
|
not applicable |
|
true |
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.
You can process the output data of this operation by using other operations of the Vehicle Appointment object.
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.
VehicleAppointmentByElementsQuery_sync
VehicleAppointmentByElementsResponse_sync
See the latest SAP notes release in this area that may be relevant for proper functioning of this operation.
The XI Message: Vehicle Appointment Query, Response
(/SCWM/EX_SR_BIF_VAPP_QR) Business Add-In (BAdI) is available for this operation.