Customer and Business Partner
SD / O2Cintermediate

Business Partner Model and Customer Vendor Integration (CVI) in S/4HANA

Explains how S/4HANA replaces direct customer master maintenance with the Business Partner model, how CVI synchronizes BP with customer and vendor master data, and what this means for configuration and troubleshooting.

Explanation

In S/4HANA (on-premise and private cloud), SAP mandates the Business Partner (BP) as the single point of entry for maintaining customer and vendor master data. This is a strategic architectural shift from ECC, where customers (XD01/XD02 style transactions conceptually) and vendors were maintained through separate master data objects with separate number ranges and separate screens. The BP model unifies the person/organization/group concept: a single BP can hold multiple roles (FI Customer, FI Vendor, SD-relevant customer role, etc.), and the underlying customer (KNA1/KNB1/KNVV) and vendor (LFA1/LFB1) tables are kept synchronized in the background through Customer Vendor Integration (CVI). CVI is not optional in S/4HANA on-premise for customer/vendor maintenance through standard transactions; it is the mandatory synchronization layer. When a Business Partner is created and a customer role (e.g., FLCU00 for FI customer, or SD-relevant BP roles) is assigned, CVI automatically creates or updates the corresponding classic customer master records behind the scenes. This means the general data, company code data, and sales area data segments described in the previous lesson still exist physically, but the primary maintenance transaction is now BP-centric rather than direct customer master transactions. From a configuration standpoint, this requires several elements to be in place before BP-to-customer synchronization works correctly: a BP grouping must be mapped to a customer account group (and separately to a vendor account group if the BP will also be a vendor), number ranges for BP and customer account groups must be aligned in a compatible way (especially critical when using external number assignment, since mismatched number ranges are one of the most common CVI errors), and the relevant BP roles must be activated for the business partner category (person, organization, or group) in use. A critical practical point for consultants: because CVI runs synchronously during BP maintenance in most on-premise scenarios, an error in mapping configuration (e.g., no customer account group assigned to a BP grouping) will block the save of the Business Partner itself, not just produce a silent data gap. This is a common go-live blocker when consultants underestimate CVI setup during data migration cutover. On S/4HANA Public Cloud, BP is likewise the standard, but the emphasis shifts further toward Fiori apps and predefined configuration content, with less direct exposure to classic customizing transactions; extensibility and configuration changes are typically done through the SAP-provided configuration environment (e.g., Manage Business Configuration / SSCUI style apps) rather than classic IMG paths, and administrators should expect more guided, template-driven setup with reduced flexibility to deviate from SAP's standard BP-CVI mapping. For migration projects moving from ECC to S/4HANA, existing customer and vendor master data must be converted into Business Partners using SAP's migration tooling as part of the technical conversion; this is typically handled by Basis/technical migration teams, but functional consultants must validate that account group mappings, number ranges, and role assignments are correctly configured beforehand, and must reconcile sample records post-conversion to confirm sales area data, partner functions, and tax classifications carried over correctly.

Code example

ABAP Code
* Illustrative check: comparing BP number to synchronized customer number after CVI* Table: CVI_CUST_LINK (representative of BP-customer link concept; exact table naming varies by release)SELECT partner kunnr  FROM but000  " Business Partner general data (conceptual reference)  INTO TABLE @DATA(lt_bp)  WHERE partner = '0000500123'. * Conceptual verification steps during CVI troubleshooting:* 1. Confirm BP exists and has the correct BP role (e.g., FI Customer) assigned.* 2. Confirm BP grouping is mapped to a customer account group in the number range/grouping customizing.* 3. Confirm the synchronized customer master (KNA1) was created with matching number (if number ranges are aligned).* 4. If sales area data is missing after sync, extend sales area data using the sales-relevant BP role or the appropriate follow-on transaction.

Real project scenario

During an S/4HANA on-premise greenfield implementation, the project team configured Business Partner groupings late in the build phase without properly mapping every BP grouping to a corresponding customer account group. When business users attempted to create new customers via the Business Partner transaction during integration testing, saves failed intermittently for certain customer types with a generic synchronization error. Root cause analysis traced the failures to two BP groupings that had no customer account group mapping in the CVI configuration. The team had to extend the configuration mapping table and re-test, and the lesson learned was added to the project's configuration checklist: BP grouping to account group mapping must be validated for every planned customer/vendor type before integration testing begins, not just for the primary account groups used in demos.

Common mistakes

โ€ข Assuming customer master transactions still work as the primary maintenance path in S/4HANA on-premise without recognizing BP as mandatory. โ€ข Failing to map every planned BP grouping to a customer (and vendor, if dual role) account group before testing begins. โ€ข Using mismatched internal/external number range settings between BP grouping and customer account group, causing synchronization failures. โ€ข Not validating post-migration that sales area data, tax classification, and partner functions were correctly carried over after CVI conversion. โ€ข Treating Public Cloud BP configuration as identical to on-premise IMG-based configuration when the available tools and flexibility differ.

Best practices

โ€ข Validate BP grouping to account group mapping for every customer and vendor type before integration testing, not just primary types. โ€ข Align number range assignment between BP groupings and customer/vendor account groups early in the design phase to avoid synchronization errors. โ€ข During ECC-to-S/4HANA conversion, reconcile a representative sample of converted Business Partners against original customer/vendor master data for sales area, tax, and partner function accuracy. โ€ข Document whether the deployment is on-premise/private cloud (classic IMG-based CVI configuration) or public cloud (guided configuration apps) since setup approach differs materially. โ€ข Involve both SD and FI functional consultants in BP configuration design since customer and vendor roles intersect with both domains.

Interview angle

Candidates are often asked to explain why SAP introduced the Business Partner model and what CVI does. A strong answer distinguishes conceptual unification (single object, multiple roles) from the technical synchronization mechanism (CVI keeping classic tables updated) and can describe a real failure mode such as number range mismatch or missing account group mapping. Senior candidates should also be able to contrast on-premise CVI mechanics with the more guided configuration experience in S/4HANA Public Cloud.