Ansicht
Dokumentation

CACS_GET_OU_OF_CONTRACTS - Determination of Organizational Units for Specified Commission Contracts

ROGBILLS - Synchronize billing plans   RFUMSV00 - Advance Return for Tax on Sales/Purchases  
This documentation is copyright by SAP AG.

Functionality

An RFC-compliant function module for determining data for commission contracts in organizational management. It is not suitable for mass processing or for use in performance-critical areas.

Import parameters:

IV_APPL: commission application for which the determination is to be carried out. No existence check is carried out. This parameter is mandatory.

IV_CLC_TIMESTAMP: effective time of access; this is filled with the current time stamp (UTC using GET TIME STAMP) if it is initial.

IV_KNW_TIMESTAMP: technical time of access; this is filled with the current time stamp (UTC using GET TIME STAMP) if it is initial.

IT_CTRTB_IDS: table with IDs of commission contracts. The module determines the data in organizational management for each parameter specified in this table. The validity of the ID's are NOT verified!

Export parameters:

ET_OUS: table of type CACS_TT_ORGDATA_O_S, defined in the Data Dictionary. The lines in this table correspond exactly with those of table IT_CTRTB_IDS, however they also contain the contract ID for easier access. For each line, the position assigned to the contract in field POS_ID is returned with text (in POS_TEXT), as long as a staff assignment for the contract exists for the time determined by IV_CLC_TIMESTAMP. In this case, field NOT_POSITION is set to value 0. The organizational unit is also determined for the position and returned in OE_ID that is assigned to the position; the text description is also returned for the position in OE_TEXT. If the commission contract is assigned directly to an organizational unit, only the OU is determined and the field for the position remains initial in the return structure.

The NOT_POSITION field accepts the values '1', '2' and 'X' as well as '0' already mentioned above; this is explained below.

If no staff assignment exists at the time of access, however one existed at another time or is planned for the future, the assignment with the earliest assignment date (BEGDA) for the commission contract is determined and returned as described above. In this case, field NOT_POSITION is set to value X.

Field OCC_BEGIN is always filled with the start date of the organizational assignment of the contract that is returned (BEGDA).

If no staff assignment ever existed for this contract and none is planned for the future, field NOT_POSITION is filled with value '2'.

In the event of an internal error, field NOT_POSITION may contain value '1' . If other fields are filled, their content is consequently invalid.

Exceptions:

NO_WEGID: in the determination process, the evaluation path for finding organizational units on the basis of positions is read from the database for the current time-spot according to FS-CS/ICM version management. If no valid evaluation path is found, exception NO_WEGID is triggered.

NO_ACTIVE_PLVAR_FOUND: if no active plan version is found (HCM), this exception is triggered.

Notes

When processing the results of the function module, you should first check the value of the parameter NOT_POSITION for every line.

Parameters

ET_OUS
IT_CTRTB_IDS
IV_APPL
IV_CLC_TIMESTAMP
IV_KNW_TIMESTAMP

Exceptions

NO_ACTIVE_PLVAR_FOUND
NO_WEGID

Function Group

CACS_EXT_CC

SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up   RFUMSV00 - Advance Return for Tax on Sales/Purchases  
This documentation is copyright by SAP AG.

Length: 3762 Date: 20240523 Time: 043420     sap01-206 ( 77 ms )