5.0 Function Modules

Function Group BUBA_3 – Contains function modules to read and change business partner addresses, central data, bank details, payment cards, roles. Function modules for contact person and employee specific information retrieval / change are also included.

For most of the function modules that retrieve data, business partner number is passed as import parameter. Data is retrieved in the table specified in the interface. Return table returns status messages.

For most of the function modules that add business partner related details, business partner number and a table containing the details to be added are passed via the interface. Return table returns status messages.

5.1 Data Creation

从R3导物料数据

Function COM_HIERARCHY_CREATE_API （CR100 P129）？用何种技术调用该函数？

Name	Description
GUID_CREATE	Create GUID for a Business Transaction
BAPI_BUSPROCESSND_CREATEMULTI	Bapi to create Service Contracts programmatically. Pass the inputfields to be created in the contract. Note: BAPI_BUSPROCESSND_SAVE must be called after this function call to save the Service Contract.
BAPI_BUSPROCESSND_SAVE	Bapi to save the Service Contracts.
BAPI_ECRMISUTO_INIT	Initialize the creation of Ibase in CRM
BAPI_ECRMISUTO_CREATEMULTIPLE	Create the Installed Base and its components. Note: Always call the function module ‘BAPI_TRANSACTION_COMMIT’ after call to any Bapi
CRM_IBASE_INITIALIZE	Initialize the changes to be done in Ibase in CRM
CRM_IBASE_SAVE	Call this FM to save the changes in the Ibase
BAPI_BUPA_FRG0130_CREATE	Bapi to create Business Agreement for a customer
BAPI_BUPA_ADDRESS_ADD	Add invoice address for business partner. Pass the address type as 'rechnung' to add invoice address
BAPI_BUPA_BANKDETAIL_ADD	Add bank details for the business partner
BAPI_BUPA_CREATE_FROM_DATA	BAPI for business partner creation as Organization, Person or Group in general role. Same BAPI can be used to create Contact Person for the Business Partner
BAPI_BUPR_RELATIONSHIP_CREATE	Function module to establish the Business Partner and Contact Person Relationship. Pass the Relationship Category as ‘BUR001’
BAPI_BUPA_ROLE_ADD	Add Role to Business Partner for e.g. Sold to Party ‘CRM001’, Contact Person ‘BUP001’
BAPI_BUPA_TAX_ADD	BAPI Add Tax Number for the existing Business Partner
BAPI_BUPA_FRG0040_CREATE	Create Classification Data for a Business Partner
BAPI_BUPA_FRG0130_CREATE	Create Business Agreement
BAPI_BUSPROCESSND_CREATEMULTI	BAPI to create Contract. Populate the Header and Line Item Details before calling the BAPI

5.2 Data Retrieval

Name	Description
BAPI_BUPA_ADDRESSES_GET	Determine All Addresses
BAPI_BUPA_ADDRESS_GETDETAIL	Read Address
BAPI_BUPA_ADDRESS_GET_NUMBERS	Read Address Numbers
BAPI_BUPA_BANKDETAILS_GET	Determine All Bank Details
BAPI_BUPA_BANKDETAIL_GETDETAIL	Read Bank Details
BAPI_BUPA_BANKDETAIL_NUMBERS	Read Bank Details Numbers
BAPI_BUPA_CENTRAL_GETDETAIL	Read Central Data
BAPI_BUPA_EXISTENCE_CHECK	Check Existence of Business Partner
BAPI_BUPA_GET_NUMBERS	Read Business Partner Numbers
BAPI_BUPA_RELATIONSHIPS_GET	Determine All BP Relationships
BAPI_BUPA_ROLES_GET	Determine All Roles
BAPI_BUPA_ROLE_EXISTENCE_CHECK	Check Existence of Role
BAPI_BUPA_SEARCH	Search Business Partner for Telephone, E-Mail, Address
BAPI_BUPA_STATUS_GETDETAIL	Business Partner: Read Status
BAPI_BUPR_ACTIVITYP_EXISTCHECK	Check Existence of Contact Partner Relationship
BAPI_BUPR_CONTP_ADDRESSES_GET	Read Contact Person Relationship Addresses
BAPI_BUPR_CONTP_ADDR_GETDETAIL	Read Contact Person Relationship Addresses
BAPI_BUPR_CONTP_GETDETAIL	Read Contact Person Relationship
BAPI_BUPR_EMPLO_ADDRESSES_GET	Read Contact Person Relationship Addresses
BAPI_BUPR_EMPLO_ADDR_GETDETAIL	Read Employee Relationship Address
BAPI_BUPR_EMPLO_GETDETAIL	Read Employee Relationship
BAPI_BUPR_RELATIONSHIP_GET	Read General Relationship
BAPI_BUPR_RELSHIP_CHECKEXIST	Check Existence of General Relationship
BAPI_BUPR_RELSHIP_GET_DETAIL	Read General Relationship
BAPI_BUPR_RESP_EMPLO_CHEKEXIST	Read Relationship of Employee Responsible
BUPA_PARTNER_CONTACT_SEARCH	Searches business partners for telephone, E-Mail, address
ECRM_ISU_COMP_BY_ADDRESS	Check for Existence of Ibase
CRM_ORDER_GET_HEADER_GUID	Get Header GUID for Item GUID pass ref_kind as b
CRM_ORDERADM_H_READ_OW	Read the Header Details for a Business Transaction. Pass the Header guid.
CRM_ORDERADM_I_READ_OW	Read the Line Item Details for a line item. Pass the line item guid.
CRM_ORDER_READ	Get all the Service Contract details. Note: Pass the requested objects to fetch only the required details. This can also be used to get the details of activities/leads/opportunities etc.
CRM_ORDER_GETSTATUS	Get status of the Service Contract

