Fonction SAP BAPI_ISUMOVEIN_CREATEFROMDATA - IS-U: BAPI for Move-In Creation

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
CONTACTDATA BAPIBCONTACT u 220 X Data for Customer Contact
CONTRACTACCOUNTDATA BAPIISUVKP u 689 X Data for Contract Account
CONTRACTACCOUNTDATAX BAPIISUVKPX u 102 X WHich Data Do You Want to Copy?
MOVEINCREATECONTROLDATA BAPIISUMOVEINCR_C u 5 Data for Controling Move-In Processing
MOVEINCREATEINPUTDATA BAPIISUMOVEINCR_I u 67 Input Data for Move-In Document Creation
PARTNERDATA BAPIISUBPD u 1580 X General Data on Business Partner
PARTNERDATAX BAPIISUBPDX u 107 X WHich Data Do You Want to Copy?

Paramètre Reférence Type Long. Description
CONT_ACCT BAPICAPARA-ACCOUNT C 12 Contract Account Number
MOVEINDOCNUMBER BAPIISUMOVEINCR_I-MOVEINDOCNUMBER C 12 Move-In Document Number
PARTNER BAPIBPPARA-PARTNER C 10 Number of Business Partner

Paramètre Reférence Long. Facultatif Description
EXTENSIONIN BAPIPAREX 990 X Customer Enhancements
TADDRESS BAPIISUBPA 1291 X Address Data of Business Partner that is Moving In
TADDRESSX BAPIISUBPAX 66 X WHich Data Do You Want to Copy?
TBANKDATA BAPIISUBPB 213 X Bank Details of Business Partner that is Moving In
TBANKDATAX BAPIISUBPBX 15 X WHich Data Do You Want to Copy?
TCCARDDATA BAPIISUBPC 144 X Credit Cards of Business Partner that is Moving In
TCCARDDATAX BAPIISUBPCX 12 X WHich Data Do You Want to Copy?
TCONTRACTDATA BAPIISUCONTRACT 386 Data for the Contract to be Created
TCONTRACTDATAX BAPIISUCONTRACTX 64 WHich Data Do You Want to Copy?
TCTRACLOCKDETAIL BAPIFKKVKLOCKSI 87 X Lock on Contract Account
TMETERREADINGRESULTS BAPIEABLU 232 X Meter Reading Results
TRETURN BAPIRET2 548 Messages

