# CO_MDG_BP_RELATIONSHIP_CNF_OUT

**SOAP v1.0.0 — ACTIVE**

## Title / 标题
**BP Relationship - Send Confirmation from SAP S/4HANA Cloud to Client / 业务伙伴关系 - 从 SAP S/4HANA Cloud 向客户端发送确认**

## Operation / 操作
`BPRelationshipReplicationConfirmationOut`

---

## Description / 描述
Sends Business Partner relationship data replication status from SAP S/4HANA Cloud to an external client system using this asynchronous outbound service.

使用此异步出站服务，将业务伙伴关系数据复制状态从 SAP S/4HANA Cloud 发送到外部客户端系统。

---

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

## Message Structure / 消息结构

### Request / 请求
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `RelationshipConfirmation` | Table | BP relationship replication confirmations | 业务伙伴关系复制确认 |
| `?RelationshipUUID` | `RAW(16)` | Relationship GUID | 关系全局唯一标识 |
| `?SourceBP` | `CHAR(10)` | Source business partner | 源业务伙伴 |
| `?TargetBP` | `CHAR(10)` | Target business partner | 目标业务伙伴 |
| `?RelationshipCategory` | `CHAR(6)` | Relationship category code | 关系类别代码 |
| `?Status` | `CHAR(1)` | Replication status (S/E) | 复制状态（成功/错误） |
| `?StatusMessage` | `CHAR(220)` | Detailed status message | 详细状态消息 |
| `?ProcessedAt` | `TIMESTAMP` | Processing timestamp | 处理时间戳 |

### Response / 响应
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `Return` | `BAPIRETURN` | Acknowledgement of receipt | 接收确认 |
| `?Type` | `CHAR(1)` | Message type (S/E/W/I) | 消息类型（成功/错误/警告/信息） |
| `?Message` | `CHAR(220)` | Acknowledgement message | 确认消息文本 |

---

## Example Payload / 示例负载

### Request
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <BPRelationshipReplicationConfirmationOut>
      <RelationshipConfirmation>
        <item>
          <RelationshipUUID>001E6A3B7C8D4F5E9A0B1C2D3E4F5A6B</RelationshipUUID>
          <SourceBP>BP001</SourceBP>
          <TargetBP>BP002</TargetBP>
          <RelationshipCategory>BUR001</RelationshipCategory>
          <Status>S</Status>
          <StatusMessage>Relationship replicated successfully / 关系复制成功</StatusMessage>
          <ProcessedAt>2026-07-23T14:30:00+08:00</ProcessedAt>
        </item>
        <item>
          <RelationshipUUID>002E6A3B7C8D4F5E9A0B1C2D3E4F5A6C</RelationshipUUID>
          <SourceBP>BP003</SourceBP>
          <TargetBP>BP004</TargetBP>
          <RelationshipCategory>BUR002</RelationshipCategory>
          <Status>E</Status>
          <StatusMessage>Target BP not found / 未找到目标业务伙伴</StatusMessage>
          <ProcessedAt>2026-07-23T14:30:01+08:00</ProcessedAt>
        </item>
      </RelationshipConfirmation>
    </BPRelationshipReplicationConfirmationOut>
  </soap:Body>
</soap:Envelope>
```

### Response
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <BPRelationshipReplicationConfirmationOutResponse>
      <Return>
        <Type>S</Type>
        <Message>Confirmation received / 确认已接收</Message>
      </Return>
    </BPRelationshipReplicationConfirmationOutResponse>
  </soap:Body>
</soap:Envelope>
```

---

## Error Codes / 错误代码
| Code | Description (EN) | Description (CN) |
|------|------------------|------------------|
| `BRC_001` | Invalid relationship UUID | 无效的关系UUID |
| `BRC_002` | Source BP does not exist | 源业务伙伴不存在 |
| `BRC_003` | Target BP does not exist | 目标业务伙伴不存在 |
| `BRC_004` | Relationship category invalid | 关系类别无效 |
| `BRC_005` | Replication system unreachable | 复制系统不可达 |

---

## Notes / 备注
- This is an asynchronous outbound confirmation service / 这是一个异步出站确认服务
- Confirmations are sent after replication processing / 确认消息在复制处理后发送
- Failed items (Status=E) should be investigated and re-triggered / 失败项（Status=E）应调查并重新触发
- Max 1000 confirmation items per message / 每条消息最多 1000 条确认项