pospal 银豹收银系统-凯发网站

销售单据api



• 更新时间:2018-04-12


• 1.查询所有凯发官方首页的支付方式代码


• 2.根据单据序列号查询


• 3.根据单据uid查询


• 4.分页查询所有单据


• 5.分页查询会员单据


• 6.根据销售单据uid查询对应的退货单据


• 7.根据销售单据sn查询对应的退货单据


• 8.根据退货单据uid查询对应的销售单据


• 9.根据退货单据sn查询对应的销售单据


• 10.根据网单号查询对应的销售单据


• 11.查询我的凯发官方首页的支付方式代码

1. 查询凯发官方首页的支付方式代码

接口地址	http://host:port/pospal-api2/openapi/v1/ticketopenapi/queryallpaymethod
请求头	user-agent: openapi content-type: application/json; charset=utf-8 accept-encoding: gzip,deflate time-stamp: 1437528688233 data-signature: bf706e6ac693ba3b1babd32e6713431d
请求方式	post
请求体	{ "appid": "abcdefghijklmn" }
参数名	是否必须	类型	说明
appid	是	string	pospal配置的访问凭证
返回结果	{ "status": "success", "messages": [], "data": [ { "code": "paycode_1", "name": "现金" } { "code": "paycode_2", "name": "储值卡" } ] }
字段名	类型	说明
status	string	是否正确处理请求，返回success或error，不区分大小写
messages	string[]	处理结果的消息
errorcode	int	业务处理的错误代码,参见错误代码表
data	list	实体信息
code	string	凯发官方首页的支付方式代码
name	string	凯发官方首页的支付方式名称

2. 根据单据序列号查询

接口地址	http://host:port/pospal-api2/openapi/v1/ticketopenapi/queryticketbysn
请求头	user-agent: openapi content-type: application/json; charset=utf-8 accept-encoding: gzip,deflate time-stamp: 1437528688233 data-signature: bf706e6ac693ba3b1babd32e6713431d
请求方式	post
请求体	{ "appid": "abcdefghijklmn", "sn":"201511121549168880001" }
参数名	是否必须	类型	说明
appid	是	string	pospal配置的访问凭证
sn	是	string	单据序列号
返回结果	{ "status": "success", "messages": [], "data":{ "cashieruid": 832101480292933201, "customeruid": 6666, "sn": "201511121602084680006", "datetime": "2015-11-12 16:02:12", "totalamount": 72, "totalprofit": 42, "discount": 100, "externalorderno": "2017121521001004460219576817", "remark": "收银测试", "rounding": 0, "tickettype": "sell", "invalid": 0, "weborderno": "21061518100850239104", "payments": [ { "code": "paycode_1", "amount": 9.42 }, ], "pointusage":{ "customeruid": 6666, "point": 80.00, "money": 8.00, "exchangetype": 1 }, "items":[ { "name": "冰摩卡", "buyprice": 10, "sellprice": 24, "customerprice": 22, "quantity": 1, "discount": 100, "customerdiscount": 100, "totalamount": 24, "totalprofit": 14, "iscustomerdiscount": 1, "productuid": 379659791803681560, "ticketitemattributes": [ { "attributename": "加粮", "attributevalue": "一匙" } ], "saleguiderlist": [ { "guideruid": 340630600558146350, "guiderjobnumber": "2002" "guidername": "林肉肉" } ] } ] } }
字段名	类型	说明
status	string	是否正确处理请求，返回success或error，不区分大小写
messages	string[]	处理结果的消息
errorcode	int	业务处理的错误代码,参见错误代码表
data	json	单据实体信息
cashieruid	long	收银员唯一标识
customeruid	long	会员唯一标识 为0表示收银时没选择会员
sn	string	单据序列号
datetime	string	单据产生的时间，格式为yyyy-mm-dd hh:mm:ss
totalamount	bigdecima	单据实收总额
totalprofit	bigdecima	单据总利润
discount	bigdecima	单据折扣
externalorderno	string	第三方平台支付单号
remark	string	备注
rounding	bigdecima	抹零数额，比如3.1元收别人3元，0.1就是被抹零数额
tickettype	string	单据类型：sell销售单据, sell_return退货单据。不区分大小写
invalid	int	值为1时表示单据已作废(反结账)
weborderno	string	网单号（直接在pos端收银，不会有值。只有通过外卖平台，小程序，或者订单推送接口 的网单才有）
payments	list	多种凯发官方首页的支付方式
code	string	凯发官方首页的支付方式代码
amount	bigdecimal	支付金额
pointusage	json	积分使用明细 上面的demo表示 80积分抵现8元
customeruid	long	会员uid
point	bigdecimal	积分
money	bigdecimal	金额
exchangetype	int	积分使用类型 1:积分抵现 2:积分兑换
items	list	单据条目实体
name	string	单据条目商品名称
buyprice	bigdecimal	单据条目商品进货价
sellprice	bigdecimal	单据条目商品销售价
customerprice	bigdecimal	单据条目商品会员价
quantity	bigdecimal	单据条目销售的商品数量，如3.5箱
discount	bigdecimal	单据条目所打的折扣
customerdiscount	bigdecimal	单据条目所打的会员折扣
totalamount	bigdecimal	单据条目总价
totalprofit	bigdecimal	单据条目总利润
iscustomerdiscount	int	数据为1时表求享受了会员折扣
productuid	long	单据条目所对应的商品唯一标识
ticketitemattributes	list	单据条目属性、备注实体
attributename	string	属性名称，即口味选项，如加糖、加水、加冰
attributevalue	string	属性值，即口味价格
saleguiderlist	list	导购员信息
guideruid	long	导购员uid
guiderjobnumber	string	导购员工号
guidername	string	导购员名字
ticketstoreappidoraccount	string	会员所在消费门店的appid或账号 当前接口该字段不会有值。 只有 5. 分页查询会员单据，该字段才有值。

