Ansicht
Dokumentation

ATP_PAL_TIME_SERIES_ - BAdI: ATP Product Allocation Time Series Check

General Data in Customer Master   General Data in Customer Master  
This documentation is copyright by SAP AG.

This Business Add-In (BAdI) is used in the ATP: Product Allocation(CA-ATP-PAL) component. You can use this BAdI right before the product allocation check is carried out to modify available quantities of the time series as well as some check parameters, for example, the number of backward and forward periods.

The BAdI is called at the point in time right before the check of the request on the time series is carried out. The characteristic value combination and all other check parameters have already been determined. At this point in time, using the BAdI you can change the available quantities of the time series and modify check parameters which are then considered by the standard check logic. For example, you can set the available quantity to zero which will lead to a zero confirmation in this period.

The BAdI provides a filter to implement variants for sales product allocation and capacity product allocation (filter PRODALLOCSEQUENCEGROUPTYPE). You can implement different variants using the filter (Sales 01or Capacity 02), for example, for individual implementations or using both allocation types in one implementation.

For more information about the standard settings (filters, single or multiple uses), see the Spot Element Definitionstab in the BAdI Builder (transaction SE18).

You can find example implementations in the BAdI Builder on the Enhancement Spot Element Definitionstab in the Implementation Example Classes section. The following example implementations are available:

CL_ATP_PAL_TIMESRS_CHK_IMP_EX

The example implementation adapts the available quantities in the time series to a multiple of the sales unit so that the confirmation results in a whole number and no rounding issues occur when the sales unit is different from the allocation unit. Furthermore, for specific customers (defined in customer master data), it allows an extended consumption range (more backward consumption and past periods allowed).

BAdI method Adapt Parameters and Time Series (ADAPT_PARAMS_AND_TIMESERIES):

The following list contains only parameters that require additional information.

Import Parameters

• Structured parameter: PRODUCTALLOCATIONREQUIREMENT

• Field: prodallocpivotperiodindex: Product Allocation Pivot Period Index

Index number of the pivot period (first period that is checked). The number is the index number contained in table parameter PRODUCTALLOCATIONQUANTITIES.

• Structured parameter: PRODUCTALLOCATIONMASTERDATA

• Field: validitystartutcdatetime: Validity Start UTC Date Time

Calculated validity start date that is based on the sequence constraint validity

• Field: validityendutcdatetime: Validity End UTC Date Time

Calculated validity end date that is based on the sequence constraint validity

• Structured parameter: ATPCHECKPARAMETERS

• Field: atpcheckcurrentutcdatetime: ATP Check Current UTC Date Time

Current date and time that is used for the ATP check

Changing Parameters

• Table parameter PRODALLOCATIONAVAILABLEQTYS

Only those periods need to be maintained for which the available quantities need to be changed. The table can be left empty if you don't want to change anything. However, if you maintain entries, the field productallocationperiodindexneeds to be filled with the index value that identifies the period in the importing parameter PRODUCTALLOCATIONQUANTITIES.

• Structured parameter: PRODUCTALLOCCHECKPARAMETERS

This parameter must be filled with the original values (even if nothing shall be changed). The original values can be filled using the structured parameter PRODUCTALLOCATIONMASTERDATA (for details see the example implementation).

• Possible values for field prodalloccharcconstraintstatus:

01 Unrestricted Availability

02 Restricted Availability

03 No Availability

04 Not relevant: Setting this value does not have any effect as the BAdI cannot use the value at this point in time.

• Possible values for field horizontalconsumptiondirection:

01 Backward then Forward

02 Backward with Earliest First then Forward

• Structured parameter: POSTPROCESSINGPARAMETERS

• Field: prodallocdistributenegqtyisrqd: Product Allocation Distribute Negative Quantity Is Required

In case an over-confirmation results from increasing the available quantity, negative available quantity can occur. Setting the parameter, the negative quantity will be charged to other periods, otherwise the negative quantity will stay in the period.

Product Allocation Check Context Information (Class CL_ATP_PAL_CHECK_CONTEXT):

This class provides access to information about the currently executed product allocation check and can be used in BAdI implementations.

For information about implementing BAdIs as part of the enhancement framework, see SAP Library for SAP NetWeaver Platform on SAP Help Portal at http://help.sap.com/nw_platform. Choose a release and then Application Help: SAP NetWeaver Library: Function-Oriented View. In SAP Library, choose Application Server ABAP -> Application Development on AS ABAP -> Customer-Specific ABAP Development -> Enhancement Framework.

SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up   ROGBILLS - Synchronize billing plans  
This documentation is copyright by SAP AG.

Length: 7450 Date: 20240523 Time: 223815     sap01-206 ( 113 ms )