# CO_NGC_SOAP_CHARCBULKREPREQOUT

**SOAP v1.0.0 — ACTIVE**

## Title / 标题
**Characteristic Data for Classification - Replicate (Asynchronous, Outbound) / 分类特征数据 - 复制（异步，出站）**

## Operation / 操作
`CharacteristicBulkReplicateRequest_Out`

---

## Description / 描述
This outbound SOAP service consumer enables you to replicate classification characteristics from SAP S/4HANA Cloud to an external client system.

此出站SOAP服务消费者使您能够将分类特征数据从SAP S/4HANA Cloud复制到外部客户端系统。

---

## Endpoint / 端点
| Environment | URL |
|-------------|-----|
| Production | `https://sap.example.com/sap/bc/srt/rfc/sap/CO_NGC_SOAP_CHARCBULKREPREQOUT` |
| Test | `https://sap-test.example.com/sap/bc/srt/rfc/sap/CO_NGC_SOAP_CHARCBULKREPREQOUT` |

## Message Structure / 消息结构

### Request / 请求
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `MessageHeader` | `BUS_DOC_MSG_HDR` | Message header | 消息头 |
| `?ID` | `CHAR(35)` | Message ID | 消息ID |
| `?UUID` | `RAW(16)` | Message UUID | 消息UUID |
| `?CreationDateTime` | `DATETIME` | Creation timestamp | 创建时间戳 |
| `?SenderID` | `CHAR(60)` | Sender system ID | 发送方系统ID |
| `CharacteristicBulkReplicateRequest` | `CHR_BULK_REQ` | Bulk replication request root | 批量复制请求根节点 |
| `?CharInternalID` | `CHAR(30)` | Characteristic internal ID | 特征内部ID |
| `?CharExternalID` | `CHAR(30)` | Characteristic external ID | 特征外部ID |
| `?CharDescription` | `CHAR(40)` | Characteristic description | 特征描述 |
| `?CharStatus` | `CHAR(1)` | Status (1=active, 0=inactive) | 状态（1=活跃，0=非活跃） |
| `?DataType` | `CHAR(4)` | Data type (NUM/CHAR/DATE) | 数据类型（NUM/CHAR/DATE） |
| `?ValueLength` | `NUMC(3)` | Value length | 值长度 |
| `?DecimalPlaces` | `NUMC(2)` | Number of decimal places | 小数位数 |
| `?UnitOfMeasure` | `UNIT(3)` | Unit of measure | 计量单位 |
| `?SingleValue` | `CHAR(1)` | Single value flag | 单值标志 |
| `?Template` | `CHAR(30)` | Characteristic template | 特征模板 |
| `Values` | Table | Allowed characteristic values | 允许的特征值 |
| `?ValueInternalID` | `CHAR(30)` | Value internal ID | 值内部ID |
| `?ValueExternalID` | `CHAR(30)` | Value external ID | 值外部ID |
| `?ValueDescription` | `CHAR(40)` | Value description | 值描述 |
| `?SortOrder` | `NUMC(4)` | Sort order | 排序顺序 |

### Response / 响应
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `Return` | `BAPIRETURN` | Application log message | 应用程序日志消息 |
| `?Type` | `CHAR(1)` | Message type (S/E/W/I) | 消息类型（成功/错误/警告/信息） |
| `?Code` | `CHAR(20)` | Message code | 消息代码 |
| `?Message` | `CHAR(220)` | Message text | 消息文本 |

---

## Example Payload / 示例负载

### Request
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <CharacteristicBulkReplicateRequest_Out>
      <MessageHeader>
        <ID>CHR-REPL-20260723-001</ID>
        <UUID>6B29FC40-CA47-1067-B31D-00DD010662DA</UUID>
        <CreationDateTime>2026-07-23T08:00:00Z</CreationDateTime>
        <SenderID>SAP_S4HANA_CLNT_100</SenderID>
      </MessageHeader>
      <CharacteristicBulkReplicateRequest>
        <CharInternalID>CHR-001</CharInternalID>
        <CharExternalID>COLOR_CODE</CharExternalID>
        <CharDescription>Color Code / 颜色代码</CharDescription>
        <CharStatus>1</CharStatus>
        <DataType>CHAR</DataType>
        <ValueLength>10</ValueLength>
        <SingleValue>X</SingleValue>
      </CharacteristicBulkReplicateRequest>
      <Values>
        <item>
          <ValueInternalID>VAL-001</ValueInternalID>
          <ValueExternalID>RED</ValueExternalID>
          <ValueDescription>Red / 红色</ValueDescription>
          <SortOrder>0010</SortOrder>
        </item>
        <item>
          <ValueInternalID>VAL-002</ValueInternalID>
          <ValueExternalID>BLUE</ValueExternalID>
          <ValueDescription>Blue / 蓝色</ValueDescription>
          <SortOrder>0020</SortOrder>
        </item>
        <item>
          <ValueInternalID>VAL-003</ValueInternalID>
          <ValueExternalID>GREEN</ValueExternalID>
          <ValueDescription>Green / 绿色</ValueDescription>
          <SortOrder>0030</SortOrder>
        </item>
      </Values>
    </CharacteristicBulkReplicateRequest_Out>
  </soap:Body>
</soap:Envelope>
```

### Response
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <CharacteristicBulkReplicateRequest_OutResponse>
      <Return>
        <Type>S</Type>
        <Code>CHR_100</Code>
        <Message>Characteristics replicated successfully / 特征已成功复制</Message>
      </Return>
    </CharacteristicBulkReplicateRequest_OutResponse>
  </soap:Body>
</soap:Envelope>
```

---

## Error Codes / 错误代码
| Code | Description (EN) | Description (CN) |
|------|------------------|------------------|
| `CHR_001` | Invalid characteristic ID | 无效的特征ID |
| `CHR_002` | Data type not supported | 不支持的数据类型 |
| `CHR_003` | Value length exceeds maximum | 值长度超出最大值 |
| `CHR_004` | Duplicate value entry | 重复的值条目 |

---

## Notes / 备注
- This is an asynchronous outbound service / 这是一个异步出站服务
- The service replicates characteristics from SAP S/4HANA to external classification systems / 该服务将特征从SAP S/4HANA复制到外部分类系统
- Characteristic changes trigger automatic replication / 特征变更触发自动复制
- Use AIF for error monitoring and reprocessing / 使用AIF进行错误监控和重新处理