3. 根据单据uid查询

接口地址	http://host:port/pospal-api2/openapi/v1/ticketopenapi/queryticketbyuid
请求头	user-agent: openapi content-type: application/json; charset=utf-8 accept-encoding: gzip,deflate time-stamp: 1437528688233 data-signature: bf706e6ac693ba3b1babd32e6713431d
请求方式	post
请求体	{ "appid": "abcdefghijklmn", "uid": 8008010001 }
参数名	是否必须	类型	说明
appid	是	string	pospal配置的访问凭证
uid	是	long	单据uid
返回结果	字段参照2. 根据单据序列号查询
字段名	类型	说明
字段参照2. 根据单据序列号查询

4. 分页查询所有单据

接口地址	http://host:port/pospal-api2/openapi/v1/ticketopenapi/queryticketpages
请求头	user-agent: openapi content-type: application/json; charset=utf-8 accept-encoding: gzip,deflate time-stamp: 1437528688233 data-signature: bf706e6ac693ba3b1babd32e6713431d
请求方式	post
请求体	{ "appid": "abcdefghijklmn", "starttime": "2015-11-12 01:59:59", "endtime": "2015-11-12 23:59:59", "postbackparameter":{ "parametertype": "abcd",从返回结果中直接取出 "parametervalue": "abcd" } }
参数名	是否必须	类型	说明
appid	是	string	pospal配置的访问凭证
starttime	是	string	格式为yyyy-mm-dd hh:mm:ss
endtime	是	string	格式为yyyy-mm-dd hh:mm:ss endtime - starttime<=1天
postbackparameter	否	json	查询凯发官方首页时可以不传，之后的内容从返回结果中取出
parametertype	是	string	从返回结果中取出
parametervalue	是	string	从返回结果中取出
返回结果	{ "status": "success", "messages": [], "data":{ "postbackparameter": { "parametertype": "abcd", 从返回结果中直接取出 "parametervalue":"abcd" } "result": [ { "cashieruid": 832101480292933201, "customeruid": 0, "sn": "201511121602084680006", "datetime": "2015-11-12 16:02:12", "totalamount": 72, "totalprofit": 42, "discount": 100, "externalorderno": "2017121521001004460219576817", "remark": "收银测试", "rounding": 0, "tickettype": "sell", ""invalid": 0, "payments": [ { "code": "paycode_1", "amount": 9.42 } ] "items": [ { "name": "冰摩卡", "buyprice": 10, "sellprice": 24, "customerprice": 22, "quantity": 1, "discount": 100, "customerdiscount": 100, "totalamount": 24, "totalprofit": 14, "iscustomerdiscount": 1, "productuid":379659791803681560, ticketitemattributes": [ { "attributename":"加粮", "attributevalue":"一匙" } ] } ] } ] "pagesize": 100 } }
字段名	类型	说明
status	string	是否正确处理请求，返回success或error，不区分大小写
messages	string[]	处理结果的消息
errorcode	int	业务处理的错误代码,参见错误代码表
pagesize	int	本次查询预期从库存取出记录数，如果结果集的长度小于pagesize，不需要进行下一页查询
postbackparameter	json	分页查询回传到服务器的参数结构从第二页开始必须回传，如果没传，每次查询都是第一页
parametertype	string	从返回结果中直接取出用于回传，不能变其值
parametervalue	string	从返回结果中直接取出用于回传，不能变其值
result	list	单据实体信息，字段信息参照2. 根据单据序列号查询

