HowToGuide YL EWM Integration R2 V1.5m

How-To-Guide CUSTOMER
SAP Yard Logistics

Document Version: 1.5 – 2017-09-04
SAP YL and SAP EWM Integration

Typographic Conventions
Type Style Description
Example Words or characters quoted from the screen. These include field names, screen titles,
pushbuttons labels, menu names, menu paths, and menu options.
Textual cross-references to other documents.
Example Emphasized words or expressions.
EXAMPLE Technical names of system objects. These include report names, program names,
transaction codes, table names, and key concepts of a programming language when they
are surrounded by body text, for example, SELECT and INCLUDE.
Example Output on the screen. This includes file and directory names and their paths, messages,
names of variables and parameters, source text, and names of installation, upgrade and
database tools.
Example Exact user entry. These are words or characters that you enter in the system exactly as
they appear in the documentation.
<Example> Variable user entry. Angle brackets indicate that you replace these words and characters
with appropriate entries to make entries in the system.
EXAMPLE Keys on the keyboard, for example, F 2 or E N T E R .
CUSTOMER SAP YL and SAP EWM Integration

2 © 2016 SAP SE or an SAP affiliate company. All rights reserved. Typographic Conventions
Document History
Version Date Change
1.0 11-02-2016 Initial creation
1.1 24-10-2016 Update for Release 2
1.2 04-04-2017 Update
1.3 07-08-2017 Update
1.4 21-08-2017 Update after Review
1.5 04-09-2017 Update after Review
SAP YL and SAP EWM Integration CUSTOMER

Document History © 2016 SAP SE or an SAP affiliate company. All rights reserved. 3
Contents
1 Getting Started .............................................................................................................................. 6

1.1 About this Guide .................................................................................................................................... 6
1.2 Related Document ................................................................................................................................. 6
1.3 Important SAP Notes ............................................................................................................................ 6
2 Overview ......................................................................................................................................... 7
2.1 Process view .......................................................................................................................................... 7
2.2 Restrictions and Limits ......................................................................................................................... 9
2.2.1 Scenario 1 - Vehicle and Container Hierarchies in Inbound and Outbound in Sequence
................................................................................................................................................ 9
2.2.2 Scenario 2 - Vehicle and Container Hierarchies in Inbound and Outbound sequence
with Release Control ........................................................................................................... 10
3 Setup in SAP YL........................................................................................................................... 12

3.1 General Settings ...................................................................................................................................12
3.1.1 Assign EWM Warehousing to a Yard Number ...................................................................12
3.1.2 Mapping of YL storage bins to EWM doors and checkpoints ...........................................12
3.1.3 Maintain EWM checkpoints .................................................................................................13
3.1.4 Set Activity Types as Subsystem relevant ........................................................................13
3.1.5 Assign External Warehouse ID to Storage Type ...............................................................14
3.1.6 Maintain Logical Ports for EWM Integration ......................................................................14
4 Setup in SAP EWM ...................................................................................................................... 16

4.1 Enable Standard Web Services Usage ...............................................................................................16
4.2 Prerequisites .........................................................................................................................................16
4.3 Set Up Standard EWM Web Services .................................................................................................16
4.3.1 Set up standard web services on EWM side ...................................................................... 17
4.3.2 Set up standard web services in SAP Yard Logistics ........................................................21
4.4 Overview of New Web Services .......................................................................................................... 25
4.4.1 Door Arrival/Door Departure ............................................................................................. 25
4.4.2 Query External TU ................................................................................................................31
4.4.3 Loading/Unloading Notification ........................................................................................ 36
5 Technical Overview .....................................................................................................................43

5.1 Check-In ............................................................................................................................................... 43
5.2 Check-Out ............................................................................................................................................ 44
5.3 Reverse Check-In................................................................................................................................. 45
5.4 Reverse Check-Out ............................................................................................................................. 45
5.5 Door Determination ............................................................................................................................. 45
5.6 Door arrival/departure........................................................................................................................ 46
5.7 Loading/Unloading Notification ......................................................................................................... 48

4 © 2016 SAP SE or an SAP affiliate company. All rights reserved. Contents
1 Getting Started
1.1 About this Guide
This guide provides detailed introduction about how to set up the YL-EWM Integration solution on SAP Yard
Logistics (SAP YL).
Target Groups
• Technical Consultants
• Support Specialists
• Solution Consultants
1.2 Related Document
Related Document
Document Title Link Comment
Online Help for SAP YL http://help.sap.com/yl Central place for all documents for SAP Yard
Logistics
1.3 Important SAP Notes
Important SAP Notes
SAP Note Implementation Comment

Number System
2193981 YL, EWM Update of TE and VEH Methods in /SCWM/CL_BIF_YRD
2209414 YL, EWM EWM 9.3 Short Dump in LDAP Notification for TU Without a
Vehicle
2233793 YL, EWM Corrections for

TransportationOrderLoadingAppointmentRequest_IN
2267111 YL, EWM Corrections for

TransportationOrderLoadingAppointmentrequest_IN
2392436 YL, EWM Arrival at checkpoint fails for vehicles with TUs and containers
2265646 EWM Departure from checkpoint: GI not posted for TU container

