Fonction SAP BAPI_BUSPARTNER_CHANGE - IS-H: BAPI BusPartner.Change - Change Business Partner

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
ADDRESS_X BAPINADDRX u 674 X Change Structure: Address General Business Partner
BPARTNERID BAPI1309BPARTNER-BPARTNER C 10 Business Partner Number
BPARTNER_X BAPI1309BPARTINX u 365 X Change Structure: General Business Partner
CLIENT BAPINALL-CLIENT C 3 Client
CUSTOMER_X BAPI1309CUSTINX u 72 X Change Structure/Create Structure: Function "IS-H Customer"
EMPLOYER_X BAPI1309EMPLINX u 64 X Change Structure/Create Structure: Function "Employer"
HOSPITAL_X BAPI1309HOSPINX u 56 X Change Structure/Create Structure: Function "Hospital"
INSPROVIDER_X BAPI1309INSPROVINX u 326 X Change Structure/Create Structure: Function "Insurance Provider"
PERSON_X BAPI1309PERSINX u 147 X Change Structure/Create Structure: Function "Person"
ROLE_CUST BAPINALL-XIND C 1 SPACE X Checkbox: Change/Create Customer
ROLE_EMPL BAPINALL-XIND C 1 SPACE X Checkbox: Change/Create Employer
ROLE_HOSP BAPINALL-XIND C 1 SPACE X Checkbox: Change/Create Hospital
ROLE_INS BAPINALL-XIND C 1 SPACE X Checkbox: Change/Create Insurance Provider
ROLE_PERS BAPINALL-XIND C 1 SPACE X Checkbox: Change/Create Person (Physician/Employee)
TESTRUN BAPINALL-TESTRUN C 1 SPACE X Test Mode (No Changes in Database)

Paramètre Reférence Type Long. Description
ADDRESS_CDATA BAPINADDR u 994 Changed Address
BPARTNER_CDATA BAPI1309BPARTNER u 461 Changed General Business Partner
CUSTOMER_CDATA BAPI1309CUSTOMER u 78 Changed IS-H Customer
CUSTOMER_IDATA BAPI1309CUSTOMER u 78 Created IS-H Customer
EMPLOYER_CDATA BAPI1309EMPLOYER u 74 Changed Employer
EMPLOYER_IDATA BAPI1309EMPLOYER u 74 Created Employer
HOSPITAL_CDATA BAPI1309HOSPITAL u 66 Changed Hospital
HOSPITAL_IDATA BAPI1309HOSPITAL u 66 Created Hospital
INSPROVIDER_CDATA BAPI1309INS_PROVIDER u 373 Changed Insurance Provider
INSPROVIDER_IDATA BAPI1309INS_PROVIDER u 373 Created Insurance Provider
PERSON_CDATA BAPI1309PERSON u 172 Changed Person
PERSON_IDATA BAPI1309PERSON u 172 Created Person
WORST_RETURNED_MSGTY BAPINALL-WORSTRETMSG C 1 IS-H: Most Severe Message Type Generated

