Recommendation
From Release 640 upwards the time-dependent address usagessolution provided by Financial Services will be replaced by thetime-dependent address usages for the SAP Business Partner. We thereforerecommend that you no longer use this method.
To create addresses and time-dependent address usages, use the methodAddAddress for the Business Object BusinessPartnerFS.

Functionality
You can use this method to add an address with an indefinite number oftime-dependent usages to an existing business partner.
You can specify whether the address added to the business partner is the
standard address and you can add further data forthe individual communicationtypes to the business partner.
In addition you can assign address to the address types for the businesspartner using time-dependent address usages and specify a certainvalidity period.

Notes
Every time you call this method you can create one address with anindefinite number of address usages for a business partner.
You can add only one record with addresses and an indefinite number ofaddress usages to each business partner.
A preprocessing run takes place before the data is added:

• A check is performed to determine whether the business partner is
available for processing.

• A simple exclusive lock is activated.

This prevents other users from changing the business partner that iscurrently being processed until either the method TransactionCommit
or TransactionRollback for the Business ObjectBapiService is executed. The authorized user can access the samebusiness partner repeatedly.
Address data and address usages are not written to the database untilthe method TransactionCommit for the Business ObjectBapiService has been called.

Authorizations
You can make settings for business partner authorization objects to bechecked in Customizing for the SAP Business Partner underBusiness Partner-> Basic Settings-> Authorization Management.

Buffering
This method works with buffering. Change and read methods for thisbusiness object category can be repeatedly used for this instance. Aftercalling the save method, read and write methods can access the bufferedinstances and supply current attributes in the same Logical Unit of Work(LUW).

Dependencies
The system checks data added with regards to its consistency and theCustomizing settings available.
In the parameter ACCEPT_ERROR you can define how the system is todeal with errors arising from the regional structure check.
If you have not made the relevant settings, then the system carries outa duplicate check when adding addresses. If the system recognizes thatthe record being created already exists, then it returns those recordsthat are similar to the record in the parameter ADDRESSDUPLICATES
. In the parameter DUPLICATE_MESSAGE_TYPE you can determinewhether the system should continue adding the data with an errormessage, or whether it should terminate processing.
If no error occurs when adding addresses and time-dependent addressusages, then the data is saved and the system returns a unique addressGUID in the parameter ADDRESSGUID.

Return messages
Messages are returned in the RETURN parameter. You can find thereturn values and their meaning in the parameter documentation.

Description
In this parameter the system transfer an address GUID.
The address GUID identifies an address that is unique across allsystems.
It is a technical object identifier that is not shown on the interfaceand that is not to be used in interactions between system users.

Description
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Address Number.

Value range
The value range for the parameter corresponds to the value range for thedomain of the data element.

Description
With this parameter you control whether a message from the regionalstructure check is of the type:


• E (error) or


• W (warning)

In this parameter enter the value X if messages issued are to bewarning messages.

Value range
X for the regional structure check will issue a message of type W(warning)
' ' for the regional structure check will issue a message of type E(error)

Default
' ' for the regional structure check will issue a message of type E(error)

Description
This parameter is a required (mandatory) parameter.
It contains address data for the SAP Business Partner.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.
You have to transfer values for the following fields:


• COUNTRY (Country key)

Value range
The value range for the parameter corresponds to the value range for thestructure component.

Description
This parameter is a required (mandatory) parameter.
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Business Partner Number.

Value range
The value range for the parameter corresponds to the value range for thedomain of the data element.

Description
You can find information on the meaning of the parameter in thecorresponding documentation for the data element: Output: Severity of error (N/SPACE-normal, E/F/A-error).
With this parameter you can control which kind of message is to beissued during a duplicate check:


• E (error) or


• W (warning)

If the system issues message type E then it terminatesprocessing.

Default
If no value is entered then message type E is used as default inthe standard system.

Description
In this parameter the system returns duplicate addresses that itidentified as being the same or similar when the current record wasentered.
The field ADDRNUMBER contains the address numbers of the addresses thatwere identified as being the same or similar.
If these addresses are personal addresses then the relevant personnumber is entered in the field PERSNUMBER.
If the duplicate check tool supports the option, then the fieldPERCENTAGE contains the percentage showing how likely it is that theaddress record in question is a duplicate.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

Recommendation
From Release 640 upwards the time-dependent address usagessolution provided by Financial Services will be replaced by thetime-dependent address usages for the SAP Business Partner. We thereforerecommend that you no longer use this method.
To create addresses and time-dependent address usages, use the methodAddAddress for the Business Object BusinessPartnerFS.

Description
This parameter contains the time-dependent address usages for the SAPBusiness Partner for Financial Services
With the time-dependent address usages you can assign an infinite numberof address types with fixed validity periodsto an address for a business partner.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.
The system checks the data in this parameter with regards to itsconsistency and the Customizing settings.
You can define address types in Customizing for the SAP BusinessPartner for Financial Services under General Settings -> BusinessPartner -> Basic Settings -> Address Determination -> Define AddressTypes.
The standard address is automatically assigned to the standard addressusage.
The assignment of addresses to the standard address usage cannot haveany gaps from the current date to 31.12.9999.
The indicator standard address set in the addresspool must always agree with the current entry in the standard addressusage and is automatically provided.
No further settings are needed for the indicator standard addressor standard address usage are needed when you transfer the firstaddress to be added. When you create further addresses, observe thefollowing procedure:


• If the indicator standard address is set, then you have to enter
a standard address usage (XXDEFAULT)

• If there is a valid standard address usage available for the
current date, then the indicator standard address isautomatically set

Value range
The value range for this parameter corresponds with the value range forthe structure component.

Description
This parameter contains information about the fax numbers for a businesspartner in Business Address Services.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

Description
This parameter contains information about the pager numbers for abusiness partner.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

Description
This parameter contains information about the PRT (printer) addressesfor a business partner in Business Address Services.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

Description
This parameter contains information about the RFC addresses for abusiness partner in Business Address Services.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

Description
This parameter contains information about the RML addresses for abusiness partner in Business Address Services.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

Description
This parameter contains information about the e-mail addresses for abusiness partner in Business Address Services.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

Description
This parameter contains information about the SSF addresses for abusiness partner in Business Address Services.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

Description
This parameter contains information about the telephone numbers for abusiness partner in Business Address Services.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

Description
This parameter contains information about the telex numbers for abusiness partner in Business Address Services.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

Description
This parameter contains information about the teletex numbers for abusiness partner in Business Address Services.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

Description
This parameter contains information about the URI addresses for abusiness partner in Business Address Services.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

Description
This parameter contains information about the X.400 addresses for abusiness partner in Business Address Services.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary

Description
This parameter contains comments on the addresses for a businesspartner.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

Description
This parameter contains notes on the communication types for a businesspartner.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.

Description
This table contains the return messages from the method call.