---
# API: POS Financial Transactions - Create
# File: CE_POS_FINANCIAL_TRANS_CREATE_REQ_IN.md
# Version: 1.0.0
# Status: ACTIVE
# Protocol: SOAP (Synchronous)
# Source URL: https://api.sap.com/api/CE_POS_FINANCIAL_TRANS_CREATE_REQ_IN/overview
# Generated: 2026-07-23
---

# POS Financial Transactions - Create / POS金融交易 - 创建

> **API 版本:** 1.0.0 | **状态:** ACTIVE | **协议:** SOAP  
> **技术名称:** `CE_POS_FINANCIAL_TRANS_CREATE_REQ_IN`  
> **WSDL 绑定:** `/sap/bc/srt/wsdl/flv_10002A111AD1/bndr_url/sap/bc/srt/rfc/sap/ce_pos_financial_trans_create_req_in/100/ce_pos_financial_trans_create_req_in/binding`  
> **SAP 通信场景:** `SAP_COM_0113`

## 概述 / Overview

该同步 SOAP 入站服务用于创建 POS 金融交易记录。支持金融交易抬头、行项目、付款方式、税务和汇总数据的传输。

This synchronous inbound SOAP service creates POS financial transaction records. It supports financial transaction header, line item, payment method, tax, and summary data transmission.

