Show TOC

Function documentationDirect Integration with SAP Extended Warehouse Management Locate this document in the navigation structure

 

You can integrate SAP Transportation Management (SAP TM) with SAP Extended Warehouse Management (SAP EWM).

Prerequisites

  • You have configured the following settings in your freight order type:

    • In the Document Creation Relevance field, you have specified that transportation activities are to be created in SAP EWM.

    • You have specified an output profile that contains actions for sending LoadingAppointment messages, for example, /SCMTMS/TOR.

    For more information, see Customizing for Transportation Management under   Freight Order Management   Freight Order   Define Freight Order Types  .

  • SAP provides the following, predefined event codes for cancelations as well as the corresponding event reason codes:

    Event Code

    Name

    Event Reason Code

    Name

    CANCEL_EXEC_DOC

    Cancel Execution Document

    CANCELLED_BY_CARRIER

    Canceled by Carrier

    CANCEL_STATUS_RESET

    Cancel and Reset Cargo Execution Status

    TM_PLAN_NOT_READY

    TM Planning Not Yet Ready

    CANCEL_UNASSIGN_FUS

    Cancel and Unassign FUs of Current Stop

    STOP_CANCELLED

    Loading Appointment Canceled

    These event codes are set as the default codes.

    You can define your own event codes and event reason codes. For each event type, you must specify at least one of your event codes as the default code.

    For more information, see Customizing for Transportation Management under   Basic Functions   General Settings   Define Event Reason Codes  .

  • If you want to work with trailers, you have configured the following settings in your transportation unit type:

    • In the Document Creation Relevance field, you have specified that transportation activities are to be created in SAP EWM.

    • You have specified an output profile that contains actions for sending LoadingAppointment messages, for example, /SCMTMS/TOR.

    For more information, see Customizing for Transportation Management under   Freight Order Management   Transportation Unit   Define Transportation Unit Types  .

Features

The following processes are supported as part of direct integration of SAP TM with SAP EWM:

Note Note

  • Deliveries to a transportation stop that originate from warehouses with different warehouse numbers are not supported by direct integration of SAP TM with SAP EWM. It is not relevant whether the warehouse numbers are from the same SAP EWM system or from different SAP EWM systems.

    For more information about the supported functions and the restrictions, see SAP Note 1984252.

  • When you define the freight unit building rule for delivery-based transportation requirements (DTR), make sure that freight units are not split for a DTR item. If a DTR item is split into two or more freight units, an error occurs when the transportation unit is generated in SAP EWM.

    Example Example

    You have defined a freight unit building rule with a split quantity of 1,500 kg. If you have a DTR item that weighs 2,000 kg, SAP TM creates two freight units: one freight unit with 1,500 kg and another with the remaining quantity of 500 kg. If a LoadingAppointment message is then sent to SAP EWM as part of the integration, the request cannot be executed correctly.

    End of the example.
End of the note.
Displaying Data

The warehouse numbers from SAP EWM are displayed in the following locations:

  • Delivery-based transportation requirement: Locations and Dates/Times tab page

  • Freight order:   Overview   Stop   tab page

Changing Data

If you change the following data in SAP EWM, your changes are automatically replicated to SAP TM:

  • Carrier

  • Planned departure time and arrival time

  • Gross weight of the vehicle

  • Packaging material

Actual quantities from SAP EWM are automatically transferred to SAP TM. If the actual quantities and planned quantities differ, the system creates a discrepancy in SAP TM. For more information see Discrepancies and Events.

Actual dates are also reported automatically to SAP TM.

If you reassign a complete delivery in SAP EWM from one transportation unit to another, SAP EWM reports the reassignment to SAP TM. In SAP TM, the delivery is automatically reassigned from the original freight order to the associated freight order.

If you assign a freight unit to a transportation unit in SAP EWM but the freight unit is not assigned to a freight order in SAP TM, this information is also transferred to SAP TM. The system then automatically assigns the freight unit to the corresponding freight order.

Updating Data

If you set the cargo execution status Cargo Ready for Loading for your freight order, the system automatically triggers the event Ready for Loading. The system transfers the event to the predecessor document (that is, the freight unit) and changes its status to Cargo Ready for Loading. When building the freight unit, the system checks whether this status has been set. If so, the freight unit is no longer updated from SAP ERP but from SAP EWM.

The same applies for the cargo execution status Cargo Ready for Unloading and the event Ready for Unloading.

If SAP TM receives the LoadingAppointmentNotfication message during outbound-delivery-based transportation planning, the cargo receipt status for the item is automatically set to Shipped. If the item in question is to be unloaded at the next transportation stop, the handling execution status is automatically set to Not Unloaded. In the associated freight unit, the cargo receipt status is also set automatically to Shipped. As a result, the freight unit is no longer updated from the forwarding order or the delivery-based transportation requirement.

Canceling Documents
Cancelations in SAP TM

After the freight order has been created but before the loading or unloading instructions have been sent to SAP EWM, you can cancel the freight order in SAP TM without impacting SAP EWM. The cargo execution status of the container or the main item in the freight order is a decisive factor. You can cancel the freight order in SAP TM provided that you have not set the cargo execution status to Cargo Ready for Loading or Cargo Ready for Unloading. If you have set either of these statuses, you cannot cancel the freight order in SAP TM. To cancel the freight order in SAP TM, you must wait for confirmation from SAP EWM.

Cancelations in SAP EWM

If the loading or unloading instructions have already been sent to SAP EWM, you can cancel the associated transportation unit only in SAP EWM. This can affect the freight order in SAP TM in different ways, that is, the freight order is either canceled or retained. If the freight order is retained, the following options arise:

  • Only the cargo execution status is reset; the assignment of the freight units is retained for the current transportation stop. This is important if you have accidentally changed the status and want to reset it.

  • The cargo execution status is reset and the assignment of the freight units is removed for the current transportation stop. You can then assign these freight units to another execution document.

The impact on the freight order and associated freight units depends on the following information:

  • Event codes for the cancelation and the associated event reason codes that you have defined in Customizing (see the prerequisites above)

  • Event reason that is sent with the confirmation from SAP EWM to SAP TM once a cancelation has taken place in SAP EWM

More Information

Delivery Split

Batch Split