销售数据采集接口开发指南
WebService
开发流程说明
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.1
Host: 59.41.59.58
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="/2001/XMLSchema-instance" xmlns:xsd="/2001/XMLSchema" xmlns:soap12="/2003/05/soap-envelope">
<soap12:Body>
<postsalescreate xmlns="">
<astr_request>
<header>
<licensekey>string</licensekey>
<username>string</username>
<password>string</password>
<lang>string</lang>
<pagerecords>int</pagerecords>
<pageno>int</pageno>
<updatecount>int</updatecount>
<messagetype>string</messagetype>
<messageid>string</messageid>
<version>string</version>
</header>
webserver接口开发 <salestotal>
<localstorecode>string</localstorecode>
<reservedocno>string</reservedocno>
<txdate_yyyymmdd>string</txdate_yyyymmdd>
<txtime_hhmmss>string</txtime_hhmmss>
<mallid>string</mallid>
<storecode>string</storecode>
<tillid>string</tillid>
<salestype>string</salestype>
<txdocno>string</txdocno>
<orgtxdate_yyyymmdd>string</orgtxdate_yyyymmdd>
<orgstorecode>string</orgstorecode>
<orgtillid>string</orgtillid>
<txorgdocno>string</txorgdocno>
<mallitemcode>string</mallitemcode>
<cashier>string</cashier>
<vipcode>string</vipcode>
<salesman>string</salesman>
<demographiccode>string</demographiccode>
<demographicdata>string</demographicdata>
<netqty>decimal</netqty>
<originalamount>decimal</originalamount>
<sellingamount>decimal</sellingamount>
<couponnumber>string</couponnumber>
<coupongroup>string</coupongroup>
<coupontype>string</coupontype>
<couponqty>short</couponqty>
<totaldiscount>
<salesdiscount xsi:nil="true" />
<salesdiscount xsi:nil="true" />
</totaldiscount>
<ttltaxamount1>decimal</ttltaxamount1>
<ttltaxamount2>decimal</ttltaxamount2>
<netamount>decimal</netamount>
<paidamount>decimal</paidamount>
<changeamount>decimal</changeamount>
<priceincludetax>string</priceincludetax>
<shoptaxgroup>string</shoptaxgroup>
<extendparam>string</extendparam>
<invoicetitle>string</invoicetitle>
<invoicecontent>string</invoicecontent>
<issueby>string</issueby>
<issuedate_yyyymmdd>string</issuedate_yyyymmdd>
<issuetime_hhmmss>string</issuetime_hhmmss>
<ecorderno>string</ecorderno>
<buyerremark>string</buyerremark>
<orderremark>string</orderremark>
<status>string</status>
<ttpossalesdocno>string</ttpossalesdocno>
版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。
发表评论