Setting Up Delivery Document Integration

Objective

After completing this lesson, you will be able to set up delivery document integration

Delivery Document Integration

It is important to understand the basic SAP EWM integration settings for delivery documents.

The following figure provides an overview of the functions supported by the SAP EWM and SAP ERP interface:

Shows the Delivery Document Process Flow and functions supported by the ERP and EWM systems

The delivery document is normally created in the SAP ERP system (Logistics Execution (LE) delivery), but it can originate in the SAP EWM system, for example, in the case of a direct outbound delivery order or in a kit-to-stock process. Certain changes to delivery documents can happen in the SAP ERP system after the distribution. A changed advanced shipping notice (ASN) from a vendor, for example, can cause inbound delivery changes to be copied from the SAP ERP system to the SAP EWM system.

When EWM is connected to an SAP S/4HANA system, certain fields in LE deliveries can still be changed depending on the processing status in SAP EWM. Furthermore, embedded EWM offers the option for changes in the LE delivery.

Changes can always be done from the EWM side. A pick denial in an SAP EWM can result in delivery changes from the SAP EWM system to the SAP ERP system. Delivery splits in SAP EWM can also result in delivery document data to exchange between the SAP EWM system and the SAP ERP system. Another example is sending confirmations of deliveries from EWM for follow-on functions in SAP ERP (for example, goods receipt or goods issue).

General SAP EWM Delivery Document Control

The EWM delivery document contains all the data required to document and control a business process. Various documents are used in delivery processing to control the processes.

A document comprises a document header and any number of document items. This structure is illustrated in the following figure.

EWM Delivery Document Structure with Header and Items examples

Document Header

General data and data that is relevant for inbound and outbound delivery documents, posting changes, and internal stock transfers is contained in the delivery header. This data is valid for the entire document and includes:

  • Goods receiving office or shipping office

  • Scheduling data (for example, shipping or delivery date)

  • Weights and volumes for the complete delivery

  • Ship-from party, sold-to party, and goods recipient numbers

Document Item

In the delivery document, items contain information related to individual products within the delivery.

The following are examples of item-related information:

  • Product/material number

  • Delivery quantity

  • Weight and volume for item

  • Location-related information such as goods receiving point or unloading point

  • Dates such as goods receipt or picking date

  • Tolerances for over and under delivery quantities

Document and Item - Category and Type

The document header and the document item are defined in the EWM system by using a combination of document / item category and document / item type. Document and item categories are predefined in the system and can not be changed, but a customer can define the required document and item types.

Illustrates example table with Header, Items and related of Document and Item categories and type

EWM Document Category

The document category classifies the different documents that can be processed by the system in delivery processing.

Shows key Document Categories in Delivery Processing

Note

The above figure only shows the most important document categories.

The category defines in which business process a document can be used, which customizing settings are possible, and with which transaction the document can be processed.

Some details for the different document categories are described here:

  • IDR (Inbound Delivery Notification) and PDI (Inbound Delivery):

    These documents are used during the inbound process. The IDR is created through a message received from the ERP system and triggers a PPF action to create the follow-up document, the PDI. In an SAP S/4HANA embedded EWM the IDR does not exist anymore, the PDI is created immediately. In a decentralized EWM (9.5 or based on SAP S/4HANA) the IDR can be skipped.

    By using an Expected Goods Receipt document (details are below) the PDI can also be created directly in EWM, without a IDR. The PDI can then create an inbound delivery in ERP or only create a material document, depending on the scenario and customizing settings.

  • ODR (Outbound Delivery Request), PDO (Outbound Delivery Order) and FDO (Outbound Delivery):

    These documents are used during the outbound process. The ODR is created through a message received from the ERP system and triggers a PPF action to create the follow-up document, the PDO. In an SAP S/4HANA embedded EWM the ODR does not exist anymore, the PDO is created immediately. In a decentralized EWM (9.5 or based on SAP S/4HANA) the ODR can be skipped.

    The PDO can also be created directly in EWM, this is then called a direct outbound delivery order. This PDO then also creates an outbound delivery in ERP.

    For the goods issue posting in EWM and to communicate any delivery split, it is necessary to create the FDO.

  • POR (Posting Change Request) and SPC (Posting Change):

    These documents are used during a posting change process. The POR is created through a message received from the ERP system and triggers a PPF action to create the follow-up document, the SPC. In an SAP S/4HANA embedded EWM the POR does not exist anymore, the SPC is created immediately. In a decentralized EWM (9.5 or based on SAP S/4HANA) the POR can be skipped.

    The SPC can be created directly in EWM to trigger a posting change.

  • WMR (Stock Transfer):

    The WMR can only be created directly in EWM. It is used to plan a warehouse internal physical movement.

    Note

    As an exception in embedded EWM a Just-in-Time (JIT) call can directly create a WMR.

