Fonction SAP BAPI_0050_CREATE - Create FM Budgeting Entry document

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
HEADER_DATA BAPI_0050_HEADER u 42 Header data
HEADER_DATA_ADD BAPI_0050_HEADER_ADD u 172 X Additional header data
LANGUAGE BAPI_0050_FIELDS-LANGUAGE C 1 X Language
TESTRUN BAPI_0050_FIELDS-TESTRUN C 1 'X' X Switch to Simulation Session

Paramètre Reférence Type Long. Description
DOCUMENTNUMBER BAPI_0050_FIELDS-DOCUMENT C 10 Budget entry document number
DOCUMENTYEAR BAPI_0050_FIELDS-DOC_YEAR N 4 Document year
FMAREA BAPI_0050_FIELDS-FM_AREA C 4 Financial management area

Paramètre Reférence Long. Facultatif Description
EXTENSION_IN BAPIPAREX 990 X Enhancement
ITEM_DATA BAPI_0050_ITEM 206 Line item
LONG_TEXT BAPI_0050_LONGTEXT 138 X Long text
PERIOD_DATA BAPI_0050_PERIOD 21 X Periods
RETURN BAPIRET2 548 Return messages
SENDER_ITEM_DATA BAPI_0050_ITEM 206 X Line item (senders)
SENDER_PERIOD_DATA BAPI_0050_PERIOD 21 X Periods (senders)

Functionality
This method enables you to create budget entry documents. You can createeither posted documents or preposted documents.