6 © 2016 SAP SE or an SAP affiliate company. All rights reserved. Getting Started
2 Overview
The integration between SAP Yard Logistics (YL for short) and SAP EWM warehousing system is based on the
yard management scenario described in http://help.sap.com/ewm93, go to SAP library, select SAP Extended
Warehouse Management, shipping and receiving, then yard management.
Focus of this current document is to describe the functionality related to the interaction between the YL and the
EWM system.
Note
The newly developed process scope for transit warehouse is currently not in scope, but implies some
technical restrictions: The change processes in the warehousing system are very limited in regards to the
“classical” yard management integration but very flexible in regards to the transit warehousing.
To connect the SAP YL to a EWM managed warehouse, the SAP YL yard number must have the business system
and the warehouse number assigned that is used in the EWM warehousing.
Caution
The EWM warehouse number used as yard number in SAP YL and the EWM warehouse number used in
EWM warehousing must be setup in different clients. The reason is that the SAP YL warehouse number
uses the technical concept of the TUs and they are not warehouse dependent business objects.
Moreover, the yard management integrated into SAP EWM Shipping and Receiving shall not be activated
in the assigned EWM warehousing system setup.
Once the linkage between the SAP YL yard number and SAP EWM is established, the setup of the two systems -
SAP YL and SAP EWM - need to be completed as described in the following chapters of this document.
2.1 Process view
When a truck arrives in the yard at the checkpoint the relevant yard order is posted check-in. By that, YL will send
the check-in request confirmation must be send to the EWM warehousing system. At check in or during execution
of a movement in the yard, a door determination might be executed. This determination must trigger a request to
EWM to query which door has been determined in the EWM warehousing system at EWM TU level.
This information will be stored at YT level in SAP YL. By confirming the yard task the Transportation Unit drives to
the pre-assigned door.
When the yard task is confirmed to the pre-assigned door, the door arrival request confirmation shall be triggered.
In the warehousing system, a warehouse worker begins to load the truck by the different HUs from the staging
area. This step is typically carried out using an RF device in the EWM. After he or she has confirmed the loading of
the last HU, the warehouse worker confirms the completion of the loading for the TU. After that, the YL is
informed by receiving a load notification from SAP EWM.
The Close of the TU in EWM might trigger the goods issue posting, and prints the delivery notes and waybill (SAP
EWM). Also, the outbound deliveries were completed (SAP ERP).

Overview © 2016 SAP SE or an SAP affiliate company. All rights reserved. 7
In the yard the TU is being moved from the door to the check-point. This triggers the call for door departure
request confirmation from YL, which is send to EWM
Finally, the check-out of the TU is posted based on the related yard order. This triggers the call for check-out
departure request confirmation from YL towards EWM. See the following figure for a quick summary.
Integation SAP YL – SAP EWM

SAP YL SAP EWM
Yard Request
Yard Order
Yard TU
Yard TU TU Query Yard TU
Yard TU EWM TU
Yard TU
Check in Checkpoint Arrival
Yard Task
Door Determination
Door Arrival Arrival at Door
Loading Loading
Unloading Unloading
Door Departure Departure from Door
Check out Checkpoint Departure
Figure 1: SAP YL - SAP EWM integration

8 © 2016 SAP SE or an SAP affiliate company. All rights reserved. Overview
2.2 Restrictions and Limits
In this chapter the restrictions and limits are explained using sample processes that are not supported in the
integration scenario between SAP Yard Logistics and the SAP EWM warehousing. Although these are only
examples also variations of these processes are also not supported.
For the usage in scenarios using SAP Yard Logistics and SAP EWM warehousing, SAP Yard Logistics is used to
manage in- and outbound of transports, while SAP EWM warehousing executes only the loading or unloading of
TU’s with products. Therefore, only those TU’s with loading or unloading activities are required in SAP EWM
warehousing. TU hierarchies are also not expected in SAP EWM warehousing to allow independent loading
respective unloading (check-in/ check-out) activities.
Examples:
• Tractor / Locomotive: is represented in YL as a TU, but is not required in EWM, because a tractor will not be
loaded unloaded.
• Trailer carrying containers: a trailer is a TU in YL, but not required in EWM.
• Trailer for products: is a TU in YL. In EWM only required if product loading/unloading is planned.
• Container: is required in YL and EWM. In EWM the container TU will be loaded/unloaded.
Also in EWM the hierarchy of TU is not of interest. The necessary TU should be created independently to support
independent loading/unloading activities.
The "Warehouse visits" in a yard order is only expected for TU’s with loading/unloading activities in EWM.
2.2.1 Scenario 1 - Vehicle and Container Hierarchies in

Inbound and Outbound in Sequence
Assume you have two yard requests/orders (one for inbound and one for outbound) relevant for EWM
warehousing process that has a hierarchy of logistical items like a root vehicle and containers assigned. Then the
following sequence is executed:
1. Inbound check-in
2. Outbound activation
3. Inbound completion
In this scenario, SAP EWM warehousing check-out is posted for the inbound vehicle and container and SAP EWM
warehousing check-in is posted for the outbound vehicle and container.
Action/Queue Vehicle Container
EWM Check-Out (for Inbound yard In process (1); Action should Should not be triggered, because
document 1) check-out both: vehicle and parent TU exists
container as they are coupled.
Fails: container is already
locked by (2)
EWM Check-In (for outbound yard Registered in queue In process (2); Fails: active
document 2) container still exists, because
check-out was not yet posted by
(1)

The two queues will run in parallel and then the queue processes (1) and (2) will still block each other.
In this process the inbound yard order releases the control from the vehicle and the container, and the outbound
yard order gets this control. Therefore, SAP EWM warehousing check-out for the inbound yard order and SAP
EWM warehousing check-in for the outbound yard order are posted.
The web services for check-in of container is executed in parallel with posting the check-out of the vehicle and
container. Thus, they block each other.
Figure 2: Scenario 1
To finish this scenario, we only have a workaround to retrigger failed queues in correct sequence: first process
check-out, then process check-in.
2.2.2 Scenario 2 - Vehicle and Container Hierarchies in