Besides the above listed document categories, some other, more specialized, document categories exist:

  • GRN (Expected Goods Receipt Notification) and EGR (Expected Goods Receipt):

    The expected goods receipt process is a planning process to enable warehouse managers to get an overview about the planned inbound workload. The EGR can then be used to create a PDI, which is then further processed in the warehouse.

    The GRN is created through a program either in ERP or in EWM and triggers a PPF action to create the follow-up document, the EGR. In a decentralized EWM 9.5 or based on SAP S/4HANA the GRN can be skipped.

    In SAP S/4HANA embedded EWM, neither the GRN nor the EGR exists. The process steps based on these documents (inbound workload overview or creation of the PDI in EWM) are still possible, they simply don't require these documents.

  • PWR (Production Material Request):

    The PWR is created in EWM for a manufacturing order in ERP when the advanced production integration is used. There is no delivery in ERP and there is no other interim document in EWM.

Warehouse Request

A PDI (Inbound Delivery), PDO (Outbound Delivery Order), SPC (Posting Change) and WMR (Stock Transfer) are all Warehouse Requests. This is the generic term for a delivery document in EWM that enables the processing warehouse activities for a specific product. These activities can be warehouse tasks (for physical movements or posting changes) or goods receipt / goods issue postings.

EWM Document Type

The EWM document type classifies a document with regard to the primary business use of the document.

The following figure lists examples of EWM document types:

EWM Document Types

Doc. TypeDescription
INBInbound Delivery
INBIInbound Delivery, production
OUTBOutbound Delivery
SREAWarehouse Reorganization
SRPLReplenishment
SWHIStock Transfer
TWPRPosting Change

EWM Delivery Documents

In EWM a delivery document is always a combination of a document category and a document type. Examples for EWM delivery documents and their respective document type and document category are listed in the following figure:

EWM Delivery Documents

Doc. TypeDoc. Cat.Description
INBIDRInbound Delivery Notification
INBPDIInbound Delivery
OUTBODROutbound Delivery Request
OUTBPDOOutbound Delivery Order
OUTBFDOOutbound Delivery
SRPLWMRReplenishment
SWHIWMRStock Transfer
TWPRPORPosting Change Request
TWPRSPCPosting Change

Each combination of document type and document category in the table represents a document in an EWM business process. You can create your own document types in each process configuration, such as goods receipt, goods issue, stock transfers, and posting changes.

As there are less document categories in SAP S/4HANA embedded EWM, there are less combinations accordingly.

SAP supplies these above listed and several other document types as default customizing or via Business Configuration Sets and recommends to use these delivery documents as they are or as templates for defining your own document types.

EWM Item Categories and Item Types

Each delivery document item is identified by the following:

  • An item type
  • The document type of the delivery document in which it appears
  • The item category, which classifies the delivery item by its basic use

The following table lists the item categories:

Item Categories

Item CategoryDescription
DLVStandard Delivery Item
PACPacking item
RETReturns Item
TXTText Item
VALValue Item (used only in outbound delivery processing)

Delivery item types classify the items for a document type for the complete business process. The item type defines the business characteristics of the item in a delivery document.

The following table lists examples of item types.

Item Types

Item TypeDescription
IDLVStandard item - Inbound Delivery
ODLVStandard item - Outbound Delivery
TWPRStandard item - Posting Change