5. 分页查询会员单据

接口地址	http://host:port/pospal-api2/openapi/v1/ticketopenapi/querycustomerhistoryticketsbyuid
请求头	user-agent: openapi content-type: application/json; charset=utf-8 accept-encoding: gzip,deflate time-stamp: 1437528688233 data-signature: bf706e6ac693ba3b1babd32e6713431d
请求方式	post
请求体	{ "appid": "abcdefghijklmn", "starttime": "2015-11-12 01:59:59", "endtime": "2015-11-12 23:59:59", "customeruid": "886263699231969848", "queryallstoreconsume": 1, "postbackparameter":{ "parametertype": "last_result_min_id", "parametervalue": "3764404" } }
参数名	是否必须	类型	说明
appid	是	string	pospal配置的访问凭证
starttime	否	string	格式为yyyy-mm-dd hh:mm:ss
endtime	否	string	格式为yyyy-mm-dd hh:mm:ss
customeruid	是	string	会员在银豹系统的唯一标识
queryallstoreconsume	否	int	是否查询会员在所有门店的消费记录 1：是，0：否，默认0
postbackparameter	否	json	查询凯发官方首页时可以不传，之后的内容从返回结果中取出
parametertype	是	string	从返回结果中取出
parametervalue	是	string	从返回结果中取出
返回结果	{ "status": "success", "messages": [], "data":{ "postbackparameter": { "parametertype": "last_result_min_id", "parametervalue":"3764404" }, "result": [ { "cashieruid": 832101480292933201, "customeruid": 0, "sn": "201511121602084680006", "datetime": "2015-11-12 16:02:12", "totalamount": 72, "totalprofit": 42, "discount": 100, "externalorderno": "2017121521001004460219576817", "rounding": 0, "tickettype": "sell", ""invalid": 0, "payments": [ { "code": "paycode_1", "amount": 9.42 } ], "items": [ { "name": "冰摩卡", "buyprice": 10, "sellprice": 24, "customerprice": 22, "quantity": 1, "discount": 100, "customerdiscount": 100, "totalamount": 24, "totalprofit": 14, "iscustomerdiscount": 1, "productuid":379659791803681560, ticketitemattributes": [ { "attributename":"加粮", "attributevalue":"一匙" } ] } ], "ticketstoreappidoraccount": "87eb2c555bbf382e7f6c7b275b0c502a" } ], "pagesize": 100 } }
字段名	类型	说明
status	string	是否正确处理请求，返回success或error，不区分大小写
messages	string[]	处理结果的消息
errorcode	int	业务处理的错误代码,参见错误代码表
pagesize	int	本次查询预期从库存取出记录数，如果结果集的长度小于pagesize，不需要进行下一页查询
postbackparameter	json	分页查询回传到服务器的参数结构从第二页开始必须回传，如果没传，每次查询都是第一页
parametertype	string	从返回结果中直接取出用于回传，不能变其值
parametervalue	string	从返回结果中直接取出用于回传，不能变其值
result	list	单据实体信息，字段信息参照2. 根据单据序列号查询

6. 根据销售单据uid查询对应的退货单据