Inbound and Outbound sequence with Release Control
Assume you have two yard requests/orders (one for inbound and one for outbound) relevant for EWM
warehousing process that has a hierarchy of logistical items like a root vehicle and containers assigned. Then the
following sequence is executed:
1. Inbound check-in
2. Outbound activation
3. Release TU control from container only

10 © 2016 SAP SE or an SAP affiliate company. All rights reserved. Overview
In this process the inbound yard order releases control from the container, then outbound yard order gets this
control. Thus, SAP EWM warehousing check-out is posted for the inbound yard order and SAP EWM warehousing
check-in is posted for the outbound yard order.
The web service for check-in of the container is executed after check-out of the container. But SAP EWM check-
out for container is not triggered at this point of time. The SAP EWM check-out for the container itself is not
relevant at all as it has a parent and the check-out of its parent is not relevant as it is still under the yard order
control.
Thus, the SAP EWM warehousing check-in of container is blocked and can only be executed after the check-out of
its parent has been triggered.
Figure 3: Scenario 2
To finish this scenario, we only have a workaround to wait until the vehicle will post check-out for both objects.
Then, retrigger the failed queue for the container check-in.

3 Setup in SAP YL
3.1 General Settings
3.1.1 Assign EWM Warehousing to a Yard Number
First, the own business system needs to be defined at customizing node “define own business system”.
Then, the customizing node “Assign EWM Business Systems and Warehouses to Yard” should be maintained.
This customizing contains "Business System for Warehousing Integration" representing integrated EWM business
systems, "Warehouse Number Used for Warehousing Integration" (i.e. the EWM warehouse number) and EWM
Warehouse ID - identifier of an external EWM warehouse and system.
To determine the connectivity of that linked warehousing system, an entry in in so called 'Warehouse Visits'
should be created for each Yard Order Item if it is relevant for communication with an SAP EWM warehousing
business system.
In IMG transaction SPRO, navigate to Yard Logistics -> Integration -> Integration to SAP Extended Warehouse
Management -> Assign EWM Business Systems and Warehouses to Yard:
Yard No EWM business system EWM WhNo EWM warehouse ID
CR01 XYM_200 TRCK XYM200_TRCK
CR01 XYN_300 W001 XYM300_W001
TRCK XYN_300 IK01 XYN300_IK01
Table 1: Assign EWM Business Systems and Warehouses to Yard (Example)
3.1.2 Mapping of YL storage bins to EWM doors and

checkpoints
This customizing is used for the mapping between YL storage bins and EWM doors and its checkpoint – to post
TU at the required location in external EWM system.
This can be found in the NWBC; navigate to Settings -> Integration to SAP EWM -> Determine EWM Door
(/SAPYL/EWMDOOR). Display View "EWM Door": Overview:
Yard No Storage bin EWM Warehouse ID EWM Dr/Ch
TRCK XYN300_IK01_D001 XYN300_IK01 D001
TRCK XYN300_W001_DI01 XYN300_W001 DI01
TRCK XYN300_W001_DO01 XYN300_W001 DOR1
Table 2: Define Doors (Example)

12 © 2016 SAP SE or an SAP affiliate company. All rights reserved. Setup in SAP YL
Example
The values in the figure above are only one example setup. Make sure to use your own customized doors
from the EWM (warehousing) warehouse number!
3.1.3 Maintain EWM checkpoints
This customizing is used for correct usage of EWM checkpoint – to post TU at the required location in external
EWM system. Only inbound checkpoints are required to be maintained.
In IMG transaction SPRO, navigate to Yard Logistics -> Integration -> Integration to SAP Extended Warehouse
Management -> Maintain EWM Checkpoints:
EWM Warehouse ID Checkpoint
XYN300_IK01 INBW
XYN300_W001 INBW
YYN200_TRCK INBC
Table 3: Define EWM checkpoints
Example
The values in the figure above are only one example setup. Make sure to use your own customized
checkpoints from the EWM (warehousing) warehouse number!
3.1.4 Set Activity Types as Subsystem relevant
One more customizing table used in EWM communication can be found in IMG, transaction SPRO; navigate to
Yard Logistics -> Yard Tasks-> Define Activity Types:

Setup in SAP YL © 2016 SAP SE or an SAP affiliate company. All rights reserved. 13
Figure 4: Activity Type is relevant for Subsystem
The flag ‘Relevant for Subsystem’ is used during door determination which is described in a later chapter.
3.1.5 Assign External Warehouse ID to Storage Type
The next customizing is used for door determination and door arrival if several warehouse visits are maintained
for the Yard Order Item.
This can be found in the NWBC; navigate to Settings -> Integration to SAP EWM -> Assign External Warehouse ID
to Storage Type (/SAPYL/WHVISST).
Yard No Storage Type EWM Warehouse ID
TRCK DXN1 XYN300_W001
TRCK DXN2 XYN300_IK01
Table 4: Assign External Warehouse ID to Storage Type
3.1.6 Maintain Logical Ports for EWM Integration
This customizing is more technical and used maintenance of logical port that are used for communication with
different external EWM systems.
Creation of the logical ports will be explained in the later chapter 4.3. Once logical port is created, it can be added
in this customizing.

14 © 2016 SAP SE or an SAP affiliate company. All rights reserved. Setup in SAP YL
This can be found in the NWBC; navigate to Settings -> Integration to SAP EWM -> Maintain Logical Port for EWM
Integration (/SAPYL/V_EWM_LP):
EWM business Proxy Class of Logical Port Logical Port

