导入订单

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

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

接口说明:

接口调用基本信息 说明
协议 https
http请求方式 POST
请求URL https://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。

请求数据样例

示例代码
{
  "order_list": [
    {
      "order_id": "AQAATGagQ7KQCxMJEj7kHuUjTxxx",
      "create_time": 1527584231,
      "pay_finish_time": 1527584244,
      "desc": "xx微主页",
      "fee": 1,
      "trans_id": "4200000144201807116521229xxx",
      "status": 3,
      "ext_info": {
        "product_info": {
          "item_list": [
            {
              "item_code": "00003563372839_00000010001xxx",
              "sku_id": "00003563372839_10000010014xxx",
              "amount": 1,
              "total_fee": 1,
              "thumb_url": "https://shp.qpic.cn/wechat_bs/0/4eb3dcee0edcd34939b87f232e9fxxxx",
              "title": "肯德基XX",
              "desc": "xxxx",
              "unit_price": 1,
              "original_price": 2,
              "poi_list": [
                {
                  "longitude": 116.32676,
                  "latitude": 40.003305,
                  "radius": 4,
                  "business_name": "肯德基",
                  "branch_name": "珠江新城店",
                  "address": "新港中路123号"
                },
                {
                  "longitude": 117.32676,
                  "latitude": 41.003305,
                  "radius": 5,
                  "business_name": "肯德基",
                  "branch_name": "客村店",
                  "address": "新港中路123号"
                }
              ],
              "stock_attr_info": [
                {
                  "attr_name": {
                    "name": "尺码"
                  },
                  "attr_value": {
                    "name": "L"
                  }
                }
              ],
              "category_list": [
                "衣服",
                "T-shirt"
              ],
              "item_detail_page": {
                "path": "/portal/xxxx/detail?code=00003563372839_00000010001xxx"
              },
              "bar_code_info": {
                "barcode_type": "ean8",
                "barcode": "12345678"
              },
              "platform_category_list": [
                {
                  "category_id": 4342,
                  "category_name": "运动裤"
                }
              ]
            }
          ]
        },
        "express_info": {
          "name": "测试用户",
          "phone": "158xxxxxx",
          "address": "广东省广州市tit创意园品牌街腾讯微信总部",
          "price": 0,
          "national_code": "440105",
          "country": "中国",
          "province": "广东省",
          "city": "广州市",
          "district": "海珠区",
          "express_package_info_list": [
            {
              "express_company_id": 2001,
              "express_company_name": "圆通",
              "express_code": "88627337387xxx",
              "ship_time": 1517713509,
              "express_page": {
                "path": "/libs/xxxxx/portal/express-detail/xxxxx"
              },
              "express_goods_info_list": [
                {
                  "item_code": "00003563372839_00000010001xxx",
                  "sku_id": "00003563372839_10000010014xxx"
                }
              ]
            }
          ]
        },
        "promotion_info": {
          "discount_fee": 1
        },
        "brand_info": {
          "id": "qwertyui",
          "name": "外婆家",
          "phone": "12345678",
          "contact_detail_page": {
            "path": "/libs/xxxxx/portal/contact_detail/xxxx"
          }
        },
        "invoice_info": {
          "type": 0,
          "title": "xxxxxx",
          "tax_number": "xxxxxx",
          "company_address": "xxxxxx",
          "telephone": "020-xxxxxx",
          "bank_name": "招商银行",
          "bank_account": "xxxxxxxx",
          "invoice_detail_page": {
            "path": "/libs/xxxxx/portal/invoice-detail/xxxxx"
          }
        },
        "payment_method": 1,
        "user_open_id": "xxxxxxx",
        "order_detail_page": {
          "path": "/libs/xxxxx/portal/order-detail/xxxxx",
          "kf_type":3
        },
        "follow_buy_info": {
          "wxapp_fb_key": "BgA****K7b"
        }
      }
    }
  ]
}
添加订单参数列表
订单基本字段 必填 字段类型 说明
order_list array 单次请求订单数量不可超过10单
order_list字段 必填 字段类型 说明
order_id string 订单id,需要保证唯一性
create_time uint32 订单创建时间,unix时间戳
pay_finish_time uint32 支付完成时间,unix时间戳
desc string 订单备注
fee uint32 订单金额,单位:分
trans_id string 微信支付订单id,对于使用微信支付的订单,该字段必填
status uint32 订单状态,3:支付完成 4:已发货 5:已退款 100: 已完成
ext_info object 订单扩展信息
ext_info字段 必填 字段类型 说明
product_info object 物品相关信息
express_info object 快递信息
promotion_info object 订单优惠信息
brand_info object 商家信息
invoice_info object 发票信息,对于开发票订单,该字段必填
payment_method uint32 订单支付方式,0:未知方式 1:微信支付 2:其他支付方式
user_open_id string 用户的openid,参见openid说明
order_detail_page object 订单详情页(小程序页面)
total_fee uint32 订单物品合计金额(优惠前金额,不填写的话,平台默认用物品的total fee累加)
follow_buy_info object 商品来源凭据
product_info字段 必填 字段类型 说明
item_list array 包含订单中所有物品的信息
item_list字段 必填 字段类型 说明
item_code string 物品ID(SPU ID),要求appid下全局唯一
sku_id string sku_id
amount uint32 物品数量
total_fee uint32 物品总价,单位:分
thumb_url string 物品图片,图片宽度必须大于750px,宽高比建议4:3 - 1:1之间
title string 物品名称
desc string 物品详细描述
unit_price uint32 物品单价(实际售价),单位:分
original_price uint32 物品原价,单位:分
stock_attr_info array 物品属性列表
category_list array 物品类目列表
item_detail_page object 物品详情页(小程序页面)
can_be_search bool 物品能否被搜索(默认true可以被搜索)
bar_code_info object 物品的条形码信息
platform_category_list array 物品平台类目列表,填写的每个类目必须在物品类目表列出,多级类目只填最后一级(如完整类目为"运动户外-运动服饰-运动裤",只需要填"运动裤"的类目ID与类目名)
poi_list字段 选填 字段类型 说明
longitude double 门店的经度,WGS84标准
latitude double 门店的纬度,WGS84标准
radius double 门店可送达半径,单位km
business_name string 门店名称(仅为商户名,如:国美、麦当劳,不应包含地区、地址、分店名等信息,错误示例:北京国美),20个字符以内
branch_name string 分店名称(不应包含地区信息,不应与门店名有重复,错误示例:北京王府井店),20个字符以内
address string 门店地址(不包含省市区信息,如:新港中路123号)
stock_attr_info字段 必填 字段类型 说明
attr_name object 属性名
attr_value object 属性值
attr_name字段 必填 字段类型 说明
name string 属性名称
attr_value字段 必填 字段类型 说明
name string 属性值
item_detail_page字段(以下二选一) 必填 字段类型 说明
path string 小程序物品详情页跳转链接
src_h5_path string h5物品详情页跳转链接
platform_category_list字段 必填 字段类型 说明
category_id uint32 平台类目ID
category_name string 平台类目名称
express_info字段 必填 字段类型 说明
name string 收件人姓名
phone string 收件人联系电话
address string 收件人地址
price uint32 运费,单位:分
national_code string 行政区划代码
country string 国家
province string 省份
city string 城市
district string
express_package_info_list array 包裹中的物品信息
express_package_info_list字段 必填 字段类型 说明
express_company_id uint32 快递公司编号,参见快递公司信息
express_company_name string 快递公司名
express_code string 快递单号
ship_time uint32 发货时间,unix时间戳
express_page object 快递详情页(小程序页面)
express_goods_info_list array 包裹物品信息
express_page字段(以下二选一) 必填 字段类型 说明
path string 小程序快递详情页跳转链接
src_h5_path string h5快递详情页跳转链接
express_goods_info_list字段 必填 字段类型 说明
item_code string 物品id
sku_id string sku_id
promotion_info字段 必填 字段类型 说明
discount_fee uint32 优惠金额
invoice_info字段 必填 字段类型 说明
type uint32 抬头类型,0:单位,1:个人
title string 发票抬头
tax_number string 发票税号
company_address string 单位地址
telephone string 手机号码
bank_name string 银行名称
bank_account string 银行账号
invoice_detail_page object 发票详情页(小程序页面)
brand_info字段 必填 字段类型 说明
phone string 用于售后场景的商家联系电话,便于用户咨询和问题解决
contact_detail_page object 联系商家页面
logo string 商家logo,不填的话,默认取小程序头像
name string 商家名称,不填的话,默认取小程序名字
id string 商家id,不填的话,默认取商家名称
invoice_detail_page字段(以下二选一) 必填 字段类型 说明
path string 小程序发票详情页跳转链接
src_h5_path string h5发票详情页跳转链接
order_detail_page字段(以下二选一) 必填 字段类型 说明
path string 小程序订单详情页跳转链接
src_h5_path string h5订单详情页跳转链接
contact_detail_page字段 必填 字段类型 说明
kf_type int 在线客服类型 1 没有在线客服; 2 微信客服消息; 3 小程序自有客服; 4 公众号h5自有客服
path string 小程序自有客服页面路径,kf_type为3时必填
src_h5_path string 公众号h5自有客服页面路径,kf_type为4时必填
bar_code_info字段 必填 字段类型 说明
barcode_type string 条形码类型, 目前支持"ean8", "ean13", 前者对应的barcode为8位纯数字字符串,后者为13位纯数字字符串
barcode string 条形码数字字符串
follow_buy_info字段 必填 字段类型 说明
wxapp_fb_key string 商品来源凭据

回包数据样例

接口调用成功回包
{
    "errcode":0,
    "errmsg":"success",
    "follow_buy_check_list": [
      {
        "order_id": "AQAATGagQ7KQCxMJEj7kHuUjTxxx",
        "recommend_openid": "oPuQe5Qqmh141RF-SATE"
      },
      {
        "order_id": "AQAATGagQ7KQCxMJEj7kHuUjTxxx",
        "errmsg": "wxapp_fb_key错误"
      }
    ]
}
接口调用失败回包
{
    "errcode": 9019101,
    "errmsg":"订单数量超过限制",
    "follow_buy_check_list": [
      {
        "order_id": "AQAATGagQ7KQCxMJEj7kHuUjTxxx",
        "errmsg": "wxapp_fb_key校验错误"
      }
    ]
}
回包字段 类型 说明
errcode int32 错误码
errmsg string 错误信息
fail_order_list object 失败订单信息
follow_buy_check_list object 商品来源凭据校验结果
fail_order_list字段 类型 说明
order_id string 失败订单ID
error_code int32 订单错误码
msg string 错误提示
follow_buy_check_list字段 类型 说明
order_id string 订单ID
recommend_openid string 商品推荐者openid
errmsg string 错误提示

接口错误码

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