SAP Function BAPI_0051_UPDATE - FM Budgeting - Update totals

Parameter Reference Type Length Default Optional Text
BUD_CAT BAPI_0051_FIELDS-BUDCAT C 2 Budget category
FISC_YEAR BAPI_0051_FIELDS-FISC_YEAR N 4 Fiscal year
F_MNGT_AREA BAPI_0051_FIELDS-FM_AREA C 4 Financial management area
PERIOD_INTERVAL BAPI_0051_PERIOD_INTERVAL u 6 Interval of periods to take into account for mass update
TESTRUN BAPI_0051_FIELDS-TESTRUN C 1 'X' X Switch to Simulation Session for Write BAPIs
UPDATE_MODE BAPI_0051_FIELDS-UPDATE_MODE C 1 Update mode in mass transactions
VERSN BAPI_0051_FIELDS-VERSION C 3 Budget version

Parameter Reference Length Optional Text
ITEM_DATA BAPI_0051_ITEM_SET 148 Total line for Budget Data
PERIOD_DATA BAPI_0051_PERIOD_SET 21 X Period value for Budget Data
RETURN BAPIRET2 548 Return parameter

Functionality
This method enables you to update budgeting totals.

Example

Notes
The following authorization objects are checked:

  • with activity 02 (change)

    • ,,F_FICB_FKR Financial management area
    • with activity 20 (mass process)

      • ,,F_FMBU_VER Version and budget category
      Item data
      The data for items is passed on in the table ItemData.
      Period data
      Period data is passed on in the table PeriodData.
      For each line item, specify either an annual amount and a distributionkey on the item level, or the period amount.
      Return messages
      INCLUDE BAPI_RET

      Description
      This parameter is an import parameter.
      INCLUDE BAPI_DATAELEMENT
      Also see Budget category.

      Value range

      Description
      This parameter is an import parameter.
      INCLUDE BAPI_DATAELEMENT
      Also see Fiscal year.

      Value range

      Description
      This parameter is an import parameter.
      INCLUDE BAPI_DATAELEMENT
      Also see FM Area.

      Value range

      Description
      This parameter is an import parameter.
      INCLUDE BAPI_DATAELEMENT
      Using the period interval, you specify which periods will be updated.
      If the period interval is smaller than the full year, periods amountsmust be passed on. In this case, annual amounts are not allowed.
      Please note that periods amounts can only be specified for periodswithin the interval.

      Value range

      Default
      If the interval is not specified, all periods are take into account.

      Description
      This parameter is an import parameter.
      INCLUDE BAPI_DATAELEMENT
      For additional information, see: Testrun.

      Value range

      Description
      This parameter is an inport parameter.
      INCLUDE BAPI_DATAELEMENT
      Update mode

      Value range

      Description
      This parameter is an import parameter.
      INCLUDE BAPI_DATAELEMENT
      Also see Version.

      Value range

      Description
      The table contains the line item data. It is an import parameter.
      INCLUDE BAPI_DATAELEMENT
      At least the following data is required:

      • Item counter (field ITEM_NUM). The line numbering should be complete and
        • unique.
        • Transaction currency (field TRANS_CURR)

          • The following can also be passed on as an alternative to the transactioncurrency:
          Transaction currency in the ISO format (field TRANS_CURR_ISO),,
          • Fund (field FUND). The field should be initial (blank) if the account
            • assignment element FUND is not active.
            • Funds center (field FUNDS_CTR)

            • Commitment item (field CMMT_ITEM)

            • Functional area (field FUNC_AREA). The field should be initial (blank)
              • if the the account assignment element FUNCTIONAL AREA is not active.
              • Funded program (field MEASURE). The field should be initial (blank) if
                • the the account assignment element FUNDED PROGRAM is not active.
                • Grant (field GRANT_NBR). The field should be initial (blank) if the the
                  • account assignment element GRANT is not active.
                  • Budget type (field BUDTYPE)

                  • Year of cash effectivity (field CASH_YEAR). The field should be initial
                    • (blank) if the year of cash effectivity is not active for the budgetcategory (no time horizon defined for budgeting).
                    • Total amount (field TOTAL_AMOUNT_TCUR)

                    • Distribution key (field DISTKEY)

                      • Instead of specifying the total amount and distribution key, you canprovide period data (Parameter PeriodData) for the item.

                      Description
                      The table contains the line items data. It is an import parameter.
                      INCLUDE BAPI_DATAELEMENT
                      At least the following data is required:

                      • Item counter (field ITEM_NUM). The line numbering should be complete and
                        • unique.
                        • Transaction currency (field TRANS_CURR)

                          • The following can also be passed on as an alternative to the transactioncurrency:
                          Transaction currency in the ISO format (field TRANS_CURR_ISO),,
                          • Fund (field FUND). The field should be initial (blank) if the dimension
                            • FUND is not active.
                            • Funds center (field FUNDS_CTR)

                            • Commitment item (field CMMT_ITEM)

                            • Functional area (field FUNC_AREA). The field should be initial (blank)
                              • if the dimension FUNCTIONAL AREA is not active.
                              • Funded program (field MEASURE). The field should be initial i(blank) f
                                • the dimension FUNDED PROGRAM is not active.
                                • Grant (field GRANT_NBR). The field should be initial (blank) if the
                                  • dimension GRANT is not active.
                                  • Budget type (field BUDTYPE)

                                  • Total amount (field TOTAL_AMOUNT_TCUR)

                                  • Distribution key (field DISTKEY)

                                    • Instead of specyfying total amount and distribution key, you can provideperiod data (Parameter PeriodData) for the item.

                                    Value range
                                    INCLUDE BAPI_TABLE

                                    Value range

                                    Authorization messages
                                    TYPE ,,ID ,,NUMBER ,,MESSAGE
                                    E,,F6,,702,,No authorization for FM area &1 activity &2

                                    Processing messages
                                    TYPE ,,ID ,,NUMBER ,,MESSAGE
                                    I,,FMBAPI,,001,,Test run process (&1 &2)
                                    E,,FMBAPI,,004,,Errors occurred. See other messages for detail
                                    S,,FMBAPI,,005,,No error. Successful processing
                                    E,,FMBAPI,,024,,Errors occurred. No instance of &1 has beenupdated.
                                    S,,FMBAPI,,025,,No error. &1 has been updated successfully.
                                    I,,FMBAPI,,034,,No line relevant for update. Processing has beenstopped.

                                    Messages on data input
                                    TYPE,,ID,,NUMBER,,MESSAGE
                                    E,,FMBAPI,,002,,Distribution key and period amounts filledsimultanuously,,
                                    E,,FMBAPI,,003,,Total amount and period amounts filled simultanuously
                                    E,,FMBAPI,,008,,Period &1 is greather than the highest periodallowed (&2)
                                    E,,FMBAPI,,009,,Total amount should be specified
                                    E,,FMBAPI,,010,,Distribution key should be specified
                                    E,,FMBAPI,,011,,Total amt after distribution (&1) differs fromoriginal (&2)
                                    E,,FMBAPI,,014,,Transaction currency &1 differs from localcurrency &2
                                    E,,FMBAPI,,017,,Duplication of item number &1
                                    E,,FMBAPI,,018,,Duplication of budgeting period &1 for item2
                                    E,,FMBAPI,,019,,Item number should not be initial
                                    E,,FMBAPI,,020,,Item no. (&1), budgeting per. (&2) shouldnot be BLANK
                                    E,,FMBAPI,,021,,Error in item numbering (&1)
                                    E,,FMBAPI,,022,,Update mode &1 is not valid
                                    E,,FMBAPI,,023,,Duplication of budgeting entry (&1)
                                    E,,FMBAPI,,026,,Period from is mandatory
                                    E,,FMBAPI ,,027 ,,Period to (&1) must be > or = period from (
                                    2)
                                    E,,FMBAPI,,028,,This BAPI not allowed for FM area &1 (Budg. ledgeractive)
                                    E,,FMBAPI,,030,,Annual amount is not allowed with period interval1 - 2
                                    E,,FMBAPI,,031,,Period &1 is not allowed with period interval2 - 3
                                    I,,FMBAPI,,032,,Distribution key has been set to &1

                                    Others possible messages
                                    You may see messages from other function modules or programs,especially:

                                    • customizing messages

                                    • master data messages

                                    • consistency checks messages

                                    • availability control messages

                                      • Value range

979973Lock table overflow for BAPI call in simulation mode