# CO_NGC_SOAP_CLASSBULKREPCONOUT

**SOAP v1.0.0 — ACTIVE**

## Title / 标题
**Class Data for Classification - Confirmation (Asynchronous, Outbound) / 分类类数据 - 确认（异步，出站）**

## Operation / 操作
`ClassBulkReplicateConfirmation_Out`

---

## Description / 描述
This outbound SOAP service consumer enables you to send confirmation from an SAP S/4HANA Cloud system to the client system about the replication of classification classes.

此出站SOAP服务消费者使您能够将关于分类类复制的确认信息从SAP S/4HANA Cloud系统发送到客户端系统。

---

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

## 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 |
| `?ReceiverID` | `CHAR(60)` | Receiver system ID | 接收方系统ID |
| `ClassBulkReplicateConfirmation` | `CLS_BULK_CONF` | Bulk replication confirmation root | 批量复制确认根节点 |
| `?ClassInternalID` | `CHAR(30)` | Class internal ID | 类内部ID |
| `?ClassExternalID` | `CHAR(30)` | Class external ID | 类外部ID |
| `?ClassType` | `CHAR(3)` | Class type | 类类型 |
| `?ClassDescription` | `CHAR(40)` | Class description | 类描述 |
| `?ClassStatus` | `CHAR(1)` | Status (1=active, 0=inactive) | 状态（1=活跃，0=非活跃） |
| `?ConfirmationStatus` | `CHAR(1)` | Confirmation (S=success, E=error) | 确认（S=成功，E=错误） |
| `?ConfirmationMessage` | `CHAR(220)` | Confirmation message text | 确认消息文本 |
| `?ParentClassID` | `CHAR(30)` | Parent class ID | 父类ID |
| `Characteristics` | Table | Assigned characteristics | 分配的特征 |
| `?CharInternalID` | `CHAR(30)` | Characteristic internal ID | 特征内部ID |
| `?CharExternalID` | `CHAR(30)` | Characteristic external ID | 特征外部ID |
| `?Required` | `CHAR(1)` | Mandatory characteristic flag | 必需特征标志 |
| `?SortOrder` | `NUMC(4)` | Sort order within class | 类内排序顺序 |

### 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>
    <ClassBulkReplicateConfirmation_Out>
      <MessageHeader>
        <ID>CLS-CONF-20260723-001</ID>
        <UUID>6B29FC40-CA47-1067-B31D-00DD010662DB</UUID>
        <CreationDateTime>2026-07-23T09:15:00Z</CreationDateTime>
        <SenderID>SAP_S4HANA_CLNT_100</SenderID>
        <ReceiverID>CLIENT_SYSTEM_001</ReceiverID>
      </MessageHeader>
      <ClassBulkReplicateConfirmation>
        <ClassInternalID>CLS-001</ClassInternalID>
        <ClassExternalID>MATERIAL_COLOR</ClassExternalID>
        <ClassType>001</ClassType>
        <ClassDescription>Material Color Classification / 物料颜色分类</ClassDescription>
        <ClassStatus>1</ClassStatus>
        <ConfirmationStatus>S</ConfirmationStatus>
        <ConfirmationMessage>Class replicated successfully / 类已成功复制</ConfirmationMessage>
      </ClassBulkReplicateConfirmation>
      <Characteristics>
        <item>
          <CharInternalID>CHR-001</CharInternalID>
          <CharExternalID>COLOR_CODE</CharExternalID>
          <Required>X</Required>
          <SortOrder>0010</SortOrder>
        </item>
        <item>
          <CharInternalID>CHR-002</CharInternalID>
          <CharExternalID>COLOR_DESC</CharExternalID>
          <Required></Required>
          <SortOrder>0020</SortOrder>
        </item>
      </Characteristics>
    </ClassBulkReplicateConfirmation_Out>
  </soap:Body>
</soap:Envelope>
```

### Response
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ClassBulkReplicateConfirmation_OutResponse>
      <Return>
        <Type>S</Type>
        <Code>CLS_100</Code>
        <Message>Confirmation sent successfully / 确认已成功发送</Message>
      </Return>
    </ClassBulkReplicateConfirmation_OutResponse>
  </soap:Body>
</soap:Envelope>
```

---

## Error Codes / 错误代码
| Code | Description (EN) | Description (CN) |
|------|------------------|------------------|
| `CLS_001` | Invalid class ID | 无效的类ID |
| `CLS_002` | Class type not found | 未找到类类型 |
| `CLS_003` | Characteristic assignment failed | 特征分配失败 |
| `CLS_004` | Class hierarchy cycle detected | 检测到类层次循环 |

---

## Notes / 备注
- This is an asynchronous outbound confirmation service / 这是一个异步出站确认服务
- The confirmation is sent after a class replication request has been processed / 在类复制请求处理完成后发送确认
- Class types: 001=Material Class, 002=Batch Class, 003=Equipment Class / 类类型：001=物料类，002=批次类，003=设备类
- Use AIF transaction `/AIF/IFMON` for message monitoring / 使用AIF事务`/AIF/IFMON`进行消息监控