Sapass

 Simplify SAP R/3 development with Excel VBA/VB RFC  
Home> Bapi>SingleSettlementReqs



Index

SingleSettlementReqs

SingleSettlementReqs


The business object Single settlement request is a settlement
request that invoices a single business transaction between the invoicing party and the payer.

Structure

Single settlement requests can be differentiated according to their debit type:


  • Invoice

  • Credit memo

  • Reversal

  • A single settlement request consists of several items that each contain
    the quantity of a material or a service billed in each case by the invoicing party.


    11-Dec-2005


    Methods

    Available Methods


    • CancelMultiple : Cancel [ BAPI_SINGLESETTREQS_CANCELMULT ]
    • ChangeMultiple : Change Several Objects [ BAPI_SINGLESETTREQS_CHANGEMULT ]
    • CreateMultiple : Create [ BAPI_SINGLESETTREQS_CREATEMULT ]
    • GetList : Determine Documents [ BAPI_SINGLESETTREQS_GETLIST ]
    • ReleaseMultiple : Release Documents to Accounting [ BAPI_SINGLESETTREQS_RELEASE ]

    11-Dec-2005


    CancelMultiple

    CancelMultiple


    You use this method to reverse payment documents.

    To do this, you enter the number via structure "HEADDATAIN".

    You display messages via "RETURN".


    11-Dec-2005


    ChangeMultiple

    ChangeMultiple


    You use this method to change payment documents.

    You use the document number (and item number) to select the documentsvia structure "HEADDATAINX" and document items via "ITEMDATAIN". In addition, you also mark the fields to be changed here.

    You use structures "HEADDATAIN" and "ITEMDATAIN" to enter the new values.


    Messages are returned in structure "RETURN".

    Changed documents are returned in structures "HEADDATAOUT" and "ITEMDATAOUT".

    You use structure "EXTENSIONIN" to change customer-specific fields. These must be inserted via an Append structure to structure
    "BAPI_TE_KOMZRKE" for header data and "BAPI_TE_KOMZRPE" for item data.Here, the field "DOCUMENT_NUMBER" must be used as the key for this BAPI and field "REF_DOC" must be left empty.

    Notes

    Caution: In the method "BAPI_SINGLESETTREQS_CREATMULT", field
    "PAYM_DOC" is used for the document number, instead of "DOCUMENT_NUMBER".

    Changeable fields

    Header data

    DOCUMENT_NUMBER Document number

    BILL_DATE Posting date

    CURRENCY Currency OS NCY

    CURRENCY_ISO ISO code for currency


    DOC_DATE Document date

    REF_DOC_NO Reference

    PAYMT_REF Payment reference

    ALLOC_NMBR Assignment

    EXCH_RATE Directly quoted exchange rate

    EXCH_RATE_V Indirectly quoted exchange rate

    EX_RATE_FX Indicator for fixing exchange rate


    TRANS_DATE Date for currency translation

    PMNTTRMS Terms of payment for invoicing party

    DSCNT1_TO Number of days for payment in first condition

    DSCT_PCT1 Cash discount percent for payment in first condition

    DSCNT2_TO Number of days for payment in second condition


    DSCT_PCT2 Cash discount percent for payment in second condition

    DSCNT3_TO Number of days for net due date

    ADD_VAL_DY Additional value days of the invoicing party

    FIX_VAL_DY Fixed value date of the invoicing party

    PMNTTRMS_DEB Terms of payment key, customer


    DSCNT1_TO_DEB Cash discount 1 - days, customer

    DSCT_PCT1_DEB Cash discount 1 - percentage, customer

    DSCNT2_TO_DEB Cash discount 2 - days, customer

    DSCT_PCT2_DEB Cash discount 2 - percentage, customer

    DSCNT3_TO_DEB Net due date, customer


    PMNT_METH_DEB Payment method, customer

    ADD_VAL_DY_DEB Additional value days, customer

    FIX_VAL_DY_DEB Fixed value date, customer

    PMNT_METH Payment method of invoicing party

    INV_LIST_DATE Posting date of remuneration list


    TESTRUN Switch to simulation mode (no changes to database)

    Item data

    DOCUMENT_NUMBER Document number

    ITEM Item

    MATERIAL Material

    MATL_GROUP Material group

    VEND_PART Vendor sub-range


    COND_GROUP Condition group

    PLANT Plant

    TAX_CODE Input tax code

    TAX_CODE_DEB Output tax code

    NET_AMOUNT Net amount

    GROSS Gross amount

    TAX Tax amount

    CASH_DISC Indicator for subject to cash discount


    REF_DOC_HEAD Document number of the preceding document of the
    business partner

    REF_DOC_ITEM Item number of preceding document of the business partner

    PDOC_CAT Billing document type of the preceding document of the
    business partner


    SHORT_TEXT Short text

    TAXJURCODE Tax Jurisdiction Code

    BUS_AREA Business area

    COSTCENTER Cost center

    PROFIT_CTR Profit center

    NET_PRICE Net price

    BON_GRP1 Settlement group 1 (Purchasing)


    BON_GRP2 Settlement group 2 (Subsequent Settlement)

    BON_GRP3 Settlement group 3 (Subsequent Settlement)


    11-Dec-2005


    CreateMultiple

    CreateMultiple


    You can use this method to create single settlement requests.

    As an input parameter for this, the document header must be transferred (via structure HEADDATA).

    You transfer item data via table ITEMDATA. The item numbers can beassigned manually in the appropriate fields, or automatically on the basis of Customizing settings.


    Once a single settlement request has been created successfully, you geta document number and some document header data (via HEADDATAOUT structures).

    Any errors that occur are announced in parameter RETURN.

    Detailed information on the document items is contained in table ITEMDATAOUT.


    You can add customer-specific fields using structue EXTENSIONIN. Thesemust be added via an append structure to structure BAPI_TE_KOMZRKE forheader data, and BAPI_TE_KOMZRPE for item data. In this, field REF_DOCmust be used as a key field for the BAPI, and field DOCUMENT_NUMBER must be left free.


    Notes

    Caution: In structure HEADDATAOUT, field PAYM_DOC is used for the document number instead of the usual DOCUMENT_NUMBER.

    Header data

    1. Mandatory entries:

    General

    PAYTYPE Payment type

    REF_DOC Number that clearly identifies an external document


    DIFF_INV Invoicing party

    GROSS_AMNT Total invoice amount

    BILL_TO Invoice recipient

    COMP_CODE Company code

    CURRENCY Document currency

    Only for entries with logistics data

    PURCH_ORG Purchasing organization


    PUR_GROUP Purchasing group

    SALESORG Sales organization

    DISTR_CHAN Distribution channel

    DIVISION Division

    2. Optional entries

    BILL_DATE Billing date

    CURRENCY_ISO ISO code for currency


    DOC_DATE Document date

    REF_DOC_NO Reference document number

    PAYMT_REF Payment reference

    EXCH_RATE Exchange rate

    EX_RATE_FX Indicator for exchange rate fixing

    TRANS_DATE Conversion date for currency conversion


    PMNTTRMS Terms of payment key for invoicing party

    DSCNT1_TO Number of days for payment in first condition

    DSCT_PCT1 Cash discount percentage for payment in first condition

    DSCNT2_TO Number of days for payment in second condition


    DSCT_PCT2 Cash discount percentage for payment in second condition

    DSCNT3_TO Number of days for due date for net payment

    If you enter a terms of payment key, you cannot enter terms of payment, and vice versa.

    ADD_VAL_DY Additional value days of invoicing party


    FIX_VAL_DY Fixed value date of invoicing party

    You can only enter one of these two options.

    PMNTTRMS_DEB Terms of payment key for invoice recipient

    DSCNT1_TO_DEB Number of days for payment in first condition

    DSCT_PCT1_DEB Cash discount percentage for payment in first condition


    DSCNT2_TO_DEB Number of days for payment in second condition

    DSCT_PCT2_DEB Cash discount percentage for payment in second condition

    DSCNT3_TO_DEB Number of days for due date for net payment

    If you enter a terms of payment key, you cannot enter terms of payment, and vice versa.


    ADD_VAL_DY_DEB Additional value days of invoice recipient

    FIX_VAL_DY_DEB Fixed value date of invoice recipient

    You can only enter one of these two options.

    PMNT_METH_DEB Payment method for invoice recipient

    TESTRUN Switch to simulation (no changes made to DB)


    PYMT_METH Payment method for invoicing party

    EXCH_RATE_V Quantity based exchange rate

    INV_LIST_DATE Invoice list date

    ALLOC_NMBR Assignment

    DOCID Barcode

    Item data

    1. Mandatory entries


    REF_DOC Number that uniquely identifies an external document.
    This is used to assign the item data to the header data.

    TAX_CODE Input tax code

    TAX_CODE_DEB Output tax code

    NET_AMOUNT Net amount of item


    GROSS Gross amount of item

    TAX Tax amount of item

    2. Optional entries:

    General

    REF_ITEM Document item

    CASH_DISC Indicator - qualifying for cash discount

    REF_DOC_HEAD Document number of the preceding document at the
    business partner


    REF_DOC_ITEM Item number of the preceding document at the business
    partner

    PDOC_CAT Billing type of the preceding document at the business
    partner

    SHORT_TEXT Short text

    TAXJURCODE Tax jurisdiction code


    BUS_AREA Business area

    COSTCENTER Cost center

    PROFIT_CTR Profit center

    Only for entries with logistics data

    MATL_GROUP Material group

    MATERIAL Material

    VEND_PART Vendor sub-range


    COND_GROUP Condition group at vendor

    PLANT Plant


    11-Dec-2005


    GetList

    GetList


    You use this method to select payment documents.

    These are returned via structures "HEADDATAOUT" and "ITEMDATAOUT".

    The messages are found in structure "RETURN".

    Notes

    Structure

    DOCUMENTNUMBERRANGE Document number


    SALESORGRANGE Sales organization

    DISCHANELRANGE Distribution channel

    DIVISONRANGE Division

    CUSTOMERRANGE Customer

    VENDORRANGE Payment recipient

    PURCHORGRRANGE Pruchasing organization


    PURGROUPRANGE Purchasing group

    COMPCODERANGE Company code

    BILLDATERANGE Posting date

    INVLISTDATERANGE Remuneration list date

    ACCTSTATUSRANGE Posting status

    PAYTYPERANGE Payment type


    BILLTYPE Billing document type

    DOCDATERANGE Document date

    REFDOCNORANGE Reference

    ALLOCNMBRRANGE Assignment

    PAYMTREFRANGE Payment reference

    For each structure, you can use "Inclusive" and "Exclusive" to restrict options and value areas.



    11-Dec-2005


    ReleaseMultiple

    ReleaseMultiple


    You use this method to release payment documents to Financial Accounting.

    You use various structures to select the documents that are to be released.

    You use structure "HEADDATAOUT" to display the released payment documents.

    Messages are issued via "RETURN".


    Notes

    Structure

    DOCUMENTNUMBERRANGE Document number

    SALESORGRANGE Sales organization

    DISCHANELRANGE Distribution channel

    DIVISONRANGE Division

    CUSTOMERRANGE Customer


    VENDORRANGE Payment recipient

    PURCHORGRRANGE Purchasing organization

    PURGROUPRANGE Purchasing group

    COMPCODERANGE Company code

    BILLDATERANGE Posting date

    INVLISTDATERANGE Remuneration list date


    PAYTYPERANGE Payment type

    BILLTYPE Billing document type

    DOCDATERANGE Document date

    REFDOCNORANGE Reference

    ALLOCNMBRRANGE Assignment

    PAYMTREFRANGE Payment reference


    For each structure, you can use "Inclusive" and "Exclusive" to restrict options and value areas.


    11-Dec-2005