Functionality
INCLUDE NBAPI_ISH
It is used to create a new service.
You must specify the import parameters 'client', 'institution' and'catalog' in which the service should be created.
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_PLNDATA : Planned values for the service
SRVCAT_ADDDATA : Additional data for special services
(e.g. FR, PS)
SRVCAT_ADDDATCH : Add. data service master Switzerland
SRVCAT_ADDDATCH_AG : Service master Switzerland => age asgmt
SRVCAT_ADDDATCH_KU : Service master Switzerland => excluding
service assignment
SRVCAT_ADDDATCH_QL : Service master Switzerland => qualitative
grade assignment
SRVCAT_ADDDATCH_QT : Service master Switzerland => quantitative
grade assignment
SRVCAT_ADDDATCH_SP : Service master Switzerland => divisionasgmt
SRVCAT_ADDDATCH_N1 : Service breakdown Switzerland
SRVCAT_ADDDATCH_N1T: Service breakdown - texts Switzerland
SRVCAT_ADDDATCH_W1 : Service master Switzerland => IV qualifier
assignment
You must only fill the structure SRVCAT_SRVDATA to create a service.The specification of other structures is optional. If you also specifysuch structures can, all key fields must be filled. The specificationof the key field "client" is optional.
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_COLDATA. 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_COLDATA, etc. For this reason, it is recommended to firstexecute the module in Test mode. To do this, set the parameterTESTRUN. In this mode, all test routines are run. Errors that occur arelogged in the table RETURN, but are not written to the database.
In test mode, those records that would not be written to the databasein a live run are logged as well.
The authorization check is performed using the authorizationobject N_EINR_TCO (NT01 is the transaction code for this object in SAPIS-H).
You can create as many (column) intervals as you like for aservice. The specification of SRVCAT_COLDATA records for anSRVCAT_SRVDATA record is optional. If a column record is passed aswell, all columns defined in Customizing for IS-H (IS-H table NTSI)must be specified for each time interval of the structureSRVCAT_COLDATA - regardless of whether they are filled with values.This specification should help prevent inconsistencies in the databasecaused by different time intervals for individual columns.
The system checks whether all columns were specified for an intervaland whether the individual intervals overlap.
If the individual intervals do not overlap, there are no restrictionswith respect to the intervals.
It is recommended that you do not leave gaps between the time intervalsand to use the highdate (12/31/9999) for the upper limit(SRVCAT_COLDATA-ENDDATE) of the most recent 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 therecords. 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. This may giverise to error messages of the type "end date before system date" thatcan initially appear incomprehensible.
Please note: The field COL_VALUE in the table SRVCAT_SRVDATA is aspecial type of field to which charge factor values or monetary amountscan be assigned. For this reason, the field must be filled completely.This means you also have to specify leading zeros. The systemautomatically sets the decimal point. For instance, the specification"000000010050" corresponds to 100.50 DEM or, depending on the catalogcurrency, 10050 Lira.
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).
If you do not specify the fields pertaining to the person who madechanges (DELETION_USER, DELETION_DATE, CREATION_USER, CREATION_DATE,UPDATE_USER, UPDATE_DATE in SRVCAT_SRVDATA, SRVCAT_COLDATA andSRVCAT_TXTDATA; UPDATE_USER, UPDATE_DATE in SRVCAT_ADDDATA;CREATION_DATE, CREATION_USER, CREATION_TIME, UPDATE_DATE, UPDATE_USER,UPDATE_TIME in SRVCAT_ADDDATCH, SRVCAT_ADDDATCH_AG, SRVCAT_ADDDATCH_KU,SRVCAT_ADDDATCH_QL, SRVCAT_ADDDATCH_QT sowie SRVCAT_ADDDATCH_SP), theyare automatically filled with system data (this only applies toDELETION_USER and DELETION_DATE if the deletion flag DELETION_IND isset).
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 occur 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 727: 'Absence-relevant' indicator for extended services only (&)


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

Note:
When a message text above is followed by "(&)", this placeholder standsfor the service that caused the error.

Description
Additional data (in particular for procedures surcharges and flat ratesper case) for a service are passed to the BAPI in this table.
For this to be possible, you must have entered a corresponding recordin the table SRVCAT_SRVDATA.
You can create as many SRVCAT_ADDDATA records as you like for aservice.
For further information, refer also to the documentation on AddItem.
INCLUDE NBAPI_SRVCAT_ADDDATA

Description
Additional data for a service for the country version Austria is passedto the BAPI in this table.
For this to be possible, you must have entered a corresponding recordin the table SRVCAT_SRVDATA.
You can only create one SRVCAT_ADDDATAT record for a service.
For further information, refer also to the documentation on AddItem.
INCLUDE NBAPI_SRVCAT_ADDDATAT

Description
Additional data (for the TARMED service catalog) pertaining to aservice for the country version Switzerland and/or Austria is passed tothe BAPI in this table.
For this to be possible, a corresponding record must be contained inthe table SRVCAT_SRVDATA.
You can only create one SRVCAT_ADDDATCH record for a service.
For further information, refer also to the documentation for AddItem.