Paramètre Reférence Long. Facultatif Description
ADD_PHONE_DDATA BAPINADDR2 53 X Deleted Telephone Numbers
ADD_PHONE_IDATA BAPINADDR2 53 X Created Telephone Numbers
ADD_PHONE_X BAPI1309RNADR2X 41 X Change Data: Telephone Numbers
ASS_PER_KVPHYSNO_DDATA BAPI1309PERPHYSNO 38 X Deleted Person-HI Physician Number Assignment
ASS_PER_KVPHYSNO_IDATA BAPI1309PERPHYSNO 38 X Created Person-HI Physician Number Assignment
ASS_PER_KVPHYSNO_UDATA BAPI1309PERPHYSNO 38 X Changed Person-HI Physician Number Assignment
ASS_PER_KVPHYSNO_X BAPI1309PERPHYSNOX 28 X Change Data: Change Structure for Person-HI Physician Number Assignment
ASS_PER_QLDI_DDATA BAPI1309PERQLDI 85 X Deleted Person-to-Qualitative Grade Assignment
ASS_PER_QLDI_IDATA BAPI1309PERQLDI 85 X Created Person-to-Qualitative Grade Assignment
ASS_PER_QLDI_UDATA BAPI1309PERQLDI 85 X Changed Person-to-Qualitative Grade Assignment
ASS_PER_QLDI_X BAPI1309PERQLDIX 32 X Change Data: Person-to-Qualitative Grade Asgmt
ASS_PER_QTDI_DDATA BAPI1309PERQTDI 86 X Deleted Person-to-Quantitative Grade Assignment
ASS_PER_QTDI_IDATA BAPI1309PERQTDI 86 X Created Person-to-Quantitative Grade Assignment
ASS_PER_QTDI_UDATA BAPI1309PERQTDI 86 X Changed Person-to-Quantitative Grade Assignment
ASS_PER_QTDI_X BAPI1309PERQTDIX 33 X Change Data: Person-to-Quantitative Grade Asgmt
ASS_PER_SPEC_DDATA BAPI1309PERSPEC 18 X Deleted Person-to-Specialty Assignment
ASS_PER_SPEC_IDATA BAPI1309PERSPEC 18 X Created Person-to-Specialty Assignment
ASS_PER_SPEC_X BAPI1309PERSPECX 5 X Change Date: Person-to-Specialty Assignment
ASS_PER_USR_DDATA BAPI1309PERUSR 25 X Deleted Person-to-User Name Assignment
ASS_PER_USR_IDATA BAPI1309PERUSR 25 X Created Person-to-User Name Assignment
ASS_PER_USR_X BAPI1309PERUSRX 13 X Change Data: Person-to-User Name Assignment
ASS_PER_WORKNO_DDATA BAPI1309PERWORKNO 38 X Deleted Person-Place of Work Number Assignment
ASS_PER_WORKNO_IDATA BAPI1309PERWORKNO 38 X Created Person-Place of Work Number Assignment
ASS_PER_WORKNO_UDATA BAPI1309PERWORKNO 38 X Changed Person-Place of Work Number Assignment
ASS_PER_WORKNO_X BAPI1309PERWORKNOX 28 X Change Data: Person-Place of Work Number Assignment
RETURN BAPIRET2 548 X Return Parameters

