Functionality
INCLUDE NBAPI_ISH
It is used to change an existing service of a service catalog.
You must specify the import parameters 'client', 'institution' and'catalog' in which the service is to be changed.
The parameter TESTRUN is optional. If it is flagged ('X'), the moduleis executed in test mode. Test mode serves to check the data passed tothe function module. Errors detected during the check are returned tothe user in the table RETURN. Data is not written to the database intest mode.
The following tables can be passed to the function module:
SRVCAT_SRVDATA : Header data of the service
SRVCAT_COLDATA : Columns of the service
SRVCAT_TXTDATA : Description of the service (service text)
SRVCAT_ADDDATA : Additional data for special services (FR, PS)
SRVCAT_PLNDATA : Planned values for the service
SRVCAT_ADDDATCH : Add. data service master for country version CH
SRVCAT_ADDDATCH_AG : Service master => age assignment (CH only)
SRVCAT_ADDDATCH_KU : Service master => excluding service asgmt (CHonly)
SRVCAT_ADDDATCH_QL : Service master => qualitat. grade asgmt (CH only)
SRVCAT_ADDDATCH_QT : Service master => quantitat. grade asgmt (CH only)
SRVCAT_ADDDATCH_SP : Service master => division asgmt (CH only)
SRVCAT_ADDDATCH_N1 : Service breakdown for country version CH
SRVCAT_ADDDATCH_N1T: Service breakdown - texts for country version CH
SRVCAT_ADDDATCH_W1 : Service master => IV qualifier asgmt (CH only)
Each of the fields in the above tables (except for the key fields) hasa corresponding X field of the same name that ends with "X".This X field must be filled with an "X" if the corresponding field isto be written to the database. Fields whose X field is not filled withan "X" are not written to the database.
This ensures that existing fields in the database are not overwrittenunintentionally or their contents deleted.
You must only fill the structure SRVCAT_SRVDATA to change a service.The specification of other structures is optional. If you also specifysuch structures, all key fields must be filled. The specification ofthe key field "client" is optional.
Key fields cannot be changed.
To enable an SRVCAT_* record to be changed, a corresponding record mustexist for it in the structure SRVCAT_SRVDATA.
Records passed to SRVCAT_SRVDATA can only be changed. Records of theother tables can be created and changed provided the correspondingSRVCAT_SRVDATA record exists for them.
For instance, if a column record is specified via the structureSRVCAT_COLDATA, the module first checks whether the record was includedin the data passed via SRVCAT_SRVDATA. If this is the case, the recordis changed (if it already existed) or created (if it did not exist)(provided the plausibility check was ok).
When the method executes, all available tables are first checked forerrors and consistency. If an error is detected in a record, it islogged internally and records related to this service are not writtento the database.
Example:
An error is detected for a record of the service BASICNURSINGCHARGE inthe structure SRVCAT_SRVDATA. Consequently, none of the records forBASICNURSINGCHARGE are written to the database, even if there are noerrors for this service in the structures SRVCAT_SRVDATA,SRVCAT_TXTDATA, etc.
For this reason, it is recommended that you first execute the module inTest mode. To do this, set the parameter TESTRUN. In this mode,all test routines are run. Errors encountered are logged in the tableRETURN, but are not written to the database.
In test mode, all of the records that would not be written to thedatabase in a live run are logged as well.
The following applies to the tables SRVCAT_ADDDATA, SRVCAT_PLNDATA andSRVCAT_COLDATA: You can change numerous SRVCAT_ADDDATA andSRVCAT_PLNDATA records for a service, but can only create one record(for SRVCAT_PLNDATA, a record can of course be created for eachrequesting organizational unit specified). If a record passed to theBAPI doesn't yet exist in the database, this record is created. If italready exists, it is changed.
Records may be created in accordance with the diagram below forSRVCAT_PLNDATA.
If you want to CREATE a new time interval for a service, all definedcolumns must be included in the data passed to the structureSRVCAT_COLDATA (they can be displayed using the method GetList) -regardless of whether their amount fields are filled. All of thesecolumns must be valid for the same time interval. This preventsinconsistencies in the database caused by the columns being valid fordifferent intervals.
Time intervals can be inserted as of the last start date available inthe database (new start date >= most recent start date in thedatabase):
|----------------------| (last) existing interval
|--------| new interval
|----------| new interval
|---------------| new interval
|---------------------------------| new interval
|----------| new interval
It is recommended that you specify the highdate (12/31/9999) for theend date (ENDDATE) of the last interval in the table SRVCAT_COLDATA Ifyou do not make this specification, slight problems with respect todelimitation can arise when services are created manually and problemscan also arise when extended services are billed for. However, sinceyou may well require in particular extended services to be discontinuedat a given date, a highdate is not automatically written in thecolumns.
It is recommended that you also specify the start date for newrecords. If this date is not specified explicitly, the date fromCustomizing for IS-H is used for SRVCAT_SRVDATA and SRVCAT_COLDATA and01/01/1990 is used for SRVCAT_ADDDATA and SRVCAT_PLNDATA.
If fields were added at a later date in the catalog column definitiontable in Customizing for IS-H, run the program RNUKARE2 before usingthis BAPI method. This program creates the subsequently added columnintervals for all relevant services in relation to the validityintervals of existing catalog columns.
Please note: The field COL_VALUE in the table SRVCAT_SRVDATA is avariable field to which charge factor values or monetary amounts can beassigned depending on the definition in Customizing. For this reason,the field must be filled completely. This means you also have tospecify leading zeros. The system automatically sets the decimal point.For instance, the specification "000000010050" corresponds to 100.50DEM or, depending on the catalog currency, 10050 Lira. As a rule, keyfields cannot be changed.
If a field of a structure is to be used, for which a field with thesame name and the suffix "_ISO" exists, the user can decide which ofthe two fields is to be filled. The _ISO field is for values (e.g.measures) compliant with the ISO standard; the corresponding fieldwithout the suffix "_ISO" is intended for values compliant with the SAPstandard. If the _ISO field is specified, this value is automaticallyconverted into the SAP value. However, the ISO and SAP standards areidentical in the vast majority of cases.
The fields CURRKEY and CURRKEY_ISO of the table SRVCAT_PLNDATA areexclusively export fields. They are filled by the system and user inputis ignored (SRVCAT_PLNDATA always contains the local currency).
It is not possible to change the start date of existing SRVCAT_COLDATA,SRVCAT_ADDDATA and SRVCAT_PLNDATA records. If included in the datapassed to the interface, this date is ignored.
The authorization check is performed using the authorizationobject N_EINR_TCO (NT02 is the transaction code for this object in SAPIS-H).
Change data is only changed if a corresponding change wascarried out: If the deletion flag is set, DELETION_DATE andDELETION_USER are changed also. If a record is changed, UPDATE_DATE andUPDATE_USER are changed. CREATION_USER and CREATION_DATE can only bechanged when a new record is created. The following applies to allchange data: if the required data is not passed via the interface, thesystem data is used.
SRVCAT_SRVDATA-SERVICEID and -EXTID (if it exists) are converted toupper-case. No other fields are converted to upper-case,SRVCAT_TXTDATA-SERVICEID or SRVCAT_SRVDATA-UPDATE_USER!
INCLUDE NBAPI_WORST_RETURNED_MSGTY
INCLUDE NBAPI_CLIENT
INCLUDE NBAPI_INSTITUTION