Note: CRM_ORDER_READ Function Module

CRM_ORDER_READ is a function module which can be used to get the details of any business transaction based on the Header GUID, Item GUID or both.
Always pass the IT_REQUESTED_OBJECTS structure to this function module to fetch the required details only.
This function module can not be executed directly instead SAP has provided a report CRM_ORDER_READ for the same for testing purpose. We can pass Business Transaction Number (Object ID), Header GUID or Item GUID to this report to get the required details.

Some Exporting Parameters in CRM_ORDER_READ Function Module

Return Structure Name	Details Fetched
ET_ORDERADM_H	Header Details of a Business Transaction such as OBJECT_ID, PROCESS_TYPE etc.
ET_ORDERADM_I	Item Details of a Business Transaction such as PRODUCT, PRODUCT_KIND, HEADER etc.
ET_ACTIVITY_H	Header Details of an activity such as PRIORITY, OBJECTIVE, Address Details etc.
ET_ACTIVITY_I	Item Details of an activity.
ET_CUSTOMER_H	Additional details at Header level
ET_CUSTOMER_I	Additional details at Item level
ET_APPOINTMENT	All the dates at Header and Item level
ET_PARTNER	Partner Details at Header and Item level
ET_STATUS	Status of Business Transaction at Header and Item level
ET_BILLING	Billing related details for a Business Transaction both at Header and Item (This structure was enhanced in a leading ISU SAP-CRM implementation to include BUAG_ID(Business Agreement) field in a Service Contract
ET_ORDPRP_OBJL_I_D	Object List details such as PRODUCT
ET_DOC_FLOW	Ref. Details of the previous Business Transaction

Document Flow function. 读取参考单据信息

CRM_DOC_FLOW_READ_DB

根据BP描述查找BP编号：

COM_PARTNER_IDENTIFY

参数: IV_ENTRY= BP描述。

参考程序：（

GENERATE_TABLE_CONTROL_CHANGES

CALL FUNCTION 'COM_PARTNER_IDENTIFY'

CHANGING CT_FIELD_VALUE_PAIRS LIKE GT_FIELD_VALUE_PAIRS.

program:COM_PARTNER_UI2

Screen : 2002

）

5.3 Data Maintenance

Name	Description
BAPI_BUSPROCESSND_CHANGEMULTI	Bapi to change Service Contracts programmatically. Pass the inputfields to be modified. Note: CRM_ORDER_SAVE function module must be called to save the changed contract explicitly after call to this function module.
CRM_ORDER_SAVE	Save the changes made to the Service Contract. Just pass the Header_GUID of the service contract.
CRM_APPT_MAINTAIN_SINGLE_OW	Maintain the Dates for a Service Contract (Start Date, End date, Date of Sale, Planned Contract Start Date etc). Don’t forget to pass the input_fields to be maintained. Note: CRM_ORDER_SAVE function module must be called to save the changed contract explicitly after call to this function module.
CRM_STATUS_MAINTAIN_OW	Maintain the user status of Service Contracts. Don’t forget to pass the input_fields to be maintained. Note: CRM_ORDER_SAVE function module must be called to save the changed contract explicitly after call to this function module.
CRM_IBASE_COMP_CHANGE	Change the Installed Base components Note: Always call the FM ‘CRM_IBASE_SAVE’ to save the changes done to Ibase