system
XYN_300 /SAPYL/CO_DOOR_ARR_DEPT XYN300
XYN_300 /SAPYL/CO_QUERY_EXTERNAL_TU XYN300
XYN_300 /SAPYL/CO_QUERY_EXT_TU_DATA XYN300
XYN_300 /SAPYL/CO_TU_CANCEL_CHECK_IN XYN300
XYN_300 /SAPYL/CO_TU_CANCEL_CHECK_OUT XYN300
XYN_300 /SAPYL/CO_TU_LOCK XYN300
XYN_300 /SAPYL/CO_TU_UNLOCK XYN300
XYN_300 /SAPYL/CO_VEHICLE _CHECK_IN XYN300
Table 5: Maintain Logical Ports for EWM Integration
Example
The values in the figure above are only one example setup. Make sure to use your own generated proxy
classes are maintained here!

Setup in SAP YL © 2016 SAP SE or an SAP affiliate company. All rights reserved. 15
4 Setup in SAP EWM
4.1 Enable Standard Web Services Usage
To enable the use of standard web services the "Point-to-Point Communication" must be enabled. If this is the
case, you can trigger enterprise services through the Web services protocol without using a mediator (such as
SAP NetWeaver Process Integration). In other words, you can configure direct communication between the
consumer and provider.
To set up a point-to-point communication for asynchronous services, you need to make additional settings in the
SAP back-end system:
You must activate the business function FND_SOA_REUSE_1.
In Customizing for SAP Business Suite , choose Cross-Application Components -> Processes and Tools for
Enterprise Applications -> Enterprise Services -> Point-to-Point Enablement for Asynchronous Enterprise
Services .
You use the SOA Manager application (transaction SOAMANAGER) to set up endpoints and logical ports.
For more information about the SOA Manager application, see SAP Library for SAP NetWeaver on SAP Help Portal
at http://help.sap.com/netweaver -> SAP NetWeaver 7.0 (2004s) -> SAP NetWeaver 7.0 including Enhancement
Package 2 . Search for Working with the SOA Manager .
Standard outbound web services do not require any additional development. Only set up of endpoints and logical
ports required. This should be done by using SOAMANAGER.
4.2 Prerequisites
In order to setup connection between the systems the user for WSDL access needs to be authorized to access the
WSDL in your EWM system (role SAP_QAP_WEBSERVICE).
In order to create logical ports in Yard Logistics system you user should be authorized to do this (S_DEVELOP).
4.3 Set Up Standard EWM Web Services
Following is now the full list of standard web services that are used in the YL solution.
• TransportationUnitAppointmentCheckInRequestConfirmation_In
• TransportationUnitAppointmentCheckOutRequestConfirmation_In
• TransportationUnitAppointmentExternalLockRequestConfirmation_In
• TransportationUnitAppointmentExternalUnlockRequestConfirmation_In
• TransportationUnitAppointmentCancelCheckInRequestConfirmation_In
• TransportationUnitAppointmentCancelCheckOutRequestConfirmation_In

16 © 2016 SAP SE or an SAP affiliate company. All rights reserved. Setup in SAP EWM
• VehicleAppointmentByElementsQueryResponse_In
• VehicleAppointmentCheckInRequestConfirmation_In
• VehicleAppointmentCheckOutRequestConfirmation_In
• VehicleAppointmentExternalLockRequestConfirmation_In
• VehicleAppointmentExternalUnlockRequestConfirmation_In
All of these web services should post changes in EWM system connected with Yard Logistics.
In Yard Logistics system for these service provider corresponding service consumers have been created. In order
to find them, please go to SE80 -> Enterprise Service Browser -> Packages->/SAPYL/INTERFACES -> Object
Types -> Service Consumers -> Objects:
4.3.1 Set up standard web services on EWM side
Please see an example how to set up connection for the standard web service.

Setup in SAP EWM © 2016 SAP SE or an SAP affiliate company. All rights reserved. 17
In order to find all the mentioned objects in EWM, please go to SE80 and select Enterprise Service Browser.
In the list of objects please go to Packages->/SCWM/BIF->Object Types->Service Providers->Objects
Double click on your service provider.

In our example we will use TransportationUnitAppointmentCheckInRequestConfirmation_In. Press button 'Start
SOA Manager':

Here we need to create a service. In the opened window of SOAManager press button 'Create Service'
Put any name of Service and Binding:
Press Next. In the appeared screen please select SSL for Transport Lever Security and User ID/Password for
Transport Channel Authentication:

Press Next. And in the next screen press Finish. A new service is created now.
Now press button 'Open Binding WSDL Generation'
Copy WSDL URL for Binding and save somewhere. It will be required later.

So with EWM part we're done.
4.3.2 Set up standard web services in SAP Yard Logistics
Now we should continue with Yard Logistics. Please find your service consumer relevant for your service provider
as described above at the beginning of this chapter.
In our example: TransportationUnitAppointmentCheckInRequestConfirmation_In

Go to SOA Manager:
In the appeared SOA Manager screen press Create-> WSDL Based Configuration:
In the next screen enter any Logical Port Name and Description:

Press Next.
In the appeared screen enter WSDL URL that was copied earlier, user that have authorization to access WSDL
(EWM user) and his password.
First choose the correct service, e.g. /SAPYL/CO_TU_CHECK_IN.
Press Next.
Press Next. In the screen table with the services depending on SOAP protocol is displayed. The first one is
selected by default. Press Next. Enter the same user and password:

Press Next -> Finish.
A new logical port is now created:
Next we should link EWM system, service consumer in Yard Logistics and logical port that is used for the service
and particular EWM system. In Yard Logistics go to NWBC->Settings->Integration to SAP EWM->Maintain Logical
Ports for EWM Integration:
Press New Entries and enter required information:

