SAP ABAP IMG Activity BADI_BUDGT_CNTL_INTE (BAdI: Budget Control Integration)
Hierarchy
☛ SAP_FIN (Software Component) SAP_FIN
   ⤷ FI-LOC (Application Component) Localization
     ⤷ ID-FI-EPIC-PMCTL (Package) Globalization: E-Payment Integration Payment Control
IMG Activity
ID BADI_BUDGT_CNTL_INTE BAdI: Budget Control Integration  
Transaction Code S_EBJ_45000022   (empty) 
Created on 20130718    
Customizing Attributes BADI_BUDGT_CNTL_INTE   BAdI: Budget Control Integration 
Customizing Activity BADI_BUDGT_CNTL_INTE   BAdI: Budget Control Integration 
Document
Document Class SIMG   Hypertext: Object Class - Class to which a document belongs.
Document Name BADI_BUDGT_CNTL_INTE    

Use

This Business Add-In (BAdI) is used in the E-Payment Integration China (FI-LOC-EPI-CN) component.

You can use this BAdI to implement an interface for retrieving cash budget planning information from a source other than Electronic Payment Integration. The Electronic Payment Integration functions then allow you to make the assignment between payment items (such as invoices, credit memos or down payments) and the liquidity items in the cash budget plan. After making the assignment, you can pass this information about cash consumption to the source application.

This BAdI can be called by the Electronic Payment Integration framework as follows:

  • When a payment proposal runs, the logic in this BAdI can derive default liquidity item assignments for the items picked up by the proposal run.
  • When a user assigns liquidity items to payment items, the logic can derive cash budget and consumption information from the source application and display it in the Liquidity Item Assignment dialog box (displayed when the user clicks on the link in the Liquidity Item Assignment column). The system can display this dialog box on the Process Items tab page or the Approve Items tab page.
  • When a user performs a certain action, the logic can check, for example, if enough cash has been budgeted to cover the payment of the item. The system can make such checks as follows:
    • When a user submits an item
    • When a user confirms a step in the approval process
    • When a user pays an item
  • When a user pays an item, the logic in this BAdI can handle the corresponding cash budgeting data to meet your business requirements, for example, include it in the payment file

This BAdI definition has the following methods:

  • Derive cash budget entity matrix (IF_EPIC_CB_INTEGRATION~DERIVE_CB_ENTITY_MATRIX) BAdI method

    This BAdI method retrieves the cash budget planning information from the source other than Electronic Payment Integration and passes back the consumption information. It also allows you to configure the field display in the Liquidity Item Assignment dialog box and provide dropdown lists (F4 help) for the fields displayed.

  • Action (IF_EPIC_CB_INTEGRATION~ACTION) BAdI method

    This BAdI method allows liquidity item assignment and changes depending on the action that the user performs, for example, approving an item or paying an item. The method determines which budgeting activities the user can perform during this action, for example, make a new assignment or validate an existing assignment.

Requirements

Standard settings

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

Activities

You can find example implementations in the BAdI Builder on the Enhancement Spot Element Definitions tab in the Implementation Example Classes section.

For this BAdI, the EI_BUDGET_CNTRL_INTEGRATION example implementation is available. This implementation allows the user to perform cash budgeting actions on the Electronic Payment Integration (China) screen as follows:

  1. When a user calls the EPIC_PROC transaction, the sample coding in the IF_EPIC_CB_INTEGRATION~DERIVE_CB_ENTITY_MATRIX method derives a budget planning structure (the combination of, for example, organizational unit, budget area, budget cycle, liquidity item) that is stored in the EPIC_CB_CYCLE, EPIC_CB_LQITEM, and EPIC_CB_ORG database tables. It also gets cash budgeting data, such as the planned and consumed amounts from the EPIC_CB_PLAN table for cash budget planning and cash budget consumption.
  2. When a user wants to assign liquidity items to payment items, the IF_EPIC_CB_INTEGRATION~ACTION method is called to derive a default cash budget assignment for the selected payment items.
  3. When a user submits the item for payment, the IF_EPIC_CB_INTEGRATION~ACTION method is called to check that the assignment is not empty and that the assignment amount does not exceed the amount budgeted for the liquidity item. If there is an error, a message is returned for the Electronic Payment Integration framework to display.
  4. After an item has been submitted, if a user wants to display the cash budgeting information, the IF_EPIC_CB_INTEGRATION~ACTION method is called, but there is no follow-on coding in this example.
  5. When a user later confirms the approval of this item, the IF_EPIC_CB_INTEGRATION~ACTION method is called to check if the amount assigned to liquidity items does not exceed the amount budgeted for the liquidity item. If there is an error, a message is returned for the Electronic Payment Integration framework to display.
  6. When the approval process for an item has been completed and confirmed, the IF_EPIC_CB_INTEGRATION~ACTION method is called, but there is no follow-on coding in this example.
  7. When a user pays an item, the IF_EPIC_CB_INTEGRATION~ACTION method is called to check if the amount assigned to liquidity items does not exceed the amount budgeted for the liquidity item. If there is an error, a message is returned for the Electronic Payment Integration framework to display.
  8. After an item has been paid, the IF_EPIC_CB_INTEGRATION~ACTION method is called to modify the consumed amount for the related liquidity items.
  9. When a user saves liquidity item assignments in the Liquidity Item Assignment dialog box, the IF_EPIC_CB_INTEGRATION~ACTION method is called to save the assignment to the payment items in the EPIC_CBC table.

Example

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. In SAP Library, choose SAP NetWeaver Library: Function-Oriented View -> Application Server -> Application Server ABAP -> Application Development on AS ABAP -> ABAP Customer Development -> Enhancement Framework.

Business Attributes
ASAP Roadmap ID 105   Define functions and processes 
Mandatory / Optional 2   Optional activity 
Critical / Non-Critical 2   Non-critical 
Country-Dependency I   Valid for countries specified 
Customizing Attributes Country Key Country Name
BADI_BUDGT_CNTL_INTE CN China
Assigned Application Components
Documentation Object Class Documentation Object Name Current line number Application Component Application Component Name
SIMG BADI_BUDGT_CNTL_INTE 0 HLA0009200 Financial Accounting 
Maintenance Objects
Maintenance object type E   Business Add-In - Definition 
History
Last changed by/on SAP  20130726 
SAP Release Created in