接口地址	http://host:port/pospal-api2/openapi/v1/ticketopenapi/queryrefunticketbysellticketuid
请求头	user-agent: openapi content-type: application/json; charset=utf-8 accept-encoding: gzip,deflate time-stamp: 1437528688233 data-signature: bf706e6ac693ba3b1babd32e6713431d
请求方式	post
请求体	{ "appid": "abcdefghijklmn", "selltcketuid": 8008010001 }
参数名	是否必须	类型	说明
appid	是	string	pospal配置的访问凭证
selltcketuid	是	long	销售单据uid
返回结果	字段参照2. 根据单据序列号查询

7. 根据销售单据sn查询对应的退货单据

接口地址	http://host:port/pospal-api2/openapi/v1/ticketopenapi/queryrefunticketbysellticketsn
请求头	user-agent: openapi content-type: application/json; charset=utf-8 accept-encoding: gzip,deflate time-stamp: 1437528688233 data-signature: bf706e6ac693ba3b1babd32e6713431d
请求方式	post
请求体	{ "appid": "abcdefghijklmn", "selltcketsn": "20170509154301968000" }
参数名	是否必须	类型	说明
appid	是	string	pospal配置的访问凭证
selltcketsn	是	string	销售单据sn
返回结果	字段参照2. 根据单据序列号查询

8.根据退货单据uid查询对应的销售单据

接口地址	http://host:port/pospal-api2/openapi/v1/ticketopenapi/querysellticketbyrefunticketuid
请求头	user-agent: openapi content-type: application/json; charset=utf-8 accept-encoding: gzip,deflate time-stamp: 1437528688233 data-signature: bf706e6ac693ba3b1babd32e6713431d
请求方式	post
请求体	{ "appid": "abcdefghijklmn", "refuntcketuid": 1508919704366308111 }
参数名	是否必须	类型	说明
appid	是	string	pospal配置的访问凭证
refuntcketuid	是	long	退贷单据uid
返回结果	字段参照2. 根据单据序列号查询

9.根据退货单据sn查询对应的销售单据

接口地址	http://host:port/pospal-api2/openapi/v1/ticketopenapi/querysellticketbyrefunticketsn
请求头	user-agent: openapi content-type: application/json; charset=utf-8 accept-encoding: gzip,deflate time-stamp: 1437528688233 data-signature: bf706e6ac693ba3b1babd32e6713431d
请求方式	post
请求体	{ "appid": "abcdefghijklmn", "refuntcketsn": "201710251621443620002" }
参数名	是否必须	类型	说明
appid	是	string	pospal配置的访问凭证
refuntcketsn	是	string	退贷单据sn
返回结果	字段参照2. 根据单据序列号查询

10.根据网单号查询对应的销售单据

接口地址	http://host:port/pospal-api2/openapi/v1/ticketopenapi/queryticketbyorderno
请求头	user-agent: openapi content-type: application/json; charset=utf-8 accept-encoding: gzip,deflate time-stamp: 1437528688233 data-signature: bf706e6ac693ba3b1babd32e6713431d
请求方式	post
请求体	{ "appid": "abcdefghijklmn", "orderno": "20170509154301968000" }
参数名	是否必须	类型	说明
appid	是	string	pospal配置的访问凭证
orderno	是	string	网单号
返回结果	字段参照2. 根据单据序列号查询

11. 查询我的凯发官方首页的支付方式代码

接口地址	http://host:port/pospal-api2/openapi/v1/ticketopenapi/querymypaymethod
请求头	user-agent: openapi content-type: application/json; charset=utf-8 accept-encoding: gzip,deflate time-stamp: 1437528688233 data-signature: bf706e6ac693ba3b1babd32e6713431d
请求方式	post
请求体	{ "appid": "abcdefghijklmn" }
参数名	是否必须	类型	说明
appid	是	string	pospal配置的访问凭证
返回结果	{ "status": "success", "messages": [], "data": [ { "code": "paycode_1", "name": "现金" } { "code": "paycode_2", "name": "储值卡" } ] }
字段名	类型	说明
status	string	是否正确处理请求，返回success或error，不区分大小写
messages	string[]	处理结果的消息
errorcode	int	业务处理的错误代码,参见错误代码表
data	list	实体信息
code	string	凯发官方首页的支付方式代码
name	string	凯发官方首页的支付方式名称