Functionality
This BAPI creates a move-indocument in the system and does the following:

  • Creates a new contract for
  • each utility installation.
    • Either creates a new contract
    • account or uses an existing contract account, changing it in theprocess if necessary.
      • Either creates a new business
      • partner or uses an existing business partner, changing it in theprocess if necessary.
        • You can enter meter reading results or create meter reading orders.

        • A customer contact is automatically created together with the move-in
        • document.
          This BAPI does not support the following functions:
          • Creation of service orders and service notifications

          • Creation of budget billing plans

          • Creation of the welcome letter

          • Requesting and transferring security deposits

          • Creation of print action records

          • Posting of move-in charges
          • Notes

            • This BAPI can only be used when a complete IS-U system is
            • available. Specifically, this means the entities required in the IS-Udata model may not reside in a separate system.
              • To fill the import parameters of this BAPI, you can use function module
              • ISU_MOVE_IN_BAPI_GET_DEFAULTS. This function module does the following:
                Allocates default data to the contract account and utilitycontracts in accordance with the referencemove-in document concept.
                Data for bank details and credit cards is supplemented with theappropriate IDs (keys) and added to in the contract account data,including the payment methods.

                Further information

                Description
                Number of the contractaccount that was created/changed in the system when you created themove-in.

                Description
                This parameter is used to return the number of the move-in documentcreated in the system.

                Description
                Number of the move-in customer.

                Description
                This structure contains the data for the customer contact entered inthe system when the move-in document was created. For more informationon the meaning of the individual fields see the documentation of thefunction moduleBAPI_BCONTACT_CREATEFROMDATA (createbusiness partner contact).
                The following fields are determined internally, meaning they cannot bedefined freely:

                • Business partner number (PARTNER)

                • Contact class (CLASS)

                • Contact activity (ACTIVITY)

                • The contact objects that have roles are also determined internally.

                  Description
                  This structure contains the data for thecontract account.
                  To create a new contract account, you must enter data in the followingparameters:

                  • RESP_COMP_CODE

                  • DUNNING_PROC

                  • RELSHIP_PARTNER

                  • TOLERANCE_GROUP

                  • TERMS_OF_PAYMENT

                  • SETTLE_CAT_CL_ENTRIES

                  • ACCOUNT_DETERM_ID

                  • APPL_FORM

                  • LANGU_ACC
                  • Notes
                    The fields of this structure are only copied if the correspondingfields in the parameter CONTRACTACCOUNTDATAX contain X.

                    MEANING&
                    Fields that you want the system to copy from the parameterCONTRACTACCOUNTDATA must contain a X in the corresponding fieldsof this structure.

                    Description
                    This structure contains the following fields (used to control theprocess flow of move-in processing):

                    • PARTNERSTDADDRADJUST

                    • PARTNERSTDADDRADJUSTX

                    • If this input parameter is empty then the system copies thePARTNERSTDADDRADJUST field from Customizing
                      • PARTNERCREATE

                      • CONTRACTACCOUNTCREATE

                      • TESTRUN
                      • Description
                        This structure contains input data used to enter amove-in in conjuction witha BAPI:

                        • MOVEINDOCNUMBER

                        • Only enter data in this field if you require a standard move-indocument number.
                          • PARTNER

                          • Enter the business partner number if:
                            you are entering the move-in for abusiness partner thatalready exists in the system, or
                            you want to create a business partner with a pre-assigned number.
                            • PARTNERGROUP, PARTNERCATEGORY

                            • , PARTNERREFERENCE
                              Only enter data in these 3 fields if you want the system to create anew business partner when the move-in is created.
                              • CONT_ACCT

                              • Enter a contract account number if:
                                you want to use an existingcontract account for themove-in or
                                you want to create a new contract account with a pre-assigned number.
                                • ACCT_CAT

                                • Only enter data in this field if you want the system to create anadditional contract account when the move-in is created.
                                  • MOVEINDATE and ACTUALMOVEINDATE:

                                  • The MOVEINDATE field is mandatory.
                                    You only have to maintain the ACTUALMOVEINDATE field if itdiffers from the move-in date.

                                    Description
                                    This structure contains the data of the businesss partner moving intothe premise.

                                    Notes
                                    The system only transfers the fields of this structure if thecorresponding fields in the parameter PARTNERDATAX contain X.

                                    Description
                                    If you want to transfer a field from parameter PARTNERDATA then itscorresponding field in this structure must contain X.

                                    Description
                                    You can only change the address data of the business partner if theparameter MOVEINCREATECONTROLDATA-PARTNERSTDADDRADJUSTis not set. There are, however, the following exceptions to thisrule:

                                    • TEL_NUMBER

                                    • TEL_EXTENS

                                    • FAX_NUMBER

                                    • FAX_EXTENS

                                    • DEFLT_COMM

                                    • E_MAIL
                                    • Notes
                                      The system only transfer the fields from this structure if thecorresponding fields in the parameter TADDRESSX.
                                      INCLUDE ISU_WEITEREINFOS OBJECT DOKU ID TXthe following function module documentation:

                                      • BAPI_ISUPARTNER_CHANGE

                                      • BAPI_ISUPARTNER_CREATEFROMDATA

                                        • BAPI_ISUPARTNER_GETDETAIL.
                                        • Value range

                                          Description
                                          You can only copy fields from the parameter TADDRESS if thecorresponding field in this structure contains X.

                                          Description
                                          You can only copy fields from this structure if the correspondingfields in parameter TBANKDATAX contain X.
                                          INCLUDE ISU_WEITEREINFOS OBJECT DOKU ID TXthe following function module documentation:

                                          • BAPI_ISUPARTNER_CHANGE

                                          • BAPI_ISUPARTNER_CREATEFROMDATA

                                            • BAPI_ISUPARTNER_GETDETAIL
                                            • Description
                                              If you want to transfer fields from the parameter TBANKDATA then thecorresponding fields in this structure must contain X.

                                              Description
                                              The system only transfers fields from this structure if thecorresponding fields in parameter TCCARDDATAX contain X.
                                              INCLUDE ISU_WEITEREINFOS OBJECT DOKU ID TXthe following function module documentation:

                                              • BAPI_ISUPARTNER_CHANGE

                                              • BAPI_ISUPARTNER_CREATEFROMDATA

                                                • BAPI_ISUPARTNER_GETDETAIL
                                                • Description
                                                  If you want to transfer fields from parameter TCCARDDATA then thecorresponding fields in this structure must contain X.

                                                  Description
                                                  This structure contains data on theutility contracts to becreated in the move-in.
                                                  The following fields are mandatory:

                                                  • COMP_CODE

                                                  • ACTDETERID

                                                  • JOINT_INVOICE
                                                  • Notes
                                                    The system only transfers fields from this structure if thecorresponding fields in parameter TCONTRACTDATAX contain X.

                                                    Description
                                                    If you want to transfer fields from the parameter TCONTRACTDATA thenthe corresponding fields of this structure must contain X.

                                                    Value range
                                                    INCLUDE ISU_WEITEREINFOS OBJECT DOKU ID TXthe following function module documentation:

                                                    • BAPI_CTRACCONTRACTACCOUNT_CHNG


                                                      • BAPI_CTRACCONTRACTACCOUNT_CREA

                                                        • BAPI_ISUACCOUNT_CHANGE

                                                        • BAPI_ISUACCOUNT_CREATEFROMDATA

                                                        • Description
                                                          You can enter meter readings for meter readings at move-in. For moreinformation on the individual fields, see the following function moduledocumentation:

                                                          • BAPI_MTRREADDOC_UPLOAD.

                                                          • Meter reading order are generated through the move-in. For this reason,the following fields cannot be freely defined, but are determinedinternally:
                                                            • Meter reading reason (MRREASON)

                                                            • Meter reading order number (MRIDNUMBER)

                                                            • Billing-relevant meter reading date (MRDATEFORBILLING)

                                                            • Billling-relevant meter reading time (MRTIMEFORBILLING)

                                                            • Number of service order/service notification (SMORDER)
                                                            • Description
                                                              This parameter is used to return messages, such as success and errormesssages.

                                                              Value range
                                                              Generally, the system returns one of the following messages:
                                                              If an action was successful
                                                              (S039(EQ)) Move-in document & created
                                                              If an error occurred
                                                              (E312(EMV)) Move-in document was not created
                                                              If the action was successful, the system specifies the masterdata/transaction data that was created/changed, for example:
                                                              (S044(EQ)) Business partner & changed
                                                              (S045(EQ)) Contract account & changed
                                                              (S060(EQ)) Contract &1 created for installation &2
                                                              (S038(EQ)) Customer contact & created
                                                              If an error occurs, the system outputs different messages. The mostfrequent are:
                                                              (E311(EMV)) BAPI called incorrectly
                                                              (E302(EMV)) Error reading of data for business partner
                                                              (E303(EMV)) Error checking data for business partner
                                                              (E305(EMV)) Error reading data for contract account
                                                              (E306(EMV)) Error checking data for contract account
                                                              (E308(EMV)) Error reading data for contract
                                                              (E309(EMV)) Error checking data for contract
                                                              (E313(EMV)) Error reading meter reading data
                                                              (E314(EMV)) Error checking meter reading data
                                                              The system also outputs messages that explain the cause of the error.

596925Move-in/MDG: Company code-dependent Customizing