Sapass

 Simplify SAP R/3 development with Excel VBA/VB RFC  
Home> Bapi>BusinessPartner



Index

BusinessPartner

BusinessPartner


Business Partner manages central, cross-application data on a person or organization with whom/which a business interest exists.

The most important central data is:
Names
Addresses
Bank details
Payment cards


11-Dec-2005


Methods

Available Methods


  • AddressAdd : Add Address [ BAPI_BUPA_ADDRESS_ADD ]
  • AddressChange : Change Address [ BAPI_BUPA_ADDRESS_CHANGE ]
  • AddressesGet : Get All Addresses [ BAPI_BUPA_ADDRESSES_GET ]
  • AddressGetdetail : Read Address [ BAPI_BUPA_ADDRESS_GETDETAIL ]
  • AddressGetNumbers : Read Address Numbers [ BAPI_BUPA_ADDRESS_GET_NUMBERS ]
  • AddressRemove : Delete Address [ BAPI_BUPA_ADDRESS_REMOVE ]
  • BankdetailAdd : Add Bank Details [ BAPI_BUPA_BANKDETAIL_ADD ]
  • BankdetailChange : Read Bank Details [ BAPI_BUPA_BANKDETAIL_CHANGE ]
  • BankdetailGetDetail : Read Bank Details [ BAPI_BUPA_BANKDETAIL_GETDETAIL ]
  • BankdetailNumbers : Read Bank Detail Numbers [ BAPI_BUPA_BANKDETAIL_NUMBERS ]
  • BankdetailRemove : Delete Bank Details [ BAPI_BUPA_BANKDETAIL_REMOVE ]
  • BankdetailsGet : Get Bank Details [ BAPI_BUPA_BANKDETAILS_GET ]
  • CentralChange : Change Business Partner [ BAPI_BUPA_CENTRAL_CHANGE ]
  • ChangePassword : Change Password of Business Partner Internet User [ BAPI_BUPA_PASSWORD_CHANGE ]
  • CheckPassword : Check Password of Business Partner Internet User [ BAPI_BUPA_PASSWORD_CHECK ]
  • CreateFromData : Create Business Partner [ BAPI_BUPA_CREATE_FROM_DATA ]
  • CreatePassword : Create Internet User for Business Partner [ BAPI_BUPA_PASSWORD_CREATE ]
  • DeletePassword : Delete Internet User of Business Partner [ BAPI_BUPA_PASSWORD_DELETE ]
  • GetDetail : Business Partner Detailed Information [ BAPI_BUSINESS_PARTN_GET_DETAIL ]
  • GetNumbers : Read Business Partner Numbers [ BAPI_BUPA_GET_NUMBERS ]
  • GetPassword : Read Status Information on Business Partner Internet User [ BAPI_BUPA_PASSWORD_GET ]
  • InitPassword : Initialize Password for Business Partner Internet User [ BAPI_BUPA_PASSWORD_INIT ]
  • RelationshipsGet : Determine Business Partner Relationships [ BAPI_BUPA_RELATIONSHIPS_GET ]
  • RoleExistenceCheck : Check if BP Role Exists [ BAPI_BUPA_ROLE_EXISTENCE_CHECK ]
  • RolesGet : Determine Roles [ BAPI_BUPA_ROLES_GET ]
  • Search : SAP BP, BAPI: Search Business Partner for Telephone, E-Mail, Address [ BAPI_BUPA_SEARCH ]
  • TaxNumberAdd : Add VAT Registration Number [ BAPI_BUPA_TAX_ADD ]
  • TaxNumberChange : Change VAT Registration Number [ BAPI_BUPA_TAX_CHANGE ]
  • TaxNumberGetDetail : Display VAT Registration Number [ BAPI_BUPA_TAX_GETDETAIL ]
  • TaxNumberRemove : Delete VAT Registration Number [ BAPI_BUPA_TAX_REMOVE ]

11-Dec-2005


AddressAdd

AddressAdd


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 transferred at the interface ischecked for consistency and Customizing settings. Any errors that occur
are returned in the RETURN table. 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 address GUID export parameter. This number uniquely identifies the address over all systems.


Depending on the partner category of the business partner involved, the address of either a person or an organization is created.


11-Dec-2005


AddressChange

AddressChange


With this BAPI you can change the specific address for a certainbusiness partner. The system checks that the business partner and theaddress exist, and then checks the new data for consistency andCustomizing settings. Any errors that occur are logged and output in
the RETURN table. If any of the checks run across errors, the address changes are not carried out.

Depending on the business partner category of the business partner youhave entered, either the address of a person or that of an organization is changed.


