三、接口参数定义

####

**详细的接口文档参见：‸**

[【附件】MIS_POS--收银接口规范v5.1.1.zip](/media/attachment/2025/04/MIS_POS--%E6%94%B6%E9%93%B6%E6%8E%A5%E5%8F%A3%E8%A7%84%E8%8C%83v5.1.1.zip)

**请求&** **应答类定义**

### 1.1 RequestData、ResponseData 类说明

**RequestData****请求：**
调用函数 RequestData. putValue (String key, String value)

功能：填入请求信息相应的数据

参数：key：请求数据的键量

```
Value：key 对应的值
```

|  **Key** **（不区分大小写）**                                                                                               | **字段类型** | **注释**                                   |
| ----------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | -------------------------------------------------- |
| PosNumber                                                                                                                               | String             | 收银机号                                         |
| StoreNumber                                                                                                                             | String             | 门店号                                           |
| Operator                                                                                                                                | String             | 操作员号                                         |
| CardNumber                                                                                                                              | String             | 卡号(扫码支付时传入付款码)                       |
| CardType                                                                                                                                | String             | 卡种代码（银行卡 01，万商通联 02……）           |
| TransType                                                                                                                               | String             | 交易类型                                         |
| Amount                                                                                                                                  | String             | 金额（12 位，分为单位，不足左补 0）              |
| OldTraceNumber                                                                                                                          | String             | 原始流水号                                       |
| AuthNumber                                                                                                                              | String             | 授权码（6 位，不足左补 0）                       |
| HostserialNumber                                                                                                                        | String             | 原系统参考号（12 位，不足左补 0）                |
| TransDate                                                                                                                               | String             | 原交易日期（4 位，MMDD）                         |
| ExpireDate                                                                                                                              | String             | 有效期                                           |
| Memo                                                                                                                                    | String             | 其他信息                                         |
| TransCheck                                                                                                                              | String             | 交易唯一标识                                     |
| BusinessId                                                                                                                              | String             | 业务编码，用于多业务模式                         |
| TransId                                                                                                                                 | String             | 收银宝交易单号(消费时返回，撤销、退货时传入)     |
| OrderNumber                                                                                                                             | String             | 商户交易订单号                                   |
| OldOrderNumber                                                                                                                          | String             | 原商户交易订单号                                 |
| SubAcct                                                                                                                                 | String             | 订单交易分账信息（内容为 JSON 格式，详见附录一） |
|                                                                                                                                         |                    |                                                  |
| 自定义附加 KEY                                                                                                                          |
| preDef_0                                                                                                                                | String | 自定义域 1 |
| preDef_1                                                                                                                                | String | 自定义域 2 |
| ……                                                                                                                                    | …… | …… |
| preDef_9                                                                                                                                | String | 自定义域 9 |
| preDef_A                                                                                                                                | String | 自定义域 10 |
| preDef_B                                                                                                                                | String | 自定义域 11 |
| ……                                                                                                                                    | …… | …… |
| preDef_J                                                                                                                                | String | 自定义域 20 |
|                                                                                                                                         |   |   |
| **备注：1. TransCheck 参考格式为 YYYYMMDD + hhmmss + 收银小票号（保证每笔交易的 TransCheck 唯一值即可，最大长度不要超过 20 位）** |

**ResponseData****应答：**

调用函数 RequestData.GetValue(Key as String) As String

功能：根据填入的 Key 返回对应的 Value

参数：Key：请求返回数据的键

|  **Key** **（不区分大小写）**                | **字段类型** | **注释**                                                                                                 |
| ---------------------------------------------------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Tips                                                     | String             | 小费                                                                                                           |
| Total                                                    | String             | 总计                                                                                                           |
| Amount                                                   | String             | 金额                                                                                                           |
| BalanceAmount                                            | String             | 余额                                                                                                           |
| PosTraceNumber                                           | String             | 流水号                                                                                                         |
| CardNumber                                               | String             | 卡号                                                                                                           |
| OldTraceNumber                                           | String             | 原始流水号                                                                                                     |
| ExpireDate                                               | String             | 有效期                                                                                                         |
| BatchNumber                                              | String             | 批次号                                                                                                         |
| MerchantNumber                                           | String             | 商户号                                                                                                         |
| MerchantName                                             | String             | 商户名                                                                                                         |
| TerminalNumber                                           | String             | 终端号                                                                                                         |
| HostSerialNumber                                         | String             | 系统参考号                                                                                                     |
| AuthNumber                                               | String             | 授权码                                                                                                         |
| RejCode                                                  | String             | 返回码                                                                                                         |
| IssNumber                                                | String             | 发卡行号                                                                                                       |
| IssName                                                  | String             | 发卡行名称                                                                                                     |
| CardNumber                                               | String             | 卡号                                                                                                           |
| TransDate                                                | String             | 交易日期                                                                                                       |
| TransTime                                                | String             | 交易时间                                                                                                       |
| RejCodeExplain                                           | String             | 返回码解释                                                                                                     |
| CardBack                                                 | String             | 卡片回收标志                                                                                                   |
| Memo                                                     | String             | 备注                                                                                                           |
| TransCheck                                               | String             | 交易唯一标识                                                                                                   |
| IsOffline                                                | String             | 脱机标识：0-联机、1-脱机                                                                                       |
| CUPS                                                     | String             | 卡组织                                                                                                         |
| TransId                                                  | String             | 收银宝-交易单号（撤销、退货需传入，当网上统一收银时表示的是商户的交易单号，此时收银宝的交易单号用 TrxId 字段） |
| PrintContent                                             | String             | 打印内容                                                                                                       |
| DiscountAmt                                              | String             | 优惠金额                                                                                                       |
| ActualPayment                                            | String             | 实付金额                                                                                                       |
| OrderNumber                                              | String             | 订单编号                                                                                                       |
| SubAcct                                                  | String             | 订单交易分账信息                                                                                               |
| TrxId                                                    | String             | 收银宝交易单号（只用在网上统一收银时）                                                                         |
| TrxStatus                                                | String             | 交易的状态,对于刷卡支付，该状态表示实际的支付结果，其他为下单状态（只用在网上统一收银时）                      |
|                                                          |
| 自定义附加 KEY                                           |
| preDef_0                                                 | String | 自定义域 1 |
| preDef_1                                                 | String | 自定义域 2 |
| ……                                                     | …… | …… |
| preDef_9                                                 | String | 自定义域 9 |
| preDef_A                                                 | String | 自定义域 10 |
| preDef_B                                                 | String | 自定义域 11 |
| ……                                                     | …… | …… |
| preDef_J                                                 | String | 自定义域 20 |
|                                                          |   |   |
| 备注：1. 如果对应 Key 没有 Value，函数则返回空字符串“” |

三、 接口参数定义

三、接口参数定义