帮助中心

1220-上传会员小票

2021-12-17

接口编号 1220

接口说明

1、上传会员的交易小票数据(验证门店、订单号、会员是否存在,订单长度小于等于26,门店16,RefSaleNo长度26,VipOffCode长度20)  

2、支持批量,限制100,小票明细可以为空。

3、明细金额合计(SaleMoney)与主数据(SaleMoney)有一致验证

4、shopCode+SaleNo 表示订单唯一

5、paydtls如果有值,忽略明细金额与表头一致验证,paydtls合计可等于少于表头SalePayMoney

6、门店,导购不存在会自动创建

请求说明

  • HTTP请求方式:POST

  • 返回数据格式:JSON

  • 请求路径:api/csale/vipsaleupload

请求参数

字段类型为空长度描述
ShopCodestring1~16门店代码,shopCode+SaleNo表示唯一
SaleNostring1~26订单编号
RefSaleNostring0~26关联单号(退货单关联)
SaleTypestring1订单状态:S=销售;R=退货;C= 换货
VipOffCodestring1~20会员线下卡号
SaleDatestring19销售日期(yyyy-MM-dd   HH:mm:ss格式)
SaleQtyint0~11销售总数量,销售总数量需介于-1000, 1000之间。退货时为负数。
SaleMoneydouble(12,2)销售总金额(2位小数-应付)。退货时为负数。
SaleProdQtyint0~11销售商品品项数。
SaleOrigMoneydouble(12,2)原始总金额(2位小数)。退货时为负数。
SalePayMoneydouble(12,2)实付金额(2位小数-实付)。退货时为负数。
SalerCodestring0~16导购工号
CmdShopCodestring0~16推荐门店编码
CmdSalerCodestring0~16推荐导购编码
Dtls[]

商品明细,json数组
DataOriginInt2数据来源:默认0:线下门店;1:品牌自有商城;2:品牌线上官网;6:EZR微商城;7:EZR微信小程序;9第三方商城;10:天猫;11:京东 12:拼多多; 13:其它;14:小红书;15:考拉;16:唯品会,20:抖音,21快手,22京东小程序
SaleCategoryInt20:会员;1:非会员 注:同一批次仅支持一种类型小票,非会员小票仅支持线下来源
PayDtls[][]支付方式明细,json数组

Dtls数据结构

字段类型为空长度描述
ProdCodestring1~22商品条码(SKU)
RetailPricedouble(12,2)零售单价(2位小数)
SalePricedouble(12,2)实际售价(2位小数)
SaleQtyint1-11销售件数,负数代表退货,不可以为0
SaleMoneydouble(12,2)销售金额(2位小数=SalePrice×SaleQty=订单 SaleMoney)
CmdShopCodestring0~16推荐门店编码
CmdSalerCodestring0~16推荐导购编码
SalerCodestring0~16导购工号

PayDtls数据结构

字段类型描述
PayOriginstring支付方式(AL=支付宝,WX=微信支付,EP=EZR储蓄卡,ES=EZR储值卡赠送,BC=银行卡支付,BP=积分抵现,XG=西瓜支付,OT=其它)
PayMoneydecimal支付金额

请求参数示例代码(json对象)

[{
 "ShopCode": "HQS0001",
 "SaleNo": "000012809",
 "RefSaleNo": "",
 "SaleType": "S",
 "VipOffCode": "EZ00001201",
 "SaleDate": "2015-06-22 10:30:01",
 "SaleQty": 2,
 "SaleMoney": 890.00,
 "SaleProdQty": 1,
 "SaleOrigMoney": 890.00,
 "SalerCode": "",
 "CmdShopCode": "",
 "CmdSalerCode": "",
 "Dtls": [{
     "ProdCode": "15026609123",        
     "RetailPrice": 450.00,
     "SalePrice": 450.00,
     "SaleQty": 1,
     "SaleMoney": 450.00,
     "SalerCode": "",
     "CmdShopCode": "",
             "CmdSalerCode": "",
 }, {
     ...
 }],
 "PayDtls":[{
     "PayOrigin":"WX",
     "PayMoney":100
 },...]
}, {
 ...
}];


系统级返回结果示例(json)

{
 "Status": true,
 "StatusCode": 200,
 "Msg": "成功",
 "Timestamp": "20150622093101",
 "Sign": "6ECC9BF07C69E80F6D8552FF7B2E7A8FCA2CC80E",
 "Result": 见业务返回结果示例,
}

业务返回结果示例(json对象):

内容1,代表所影响行数



17949