SAP Function BAPI_FMCABILLDOC_ADJUST - Adjust PS Billing Documents

Parameter Reference Type Length Default Optional Text
ADJUSTED_DOC BAPI_FMCA_EXT_ADJUSTED_DOC u 22 External billing document that should be adjusted
HEADER BAPI_FMCA_EXTDOC_H u 405 Header of External PSCD Billing Document
READ_ARCHIVE BAPI_FMCA_READ_ARCHIVE u 1 SPACE X Fields for controlling access to archived documents
TESTRUN BAPI_FMCAINV_FIELDS-TESTRUN C 1 SPACE X Switch to Simulation Mode for Write BAPIs

Parameter Reference Type Length Text
NEW_ADJUSTMENTDOC BAPI_FMCA_NEW_ADJUSTMENTDOC u 12 Adjustment Billing Document

Parameter Reference Length Optional Text
ADDITEMS BAPI_FMCA_EXTDOC_A 290 X Additional Items of External PSCD Billing Document
EXTENSIONIN BAPIPAREX 990 X Reference Structure for BAPI Parameters EXTENSIONIN/EXTENSIONOUT
EXTENSIONOUT BAPIPAREX 990 X Reference Structure for BAPI Parameters EXTENSIONIN/EXTENSIONOUT
ITEMS BAPI_FMCA_EXTDOC_I 416 X Items of External PSCD Billing Document
RETURN BAPIRET2 548 X Return Parameter(s)
TAXITEMS BAPI_FMCA_EXTDOC_T 98 X Tax Items of External PSCD Billing Document

Functionality
You can use this Business Application Programming Interface(BAPI) to adjust billing documents. This isadvisable because the billing documents processed by invoicing andposted in Contract Accounts Receivable and Payable cannot be deleted ordeactivated.

Notes
Note:

  • The BAPI updates the billing document directly if it is successful and
    • does not use the update task.
    • The BAPI does not perform any of its own authorization checks.

    • Simulated billing documents cannot be adjusted.

    • Billing documents that were already adjusted cannot be adjusted
      • again.
      • You can adjust and reverse adjustment documents.

      • The adjustment billing documents also require a unique reference to a
        • document in the feeder system.
        • You can enhance this BAPI using the implementation of BAdIs

        • FMCAINV_BILL_CANCEL, FMCAINV_BAPIBILL and FKKINV_BAPIBILL without making
          • any modifications.

          Description
          Contains the document number of the newly created adjustment document.

          Description
          This structure identifies the billing document that should be adjusted:

          • LOG_SYSTEM and REFDOCNO must be filled. You identify the billing
            • document to be adjusted from the view of the feeder system.
            • CONT_ACCT must be filled with the contract account of the document to be
              • adjusted. Alternatively, you can leave CONT_ACCT empty and fillCONT_ACCT_ID. In this case, you must implement methodCONTRACT_ACCOUNT_DETERMINE of BAdI FKKINV_BAPIBILL.

              Description
              Contains the header data of the external adjustment document.

              Description
              Ensures that the billing documents to be adjusted are also written inthe archive:

              • The billing document to be adjusted is first searched for in the
                • database.
                • If the billing document is not found in the database and the indicator
                  • is selected, the billing document to be adjusted is then searched for inthe archive.
                  Note that accessing archived billing documents can increase runtime.

                  Description
                  If you select this field, the BAPI does not make any changes in thedatabase. All checks are run. Any errors that occur are written in theexport table RETURN.

                  Description
                  Contains optional additional items of the external adjustment document.

                  Description
                  You can use this import table to provide the BAPI with additional data.The SAP Standard ignores the table and only forwards the data to themethods of BAdI ISTINV_BILL_CANCEL and ISTINV_BAPIBILL.

                  Description
                  You can use this export table to return more data from the BAPI to thecaller. The SAP Standard does not use the table. If you want to fill thetable, you must implement the methods of BAdI ISTINV_BILL_CANCEL andISTINV_BAPIBILL.

                  Default

                  Description
                  Contains the item data of the external adjustment document.

                  Description
                  This table contains all log messages. If the table contains one or moremessages of message type E or A, anerror has occurred that causes processing to be terminated.

                  Description
                  Contains the tax item data of the external adjustment document. Thetable is only used when an external tax determination is wanted.