**API 业务加速器中心:** [https://api.sap.com/api/CE_POS_FINANCIAL_TRANS_CREATE_REQ_IN/overview](https://api.sap.com/api/CE_POS_FINANCIAL_TRANS_CREATE_REQ_IN/overview)

---

## 消息结构 / Message Structure

| # | 结构名称 | 描述 (EN) | 描述 (CN) |
|---|----------|-----------|-----------|
| 1 | `POSFinancialTransactionCreate` | POS Financial Transaction Create Request | POS金融交易创建请求 |
| 2 | `POSFinancialTransactionCreateResponse` | POS Financial Transaction Create Response | POS金融交易创建响应 |

---

## 1. 请求结构: POSFinancialTransactionCreate / POS金融交易创建请求

**命名空间:** `urn:sap-com:document:sap:soap:functions:mc-style`

| # | 字段名称 | 类型 | 描述 (EN) | 描述 (CN) |
|---|----------|------|-----------|-----------|
| 1 | `TransactionID` | string(35) | Financial Transaction ID | 金融交易编号 |
| 2 | `StoreID` | string(10) | Store ID | 门店编号 |
| 3 | `POSSystemID` | string(10) | POS System ID | POS系统编号 |
| 4 | `BusinessDayDate` | date | Business Day Date | 营业日期 |
| 5 | `TransactionDate` | datetime | Transaction Date/Time | 交易日期时间 |
| 6 | `TransactionType` | string(2) | Transaction Type (01=Sale, 02=Return, 03=Void) | 交易类型 (01=销售, 02=退货, 03=作废) |
| 7 | `TotalAmount` | decimal(16,3) | Total Financial Amount | 金融交易总金额 |
| 8 | `CurrencyCode` | string(5) | Currency Code | 货币代码 |
| 9 | `PaymentMethod` | string(2) | Payment Method (CA=Cash, CR=Credit Card, DB=Debit Card) | 付款方式 (CA=现金, CR=信用卡, DB=借记卡) |

---

## 2. 响应结构: POSFinancialTransactionCreateResponse / POS金融交易创建响应

**命名空间:** `urn:sap-com:document:sap:soap:functions:mc-style`

| # | 字段名称 | 类型 | 描述 (EN) | 描述 (CN) |
|---|----------|------|-----------|-----------|
| 1 | `TransactionID` | string(35) | Financial Transaction ID | 金融交易编号 |
| 2 | `Status` | string(1) | Status (S=Success, E=Error) | 状态 (S=成功, E=错误) |
| 3 | `Message` | string(200) | Status Message | 状态消息 |

---

## SOAP 示例 / SOAP Example

### 请求示例 / Request Example

```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:urn="urn:sap-com:document:sap:soap:functions:mc-style">
   <soap:Header/>
   <soap:Body>
      <urn:POSFinancialTransactionCreate>
         <TransactionID>FIN-TXN-20260723-001</TransactionID>
         <StoreID>STORE-001</StoreID>
         <POSSystemID>POS-001</POSSystemID>
         <BusinessDayDate>2026-07-23</BusinessDayDate>
         <TransactionDate>2026-07-23T14:30:00</TransactionDate>
         <TransactionType>01</TransactionType>
         <TotalAmount>1250.00</TotalAmount>
         <CurrencyCode>USD</CurrencyCode>
         <PaymentMethod>CR</PaymentMethod>
      </urn:POSFinancialTransactionCreate>
   </soap:Body>
</soap:Envelope>
```

### 响应示例 / Response Example

```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:urn="urn:sap-com:document:sap:soap:functions:mc-style">
   <soap:Header/>
   <soap:Body>
      <urn:POSFinancialTransactionCreateResponse>
         <TransactionID>FIN-TXN-20260723-001</TransactionID>
         <Status>S</Status>
         <Message>Financial transaction FIN-TXN-20260723-001 created successfully</Message>
      </urn:POSFinancialTransactionCreateResponse>
   </soap:Body>
</soap:Envelope>
```

---

## 字段说明 / Field Descriptions

### TransactionID
- **类型:** string(35)
- **描述 (EN):** Financial Transaction ID
- **描述 (CN):** 金融交易编号
- **用途:** 标识需要创建的 POS 金融交易

### StoreID
- **类型:** string(10)
- **描述 (EN):** Store ID
- **描述 (CN):** 门店编号
- **用途:** 标识发生金融交易的门店

### POSSystemID
- **类型:** string(10)
- **描述 (EN):** POS System ID
- **描述 (CN):** POS系统编号
- **用途:** 标识发起金融交易的 POS 系统

### BusinessDayDate
- **类型:** date
- **描述 (EN):** Business Day Date
- **描述 (CN):** 营业日期
- **用途:** 交易归属的营业日期

### TransactionDate
- **类型:** datetime
- **描述 (EN):** Transaction Date/Time
- **描述 (CN):** 交易日期时间
- **用途:** 交易发生的具体日期和时间

### TransactionType
- **类型:** string(2)
- **描述 (EN):** Transaction Type
- **描述 (CN):** 交易类型
- **用途:** 01 = 销售 (Sale), 02 = 退货 (Return), 03 = 作废 (Void)

### TotalAmount
- **类型:** decimal(16,3)
- **描述 (EN):** Total Financial Amount
- **描述 (CN):** 金融交易总金额
- **用途:** 交易的总金额（含税）

### CurrencyCode
- **类型:** string(5)
- **描述 (EN):** Currency Code
- **描述 (CN):** 货币代码
- **用途:** 交易使用的货币（如 USD, CNY）

### PaymentMethod
- **类型:** string(2)
- **描述 (EN):** Payment Method
- **描述 (CN):** 付款方式
- **用途:** CA = 现金 (Cash), CR = 信用卡 (Credit Card), DB = 借记卡 (Debit Card)

### Status
- **类型:** string(1)
- **描述 (EN):** Status
- **描述 (CN):** 状态
- **用途:** S = 成功 (Success), E = 错误 (Error)

### Message
- **类型:** string(200)
- **描述 (EN):** Status Message
- **描述 (CN):** 状态消息
- **用途:** 返回处理结果描述信息

---

## 处理规则 / Processing Rules

1. 系统必须提供有效的金融交易编号 (TransactionID) 才能执行创建操作。
2. 门店编号和 POS 系统编号必须为有效的 SAP 主数据。
3. 交易类型必须为有效的 SAP 代码：01 = 销售, 02 = 退货, 03 = 作废。
4. 付款方式必须为有效的 SAP 代码：CA = 现金, CR = 信用卡, DB = 借记卡。
5. 交易总金额必须与行项目汇总金额一致。
6. 响应中的状态字段指示操作结果：S = 成功，E = 错误。

---

## 错误处理 / Error Handling

| HTTP 状态码 | 错误代码 | 描述 (EN) | 描述 (CN) |
|-------------|----------|-----------|-----------|
| 400 | `INVALID_TRANSACTION_ID` | Invalid Transaction ID | 无效的交易编号 |
| 400 | `INVALID_STORE_ID` | Invalid Store ID | 无效的门店编号 |
| 400 | `INVALID_POS_SYSTEM_ID` | Invalid POS System ID | 无效的POS系统编号 |
| 400 | `INVALID_TRANSACTION_TYPE` | Invalid Transaction Type | 无效的交易类型 |
| 400 | `INVALID_PAYMENT_METHOD` | Invalid Payment Method | 无效的付款方式 |
| 400 | `AMOUNT_MISMATCH` | Transaction amount mismatch | 交易金额不匹配 |
| 500 | `CREATION_FAILED` | Creation process failed | 创建过程失败 |

---

## 配置指南 / Configuration Guide

### SAP 通信场景配置
1. 在 SAP S/4HANA 系统中，使用事务码 `SM30` 维护表 `SCOP`（通信场景）。
2. 激活通信场景 `SAP_COM_0113`。
3. 创建通信系统和通信用户。
4. 分配相应的入站服务权限。

### 端点配置
- **SOAP 端点:** `/sap/bc/srt/rfc/sap/ce_pos_financial_trans_create_req_in/100/ce_pos_financial_trans_create_req_in`
- **SOAP 操作:** `POSFinancialTransactionCreate`
- **SOAP 版本:** 1.1

---

## 相关链接 / Related Links

- [SAP API Business Hub - POS Financial Transaction Create](https://api.sap.com/api/CE_POS_FINANCIAL_TRANS_CREATE_REQ_IN/overview)
- [SAP Help Portal - POS Financial Integration](https://help.sap.com/docs/sap-s4hana)
- [SAP Communication Scenario SAP_COM_0113](https://api.sap.com/communication_scenario/SAP_COM_0113)