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

销售数据采集接口开发指南 WebService 目 录开发流程说明2开发步骤指南3开发代码示例指南26 开发流程说明1） 当一笔交易完成后，把生成的销售数据写成标准的XML文件格式，然后连接web service server端，把XML文件发送到web service server端。交易发送不成功形成提醒式回馈信息告知,譬如”交易上传至商场不成功,请检查网络联系管理员”。2） 如果连接web service server端不成功，把该笔交易的销售数据的唯一标示保存到本地文件，以便在连接web service server端正常的情况下，可以通过该唯一标示提取数据库中的原始销售数据，重新生成XML文件并发送到web service server端。成功发送后，把本地文件对应该笔的销售数据的唯一标示删除。3） 如果返回xml文件显示的状态为不成功，把该笔交易的销售数据的唯一标示保存到本地文件，以便在数据校验成功后，可以通过该唯一标示提取数据库中的原始销售数据，重新生成XML文件并发送到web service server端。成功发送后，把本地文件对应该笔的销售数据的唯一标示删除。4） 租户POS系统每天销售完结后，并且所有交易资料都已经上传到Web服务器后，连接Web服务器，将当天的销售交易汇总发送到WebService服务器，以方便商场零售管理系统核对本日交易记录匹配情况。开发步骤指南PostSalesCreate销售交易1. Web Service交易函数说明PostSalesCreate()：上传正常销售交易数据、退货交易数据函数。2. Web Service交易函数结构说明软件开发商每笔销售（退货）数据完结需要调用上传交易Web Service函数，每次只上传一笔交易数据。每一笔交易数据均需包含以下内容： Header信息包括许可证，用户名，密码等等信息 交易汇总信息包括该笔销售的交易日期，交易时间，店铺号，收银机号，交易流水号，总金额，总货品数，付款方式数量（共有几种付款方式）等等信息。每笔销售数据，只会有一条汇总信息。 货品信息包括货品编号，货品单价，货品数量，实际销售交易，等等信息。每笔销售数据，可有多条货品信息。 付款方式信息包括付款方式编号，付款金额（找零后金额）等等信息。每笔销售数据，可有多条付款方式信息。3. 函数调用示例说明以下提供XML文件格式，紧接着是以表格的形式对文件格式进行详细解释。postsalescreate()请求数据格式：以下是 SOAP 1.2 请求和响应示例。所显示的占位符需替换为实际值。POST /esPOS_WebService/nv_espos_webservice.asmx HTTP/1.1Host: 8Content-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 string string string string string 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 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 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付款方式中填写对应方式付款实际金额，无对应付款方式时在其他付款方式字段填写剩余付款方式金额的合计。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 string 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 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 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 4. XML数据文件内容详细解释 传入参数：Postsalescreate 返回值：PostsalescreateResponse 举例 PostsalescreateRequest:销售单请求序号字段名描述数据类型允许空值说明1.header标头requestheader否2.salestotal销售单主表SalesTotal否3.salesitems销售单明细表SalesItem否4.salestenders销售单付款明细表SalesTender是5.salesdelivery销售单配送表SalesDatadelivery是保留PostsalescreateResponse:销售单响应序号字段名描述数据类型允许空值说明1.header标头responseheader否2.salestotal销售单主表SalesTotal否3.salesitems销售单明细表SalesItem否4.salestenders销售单付款明细表SalesTender否5.sale