Press Save.
We're done. Web service for TU check in in EWM system now is connected with Yard Logistics.
4.4 Overview of New Web Services
To enable the communication between SAP YL and SAP EWM new web services (inbound and outbound) need to
be created in the EWM system that you want to link to the SAP YL system.
The following two new outbound web services need to be created in EWM:
• Door Arrival/Departure:
Create a service provider using WSDL file of the service consumer /SAPYL/CO_DOOR_ARR_DEPT (_-sapyl_-
door_arr_dep ). Also, you need to set up logical port for it.
In the YL system you need to create a new logical port for web service consumer
/SAPYL/CO_DOOR_ARR_DEPT (_-sapyl_-door_arr_dep ) with the new URL of web service provider.
• Query External TU
Create a service provider using WSDL file of the service consumer /SAPYL/CO_QUERY_EXT_TU_DATA (_-
sapyl_-query_ext_tu_data). In YL you need to create a new logical port for web service consumer
/SAPYL/CO_QUERY_EXT_TU_DATA (_-sapyl_-query_ext_tu_data) with the new URL of web service provider.
The following new inbound web service needs to be setup as consumer:
• Loading/Unloading Notification
A new web service /SAPYL/LOAD_UNLOAD_NOTIF_PRDCT has been created in the YL system. For this web
service provider a new service consumer needs to be created and set up on the EWM system. The name
should be e.g. /SAPYL/CO_LOAD_UNLOAD_NTF_PROD (Note! You could have a different name or different
prefix).
Create a new PPF action via SPPFCADM based on the existing one for application /SCWM/SHP_RCV; action
profile /SCWM/TU, action definition /SAPYL/YL_LOAD_UNLOAD_NOTIF (Note! You could have a different
name or different prefix)..
Also, copy schedule condition from class /SAPYL/CL_IM_SCH_LOAD_NOTIF, and copy the execution method
from class /SAPYL/CL_IM_LOAD_UNLOAD.
Note: it should be ensured that all coding is adjusted with the newly created/generated names so that objects
with the prefix /SAPYL/ are not used and for example are copied to custom-specific, i.e. that all @EWM TODO
lines insert your generated instance please.
See the following chapter for a detailed description.
4.4.1 Door Arrival/Door Departure
For this part you need to create a web service provider and set up a consumer web service. The web service is
used to post TU arrival at door or departure from door in an external EWM system.
Web Service Provider

4. In YL select service consumer /SAPYL/CO_DOOR_ARR_DEPT (_-sapyl_-door_arr_dep)
5. Save WSDL file:

6. Go to EWM system which should be connected with YL. Select required package and create Enterprise
service.
7. Select Service Provider ->External WSDL -> Local file -> Select the WSDL file that was saved in the step 2 ->
Specify name (e.g. door_arrival_departure) and prefix -> Select Package, request, prefix -> Complete
Prefix: In Yard Logistics prefix /SAPYL/ is used. In your external EWM system another prefix might be used.
This prefix should be specified during generation of the service provider.
Example: here prefix ZZZ is specified. You might have a different one.
8. Go to generated class:

Note! This is only an example. During creation of your own service provider you might have different names of the
generated objects.
Here you see generated interface name and a new implementing class. You can change the names of these
objects. Also you can check the name of the data types that should be created in the tab Name Problems and
rename them if required.
Activate service provider.
9. Next you should implement an existing method of the generated class. It is proposed to copy the logic from
function module /SAPYL/WS_DOOR_ARR_DEP (in YL) which you can find as an attachment.
Note! An authority check is implemented in this function module. You could skip it or use the standard
/SCWM/ACTI, for example. Also please make sure that you've created messages required in this
implementation in your message class. Texts of the messages are provided in the attachment for this
method.
10. Select required web service and press button SOA Manager:
11. A new window will open in a browser. Press ‘Create Service’ button:

12. Fill the data and press Next
13. Select the required options as in the screen below and press Next
14. In the next screen press Finish

15. A new service provider was created with the generated WSDL document. Press the button to navigate to the
created binding

16. Copy URL for binding. It will be used in the next steps:
Web Service Consumer

1. In Yard Logistics service consumer exists:

2. Press button ‘Create’ and ‘WSDL Based Configuration’
3. Put name and description of the logical port. Press Next

4. Enter WSDL URL from step above, user (which has required authorization to read data from EWM) and his
password
5. Press Next->Next. On Consumer Security step specify the same user and password:
6. Press Next-> Finish

7. Select you logical port. Press ‘Set log. Port Default’

4.4.2 Query External TU
The web service is used to query TU data from EWM system. The standard EWM web service for TU Querying
does not cover a query by license plate number, therefore a new one needs to be created.
For this part you also need to create a web service provider and set up a consumer web service.
Web Service Provider

1. In YL select service consumer /SAPYL/CO_ QUERY_EXT_TU_DATA (_-sapyl_- query_ext_tu_data) - relevant
for Release 2. There is a service consumer with a similar name /SAPYL/CO_ QUERY_EXTERNAL_TU which
was created for Release 1. Please make sure you use a correct one. Go to tab WSDL:
2. Save WSDL file:
3. Go to the EWM system. Select required package and create Enterprise service:

4. Select Service Provider ->External WSDL -> Local file -> Select the WSDL file that was saved in the step 2 ->
Specify name (e.g. query_ext_tu_data) and prefix -> Select Package, request, prefix -> Complete
Prefix: In Yard Logistics prefix /SAPYL/ is used. In your external EWM system another prefix might be used.
This prefix should be specified during generation of the service provider.
Example: here prefix ZZZ is specified. You might have a different one.
5. Go to generated class. Note! This is only an example. During creation of your own service provider you might
have different names of the generated objects.

