High- Level Specification

Functional Overview

The functional design of the enhancements describes the scenario(s) where enhancements to existing SAP programs are required.

Allocate Batch 

Outbound Delivery creation will be happened through Manual/background job, which will be run periodically. At the time of outbound delivery creation, system will try to allocate the batch based on the predefined rules

and distribution from S/4HANA to EWM is triggered when saving the delivery. 

Enhancement to Check Distribute Outbound Delivery:

Once all the line item have been allocated batches in outbound delivery then allow to distribute the outbound delivery to EWM for those only relevant for deliveries with storage locations active for EWM

.

Note: the distribution is for the whole outbound delivery, not for the individual delivery item.

Scope and Objectives

Objective
To Implement an automated check during Outbound Delivery processing that inspects all line items. When saving an outbound delivery, if any item is for a batch‑managed material and the batch field is empty, the system must prevent distribution to EWM (no ODO created; distribution status remains Relevant/Planned).

• In scope: Outbound deliveries relevant to Embedded EWM
• Out of scope: Other delivery (Inbound deliveries, IM outbound deliveries, return deliveries..etc).

Image Added

Assumptions

& Dependencies

• Materials that participate are batch‑managed (MARA-XCHPF = 'X').
• Plants/storage locations are EWM‑relevant (/SCWM/TMAPSTLOC - mapped to EWM based on Plant/SLOC standard integration active).

Security, Integrity and Controls

• BADI implementation class must be transportable and accessible in the Private Cloud tenant.
• No special end‑user auth needed beyond standard LE/EWM authorizations.

Configuration Requirements

Not Applicable

Language Requirements

Not Applicable

Special Requirements

Not Applicable

Design Rationale

Functional Requirements

Proposed Technology to Use

When saving an outbound delivery (Document Category 'J'), if any line items (include Batch Spilt line also) Storage Location is relevant EWM and a batch‑managed material and the batch field is empty, 
the system must prevent distribution to EWM (no ODO created; distribution status remains Relevant/Planned).

Note: For batch split, the main item’s batch is expected to be blank; validate each batch split subitem instead.

• Enhancement Spot: ES_LE_SHP_EXTEND
• BADI: LE_SHP_CHECK_DISTRIBUTION
• Interface: IF_LE_SHP_CHECK_DISTRIBUTION
• Method: CHECK_DISTRIBUTION (parameters include DELIVERY_DOCUMENT_IN, DELIVERY_DOCUMENT_ITEMS_IN, MESSAGES, DISTRIBUTION_NOT_ALLOWED_OUT). 

Data Source 

Data Source

Considerations

Table	Field Name	Comments/Calculation/Field Manipulation
LIKP	VBTYP	delivery Header (Document Category)
LIPS	MATNR	delivery items (Material)
LIPS	CHARG	delivery items (Batch)
LIPS	WERKS	delivery items (Plant)
LIPS	LGORT	delivery items (Storage Location)
MARA	XCHPF	Material Master (Batch Management Indicator)

Data Validation Considerations

Custom Tables

Not Applicable

Master Data

Configuration Table

Selection Screen Enhancement

Processing Logic

To apply the following Logic at METHOD (CHECK_DISTRIBUTION) in interface (IF_LE_SHP_CHECK_DISTRIBUTION) 

1) To check the Scope to Outbound Delivery only based on Document Category (J) of Delivery. If LIKP-VBTYP <> 'J" then RETURN. otherwise continue

  
 2) Loop all items of delivery to check EWM Relevant and batch-managed material based on Plant & Storage Location combination and Material master Batch Management Indicator (MARA-XCHPF)  
  
    If  batch-managed material (MARA-XCHPF) = "X" then check Batch not allocated  in Delivery item.

    If it is not allocated then update Block distribution as TRUE otherwise FALSE 

3) If there is Block distribution as TRUE then

    Update DISTRIBUTION_NOT_ALLOWED_OUT = TRUE

                 MESSAGE =  "Batch missing on at least one batch-managed item; distribution to EWM blocked" with MSGID="VL' MSGNO = '000' MSGTY = 'E'.  
    
  

Volumetrics

Not Applicable

Performance Considerations

• Use in-memory item tables where possible.
• Single SELECT for MARA-XCHPF with FOR ALL ENTRIES.
• Early exit as soon as one batch is found.

Error Handling

• Info message : “Batch missing on at least one batch-managed item; distribution to EWM blocked”
• No hard error: Do not block save unless explicitly required.
• Logging: Add to application log (BAL) with object LE and sub object DELIVERY.

Testing

How to Test

Create Outbound Deliveries (manual or via background jobs) with multiple line items, driven by EWM-relevant storage locations, supporting both Batch-Managed and Non-Batch-Managed materials.

Note: EWM distribution is applicable only when the Storage Location is EWM-relevant.

Test Conditions and Expected Results

Test Considerations/Dependencies

Other Information

Development Details

Package

Enhancement Implementation

Other Development Objects

Appendix

Custom Authorization Group Naming Convention

This table is based on the Syensqo development standards document. It provides the naming conventions for authorization groups to associated with custom reports and tables to comply with security requirements.

See also

Change log