导入订单

开发者可以在用户支付完成后,同步小程序/H5/APP订单数据至好物圈(H5/APP订单需保证调用支付接口的H5/APP与导入数据的小程序绑定在同一个微信开放平台帐号下)。

历史订单导入:在首次接入时,开发者需导入最近三个月的”历史订单“数据,导入数据有助于物品在搜索中获得更好的曝光,帮助新接入的商家在搜索中实现冷启动。

接口说明:

接口调用基本信息说明
协议https
http请求方式POST
请求URLhttps://api.weixin.qq.com/mall/importorder?action=add-order&is_history=0/1&access_token=ACCESS_TOKEN
POST数据格式UTF-8 json
接口能力导入订单数据
接口调用时机用户完成支付
其他说明如果订单中的物品为首次导入,订单中的物品信息会该物品的初始化信息;如果为历史订单,请求URL的is_history参数值为1。

请求数据样例

示例代码
  1. {
  2. "order_list": [
  3. {
  4. "order_id": "AQAATGagQ7KQCxMJEj7kHuUjTxxx",
  5. "create_time": 1527584231,
  6. "pay_finish_time": 1527584244,
  7. "desc": "xx微主页",
  8. "fee": 1,
  9. "trans_id": "4200000144201807116521229xxx",
  10. "status": 3,
  11. "ext_info": {
  12. "product_info": {
  13. "item_list": [
  14. {
  15. "item_code": "00003563372839_00000010001xxx",
  16. "sku_id": "00003563372839_10000010014xxx",
  17. "amount": 1,
  18. "total_fee": 1,
  19. "thumb_url": "https://shp.qpic.cn/wechat_bs/0/4eb3dcee0edcd34939b87f232e9fxxxx",
  20. "title": "肯德基XX",
  21. "desc": "xxxx",
  22. "unit_price": 1,
  23. "original_price": 2,
  24. "poi_list": [
  25. {
  26. "longitude": 116.32676,
  27. "latitude": 40.003305,
  28. "radius": 4,
  29. "business_name": "肯德基",
  30. "branch_name": "珠江新城店",
  31. "address": "新港中路123号"
  32. },
  33. {
  34. "longitude": 117.32676,
  35. "latitude": 41.003305,
  36. "radius": 5,
  37. "business_name": "肯德基",
  38. "branch_name": "客村店",
  39. "address": "新港中路123号"
  40. }
  41. ],
  42. "stock_attr_info": [
  43. {
  44. "attr_name": {
  45. "name": "尺码"
  46. },
  47. "attr_value": {
  48. "name": "L"
  49. }
  50. }
  51. ],
  52. "category_list": [
  53. "衣服",
  54. "T-shirt"
  55. ],
  56. "item_detail_page": {
  57. "path": "/portal/xxxx/detail?code=00003563372839_00000010001xxx"
  58. },
  59. "bar_code_info": {
  60. "barcode_type": "ean8",
  61. "barcode": "12345678"
  62. },
  63. "platform_category_list": [
  64. {
  65. "category_id": 4342,
  66. "category_name": "运动裤"
  67. }
  68. ]
  69. }
  70. ]
  71. },
  72. "express_info": {
  73. "name": "测试用户",
  74. "phone": "158xxxxxx",
  75. "address": "广东省广州市tit创意园品牌街腾讯微信总部",
  76. "price": 0,
  77. "national_code": "440105",
  78. "country": "中国",
  79. "province": "广东省",
  80. "city": "广州市",
  81. "district": "海珠区",
  82. "express_package_info_list": [
  83. {
  84. "express_company_id": 2001,
  85. "express_company_name": "圆通",
  86. "express_code": "88627337387xxx",
  87. "ship_time": 1517713509,
  88. "express_page": {
  89. "path": "/libs/xxxxx/portal/express-detail/xxxxx"
  90. },
  91. "express_goods_info_list": [
  92. {
  93. "item_code": "00003563372839_00000010001xxx",
  94. "sku_id": "00003563372839_10000010014xxx"
  95. }
  96. ]
  97. }
  98. ]
  99. },
  100. "promotion_info": {
  101. "discount_fee": 1
  102. },
  103. "brand_info": {
  104. "phone": "12345678",
  105. "contact_detail_page": {
  106. "path": "/libs/xxxxx/portal/contact_detail/xxxx"
  107. }
  108. },
  109. "invoice_info": {
  110. "type": 0,
  111. "title": "xxxxxx",
  112. "tax_number": "xxxxxx",
  113. "company_address": "xxxxxx",
  114. "telephone": "020-xxxxxx",
  115. "bank_name": "招商银行",
  116. "bank_account": "xxxxxxxx",
  117. "invoice_detail_page": {
  118. "path": "/libs/xxxxx/portal/invoice-detail/xxxxx"
  119. }
  120. },
  121. "payment_method": 1,
  122. "user_open_id": "xxxxxxx",
  123. "order_detail_page": {
  124. "path": "/libs/xxxxx/portal/order-detail/xxxxx",
  125. "kf_type":3
  126. }
  127. }
  128. }
  129. ]
  130. }