Here you see generated interface name and a new implementing class. You can change the names of these
objects. Also you can check the names of the data types that will be created in the tab Name Problems and
rename them if required.
Activate service provider.
6. Next you should implement an existing method of the generated class. It is proposed to copy the logic from
function module /SAPYL/WS_QUERY_EXT_TU (is relevant for Release 2 in YL) which you can find as an
attachment.
Note! An authority check is implemented in this function module. You could skip it or use the standard
/SCWM/ACTI, for example. Also please make sure that you've created messages required in this
implementation in your message class. Texts of the messages are provided in the attachment for this
method.
.
7. Select required web service and press button SOA Manager:
8. A new window will open in a browser. Press ‘Create Service’ button:

9. Fill the data and press Next
10. Select the required options as in the screen below and press Next
11. In the next screen press Finish

12. A new service provider was created with the generated WSDL document. Press the button to navigate to the
created binding:
13. Copy URL for binding. It will be used in the next steps:

Web Service Consumer
1. In Yard Logistics the following service consumer exists:
2. Press button ‘Create’ and ‘WSDL Based Configuration’

3. Put name and description of the logical port. Press Next
4. Enter WSDL URL from step above, user (which has required authorization) and password

6. Press Next-> Finish
7. Select you logical port. Press ‘Set log. Port Default’
4.4.3 Loading/Unloading Notification
In Yard Logistics system go to service definition /SAPYL/LOAD_UNLOAD_NOTIF_PROD relevant for Release 2.

There is also another service definition with similar name /SAPYL/LOAD_UNLOAD_NOTIFICAT which is relevant
for Release 1. Make sure you’ve selected a correct one.
Download WSDL file for the service definition:

Go to SOAMANAGER and create a new service repeating the steps mentioned, for service providers in previous
steps, e.g. service provider for QUERY_EXT_TU_DATA:
Figure 5: SOA Configuration

The marked button shows you the way to the popup to get the relevant URL:
Figure 6: URL for binding

Now copy the URL for this binding, it will be used in the following steps.
The following steps describe the setup of the consumer web service.
1. Go to the EWM system which should. In SE80 select the package and press Create->Enterprise Service:

Figure 7: Enterprise Service Creation
2. Select ‘Service Consumer’ on the next popup and press "Continue"
3. Select ‘External WSDL/Schema’ on the next popup and press "Continue"
4. Select ‘Local file’ on the next popup and press "Continue". On this popup please select WSDL file that was
saved in the previous step:
Figure 8: Re-use URL from binding

5. Select transport request, prefix and press "Finish".

6. A new service consumer will be generated (Note! the figure below as an example; in your system adapt to
your naming conventions and customer code)
Figure 9: Generated Web Service Consumer

7. Press (marked) button ‘Create’ and select menu item ‘WSDL Based Configuration’
8. Put the name and description of the logical port. Press "Next"
9. Enter WSDL URL from the binding, add user (which has required authorization) and password
Figure 10: WSDL location


Figure 11: Consumer security
11. Press "Next"-> "Finish"
12. Select your logical port. Press ‘Set log. Port Default’
Figure 12: Set default logical port

Congrats! Now you're done with the setup of the consumer web service!
As next step you need to create the PPF action triggering the web service call for you. To do so, navigate to
transaction SPPFCADM in your EWM warehousing system.
1. In EWM create a new PPF action, e.g. ZEWM_ YL_LOAD_UNLOAD_NOTIF based on the template. Go to
application /SCWM/SHP_RCV, action profile /SCWM/TU, and copy all settings from the action
/SAPYL/YL_LOAD_UNLOAD_NOTIF created in Yard Logistics.
Note! In all the objects that you'll create use your prefix, please. In the screenshots below the objects are
created with the prefix /SAPYL/ which is not relevant for your EWM implementation.

2. In the tab Processing Details you'll need to provide a new filter value for BAdI e.g. ZEWM_TU_LOAD_UNLOAD,
Create your own BAdI Implementation and implementing class for execution . Copy implementation logic
from Yard Logistics, class /SAPYL/CL_IM_LOAD_UNLOAD and replace @EWM TODO with the generated
objects: service consumer implementing class from point 6 above, input structure of the generated method
of this class, etc.

3. Also create your own schedule condition (copy the sample condition from YL, see next figure)
Figure 13; Schedule condition template

Note: it should be ensured that all coding is adjusted with the newly created/generated names.
• Verify schedule condition
• Verify execution method

5 Technical Overview
For the outbound messages a qRFC function modules are used as overall guiding principle to be able to re-
process the failed queue to trigger a web service. The queue is defined as a concatenation of external EWM
warehouse and TU external number.
Moreover, after calling the qRFC a centrally defined BADI (/SAPYL/SUBSYST_CALL) has been provided for EWM
web service call. The yard number will be used as a filter to define the web service to be called. For SAP EWM
warehousing we have defined a sample BADI implementation.
All outbound interfaces are assumed to be called synchronously to update the relevant business documents in a
timely manner.
All outbound web services are called from qRFC function modules that are defined within the function group
/SAPYL/EWM_RFC.
All web service calls are wrapped into a BAdI /SAPYL/SUBSYST_CALL having the interface
/SAPYL/IF_SUBSYST_CALL and it contains methods for all used outbound web services:
• CHECK_IN ( TU/Vehicle Check-In)
• CHECK_OUT ( TU/Vehicle Check-Out)
• DOOR_DETERMINATION ( TU Door determination)
• DOOR_ARR_DEP (TU Arrival/Departure at door)
• CANCEL_CHECK_IN ( TU/Vehicle Check-In cancellation)
• CANCEL_CHECK_OUT (TU/Vehicle Check-out cancellation)
A fallback class /SAPYL/CL_FB_IM_SUBSYST_CALL is implemented and contains logic for all mentioned web
services.
5.1 Check-In
Check-In action is triggered within qRFC FM /SAPYL/EWM_RFC_CHECK_IN.

