SAP Function BAPI_MEDSRV_CHANGEMULT_PATIENT - IS-H*MED: BAPI Medical Service Change Multiple - Change Medical Services

Parameter Reference Type Length Default Optional Text
CLIENT BAPINALL-CLIENT C 3 Client
INSTITUTION BAPI1410DATA-INSTITUTION C 4 IS-H: Institution
PATIENTID BAPI1410DATA-PATIENTID C 10 IS-H: Patient Number
TESTRUN BAPINALL-TESTRUN C 1 X IS-H: Test Run Without Database Changes (Checkbox)

Parameter Reference Type Length Text
WORST_RETURNED_MSGTY BAPINALL-WORSTRETMSG C 1 IS-H: Most Severe Message Type Generated

Parameter Reference Length Optional Text
MEDICALSERVICE_INPUT BAPI1410DATAINX 469 IS-H*MED: BAPI Medical Service Creation and Change Data
MEDICALSERVICE_OUTPUT BAPI1410DATA 631 X IS-H*MED: BAPI Medical Service Data
RETURN BAPIRET2 548 X Return Parameters
STATUS_OUTPUT BAPI1410STATUS 53 X IS-H*MED: BAPI Service - Employee - Status Assignment


This BAPI method is part of the Clinical System component.
It is used to change an existing medical service for a patient who isalready entered in the system. Using this method you can change theresponsible employee. However, as a result, the system will create anew entry in the service status - employee assignment of the lastservice status. You cannot change the status of a service.

Notes
You must enter the client, the institution and the patient number ofthe service you wish to change, as import parameters.
The MEDICALSERVICE_INPUT table (containing medical service data)can be transferred to the BAPU in order to change a service.
For each of its fields (except key fields and fields which cannot bechanged), the above table also has an X field with the same name butending with an "X". These X fields must be filled with an "X" if thesystem should write the corresponding attribute to the database. Thesystem will not write attributes, with X fields which do not contain an"X", to the database.
This guarantees that the system will not overwrite existing fields in
the database or delete their contents.
During this method, the system will first check existing tables forerrors and consistency. If the system finds an error in a record, itwill log this internally and will not change the service in thedatabase.
The parameter TESTRUN is optional. If it contains an "X", themodule will run in test mode. The test mode is used to checktransferred data. The system will return to the user any errorsdetermined during this check in the RETURN table. In test mode,when the system checks the data consistency, the system will not writeto the database.
You can find the return values which are possible and their meanings inthe parameter documentation of the RETURN table.
You will require the following authorizations to execute this method:
1. On Patient level: N_NLEM_PATNR;
2. On Service level: N_NLEI_LNRLS;
The system will try to process, i.e. update, every transferredMEDICALSERVICE_INPUT record. If you transfer several services,which you wish to change, via the interface, and problems occur whilstthe system is processing these services, the system will update allservices except the one where the problem occurred.

Description
This return parameter contains the most severe message type generatedin the return parameter RETURN. You can use this to execute asimple success analysis, without having to examine the structure or theRETURN table in detail. You can always limit this to all caseswhich contain 'E' or 'A' here as the worst type.
The processing of the message types ' ', 'S', 'I' and 'W' issuccessfully completed. We could not process data for message types 'E'or 'A'.

