SAP Function BAPI_BUPA_ADDRESS_ADD - SAP BP, BAPI: Add Address

Parameter Reference Type Length Default Optional Text
ACCEPT_ERROR BAPI4001_1-ACCEPT_ERR C 1 SPACE X Accept Regional Structure Check Errors with Warnings
ADDRESSDATA BAPIBUS1006_ADDRESS u 830 Address Data
BUSINESSPARTNER BAPIBUS1006_HEAD-BPARTNER C 10 Business Partner Number
DUPLICATE_MESSAGE_TYPE BAPIBUS1006_HEAD-CONTROLDUPLICATEMESSAGE C 1 X Message Type Control

Parameter Reference Type Length Text
ADDRESSGUID BUT020-GUID C 32 Address GUID

Parameter Reference Length Optional Text
ADDRESSDUPLICATES BAPIBUS1006_ADDRESS_DUPLICATES 67 X Address Duplicates
ADDRESSUSAGE BAPIBUS1006_ADDRESSUSAGE 35 X Address Usages
BAPIADFAX BAPIADFAX 143 X Telefax Numbers
BAPIADPAG BAPIADPAG 136 X Pager Numbers
BAPIADPRT BAPIADPRT 40 X PRT Addresses
BAPIADRFC BAPIADRFC 69 X RFC Addresses
BAPIADRML BAPIADRML 63 X RML Addresses
BAPIADSMTP BAPIADSMTP 300 X E-Mail Addresses
BAPIADSSF BAPIADSSF 2391 X SSF Addresses
BAPIADTEL BAPIADTEL 142 X Telephone Numbers
BAPIADTLX BAPIADTLX 72 X Telex Numbers
BAPIADTTX BAPIADTTX 72 X Teletex Numbers
BAPIADURI BAPIADURI 2219 X URI Addresses
BAPIADUSE BAPIADUSE 46 X BAPI Structure for Communication Usages (BAS)
BAPIADX400 BAPIADX400 948 X X400 Addresses
BAPIAD_REM BAPIAD_REM 55 X Address Notes
BAPICOMREM BAPICOMREM 60 X Notes on Communication Types
RETURN BAPIRET2 548 X Messages

Functionality
With this function module you create an address for a business partner.You can also create related communication types such as telephone, fax,Internet address, and so on.
The data in the interface is checked for consistency and Customizingsettings. Any errors that occur are stated as test results in the RETURNtable. If an error occurs, the address is not created.
If no errors occur, the data is saved, and a number with CHAR 32 (GUID)format is returned by the ADDRESSGUID export parameter. This numberuniquely identifies the address over all systems.
Depending on the partner category of the business partner involved, anaddress for a person or an organization is created.
If appropriate settings are made in the system, a duplicate check iscarried out during creation. If a record to be created is recognized asalready existing in the system, the addresses that are similar to thisrecord are returned to the table ADDRESSDUPLICATES.
If the tool used for the duplicate check makes it possible, theprobability in percent of the current record being a duplicate isreturned in the table ADDRESSDUPLICATES.
In order to add an international address version to an address, use thefunction module BAPI_BUPA_ADDRESS_CHANGE.
The following applies to time dependency: if no validity data istransferred, then the newly created address is valid from the currentdate to the 31.12.9999.

Description
The address GUID uniquely identifies an address over all systems.
It is purely a technical object identifier that is not intended for usein the interface, or in interaction between system users.

Description
You use this parameter to control whether a message from the regionalstructure check should be category E or W. Enter the value X in thisparameter if a possible message of category W should be issued.

Value range
X

Default
The default value of the parameter is SPACE. Thus a possible message ofcategory E is issued during the regional structure check.

Description
This structure contains information on business partner addresses.
For information on the significance of the individual parameter fields,consult the corresponding data element documentation in the ABAPdictionary.

