Fonction SAP BAPI_CASEPROCEDURE_CREATEMULT - IS-H BAPI CaseProcedure.CreateMultiple - Create Case-Related Procedures

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
CLIENT BAPINALL-CLIENT C 3 Client
INSTITUTION BAPI1303DATA-INSTITUTION C 4 Institution
PATCASEID BAPI1303DATA-PATCASEID C 10 Case Number
TESTRUN BAPINALL-TESTRUN C 1 SPACE X Test Mode (No Changes in Database)

Paramètre Reférence Type Long. Description
WORST_RETURNED_MSGTY BAPINALL-WORSTRETMSG C 1 Most Severe Message Type

Paramètre Reférence Long. Facultatif Description
CASEPROCEDURE_ASSDIA BAPI1303ASSDIA 70 X Table Containing the Generated Diagnosis Assignments
CASEPROCEDURE_ASSSRV BAPI1303ASSSRV 78 X Table Containing the Generated Service Assignments
CASEPROCEDURE_CASSDIA BAPI1303CASSDIA 34 X Assignments to Diagnoses to Be Created
CASEPROCEDURE_CASSSRV BAPI1303CASSSRV 43 X Assignments to Services to Be Created
CASEPROCEDURE_CDATA BAPI1303CDATA 228 Data for Procedures to Be Created
CASEPROCEDURE_DATA BAPI1303DATA 382 X Table Containing the Generated Procedures
RETURN BAPIRET2 548 X Return Messages