Similar to document types, SAP has predefined several combinations of item category and item type for several document types to enable processing of standard processes. You can configure your own item types to represent delivery items that have business characteristics that are different from the standard.

Service Profiles

In EWM, delivery documents represent various delivery processes in the system. In delivery processing, a series of service profiles on header and item level are used to determine how the documents and items are processed in SAP EWM. They also define the business scope of the documents, that is, what functions are required in the business processes.

Two types of service profiles are defined within EWM:

  • System profiles

  • Customer profiles

System Profiles and Customer Profiles

System profiles are predefined in the EWM system and cannot be changed. They contain configuration settings used as default options in the various delivery document processes. Internally, system profiles are linked to the document categories for profiles related to document headers, and to the item categories for profile settings related to document items.

To configure your own business processes, you create customer profiles. Customer profiles are always linked to the corresponding system profile. SAP has also created a set of predefined customer profiles for the standard delivery processes.

An example of a customer profile and its corresponding system profile for status management is shown in the following figure.

Illustrates Customer Profile and its corresponding System Profile

Document and Item Profiles

The customer profiles are assigned to the delivery document types and item types.

The following profiles are available on header and / or item level (details are described in the next paragraphs):

  • Action profile (only on header level)
  • Status profile
  • Text profile
  • Field control profile
  • Partner profile
  • Date profile
  • Incompleteness profile
  • Quantity offsetting profile
  • Reference document category profile
  • Process profile
  • Process code profile (only on item level)

Action Profile (for Post Processing Framework (PPF))

Message/output control for delivery processing uses Post Processing Framework (PPF). The PPF is a Basis component that generates actions from the data of an application according to an action definition (for example, the printing of a delivery note). PPF provides the tools for scheduling, starting, and monitoring actions. Actions are saved in an action profile, which is linked to the document type.

In addition to printing-related actions, actions can include:

  • Activating delivery documents such as inbound delivery notification or outbound delivery requests

  • Posting goods issue or receipt

Note

The action profile on header level is the only service profile, which is not based on a system profile.

Status Management

Status management controls business transactions used to process a delivery document by assigning one or more statuses to the document.

Status profiles are assigned to delivery types and item types. A status profile contains status types that describe a process in the overall processing life cycle of a delivery document such as a goods receipt status, an unloading status, or a putaway status. Each status type has one or more valid status values assigned to it such as Yes/No, Not started/In Process/Completed. The status value allows or disallows a business transaction. A business transaction can set a new status value.

Text Management

Text management allows texts to be received through delivery documents from the SAP ERP system and processed within SAP EWM delivery documents. New texts can also be created and saved within EWM delivery documents, and you can display, change, or delete texts. Text management supports texts at the delivery header and item level.

In SAP EWM, text types representing particular notes such as "shipping instructions" and "preferred carrier" are defined. Text profiles group text types for a particular delivery header or item. Within the text profile, the access sequence for each text type indicates the source of the text. Text profiles used to specify texts for delivery headers are assigned to the document type; whereas, text profiles used for delivery item texts are assigned to the item type.

Field Control

Delivery documents contain a multitude of fields that contain the data used and required in delivery processing. In addition to status management, field control determines which fields are displayed and changed during delivery document processing. The fields that appear in the delivery header and item structures are determined and controlled by the field control function.

Delivery processing uses field control during the following events:

  • The creation of a document or document item

  • When switching between display mode and change mode

  • After data is changed in a document

All fields in a delivery document are defined in the system as components of structures. Every component in the structure is uniquely identified by the logical field name, and can be addressed directly. In the field attributes assigned to the fields, the system defines the processing characteristics of each field. The list of assigned fields and their field attributes for a particular document type or item type is assigned to a system profile. The field attributes in the system profile cannot be changed, however, you can create new field names by using the system profile. The assignment to the delivery document type or item type is done using the field control profile. A field control profile contains all the allowed fields and their attributes for a particular document or item type. Every field control profile is assigned to a system profile.

SAP provides predefined logical field names, system profiles, and field control profiles for all of the standard delivery processes.

Partner Processing