Notes
The following authorization objects are checked:

  • With activity 02 (change)

  • ,,F_FICB_FKR ,,Financial management area
    ,,F_FMBU_VER ,,Version and budget category
    • With activity 10 (post) or activity 09 (prepost), depending on the
    • document status
      ,,F_FMBU_DOC ,,Document type
      ,,F_FMBU_STA ,,Status
      ,,F_FMBU_ACC ,,Account assignment
      Header data
      Header data for the entry document can be passed on in the parametersHeaderData and HeaderDataAdd (for additional data).
      Item data
      The data for the entry document items is passed on in the tableItemData. In the case of a process that implies sender andreceiver parts (such as a transfer), the data for the sender items ispassed on in the table SenderItemData. In the case of a processthat implies source and target parts (such as a revenues increasingbudget), the data for the source items is passed on in the tableSenderItemData.
      All input items in one entry document should have the same value type(Either 'B1' for Budget input or 'R1' for Release input).
      Period data
      The period data for the entry document items is passed on in the tablePeriodData. In the case of a process that implies sender andreceiver parts (such as a transfer), the period data for the senderitems is passed on in the table SenderPeriodData.
      Texts
      Long text for the entry document can be passed on in the tableLongtext.
      Return messages
      INCLUDE BAPI_RET
      Parameter interdependencies
      The tables SenderItemData and SenderPeriodData shouldonly be passed on for processes containing sender and receiver parts(such as a transfer or carryforward).
      INCLUDE BAPI_KEYFIELD

      Value range
      INCLUDE BAPI_KEYFIELD

      Value range
      INCLUDE BAPI_KEYFIELD

      Value range

      Description
      The parameter contains the entry document header data. It is an importparameter.
      INCLUDE BAPI_DATAELEMENT
      You must enter at least the following data:

      • Financial management area (field FM_AREA)

      • Version (field VERSION)

      • Document date (field DOCDATE)

      • Posting date (field PSTNG_DATE). The posting date is only relevant if
      • the budgetary ledger is active. If it is not, the field should beinitial (blank).
        • Document type (field DOCTYPE)

        • Document status (field DOCSTATE). Status should be set to '1' for posted
        • documents or to '2' for preposted documents.
          • Process (field PROCESS)
          • Value range

            Description
            This parameter contains additional header data for budget entrydocuments. It is an import parameter.
            INCLUDE BAPI_DATAELEMENT

            Value range

            Description
            This parameter allows you to specify in which language the data (longtext) is passed.
            For further information, see Language.

            Value range

            Default
            By default, the language is set to the logon language.

            Description
            This parameter is an input parameter.
            INCLUDE BAPI_DATAELEMENT
            You can also get further information under Switch toSimulation Session for Write BAPIs.

            Value range

            Description
            This parameter is an import parameter. It is provided to allow customersto define additional fields for the object to be created.
            The table extension provided is called BAPI_TE_FMBH.
            INCLUDE BAPI_DATAELEMENT

            Value range

            Description
            The table contains the entry document item data. It is an importparameter.
            INCLUDE BAPI_DATAELEMENT
            At least the following data is required:

            • Item counter (field ITEM_NUM). The line numbering should be complete and
            • unique.
              • Fiscal year (field FISC_YEAR)

              • Budget category (field BUDCAT)

              • Budget type (field BUDTYPE)

              • 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 (blank) if
                  • the dimension FUNDED PROGRAM is not active.
                    • Grant (field GRANT_NBR). The field should be initial (blank) f the
                    • dimension GRANT is not active.
                      • Transaction currency (field TRANS_CURR). The following can also be
                      • passed on as an alternative to the transaction currency:
                        Transaction currency in the ISO format (field TRANS_CURR_ISO),,
                        • Total amount (field TOTAL_AMOUNT)

                        • Distribution key (field DISTKEY)

                        • Instead of specifying total amount and distribution key, you can alsoprovide period data (parameter PeriodData) for the item.
                          • Value type (field VALTYPE)
                          • Value range

                            Description
                            This table contains a long text for the entry document. It is an importparameter.
                            INCLUDE BAPI_DATAELEMENT

                            Value range

                            Default
                            The text identifier (field TEXT_ID) is not taken into account. The textidentifier for entry document longtext is 'FMED'.

                            Description
                            The table contains the period amount per item. It is an importparameter.
                            At least the following data is required:

                            • Item counter (field ITEM_NUM)

                            • Period (field BUDGETING_PERIOD)

                            • Period data should only be specified if the total amount anddistribution key have not been specified in the parameter ItemData
                              for the corresponding item.
                              INCLUDE BAPI_DATAELEMENT

                              Value range

                              Description
                              INCLUDE BAPI_TABLE

                              Value range

                              Authorization messages
                              TYPE,,ID,,NUMBER ,,MESSAGE
                              E,,F6,,702,,No authorization for FM area &1 activity &2
                              E,,FMKU,,162,,No authorization for FM area &1 document type2 activity 3
                              E,,FMKU,,163,,No authorization for FM area &1 version &2budget categ. &4 activity &3
                              E,,FMKU,,164,,No authorization for FM area &1 authorization group2 activity 3,,
                              E,,F6,, 705,, No authorization for FM area &1 authorization group2 activity 3,,

                              Processing messages
                              TYPE ,,ID ,,NUMBER ,,MESSAGE
                              S,,BAPI,,000,,&1 &2 &3 has been created. Externalreference: &4
                              I,,FMBAPI,,001,,Test run process (&1 &2)
                              E,,FMBAPI,,004,,Errors occurred. See other messages for details.
                              S,,FMBAPI,,005,,No errors. Successful processing
                              E,,BAPI,,001,,No instance of object type &1 created. Ext.reference: &4

                              Messages on data input
                              TYPE,, ID ,,NUMBER ,,MESSAGE
                              E,,FMBAPI,,002,,Distribution key and period amounts filledsimultaneously,,
                              E,,FMBAPI,,003,,Total amount and period amounts filled simultaneously
                              E,,FMBAPI,,008,,Period &1 is bigger 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 distrib. (&1) different fromoriginal amt (&2)
                              E,,FMBAPI,,012,,Parameter &1 is mandatory with process &2
                              E,,FMBAPI,,013,,Parameter &1 should be initial (blank) withprocess &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 (blank)
                              E,,FMBAPI,,020,,Item number (&1), budgetg period (&2) shouldnot be initial
                              E,,FMBAPI,,021,,Error in item numbering (&1)
                              E,,FMBAPI,,032,,Distribution key has been set to &1

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

                              • customizing messages

                              • master data messages

                              • consistency checks messages

                              • availability control messages
                              • Description
                                The table contains the entry document item data for senders. It isrelevant for processes that contain sender and receiver parts (such astransfers). It is an import parameter. The corresponding period datashould be passed to parameter PeriodSenderData.
                                For further information, see the parameter documentation ofLine Item Data
                                INCLUDE BAPI_DATAELEMENT

                                Value range

                                Description
                                The table contains period data per item for senders. It is relevant forprocesses that contain Sender and Receiver parts (e.g. Transfer). It isan import parameter. The corresponding items data should be passed tothe parameter SenderItemData.
                                For further information, see the parameter documentation ofPeriodData
                                INCLUDE BAPI_DATAELEMENT

                                Value range

979973Lock table overflow for BAPI call in simulation mode