添加订单参数列表
订单基本字段必填字段类型说明
order_listarray单次请求订单数量不可超过10单
order_list字段必填字段类型说明
order_idstring订单id,需要保证唯一性
create_timeuint32订单创建时间,unix时间戳
pay_finish_timeuint32支付完成时间,unix时间戳
descstring订单备注
feeuint32订单金额,单位:分
trans_idstring微信支付订单id,对于使用微信支付的订单,该字段必填
statusuint32订单状态,3:支付完成 4:已发货 5:已退款 100: 已完成
ext_infoobject订单扩展信息
ext_info字段必填字段类型说明
product_infoobject物品相关信息
express_infoobject快递信息
promotion_infoobject订单优惠信息
brand_infoobject商家信息
invoice_infoobject发票信息,对于开发票订单,该字段必填
payment_methoduint32订单支付方式,0:未知方式 1:微信支付 2:其他支付方式
user_open_idstring用户的openid,参见openid说明
order_detail_pageobject订单详情页(小程序页面)
total_feeuint32订单物品合计金额(优惠前金额,不填写的话,平台默认用物品的total fee累加)
product_info字段必填字段类型说明
item_listarray包含订单中所有物品的信息
item_list字段必填字段类型说明
item_codestring物品ID(SPU ID),要求appid下全局唯一
sku_idstringsku_id
amountuint32物品数量
total_feeuint32物品总价,单位:分
thumb_urlstring物品图片,图片宽度必须大于750px,宽高比建议4:3 - 1:1之间
titlestring物品名称
descstring物品详细描述
unit_priceuint32物品单价(实际售价),单位:分
original_priceuint32物品原价,单位:分
stock_attr_infoarray物品属性列表
category_listarray物品类目列表
item_detail_pageobject物品详情页(小程序页面)
can_be_searchbool物品能否被搜索(默认true可以被搜索)
bar_code_infoobject物品的条形码信息
platform_category_listarray物品平台类目列表,填写的每个类目必须在好物圈物品类目表列出,多级类目只填最后一级(如完整类目为"运动户外-运动服饰-运动裤",只需要填"运动裤"的类目ID与类目名)
poi_list字段选填字段类型说明
longitudedouble门店的经度,WGS84标准
latitudedouble门店的纬度,WGS84标准
radiusdouble门店可送达半径,单位km
business_namestring门店名称(仅为商户名,如:国美、麦当劳,不应包含地区、地址、分店名等信息,错误示例:北京国美),20个字符以内
branch_namestring分店名称(不应包含地区信息,不应与门店名有重复,错误示例:北京王府井店),20个字符以内
addressstring门店地址(不包含省市区信息,如:新港中路123号)
stock_attr_info字段必填字段类型说明
attr_nameobject属性名
attr_valueobject属性值
attr_name字段必填字段类型说明
namestring属性名称
attr_value字段必填字段类型说明
namestring属性值
item_detail_page字段(以下二选一)必填字段类型说明
pathstring小程序物品详情页跳转链接
src_h5_pathstringh5物品详情页跳转链接
platform_category_list字段必填字段类型说明
category_iduint32平台类目ID
category_namestring平台类目名称
express_info字段必填字段类型说明
namestring收件人姓名
phonestring收件人联系电话
addressstring收件人地址
priceuint32运费,单位:分
national_codestring行政区划代码
countrystring国家
provincestring省份
citystring城市
districtstring
express_package_info_listarray包裹中的物品信息
express_package_info_list字段必填字段类型说明
express_company_iduint32快递公司id
express_company_namestring快递公司名
express_codestring快递单号
ship_timeuint32发货时间,unix时间戳
express_pageobject快递详情页(小程序页面)
express_goods_info_listarray包裹物品信息
express_page字段(以下二选一)必填字段类型说明
pathstring小程序快递详情页跳转链接
src_h5_pathstringh5快递详情页跳转链接
express_goods_info_list字段必填字段类型说明
item_codestring物品id
sku_idstringsku_id
promotion_info字段必填字段类型说明
discount_feeuint32优惠金额
invoice_info字段必填字段类型说明
typeuint32抬头类型,0:单位,1:个人
titlestring发票抬头
tax_numberstring发票税号
company_addressstring单位地址
telephonestring手机号码
bank_namestring银行名称
bank_accountstring银行账号
invoice_detail_pageobject发票详情页(小程序页面)
brand_info字段必填字段类型说明
phonestring用于售后场景的商家联系电话,便于用户咨询和问题解决
contact_detail_pageobject联系商家页面
logostring商家logo,不填的话,默认取小程序头像
namestring商家名称,不填的话,默认取小程序名字
invoice_detail_page字段(以下二选一)必填字段类型说明
pathstring小程序发票详情页跳转链接
src_h5_pathstringh5发票详情页跳转链接
order_detail_page字段(以下二选一)必填字段类型说明
pathstring小程序订单详情页跳转链接
src_h5_pathstringh5订单详情页跳转链接
contact_detail_page字段必填字段类型说明
kf_typeint在线客服类型 1 没有在线客服; 2 微信客服消息; 3 小程序自有客服; 4 公众号h5自有客服
pathstring小程序自有客服页面路径,kf_type为3时必填
src_h5_pathstring公众号h5自有客服页面路径,kf_type为4时必填
bar_code_info字段必填字段类型说明
barcode_typestring条形码类型, 目前支持"ean8", "ean13", 前者对应的barcode为8位纯数字字符串,后者为13位纯数字字符串
barcodestring条形码数字字符串

回包数据样例

接口调用成功回包
  1. {
  2. "errcode":0,
  3. "errmsg":"success"
  4. }
接口调用失败回包
  1. {
  2. "errcode": 9019101,
  3. "errmsg":"订单数量超过限制"
  4. }
回包字段类型说明
errcodeint32错误码
errmsgstring错误信息
fail_order_listobject失败订单信息
fail_order_list字段类型说明
order_idstring失败订单ID
error_codeint32订单错误码
msgstring错误提示

接口错误码

回包错误码说明
0成功
9009099系统错误
9009098请求参数错误,详细错误提示请参考json回包中的errmsg字段。
9009400订单数量超过限制
其他常见错误码点击查看
订单错误码说明
-1系统错误
-2订单参数错误