Functionality
INCLUDE NBAPI_ISH
It creates procedures (including service assignments/diagnosisassignments) for a specific case. For this to be possible, the servicesand diagnoses must exist in the database.
You can create

  • Movement-related procedures

  • Including assignments to services and/or diagnoses, if appropriate
    • Case-related procedures

    • Procedures relevant for DRGs.

    • All error, warning and information messages that are generated arecollected in the table RETURN. The most severe error type isreturned in the parameter WORST_RETURNED_MSGTY.
      The consistency of the data passed to the method can be checked in testmode. When you execute the method in test mode, it returns the generatedprocedures in the table CASEPROCEDURE_DATA. The fieldCASESEPROCEDURE_DATA-SURPROC_SEQNO contains a temporary value that isgreater than 9000000000.
      If you wish to assign a procedure to a specific movement, you must fillthe field CASEPROCEDURE_CDATA-MOVEMENT_SEQNO and the fieldCASEPROCEDURE_CDATA-MOVEMENT_SEQNOX. You can, however, only makeassignments to surgery movements. Assignments to movements other thansurgery movements are refused, and the procedure record is flagged aserrored.
      Every procedure that is not assigned to a surgery movement isautomatically case-related. The date, time and organizational unit canbe specified for these procedures. If no values for these fields werepassed to the method, the relevant values are determined from currentmovements and can be modified again using the SAP enhancementISH_PROCEDURE_PROPOS.
      If you want to use the data of a particular movement as default valuesfor case-related procedures, you need simply fill the fieldMOVEMENT_PROPOSAL in the table CASEPROCEDURE_CDATA with thesequence number of an existing movement from which the date, time andorganizational units should be taken for the procedure. Filling thisfield does not create a movement reference for the procedure.
      A procedure is created in the DRG catalog if the indicatorCASEPROCEDURE_CDATA-DRG_MODE is set. The DRG catalog is specifiedin the parameter DRGTARIF in Customizing under SAP Healthcare -Industry-Specific Components for Hospitals - Basic Settings - SystemParameters - Maintain Institution-Specific, Time-Dependent Parameters.If the field DRG_MODE is initial, the procedures catalog will bedetermined from the system parameter OP_TARIF. Depending on the countryversion and case type, either the admission date or the procedure dateis used to determine the procedure catalog.
      Services or diagnoses cannot be assigned to case-related andDRG-relevant procedures. If assignments to case-related procedures arenevertheless passed in the table CASEPROCEDURE_CASSSRV or
      CASEPROCEDURE_CASSDIA, the entire procedure record is flagged as erroredand its processing is discontinued.
      The service assignments and/or diagnosis assignments to be created mustbe linked to the relevant procedure via the field CASEPROCEDURE_CASSSRV-
      PRC_ACTIONSEQNO or CASEPROCEDURE_CASSDIA-
      PRC_ACTIONSEQNO. The fields RULETYPE, ACTIONSEQNO andDIA_ACTIONSEQNO are currently not active, and, as such, can remaininitial.
      Service assignments and diagnosis assignments for which a procedurerecord does not exist are flagged as errored and are not taken intoaccount.
      At present, the services and diagnoses to be assigned must alreadyexist in the database.
      If the service number or diagnosis number is not found in the internaltable or in the database, the procedure will not be created, since theentire process is errored.
      You can store a comment (max. length 50-characters) pertaining to aprocedure via the field PROC_REMARK. Integration with theSAPscript editor is currently not supported.

      Notes
      INCLUDE NBAPI_PRECOND_AUTHORITIES
      RESET N1
      N_NICP_FAL
      Creation, modification and deletion of procedures with assignments
      INCLUDE BAPI_RET

      Further information
      The following activities are not implemented in the currentversion of this method:
      The automatic generation of the services defined in Customizing whenmovement-related services are entered.
      The automatic assignment of the procedure to services.
      The automatic assignment of the procedure to diagnoses.
      The creation of SAPscript long texts.
      INCLUDE NBAPI_WORST_RETURNED_MSGTY
      INCLUDE NBAPI_CLIENT
      INCLUDE NBAPI_INSTITUTION
      INCLUDE NBAPI_PATCASEID
      INCLUDE NBAPI_TESTRUN

      Description
      All of the generated assignments of procedures to diagnoses are passedin this table.

      Description
      All of the generated assignments of procedures to services are passedin this table.

      Description
      If you wish to create additional diagnosis assignments for a procedure,you can specify these assignments in this table.
      Please note the following rules when filling this table:

      • The field RULETYPE is currently inactive, and, as such, can be
      • left empty.
        • In the field PRC_ACTIONSEQNO, specify the number of the
        • procedure record for which the diagnosis assignment is to be created.The diagnosis assignments are linked to their corresponding procedurerecord in the tables CASEPROCEDURE_CDATA andCASEPROCEDURE_CASSDIA using this field.
          • The field DIA_ACTIONSEQNO is currently inactive, and, as such,
          • can be left empty.
            • You have to specify "I" for "Create" in the ACTION field.

            • The sequence number of a diagnosis that exists for the case must be
            • specified in the field DIAG_SEQNO.
              Note that diagnosis assignments can only be created formovement-related procedures.

              Description
              If you wish to create additional service assignments for a procedure,you can specify these assignments in this table.
              Please note the following rules when filling this table:

              • The field RULETYPE is currently inactive, and, as such, can be
              • left empty.
                • In the field PRC_ACTIONSEQNO, specify the number of the
                • procedure record for which the service assignment is to be created. Theservice assignments are linked to their corresponding procedure recordin the tables CASEPROCEDURE_CDATA and CASEPROCEDURE_CASSSRV
                  using this field.
                  • The field ACTIONSEQNO is currently inactive, and, as such, can
                  • be left empty.
                    • You have to specify "I" for "Create" in the ACTION field.

                    • The sequence number of a service that exists for the case must be
                    • specified in the field SERVICE_SEQNO.
                      Note that service assignments can only be created for movement-relatedprocedures.

                      Description
                      In this table you specify the data of the procedures to be created.
                      Note the following rules when filling the table:

                      • You must leave the field SURPROC_SEQNO blank. The system
                      • specifies this number when creating a new surgical procedure code.External number assignment is not supported here.
                        • The field RULETYPE is currently inactive, and, as such, can
                        • remain empty.
                          • In the field PRC_ACTIONSEQNOeach surgical procedure code to be created. "1" for the first tableentry, "2" for the second table entry and so on.
                            • Specify "I" (for Insert) in the field ACTION.

                            • The field MOVEMENT_PROPOSAL can be filled when creating a
                            • case-related procedure. The field should contain the sequence number ofa movement that exists for the case. The system takes the defaultvalues (start date, start time, nursing organizational unit, departmentorganizational unit) from this movement when creating the newprocedure.
                              The fields MOVEMENT_PROPOSAL and MOVEMENT_SEQNO must not be specifiedat the same time.
                              • If you passed an "X" in the field DRG_MODE, the procedures are
                              • created in the DRG catalog. If the field is initial, the procedure willbe created in the surgical procedures catalog. If the DRG catalog andthe procedures catalog are identical, you can leave this field blank.
                                You define the relevant catalogs in the system parameters OP_TARIF andDRGTARIF in Customizing for IS-H by choosing SAP Healthcare -Industry-Specific Components for Hospitals -> Basic Settings -> SystemParameters -> MaintainInstitution-Specific, Time-Independent Parameters.
                                • In the field SG_PR_CODE, specify the surgical procedure code to
                                • be created.
                                  You can specify attributes of the procedures to be created in thefields of the table CASEPROCEDURE_CDATA for which a field withthe same name and the suffix "X" exists in the structure. The relevantattribute is only evaluated if the corresponding "X field" contains an"X".
                                  If a procedure is to be assigned to a movement, the fieldCASEPROCEDURE_CDATA-MOVEMENT_SEQNO must contain the sequencenumber of a movement that exists for the current case. The movementmust be a surgery movement since assignment to movements of anothercategory are not allowed. The fieldCASEPROCEDURE_CDATA-MOVEMENT_SEQNOX must also contain the value"X".
                                  If you want to use the date and time from a movement that exists forthe case as default values when creating a procedure, fill the fieldCASEPROCEDURE_CDATA-MOVEMENT_PROPOSAL with the sequence numberof a movement that exists for the current case. The movement category(admission, transfer, outpatient visit, surgery, etc.) is irrelevanthere.
                                  Note that this field can only be set for case-related procedures. Thespecification of CASEPROCEDURE_CDATA-MOVEMENT_SEQNO andCASEPROCEDURE_CDATA-MOVEMENT_PROPOSAL is not allowed. If thesefields are filled, the processing of the procedure record is refused.
                                  You can make entries in the fields BEGINDATE, BEGINTIME,ENDDATE, DEPTOU and PERFOU only for case-relatedprocedures. A procedure is related to exactly one case when there is nospecification in the field MOVEMENT_SEQNO.
                                  The method attempts to generate each record passed to it. Recordscontaining errors are flagged (by "!" in the fieldCASEPROCEDURE_CDATA-ACTION and skipped. Any errors that occurredare collected in the parameter RETURN.
                                  If you wish to create additional service assignments for a procedure,you can specify these assignments in the tableCASEPROCEDURE_CASSSRV. To create diagnosis assignments, you mustfill the table CASEPROCEDURE_CASSDIA. In such cases, the relateddata records must be linked explicitly via the fields RULETYPEand PRC_ACTIONSEQNO. The field ACTIONSEQNO contains asequence number of your choosing.

                                  Description
                                  The generated procedures together with the most important procedureattributes are returned in this table.
                                  To enable the procedure data passed to the method to be assigned to thegenerated data, in test mode the field
                                  CASEPROCEDURE_DATA-SURPROC_SEQNO contains the index of the relevantCASEPROCEDURE_CDATA record. In live mode, the fieldCASESERVICE_DATA-SURPROC_SEQNO contains the assigned procedurecode that is also to be found in the relevant CASEPROCEDURE_CDATA
                                  record.

                                  Description
                                  Errors that occurred are returned in this table.

                                  Value range
                                  The following error messages can occur:

                                  • NC603:,,,,Current client is , but data is
                                  • determined for client
                                    • MC600:,,,,System error occurred during lock management

                                    • MC601:,,,,Object requested is currently locked by user

                                      • MC602:,,,,The requested object is locked by another
                                      • transaction
                                        • MC603:,,,,Lock table overflow

                                        • DA300:,,,,No active nametab exists for

                                        • NICP002:,,You are not authorized to create or change
                                        • procedures
                                          • NS016:,,,,Institution does not exist

                                          • N1117:,,,,Institution does not exist
                                          • N1034:,,,,Case does not exist
                                            • N1613:,,,,You are not authorized to process this case in
                                            • institution
                                              • N1601:,,,,Number of parameters in check object
                                              • is invalid
                                                • N1602:,,,,Specified object is not
                                                • maintained in user master
                                                  • N1603:,,,,No profile is entered in user master

                                                  • N1604:,,,,Authorization for
                                                  • to be checked not found in user master
                                                    • N1606:,,,,You are not authorized to carry out actions in
                                                    • the SAP System
                                                      • N1605:,,,,User master is set up incorrectly
                                                      • (SY-SUBRC = )
                                                        • N1026:,,,,Case is canceled

                                                        • N3298:,,,,Case is billed; you can only make certain
                                                        • changes to procedures
                                                          • BS005:,,,,Process & is not supported (&) (Med. Status)

                                                          • BS006:,,,,"&" is not allowed (&) (Med. Status)

                                                          • BS059:,,,,No authorization for activating user status &

                                                          • BS060:,,,,No authorization for deleting user status &

                                                          • N1002:,,,,Case has no other movements

                                                          • N1114:,,,,No entry for system parameter in inst. &
                                                          • (time-dep.) on &
                                                            • 00002:,,,,Enter a valid value

                                                            • NICP005:,,Invalid processing mode (only & allowed
                                                            • here)
                                                              • NICP006:,,Enter a valid procedure code

                                                              • NICP007:,,Illegal entry in field LNRIC

                                                              • NICP008:,,Movement with sequence number & does not
                                                              • exist
                                                                • NICP009:,,Cannot find number range interval for
                                                                • ISH_NICP
                                                                  • NICP010:,,Invalid processing mode &

                                                                  • NICP011:,,Invalid service assignment

                                                                  • NICP012:,,Invalid diagnosis assignment

                                                                  • NICP013:,,Procedure is assigned to movement. You
                                                                  • cannot enter date/OUs.
                                                                    • NICP014:,,You cannot specify the entry sequence

                                                                    • NICP015:,,Source specifications for procedure &1 are
                                                                    • incomplete
                                                                      • NICP016:,,Source specifications for procedure &1 are
                                                                      • illegal
                                                                        • NICP017:,,Source specifications for procedure &1 are
                                                                        • invalid
                                                                          • NICP018:,,Invalid procedure action in a service
                                                                          • assignment
                                                                            • NICP019:,,Invalid procedure action in a diagnosis
                                                                            • assignment
                                                                              • NICP020:,,You cannot assign procedure & to a movement

                                                                              • NICP021:,,Diagnosis &1/&2/&3 does not exist

                                                                              • NICP023:,,Catalog & does not match surgical procedure
                                                                              • catalog &
                                                                                • NICP024:,,Procedure & is already assigned to movement

                                                                                  • NICP025:,,Illegal specification of procedure catalog &

                                                                                  • NICP026:,,Selecting DRG Relevant is not allowed

                                                                                  • NICP027:,,You have already made this service
                                                                                  • assignment
                                                                                    • NICP028:,,You have already made this diagnosis
                                                                                    • assignment
                                                                                      • NICP029:,,Procedure & is case-related. Service
                                                                                      • assignment is not possible.
                                                                                        • NICP030:,,Procedure & is case-related. Diagnosis
                                                                                        • assignment is not possible.
                                                                                          • NICP031:,,Service & is extended service. Assignment is
                                                                                          • not possible.
                                                                                            • NICP032:,,Service &1 is not assigned to movement &2

                                                                                            • NICP033:,,Diagnosis &1 is not assigned to movement &2

                                                                                            • NICP034:,,Indicator is not permitted for internal
                                                                                            • procedure &1
                                                                                              • NICP042:,,Service assignment is not permitted for
                                                                                              • internal procedure &
                                                                                                • NICP043:,,Diagnosis assignment is not permitted for
                                                                                                • internal procedure &
                                                                                                  • NICP047:,,Illegal entry in field "DRG data maintenance
                                                                                                  • active / inactive"
                                                                                                    • NICP056:,,Specify localization for procedure &

                                                                                                    • NICP057:,,Localization & is invalid

                                                                                                    • NICP064:,,Quantities and units of measure cannot be
                                                                                                    • entered for procedure &
                                                                                                      • NICP065:,,Procedure & is quantity-based. Enter a
                                                                                                      • quantity.
                                                                                                        • NICP066:,,Procedure & is quantity-based. Enter a unit
                                                                                                        • of measure.
                                                                                                          • NICP067:,,You can only enter procedure & in unit of
                                                                                                          • measure &
                                                                                                            • NICP068:,,Units & and & have different dimensions

                                                                                                            • N3294:,,,,You can only enter number of surgeries for
                                                                                                            • procedures flagged as main code
                                                                                                              • N1563:,,,,Movement number & of case does not
                                                                                                              • exist
                                                                                                                • N1298:,,,,Visit type & is not a surgery (check your
                                                                                                                • entry)
                                                                                                                  • N0466:,,,,Service catalog & is not defined in
                                                                                                                  • institution &
                                                                                                                    • N3891:,,,,Procedure code & does not exist in catalog &

                                                                                                                    • N1356:,,,,Surgery type &2 is not supported in
                                                                                                                    • institution &1 (check your entry)
                                                                                                                      • N3810:,,,,Specify a valid DRG category

                                                                                                                      • N3854:,,,,You have not set the main code ind. for a
                                                                                                                      • surg. procedure (check)
                                                                                                                        • N2041:,,,,Organizational unit & does not exist

                                                                                                                        • N2046:,,,,Organizational unit & does not exist in
                                                                                                                        • institution &
                                                                                                                          • N2047:,,,,Org. ID & is not valid in the given period

                                                                                                                          • N1198:,,,,Organizational unit & is currently not
                                                                                                                          • available
                                                                                                                            • N1199:,,,,Organizational unit & has not been released

                                                                                                                            • NE501:,,,,Service &1/&2/&3 is not defined

                                                                                                                            • N3767:,,,,No valid procedures catalog (&) exists between
                                                                                                                            • and
                                                                                                                              The following warning messages can occur:
                                                                                                                              • N3432:,,,,No services match the specified selection
                                                                                                                              • criteria
                                                                                                                                • N3851:,,,,Main code indicator set more than once (check)