Significance of the field STANDARDADDRESS
The field is obsolete. It was used when a partner had only one standardaddress whose validity was unrestricted. The field should no longer beused in new programs.
The field is supported as follows for reasons of compatibility:

  • X: Address becomes the standard address during its entire validity

  • The content 'X' in this field is not compatible with the usage of thetable ADDRESSUSAGE.

    Default
    INCLUDE BAPI_BUSINESSPARTNER OBJECT DOKU ID TX

    Description
    You can use this parameter to control whether the message type with theduplicate check should be an E message or a W message, in other wordsan error message, or a warning. With E messages, further processing iscanceled.
    Permitted values
    E for errors and W for warnings.
    If you do not specify a value, standard message category E is used.

    Description
    The addresses that the system has recognized as being the same orsimilar are stated in this table. The field ADDRNUMBER contains theaddress number of the addresses recognized as being the same orsimilar. In the case that the addresses are personal addresses, thefield PERSNUMBER is filled with the relevant personal number.
    Depending on whether the tool for the duplicate check offers thepossibility, the field PERCENTAGE contains the probability of the givenaddress record being a duplicate

    Description
    This table contains data on adding an address usage to the businesspartner address.
    For information on the significance of the individual parameter fields,see the corresponding data element documentation in the ABAP Dictionary.
    Enter the following data to make an address an aktive standard address:

    • Address type = XXDEFAULT, STANDARDADDRESSUSAGE = X

    • If the address should become the standard address during its entirevalidity(ADDRESSDATA-VALIDTODATE), the fields USAGEVALIDTO andUSAGEVALIDFROM can remain empty.

      Description
      This table contains information on the fax data of a business partner.
      For information on the significance of the individual parameter fields,consult the corresponding data element documentation in the ABAPdictionary.

      Description
      This table contains information on the pager numbers of a businesspartner.
      For information on the significance of the individual parameter fields,consult the corresponding data element documentation in the ABAPdictionary.

      Description
      Table contains information on the printer addresses of the businesspartner.
      For information on the significance of the individual parameter fields,consult the corresponding data element documentation in the ABAPdictionary.

      Description
      Table contains information on the RFC addresses of the businesspartner.
      For information on the significance of the individual parameter fields,consult the corresponding data element documentation in the ABAPdictionary.

      Description
      This table contains information on the R-mail addresses of a businesspartner.
      For information on the significance of the individual parameter fields,consult the corresponding data element documentation in the ABAPdictionary.

      Description
      Table contains information on the Internet addresses of a businesspartner.
      For information on the significance of the individual parameter fields,consult the corresponding data element documentation in the ABAPdictionary.

      Description
      Table contains information on the SSF addresses of a business partner.
      For information on the significance of the individual parameter fields,consult the corresponding data element documentation in the ABAPdictionary.

      Description
      This table contains information on the telephone addresses of abusiness partner.
      For information on the significance of the individual parameter fields,consult the corresponding data element documentation in the ABAPdictionary.

      Description
      Table contains information on the telex data of a business partner.
      For information on the significance of the individual parameter fields,consult the corresponding data element documentation in the ABAPdictionary.

      Description
      This table contains information on the teletex data of a businesspartner.
      For information on the significance of the individual parameter fields,consult the corresponding data element documentation in the ABAPdictionary.

      Description
      Table contains information on the URI addresses of a business partner.
      For information on the significance of the individual parameter fields,consult the corresponding data element documentation in the ABAPdictionary.

      Description
      BAPI structure for communication usage (Business Address Services).

      Value range
      This table contains the communication data usage.

      Description
      Table contains information on the X400 addresses of a business partner.
      For information on the significance of the individual parameter fields,consult the corresponding data element documentation in the ABAPdictionary.

      Description
      Table contains information on the addresses of a business partner.
      For information on the significance of the individual parameter fields,consult the corresponding data element documentation in the ABAPdictionary.

      Description
      Table contains information on the communication data of a businesspartner.
      For information on the significance of the individual parameter fields,consult the corresponding data element documentation in the ABAPdictionary.

      Description
      Table contains return messages from the method call.

687828SAP BP API: Duplicate check 100 % correspondence
687865Duplicate check: 100 % hits in BAS interface
453100Shadow table update for contract partner BAPIs