帮助中心
进入EZR

2030-上传平台订单

2021-06-08

接口编号  2030

接口说明

1、上传第三方商城（淘宝、京东等）交易订单数据。

注：

1.1 只需要接入订单完成、客户确认收货的订单。先判断下单人淘宝nick，再查找收货人手机号；（对于未线下开卡的手机号，默认只保存3个月数据，待线下开卡后自动转为会员订单）

1.2 每商城渠道的订单编号必须唯一；

1.3 支持批量接入，最大数据行数限制100。

1.4 saleTime必须在一年以内，DiscountMoney不能小于0，退货金额和数量必须都为负数，商品明细不能为空，明细的合计Amount必须等于主数据的TotalMoney，明细的合计Quantity必须等于主数据的TotalQty

请求说明

  • HTTP请求方式：POST

  • 返回数据格式：JSON

  • 请求路径：api/morder/thirdOrdAdd

请求参数

字段类型为空长度描述
ShopCodestring否1~16渠道代码（商城的店铺号），批量必须是同一渠道代码
Codestring否1~26订单编号
OriginalCodestring是1~26关联单号(退货单关联)
OrderTimestring否
销售日期(yyyy-MM-dd HH:mm:ss格式)
TotalQtyint否
订单总数量
TotalMoneydouble否
订单总金额(2位小数)
PayTimestring否
付款完成时间(yyyy-MM-dd HH:mm:ss格式)
PayAmountdouble是
实际支付金额(2位小数)
BuyerCodestring否1~32买家账号
DiscountMoneydouble是
优惠总金额(2位小数)
RecvConsigneestring否1~32收货人姓名
RecvMobilestring否1~16收货人手机，按该字段去关联线下会员卡号
RecvTelstring是1~16收货人电话
RecvAddressstring是1~128收货人地址
RecvProvincestring是1~32收货人省份
RecvCitystring是1~64收货人城市
RecvCountystring是1~64收货人区县
DataOriginint是
数据来源：10=淘宝；11=京东；12=拼多多
Dtls[]否
商品明细

Dtls数据结构

字段类型为空长度描述
BarCodestring否1~30商品条码
PriceOriginaldouble是
原始单价(2位小数)
PriceSelldouble是
实际售价(2位小数)
Quantityint是
订购数量
Amountdouble是
订购金额(2位小数)
DiscountMoneydouble是
折扣金额(2位小数)

请求参数示例代码（json对象）

[{
"ShopCode": "HQS0001",
"Code": "0000128092",
"BuyerCode": "EZ00001201",
"OrderTime": "2019-06-22   10:30:01",
"TotalQty": 1,
"TotalMoney": 450.00,
"PayTime": "2019-06-22   10:35:01",
"PayAmount": 450.00,
"DataOrigin": 1,
"DiscountMoney": 0.00,
"RecvConsignee": "测试",
"RecvMobile": "13122136787",
"Dtls": [{
 "BarCode": "15026609123",
 "PriceOriginal": 450.00,
 "PriceSell": 450.00,
 "Quantity": 1,
 "Amount": 450.00,
 "DiscountMoney": 0.00
}]
}, {
"ShopCode": "HQS0001",
"Code": "0000128094",
"BuyerCode": "EZ00001201",
"OrderTime": "2019-06-22   10:30:01",
"TotalQty": 1,
"TotalMoney": 450.00,
"PayTime": "2019-06-22   10:35:01",
"PayAmount": 450.00,
"DataOrigin": 1,
"DiscountMoney": 0.00,
"RecvConsignee": "测试",
"RecvMobile": "13122136787",
"Dtls": [{
 "BarCode": "15026609123",
 "PriceOriginal": 450.00,
 "PriceSell": 450.00,
 "Quantity": 1,
 "Amount": 450.00,
 "DiscountMoney": 0.00
}]
}]


系统级返回结果示例（json）

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

业务返回结果示例（json对象）：

内容1，代表所影响行数


3936