Guide

Business Partner Migration: KNA1/LFA1 to BUT000

Guide to the SAP S/4HANA Business Partner migration — how customer master (KNA1) and vendor master (LFA1) data moves to the central Business Partner (BUT000) model.

Why Business Partner?

In SAP ECC, customers and vendors lived in separate master data silos: KNA1 (Customer General Data) and LFA1 (Vendor General Data), with company-code-level data in KNB1/LFB1 and bank data in KNBK/LFBK. A single business entity that was both a customer and a vendor required two separate master records with no structural link.

SAP S/4HANA mandates the Business Partner (BP) model. Every customer and vendor is a Business Partner stored in BUT000 (BP General Data), with roles determining whether the partner acts as a customer, vendor, or both.

Table Migration Overview

ECC TablePurposeS/4HANA Equivalent
KNA1Customer General DataBUT000 + BP Role FLCU00
KNB1Customer Company Code DataStill exists, linked via BP number
KNVVCustomer Sales Area DataStill exists, linked via BP number
KNBKCustomer Bank DataBUT0BK (BP Bank Details)
LFA1Vendor General DataBUT000 + BP Role FLVN00
LFB1Vendor Company Code DataStill exists, linked via BP number
LFM1Vendor Purchasing DataStill exists, linked via BP number
LFBKVendor Bank DataBUT0BK (BP Bank Details)

Note: KNA1 and LFA1 still exist in S/4HANA as compatibility views. New records are created exclusively through the BP transaction. The Customer-Vendor Integration (CVI) synchronizes data between the BP and customer/vendor layers.

Number Synchronization

S/4HANA enforces same-number assignment: the Business Partner number, Customer number, and Vendor number are identical. If BP 1000000 is a customer, then KUNNR = 1000000. This is controlled by customizing in transaction BUCF (BP–Customer/Vendor Number Range Mapping).

CDS Views for Business Partner

The recommended CDS Views for accessing business partner data:

Transaction Changes

ECC TransactionPurposeS/4HANA Replacement
XD01 / XD02 / XD03Customer Create/Change/DisplayBP (Business Partner)
XK01 / XK02 / XK03Vendor Create/Change/DisplayBP (Business Partner)
FD01 / FD02 / FD03Customer (FI) Create/Change/DisplayBP (Business Partner)
FK01 / FK02 / FK03Vendor (FI) Create/Change/DisplayBP (Business Partner)
MK01 / MK02 / MK03Vendor (MM) Create/Change/DisplayBP (Business Partner)

ABAP Code Migration Example

Before (ECC — reading KNA1):

SELECT kunnr name1 land1 ort01
  FROM kna1
  INTO TABLE @DATA(lt_customers)
  WHERE land1 = 'DE'.

After (S/4HANA — using CDS View):

SELECT Customer, CustomerName, Country, CityName
  FROM I_Customer
  WHERE Country = 'DE'
  INTO TABLE @DATA(lt_customers).

Migration Steps

  1. Pre-Check — Run transaction BUPA_PRE_CHECK to identify data quality issues (duplicate tax numbers, inconsistent addresses, etc.)
  2. Number Range Alignment — Configure same-number assignment in BUCF before migration
  3. CVI Synchronization — Run report CVI_MIGRATION to create BP records from existing customers/vendors
  4. Custom Code Adaptation — Replace direct KNA1/LFA1 reads with CDS Views or BP APIs
  5. Testing — Validate that all customer/vendor scenarios work via BP transaction

Related Resources