# CO_MMPUR_RFQ_S4_REQUEST_OUT

**SOAP v1.0.0 — ACTIVE**

## Title / 标题
**Request for Quotation - Send (Outbound, Asynchronous) / 询价单 - 发送（出站，异步）**

## Operation / 操作
`RequestForQuotation_S4RequestOut`

---

## Description / 描述
This outbound asynchronous service enables you to send requests for quotations from your SAP S/4HANA Cloud system to an external sourcing system via web service request.

此出站异步服务使您能够通过网络服务请求将询价单从SAP S/4HANA Cloud系统发送到外部寻源系统。

---

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

## Message Structure / 消息结构

### Request / 请求
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `RFQRequest` | `MMPUR_RFQ_S4` | RFQ request root node | 询价请求根节点 |
| `?RFQNumber` | `CHAR(10)` | Request for Quotation number | 询价单号 |
| `?DocumentType` | `CHAR(4)` | RFQ document type | 询价单类型 |
| `?PurchasingOrganization` | `CHAR(4)` | Purchasing organization | 采购组织 |
| `?PurchasingGroup` | `CHAR(3)` | Purchasing group | 采购组 |
| `?CreatedDate` | `DATE` | RFQ creation date | 询价单创建日期 |
| `?QuotationDeadline` | `DATE` | Quotation submission deadline | 报价提交截止日期 |
| `?CompanyCode` | `CHAR(4)` | Company code | 公司代码 |
| `?Language` | `LANG(2)` | Language key | 语言代码 |
| `Items` | Table | RFQ item details | 询价项目明细 |
| `?ItemNumber` | `NUMC(5)` | Item number | 项目编号 |
| `?Material` | `CHAR(40)` | Material number | 物料号 |
| `?MaterialGroup` | `CHAR(9)` | Material group | 物料组 |
| `?Quantity` | `QUAN(13)` | Requested quantity | 需求数量 |
| `?Unit` | `UNIT(3)` | Unit of measure | 计量单位 |
| `?DeliveryDate` | `DATE` | Requested delivery date | 需求交货日期 |
| `?Plant` | `CHAR(4)` | Plant | 工厂 |
| `?StorageLocation` | `CHAR(4)` | Storage location | 存储地点 |
| `Bidders` | Table | Supplier (bidder) list | 供应商（投标方）列表 |
| `?Supplier` | `CHAR(10)` | Supplier account | 供应商账户 |
| `?Incoterms` | `CHAR(3)` | Incoterms | 国际贸易条款 |
| `?PaymentTerms` | `CHAR(4)` | Payment terms | 付款条件 |

### 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>
    <RequestForQuotation_S4RequestOut>
      <RFQRequest>
        <RFQNumber>4500000001</RFQNumber>
        <DocumentType>ANF</DocumentType>
        <PurchasingOrganization>1000</PurchasingOrganization>
        <PurchasingGroup>001</PurchasingGroup>
        <CreatedDate>2026-07-23</CreatedDate>
        <QuotationDeadline>2026-08-15</QuotationDeadline>
        <CompanyCode>1000</CompanyCode>
        <Language>ZH</Language>
      </RFQRequest>
      <Items>
        <item>
          <ItemNumber>00010</ItemNumber>
          <Material>M-10001</Material>
          <MaterialGroup>0101</MaterialGroup>
          <Quantity>500.000</Quantity>
          <Unit>PC</Unit>
          <DeliveryDate>2026-09-01</DeliveryDate>
          <Plant>1000</Plant>
          <StorageLocation>0001</StorageLocation>
        </item>
      </Items>
      <Bidders>
        <item>
          <Supplier>0010001000</Supplier>
          <Incoterms>CIF</Incoterms>
          <PaymentTerms>0001</PaymentTerms>
        </item>
        <item>
          <Supplier>0010002000</Supplier>
          <Incoterms>CIF</Incoterms>
          <PaymentTerms>0001</PaymentTerms>
        </item>
      </Bidders>
    </RequestForQuotation_S4RequestOut>
  </soap:Body>
</soap:Envelope>
```

### Response
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <RequestForQuotation_S4RequestOutResponse>
      <Return>
        <Type>S</Type>
        <Code>RFQ_100</Code>
        <Message>RFQ sent successfully / 询价单已成功发送</Message>
      </Return>
    </RequestForQuotation_S4RequestOutResponse>
  </soap:Body>
</soap:Envelope>
```

---

## Error Codes / 错误代码
| Code | Description (EN) | Description (CN) |
|------|------------------|------------------|
| `RFQ_001` | RFQ number is missing | 缺少询价单号 |
| `RFQ_002` | No bidders defined | 未定义投标方 |
| `RFQ_003` | Invalid purchasing organization | 无效的采购组织 |
| `RFQ_004` | External system communication error | 外部系统通信错误 |

---

## Notes / 备注
- This is an asynchronous outbound service / 这是一个异步出站服务
- RFQ must be in status "Published" before sending / 发送前询价单必须处于"已发布"状态
- Use AIF transaction `/AIF/IFMON` for message monitoring / 使用AIF事务`/AIF/IFMON`进行消息监控
- Maximum 999 items per RFQ / 每个询价单最多999个项目