# CO_FAP_POS_POSITIVE_PAY_OUT

**SOAP v1.0.0 —ACTIVE**

## Title / 标题
**Positive Pay File - Send / 正向付款文件 - 发?*

## Operation / 操作
`PositivePayFileSend`

---

## Description / 描述
This service transmits positive pay files to banks, providing issued check details for fraud prevention verification.

该服务向银行发送正向付款文件，提供已签发支票详细信息用于防欺诈验证。
---

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

## Message Structure / 消息结构

### Request / 请求
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `PositivePayFile` | `POS_PAY` | Positive pay file header | 正向付款文件抬头 |
| `?CompanyCode` | `CHAR(4)` | Company code | 公司代码 |
| `?BankAccount` | `CHAR(18)` | Bank account number | 银行账户 |
| `?FileDate` | `DATE` | File creation date | 文件创建日期 |
| `CheckItems` | Table | Check details | 支票明细 |
| `?CheckNumber` | `CHAR(13)` | Check number | 支票号码 |
| `?IssueDate` | `DATE` | Check issue date | 支票签发日期 |
| `?Payee` | `CHAR(35)` | Payee name | 收款方名?|
| `?Amount` | `DECIMAL` | Check amount | 支票金额 |
| `?Currency` | `CUKY(5)` | Currency | 货币 |
| `?Status` | `CHAR(1)` | Status (I=issued, V=voided) | 状态（I=已签发，V=已作废） |

### Response / 响应
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `Return` | `BAPIRETURN` | Application log message | 应用程序日志消息 |
| `?Type` | `CHAR(1)` | Message type (S/E/W/I) | 消息类型（成?错误/警告/信息?|
| `?Message` | `CHAR(220)` | Message text | 消息文本 |
| `FileReference` | `CHAR(32)` | Bank file reference number | 银行文件参考号 |

---

## Example Payload / 示例负载

### Request
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <PositivePayFileSend>
      <PositivePayFile>
        <CompanyCode>1000</CompanyCode>
        <BankAccount>1234567890</BankAccount>
        <FileDate>2026-07-23</FileDate>
      </PositivePayFile>
      <CheckItems>
        <item>
          <CheckNumber>1000001</CheckNumber>
          <IssueDate>2026-07-23</IssueDate>
          <Payee>ABC Supplier Co., Ltd.</Payee>
          <Amount>25000.00</Amount>
          <Currency>CNY</Currency>
          <Status>I</Status>
        </item>
        <item>
          <CheckNumber>1000002</CheckNumber>
          <IssueDate>2026-06-30</IssueDate>
          <Payee>XYZ Services Inc.</Payee>
          <Amount>5000.00</Amount>
          <Currency>CNY</Currency>
          <Status>V</Status>
        </item>
      </CheckItems>
    </PositivePayFileSend>
  </soap:Body>
</soap:Envelope>
```

### Response
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <PositivePayFileSendResponse>
      <Return>
        <Type>S</Type>
        <Message>File transmitted successfully / 文件已成功传?/Message>
      </Return>
      <FileReference>BANK-REF-20260723-001</FileReference>
    </PositivePayFileSendResponse>
  </soap:Body>
</soap:Envelope>
```

---

## Error Codes / 错误代码
| Code | Description (EN) | Description (CN) |
|------|------------------|------------------|
| `POS_001` | Invalid bank account | 无效的银行账?|
| `POS_002` | Duplicate check number | 重复的支票号?|
| `POS_003` | Amount must be positive | 金额必须为正?|
| `POS_004` | Bank communication error | 银行通信错误 |

---

## Notes / 备注
- Voided checks (Status=V) must be reported on the same day / 作废支票（状?V）必须在当天报告
- Maximum 5000 check items per file / 每个文件最?000个支票项?- File transmission is asynchronous; check bank response for confirmation / 文件传输为异步方式，请查看银行响应的确认信息