Value range

  • ' ': No message occurred

  • 'S': Success message

  • 'I': Information message

  • 'W': Warning

  • 'E': Error

  • 'A': Abort
  • Default

    Description
    In this field you must enter the client manually. When you create orchange objects, the system will check this entry to ensure that it isprocessing in the correct client.

    Value range
    All clients stored in the system.
    This field is alpha-converted, which means that if you enter numbersonly, you can omit the leading blanks and leading zeroes.

    Default
    This value is not preassigned.

    Description
    In this field you must manually enter the responsible institution.

    Value range
    All institutions stored in the system.
    This field is alpha-converted, which means that if you enter numbersonly, you can omit the leading blanks and leading zeroes.

    Default
    This value is not preassigned.

    Description
    Manual entry of the patient number within the relevant client.

    Value range
    This field is alpha-converted, which means that if you enter numbers
    only, you can omit the leading blanks and leading zeroes.

    Default
    This value is not preassigned.

    MEANING&
    In order to check the consistency of data which you wish to updatewithout making changes in the database, you can execute a test run.

    Value range
    You must set this parameter to 'X' if you wish to execute a test runwithout database changes.

    Default
    The parameter is preassigned, not with 'X', but with SPACE. If thesystem does not transfer the parameter when calling, it will notexecute a test run, but will update the data in the database (updaterun).

    Description
    In this table you enter the data of the patient-related service thatyou wish to change.
    The Service_Seqno key field must contain an entry. All otherfields are optional.
    You can enter attributes for the services you wish to change in theMEDICALSERVICE_INPUT table; for this table there is also a fieldof the same name with the suffix 'X' in the structure. The system willonly evaluate the relevant attribute, if the corresponding X-fieldcontains an 'X'.
    The system will try to process every transferred record. The systemwill collect any errors which occur in the RETURN parameter.

    Description
    The system will return the changed services with the most importantservice characteristics to this table.

    Value range

    Default

    F&MEANING&
    The system will return possible errors which may have occurred in thistable.

    Value range
    The following error messages may occur:

    • NC 035: Enter a valid institution.

    • NC 603: Current client is , but data is determined for client
    • .
      • NC 605: Desired function not possible without value in field <(>

      • <<)>SERVICE_STATUS>.
        • NFCL 001: MAP_STRUCT_TO_INTERN: NLEI and NLEM data record do not match.

        • NFCL 003: Internal service status for could not be
        • found.
          • NFCL 004: External service status for could not be
          • found.
            • NFCL 007: Service : No key fields can be
            • modified.
              • NFCL 008: Service : Service code is empty.

              • NFCL 009: Service is invalid or does not
              • exist.
                • NFCL 010: You cannot assign the service to
                • this movement.
                  • NFCL 011: Service has status
                  • and cannot have a reference to a movement.
                    • NFCL 012: Service has status
                    • and must have a reference to a movement.
                      • NFCL 013: Service : Organizational unit
                      • is not a valid Requesting Department Organizational Unit.
                        • NFCL 013: Service : Organizational unit
                        • is not a valid Requesting Nursing Organizational Unit.
                          • NFCL 013: Service : Organizational unit
                          • is not a valid Performing Organizational Unit.
                            • NFCL 014: Service : Error creating the
                            • service - service assignment.
                              • NFCL 015: Service : Time stamp SRV_STARTDATE
                              • is not correct or is empty.
                                • NFCL 016: Service : SRV_ANCHOR
                                • is not contained in the domain.
                                  • NFCL 016: Service : Field value
                                  • is not contained in the domain.
                                    • NFCL 017: Service is linked to more than
                                    • one request.
                                      • NFCL 019: You cannot change the request reference for service
                                      • .
                                        • NFCL 020: Service : You are attempting to
                                        • change the desired time or date.
                                          • NFCL 022: Cannot read parameter N1ZOTYP for institution .

                                          • NFCL 023: Service : Error <(>

                                          • <<)>sy-subrc> breaking down costs.
                                            • NFCL 026: Cannot cancel service .

                                            • NFCL 028: Service : Time limit value is
                                            • greater than 255.
                                              • NFCL 029: Time interpretation does not exist in
                                              • institution .
                                                • NFCL 034: Service has status
                                                • , but no request or preregistration.
                                                  • NFCL 035: Service : Room <(>

                                                  • <<)>IDENTIFICATION_ROOM> is not valid.
                                                    • NFCL 036: Room does not match room
                                                    • for service <(> <<)>SERVICE_SEQNO>.
                                                      • NFCL 037: Degree of infection has not been assigned to
                                                      • institution <(> <<)>INSTITUTION>.
                                                        • NFCL 038: Localization has not been defined for
                                                        • institution <(> <<)>INSTITUTION>.
                                                          • NFCL 042: Service : The linked appointment
                                                          • is canceled.
                                                            • NFCL 043: Service : The linked appointment
                                                            • is incorrect.
                                                              • NFCL 056: Service : Value <(>

                                                              • <<)>PATIENT_CONSENT> of patient consent is not allowed.
                                                                • NFCL 058: An instance of the class CL_ISHMED_SERVICE could not be
                                                                • created.
                                                                  • NFCL 059: Constructor class CL_ISHMED_SERVICE: Transfer parameters were
                                                                  • incorrect.
                                                                    • NFCL 060: Class CL_ISHMED_SERVICE: Parameter I_COPY_OF was incorrect.

                                                                    • NFCL 061: Class CL_ISHMED_SERVICE: Parameter I_ENVIRONMENT was blank or
                                                                    • incorrect.
                                                                      • NFCL 062: Class CL_ISHMED_SERVICE: Important data could not be found.

                                                                      • NFCL 063: Class CL_ISHMED_SERVICE: When instantiating an unforeseeable
                                                                      • error occurred.
                                                                        • NFCL 064: Service : The employee responsible is not
                                                                        • specified.
                                                                          • NFCL 065: Service : The employee responsible is
                                                                          • not valid.
                                                                            • NFCL 066: Desired time cannot be in the past when confirming.

                                                                            • NFCL 067: Position type is not available in institution

                                                                            • <(> <<)>INSTITUTION>.

                                                                            • NFCL 073: Service : The field STORN cannot be changed
                                                                            • with CHANGE.
                                                                              • NFCL 078: Patient with provisional master data does not exist.

                                                                              • NFCL 079: Service is linked to more than
                                                                              • one provisional patient.
                                                                                • NFCL 083: Service : Provisional patient may
                                                                                • not be changed.
                                                                                  • NFCL 104: Preregistration service: Inconsistency between case <(>

                                                                                  • <<)>PATCASEID> and patient .
                                                                                    • NFCL 146: Enter a valid client.

                                                                                    • NFCL 147: Enter a valid patient number.

                                                                                    • NFCL 148: Entries between MEDICALSERVICE_INPUT-SERVICE_SEQNO and
                                                                                    • STATUS_INPUT-SERVICE_SEQNO are different.
                                                                                      • NFCL 148: Entries between MEDICALSERVICE_INPUT-PATIENTID and PATIENTID
                                                                                      • are different.
                                                                                        • NFCL 150: The Service, Case No., Pat. No., and Pat. ID fields cannot be
                                                                                        • changed.
                                                                                          • NFCL 159: Input value UNIT_TIME_LIMIT is not permitted in field
                                                                                          • .
                                                                                            • NFCL 202: Correct desired time.

                                                                                            • NFCL 203: Preregistration & is not valid.

                                                                                            • NFCL 204: Field may not be filled.

                                                                                            • NFCL 204: Field may not be filled.

                                                                                            • NFCL 204: Field may not be filled.

                                                                                            • NFCL 205: Service does not belong to patient.

                                                                                            • N1 014: Patient does not exist.

                                                                                            • N1 018: Patient canceled.

                                                                                            • N1 026: Case is canceled.

                                                                                            • N1 034: Case does not exist.

                                                                                            • N1 036: Enter a valid institution.

                                                                                            • N1 199: Organizational unit has not been released.

                                                                                            • N1 199: Organizational unit has not been released.

                                                                                            • N1 199: Organizational unit has not been released.

                                                                                            • N1 204: Organizational unit does not exist.

                                                                                            • N1 204: Organizational unit does not exist.

                                                                                            • N1 204: Organizational unit does not exist.

                                                                                            • N2 673: Institution does not exist.

                                                                                            • N2 674: Catalog does not exist.

                                                                                            • N2 679: Checkbox contains a non-permitted value.

                                                                                            • N2 679: Checkbox contains a non-permitted value.

                                                                                            • N2 679: Checkbox contains a non-permitted value.

                                                                                            • N2 679: Checkbox contains a non-permitted value.

                                                                                            • N2 679: Checkbox contains a non-permitted value.

                                                                                            • N2 679: Checkbox ist mit einem ungültigen Wert

                                                                                            • N2 679: Checkbox ist mit einem ungültigen Wert

                                                                                            • NF 615: Enter a valid employee.

                                                                                            • NF1 040: Surgery anchor service not found (Parameter N2ANKLOP).

                                                                                            • NF1 041: AN Anchor service not found (Parameter N1ANKLAN).

                                                                                            • NF1 048: On the case is already
                                                                                            • completed.

                                                                                              Description
                                                                                              The system will return the Service-Employee-Status assignment of thechanged service to this table.
                                                                                              The SERVICE_SEQNO attribute of the MEDICALSERVICE_OUTPUT
                                                                                              table contains the sequence number of the service, which you willalso find in the corresponding data record of the STATUS_OUTPUTtable. You should note that there can be several data records in theSTATUS_OUTPUT table for one entry in theMEDICALSERVICE_OUTPUT table.

                                                                                              Value range