POS数据收集WebService方式开发指南.doc

《POS数据收集WebService方式开发指南.doc》由会员分享，可在线阅读，更多相关《POS数据收集WebService方式开发指南.doc（26页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、 销售数据采集接口开发指南 WebService 目 录开发流程说明2开发步骤指南3开发代码示例指南26 开发流程说明1） 当一笔交易完成后，把生成的销售数据写成标准的XML文件格式，然后连接web service server端，把XML文件发送到web service server端。交易发送不成功形成提醒式回馈信息告知,譬如”交易上传至商场不成功,请检查网络联系管理员”。2） 如果连接web service server端不成功，把该笔交易的销售数据的唯一标示保存到本地文件，以便在连接web service server端正常的情况下，可以通过该唯一标示提取数据库中的原始销售数据，重新生

2、成XML文件并发送到web service server端。成功发送后，把本地文件对应该笔的销售数据的唯一标示删除。3） 如果返回xml文件显示的状态为不成功，把该笔交易的销售数据的唯一标示保存到本地文件，以便在数据校验成功后，可以通过该唯一标示提取数据库中的原始销售数据，重新生成XML文件并发送到web service server端。成功发送后，把本地文件对应该笔的销售数据的唯一标示删除。4） 租户POS系统每天销售完结后，并且所有交易资料都已经上传到Web服务器后，连接Web服务器，将当天的销售交易汇总发送到WebService服务器，以方便商场零售管理系统核对本日交易记录匹配情况。开发

3、步骤指南PostSalesCreate销售交易1. Web Service交易函数说明PostSalesCreate()：上传正常销售交易数据、退货交易数据函数。2. Web Service交易函数结构说明软件开发商每笔销售（退货）数据完结需要调用上传交易Web Service函数，每次只上传一笔交易数据。每一笔交易数据均需包含以下内容： Header信息包括许可证，用户名，密码等等信息 交易汇总信息包括该笔销售的交易日期，交易时间，店铺号，收银机号，交易流水号，总金额，总货品数，付款方式数量（共有几种付款方式）等等信息。每笔销售数据，只会有一条汇总信息。 货品信息包括货品编号，货品单价，货品

4、数量，实际销售交易，等等信息。每笔销售数据，可有多条货品信息。 付款方式信息包括付款方式编号，付款金额（找零后金额）等等信息。每笔销售数据，可有多条付款方式信息。3. 函数调用示例说明以下提供XML文件格式，紧接着是以表格的形式对文件格式进行详细解释。postsalescreate()请求数据格式：以下是 SOAP 1.2 请求和响应示例。所显示的占位符需替换为实际值。POST /esPOS_WebService/nv_espos_webservice.asmx HTTP/1.1Host: 59.41.59.58Content-Type: application/soap+xml; chars

5、et=utf-8Content-Length: length string string string string int int int string string string string string string string string string string string string string string string string string string string string string string decimal decimal decimal string string string short decimal decimal decimal

6、decimal decimal string string string string string string string string string string string string string string int string string string string string string string string string string string short decimal decimal decimal decimal string string string string string decimal decimal decimal decimal

7、decimal decimal decimal string string string string int string string string string string string string string string string string short decimal decimal decimal decimal string string string string string decimal decimal decimal decimal decimal decimal decimal string string string int string short

8、short decimal decimal decimal string string int string short short decimal decimal decimal string string string string string string string string string string string string string string string string string string 备注：1）以上示例中tendercode付款方式代号解释：CH-现金 CI-国内银行卡 CO-国外银行卡 OT-其他付款方式。接口数据应在TenderCode付款方式

9、中填写对应方式付款实际金额，无对应付款方式时在其他付款方式字段填写剩余付款方式金额的合计。Postsalescreate()返回信息：HTTP/1.1 200 OKContent-Type: application/soap+xml; charset=utf-8Content-Length: length short string int int int int int string string string string string string string string string string string string string string string string s

10、tring string string string string string decimal decimal decimal string string string short decimal decimal decimal decimal decimal string string string string string string string string string string string string string string int string string string string string string string string string string string short decimal decimal decimal decimal string string string string string decimal decimal decimal decimal decimal decimal decimal string string string string int/