Functionality
INCLUDE NBAPI_ISH
It is used to change IS-H business partners in the functions:

  • General Business Partner

  • Person (e.g. physician)

  • IS-H Customer

  • Insurance Provider

  • Hospital

  • Employer

  • If the business partner exists in the function "General BusinessPartner", you can use this method to change its data and also to createother functions.
    The business partner you change, or for which you wish to create newfunctions is identified by specifying the business partner number(BPARTNERID).
    You stipulate the data to be changed (or created) using the parametersROLE_HOSP, ROLE_CUST, ROLE_INS, ROLE_PERS and ROLE_EMPL. Depending onwhich parameter is flagged ("X"), the corresponding function data isevaluated and changed or created.
    If none of these parameters are set, only the data of the GeneralBusiness Partner will be changed accordingly.

    Notes
    To be able to execute this method you require the appropriatetransaction authorization for changing or creating the function data:

    • General Business Partner: NG02 (Change)

    • Person (e.g. Physician): NG04 (Create), NG05 (Change)

    • IS-H Customer: NG10 (Create), NG11 (Change)

    • Insurance Provider: NG07 (Create), NG08 (Change)

    • Hospital: NG16 (Create), NG17 (Change)

    • Employer: NG13 (Create), NG14 (Change)

    • In test mode (TESTRUN = "X") you can check your data for errors, withoutmaking changes in the database.

      Further information
      Note that this method does not enable you to create or modify SAPscripttexts or customers in Financial Accounting (FI).
      When you use this method to create IS-H customers, you must make surethat the FI customer is created afterwardsusing the dialog transactionif want to be able to use the customer/insurance provider for billing.

      Description
      All (changed) address data is returned in this structure, provided youmade changes.

      Description
      All of the (changed) data pertaining to the general business partner isreturned in this structure, provided you made changes.

      Description
      All of the (changed) data pertaining to the business partner in the"IS-H Customer" function is returned in this structure, provided youmade changes.

      Description
      All of the data pertaining to the business partner created in the "IS-HCustomer" function is returned in this structure, provided the businesspartner did not already exist in this function.

      Description
      All of the (changed) data pertaining to the business partner in the"Employer" function is returned in this structure, provided you madechanges.

      Description
      All of the data pertaining to the business partner created in the"Employer" function is returned in this structure, provided thebusiness partner did not already exist in this function.

      Description
      All of the (changed) data pertaining to the business partner in the"Hospital" function is returned in this structure, provided you madechanges.

      Description
      All of the data pertaining to the business partner created in the"Hospital" function is returned in this structure, provided thebusiness partner did not already exist in this function.

      Description
      All of the (changed) data pertaining to the business partner in the"Insurance Provider" function is returned in this structure, providedyou made changes.

      Description
      All of the data pertaining to the business partner created in the"Insurance Provider" function is returned in this structure, providedthe business partner did not already exist in this function.

      Description
      All of the (changed) data pertaining to the business partner in the"Person" function is returned in this structure, provided you madechanges.

      Description
      All of the data pertaining to the business partner created in the"Person" function is returned in this structure, provided the businesspartner did not already exist in this function.
      INCLUDE NBAPI_WORST_RETURNED_MSGTY

      Description
      In this structure you specify the address data you want to change.
      You only pass the data, which should be changed, in the correspondingfields of this structure. The system only evaluates those fields whosecorresponding "X field" contains an "X". The corresponding "X field" isthe field with the same name and the suffix "X" in the structure.
      You pass telephone numbers to be changed in a separate tableADD_PHONE_X. If you want to modify telephone numbers for the address,you have to place an "X" in the "X field" PHONESX in the presentstructure.

      Description
      Specify the number of the business partner whose data you want tochange here. The business partner must exist at least in the "GeneralBusiness Partner" function.
      If you use this method to create other functions for the businesspartner, the function data will be stored under the business partnernumber specified.

      Value range
      This field is alpha converted. This means that when you enter a number,you do not have to enter leading blanks or zeros.

      Description
      In this structure you specify the data of the general business partneryou want to change.
      You only pass the data, which should be changed, in the correspondingfields of this structure. The system only evaluates those fields whosecorresponding "X field" contains an "X". The corresponding "X field" isthe field with the same name and the suffix "X" in the structure.
      INCLUDE NBAPI_CLIENT

      Description
      You enter the data that is to be changed for the business partner withthe role 'IS-H Customer' in this structure.
      You only need to enter the data that is to be changed in the
      corresponding fields in this structure. The system only evaluates thefields whose 'X field' contains an 'X'. The 'X field' is the field inthe structure that has the same name with the suffix 'X'.
      To change an existing IS-H customer or create the role 'IS-H Customer'for an existing business partner, you must specify both the institutionand the company code. Both these fields are required.

      Description
      In this structure you specify the data of the business partner in the"Employer" function you want to change.
      You only pass the data, which should be changed, in the correspondingfields of this structure. The system only evaluates those fields whosecorresponding "X field" contains an "X". The corresponding "X field" isthe field with the same name and the suffix "X" in the structure.

      Description
      In this structure you specify the data of the business partner in the"Hospital" function you want to change.
      You only pass the data, which should be changed, in the correspondingfields of this structure. The system only evaluates those fields whosecorresponding "X field" contains an "X". The corresponding "X field" isthe field with the same name and the suffix "X" in the structure.

      Description
      In this structure you specify the data of the business partner in the"Insurance Provider" function you want to change.
      You only pass the data, which should be changed, in the correspondingfields of this structure. The system only evaluates those fields whosecorresponding "X field" contains an "X". The corresponding "X field" isthe field with the same name and the suffix "X" in the structure.

      Description
      You specify the data you want to change for the business partner withthe function "Person" in this structure.
      You only transfer the data that is to be changed in the correspondingfields in this structure. The system only evaluates the fields whose "Xfield" contains an "X". The "X field" is the field of the same name withthe suffix "X".
      Fields SPECIALTYX, USERX, KVPHYSNOX, WORKNOX, QLDIX, and QTDIXconstitute an exception. If these fields contain an "X", the systemevaluates the change data from the corresponding tables ASS_PER_SPEC_X(if SPECIALTYX = 'X'), ASS_PER_USR_X (if USERX = 'X' ),ASS_PER_KVPHYSNO_X (if KVPHYSNOX = 'X'), ASS_PER_WORKNO_X (if WORKNOX ='X'), ASS_PER_QLDI_X (if QLDIX = 'X'), and ASS_PER_QTDI_X (if QTDIX ='X').

      Description
      This parameter lets you stipulate that the business partner identifiedby the parameter BPARTNERID is changed or created in the "IS-HCustomer" function

      Value range
      You must place an "X" in this parameter if you want to create or changethe business partner in the "IS-H Customer" function. This is theprerequisite to the relevant create/change structure (CUSTOMER_X) beingtaken into account.

      Default
      The default value for this parameter is SPACE. With this setting thedata of the "IS-H Customer" function remains unchanged.

      Description
      This parameter lets you stipulate that the business partner identifiedby the parameter BPARTNERID is changed or created in the "Employer"function.

      Value range
      You must place an "X" in this parameter if you want to create or changethe business partner in the "Employer" function. This is theprerequisite to the relevant create/change structure (EMPLOYER_X) beingtaken into account.

      Default
      The default value for this parameter is SPACE. With this setting thedata of the "Employer" function remains unchanged.

      Description
      This parameter lets you stipulate that the business partner identifiedby the parameter BPARTNERID is changed or created in the "Hospital"function.

      Value range
      You must place an "X" in this parameter if you want to create or changethe business partner in the "Hospital" function. This is theprerequisite to the relevant create/change structure (HOSPITAL_X) beingtaken into account.

      Default
      The default value for this parameter is SPACE. With this setting thedata of the "Hospital" function remains unchanged.

      Description
      This parameter lets you stipulate that the business partner identifiedby the parameter BPARTNERID is changed or created in the "InsuranceProvider" function.

      Value range
      You must place an "X" in this parameter if you want to create or changethe business partner in the "Insurance Provider" function. This is theprerequisite to the relevant create/change structure (INSPROVIDER_X)being taken into account.

      Default
      The default value for this parameter is SPACE. With this setting thedata of the "Insurance Provider" function remains unchanged.

      Description
      This parameter lets you stipulate that the business partner identifiedby the parameter BPARTNERID is changed or created in the "Person"function.

      Value range
      You must place an "X" in this parameter if you want to create or changethe business partner in the "Person" function. This is the prerequisiteto the relevant create/change structure (PERSON_X) being taken intoaccount.

      Default
      The default value for this parameter is SPACE. With this setting thedata of the "Person" function remains unchanged.
      INCLUDE NBAPI_TESTRUN

      Description
      All of the data pertaining to the successfully deleted telephonenumbers is returned in this table.

      Description
      All of the data pertaining to the successfully created telephonenumbers is returned in this table.

      Description
      In this table you specify the telephone numbers which you want tocreate (ACTION = 'I') or delete (ACTION = 'D') for an address.
      Create
      The following fields in the table are taken into account when creatingtelephone numbers:
      ACTION: Specify "I" (Insert) in this field
      PHONENO: Telephone number
      EXTENSION: Extension
      The telephone number(s) entered are assigned to the address of thebusiness partner identified by the parameter BPARTNERID, if the changeindicator ADDRESS_X-PHONESX="X" is set.
      Delete
      The following fields in the table are taken into account when telephonenumbers are deleted:
      ACTION: Specify "D" (Delete) in this field
      PHONENO: Telephone number
      EXTENSION: Extension
      The telephone number(s) entered are deleted from the address of thebusiness partner identified by the parameter BPARTNERID, if the changeindicator ADDRESS_X-PHONESX="X" is set.

      Description
      This table returns all the data for the PPA physician number-personassignments that have been deleted.

      Description
      This table returns all the data for the PPA physician number-personassignments that have been created.

      Description
      This table is used to return all the data for the changed validityperiods for PPA physician number-person assignments.

      Description
      In this table, you enter the lifelong PPA physician numbers that youwant to assign to a person (ACTION = 'I') or delete (ACTION = 'D').
      Create
      The following fields in the table are taken into account when creatingPPA physician numbers:
      ACTION: Enter an 'I' (Insert) in this field.
      KVPHYSNO: Enter a PPA physician number in this field.
      BEGDATE: In this field, enter the valid-from date of the PPA physiciannumber.
      ENDDATE: In this field, enter the valid-to date of the PPA physiciannumber.
      The PPA physician number(s) entered are assigned to the business partnerwith the function "Person" who is specified in parameter BPARTNERID, ifthe function indicator ROLE_PERS is selected ('X') and the changeindicator PERSON_X-KVPHYSNOX is selected ('X') in structure PERSON_X.
      Delete
      The following fields in the table are taken into account when deletingPPA physician numbers:
      ACTION: Enter a 'D' (Delete) in this field.
      KVPHYSNO: Enter an existing PPA physician number in this field.
      The PPA physician number(s) entered are deleted for the business partnerwith the function "Person" who is specified in parameter BPARTNERID, ifthe function indicator ROLE_PERS is selected ('X') and the changeindicator PERSON_X-KVPHYSNOX is selected ('X') in structure PERSON_X.

      Description
      All data of the successfully deleted qualitative assignments to theperson is returned in this table.

      Description
      All data of the successfully created qualitative assignments to theperson is returned in this table.

      Description
      All data of the successfully changed qualitative assignments to theperson is returned in this table.

      Description
      In this table, you specify the qualitative assignments that you wish toassign to a person (ACTION = 'I') or delete (ACTION = 'D') or change(ACTION = 'U').
      Create
      The following table fields are taken into account when qualitativeassignments are created:
      ACTION: Specify 'I' (Insert) in this field.
      QUAL_DIG: Specify a valid qualitative grade in this field.
      FROM_DATE: Specify the valid-from date of the assignment in this field.
      TO_DATE: Specify the valid-to date of the assignment in this field.
      The specified qualitative assignment(s) are assigned to the businesspartner in the "Person" function identified by the BPARTNERID parameterif the function indicator ROLE_PERS = 'X' is set.
      Delete
      The following table fields are taken into account when qualitativeassignments are deleted:
      ACTION: Specify 'D' (Delete) in this field.
      QUAL_DIG: Specify an existing valid qualitative grade in this field.
      FROM_DATE: Specify the valid-from date of the assignment in this field.
      The specified qualitative assignment(s) are deleted for the businesspartner in the "Person" function identified by the BPARTNERID parameterif the function indicator ROLE_PERS = 'X' is set.
      Change
      The following table fields are taken into account when qualitativeassignments are changed:
      ACTION: Specify 'U' (Update) in this field.
      QUAL_DIG: Specify an existing qualitative grade in this field.
      FROM_DATE: Specify the valid-from date of the assignment in this field.
      TO_DATE: Specify the new value for the valid-to date of the assignmentin this field.
      TO_DATEX: Fill this field with 'X'
      The specified qualitative assignment(s) are changed for the businesspartner in the "Person" function identified by the BPARTNERID parameter
      if the function indicator ROLE_PERS = 'X' is set.

      Description
      All data of the successfully deleted quantitative assignments to theperson is returned in this table.

      Description
      All data of the successfully created quantitative assignments to theperson is returned in this table.

      Description
      All data of the successfully changed quantitative assignments to theperson is returned in this table.

      Description
      In this table, you specify the quantitative assignments that you wish toassign to a person (ACTION = 'I') or delete (ACTION = 'D') orchange (ACTION = 'U').
      Create
      The following table fields are taken into account when quantitativeassignments are created:
      ACTION: Specify 'I' (Insert) in this field.
      QUNT_DIG: Specify a valid quantitative grade in this field.
      FROM_DATE: Specify the valid-from date of the assignment in this field.
      TO_DATE: Specify the valid-to date of the assignment in this field.
      The specified quantitative assignment(s) are assigned to the businesspartner in the "Person" function identified by the BPARTNERID parameterif the function indicator ROLE_PERS = 'X' is set.
      Delete
      The following table fields are taken into account when quantitativeassignments are deleted:
      ACTION: Specify 'D' (Delete) in this field.
      QUNT_DIG: Specify an existing valid quantitative grade in this field.
      FROM_DATE: Specify the valid-from date of the assignment in this field.
      The specified quantitative assignment(s) are deleted for the businesspartner in the "Person" function identified by the BPARTNERID parameterif the function indicator ROLE_PERS = 'X' is set.
      Change
      The following table fields are taken into account when quantitativeassignments are changed:
      ACTION: Specify 'U' (Update) in this field.
      QUNT_DIG: Specify an existing quantitative grade in this field.
      FROM_DATE: Specify the valid-from date of the assignment in this field.
      TO_DATE: Specify the new value for the valid-to date of the assignmentin this field.
      TO_DATEX: Fill this field with 'X'
      The specified quantitative assignment(s) are changed for the businesspartner in the "Person" function identified by the BPARTNERID parameterif the function indicator ROLE_PERS = 'X' is set.

      Description
      All of the data pertaining to the successfully deletedspecialty-to-person assignments is returned in this table.

      Description
      All of the data pertaining to the successfully createdspecialty-to-person assignments is returned in this table.

      Description
      In this table you specify the specialties you want to assign to aperson (ACTION = 'I') or delete (ACTION = 'D').
      Create
      The following fields in the table are taken into account when creatingspecialties:
      ACTION: Specify "I" (Insert) in this field
      SPECIALTY: Specify a valid specialty of the specialty category "5" inthis field
      The specialties entered are assigned to the business partner in the"Person" function identified by the parameter BPARTNERID, if thefunction indicator ROLE_PERS = "X" and the change indicatorPERSON_X-SPECIALTYX="X" is set in the structure PERSON_X.
      Delete
      The following fields in the table are taken into account when deletingspecialties:
      ACTION: Specify "D" (Delete) in this field
      SPECIALTY: Specify a valid specialty of the specialty category "5" inthis field
      The specialties entered are deleted from the business partner in the"Person" function identified by the parameter BPARTNERID, if thefunction indicator ROLE_PERS = "X" and the change indicatorPERSON_X-SPECIALTYX="X" is set in the structure PERSON_X.

      Description
      All of the data pertaining to the successfully deleted user names isreturned in this table.

      Description
      All of the data pertaining to the successfully created user names forthe person is returned in this table.

      Description
      In this table you specify the user names you want to assign to a person(ACTION = 'I') or delete (ACTION = 'D').
      Create
      The following fields in the table are taken into account when creatinguser names:
      ACTION: Specify "I" (Insert) in this field
      USER_NAME: Specify a valid user name from the user profile in this field
      The user names entered are assigned to the business partner in thefunction "Person" identified by the parameter BPARTNERID, if thefunction indicator ROLE_PERS = "X" and the change indicatorPERSON_X-USERX="X" is set in the structure PERSON_X.
      Delete
      The following fields in the table are taken into account when deletinguser names:
      ACTION: Specify "D" (Delete) in this field.
      USER_NAME: Specify a valid user name from the user profile in thisfield.
      The user names entered are deleted from the business partner in thefunction "Person" identified by the parameter BPARTNERID, if thefunction indicator ROLE_PERS = "X" and the change indicatorPERSON_X-USERX="X" is set in the structure PERSON_X.

      Description
      This table is used to return all the data for the place of worknumber-person assignments that have been deleted.

      Description
      This table is used to return all the data for the place of worknumber-person assignments that have been created.

      Description
      This table is used to return all the data for the changed validityperiods of place of work number-person assignments.

      Description
      In this table, you enter the place of work numbers that you want toassign to a person (ACTION = 'I') or delete (ACTION = 'D').
      Create
      The following fields in the table are taken into account when creatingplace of work numbers:
      ACTION: Enter an 'I' (Insert) in this field.
      WORKNO: Enter a place of work number in this field.
      BEGDATE: In this field, enter the valid-from date of the place of worknumber.
      ENDDATE: In this field, enter the valid-to date of the place of worknumber.
      The place of work number(s) entered are assigned to the business partnerwith the function "Person" who is specified in parameter BPARTNERID, ifthe function indicator ROLE_PERS is selected ('X') and the changeindicator PERSON_X-WORKNOX is selected ('X') in structure PERSON_X.
      Delete
      The following fields in the table are taken into account when deletingplace of work numbers:
      ACTION: Enter a 'D' (Delete) in this field.
      WORKNO: Enter an existing place of work number in this field.
      The place of work number(s) entered are deleted for the business partnerwith the function "Person" who is specified in parameter BPARTNERID, ifthe function indicator ROLE_PERS is selected ('X') and the changeindicator PERSON_X-WORKNOX is selected ('X') in structure PERSON_X.

      Description
      Errors that occurred are returned in this table.

      Value range