# CO_FKC_CA_DISCO_PRPSL_BULK_OUT

**SOAP v1.0.0 —ACTIVE**

## Title / 标题
**Disconnection Requests - Bulk Send / 断连请求 - 批量发?*

## Operation / 操作
`DisconnectionRequestsBulkSend`

---

## Description / 描述
This service sends bulk disconnection requests for utility contracts, enabling mass processing of service termination proposals.

该服务批量发送公用事业合同的断连请求，支持大规模处理服务终止建议?
---

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

## Message Structure / 消息结构

### Request / 请求
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `BatchHeader` | `BATCH_HEAD` | Batch processing header | 批量处理抬头 |
| `?BatchID` | `CHAR(20)` | Unique batch identifier | 唯一批处理标?|
| `?CreatedBy` | `CHAR(12)` | User who created the batch | 批次创建?|
| `?CreatedOn` | `DATE` | Batch creation date | 批次创建日期 |
| `DisconnectionRequests` | Table | List of disconnection requests | 断连请求列表 |
| `?ContractID` | `CHAR(20)` | Utility contract ID | 公用事业合同ID |
| `?AccountNo` | `CHAR(18)` | Customer account number | 客户账户号码 |
| `?RequestDate` | `DATE` | Requested disconnection date | 请求断连日期 |
| `?ReasonCode` | `CHAR(3)` | Disconnection reason code | 断连原因代码 |
| `?ReasonText` | `CHAR(40)` | Reason description | 原因描述 |
| `?PremiseID` | `CHAR(10)` | Premise identifier | 场所标识 |

### Response / 响应
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `BatchStatus` | `CHAR(1)` | Overall batch status (S=success, E=error) | 总体批次状态（S=成功，E=错误?|
| `ProcessedCount` | `INT` | Number of successfully processed requests | 成功处理的请求数 |
| `FailedCount` | `INT` | Number of failed requests | 失败的请求数 |
| `Results` | Table | Per-request results | 逐请求结?|
| `?ContractID` | `CHAR(20)` | Utility contract ID | 公用事业合同ID |
| `?Status` | `CHAR(1)` | Individual status (S/E) | 单独状态（S/E?|
| `?Message` | `CHAR(220)` | Status message | 状态消?|

---

## Example Payload / 示例负载

### Request
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <DisconnectionRequestsBulkSend>
      <BatchHeader>
        <BatchID>BATCH-20260723-001</BatchID>
        <CreatedBy>USER001</CreatedBy>
        <CreatedOn>2026-07-23</CreatedOn>
      </BatchHeader>
      <DisconnectionRequests>
        <item>
          <ContractID>CON-1005001</ContractID>
          <AccountNo>ACC-5001001</AccountNo>
          <RequestDate>2026-08-01</RequestDate>
          <ReasonCode>NON</ReasonCode>
          <ReasonText>Non-payment / 未付?/ReasonText>
          <PremiseID>PREM-001</PremiseID>
        </item>
        <item>
          <ContractID>CON-1005002</ContractID>
          <AccountNo>ACC-5001002</AccountNo>
          <RequestDate>2026-08-05</RequestDate>
          <ReasonCode>REQ</ReasonCode>
          <ReasonText>Customer request / 客户请求</ReasonText>
          <PremiseID>PREM-002</PremiseID>
        </item>
      </DisconnectionRequests>
    </DisconnectionRequestsBulkSend>
  </soap:Body>
</soap:Envelope>
```

### Response
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <DisconnectionRequestsBulkSendResponse>
      <BatchStatus>S</BatchStatus>
      <ProcessedCount>2</ProcessedCount>
      <FailedCount>0</FailedCount>
      <Results>
        <item>
          <ContractID>CON-1005001</ContractID>
          <Status>S</Status>
          <Message>Disconnection scheduled / 断连已计?/Message>
        </item>
        <item>
          <ContractID>CON-1005002</ContractID>
          <Status>S</Status>
          <Message>Disconnection scheduled / 断连已计?/Message>
        </item>
      </Results>
    </DisconnectionRequestsBulkSendResponse>
  </soap:Body>
</soap:Envelope>
```

---

## Error Codes / 错误代码
| Code | Description (EN) | Description (CN) |
|------|------------------|------------------|
| `DIS_001` | Contract not found | 合同未找?|
| `DIS_002` | Invalid reason code | 无效的原因代?|
| `DIS_003` | Contract already disconnected | 合同已断?|
| `DIS_004` | Premise ID mismatch | 场所标识不匹?|
| `DIS_005` | Batch ID already exists | 批次ID已存?|

---

## Notes / 备注
- Maximum 1000 requests per batch / 每批次最?000个请?- Reason codes are configurable in customizing / 原因代码可在定制中配?- Disconnection date must be at least 3 business days in the future / 断连日期必须至少为未?个工作日