This function module differs from the standard change BAPIs in that youare not only able to change existing entries, but you can also deleteor add telephone numbers and fax numbers, and so on, that are appended to an address as attributes.

Use reference structure bars (check bars) to select other entries that you want to change.


Notes

If you do not state an address GUID when you call this function module,the system assumes that you want to change the standard address of this business partner.

If you want to delete a telephone number in the table of telephone
numbers for a certain address, for example, the UPDATEFLAG field in thereference structure bar of the corresponding line must contain a "D".

If you want to add an entry, this field has to contain an "I". When areference structure bar is flagged with "I", you must also provide
corresponding data for insertion. All new line-type entries that youwant to add, including the related reference structure bars, must beplaced after all the entries you want to change (U) and delete (D).

With change data, the key fields must always be filled with data, and
will be considered as far as possible. It is thus of no importance, forexample, whether all comments on a telephone number are listed as change data before the comments on the fax number, or vice-versa,unless you completely omit the sequence numbers for communication
addresses or comments, or only state them in part. In this case, the sequence of data plays a major role.

The following fields are regarded as being key fields:

Structure Fields

BAPIAD1VL ADDR_VERS, FROM_DATE


BAPIAD_REM ADDR_VERS, LANGU

BAPIADTEL CONSNUMBER

... ...

BAPIADPAG CONSNUMBER

BAPICOMREM COMM_TYPE, CONSNUMBER, LANGU

It is possible to transfer blank sequence numbers for communicationaddresses and comments. In this case, the sequence in which the data was transferred counts. For example, if you want to delete the
telephone number that is in second position in the list of existingtelephone numbers whose sequence numbers are sorted in ascending order,with this function module you firstly have to transfer a dummytelephone number line with the update flag (U), without marking fields
for updating, and then you have to transfer a telephone number line with the deletion flag (D).

You should be aware that the communication addresses stored in thedatabase are not usually sorted according to sequence numbers. Youtherefore first have to determine the sequence of the communication addresses sorted according to sequence numbers.


You are advised not to follow the above procedure, as it is very easyto make mistakes when assigning data. It is much safer to enter the sequence numbers as the key.

You should assign your own sequence numbers with communicationaddresses that you want to create (I), and with the related addresses,
so that the assignment of the communication address to a comment isclear. You only have to make sure that the sequence numbers are not yetin use in the database, unless you explicitly want to assign a comment to an existing communication address. If you omit the number
assignment, the system assumes that all comments to be inserted belongto the communication addresses to be added, and not to existingcommunication addresses. (This would only make sense if you want to adda comment in a different language to the one in which a communication address was created).


Assignment takes place exclusively by way of the sequence of the datatransferred. The first German language comment entered on a telephonenumber, that has been flagged for creation (I), is assigned to thefirst telephone number you have said you want to add. The third English
language comment on a fax number with the insertion flag (I) is assigned to the third fax number you have said you want to add.

In this case, it is not possible to add a comment to a communicationaddress that already exists. Here you always require the correct sequence number.


If the sequence numbers are filled in the case of one category ofcommunication addresses and their comments, but not with another category, this has no effect on the overall functionality. Allcommunication types are processed separately. In other words, if
complete sequence numbers are stated with a communication type, theyare considered, even if the sequence numbers with another communicationtype are missing in full or part. In the latter two cases, the sequence of data to be processed is used.

You can state the sequence numbers with the communication addresses you
want to insert (I), and omit them with the communication addresses youwant to update (U) and delete (D), and vice-versa. Separate processingthen takes place per case (sequence numbers or sequence of data). Onlycommunication addresses that you want to update or delete have to be
transferred together, whereby the sequence numbers have to be completeor not exist at all. To be on the safe side you should always state complete sequence numbers with all data.

Data that you want to change should be read in advance (for example,with function module BAPI_ADDRESSORG_GETDETAIL), in case communication
data should also be changed. This provides you with information on the sequence numbers of communication data.


11-Dec-2005


AddressesGet

AddressesGet


No document is available


11-Dec-2005


AddressGetdetail

AddressGetdetail


No document is available


11-Dec-2005


AddressGetNumbers

AddressGetNumbers


No document is available


11-Dec-2005


AddressRemove

AddressRemove


With this function module you can delete a business partner's addresstogether with related communication data. Errors that occur as a resultof the various checks that have to be carried out are logged and output in the RETURN table.

Notes


If no address GUID is stated, the system determines and deletes the standard address of the business partner.

If several addresses exist for this business partner, the standardaddress is not deleted as long as other addresses continue to exist.


If you want to delete the standard address of the business partner, andif other addresses still exist, you have to flag one of the other addresses as being the standard address by usingBAPI_BUPA_ADDRESS_CHANGE. You must change the previous address in such a way so that it loses its status as standard address.



