Sapass

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



Index

PaymentRequest

PaymentRequest


No description is available


11-Dec-2005


Methods

Available Methods


  • Cancel : Cancel Payment Request [ BAPI_PAYMENTREQUEST_CANCEL ]
  • Create : Creation of a Payment Request [ BAPI_PAYMENTREQUEST_CREATE ]
  • GetList : List Payment Requests [ BAPI_PAYMENTREQUEST_GETLIST ]
  • GetStatus : Determination of Payment Request Status [ BAPI_PAYMENTREQUEST_GETSTATUS ]
  • Post : Posting a Parked Payment Request [ BAPI_PAYMENTREQUEST_POST ]
  • Release : Payment Request Released for Payment [ BAPI_PAYMENTREQUEST_RELEASE ]
  • StartPayment : Start Payment of Payment Request [ BAPI_PAYMENTREQ_STARTPAYMENT ]

11-Dec-2005


Cancel

Cancel


One payment request can be canceled each time the method iscalled. A cancelation indicator is assigned for the payment request andboth cancelation reason and date are added. A payment request can not be paid after it has been canceled.


A payment request cannot be canceled if it is contained within a payment proposal.

Notes

The following authorization object is checked with activity 85 (cancel):

  • F_PAYRQ Authorization object for payment requests

  • After a payment request is canceled, no new instance is createdon the database. The payment request to be canceled is uniquely identifiable via its key number.

    The method carries out the following processing steps:

  • Check whether cancelation is permitted

  • Authorization check
  • Cash management and forecast data entry and check
  • Customer exit for user data update
  • Update of payment request data
  • Update of cash management and forecast data
  • Payment request data and cash management and forecast data are
    temporarily saved first of all, then they are written to the databaseas a table insert through COMMIT WORK. Deletion of internal storage iscarried out during ROLLBACK WORK. This method checks whether thepayment request to be deleted is stored in temporary storage. It is not
    possible to cancel a payment request that exists merely in temporarystorage. It is not possible to create a payment request in a Logical Unit of Work and then delete it (without a COMMIT in between).

    Customer enhancements

    The method supports the SAP customer enhancement concept. Two customer
    exits are available with which checks and update of user data can be carried out (SAP enhancement PRQ_BAPI).

    Messages

    Messages are returned in the parameter return. The parameterdocumentation shows the return codes and their meanings.


    Further Information

    You can find further information in the SAP Library under Financials -> Financial Accounting -> Bank Accounting -> PaymentTransactions -> Automatic Payment -> Payment Program for Payment Requests.


    11-Dec-2005


    Create

    Create


    You can create payment requests with this method.

    A payment request is a payment order that is carried out by the paymentprogram for payment requests. You use this method to transfer all datanecessary for the payment. Each time the method is called, only one payment item is transferred.


    Notes

    The following authorization object is checked with activity 01 (create):

  • F_PAYRQ Authorization object for payment requests
  • Transfer

    You determine how the payment request is created with parameters Releasepost and Releasepay:


  • The payment request is updated in cash management and forecast and is released for payment:
  • Releasepost "X"

    Releasepay "X"

  • The payment request is updated in cash management and forecast. The method PaymentRequest.Release
    releases the payment request for payment.
  • Releasepost "X"

    Releasepay " "

  • The payment request is parked. Update in cash management and forecast occurs with method PaymentRequest.Post. Next, release for payment is effected with method PaymentRequest.Release.

  • Releasepost " "

    Releasepay " "

    Processing steps

    This method executes the following processing steps:

  • Authorization check
  • Customer exit for check
  • Entry of payment request and completion of data

  • Payment request check
  • Optional: Entry and check of data for cash management and forecast
  • Entry of customer enhancements
  • Customer exit for update of own data
  • Update of payment request data
  • Optional: Update of cash management and forecast data

  • Update of payment request data and cash management and forecast data isdone using temporary storage. This means that the data is first savedinternally on a temporary basis and written in the database as a tableinsert with COMMIT WORK. Deletion of internal storage is carried out during ROLLBACK WORK.


    Customer enhancements

    The method supports the SAP customer enhancement concept. It ispossible to enhance payment request table PAYRQ (BAPI table extension:BAPI_TE_PAYRQ) and to permit this to be updated with table Extensionin.Furthermore, two customer exits exist through which checks and update of own data can be carried out (SAP enhancement: PRQ_BAPI).

    Messages

    Messages are returned in the parameter return. The parameterdocumentation shows the return codes and their meanings.

    Further Information

    You can find further information in the SAP Library under
    Financials -> Financial Accounting -> Bank Accounting -> PaymentTransactions -> Automatic Payments -> Payment Program for Payment Requests


    11-Dec-2005


    GetList

    GetList


    You can use this method to create a list of payment requests. You enterthe desired selection criteria (for example, origin, company code,fiscal year) in the table parameters. You can find further information in the documentation of the respective parameters.


    Notes

    The following authorization object is checked with the activity 03 (display):

  • F_PAYRQ Authorization object for payment requests
  • Returned data

    The payment requests matching the selection criteria are returned in table ListRequestid.


    Processing steps

    The method carries out the following processing steps:

  • Selection parameter checks
  • Customer exit for check
  • Selection of payment requests from temporary buffer and database
  • Authorization check

  • Customer exit for further restriction of data
  • Customer enhancements

    The method supports the SAP customer enhancement concept. Two customerexits are provided for selection parameter checks and restriction of selected data (SAP enhancement: PRQ_BAPI).


    Messages

    Messages are returned in the parameter return. The parameterdocumentation shows the return codes and their meanings.

    Further Information

    You can find further information in the SAP Library under
    Financials -> Financial Accounting -> Bank Accounting -> PaymentTransactions -> Automatic Payment -> Payment Program for Payment Requests
    .


    11-Dec-2005


    GetStatus

    GetStatus


    This method can be used to determine the status of a single payment request.

    Notes

    The following authorization object is checked with activity 03 (display):

  • F_PAYRQ Authorization object for payment requests

  • You enter the key number of the payment request and the status of the payment request is returned.

    Processing steps

    The method carries out the following processing steps:

  • Reading of payment request
  • Authorization check

  • Determination of the status
  • Messages

    Messages are returned in the parameter return. The parameterdocumentation shows the return codes and their meanings.

    Further Information

    You can find more information in the SAP Library under Financials
    -> Financial Accounting -> Bank Accounting -> Payment Transactions ->Automatic Payment -> Payment Program for Payment Requests
    .


    11-Dec-2005


    Post

    Post


    You can post a parked payment request with this method. This means that a payment request created with method PaymentRequest.Create is updated in cash management and forecast. You can also simulate posting of the payment request.

    This method is a part of the Payment handling with release
    process. You can use the following three methods to visually reproduce this process:

  • PaymentRequest.Create (Create payment request)
  • PaymentRequest.Post (Update cash management and forecast)
  • PaymentRequest.Release (Release for payment)

  • Only one payment request can be transferred each time the method is called.

    Notes

    The following authorization object is checked with activity 02 (change):

  • F_PAYRQ Authorization object for payment requests
  • Processing steps


    The method carries out the following processing steps:

  • Determination of payment request status
  • Authorization check
  • Customer exit for checking of data
  • Cash management and forecast entry and check
  • Customer exit for update of own data

  • Update of payment request data
  • Update of cash management and forecast data
  • Update of payment request data uses of temporary storage: The data isfirst stored internally and then written to the database as a tableinsert with COMMIT WORK. Deletion of internal storage is carried out during ROLLBACK WORK.


    <Customer enhancements

    The method contains two customer exits that you can use for your own checks and to update your own data.

    Messages

    Messages are returned in the parameter return. The parameter
    documentation shows the return codes and their meanings.

    Further Information

    You can find further information in the SAP Library under FinancialAccounting -> Bank Accounting -> Payment Transactions -> Automatic Payment -> Payment Program for Payment Requests
    .


    11-Dec-2005


    Release

    Release


    You can use this method to release for payment a payment request created with method PaymentRequest.Create and posted with method PaymentRequest.Post.

    This method is a part of the Payment Handling with Release
    process. You can use the following three methods to visuallyreproduce this process. Minimum requirement is the inclusion of methods Create and Release:

  • PaymentRequest.Create (Create payment request)
  • PaymentRequest.Post (Update cash management)

  • PaymentRequest.Release (Release for payment)
  • Only one payment request can be entered each time the method is called.

    Notes

    The following authorization object is checked with activity 02 (change):

  • F_PAYRQ Authorization object for payment requests

  • Processing steps

    The method carries out the following processing steps:

  • Determination of payment request status
  • Authorization check
  • Customer exit for data check
  • Customer exit for update of user data

  • Update of payment request data
  • Update of data uses temporary storage. This means that the data isfirst saved internally and then written to the database as table insertthrough COMMIT WORK. Deletion of internal storage occurs during ROLLBACK WORK.


    Customer enhancement

    The method contains two customer exits that you can use for your own checks and to update your own data.

    Messages

    Messages are returned in the parameter return. The parameter
    documentation shows the return codes and their meanings.

    Further Information

    You can find further information in the SAP Library under Financials -> Financial Accounting -> Bank Accounting -> PaymentTransactions -> Automatic Payment -> Payment Program for Payment Requests.


    11-Dec-2005


    StartPayment

    StartPayment


    A payment run (update run) can be started with this method.

    Notes

    The following authorization objects are checked with activity 02 (enter parameters) and activity 21 (schedule update run):

  • F_REGU_BUK Automatic payment: Action authorization for company codes

  • F_REGU_KOA Automatic payment: Action authorization for account types
  • Transfer

    The payment requests in table Requestid are transferred. Thepayment run date and payment run ID are determined automatically. All
    Reports that are transferred are scheduled using your variants.

    Creation of payment media and lists is controlled via the Reports table and the import parameter UsePaymentMediumTool. You can find more information on creation of payment media using the payment
    medium tool in the SAP Library.

    Processing steps

    The method carries out the following processing steps:

  • Determination of payment run parameters from payment requests and method parameters
  • Determination of payment run date and ID

  • Authorization check
  • Creation of payment run parameters in the database
  • Scheduling of payment run (immediate start)
  • COMMIT WORK

    This method starts a COMMIT WORK. All pending data for the posting isposted. Carrying out a ROLLBACK WORK from the application would have no effect.


    Messages

    Messages are returned in the parameter return. The parameterdocumentation shows the return codes and their meanings.

    Further Information

    You can find further information in the SAP Library under Financial
    Accounting -> Bank Accounting -> Payment Transactions -> Automatic Payment -> Payment Program for Payment Requests
    .


    11-Dec-2005