# CO_MMPUR_PURREQN_REP_NOTIF_OUT

**SOAP v1.0.0 — ACTIVE**

## Title / 标题
**Purchase Requisition – Send Replication Notification / 采购申请 - 发送复制通知**

## Operation / 操作
`PurchaseRequisitionReplicationNotificationOut`

---

## Description / 描述
Send notifications from an SAP S/4HANA hub system to an external system using this outbound service.

使用此出站服务从 SAP S/4HANA 中心系统向外部系统发送通知。

---

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

## Message Structure / 消息结构

### Request / 请求
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `PurchaseRequisitionNotification` | `PURREQN_NOTIF` | Purchase requisition notification header | 采购申请通知抬头 |
| `?PurchaseRequisition` | `CHAR(10)` | Purchase requisition number | 采购申请编号 |
| `?ItemNumber` | `CHAR(5)` | Item number | 行项目号 |
| `?Material` | `CHAR(40)` | Material number | 物料编号 |
| `?MaterialGroup` | `CHAR(9)` | Material group | 物料组 |
| `?Plant` | `CHAR(4)` | Plant | 工厂 |
| `?Quantity` | `DECIMAL` | Requisition quantity | 申请数量 |
| `?QuantityUnit` | `CHAR(3)` | Unit of measure | 计量单位 |
| `?DeliveryDate` | `DATE` | Delivery date | 交货日期 |
| `?PurchasingGroup` | `CHAR(3)` | Purchasing group | 采购组 |
| `?ProcurementType` | `CHAR(1)` | Procurement type (F=external, E=internal) | 采购类型（F=外部，E=内部） |
| `?SourceDetermination` | `CHAR(1)` | Source determination status | 源确定状态 |
| `?OverallStatus` | `CHAR(1)` | Overall processing status | 总体处理状态 |
| `?TrackingID` | `CHAR(35)` | Tracking ID for replication | 复制跟踪标识 |
| `ItemDetails` | Table | Additional item details | 附加项目详细信息 |
| `?RequestedQuantity` | `DECIMAL` | Requested quantity | 请求数量 |
| `?UnitPrice` | `DECIMAL` | Unit price | 单价 |

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

---

## Example Payload / 示例负载

### Request
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <PurchaseRequisitionReplicationNotificationOut>
      <PurchaseRequisitionNotification>
        <PurchaseRequisition>10000123</PurchaseRequisition>
        <ItemNumber>00010</ItemNumber>
        <Material>M-20001</Material>
        <MaterialGroup>005</MaterialGroup>
        <Plant>1000</Plant>
        <Quantity>500.000</Quantity>
        <QuantityUnit>KG</QuantityUnit>
        <DeliveryDate>2026-09-15</DeliveryDate>
        <PurchasingGroup>001</PurchasingGroup>
        <ProcurementType>F</ProcurementType>
        <SourceDetermination>1</SourceDetermination>
        <OverallStatus>3</OverallStatus>
        <TrackingID>PR-REP-20260723-001</TrackingID>
      </PurchaseRequisitionNotification>
      <ItemDetails>
        <item>
          <RequestedQuantity>500.000</RequestedQuantity>
          <UnitPrice>12.50</UnitPrice>
        </item>
      </ItemDetails>
    </PurchaseRequisitionReplicationNotificationOut>
  </soap:Body>
</soap:Envelope>
```

### Response
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <PurchaseRequisitionReplicationNotificationOutResponse>
      <Return>
        <Type>S</Type>
        <Message>Replication notification sent / 复制通知已发送</Message>
      </Return>
    </PurchaseRequisitionReplicationNotificationOutResponse>
  </soap:Body>
</soap:Envelope>
```

---

## Error Codes / 错误代码
| Code | Description (EN) | Description (CN) |
|------|------------------|------------------|
| `PRQ_001` | Purchase requisition not found | 采购申请未找到 |
| `PRQ_002` | Invalid item number | 无效的项目编号 |
| `PRQ_003` | Missing material or material group | 缺少物料或物料组 |
| `PRQ_004` | Replication tracking ID missing | 缺少复制跟踪标识 |

---

## Notes / 备注
- Procurement type: F=external procurement, E=internal procurement / 采购类型：F=外部采购，E=内部采购
- Source determination: 1=source assigned, 2=source not assigned / 源确定：1=已分配源，2=未分配源
- Overall status: 1=new, 2=in process, 3=completed, 4=rejected / 总体状态：1=新建，2=处理中，3=已完成，4=已拒绝
- This service notifies external systems about purchase requisition creation or changes / 该服务将采购申请的创建或更改通知外部系统