Partner processing is used to maintain partner information in the header and/or item data in EWM delivery documents. Partner processing configuration begins with the creation of partner roles. The partner role is used to represent a role or a function in the business process. Examples of possible partner roles are: supplier, receiving office, ship-to recipient, and warehouse. Partner roles are identified by a key, a description, and a role category. The role category defines the nature and use of the partner identified by the partner role. The following role categories are available:

  • Business partner

  • Location

  • Organizational unit

Partner roles are assigned to partner profiles. The partner profiles are assigned to the document types and item types where they are used. SAP has created predefined partner profiles for the standard EWM delivery documents. These profiles are the partner processing system profiles and cannot be changed. In these profiles SAP has defined the partner profiles with mandatory and optional partner roles.

Date Types

The date types system function configures the various dates related to delivery processing in SAP EWM. The dates that are supported by the system are defined as date types. Note that the date always includes the time. The EWM application functions determine the supported date types. As a rule, the EWM date types should match the date types defined in configurable process scheduling. Examples of date types include: delivery date, goods issue date, start of loading, end of loading, and pick/pack start.

Date profiles are pre-configured in the EWM system for all of the standard delivery types and item types. Each date profile is assigned to a system profile. Contained within the date profile are the date types that are to be used in the delivery type or item type to which the profile is assigned. If you do not define a date profile for a document type or an item type, the settings from the system profile are used automatically.

Incompleteness Check

Use the incompleteness check to ensure that all relevant fields in a delivery document have been filled. The incompleteness check uses the logical field names assigned to the system profile of the field control for its check. To set up the check, create an incompleteness profile that contains every mandatory input and output field that must be filled in order to process the document. These fields are defined by their logical field names. Each field contained within the incompleteness profile is assigned a business action code such as "Save", "Goods Issue", or "Check". The action codes determine when the field is checked for completeness.

The incompleteness profile is assigned to the document or item type, to which it will be applied. Pre-configured incompleteness profiles and settings are provided by SAP for the standard processes in delivery processing.

Quantity Offsetting

In delivery processing, you use quantity offsetting to calculate the open quantities for a document, or to calculate specific quantities such as requested quantity and reduced quantity. You execute quantity offsetting at the item level of a delivery document. To execute quantity offsetting automatically, use a quantity offsetting profile. The quantity offsetting profile contains the quantity calculation and the quantity offsetting rules to be used to calculate the desired quantities. The quantity offsetting profile is assigned to the delivery document type and the delivery document item type.

Reference Documents

In the reference documents service profile configuration, the allowed preceding document references are configured. Within the system and customer profiles, the permitted reference documents are defined using reference document category codes. The reference document customer/system profiles are assigned to the document categories where they will be used. SAP provides a pre-configured set of profiles for the standard EWM delivery document and item categories.

Process Management and Control

SAP EWM uses the process management and control function to control whether certain processes or functions are permissible for a delivery type or item.

The following process indicators can be set for the delivery header control:

  • Manual creation - controls whether a document can be created manually in SAP EWM

  • Deletion of warehouse request with follow-up documents - controls whether you can delete warehouse requests after the creation and cancellation of successor documents
  • Preceding document - allows reference to a preceding document

  • Production - allows processes for production such as kit-to-stock or goods receipt from production

  • Scrapping - allows subprocesses for scrapping

  • Pickup - allows process for sales without transportation processing

  • Invoice before goods issue - allows an invoice to be created before the goods issue

  • Correction delivery - allows posting of differences to the stock to be cleared using a correction delivery document

  • Communication to SAP ERP - for the advanced production integration the system can use the goods movement interface only
  • Goods receipt mode - when the system communicates the goods receipt to SAP ERP
  • Unique ASN number - you can use this field to control whether the system checks if the advanced shipping notification (ASN) number is unique for the ship-from party and business system or not

Note

The last two controls can also be set in settings which reference the SAP ERP system. As these settings are not available in an embedded SAP EWM, they were added to the process indicators.

At the item level the following process indicators can be set:

  • Create manually - an item can be created manually in a delivery document without reference to a line item in a preceding document

  • Invoice before GI - allows the billing of a line item before its goods issue posting