To determine whether this qRFC should be triggered, within actions of BO Yard Order, warehouse visits assigned
to Yard Order Item are checked. If there is no warehouse visits - it is not relevant for EWM integration.
Logic for TU Check-

In
Check that warehouse visit is maintained
Select EWM checkpoint
Call BAdI for Check-In
Figure 14: High-level diagram for logic of Check-In

Technical Overview © 2016 SAP SE or an SAP affiliate company. All rights reserved. 43
The following flow diagram describes usage of web services for TU check-in.
Is Yard integrated with TM?

Yes N
o
Check TU LDAP_code
AVR PVR TUR

Query TU by external
Query Vehicle by Query TU by license Query TU by external
number
license plate number plate number number
(/SAPYL/QUERY_EX
(/SCWM/II_BIF_YRD (/SAPYL/QUERY_EX (/SAPYL/QUERY_EX
T_TU_DATA)
_VAPP_QR) T_TU_DATA) T_TU_DATA)
Query Vehicle by Is TU assigned to Vehicle?

license plate number
(/SCWM/II_BIF_YRD
_VAPP_QR) Yes N
o
Lock Vehicle Lock TU

TU will be checked-in
(/SCWM/II_BIF_YRD (/SCWM/II_BIF_YRD
_VAPP_LOCK_RC) as part of vehicle _TAPP_LOCK_RC)
Check-In Vehicle Check-In TU

_VAPP_CHIN_RC) _TAPP_CHIN_RC)
Unlock Vehicle Unlock TU

_VAPP_ULOCK_RC) _TAPP_ULOCK_RC)
Figure 15. Flow diagram: usage of web services during TU Check-In
5.2 Check-Out
Check-Out action is triggered within qRFC FM /SAPYL/EWM_RFC_CHECK_OUT.

44 © 2016 SAP SE or an SAP affiliate company. All rights reserved. Technical Overview
Flow logic of usage of web services for TU check-out is almost the same as in the Figure 17 except 2 web services:
• Check-Out Vehicle: /SCWM/II_BIF_YRD_VAPP_CHOUT_RC
• Check-Out TU: /SCWM/II_BIF_YRD_TAPP_CHOUT_RC
5.3 Reverse Check-In
Reverse Check-In action is triggered within qRFC FM /SAPYL/EWM_RFC_RVRS_CHECK_IN.

Flow logic of usage of web services for TU reverse check-in is almost the same as in the Figure 17 except 2 web
services:
• Reverse Check-In Vehicle: /SCWM/II_BIF_YRD_VAPP_CAIN_RC
• Reverse Check-In TU: /SCWM/II_BIF_YRD_TAPP_CAIN_RC
5.4 Reverse Check-Out
Reverse Check-Out action is triggered within qRFC FM /SAPYL/EWM_RFC_RVRS_CHECK_OUT.

Flow logic of usage of web services for TU reverse check-out is almost the same as in the Figure 17 except 2 web
services:
• Reverse Check-In Vehicle: /SCWM/II_BIF_YRD_VAPP_CAOUT_RC
• Reverse Check-In TU: /SCWM/II_BIF_YRD_TAPP_CAOUT_RC
5.5 Door Determination
A door is determined during saving of a pending yard task. Therefore qRFC /SAPYL/EWM_RFC_DOOR_DETERM
is triggered on the level of Yard Task BO:
To determine whether this qRFC should be triggered, it is checked whether activity type is marked as 'Relevant for
subsystem determination' and if warehouse visits are assigned to Yard Task Item Transportation Unit.

Flow diagram below describes logic of BAdI implementation for door determination and usage of web services:

Yes No
Query TU by license Query TU by external

plate number number
(/SAPYL/QUERY_EX (/SAPYL/QUERY_EX
T_TU_DATA) T_TU_DATA)
Read destination bin for yard task by the determined EWM

door
Figure 17: Flow diagram: usage of web services during door determination
5.6 Door arrival/departure
Door arrival/departure will be called at yard task confirmation. Corresponding qRFC FMs
/SAPYL/EWM_RFC_DOOR_ARRIVAL and /SAPYL/EWM_RFC_DOOR_DEPARTURE are triggered at the level of
the corresponding BO Yard Task. Check if warehouse visit is maintained for
Yard Task Item's Transportation Unit
To determine whether qRFC FM should be triggered in the action of BO Yard Task warehouse area assignment of
source and destination storage type are checked. If source storage type is linked with warehouse are - qRFC for
departure from door should be triggered, if destination bin is mapped to warehouse area – qRFC for arrival at door
will be triggered. Moreover for door arrival activity type is checked. If it is marked as 'Relevant for subsystem' -
qRFC for arrival at door will be triggered.
In order to post TU arrival/departure a new web service was created: /SAPYL/DOOR_ARR_DEP.
Logic for Door Determination
Check that yard task status is ‘Pending’
Check that activity type is marked as

‘Relevant for subsystem’
Call BAdI for Door Determination
Update Yard Task with the new destination

bin
Figure 16. High-level diagram for logic for TU Door determination

Logic for Door
Arrival/Departure
Check assignment of source/destination
storage types to warehouse area
Check that activity type is relevant for

subsystem determination (for door arrival
only)
Call BAdI for Door Arrival/Departure
If Arrival at Door posted -> update BO TU

flag ‘In process by subsystem’

Yes No
Query TU by license Query TU by external

