SAP ABAP IMG Activity REFX_RERA_INVOICE (Implement Enhancements (BAdI))
Hierarchy
EA-FIN (Software Component) EA-FIN
   RE-FX (Application Component) Flexible Real Estate Management
     RE_CA_CU (Package) RE: Customizing (IMG) and Area Menu
IMG Activity
ID REFX_RERA_INVOICE Implement Enhancements (BAdI)  
Transaction Code S_SLN_44000016   (empty) 
Created on 20040429    
Customizing Attributes REFX_RERA_INVOICE   Implement Enhancements (BAdI) 
Customizing Activity REFX_RERA_INVOICE   Implement Enhancements (BAdI) 
Document
Document Class SIMG   Hypertext: Object Class - Class to which a document belongs.
Document Name RERA_INVOICE    

Use

By implementing this Business Add-In you can influence the standard system procedure for creating rent invoices (transaction RERAIV) and for deleting rent invoices (transaction RERAIVRV). The methods of the Business Add-In are automatically called for all active implementations at certain events during creation of invoices.

To modify the correspondence for the invoices created (such as the layout), use the settings in Customizing for correspondence.

Requirements

Standard settings

Activities

The following methods are available for the Creation of Rent Invoices and are executed by the system in this order during an invoicing run:

  • CHECK_IGNORE_CONTRACT

    You can exclude contracts that were selected based on the standard settings. To do so, set the return parameter CF_IGNORE = 'X'. To determine the contract data, call the API_RE_CN_GET_DETAIL function module within the BAdI implementation with the parameter IO_OBJECT = IO_CONTRACT.

    Number of calls: once for each selected contract.

  • ADAPT_INVOICE_ITEM_LIST

    Once the invoice items of a contract have been retrieved, you can modify the individual invoice items. To have certain items not invoiced, delete those entries in the internal table CT_INVOICE_ITEM. To change items (for example, their text), modify the entries in CT_INVOICE_ITEM accordingly.

    Number of calls: once for each partner with a vendor contract of each selected contract (as long as invoice items could be determined).

  • GROUP_INVOICE_ITEM_LIST

    Once all invoice items for the whole invoicing run are determined, the system groups the items together based on either the invoice recipient or the contract (setting in the selection screen). Following this standard grouping of the items, you can make an additional, more specific grouping by entering a sequence number in the invoice number field (INVNO). This number is not the final invoice number. The system only uses it to recognize the start of a new invoice.

    Number of calls: once for the entire invoicing run.

  • GET_NUMBER (only in an update run, not for a simulation)

    In Customizing, you can specify which number range interval of the number range object RE_INVOICE should be used for invoices. You can use the same or a different number range interval for credit memos. If you want to use a different procedure, or want to used your own number range object, then return the new invoice number to be used in the CD_INVNO parameter. The invoice number has to be unique for the company code and fiscal year.

    Number of calls: once for each invoice created.

  • AFTER_STORE (only in an update run, not for a simulation)

    In Customizing, you can specify if the system should update the invoice number in the XREF1 field of the FI document. If you want to update other information in addition to that, then you can perform the needed change operations in this method. However, do not perform COMMIT WORK or ROLLBACK WORK, since these controls are the responsibility of the standard program.

    Number of calls: once for each invoice created.

  • GET_FISC_YEAR (only in an update run, not for a simulation)

    In the standard system, the system determines the fiscal year of an invoice based on the company code and the current date. If you want to use a different approach instead, then return the fiscal year to be used in the parameter CD_FISC_YEAR. The method makes available the importing parameters IS_INVOICE (RE invoice header) and IT_INVOICE_ITEM (table of RE invoice items).

    Number of calls: once for each invoice created.


In the IS_OPTIONS parameter, the selection parameters from the selection screen are available to you in these methods: CHECK_IGNORE_CONTRACT, ADAPT_INVOICE_ITEM_LIST and GROUP_INVOICE_ITEM_LIST.

The following method is available for Reversal of Rent Invoices:

  • GET_BEHAVIOR_CONTEXT

    Returns the behavior context of the invoice
    You can exclude invoices selected in the standard way from reversal by setting the return parameter CF_IGNORE = 'X'. The method makes available the importing parameters IS_INVOICE (RE invoice header) and IT_INVOICE_ITEM (table of RE invoice items).

    Number of calls: once for each invoice to be reversed.

Note that when implementing the BAdI you are not allowed to use statements that affect the interface, such as direct output of messages using MESSAGE.

Notes for Developers

Example

Business Attributes
ASAP Roadmap ID 153   Design enhancements 
Mandatory / Optional 2   Optional activity 
Critical / Non-Critical 2   Non-critical 
Country-Dependency A   Valid for all countries 
Maintenance Objects
Maintenance object type E   Business Add-In - Definition 
History
Last changed by/on SAP  20101217 
SAP Release Created in 500