---
# API: Business Partner - Replicate from Client
# File: BUSINESSPARTNERSUITEBULKREPLIC.md
# Version: 1.5.0
# Status: ACTIVE
# Protocol: SOAP (Synchronous)
# Source URL: https://api.sap.com/api/BUSINESSPARTNERSUITEBULKREPLIC/overview
# Generated: 2026-07-23 14:17:02
---

# Business Partner - Replicate from Client / 业务伙伴 - 从客户端复制 API

> **API 版本:** 1.5.0 | **状态:** ACTIVE (Synchronous) | **协议:** SOAP  
> **技术名称:** `BUSINESSPARTNERSUITEBULKREPLIC`  
> **WSDL 绑定:** `/sap/bc/srt/wsdl/flv_10002A111AD1/bndr_url/sap/bc/srt/rfc/sap/businesspartnersuitebulkreplic/150/businesspartnersuitebulkreplic/binding`  
> **SAP 通信场景:** `SAP_COM_0108`

## 概述 / Overview

该同步 SOAP 出站服务用于批量复制业务伙伴数据。支持业务伙伴主数据从 SAP S/4HANA 客户端复制到外部系统。

This synchronous outbound SOAP service replicates business partner data in bulk. It supports business partner master data replication from an SAP S/4HANA client to external systems.

**API 业务加速器中心:** [https://api.sap.com/api/BUSINESSPARTNERSUITEBULKREPLIC/overview](https://api.sap.com/api/BUSINESSPARTNERSUITEBULKREPLIC/overview)

---

## 消息结构 / Message Structure

| # | 结构名称 | 描述 (EN) | 描述 (CN) |
|---|----------|-----------|-----------|
| 1 | `BusinessPartnerBulkReplicateRequest` | Business Partner Bulk Replicate Request | 业务伙伴批量复制请求 |
| 2 | `BusinessPartnerBulkReplicateResponse` | Business Partner Bulk Replicate Response | 业务伙伴批量复制响应 |

---

## 1. 请求结构: BusinessPartnerBulkReplicateRequest / 业务伙伴批量复制请求

**命名空间:** `urn:sap-com:document:sap:soap:functions:mc-style`

| # | 字段名称 | 类型 | 必填 | 描述 (EN) | 描述 (CN) |
|---|----------|------|------|-----------|-----------|
| 1 | `BusinessPartner` | CHAR(10) | 是 | Business Partner Number | 业务伙伴编号 |
| 2 | `BusinessPartnerName` | CHAR(80) | 否 | Business Partner Full Name | 业务伙伴全名 |
| 3 | `BusinessPartnerCategory` | CHAR(2) | 否 | Business Partner Category (1=Person, 2=Organization, 3=Group) | 业务伙伴类别（1=个人，2=组织，3=小组） |
| 4 | `BusinessPartnerGrouping` | CHAR(4) | 否 | Business Partner Grouping | 业务伙伴分组 |
| 5 | `BusinessPartnerFullName` | CHAR(80) | 否 | Full Name of Business Partner | 业务伙伴全名 |
| 6 | `BusinessPartnerBirthDate` | DATE | 否 | Date of Birth of Business Partner | 业务伙伴出生日期 |
| 7 | `BusinessPartnerLanguage` | CHAR(2) | 否 | Business Partner Language Key | 业务伙伴语言键值 |
| 8 | `BusinessPartnerCreationDate` | DATE | 否 | Date on which Business Partner was Created | 业务伙伴创建日期 |
| 9 | `BusinessPartnerValidityDate` | DATE | 否 | Validity Date of Business Partner | 业务伙伴有效日期 |
| 10 | `BusinessPartnerRole` | CHAR(6) | 否 | Business Partner Role | 业务伙伴角色 |

---

## 2. 响应结构: BusinessPartnerBulkReplicateResponse / 业务伙伴批量复制响应

**命名空间:** `urn:sap-com:document:sap:soap:functions:mc-style`

| # | 字段名称 | 类型 | 描述 (EN) | 描述 (CN) |
|---|----------|------|-----------|-----------|
| 1 | `ReturnCode` | CHAR(1) | Return Code (S=Success, E=Error, W=Warning) | 返回代码（S=成功，E=错误，W=警告） |
| 2 | `ReturnMessage` | CHAR(220) | Return Message Text | 返回消息文本 |
| 3 | `NumberOfBusinessPartners` | INT | Number of Processed Business Partners | 已处理的业务伙伴数量 |
| 4 | `ProcessedBusinessPartners` | TABLE | Table of Processed Business Partners | 已处理的业务伙伴列表 |

---

## 3. 表结构: ProcessedBusinessPartners / 已处理的业务伙伴列表

| # | 字段名称 | 类型 | 描述 (EN) | 描述 (CN) |
|---|----------|------|-----------|-----------|
| 1 | `BusinessPartner` | CHAR(10) | Business Partner Number | 业务伙伴编号 |
| 2 | `Status` | CHAR(1) | Processing Status | 处理状态 |
| 3 | `Message` | CHAR(220) | Status Message | 状态消息 |

---

## SOAP 请求示例 / SOAP Request Example

```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header/>
  <soap:Body>
    <BusinessPartnerBulkReplicate xmlns="urn:sap-com:document:sap:soap:functions:mc-style">
      <BusinessPartner>0000001001</BusinessPartner>
      <BusinessPartnerName>ABC Corporation</BusinessPartnerName>
      <BusinessPartnerCategory>2</BusinessPartnerCategory>
    </BusinessPartnerBulkReplicate>
  </soap:Body>
</soap:Envelope>
```

## SOAP 响应示例 / SOAP Response Example

```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <BusinessPartnerBulkReplicateResponse xmlns="urn:sap-com:document:sap:soap:functions:mc-style">
      <ReturnCode>S</ReturnCode>
      <ReturnMessage>Business partners replicated successfully</ReturnMessage>
      <NumberOfBusinessPartners>1</NumberOfBusinessPartners>
    </BusinessPartnerBulkReplicateResponse>
  </soap:Body>
</soap:Envelope>
```

---

## 错误处理 / Error Handling

| HTTP 状态码 | 错误代码 | 描述 (EN) | 描述 (CN) |
|-------------|----------|-----------|-----------|
| 400 | `BUS_PARTNER_NOT_FOUND` | Business Partner Not Found | 业务伙伴未找到 |
| 400 | `INVALID_CATEGORY` | Invalid Business Partner Category | 业务伙伴类别无效 |
| 500 | `INTERNAL_ERROR` | Internal Server Error | 服务器内部错误 |