SAP Function BAPI_BUSPARTNER_CREATE - IS-H: BAPI BusPartner.Create - Create Business Partner

Parameter Reference Type Length Default Optional Text
ADDRESS_CREATE BAPINADDR u 994 X Create Structure: Address General Business Partner
BPARTNERID BAPI1309BPARTNER-BPARTNER C 10 SPACE X Business Partner Number (with External Number Assignment)
BPARTNER_CREATE BAPI1309BPARTIN u 361 Create Structure: General Business Partner
CLIENT BAPINALL-CLIENT C 3 Client
CUSTOMER_CREATE BAPI1309CUSTIN u 69 X Create Structure: Function "IS-H Customer"
EMPLOYER_CREATE BAPI1309EMPLIN u 61 X Create Structure: Function "Employer"
HOSPITAL_CREATE BAPI1309HOSPIN u 53 X Create Structure: Function "Hospital"
INSPROVIDER_CREATE BAPI1309INSPROVIN u 283 X Create Structure: Function "Insurance Provider"
PERSON_CREATE BAPI1309PERSIN u 124 X Create Structure: Function "Person"
ROLE_CUST BAPINALL-XIND C 1 SPACE X Checkbox: Create Customer
ROLE_EMPL BAPINALL-XIND C 1 SPACE X Checkbox: Create Employer
ROLE_HOSP BAPINALL-XIND C 1 SPACE X Checkbox: Create Hospital
ROLE_INS BAPINALL-XIND C 1 SPACE X Checkbox: Create Insurance Provider
ROLE_PERS BAPINALL-XIND C 1 SPACE X Checkbox: Create Person (Physician/Employee)
TESTRUN BAPINALL-TESTRUN C 1 SPACE X Test Mode (No Changes in Database)
TRANSACT_MODE BAPINALL-TRANSACT_MODE C 1 'N' X Transaction Mode for Number Assignment

Parameter Reference Type Length Text
ADDRESS_DATA BAPINADDR u 994 Created Address
BPARTNER_DATA BAPI1309BPARTNER u 461 Created General Business Partner
CUSTOMER_DATA BAPI1309CUSTOMER u 78 Created IS-H Customer
EMPLOYER_DATA BAPI1309EMPLOYER u 74 Created Employer
HOSPITAL_DATA BAPI1309HOSPITAL u 66 Created Hospital
INSPROVIDER_DATA BAPI1309INS_PROVIDER u 373 Created Insurance Provider
PERSON_DATA BAPI1309PERSON u 172 Created Person
WORST_RETURNED_MSGTY BAPINALL-WORSTRETMSG C 1 IS-H: Most Severe Message Type Generated

