Functionality
Note: In SAP R/3 4.5A, this BAPI is replaced by BAPI"BAPI_CUSTOMER_CHANGEFROMDATA1", which takes full account ofintegration of customer data in Central Address Management (CAM). Asthis BAPI ("BAPI_CUSTOMER_CHANGEFROMDATA") is being replaced, it willonly be supported for 2 releases after SAP R/3 4.5A.
This method of the "Customer" business object can be used to change thepersonal data of an existing customer in SAP R/3, with the customerbeing entered as a consumer (company address = contact partner address= personal address). This has the following results:
If only a company address exists, this BAPI can be used to change thecompany address accordingly and create an identical personal andcontact partner address.
If only company and contact person addresses but no personal addressexist for this customer, this BAPI can only be used to change thecustomer if a company address is transferred to the BAPI("ONLY_CHANGE_COMADDRESS" = 'X').
The same applies in the following case:
If the personal address is different to the company address, this BAPIcan only be used to change the customer if a company address istransferred to the BAPI ("ONLY_CHANGE_COMADDRESS" = 'X').
If there is a different address: The personal or contact person addressis different to the company address in one of the following fields:Language, Street, House number, Region, Town, Postal code, Country,Telephone number, Fax number, E-mail.
Note: For customer data created before SAP R/3 4.5A, a company addressis different to the contact partner address if the first name, surname,or title of the contact partner of the 2nd entry differs from the 1stentry of the name field or title of the company address.
Note: The address data required is the same as that needed for themethod of creating a customer (seeBAPI_CUSTOMER_CREATEFROMDATA).
The authorization requirements for using this BAPI are the same asthose for BAPI BAPI_CUSTOMER_CREATEFROMDATA , whereas here, you need authorizationfor the change activity.
The sales organization is a required field.
If the country changes, the fields Distribution channel and Divisionmust be transferred so that the BAPI can determine the relevantcurrency (T005).
If a currency field (in R/3 or ISO format) is transferred to the BAPIfrom structure PI_ADDRESS, this currency field takes priority over thecurrency field from table T005. If both currency fields are transferredto the BAPI from PI_ADDRESS, the currency field in R/3 format haspriority.
Lastly, the number of the existing customer in SAP R/3 that is to bechanged must be transferred.
Note: All transferred values (including blank values) are adopted asthey are in the database.

Notes
Messages are returned in parameter RETURN. The return values and theirmeanings can be found in the parameter documentation.

Description
Export parameter address data customer. The structure contains thechanged customer address data.

Description
Return value for errors

Value range
TYPE = "E" CODE For the error codes, see documentation on the return value of BAPI BAPI_CUSTOMER_CREATEFROMDATA .The error codes "F2889", "F2889" and "F2891" described there cannotoccur here as return values. The following error messages exist forthis situation:
TYPE = "E" CODE = "F2875" Internal error: Customer not recogniszed incompany code master record
TYPE = "E" CODE = "F2888" Internal error: Customer not recognized inmaster record
TYPE = "E" CODE = "F2826" Contact person address different companyaddress, change not permitted
TYPE = "E" CODE = "F2825" Private address different company address,change not allowed
TYPE = "E" CODE = "F2894" Internal error: Customer not recognized insales master record
For errors that occur during CAM, see the following documentation:
ADDR_GET_COMPLETE
ADDR_CONVERT_COMPLETE_3_TO_2
ADDR_PERSONAL_GET_COMPLETE

Description
Import parameter customer number. Number of customer to be changed inR/3 system.

Description
Import parameter address data customer. The structure contains thecustomer address data to be changed.
Note: Field "ONLY_CHANGE_COMADDRESS" controls whether only the companyaddress of the customer is to be changed.

Description
Import parameter distribution channel for the customer

Description
Import parameter division for the customer

Description
Import parameter sales organization of customer