11-Dec-2005


BankdetailAdd

BankdetailAdd


No document is available


11-Dec-2005


BankdetailChange

BankdetailChange


No document is available


11-Dec-2005


BankdetailGetDetail

BankdetailGetDetail


No document is available


11-Dec-2005


BankdetailNumbers

BankdetailNumbers


No document is available


11-Dec-2005


BankdetailRemove

BankdetailRemove


No document is available


11-Dec-2005


BankdetailsGet

BankdetailsGet


No document is available


11-Dec-2005


CentralChange

CentralChange


With this function module you can change the central attributes of abusiness partner. Once the existence of a business partner has beenchecked, the new attributes entered are checked for their consistency or for Customizing settings.

Negative checks are logged and output in the RETURN table.


If one or more negative checks occur/s, no change is made to the business partner attributes, and an error log is output.


11-Dec-2005


ChangePassword

ChangePassword


Using this function module you can change the password of a businesspartner as an Internet user. If the change cannot be executed, acorresponding message is returned. To change the password, you mustenter the old and the new password. For verification purposes you have
to enter the new password in another parameter. The new password mustbe identifical to the password you enter for verification purposes.

When you enter a password, you must note that the use of capital and small letters is of relevance.



11-Dec-2005


CheckPassword

CheckPassword


Using this function module you can check the password of a businesspartner as an Internet user. If the check is unsuccessful, for examplebecause the business partner does not exist, or because the passworddoes not match, a message is returned. When you enter a password, you
must note that the use of capital and small letters is of relevance.


11-Dec-2005


CreateFromData

CreateFromData


You use this function module to create a business partner, whereby youcan also create an address with related communication types.

The data entered in the interface is checked for consistency and for Customizing settings.

If this check reveals in one or more errors, the errors are logged in the RETURN table, and the business partner is not created.

Notes

Die Eingabe der Partner-Category ist obligatorisch.


11-Dec-2005


CreatePassword

CreatePassword


Using this function module you can create a password for an Internetuser for a business partner. If this is not possible (because the business partner does not exist in the system, for example), acorresponding message is returned. Once you have created an Internet user, you first have to request an initial password with
BAPI_BPARTNER_INITPASSWORD, and can then change this with BAPI_BPARTNER_CHANGEPASSWORD.


11-Dec-2005


DeletePassword

DeletePassword


Using this function module you can delete the password of a businesspartner as an Internet user. If this is not possible, for examplebecause the business partner does not exist, a corresponding message is returned.


11-Dec-2005


GetDetail

GetDetail


This method provides detailed information on a business partner(general part) from the business partner master record. The INPUT information consists of the business partner number.

Notes

Messages are issued by the Return parameter. If a business partner does
not exist under the given number, a corresponding E category message isissued. If no address data exists, for example, an I category message is issued.


11-Dec-2005


GetNumbers

GetNumbers


No document is available


11-Dec-2005


GetPassword

GetPassword


Gives status information on a business partner Internet user.


11-Dec-2005


InitPassword

InitPassword


With this function module you can reset the password of a businesspartner as an Internet user. If this is not possible, for examplebecause the business partner does not exist, a corresponding message isreturned. Initialize means that an initial password is generated.



11-Dec-2005


RelationshipsGet

RelationshipsGet


No document is available


11-Dec-2005


RoleExistenceCheck

RoleExistenceCheck


No document is available


11-Dec-2005


RolesGet

RolesGet


No document is available


11-Dec-2005


Search

Search


Using this function module you can search for business partners.

The search criteria you can use are the telephone number, email addressand the address attributes country, region, and postal code. Othersearch criteria are central business partner data such as business
partner number, and match code fields MC_NAME1 und MC_NAME2. You can use the partner role to limit the hitlist even further.

The telephone number and the email address must be totally accurate,but address attributes and central data can contain wildcards, such as "*".


All the business partners matching all the search criteria are then selected.


11-Dec-2005


TaxNumberAdd

TaxNumberAdd


Adding a Tax Number to the Business Partner

Depending on the category involved, the tax number is used in tax calculations and tax notifications, for example.

Depending on the category, the tax number you have entered is checkedfor formal correctness (such as structure of number, or number of digits).



11-Dec-2005


TaxNumberChange

TaxNumberChange


No document is available


11-Dec-2005


TaxNumberGetDetail

TaxNumberGetDetail


Reading a Business Partner's Tax Number

Depending on the category involved, the tax number is used in tax calculations and tax notifications, for example.

Depending on the category, the tax number you have entered is checkedfor formal correctness (such as structure of number, or number of digits).



11-Dec-2005


TaxNumberRemove

TaxNumberRemove


No document is available


11-Dec-2005