---
# API: Workforce Person Master Data - Replicate
# File: WORKFORCEPERSONMASTERDATAREPLI.md
# Version: 1.0.0
# Status: ACTIVE
# Protocol: SOAP (Synchronous/Asynchronous)
# Source URL: https://api.sap.com/api/WORKFORCEPERSONMASTERDATAREPLI/overview
# Generated: 2026-07-23 14:17:02
---

# Workforce Person Master Data - Replicate / 员工主数据 - 复制

> **API 版本:** 1.0.0 | **状态:** ACTIVE | **协议:** SOAP
> **技术名称:** `WORKFORCEPERSONMASTERDATAREPLI`
> **WSDL 绑定:** `/sap/bc/srt/wsdl/flv_10002A111AD1/bndr_url/sap/bc/srt/rfc/sap/workforcepersonmasterdatareplicate/100/workforcepersonmasterdatareplicate/binding`
> **SAP 通信场景:** `SAP_COM_0109`

## 概述 / Overview

该服务用于复制员工主数据，支持人员编号、姓名、雇佣开始日期等关键字段的传输。

This service replicates workforce person master data, supporting transmission of key fields such as PersonID, FirstName, LastName, EmploymentStartDate, etc.

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

---

## 消息结构 / Message Structure

| # | 结构名称 | 描述 (EN) | 描述 (CN) |
|---|----------|-----------|-----------|
| 1 | `PersonMasterDataReplicateRequest` | Person Master Data Replicate Request | 员工主数据复制请求 |
| 2 | `PersonMasterDataReplicateResponse` | Person Master Data Replicate Response | 员工主数据复制响应 |

---

## 1. 请求结构: PersonMasterDataReplicateRequest / 员工主数据复制请求

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

```
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:ns="urn:sap-com:document:sap:soap:functions:mc-style">
  <soap:Header/>
  <soap:Body>
    <ns:WorkforcePersonMasterDataReplicate>
      <Persons>
        <item>
          <PersonID>P100001</PersonID>
          <FirstName>张三</FirstName>
          <LastName>Zhang</LastName>
          <EmploymentStartDate>2020-03-01</EmploymentStartDate>
          <EmploymentEndDate>9999-12-31</EmploymentEndDate>
          <CompanyCode>1000</CompanyCode>
          <CostCenter>CC100</CostCenter>
          <Email>zhang.san@company.com</Email>
          <Language>ZH</Language>
        </item>
      </Persons>
    </ns:WorkforcePersonMasterDataReplicate>
  </soap:Body>
</soap:Envelope>
```

## 2. 响应结构: PersonMasterDataReplicateResponse / 员工主数据复制响应

```
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:ns="urn:sap-com:document:sap:soap:functions:mc-style">
  <soap:Header/>
  <soap:Body>
    <ns:WorkforcePersonMasterDataReplicateResponse>
      <Success>true</Success>
      <Persons>
        <item>
          <PersonID>P100001</PersonID>
          <Message>Person master data replicated successfully</Message>
        </item>
      </Persons>
    </ns:WorkforcePersonMasterDataReplicateResponse>
  </soap:Body>
</soap:Envelope>
```

---

## 字段详细说明 / Field Details

### Person 人员主数字段

| 字段 | 类型 | 描述 (EN) | 描述 (CN) | 备注 |
|------|------|-----------|-----------|------|
| `PersonID` | STRING | Person ID | 人员编号 | 字符长度: 10 |
| `FirstName` | STRING | First Name | 名 | 字符长度: 40 |
| `LastName` | STRING | Last Name | 姓 | 字符长度: 40 |
| `EmploymentStartDate` | DATE | Employment Start Date | 雇佣开始日期 | 格式: YYYY-MM-DD |
| `EmploymentEndDate` | DATE | Employment End Date | 雇佣结束日期 | 格式: YYYY-MM-DD |
| `CompanyCode` | STRING | Company Code | 公司代码 | 字符长度: 4 |
| `CostCenter` | STRING | Cost Center | 成本中心 | 字符长度: 10 |
| `Email` | STRING | Email Address | 电子邮件 | 字符长度: 241 |
| `Language` | STRING | Language | 语言 | ISO 语言代码 |

---

## 错误处理 / Error Handling

| HTTP状态码 | 错误代码 | 描述 (EN) | 描述 (CN) |
|-----------|----------|-----------|-----------|
| 400 | `INVALID_PERSON_DATA` | Invalid person master data | 无效的员工主数据 |
| 500 | `REPLICATION_FAILED` | Person master data replication failed | 员工主数据复制失败 |

---

## 使用示例 / Usage Examples

### PowerShell 调用示例

```powershell
$body = "<soap:Envelope xmlns:soap=""http://schemas.xmlsoap.org/soap/envelope/"" xmlns:ns=""urn:sap-com:document:sap:soap:functions:mc-style""><soap:Header/><soap:Body><ns:WorkforcePersonMasterDataReplicate><Persons><item><PersonID>P100001</PersonID><FirstName>张三</FirstName><LastName>Zhang</LastName><EmploymentStartDate>2020-03-01</EmploymentStartDate><CompanyCode>1000</CompanyCode><CostCenter>CC100</CostCenter><Language>ZH</Language></item></Persons></ns:WorkforcePersonMasterDataReplicate></soap:Body></soap:Envelope>"

$response = Invoke-WebRequest -Uri "https://your-sap-system.com/sap/bc/srt/rfc/sap/workforcepersonmasterdatareplicate/100/workforcepersonmasterdatareplicate/binding" -Method Post -Body $body -ContentType "text/xml; charset=utf-8"
$response.Content
```

---

## 相关资源 / Related Resources

- SAP API Business Hub: [Workforce Person](https://api.sap.com/api/WORKFORCEPERSONMASTERDATAREPLI/overview)
- SAP Communication Scenario: SAP_COM_0109
