Business Logic Extensions (Cloud BAdIs) in Sourcing and Procurement - Self-Service Procurement
Purpose
This content explains the different business logic extensions that can done using cloud BAdIs, in Self-Service Procurement.
Overview
As part of In App Extensibility there are multiple extension points for Custom Logic (Cloud BADIs) in Self-Service Procurement. You, as a business expert or implementation consultant, can use the Custom Fields and Logic app to customize your applications using the following BAdIs:
BAdIs for handling Transactional Data
Name
|
Use
|
Trigger Condition
|
MM_PUR_S4_SSPPR_CHK_DRAFT_ITEM
|
Validates/Checks draft purchase requisition Item
|
Adding an item, updating any field of an item or deleting an item in the shopping cart
|
MM_PUR_S4_SSPPR_MOD_DRAFT_ITEM
|
Updates purchase requisition item attributes via custom logic of draft item
|
Creating an item (i.e. Adding an item to cart). Updating an item (Saving an item in cart after update)
|
MM_PUR_S4_PR_FLDCNTRL_SIMPLE
|
Manages the field control (Mandatory, Optional, Read Only, Disabled) of purchase requisition item attributes
|
Retrieving field control while creating an item (i.e. Adding an item to cart), updating an item (Saving an item in cart after update)
|
MM_PUR_S4_PR_CHECK
|
Checks the correctness of all the items just before placing an order
|
Choosing ‘Order’ in shopping cart.
|
MM_PUR_S4_PR_MODIFY_ITEM
|
Updates item attributes via custom logic just before placing an order
|
Choosing ‘Order’ in shopping cart.
|
MMPUR_OCI_TO_DRAFT_ITM_MAPPING
|
Modifies/enhances standard mapping between punchout item and its corresponding draft item
|
Checking out of item from the Punch-out website
|
BAdIs for handling Configurations
BAdIs for handling Master Data
Name
|
Details
|
MMPUR_CAT_TRANS_EXTRACT_DATA (Enrich data before persisting to the staging area)
|
This is used to enrich the data while extracting the catalog items from the catalog provider before persisting to the staging area
|
Check/Validate Draft Purchase Requisition Item
The cloud BADI MM_PUR_S4_SSPPR_CHK_DRAFT_ITEM is available for validating the consistency of the draft item in the shopping cart.
You can use this BAdI to implement your own custom logic for validating the shopping cart item. The implemented logic will be invoked for each of item in the cart while creating, updating and deleting an item.
CHECK_DRAFT_ITEM is the BADI interface method.
Following importing parameters are the input for the BADI interface:
1. PURCHASEREQUISITIONITEMCHECK [Structure]: Contains all the standard Item fields available for validation/checking
Import Fields for parameter PURCHASEREQUISITIONITEMCHECK
|
Field Description
|
REQUESTEDQUANTITY
|
Purchase Requisition Quantity
|
CURRENCY
|
Currency Key
|
ACCOUNTASSIGNMENTCATEGORY
|
Account Assignment Category
|
NETPRICEQUANTITY
|
Price Unit
|
BASEUNIT
|
Purchase Requisition Unit of Measure
|
DELIVERYDATE
|
Item delivery date
|
FIXEDSUPPLIER
|
Fixed Supplier
|
SUPPLIER
|
Desired Supplier
|
PURCHASINGINFORECORD
|
Number of Purchasing Info Record
|
PURCHASECONTRACT
|
Number of Principal Purchase Agreement
|
PURCHASECONTRACTITEM
|
Item Number of Principal Purchase Agreement
|
MANUALDELIVERYADDRESSID
|
Address
|
MATERIAL
|
Material Number
|
MATERIALGROUP
|
Material Group
|
PLANT
|
Plant
|
PURCHASEREQUISITIONITEMTEXT
|
Short Text
|
PURCHASEREQUISITIONPRICE
|
Price in Purchase Requisition
|
COMPANYCODE
|
Company Code
|
PURCHASINGORGANIZATION
|
Purchasing Organization
|
PURCHASINGGROUP
|
Purchasing Group
|
PURREQNSSPCATALOG
|
Technical Key of a Web Service (for Example - a Catalog)
|
PURREQNSSPCATALOGITEM
|
Catalog Item
|
PURREQNSSPCROSSCATALOGITEM
|
Catalog Item Key
|
EXTMATERIALFORPURG
|
Material of External System
|
EXTFIXEDSUPPLIERFORPURG
|
Fixed Supplier of External System
|
EXTDESIREDSUPPLIERFORPURG
|
Desired Supplier of External System
|
EXTCONTRACTFORPURG
|
Contract of External System
|
EXTCONTRACTITEMFORPURG
|
Contract Item of External System
|
EXTINFORECORDFORPURG
|
Info Record of External System
|
EXTPLANTFORPURG
|
Plant of External System
|
EXTCOMPANYCODEFORPURG
|
Company Code of External System
|
EXTPURGORGFORPURG
|
Purchasing Organization
|
EXTSOURCESYSTEM
|
Communication System ID
|
PROCUREMENTHUBSOURCESYSTEM
|
Connected System ID
|
SUPPLIERMATERIALNUMBER
|
Material Number Used by Supplier
|
OPNCTLGMAINIMAGEURL
|
Catalog Main Image URL
|
FULLNAME
|
Full name of a party (Bus. Partner, Org. Unit, Doc. address)
|
CAREOFNAME
|
c/o name
|
ADDRESSSTREETNAME
|
Street
|
ADDRESSHOUSENUMBER
|
House Number
|
ADDRESSPOSTALCODE
|
City Postal Code
|
ADDRESSCITYNAME
|
City
|
PHONENUMBER1
|
Telephone no.: dialling code+number
|
FAXNUMBER
|
First Fax No.: Area Code + Number
|
ADDRESSREGION
|
Region (State, Province, County)
|
ADDRESSCOUNTRY
|
Country Key
|
EMAILADDRESS
|
Email Address
|
FORMOFADDRESS
|
Form-of-Address Key
|
LANGUAGE
|
Language Key
|
MULTIPLEACCTASSGMTDISTRIBUTION
|
Distribution Indicator for Multiple Account Assignment
|
PRODUCTTYPE
|
Product Type Group
|
SERVICEPERFORMER
|
Service Performer
|
PERFORMANCEPERIODSTARTDATE
|
Start Date for Period of Performance
|
PERFORMANCEPERIODENDDATE
|
End Date for Period of Performance
|
PROCESSINGSTATUS
|
Processing status of purchase requisition
|
PURREQNITEMCURRENCY
|
Currency Key
|
PURREQNSSPREQUESTOR
|
Requestor
|
2. PURCHASEREQUISITIONITEMEXT [Structure] - Contains the custom fields created using in app extensibility
Following are the Export Parameters for the BADI
1. MESSAGES [Table]: List of validation/check message populated from the custom logic
Field in the exporting parameter
structure MESSAGES
|
Field Description
|
MESSAGETYPE
|
Message Type
|
MESSAGEID
|
Message Class
|
MESSAGENUMBER
|
Message Number
|
MESSAGEVARIABLE1
|
Message Variable
|
MESSAGEVARIABLE2
|
Message Variable
|
MESSAGEVARIABLE3
|
Message Variable
|
MESSAGEVARIABLE4
|
Message Variable
|
DOCUMENTNUMBER
|
Purchasing Document Number
|
DOCUMENTITEMNUMBER
|
Item Number of Purchasing Document
|
ACCOUNTASSIGNMENTNUMBER
|
Sequential Number of Account Assignment
|
SCHEDULELINE
|
Delivery Schedule Line Counter
|
Modify/Update a Draft Purchase Requisition Item
The cloud BADI MM_PUR_S4_SSPPR_MOD_DRAFT_ITEM is available for updating the draft item attributes in the shopping cart.
You can use this BAdI to implement your own custom logic for updating item attributes int the shopping cart item.
The implemented logic will be invoked for each of item in the cart while creating and updating an item.
MODIFY_DRAFT_ITEM is the BADI interface method.
Following are the Changing Parameters for the BADI
1. PURCHASEREQUISITIONITEMCHANGE [Structure]: Contains all the standard Item fields available for modification/updating
Import Fields for parameter
PURCHASEREQUISITIONITEMCHANGE
|
Field Description
|
REQUESTEDQUANTITY
|
Purchase Requisition Quantity
|
CURRENCY
|
Currency Key
|
ACCOUNTASSIGNMENTCATEGORY
|
Account Assignment Category
|
NETPRICEQUANTITY
|
Price Unit
|
BASEUNIT
|
Purchase Requisition Unit of Measure
|
DELIVERYDATE
|
Item delivery date
|
FIXEDSUPPLIER
|
Fixed Supplier
|
SUPPLIER
|
Desired Supplier
|
PURCHASINGINFORECORD
|
Number of Purchasing Info Record
|
PURCHASECONTRACT
|
Number of Principal Purchase Agreement
|
PURCHASECONTRACTITEM
|
Item Number of Principal Purchase Agreement
|
MANUALDELIVERYADDRESSID
|
Address
|
MATERIAL
|
Material Number
|
MATERIALGROUP
|
|