Description
Service catalog of an institution.
This field is alpha converted. This means that if you enter a number,you do not have to enter leading blanks or zeros.
INCLUDE NBAPI_TESTRUN

Description
Errors that occurred are returned in this table.

Value range
The following error messages can occur:

• N2 663: Service & is not defined in catalog & of institution &


• N2 664: Structure & is empty


• N2 665: Specify value for key field &


• N2 666: Service master record already exists for service &


• N2 667: The key field is different from the import parameter


• N2 668: Key fields (&) are missing from structure &


• N2 669: The key fields of structure & are not those of structure &


• N2 670: The & record already exists in the database


• N2 671: The calalog column specified in & is not defined


• N2 672: Key field not specified


• N2 673: Institution & does not exist


• N2 674: Catalog & does not exist


• N2 675: Start date after end date in & (&)


• N2 676: End date before system date in & (&)


• N2 677: Service text (&) contains illegal special characters


• N2 678: Value specified for & is not permitted by check table &


• N2 679: Checkbox & contains a non-permitted value (&)


• N2 680: Structure & contains entries with identical key fields


• N2 681: The client in structure & is not the system client


• N2 682: Numeric field & contains non-permitted characters (&)


• N2 683: Structure & contains overlapping time periods


• N2 684: No material found for & (&)


• N2 685: This field only exists with extended services (&)


• N2 686: Age specifications are inconsistent (&)


• N2 687: Indicator can only be set for groups (&)