Like other system functions, process management and control contains SAP pre-created system profiles for the standard delivery categories and item categories.

Process Codes

Process codes are used to control particular exceptional situations, for example, when a delivery quantity is larger or smaller than the actual quantity delivered.

Each process code profile is assigned to a system profile. The process code profile determines which process codes have been assigned in the corresponding system profile. If you want to change the process codes assigned to a business process, you can define a new process code profile for a system profile.

SAP has defined system profiles for the process codes for the standard processes in delivery processing. You cannot change them. If you do not define a process code profile for a item type, the settings from the system profile of the corresponding item category are used automatically.

Service Profile Assignment and Delivery Document Configuration

Within each SAP EWM business process, the delivery document types and item types are configured with their general and service profile settings. The following figure shows the basic relationships in this Customizing process.

Service Profile Assignment illustration that shows a basic Customizing process and relationships

Note

SAP strongly recommends that you use the available BC sets for the initial set up of document and item types, profiles, mappings, and so on. For details see the following notes:

2450387 - Which document type or item type for which warehouse request?

2464460 - Restricted usage of BC sets in embedded EWM in SAP S/4HANA and in decentralized EWM

1227714 - FAQ: BC Sets and delivery Customizing in EWM

1113387 - FAQ: Customizing and BC Sets in EWM delivery processing

Delivery Document Determination

When SAP EWM delivery documents are created as successor documents, the system uses determination tables to assign the document type and item types to the new delivery document that is being created. Delivery document type and item type determination tables are in the business process configuration activities in Customizing:

  • Goods receipt

  • Goods issue

  • Internal warehouse processes - includes posting changes and internal stock transfers

The following figure illustrates the delivery type determination process.

Illustrates the process when determining Delivery Type.

Note

As described in SAP Note 1227714, it is not necessary to maintain these determination tables if the successor document type is identical to the predecessor document type. That means that often these tables are not filled.

EWM Delivery Item Type Determination

To determine an item type for a delivery item, the system uses a group of fields as illustrated in the following figure.

Illustrates EWM Delivery Item Type Determination by using a group of fields.

Item type determination occurs in sequence of the largest amount of entered information first, therefore a complete entry is evaluated before an empty field.

Note

For "standard" items it is not necessary to setup any entries in the table for the item type determination.

SAP ERP Document to SAP EWM Document Integration

For the determination of the EWM document type, you maintain delivery integration settings in the SAP EWM system. SAP provides a set of standard settings for the common SAP delivery documents. The following figure shows how the SAP ERP delivery document type is mapped to the SAP EWM delivery document type.

Diagram illustrating the mapping of SAP ERP Document Type to SAP EWM Document Type

In a decentralized EWM system the "EWM delivery document type" would be an Inbound Delivery Notification, an Outbound Delivery Request, or a Posting Order Request. Since EWM 9.5 or with a decentralized EWM based on SAP S/4HANA, it is possible to "skip" these requests or notifications. The path to do this is EWM Customizing, SCM Extended Warehouse ManagementExtended Warehouse ManagementInterfacesERP IntegrationDelivery ProcessingSkip Request for Messages from ERP (for a SCM based EWM) or SCM Extended Warehouse ManagementExtended Warehouse ManagementInterfacesERP IntegrationERP Integration for Decentralized EWMSkip Request for Messages from ERP (for an SAP S/4HANA-based EWM). This has certain consequences, so you should read the documentation for this Customizing topic before deactivation.

In an SAP S/4HANA embedded EWM these interim documents are not created.

The Code for Initiator of a Communication Chain is an additional key which helps to distinguish different processes. This is necessary as sometimes the determination of the document type in ERP is very simple or because additional information is determined within the context of the received delivery information.

ERP Item Category to EWM Item Type Mapping

In addition to mapping delivery document types, the integration between the SAP ERP system and the SAP EWM system includes a mapping table that maps the SAP ERP delivery item categories to the SAP EWM item type code. The following figure illustrates this mapping.

Diagram illustrating the mapping of ERP Item Category to EWM Item Type:

In each of the EWM integration tables, the Business System field allows for the mapping of the document types and item categories based on the specific source system.