# CO_MMPUR_QTNCONFIRMATION_S4REQ

**SOAP v1.0.0 — ACTIVE**

## Title / 标题
**Supplier Quotation - Send Confirmation (Outbound) / 供应商报价 - 发送确认（出站）**

## Operation / 操作
`SupplierQuotationConfirmation_S4Req`

---

## Description / 描述
This outbound asynchronous service sends a success confirmation or error message when a supplier quotation has been received from an external sourcing system.

当从外部寻源系统接收到供应商报价时，此出站异步服务发送成功确认或错误消息。

---

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

## Message Structure / 消息结构

### Request / 请求
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `QuotationConfirmation` | `MMPUR_QTN_CONF` | Quotation confirmation root node | 报价确认根节点 |
| `?RFQNumber` | `CHAR(10)` | Request for Quotation number | 询价单号 |
| `?QuotationNumber` | `CHAR(10)` | Supplier quotation number | 供应商报价单号 |
| `?Supplier` | `CHAR(10)` | Supplier account number | 供应商账户号 |
| `?ConfirmationStatus` | `CHAR(1)` | Status (S=success, E=error) | 状态（S=成功，E=错误） |
| `?MessageText` | `CHAR(220)` | Confirmation or error message | 确认或错误消息 |
| `?PurchasingOrganization` | `CHAR(4)` | Purchasing organization | 采购组织 |
| `?PurchasingGroup` | `CHAR(3)` | Purchasing group | 采购组 |
| `?CompanyCode` | `CHAR(4)` | Company code | 公司代码 |
| `Items` | Table | Quotation item details | 报价项目明细 |
| `?ItemNumber` | `NUMC(5)` | Quotation item number | 报价项目编号 |
| `?Material` | `CHAR(40)` | Material number | 物料号 |
| `?Quantity` | `QUAN(13)` | RFQ quantity | 询价数量 |
| `?Unit` | `UNIT(3)` | Unit of measure | 计量单位 |
| `?NetPrice` | `CURR(11)` | Net price | 净价 |
| `?Currency` | `CUKY(5)` | Currency | 货币码 |

### 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 | 消息文本 |
| `?LogNo` | `CHAR(20)` | Application log number | 应用程序日志号 |

---

## Example Payload / 示例负载

### Request
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <SupplierQuotationConfirmation_S4Req>
      <QuotationConfirmation>
        <RFQNumber>4500000001</RFQNumber>
        <QuotationNumber>100000</QuotationNumber>
        <Supplier>0010001000</Supplier>
        <ConfirmationStatus>S</ConfirmationStatus>
        <MessageText>Quotation received successfully / 报价已成功接收</MessageText>
        <PurchasingOrganization>1000</PurchasingOrganization>
        <PurchasingGroup>001</PurchasingGroup>
        <CompanyCode>1000</CompanyCode>
      </QuotationConfirmation>
      <Items>
        <item>
          <ItemNumber>00010</ItemNumber>
          <Material>M-10001</Material>
          <Quantity>500.000</Quantity>
          <Unit>PC</Unit>
          <NetPrice>12.50</NetPrice>
          <Currency>CNY</Currency>
        </item>
        <item>
          <ItemNumber>00020</ItemNumber>
          <Material>M-10002</Material>
          <Quantity>200.000</Quantity>
          <Unit>KG</Unit>
          <NetPrice>8.00</NetPrice>
          <Currency>CNY</Currency>
        </item>
      </Items>
    </SupplierQuotationConfirmation_S4Req>
  </soap:Body>
</soap:Envelope>
```

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

---

## Error Codes / 错误代码
| Code | Description (EN) | Description (CN) |
|------|------------------|------------------|
| `QTN_001` | RFQ number not found | 未找到询价单号 |
| `QTN_002` | Quotation number already exists | 报价单号已存在 |
| `QTN_003` | Invalid supplier | 无效的供应商 |
| `QTN_004` | Missing mandatory field | 缺少必填字段 |

---

## Notes / 备注
- This is an asynchronous outbound service / 这是一个异步出站服务
- The confirmation is triggered after receiving a supplier quotation via the inbound RFQ confirmation service / 在通过入站RFQ确认服务收到供应商报价后触发确认
- Monitor messages via Application Interface Framework (AIF) / 通过应用程序接口框架（AIF）监控消息