满记 第三方POS数据收集WebService方式开发指南-esales接口版本0826

销售数据采集接口开发指南 WebService文档名称(title)销售数据采集接口开发指南作者(Author)华北科传项目组审批者 (To Be Approved By)科传项目经理：TECH-TRANS说明 (Comments)旨在对第三方POS销售数据采集接口开发指南定义方案书；前言在承租方与租赁方双方签署的XXXXXX 号商铺（下称“该商铺”）的XXXXXXXX商铺租赁合同（下称“租赁合同”）规定的租赁期（下称“租赁期”）内，承租方有义务按照租赁合同内要求将每日每笔销售交易数据通过软件接口的方式，每日按时传送给租赁方（业主）的管理系统内。承租方同意使用租赁方（业主）提供的销售数据上传的形式，并协助租赁方（业主）在商铺开业前，完成数据接口调试与上传工作。为配合此次项目销售数据实时采集项目的要求；现将数据接口技术方案通过此文给予发布，以便承租方POS软件开发者（供应商）研读制作相应销售数据接口。技术方案业务业务逻辑架构图租户自带POS系统通讯层 C接口调用层 A项目零售管理系统POS ServerWebService ClientpostesalescreateWebServer发布应用层 B存储交易产生交易报文1. Web Service交易函数说明Postesalescreate()：上传正常销售交易数据、退货交易数据函数。2. Web Service交易函数结构说明软件开发商每笔销售（退货）数据完结需要调用上传交易Web Service函数，每次只上传一笔交易数据。每一笔交易数据均需包含以下内容： Header信息包括许可证，用户名，密码等等信息 交易汇总信息包括该笔销售的交易日期，交易时间，店铺号，收银机号，交易流水号，总金额，总货品数，付款方式数量（共有几种付款方式）等等信息。每笔销售数据，只会有一条汇总信息。 货品信息包括货品编号，货品单价，货品数量，实际销售交易，等等信息。每笔销售数据，可有多条货品信息。 付款方式信息包括付款方式编号，付款金额（找零后金额）等等信息。每笔销售数据，可有多条付款方式信息。3. 函数调用示例说明以下提供XML文件格式，紧接着是以表格的形式对文件格式进行详细解释。Postesalescreate()请求数据格式：以下是 SOAP 1.2 请求和响应示例。所显示的占位符需替换为实际值。占位符示例：POST /eSales/esales.asmx HTTP/1.1Host: 0Content-Type: application/soap+xml; charset=utf-8Content-Length: length string string string string int int int string string string string string string string string string string string string decimal decimal string int string decimal decimal decimal decimal string string int string decimal decimal decimal decimal string string int string decimal decimal decimal string string int string decimal decimal decimal string string 填写数据示例：（为非本项目测试用户信息） GYHTC00001 123456 1 1 1 SALESDATA 332 V332M 20160329 170723 01 GYHTCL1000080001 01 10000791 01 1 0.99 2 1100008001 1 0 0.99 0 2 CH 0.99 0.99 0 备注：1）以上示例中tendercode付款方式代号解释：CH-现金。（测试时，请只以CH现金进行测试即可），正式系统内的各个付款方式如需要一一对应，在交付正式地址及贵司的用户信息时会连带附上正式环境下付款方式代码及定义。接口数据应在TenderCode付款方式中填写对应方式付款实际金额，无对应付款方式时在其他付款方式字段填写剩余付款方式金额的合计。Postesalescreate()返回信息：HTTP/1.1 200 OKContent-Type: application/soap+xml; charset=utf-8Content-Length: length short string int int int int int string string string Rtn Code:-1:失败0:成功1:数据库报错2:原始数据错误3:SQL语句错误5:货号不存在6:VIP Code不存在11:用户名/密码错误14:无效日期15:无效时间1000:单据已存在(重复上传)1001:原单据不存在1002:销售货号为空1003:付款信息为空1005:积分补录的销售单不存在1006:积分补录的销售单已是VIP销售单 1007:积分补录的销售金额与系统中对应销售单的销售金额不匹配4. XML数据文件内容详细解释 传入参数：Postesalescreate 返回值：PostesalescreateResponse 举例PostesalescreateRequest:销售开单请求序号字段名描述数据类型允许空值说明1.header标头requestheader否2.salestotal销售开单主表SalesTotal否3.salesitems销售开单明细表SalesItem否4.salestenders销售开单付款明细表SalesTender否PostesalescreateResponse:销售开单响应序号字段名描述数据类型允许空值说明1.header标头responseheader否2.salestotal销售开单主表SalesTotal否Header标头信息序号字段名描述数据类型允许空值说明1.username用户名string否商场提供每个租户单位一个2.password密码string否商场提供每个租户单位一个3.messagetype消息类型string否固定值：SALESDATA4.messageid消息IDstring否固定值：3325.version版本编号string否固定值：V332MSalesTotal:销售单主表序号字段名描述数据类型允许空值说明1.txdate_yyyymmdd交易日期string否长度:8固定格式：YYYYMMDD2.txtime_hhmmss交易时间string否长度:6固定格式：HHMMSS3.Mallid商城编号string否长度:2 4.storecode店铺号string否长度:20Web服务系统需要校验该店铺的有效性5.tillid收银机号string否可用01或者02表示如果专柜只有一台收银机就用01表示，如果有两台则第二台用02表示，依次类推Web服务系统需要校验该收银机编号的有效性6.txdocno销售单号string否长度:30（不超过）专柜销售单号，必须唯一Web服务系统如果判断到此单号的记录已经存在，返回错误信息7.cashier收银员编号string否长度:108.salesman销售员string是保留9.vipcodeVIP号string是固定留空10.netqty数量decimal 4 否长度:1固定值：111.netamount销售净金额decimal 4 否当金额是负数时，则被认为是退货12.extendparam预留字段string是后期扩展预留，留空即可SalesItem:销售单货品明细表序号字段名描述数据类型允许空值说明1.lineno商品行号string否长度:12.itemcode商品编号string否长度:30Web服务系统校验货号是否有效3.qty数量decimal 4 否长度:1固定值：1退货为负数4.discountamount折扣金额decimal 4 否固定值：05.netamount净金额decimal 4 否当金额是负数时，则被认为是退货6.bonusearn获得的积分decimal 4 否固定值：07.extendparam预留字段string是后期扩展使用，留空即可8.salesitemremark货品备注string是固定空值SalesTender:销售单付款明细表序号字段名描述数据类型允许空值说明1.lineno行号string否长度:12.tendercode付款代码string否长度:2CH-现金接口数据应在TenderCode付款方式中填写对应方式付款实际金额，无对应付款方式时在其他付款方式字段填写剩余付款方式金额的合计Web服务系统需要校验付款方式编号有效性3.payamount付款金额decimal 4 否付款金额4.baseamount本位币金额decimal 4 否同payamount5.excessamount找零金额decimal 4 否固定为 0 6.extendparam预留字段string是后期扩展使用，留空即可7.remark备注信息string是固定空值5. 返回码解释Postesalescreate()返回码解释返回码（short）为【0】，表示调用Web Service成功。交易被完整接纳。返回码（short）为非【0】，表示调用Web Service不成功。软件开发商收到此返回信息清除重传交易队列销售资料。其他返回码表示不成功，不成功信息从（string）获取。软件开发商收到其他返回码请将未成功传送的交易放入重传交易队列。并且截取responsemessage在程序界面做相应的提示。请开发方保存好response，以此作为上传成功的记录。6. 异常情况说明 连接Web Service无法连通的情况下，租户POS系统产生的交易应该保存在POS机器本地磁盘或者数据库中。租户POS系统应当在网络正常的前提下，在适当的功能模块里给出提示信息，提示租户POS系统操作人员连接Web Service发送交易数据。 连接Web Service无法连通的情况下，租户POS系统应当尝试几次（建议三次）连接。如果还无法连通，建议POS系统能编写代码停止发送数据，并间隔一定的时间后再连接Web Service（建议设定每一小时），从而避免不断连接，影响租户POS系统机器的性能。 已经发送成功的销售数据租户POS系统要保证不再重复发送，这样才能保证Web服务器不会过多处理异常数据。生产环境软件开发商可以通过以下网址进行本次项目的Web Service测试：服务端具体地址：开发商可通过以下网址进行本次项目的WebService接口测试：(内网)外网URL: 5:30001/esales.asmx?WSDLWebservice服务器。测试账号信息商场编号（mallid