Parameter Reference Length Optional Text
ADD_PHONE_CREATE BAPINADDR2 53 X Additional Telephone Number(s) to Be Created
ADD_PHONE_DATA BAPINADDR2 53 X Additional Telephone Numbers Created
ASS_PER_KVPHYSNO_CREATE BAPI1309PERPHYSNO 38 X Person-HI Physician Number Assignment to Be Created
ASS_PER_KVPHYSNO_DATA BAPI1309PERPHYSNO 38 X Created Person-HI Physician Number Assignment
ASS_PER_QLDI_CREATE BAPI1309PERQLDI 85 X IS-H CH: Person-to-Qualitative Grade Asgmt to Be Created
ASS_PER_QLDI_DATA BAPI1309PERQLDI 85 X IS-H CH: Created Person-to-Qualitative Grade Assignment
ASS_PER_QTDI_CREATE BAPI1309PERQTDI 86 X IS-H CH: Person-to-Quantitative Grade Asgmt to Be Created
ASS_PER_QTDI_DATA BAPI1309PERQTDI 86 X IS-H CH: Created Person-to-Quantitative Grade Assignment
ASS_PER_SPEC_CREATE BAPI1309PERSPEC 18 X Person-to-Specialty Assignment to Be Created
ASS_PER_SPEC_DATA BAPI1309PERSPEC 18 X Created Person-to-Specialty Assignment
ASS_PER_USR_CREATE BAPI1309PERUSR 25 X Person-to-User Name Assignment to Be Created
ASS_PER_USR_DATA BAPI1309PERUSR 25 X Created Person-to-User Name Assignment
ASS_PER_WORKNO_CREATE BAPI1309PERWORKNO 38 X Person-Place of Work Number Assignment to Be Created
ASS_PER_WORKNO_DATA BAPI1309PERWORKNO 38 X Created Person-Place of Work Number Assignment
RETURN BAPIRET2 548 X Return Parameters

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

  • General Business Partner

  • Person (e.g. physician)

  • IS-H Customer

  • Insurance Provider

  • Hospital

  • Employer

    • A General Business Partner is always created, and the otherfunctions are created only if the relevant function indicators are set("X"). The function combinations listed below can be created in a singleprocessing step. Other functions can be created using theBAPI_BUSPARTNER_CHANGE BAPI.
    The business partner data is stored under the business partner numberspecified in the BPARTNERID parameter(when external number assignment isused).
    If the BPARTNRTID parameter is initial, an internal business partnernumber is assigned in relation to the function to be created inaccordance with the following logic:
    Function,,Combined with Function,,Main Number Range Object
    Gen. Bus. Partner,,--,,Gen. Bus. Partner,,
    Person,,Gen. Bus. Partner,,Person
    IS-H Customer,,Gen. Bus. Partner,,IS-H Customer,,,,
    Ins. Provider,,Gen. Bus. Partner,,Ins. Provider
    Hospital,,Gen. Bus. Partner,,Hospital
    Employer,,Gen. Bus. Partner,,Employer
    and
    IS-H Customer,,Ins.Prov.(+ Gen.BP),,IS-H Customer

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

    • General Business Partner: NG01

    • Person (e.g. physician): NG04

    • IS-H Customer: NG10

    • Insurance Provider: NG07

    • Hospital: NG16

    • Employer: NG13

      • Test mode (TESTRUN = 'X') lets you check your data for errors, withoutchanges being made 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 afterwards using the dialog transactionif want to be able to use the customer/insurance provider for billing.

      Description
      The created address is returned in this structure.
      The field ADDR_NO contains a unique reference to the related object.This reference is only used for the unique assignment of addresses.
      Exactly one telephone number (fields PHONENO and EXTENSION) is directlyspecified in an address record. If more than one telephone line existsfor an address, the field OTHER_PHONES is flagged ("X"), and theadditional telephone numbers are stored in the corresponding tableADD_PHONE_CREATE.

      Description
      All of the data pertaining to the created general business partner isreturned in this structure.

      Description
      All of the data pertaining to the business partner created in the "IS-HCustomer" function is returned in this structure.

      Description
      All of the data pertaining to the business partner created in the"Employer" function is returned in this structure.

      Description
      All of the data pertaining to the business partner created in the"Hospital" function is returned in this structure.

      Description
      All of the data pertaining to the business partner created in the"Insurance Provider" function is returned in this structure.

      Description
      All of the data pertaining to the business partner created in the"Person" function is returned in this structure.
      INCLUDE NBAPI_WORST_RETURNED_MSGTY

      Description
      In this structure you pass the address of the business partnerspecified in the structure BPARTNER_CREATE.
      You can directly specify exactly one telephone number(fields PHONENOand EXTENSION) here. If more than one telephone line exists for anaddress, flag the field OTHER_PHONES ("X") and specify the additionaltelephone numbers in the table ADD_PHONE_CREATE.
      Leave the field ADDR_NO initial. It is used internally to identify theaddresses and is not relevant here. The address is automaticallyassigned to the business partner passed in the structureBPARTNER_CREATE.

      Description
      If you want to create the business partner with an externally assignednumber, specify this number here.
      Note that the number must be in the permitted external number range.Make sure that this number has not been assigned already (using themethod BAPI_BUSPARTNER_GETLIST, for example).
      If you do not specify a business partner number, the system assigns anew number internally.

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

      Default
      The default value for this parameter is SPACE. If the parameter is notpassed in the method call, a new business partner number is determinedinternally.

      Description
      In this structure you pass the data of the general business partner youwant to create.
      INCLUDE NBAPI_CLIENT

      Description
      In this structure you pass the data pertaining to the business partneryou want to create in the function "IS-H Customer". The structure isonly taken into account if the parameter ROLE_CUST is flagged ("X").
      Special features of the fields INSTITUTION (institution) andCOMP_CODE (company code):

      • If the field INSTITUTION is filled, it is used to determine the company
        • code and the field COMP_CODE is not taken into account. The IS-HCustomer is created with the determined company code.
        • If the filed INSTITUTION is blank and the company code specified in
          • COMP_CODE, the IS-H Customer is created with the specified companycode.
          • If both fields are filled, their consistency is checked and the IS-H
            • customer created with the specified company code.
            • If both fields are empty, an IS-H Customer cannot be created.

              • Note: An FI Customer specified in the field REF_CUST can only bechecked if the field INSTITUTION is filled.
              Caution: The method BAPI_BUSPARTNER_CREATE cannot be used tocreate an FI Customer.

              Description
              In this structure you pass the data pertaining to the business partneryou want to create in the "Employer" function. The structure is onlytaken into account if the parameter ROLE_EMPL is flagged ("X").

              Description
              In this structure you pass the data pertaining to the business partneryou want to create in the "Hospital" function. The structure is onlytaken into account if the parameter ROLE_HOSP is flagged ("X").

              Description
              In this structure you pass the data pertaining to the business partneryou want to create in the "Insurance Provider" function. The structureis only taken into account if the parameter ROLE_INS is flagged ("X").

              Description
              In this structure you pass the data pertaining to the business partneryou want to create in the "Person" function. The structure is onlytaken into account of the parameter ROLE_PERS is flagged ("X").

              Description
              This parameter lets you stipulate that the business partner is to becreated as a general business partner and additionally in the "IS-HCustomer" function. The leading number range object is the IS-HCustomer.
              This method also lets you create the business partner in the "InsuranceProvider" function in addition to the "IS-H Customer" function. To dothis, also flag the parameter SS_ROLE_INS ("X").
              When internal number assignment is used (parameter BPARTNERID isintial) the IS-H Customer is the leading number range object.
              This method does not permit the simultaneous creation of otherfunctions. If you want to create the business partner in otherfunctions as well, use the method "BAPI_BUSPARTNER_CHANGE".
              Note: This method cannot be used to create an FI Customer.

              Value range
              You must flag this parameter ("X") if you want to create the businesspartner in the "IS-H Customer" function. This is the prerequisite tothe relevant create structure (CUSTOMER_CREATE) being taken intoaccount.

              Default
              The default value of the parameter is SPACE. This means that thebusiness partner is not created in the "IS-H Customer" function.

              Description
              This parameter lets you stipulate that the business partner is to becreated as a general business partner and additionally in the"Employer" function.
              When internal number assignment is used (parameter BPARTNERID isintial) the employer is the leading number range object.
              This method does not permit the simultaneous creation of otherfunctions. If you want to create the business partner in otherfunctions as well, use the method "BAPI_BUSPARTNER_CHANGE".

              Value range
              You must flag this parameter ("X") if you want to create the businesspartner in the "Employer" function. This is the prerequisite to therelevant create structure (EMPLOYER_CREATE) being taken into account.

              Default
              The default value of the parameter is SPACE. This means that thebusiness partner is not created in the "Employer" function.

              Description
              This parameter lets you stipulate that the business partner is to becreated as a general business partner and additionally in the"Hospital" function.
              When internal number assignment is used (parameter BPARTNERID isintial) the hospital is the leading number range object.
              This method does not permit the simultaneous creation of otherfunctions. If you want to create the business partner in otherfunctions as well, use the method "BAPI_BUSPARTNER_CHANGE".

              Value range
              You must flag this parameter ("X") if you want to create the businesspartner in the "Hospital" function. This is the prerequisite to therelevant create structure (HOSPITAL_CREATE) being taken into account.

              Default
              The default value of the parameter is SPACE. This means that thebusiness partner is not created in the "Hospital" function.

              Description
              This parameter lets you stipulate that the business partner is to becreated as a general business partner and additionally in the"Insurance Provider" function. The leading number range object is theinsurance provider.
              This method also lets you create the business partner in the "IS-Hcustomer" function in addition to the "Insurance Provider" function. Todo this, also flag the parameter SS_ROLE_CUST ("X").
              When internal number assignment is used (parameter BPARTNERID isintial) the IS-H Customer is the leading number range object.
              This method does not permit the simultaneous creation of otherfunctions. If you want to create the business partner in otherfunctions as well, use the method "BAPI_BUSPARTNER_CHANGE".

              Value range
              You must flag this parameter ("X") if you want to create the businesspartner in the "Insurance Provider" function. This is the prerequisiteto the relevant create structure (INSPROVIDER_CREATE) being taken intoaccount.

              Default
              The default value of the parameter is SPACE. This means that thebusiness partner is not created in the "Insurance provider" function.

              Description
              This parameter lets you stipulate that the business partner is to becreated as a general business partner and additionally in the "Person"function.
              When internal number assignment is used (parameter BPARTNERID isintial) the person is the leading number range object.
              This method does not permit the simultaneous creation of otherfunctions. If you want to create the business partner in otherfunctions as well, use the method "BAPI_BUSPARTNER_CHANGE".

              Value range
              You must flag this parameter ("X") if you want to create the businesspartner in the "Person" function. This is the prerequisite to therelevant create structure (PERSON_CREATE) being taken into account.

              Default
              The default value of the parameter is SPACE. This means that thebusiness partner is not created in the "Person" function.
              INCLUDE NBAPI_TESTRUN

              Description
              You can execute an IS-H transaction with number assignment in theoperation modes normal and stand alone.

              Value range

              • The operation mode N (normal) should be set if several users
                • enter objects that are linked to the number assignment.
                • The operation mode S (stand alone) is recommended when
                  • transferring data during the system installation phase when there areno users who enter objects online.

                  Default
                  The default value is normal.

                  Description
                  In this table you specify the additional telephone numbers you want tocreate for the business partner address.
                  Only fill the fields PHONENO and EXTENSION. The remaining fields willbe automatically filled at creation when the telephone numbers areassigned to the address passed in the structure ADDRESS_CREATE.

                  Description
                  All of the data pertaining to the additional telephone numbers createdis returned in this table.

                  Description
                  You specify the lifelong PPA physician number that is assigned to thebusiness partner with the function "Person" in this table.
                  You only make entries in fields KVPHYSNO, BEGDATE, and ENDDATE. Thesystem automatically fills the other fields during creation.
                  The system only processes this table if parameter ROLE_PERS is selected("X").

                  Description
                  This table is used to return all the data on the lifelong PPA physiciannumbers created.

                  Description
                  In this table you specify the qualitative grades assigned to thebusiness partner in the "Person" function.
                  The table is only taken into account if the parameter ROLE_PERS = 'X' isset.

                  Description
                  All the data of the created qualitative grade is returned in thistable.

                  Description
                  In this table you specify the quantitative grades assigned to thebusiness partner in the "Person" function.
                  The table is only taken into account if the parameter ROLE_PERS = 'X'is set.

                  Description
                  All the data of the created quantitative grade is returned in thistable.

                  Description
                  In this table you specify the specialties assigned to the businesspartner in the "Person" function.
                  Only fill the field SPECIALTY with a valid specialty of the specialtycategory "5". The system automatically fills the remaining fields.
                  The table is only taken into account if the parameter ROLE_PERS isflagged ("X").

                  Description
                  All of the data pertaining to the created specialties is returned inthis table.

                  Description
                  In this table you specify the user names assigned to the businesspartner in the function "Person".
                  Only fill the field USER_NAME. The remaining fields are automaticallyfilled at creation.
                  The table is only taken into account if the parameter ROLE_PERS isflagged ("X").

                  Description
                  All of the data pertaining to the created user names is returned inthis table.

                  Description
                  You specify the place of work numbers that are assigned to the businesspartner with the function "Person" in this table.
                  You only make entries in fields WORKNO, BEGDATE, and ENDDATE. The systemfills the other fields automatically during creation.
                  The system only processes this table if parameter ROLE_PERS is selected("X").

                  Description
                  This table is used to return all the data on the place of work numberscreated.

                  Description
                  Errors that occurred are returned in this table.

                  Value range