plate number number
(/SAPYL/QUERY_EX (/SAPYL/QUERY_EX
T_TU_DATA) T_TU_DATA)
Lock TU (/SCWM/II_BIF_YRD_TAPP_LOCK_RC)
Send Door Arrival/Departure (/SAPYL/DOOR_ARR_DEP)
Unlock TU (/SCWM/II_BIF_YRD_TAPP_ULOCK_RC)
Figure 19: Flow diagram: usage of web services in door arrival/departure

Figure 18: High-level diagram for logic of Door Arrival/Departure
The flow diagram above describes logic of BAdI implementation for door determination and usage of web
services:

When arrival at door is posted in EWM – a flag ‘In process by subsystem’ is updated in BO TU. If this flag is
switched on – Yard Tasks having this to TU in the items cannot be processed until loading/unloading will be
posted in EWM. This is described in the next chapter.
5.7 Loading/Unloading Notification
This is an inbound web service and is triggered from external EWM system.
The PPF is done on EWM TU level and triggers a new web service /SAPYL/LOAD_UNLOAD_NOTIF_PRDCT.
Here another important standard customizing which is used to check at what action a message should be sent. It
can be found under the IMG transaction SPRO. Navigate to SCM Extended Warehouse Management -> Extended
Warehouse Management -> Interfaces-> Enterprise Services -> Yard Management -> Sender Relevance of
Messages for Vehicles and TUs.

This customizing is checked in the schedule condition for PPF for Loading/Unloading Notification on statuses
‘Unloading Completed’ and ‘Loading Completed’.
Read yard by EWM warehouse and EWM system
Freight Order is assigned to

Yes TU? No
Get BO TU by license Get BO TU by external

plate number and number
country
Update BO TU with new loading weight, UOM, products and

flag ‘In process by subsystem
Get first pending Yard Tasks of this TU with the earliest plan
start date
Get all TU of this Yard Task and check that for all of them
loading/unloading is finished by checking flag ‘TU empty’
Activate the Yard Task
Figure 20: Flow diagram for Loading/Unloading Notification

www.sap.com/contactsap
© 2016 SAP SE or an SAP affiliate company. All rights reserved.
No part of this publication may be reproduced or transmitted in any
form or for any purpose without the express permission of SAP SE
or an SAP affiliate company.
SAP and other SAP products and services mentioned herein as well
as their respective logos are trademarks or registered trademarks of
SAP SE (or an SAP affiliate company) in Germany and other
countries. All other product and service names mentioned are the
trademarks of their respective companies. Please see http://www.
sap.com/corporate-en/legal/copyright/index.epx#trademark for
additional trademark information and notices.
Material Number:

HowToGuide YL EWM Integration R2 V1.5m

Uploaded by

Document Informationclick to expand document information

Document Informationclick to expand document information

Copyright:

Available Formats

HowToGuide YL EWM Integration R2 V1.5m

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

HowToGuide YL EWM Integration R2 V1.5m

Uploaded by

Copyright:

Available Formats

How-To-Guide CUSTOMER

SAP Yard Logistics

SAP YL and SAP EWM Integration

Type Style Description

Example Emphasized words or expressions.

EXAMPLE Keys on the keyboard, for example, F 2 or E N T E R .

CUSTOMER SAP YL and SAP EWM Integration

Version Date Change

1.0 11-02-2016 Initial creation

1.1 24-10-2016 Update for Release 2

1.2 04-04-2017 Update

1.3 07-08-2017 Update

1.4 21-08-2017 Update after Review

1.5 04-09-2017 Update after Review

SAP YL and SAP EWM Integration CUSTOMER

1 Getting Started .............................................................................................................................. 6

3 Setup in SAP YL........................................................................................................................... 12

4 Setup in SAP EWM ...................................................................................................................... 16

5 Technical Overview .....................................................................................................................43

CUSTOMER SAP YL and SAP EWM Integration

1.1 About this Guide

1.2 Related Document

Document Title Link Comment

1.3 Important SAP Notes

Important SAP Notes

SAP Note Implementation Comment

2193981 YL, EWM Update of TE and VEH Methods in /SCWM/CL_BIF_YRD

2233793 YL, EWM Corrections for

2267111 YL, EWM Corrections for

2265646 EWM Departure from checkpoint: GI not posted for TU container

CUSTOMER SAP YL and SAP EWM Integration

2.1 Process view

SAP YL and SAP EWM Integration CUSTOMER

Integation SAP YL – SAP EWM

Check in Checkpoint Arrival

Door Arrival Arrival at Door

Door Departure Departure from Door

Check out Checkpoint Departure

Figure 1: SAP YL - SAP EWM integration

CUSTOMER SAP YL and SAP EWM Integration

2.2.1 Scenario 1 - Vehicle and Container Hierarchies in

Action/Queue Vehicle Container

SAP YL and SAP EWM Integration CUSTOMER

2.2.2 Scenario 2 - Vehicle and Container Hierarchies in

CUSTOMER SAP YL and SAP EWM Integration

SAP YL and SAP EWM Integration CUSTOMER

3.1 General Settings

3.1.1 Assign EWM Warehousing to a Yard Number

Yard No EWM business system EWM WhNo EWM warehouse ID

CR01 XYM_200 TRCK XYM200_TRCK

CR01 XYN_300 W001 XYM300_W001

TRCK XYN_300 IK01 XYN300_IK01

Table 1: Assign EWM Business Systems and Warehouses to Yard (Example)

3.1.2 Mapping of YL storage bins to EWM doors and

Yard No Storage bin EWM Warehouse ID EWM Dr/Ch

TRCK XYN300_IK01_D001 XYN300_IK01 D001

TRCK XYN300_W001_DI01 XYN300_W001 DI01

TRCK XYN300_W001_DO01 XYN300_W001 DOR1