# ECC_CASHPOINTPAYMENTCRTNO

**SOAP v1.0.0 — ACTIVE**

## Title / 标题
**External Cash Point - Inbound Payment Notification / 外部收银点 - 入库付款通知**

## Operation / 操作
`CashPointPaymentCreate`

---

## Description / 描述
Transfer payment data to Contract Accounting (FI-CA) using this asynchronous inbound service.

使用此异步入站服务将付款数据传输到合同会计（FI-CA）。

---

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

## Message Structure / 消息结构

### Request / 请求
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `CashPointPayment` | `CASHPOINT_PAY` | Payment header | 付款抬头 |
| `?CashPointID` | `CHAR(10)` | Cash point ID | 收银点编号 |
| `?PaymentDate` | `DATE` | Payment date | 付款日期 |
| `?PaymentTime` | `TIME` | Payment time | 付款时间 |
| `?CompanyCode` | `CHAR(4)` | Company code | 公司代码 |
| `?BusinessPartner` | `CHAR(10)` | Business partner number | 业务伙伴编号 |
| `?PaymentMethod` | `CHAR(1)` | Payment method | 付款方式 |
| `Amount` | `DECIMAL` | Payment amount | 付款金额 |
| `Currency` | `CUKY(5)` | Currency | 货币 |
| `Reference` | `CHAR(35)` | Payment reference | 付款参考 |
| `Items` | Table | Payment allocation items | 付款分配项目 |
| `?ContractAccount` | `CHAR(12)` | Contract account | 合同账户 |
| `?Amount` | `QUAN` | Allocated amount | 分配金额 |

### 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 | 消息文本 |
| `PaymentDocument` | `CHAR(20)` | FI-CA payment document number | FI-CA付款凭证编号 |

---

## Example Payload / 示例负载

### Request
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <CashPointPaymentCreate>
      <CashPointPayment>
        <CashPointID>CP-001</CashPointID>
        <PaymentDate>2026-07-24</PaymentDate>
        <PaymentTime>14:30:00</PaymentTime>
        <CompanyCode>1000</CompanyCode>
        <BusinessPartner>BP10001</BusinessPartner>
        <PaymentMethod>C</PaymentMethod>
        <Amount>3500.00</Amount>
        <Currency>CNY</Currency>
        <Reference>INV-202607-001</Reference>
      </CashPointPayment>
      <Items>
        <item>
          <ContractAccount>CA-10001</ContractAccount>
          <Amount>3500.00</Amount>
        </item>
      </Items>
    </CashPointPaymentCreate>
  </soap:Body>
</soap:Envelope>
```

### Response
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <CashPointPaymentCreateResponse>
      <Return>
        <Type>S</Type>
        <Message>Payment created successfully / 付款创建成功</Message>
      </Return>
      <PaymentDocument>PAY-20260724-001</PaymentDocument>
    </CashPointPaymentCreateResponse>
  </soap:Body>
</soap:Envelope>
```

---

## Error Codes / 错误代码
| Code | Description (EN) | Description (CN) |
|------|------------------|------------------|
| `CPP_001` | Invalid business partner | 无效的业务伙伴 |
| `CPP_002` | Contract account not found | 未找到合同账户 |
| `CPP_003` | Payment amount must be positive | 付款金额必须为正数 |
| `CPP_004` | Duplicate payment reference | 重复的付款参考 |

---

## Notes / 备注
- Payments are posted to Contract Accounting (FI-CA) / 付款过账到合同会计（FI-CA）
- Each payment must have at least one allocation item / 每笔付款必须至少有一个分配项目
- This is an asynchronous inbound service / 此为异步入站服务