帮助中心

1220-上传会员小票

2020-11-04

接口编号 1220

接口说明

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

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

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

4、shopCode+SaleNo 表示订单唯一

请求说明

  • 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微信小程序;10:天猫;11:京东 12:拼多多
SaleCategoryInt20:会员;1:非会员 注:同一批次仅支持一种类型小票,非会员小票仅支持线下来源



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导购工号



请求参数示例代码(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": "",
  }, {
      ...
  }]
}, {
  ...
}];


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

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

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

内容1,代表所影响行数


11572