# CO_FKK_CA_FACTOROFFERBULK_OUT

**SOAP v1.0.0 — ACTIVE**

## Title / 标题
**Factoring - Offer Data / 保理 - 出价数据**

## Operation / 操作
`FactoringOfferBulkNotification`

---

## Description / 描述
This asynchronous outbound service transfers factoring offer data from Contract Accounting (FI-CA) to an external factoring system. It provides bulk offer creation information including receivable details, business partner information, and factoring conditions.

该异步出站服务将保理出价数据从合同账户（FI-CA）传输到外部保理系统，提供批量出价创建信息，包括应收款详细信息、业务伙伴信息和保理条件。

**通信场景:** `SAP_COM_0277`

---

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

---

## Message Structure / 消息结构

### Request (FactoringOfferBulkNotification) / 请求
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `FactoringOfferBulkNotification` | - | Root element for factoring offer bulk | 保理批量出价根元素 |
| `?FactoringCompany` | `CHAR(8)` | Factoring company ID | 保理公司ID |
| `?BusinessPartner` | `CHAR(10)` | Business partner number | 业务伙伴编号 |
| `?ContractAccount` | `CHAR(12)` | Contract account number | 合同账户编号 |
| `?OfferDate` | `DATE` | Offer creation date | 出价创建日期 |
| `?OfferCurrency` | `CUKY(5)` | Offer currency | 出价货币 |
| `FactoringOfferItems` | Table | Factoring offer items table | 保理出价项目表 |
| `?FactoringItem` | `CHAR(6)` | Factoring item number | 保理项目编号 |
| `?ReceivableAmount` | `DECIMAL` | Receivable amount to factor | 保理应收金额 |
| `?ReceivableCurrency` | `CUKY(5)` | Receivable currency | 应收货币 |
| `?DueDate` | `DATE` | Due date of receivable | 应收到期日 |
| `?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 | 客户名称 |
| `?CustomerRegion` | `CHAR(3)` | Customer region | 客户地区 |
| `?OfferStatus` | `CHAR(2)` | Offer status (01=New, 02=Cancelled) | 出价状态（01=新，02=已取消） |
| `?CommissionRate` | `DECIMAL` | Factor commission rate | 保理手续费率 |
| `?ImmediatePaymentRate` | `DECIMAL` | Immediate payment percentage | 立即支付率 |

### Response (FactoringOfferBulkConfirmation) / 响应
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `FactoringOfferBulkConfirmation` | - | Confirmation of bulk offer receipt | 批量出价接收确认 |
| `?ReturnCode` | `CHAR(1)` | Return code (S=Success, E=Error) | 返回码（S=成功，E=错误） |
| `?ReturnMessage` | `CHAR(220)` | Return message text | 返回消息文本 |
| `?OffersProcessed` | `INT4` | Number of offers processed | 已处理出价数量 |
| `?ErrorsDetected` | `INT4` | Number of errors | 错误数量 |

---

## Example Payload / 示例负载

### Request
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <FactoringOfferBulkNotification>
      <FactoringCompany>FACTOR01</FactoringCompany>
      <BusinessPartner>0000123456</BusinessPartner>
      <ContractAccount>3000000001</ContractAccount>
      <OfferDate>2026-07-24</OfferDate>
      <OfferCurrency>CNY</OfferCurrency>
      <FactoringOfferItems>
        <item>
          <FactoringItem>000001</FactoringItem>
          <ReceivableAmount>50000.00</ReceivableAmount>
          <ReceivableCurrency>CNY</ReceivableCurrency>
          <DueDate>2026-09-30</DueDate>
          <DocumentNumber>1900000001</DocumentNumber>
          <DocumentType>RV</DocumentType>
          <PostingDate>2026-06-30</PostingDate>
          <Customer>1000001</Customer>
          <CustomerName>ABC Trading Co.</CustomerName>
          <OfferStatus>01</OfferStatus>
        </item>
        <item>
          <FactoringItem>000002</FactoringItem>
          <ReceivableAmount>75000.00</ReceivableAmount>
          <ReceivableCurrency>CNY</ReceivableCurrency>
          <DueDate>2026-10-15</DueDate>
          <DocumentNumber>1900000002</DocumentNumber>
          <DocumentType>RV</DocumentType>
          <PostingDate>2026-07-15</PostingDate>
          <Customer>1000002</Customer>
          <CustomerName>XYZ Manufacturing Ltd.</CustomerName>
          <OfferStatus>01</OfferStatus>
        </item>
      </FactoringOfferItems>
    </FactoringOfferBulkNotification>
  </soap:Body>
</soap:Envelope>
```

### Response
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <FactoringOfferBulkConfirmation>
      <ReturnCode>S</ReturnCode>
      <ReturnMessage>Bulk offer processed successfully / 批量出价已成功处理</ReturnMessage>
      <OffersProcessed>2</OffersProcessed>
      <ErrorsDetected>0</ErrorsDetected>
    </FactoringOfferBulkConfirmation>
  </soap:Body>
</soap:Envelope>
```

---

## Error Codes / 错误代码
| Code | Description (EN) | Description (CN) |
|------|------------------|------------------|
| `FAC_001` | Invalid factoring company | 无效的保理公司 |
| `FAC_002` | Business partner not found | 业务伙伴不存在 |
| `FAC_003` | Contract account not found | 合同账户不存在 |
| `FAC_004` | Duplicate offer item number | 重复的出价项目编号 |
| `FAC_005` | Invalid currency code | 无效的货币代码 |
| `FAC_006` | Receivable amount must be positive | 应收金额必须为正数 |
| `FAC_007` | Factoring company communication error | 保理公司通信错误 |

---

## Notes / 备注
- 此服务为异步出站服务，由FI-CA触发发送至外部保理系统 / This is an asynchronous outbound service triggered by FI-CA to send to an external factoring system
- 每个请求可包含多个出价项目，最大500条 / Each request can contain multiple offer items, max 500
- 出价状态"01"表示新出价，"02"表示取消 / Offer status "01" = New offer, "02" = Cancelled
- 保理公司将根据出价数据返回确认消息 / The factoring company returns a confirmation based on the offer data

---