导入订单
开发者可以在用户支付完成后,同步小程序/H5/APP订单数据至微信圈子(H5/APP订单需保证调用支付接口的H5/APP与导入数据的小程序绑定在同一个微信开放平台帐号下)。
历史订单导入:在首次接入时,开发者可以导入最近三个月的”历史订单“数据,导入数据有助于物品在搜索中获得更好的曝光,帮助新接入的商家在搜索中实现冷启动。
接口说明:
请求数据样例
示例代码
{
"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 | 订单参数错误 |