# CO_FKK_COMMSNDOUTSTGCOLUPDRQ

**SOAP v1.0.0 — ACTIVE**

## Title / 标题
**Collection Agency - Submit Bulk Request / 收账机构 - 提交批量请求**

## Operation / 操作
`CollectionAgencyBulkSubmitRequest`

---

## Description / 描述
This asynchronous outbound service transfers collection-relevant data from Contract Accounting (FI-CA) to an external collection agency. It submits bulk requests for collection processing including outstanding items, business partner details, and account information.

该异步出站服务将收账相关数据从合同账户（FI-CA）传输到外部收账机构，提交批量请求用于催收处理，包括未清项目、业务伙伴详细信息和账户信息。

**通信场景:** `SAP_COM_0276`

---

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

---

## Message Structure / 消息结构

### Request (CollectionAgencyBulkSubmitRequest) / 请求
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `CollectionAgencyBulkSubmitRequest` | - | Root element for bulk collection request | 批量催收请求根元素 |
| `?CollectionAgencyID` | `CHAR(10)` | Collection agency identifier | 收账机构标识符 |
| `?BusinessPartner` | `CHAR(10)` | Business partner number | 业务伙伴编号 |
| `?ContractAccount` | `CHAR(12)` | Contract account number | 合同账户编号 |
| `?SubmitDate` | `DATE` | Submission date | 提交日期 |
| `?CollectionCurrency` | `CUKY(5)` | Collection currency | 催收货币 |
| `CollectionItems` | Table | Items submitted for collection | 催收提交项目 |
| `?ItemNumber` | `CHAR(6)` | Collection item number | 催收项目编号 |
| `?OpenAmount` | `DECIMAL` | Open amount for collection | 未清催收金额 |
| `?Currency` | `CUKY(5)` | Item currency | 项目货币 |
| `?DueDate` | `DATE` | Due date of the item | 项目到期日 |
| `?DocumentNumber` | `CHAR(12)` | Original document number | 原始凭证编号 |
| `?DocumentType` | `CHAR(2)` | Document type | 凭证类型 |
| `?PostingDate` | `DATE` | Original posting date | 原始过账日期 |
| `?Customer` | `CHAR(10)` | Customer number | 客户编号 |
| `?CustomerName` | `CHAR(40)` | Customer name | 客户名称 |
| `?AddressCity` | `CHAR(40)` | Customer city | 客户城市 |
| `?AddressRegion` | `CHAR(3)` | Customer region | 客户地区 |
| `?AddressCountry` | `CHAR(3)` | Customer country | 客户国家 |
| `?PostalCode` | `CHAR(10)` | Postal code | 邮政编码 |
| `?PhoneNumber` | `CHAR(30)` | Contact phone number | 联系电话 |
| `?EmailAddress` | `CHAR(241)` | Contact email | 联系邮箱 |
| `?DaysOverdue` | `INT4` | Days past due | 逾期天数 |
| `?CollectionLevel` | `CHAR(2)` | Collection level | 催收级别 |
| `?AssignmentType` | `CHAR(2)` | Collection assignment type | 催收分配类型 |

### Response (CollectionAgencyBulkConfirmation) / 响应
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `CollectionAgencyBulkConfirmation` | - | Confirmation of bulk request receipt | 批量请求接收确认 |
| `?ReturnCode` | `CHAR(1)` | Return code (S=Success, E=Error) | 返回码（S=成功，E=错误） |
| `?ReturnMessage` | `CHAR(220)` | Return message text | 返回消息文本 |
| `?ItemsSubmitted` | `INT4` | Number of items submitted | 已提交项目数量 |
| `?ErrorsFound` | `INT4` | Number of errors found | 发现错误数量 |
| `?AgencyReference` | `CHAR(30)` | Collection agency reference number | 收账机构参考号 |

---

## Example Payload / 示例负载

### Request
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <CollectionAgencyBulkSubmitRequest>
      <CollectionAgencyID>AGENCY01</CollectionAgencyID>
      <BusinessPartner>0000123456</BusinessPartner>
      <ContractAccount>3000000001</ContractAccount>
      <SubmitDate>2026-07-24</SubmitDate>
      <CollectionCurrency>CNY</CollectionCurrency>
      <CollectionItems>
        <item>
          <ItemNumber>000001</ItemNumber>
          <OpenAmount>25000.00</OpenAmount>
          <Currency>CNY</Currency>
          <DueDate>2026-04-30</DueDate>
          <DocumentNumber>1900000050</DocumentNumber>
          <PostingDate>2026-03-15</PostingDate>
          <Customer>1000001</Customer>
          <CustomerName>ABC Trading Co.</CustomerName>
          <AddressCity>Shanghai</AddressCity>
          <AddressRegion>SH</AddressRegion>
          <AddressCountry>CN</AddressCountry>
          <PostalCode>200120</PostalCode>
          <DaysOverdue>85</DaysOverdue>
          <CollectionLevel>02</CollectionLevel>
        </item>
        <item>
          <ItemNumber>000002</ItemNumber>
          <OpenAmount>15000.00</OpenAmount>
          <Currency>CNY</Currency>
          <DueDate>2026-05-15</DueDate>
          <DocumentNumber>1900000051</DocumentNumber>
          <PostingDate>2026-04-01</PostingDate>
          <Customer>1000002</Customer>
          <CustomerName>XYZ Manufacturing Ltd.</CustomerName>
          <AddressCity>Beijing</AddressCity>
          <AddressRegion>BJ</AddressRegion>
          <AddressCountry>CN</AddressCountry>
          <PostalCode>100010</PostalCode>
          <DaysOverdue>70</DaysOverdue>
          <CollectionLevel>01</CollectionLevel>
        </item>
      </CollectionItems>
    </CollectionAgencyBulkSubmitRequest>
  </soap:Body>
</soap:Envelope>
```

### Response
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <CollectionAgencyBulkConfirmation>
      <ReturnCode>S</ReturnCode>
      <ReturnMessage>Bulk request accepted by collection agency / 批量请求已被收账机构接收</ReturnMessage>
      <ItemsSubmitted>2</ItemsSubmitted>
      <ErrorsFound>0</ErrorsFound>
      <AgencyReference>AG-REF-20260724-001</AgencyReference>
    </CollectionAgencyBulkConfirmation>
  </soap:Body>
</soap:Envelope>
```

---

## Error Codes / 错误代码
| Code | Description (EN) | Description (CN) |
|------|------------------|------------------|
| `COL_001` | Invalid collection agency | 无效的收账机构 |
| `COL_002` | Business partner not found in FI-CA | 在FI-CA中未找到业务伙伴 |
| `COL_003` | Contract account not found | 合同账户不存在 |
| `COL_004` | Open amount must be positive | 未清金额必须为正数 |
| `COL_005` | Invalid currency code | 无效的货币代码 |
| `COL_006` | Duplicate item number in request | 请求中存在重复的项目编号 |
| `COL_007` | Collection agency communication error | 收账机构通信错误 |
| `COL_008` | Exceeds maximum items per batch (1000) | 超过每批最大项目数(1000) |

---

## Notes / 备注
- 此服务为异步出站服务，由FI-CA触发发送至外部收账机构 / This is an asynchronous outbound service triggered by FI-CA to send to an external collection agency
- 每批最多可包含1000个催收项目 / Maximum 1000 collection items per batch
- 催收级别表示催收的严重程度（01=普通，02=加急，03=法律） / Collection level indicates severity (01=Normal, 02=Urgent, 03=Legal)
- 逾期天数字段用于收账机构优先级排序 / Days overdue field used for collection agency prioritization

---