Description
The service master Switzerland-to-age assignments (for the TARMEDservice catalog) pertaining to a service are passed to the BAPI in thistable.
For this to be possible, a corresponding record must be contained inthe table SRVCAT_SRVDATA.
You can create any number of SRVCAT_ADDDATCH_AG records for a service.
For further information, refer also to the documentation on AddItem.AddItem.

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, a corresponding record must be contained inthe table SRVCAT_SRVDATA.
You can create any number of SRVCAT_ADDDATCH_KO records for a service.
For further information, refer also to the documentation for AddItem.

Description
The service master Switzerland-to-excluding service assignments (forthe TARMED service catalog) pertaining to a service are passed to theBAPI in this table.
For this to be possible, a corresponding record must be contained inthe table SRVCAT_SRVDATA.
You can create any number of SRVCAT_ADDDATCH_KU records for a service.
For further information, refer also to the documentation on AddItem.AddItem.

Description
The service master Switzerland-to-maximum rule assignments pertainingto a service (for the TARMED service catalog) are passed to the BAPI inthis table.
For this to be possible, a corresponding record must be contained inthe table SRVCAT_SRVDATA.
You can create any number of SRVCAT_ADDDATCH_MX records for a service.anlegen.
For further information, refer also to the documentation on AddItem.
INCLUDE NBAPI_SRVCAT_ADDDATCH_MX

Description
Data on service breakdown pertaining to a service for the countryversion Switzerland is passed to the BAPI in this table.
For this to be possible, a corresponding record must be contained inthe table SRVCAT_SRVDATA.
You can create any number of SRVCAT_ADDDATCH_N1 records for a service.
For further information, refer also to the documentation on AddItem.
INCLUDE NBAPI_SRVCAT_ADDDATCH_N1

Description
The 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, a corresponding record must be contained inthe table SRVCAT_SRVDATA.
You can create any number of SRVCAT_ADDDATCH_N1T records for a service.Note also that for each of these text records, table SRVCAT_ADDDATCH_N1must contain an "actual" service breakdown record.
For further information, refer also to the documentation on AddItem.
INCLUDE NBAPI_SRVCAT_ADDDATCH_N1T

Description
The service master Switzerland-to-qualitative grade assignmentspertaining to a service (for the TARMED service catalog) are passed tothe BAPI in this table.
For this to be possible, a corresponding record must be contained inthe table SRVCAT_SRVDATA.
You can create any number of SRVCAT_ADDDATCH_QL records for a service.
For further information, refer also to the documentation on AddItem.AddItem.

Description
The service master Switzerland-to-quantitative grade assignmentspertaining to a service (for the TARMED service catalog) are passed tothe BAPI in this table.
For this to be possible, a corresponding record must be contained inthe table SRVCAT_SRVDATA.
You can create any number of SRVCAT_ADDDATCH_QT records for a service.
For further information, refer also to the documentation on AddItem.

Description
The service master Switzerland-to-division assignments pertaining to aservice (for the TARMED service catalog) are passed to the BAPI in thistable.
For this to be possible, a corresponding record must be contained inthe table SRVCAT_SRVDATA.
You can create any number of SRVCAT_ADDDATCH_SP records for a service.
For further information, refer also to the documentation on AddItem.

Description
Data on the service-to-IV qualifier assignment for the country versionSwitzerland is passed to the BAPI in this table.
For this to be possible, a corresponding record must be contained inthe table SRVCAT_SRVDATA.
You can create any number of SRVCAT_ADDDATCH_W1 records for a service.
For further information, refer also to the documentation on AddItem.
INCLUDE NBAPI_SRVCAT_ADDDATCH_W1

Description
Columns for a service are passed to the BAPI in this table. For this tobe possible, a corresponding record must be contained in the tableSRVCAT_SRVDATA.
You can create as many SRVCAT_COLDATA records as you like (or none atall) for a service. If a record (i.e. a time interval for the validityof the service) is to be created, you must also specify all of thecolumns (defined in Customizing for IS-H) of the catalog you use,regardless of whether you fill these columns with values.
For further information, refer also to the documentation on AddItem.
INCLUDE NBAPI_SRVCAT_COLDATA

Description
The planned values of a service are passed to the BAPI in this table.
To make this possible, a corresponding service record must be containedin the table SRVCAT_SRVDATA.
You can create as many SRVCAT_PLNDATA records as you like for aservice.
For further information, refer also to the documentation on AddItem.
INCLUDE NBAPI_SRVCAT_PLNDATA

Description
The services of the catalog specified in the import parameter arepassed to the BAPI in this table.
The services passed in the table are created if they do not alreadyexist. If they already exist in the system, this information isrecorded in the error table.
INCLUDE NBAPI_SRVCAT_SRVDATA

Description
The texts for the services are passed to the BAPI in this table. Forthis to be possible, the corresponding service must be contained in thetable SRVCAT_SRVDATA.
INCLUDE NBAPI_SRVCAT_TXTDATA