Show TOC

 Change Transportation Planning View Based on Delivery Confirmation

Definition

To react to the receipt of a confirmation of the creation of an inbound delivery.

Technical Data

Entity Type

Service Operation

Release State

Released

Technical Name

InboundDeliveryConfirmation_In_V1

Namespace

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

Application Component

TM-ERP-TR-DLV

Category

SAP A2A

Direction

Inbound

Mode

Asynchronous

Idempotency

No

Change/Update Behavior

Not Applicable

P2P Communication Enabled

Yes

Business Context and Use

A shipper uses a transportation management system to carry out transportation planning and execution for orders created in a logistics execution system (for example, purchase orders and returns orders). When the logistics execution system creates an inbound delivery based on a delivery proposal received from the transportation management system, it sends a confirmation of delivery creation (for example, using the Confirm Inbound Delivery outbound operation). The Change Transportation Planning View based on Delivery Confirmation  inbound operation receives the confirmation and updates the required data in the transportation management system.

Related Operations

Features

The Change Transportation Planning View Based on Delivery Confirmation  inbound operation receives the following details:

  • Information about the deliveries that were successfully created. The operation adds the total number of deliveries and the IDs of the deliveries to the business application log.

  • Log items with information about delivery creation (for example, an error message that explains why a particular delivery could not be created). The operation adds the log items to the business application log.

  • Processing result code (successful or unsuccessful) that relates to all log items sent in a message. The operation updates the processing result code and sets a confirmation timestamp in the freight units that are related to the delivery confirmation.

Note that the Change Transportation Planning View Based on Delivery Confirmation  inbound operation does not change an instance of a Transportation Planning View  business object (this is a transient business object that is not persisted in the database).

Error Handling

The Change Transportation Planning View Based on Delivery Confirmation  operation supports Forward Error Handling. The following error categories are used:

  • PRE.TEE.LRE: Lock Error

  • DCE: Conversion Error

  • PRE: Processing Error

For more information about the individual error categories, see the code list for the global data type LogItemCategoryCode.

Message Types

  • InboundDeliveryConfirmation_V1

Notes on SAP Implementation

Integration

You can use this operation and the related operations to integrate SAP ERP with SAP Transportation Management (SAP TM). For more information, see the documentation of the Transportation Planning View business object.

To determine whether a response has been received from SAP ERP for freight units that are related to an order-based transportation requirement (OTR) and that contain a timestamp for sending a delivery proposal, the monitoring process in SAP TM uses the confirmation timestamp that is set by this operation.  For more information, see Monitoring of Delivery Creation.

Note that if the processing result code sent by SAP ERP  is Unsuccessful, the SAP TM system raises an alert of category TMS_OI_DLV_CREATION_PROBLEM.

Enhancements

The BAdI for InboundDeliveryConfirmation_In_V1 (/SCMTMS/CPX_SE_IDLV_CNF1) Business Add-In (BAdI) is available for this operation.