---
# API: Service Order (Bulk) - Confirm
# File: CO_CRMS4_SERVICE_ORDER_BULK_CO.md
# Version: 1.4.0
# Status: ACTIVE
# Protocol: SOAP (Outbound)
# Source URL: https://api.sap.com/api/CO_CRMS4_SERVICE_ORDER_BULK_CO/overview
# Generated: 2026-07-23 14:17:02
---

# Service Order (Bulk) - Confirm / 服务订单(批量) - 确认 API

> **API 版本:** 1.4.0 | **状态:** ACTIVE | **协议:** SOAP  
> **技术名称:** `CO_CRMS4_SERVICE_ORDER_BULK_CO`  
> **WSDL 绑定:** `/sap/bc/srt/wsdl/flv_10002A111AD1/bndr_url/sap/bc/srt/rfc/sap/co_crms4_service_order_bulk_co/100/co_crms4_service_order_bulk_co/binding`  
> **SAP 通信场景:** `SAP_COM_0111`

## 概述 / Overview

该 SOAP 出站服务用于批量确认服务订单。支持将服务订单的完成状态、工时、物料消耗等信息批量发送到外部系统。

This SOAP outbound service confirms service orders in bulk. It supports batch transmission of service order completion status, labor hours, and material consumption information to external systems.

**API 业务加速器中心:** [https://api.sap.com/api/CO_CRMS4_SERVICE_ORDER_BULK_CO/overview](https://api.sap.com/api/CO_CRMS4_SERVICE_ORDER_BULK_CO/overview)

---

## 消息结构 / Message Structure

| # | 结构名称 | 描述 (EN) | 描述 (CN) |
|---|----------|-----------|-----------|
| 1 | `ServiceOrderBulkConfirmRequest` | Service Order Bulk Confirm Request | 服务订单批量确认请求 |
| 2 | `ServiceOrderBulkConfirmResponse` | Service Order Bulk Confirm Response | 服务订单批量确认响应 |

---

## 1. 请求结构: ServiceOrderBulkConfirmRequest / 服务订单批量确认请求

**命名空间:** `urn:sap-com:document:sap:soap:functions:mc-style`

| # | 字段名称 | 类型 | 描述 (EN) | 描述 (CN) | 必填 |
|---|----------|------|-----------|-----------|------|
| 1 | `ServiceOrderID` | CHAR(12) | Service Order ID | 服务订单编号 | 是 |
| 2 | `ConfirmationDate` | DATE | Confirmation Date | 确认日期 | 是 |
| 3 | `ConfirmationTime` | TIME | Confirmation Time | 确认时间 | 是 |
| 4 | `CompletionStatus` | CHAR(1) | Completion Status (C-complete/P-partial) | 完成状态 (C-完成/P-部分) | 是 |
| 5 | `ActualWorkDuration` | QUANTITY(6,2) | Actual Work Duration (hours) | 实际工时(小时) | 否 |
| 6 | `ActualWorkUnit` | UNIT(3) | Unit of Work Duration | 工时单位 | 否 |
| 7 | `MaterialConsumption` | TABLE | Material Consumption Table | 物料消耗表 | 否 |
| 8 | `ConfirmationText` | CHAR(40) | Confirmation Text | 确认文本 | 否 |
| 9 | `ConfirmedByUser` | CHAR(12) | Confirmed By | 确认者 | 是 |
| 10 | `ServiceTeam` | CHAR(20) | Service Team | 服务团队 | 否 |
| 11 | `CustomerSatisfaction` | CHAR(1) | Customer Satisfaction (1-5) | 客户满意度 (1-5) | 否 |
| 12 | `FollowUpRequired` | CHAR(1) | Follow-Up Required (X-yes/blank-no) | 需要跟进 (X-是/空-否) | 否 |

### 子结构: MaterialConsumptionItem / 物料消耗行项目

| # | 字段名称 | 类型 | 描述 (EN) | 描述 (CN) | 必填 |
|---|----------|------|-----------|-----------|------|
| 1 | `MaterialID` | CHAR(18) | Material Number | 物料编号 | 是 |
| 2 | `Quantity` | QUANTITY(13,3) | Quantity | 数量 | 是 |
| 3 | `Unit` | UNIT(3) | Unit of Measure | 计量单位 | 是 |
| 4 | `Batch` | CHAR(10) | Batch Number | 批次号 | 否 |
| 5 | `StorageLocation` | CHAR(4) | Storage Location | 存储地点 | 否 |

---

## 2. 响应结构: ServiceOrderBulkConfirmResponse / 服务订单批量确认响应

**命名空间:** `urn:sap-com:document:sap:soap:functions:mc-style`

| # | 字段名称 | 类型 | 描述 (EN) | 描述 (CN) | 必填 |
|---|----------|------|-----------|-----------|------|
| 1 | `ServiceOrderID` | CHAR(12) | Service Order ID | 服务订单编号 | 是 |
| 2 | `Status` | CHAR(1) | Status (S-success/E-error) | 状态 (S-成功/E-错误) | 是 |
| 3 | `Message` | CHAR(200) | Message | 消息 | 否 |

---

## SOAP XML 示例 / SOAP XML Example

### 请求 / Request

```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:urn="urn:sap-com:document:sap:soap:functions:mc-style">
  <soap:Header/>
  <soap:Body>
    <urn:ServiceOrderBulkConfirmRequest>
      <ServiceOrderID>SO-100001</ServiceOrderID>
      <ConfirmationDate>2026-07-23</ConfirmationDate>
      <ConfirmationTime>14:00:00</ConfirmationTime>
      <CompletionStatus>C</CompletionStatus>
      <ActualWorkDuration>8.50</ActualWorkDuration>
      <ActualWorkUnit>H</ActualWorkUnit>
      <MaterialConsumption>
        <item>
          <MaterialID>MAT-10001</MaterialID>
          <Quantity>2.000</Quantity>
          <Unit>EA</Unit>
          <Batch>B-001</Batch>
          <StorageLocation>SL01</StorageLocation>
        </item>
      </MaterialConsumption>
      <ConfirmationText>Service completed successfully</ConfirmationText>
      <ConfirmedByUser>API_USER</ConfirmedByUser>
      <ServiceTeam>TEAM-A</ServiceTeam>
      <CustomerSatisfaction>5</CustomerSatisfaction>
      <FollowUpRequired></FollowUpRequired>
    </urn:ServiceOrderBulkConfirmRequest>
  </soap:Body>
</soap:Envelope>
```

### 响应 / Response

```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:urn="urn:sap-com:document:sap:soap:functions:mc-style">
  <soap:Header/>
  <soap:Body>
    <urn:ServiceOrderBulkConfirmResponse>
      <ServiceOrderID>SO-100001</ServiceOrderID>
      <Status>S</Status>
      <Message>Bulk confirmation processed successfully</Message>
    </urn:ServiceOrderBulkConfirmResponse>
  </soap:Body>
</soap:Envelope>
```

---

## 变更记录 / Change Log

| 版本 | 日期 | 描述 |
|------|------|------|
| 1.4.0 | 2026-07-23 | 初始版本 / Initial version |