SAP Function BAPI_CTRACPSOBJECT_GETDETAIL - PSCD: Read BAPI Contract Object

Parameter Reference Type Length Default Optional Text
CTRACCOUNTTYPE BAPI_CTRACPSOBJECT_ACCOUNT-CTRACCOUNTTYPE C 2 X BAPI Accounting Data: Contract Account Category
PARTNER BAPI_CTRACPSOBJECT_ACCOUNT-PARTNER C 10 X BAPI Accounting Data: Business Partner
PSOBJECTGUID BAPI_CTRACPSOBJECT_HEAD-PSOB_GUID C 32 X GUID of a Contract Object (CHAR Format)
PSOBJECTKEY BAPI_CTRACPSOBJECT_HEAD-PSOBJECTKEY C 20 BAPI Header Data: Contract Object Key
VALIDITY_DATE BAPI_CTRACPSOBJECT_HEAD-PSOBJECTVALDT D 8 SY-DATLO X BAPI Header Data: Validity Date
XOBSOLETE BAPI_CTRACPSOBJECT_ADMIN-XOBSOLETE C 1 SPACE X Read Obsolete Contract Account Data Also?

Parameter Reference Type Length Text
PSOBJECTACCOUNTOUT BAPI_CTRACPSOBJECT_ACCOUNT u 258 BAPI Accounting Data: Contract Object
PSOBJECTDETAILOUT BAPI_CTRACPSOBJECT_DETAIL u 109 BAPI Basic Data: Contract Object

Parameter Reference Length Optional Text
EXTENSIONIN BAPIPAREX 990 X Reference Structure for BAPI Parameter ExtensionOut
EXTENSIONOUT BAPIPAREX 990 X Reference Structure for BAPI Parameter ExtensionOut
PSOBJECTCORR BAPI_CTRACPSOBJECT_CORR 60 X BAPI Contract Object Correspondence Recipient
PSOBJECTEXMT BAPI_CTRACPSOBJECT_EXMT 45 X BAPI Contract Object Exception Periods
PSOBJECTFACTS BAPI_CTRACPSOBJECT_FACTS_READ 250 X PS: Contract Object reads Facts Values
PSOBJECTLOCK BAPI_CTRACPSOBJECT_LOCK 129 X BAPI Contract Object Locks
RETURN BAPIRET2 548 Return Parameter

Functionality
This method delivers all available data to the selected contractobject. Provided that only a business partner with a contract accounttype and contract account was assigned to the contract object.Otherwise you must specify the business partner/contract accountcombination that you want when you call the method.
You will also receive the following data:

  • the assigned records for different correspondence receivers.

  • the exception period for the correspondence dunning

  • the set blocks

  • The parameter 'Return' can deliver several report numbers at the sametime.

    Example

    Notes
    BAPI uses the customer enhancement concept with 'BAPI table extensions'for which the following structures can be used:

    • BAPI_TE_DPSOB_BP_ACC

    • BAPI_TE_DPSOB_BP_ACC_COR

    • BAPI_TE_DPSOB

    • Customer enhancement P530 is called so you can check datatransferred to BAPI or determine additional data if necessary.
      Customer enhancement P535 is called at the end of the method inorder to make entries in fields in the output extension.
      There is an overview of all customer enhancements in Customizing, underFinancial Accounting -> Contract accounts receivable and payable->Program enhancements ->Define customer-specific function modules.

      Description
      This export parameter outputs the control parameter for the accountingdata of a contract object.
      INCLUDE BAPI_DATAELEMENT OBJECT DOKU ID TX

      Description
      This export parameter outputs all basic and administrative data of acontract object.
      INCLUDE BAPI_DATAELEMENT OBJECT DOKU ID TX

      Description
      In this import parameter, enter the contract accountcategory of a contract object that is to be displayed.

      Description
      In this import parameter, define the contract account data to bedisplayed with the basic data of a contract object using thebusiness partner.

      Description
      In this import parameter you enter the GUID of the contract object to bedisplayed.

      Description
      In this import parameter, enter the key of the contract object to bedisplayed.

      Description
      You can read the contract account's master data that applies to thevalidity date using this import parameter.

      Value range
      If you do not enter a validity date, the master data available in thedatabase on the current date is displayed.
      If you enter a validity date in the past, the status of the master datarecord at that time is determined and displayed, on the basis of theexisting change documents.
      If you enter a validity date in the future, all future changes to themaster data contained in change documents are displayed up to the dateselected. All valid master data up to the current date is alsodisplayed.

      Default
      The system date is the standard system proposal.

      Description
      You can use this import parameter to define whether contract accountdata flagged as obsolete should also be read. To be able to do this,you need authorization for authorization object F_KK_SOND with activity24.

      Default
      By default, the parameter is not set; as such, obsolete contractaccount data is not read.

      Description
      You can enter additional customer-specific data in this import table,if the data was created using customer enhancement P530.

      Description
      The additional data of a contract object is displayed in this exporttable, for example, the data that you created using customerenhancement P530.
      Customer enhancement P535 is called at the end of the method in orderto fill the output extension.

      Description
      Additional or different correspondence recipients of a contract objectare displayed in this table.
      The control data for correspondence in the contract object is onlyincluded by the system if the indicator correspondence parameter forcontract object is set to active. Otherwise, the control data of theassigned contract account is included.
      INCLUDE BAPI_DATAELEMENT OBJECT DOKU ID TX

      Description
      The exception period for a contract object's inbound correspondence isdisplayed in this table.
      INCLUDE BAPI_DATAELEMENT OBJECT DOKU ID TX

      Description
      The locked entries in the accounting data of a contract account aredisplayed in this table.
      Locked entries in the contract object are only included by the systemif the indicator payment data for contract object or correspondenceparameter for contract object has been set to active. Otherwise thecontrol data of the assigned contract account is included.
      INCLUDE BAPI_DATAELEMENT OBJECT DOKU ID TX

      Value range
      The following processes can be locked in a contract account:
      Type,,Process
      01,,Dunning
      02,,Incoming payment
      03,,Outgoing payment
      05,,Invoice creation
      07,,Correspondence dunning
      INCLUDE BAPI_TABLE OBJECT DOKU ID TX