导入订单
开发者可以在用户支付完成后,同步小程序/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": {
"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
}
}
}
]
}
添加订单参数列表
订单基本字段 | 必填 | 字段类型 | 说明 |
---|
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累加) |
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 | 快递公司id |
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 | 商家名称,不填的话,默认取小程序名字 |
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 | 条形码数字字符串 |
回包数据样例
接口调用成功回包
{
"errcode":0,
"errmsg":"success"
}
接口调用失败回包
{
"errcode": 9019101,
"errmsg":"订单数量超过限制"
}
回包字段 | 类型 | 说明 |
---|
errcode | int32 | 错误码 |
errmsg | string | 错误信息 |
fail_order_list | object | 失败订单信息 |
fail_order_list字段 | 类型 | 说明 |
---|
order_id | string | 失败订单ID |
error_code | int32 | 订单错误码 |
msg | string | 错误提示 |
接口错误码
回包错误码 | 说明 |
---|
0 | 成功 |
9009099 | 系统错误 |
9009098 | 请求参数错误,详细错误提示请参考json回包中的errmsg字段。 |
9009400 | 订单数量超过限制 |
其他常见错误码 | 点击查看 |