Fonction SAP BAPI_BUPA_ADDRESSES_GET - SAP BP, BAPI: Determine All Addresses

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
ADDRESSTYPE BAPIBUS1006_ADDRESSUSAGE-ADDRESSTYPE C 10 X Address Type
BUSINESSPARTNER BAPIBUS1006_HEAD-BPARTNER C 10 Business Partner Number
OPERATION BAPIBUS1006_ADDRESSES_INT-OPERATION C 6 X Transaction for BP Address Determination
VALID_DATE BAPIBUS1006_VALIDITY-VALID_DATE D 8 SY-DATLO X Initial Date for Business Partner Data

Paramètre Reférence Type Long. Description
STANDARDADDRESSGUID BAPIBUS1006_ADDRESSES_INT-ADDRGUID X 16 GUID of a Business Partner Address
STANDARDADDRESSNUMBER BAPIBUS1006_ADDRESSES_INT-ADDRNUMBER C 10 Address Number
STANDARDADDRESSUSEINSTEAD BAPIBUS1006_ADDRESSES_INT-STANDARDADDRESS C 1 Indicator: Address is Standard Address

Paramètre Reférence Long. Facultatif Description
ADDRESSES BAPIBUS1006_ADDRESSES 49 X Addresses
ADDRESSES_ALL BAPIBUS1006_ADDRESSES 49 X Addresses Independent of Temporal Validity
RETURN BAPIRET2 548 X Messages

Functionality
With this BAPI you can determine all existing addresses for a businesspartner. The standard address is flagged as such in the table parameter.
Any errors that occur during address determination are logged andreturned in the RETURN parameter.
If the temporal validity of addresses or address usages is used, usersmust enter a validity date (VALID_DATE), otherwise dates that arecurrently valid may be issued. To read all addresses, regardless oftheir temporal valid, specify the initial validity date (VALID_DATE =SPACE).
The table ADDRESSES delivers - if a key date has been entered - only theaddresses valid on the key date. If an address type (ADDRESSTYPE) isalso entered, then only the addresses with the correct temporal validityfor this address type are returned.
If there are no valid addresses for this address type, the tableADDRESSES contains all the addresses with the correct temporal validity.
If the user has entered an address usage and there is no (valid) addressfor it, then the output variables STANDARDADDRESSNUMBER andSTANDARDADDRESSGUID are filled and STANDARDADDRESSUSEINSTEAD isselected.
The output table ADDRESSES_ALL always contains all existing addresses,including addresses that do not have the correct temporal validity.

Notes
The keys from table TB009 are permitted as address usages.

Description
The GUID of the determined standard address is returned via theparameter STANDARDADDRESSGUID.

Description
The address number of the address that is identified as the standardaddress is returned via the parameter STANDARDADDRESSNUMBER.

Description
If no address corresponding to the given type in the parameterADDRESTYP is found for the business partner stated, the standardaddress determined for the business partner in parameterSTANDARDADDRESSUSEINSTEAD is proposed as an alternative to be used inthe stated address type.

Description
In the field ADDRESSTYPE you provide the address type that determinesthe address usage.
Business partner addresses are assigned to the various address types.This assignment determines the address usage.
INCLUDE BAPI_BUSINESSPARTNER OBJECT DOKU ID TX

Description
In the case of business partners with several addresses, it is requiredthat you determine the correct address in each case for varioustransactions. For this purpose the relevant transaction can be providedhere.
The application program programs on the basis of these addresstransactions. The customer cannot change the transactions delivered bySAP. However, the customer can create additional transactions in thecustomer name range (entry must begin with 'Y' or 'Z') for self-programmed processes.
The customer can maintain address types within the IMG and assign theseto the address transactions. For more information, see thedocumentation in the IMG.

Description
Validity date of the address
For an initial date (00000000), all addresses are output in the tableADDRESSES. If no date is specified the current day's date is taken andthe appropriate valid addresses are selected. When a date is specified,all addresses valid for that date are in the table ADDRESSES.
The table ADDRESSES_ALL always contains all addresses.

Value range
YYYYMMDD

Default
Current date

Description
The ADDRESSES table parameter contains all addresses that exist for abusiness parnter, and information on which of the addresses is thestandard address.

Description
The table contains all addresses, regardless of whether or not theyare valid for the event IV_VALID_DATE.

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