• N2 688: The charge type (&) must be an extended service (&


• N2 689: The charge type (&) must not be an extended service (&)


• N2 690: You specified a field that must not occur with groups (&)


• N2 691: Structure & must not exist for a service group (&)


• N2 692: SS_NTPKD values only exist for procedures surcharges and FR per
case (&)

• N2 693: SS_NTPP-STAGE only exist with procedures surcharges (&)


• N2 694: Length of stay is only relevant for flat rates per case (&)


• N2 695: Text does not exist for the service (&)


• N2 696: & record was not written to the DB - no corresponding SS_NTPK
record

• N2 697: Service master record not defined for service &


• N2 698: Only one & record per service can be created for each column
(&)

• N2 699: Different time intervals for columns to be created for a
service

• N2 721: Time interval for column creation is not allowed for service &


• N2 722: All column values must be specified when creating a column (&)


• N2 723: Organizational unit & specified in SS_NTPP does not exist (&)


• N2 724: Do not change the charge type for a service in production
operation

• N2 725: Do not change the valuation formula for a service in production
operation

• N2 726: Do not change the group indicator for a service (&)


• N2 727: 'Absence-relevant' indicator for extended services only (&)


• N2 728: & record contains errors. Not written to database (&).

Note:
If a message text in the above list is followed by "(&)", thisplaceholder stands for the service which caused the error to occur.

Description
Additional data (in particular for flat rates per case and proceduressurcharges) for a service is passed to the BAPI in this table.
For this to be possible, the service must exist in the catalog and musthave a corresponding record in the table SRVCAT_SRVDATA. If a recordwith the key fields you specified already exists in the database, thisrecord is modified. If no such records exists, a record is created.
You can only create one new SRVCAT_ADDDATA record for a service, butcan change as many as you like.
For further information, refer also to the documentation on ChangeItem.

Description
Additional data for a service for the country version Austria is passedto the BAPI in this table.
For this to be possible, the service must exist in the catalog and musthave a corresponding record in the table SRVCAT_SRVDATA. If a recordwith the key fields you specified already exists in the database, thisrecord is modified. If no such records exists, a record is created.
You can only create and change one new SRVCAT_ADDDATAT record for aservice.
For further information, refer also to the documentation on ChangeItem.
INCLUDE NBAPI_SRVCAT_ADDDATAT

Description
Additional data (for the TARMED service catalog) for the countryversion Switzerland and/or Austria is passed to the method in thistable.
To make this possible, the service must have been defined in thecatalog, and a corresponding record must exist in table SRVCAT_SRVDATA.If the datanbase contains a record with the key fields you specified,this record is modified; in the contrary case, a new record is created.
You can only create and change one new SRVCAT_ADDDATCH record for aservice.
For further information, see the documentation on the parameterChangeItem.

Description
The assignments service master Switzerland => age (for the servicecatalog TARMED) for a service are passed to the method in this table.
To make this possible, the service must have been defined in thecatalog, and a corresponding record must exist in table SRVCAT_SRVDATA.If the datanbase contains a record with the key fields you specified,this record is modified; in the contrary case, a new record is created.You can only create one new SRVCAT_ADDDATCH_AG record for a service, orchange as many as you like.
For further information, see the documentation on parameter ChangeItem.

Description
The service master Switzerland-to-combined service assignments (for theservice catalog TARMED) pertaining to a service are passed to the BAPIin this table.
For this to be possible, the service must exist in the catalog and acorresponding record must be contained in the table SRVCAT_SRVDATA. Ifthe database already contains a record with the key fields youspecified, this record will be modified. In the contrary case, a newrecord is created. You can only create one new SRVCAT_ADDDATCH_KOrecord for a service, but can change any number of such records.
For further information, refer also to the documentation forChangeItem.

Description
The assignments service master Switzerland => excluding service (forthe service catalog TARMED) for a service are passed to the method inthis table.
To make this possible, the service must have been defined in thecatalog, and a corresponding record must exist in table SRVCAT_SRVDATA.If the datanbase contains a record with the key fields you specified,this record is modified; in the contrary case, a new record is created.You can only create one new SRVCAT_ADDDATCH_KU record for a service, orchange as many as you like.
For further information, see the documentation on parameter ChangeItem.

Description
The service master Switzerland-to-maximum rule assignments (for theTARMED service catalog) pertaining to a service are passed to the BAPIin this table.
For this to be possible, the service must have been defined in thecatalog, and a corresponding record must exist in table SRVCAT_SRVDATA.If the database contains a record with the key fields you specified,this record is modified; in the contrary case, a new record is created.You can only create one new SRVCAT_ADDDATCH_MX record for a service, orchange as many as you like.
For more information, see the documentation on ChangeItem.
INCLUDE NBAPI_SRVCAT_ADDDATCH_MX

Description
Data on the service breakdown pertaining to a service for the countryversion Switzerland is passed to the BAPI in this table.
For this to be possible, the service must exist in the catalog and acorresponding record must be contained in the table SRVCAT_SRVDATA. Ifa record with the key fields you specified already exists in thedatabase, it is modified. In the contrary case, a new record iscreated.
You can only create one SRVCAT_ADDDATCH_N1 record, but can change anynumber of SRVCAT_ADDDATCH_N1 records for a service.
For further information, refer also to the documentation on ChangeItem.
INCLUDE NBAPI_SRVCAT_ADDDATCH_N1

Description
Texts for service breakdown pertaining to a service for the countryversion Switzerland are passed to the BAPI in this table.
For this to be possible, the service must exist in the catalog and acorresponding record must be contained in the table SRVCAT_SRVDATA. Thetable SRVCAT_ADDATCH_N1 must contain an identical record thatreferences the corresponding record. If the database already contains arecord with the key fields you specified, this record is changed. Inthe contrary case, a new record is created.
You can only create one SRVCAT_ADDDATCH_N1T record, but can change anynumber of SRVCAT_ADDDATCH_N1T records for a service.
For further information, refer also to the documentation on ChangeItem.
INCLUDE NBAPI_SRVCAT_ADDDATCH_N1T

Description
The assignments service master Switzerland => qualitative grade (forthe service catalog TARMED) for a service are passed to the method inthis table.
To make this possible, the service must have been defined in thecatalog, and a corresponding record must exist in table SRVCAT_SRVDATA.If the datanbase contains a record with the key fields you specified,this record is modified; in the contrary case, a new record is created.You can only create one new SRVCAT_ADDDATCH_QL record for a service, orchange as many as you like.
For further information, see the documentation in parameter ChangeItem.

Description
The assignments service master Switzerland => quantitative grade (forthe service catalog TARMED) for a service are passed to the method inthis table.
To make this possible, the service must have been defined in thecatalog, and a corresponding record must exist in table SRVCAT_SRVDATA.If the datanbase contains a record with the key fields you specified,this record is modified; in the contrary case, a new record is created.You can only create one new SRVCAT_ADDDATCH_QT record for a service, orchange as many as you like.
For further information, see the documentation on parameter ChangeItem.

Description
The assignments service master Switzerland => division (for the servicecatalog TARMED) for a service are passed to the method in this table.
To make this possible, the service must have been defined in thecatalog, and a corresponding record must exist in table SRVCAT_SRVDATA.If the datanbase contains a record with the key fields you specified,this record is modified; in the contrary case, a new record is created.You can only create one new SRVCAT_ADDDATCH_SP record for a service, orchange as many as you like.
For further information, see the documentation on parameter ChangeItem.

Description
The service-to-IV qualifier assignment pertaining to a service for thecountry version Switzerland is passed to the BAPI in this table.
For this to be possible, the service must already exist in the catalogand a corresponding record must be contained in the tableSRVCAT_SRVDATA. If the database already contains a record with the keyfields you specified, this record is changed. In the contrary case, anew record is created.
You can only create one SRVCAT_ADDDATCH_W1 record, but change anynumber of SRVCAT_ADDDATCH_W1 records for a service.
For further information, refer also to the documentation on ChangeItem.
INCLUDE NBAPI_SRVCAT_ADDDATCH_W1

Description
Columns for a service are passed to the BAPI in this table. For this tobe possible, the service must exist in the catalog and a correspondingrecord must exist for it in the table SRVCAT_SRVDATA. If a record withthe key fields you specified already exists in the database, thisrecord is changed. Otherwise, a new record is created.
You can only create one new SRVCAT_COLDATA record for a service, butcan change as many as you like. If a new record (i.e. a new validityperiod for the service) to be created, you have to include all thecolumns of the catalog you use that were defined in Customizing forIS-H - irrespective of whether you fill these columns with values.
For further information, refer also to the documentation on ChangeItem.
INCLUDE NBAPI_SRVCAT_COLDATA

Description
Planned values for a service are passed to the BAPI in this table.
For this to be possible, the service must exist in the catalog and musthave a corresponding record in the table SRVCAT_SRVDATA. If a recordwith the key fields you specified already exists in the database, thisrecord is modified. If no such records exists, a record is created.
You can only create one new SRVCAT_PLNDATA record for a service (perrequesting organizational unit), but can change as many as you like.
For further information, refer also to the documentation on ChangeItem.
INCLUDE NBAPI_SRVCAT_PLNDATA

Description
The services specified in the import parameter are passed to the BAPIin this table.
Since the method ChangeItem only serves to change existing services,the services listed must already exist in the catalog.
INCLUDE NBAPI_SRVCAT_SRVDATA

Description
The texts for services are passed to the BAPI in this table. For thisto be possible, the service must exist in the catalog and acorresponding record must exist for it in the table SRVCAT_SRVDATA.
If a record with the key fields you specified already exists in thedatabase, this record is changed, otherwise a new record is created.
INCLUDE NBAPI_SRVCAT_TXTDATA