该接口用于活动订单发货，包含两个接口《订单通知发货接口》、《订单发货状态更新接口》。订单通知发货接口，用户在数据面板，点击发货时触发通知接口，推送发货订单信息。订单发货状态更新接口，调用该接口完成订单发货信息变更。
1.订单通知发货接口
开发说明
该接口由第三方开发者提供给人人秀调用，必须设置该接口地址。
开发者接收到参数，必须先将参数urldecode处理，然后计算签名
请求地址 | 由第三方平台提供 | |
请求方式 | POST | |
参数名称 | 是否必须 | 说明 |
app_key | 是 | 人人秀平台分配的AppKey |
time_stamp | 是 | 1970-01-01开始的时间戳，精确到毫秒 |
sign | 是 | 根据签名算法所得，如何计算签名 |
h5_guid | 是 | 活动唯一标识 |
activity_guid | 否 | 互动标识，互动玩法时有值 |
shipping_type | 是 | 发货类型：1:单个订单；2:批量订单 |
order_list | 是 | 待发货的订单列表信息，详情见orderl_list参数说明 |
返回JSON格式结果 Content-type: application/json | ||
{"result":0,"msg":"","data":{}} | ||
参数名称 | 说明 | |
result | 0表示成功，1表示失败 | |
msg | 失败时，返回的错误描述 | |
data | 详情见data参数说明 | |
order_list参数说明
参数名称 | 数据类型 | 说明 |
order_no | string(32) | 人人秀订单编号 |
order_state | int(11) | 订单状态枚举（ 1:待发货） |
order_total_amount | float(2) | 订单总金额，奖品类型为0，支付单位为元 |
openid | string(128) | 用户唯一授权标识 |
nickname | string(60) | 用户授权昵称 |
headimgurl | string(200) | 用户授权头像 |
create_time | datetime | 订单创建时间 |
product_info | obj | 订单商品详情，参看 product_info参数 |
receiver_name | string(20) | 收货人姓名 |
receiver_phone | string(20) | 收货人电话 |
receiver_adds | string(100) | 收货人地址，包含省市区详细地址 |
receiver_info | obj | 收货人信息，省、市、区、详细地址 |
user_info | obj | 报名信息，活动开启报名后参与时有值 |
activity_guid | string(32) | 互动GUID，通过互动产生的数据有值，商城商品无值 |
source_name | string(60) | 推广来源，活动从推广渠道访问时有值 |
product_info 参数说明
参数名称 | 数据类型 | 说明 |
product_id | string(30) | 商品ID |
product_name | string(60) | 商品名称 |
product_type | int(11) | 奖品/商品类型枚举：1：实物；7：自有商品；12：商品 |
product_sku | string(20) | 商品规格名称，仅商城商品多规格时有值 |
product_num | int(11) | 商品购买数量 |
product_price | float(2) | 商品金额（单价） |
product_image_url | string(200) | 商品图片地址 |
product_code | string(200) | 自有商品或商城商品编码，例如："123" |
product_source | string(200) | 商城商品来源标签，多个逗号分割，例如“标签1,标签2” |
receiver_info 参数说明
参数名称 | 数据类型 | 说明 |
province | string(100) | 收货地址，省份名 |
city | string(100) | 收货地址，城市名 |
district | string(100) | 收货地址，县或区名 |
address | string(100) | 收货地址，其他或门牌信息 |
user_info 参数说明
参数名称 | 数据类型 | 说明 |
id | int(11) | 数据ID |
title | string(100) | 数据标题 |
value | string(200) | 数据内容 |
data参数说明
参数名称 | 数据类型 | 说明 |
rows | obj | 发货成功订单列表，更新订单类型=1时，必传，详情见rows参数说明 |
update_type | tyint(2) | 更新订单类型，1：同步更新；2：异步更新（不同步更改发货状态，后续自己通过《订单发货状态更新接口》异步更新） |
rows 参数说明
参数名称 | 数据类型 | 说明 |
order_no | string(32) | 人人秀订单号 |
express_name | string(60) | 发货快递公司名称，例如：顺丰快递 |
express_no | string(60) | 发货快递单号，例如：SF10001 |
is_success | tyint2) | 是否发货成功，0：成功；1：失败 |
msg | string(200) | 失败文案 |
请求参数示例
{
"app_key": "96c84928b1dce057d110ea3b3880fc83",
"time_stamp":"1543999047492",
"sign ":"051BF3517D40AB9D7D6B45EF6E4EB7F9",
"h5_guid":"123456",
"activity_guid": "",
"shipping_type": 1,
"order_list ":[{
"order_no": "TP1543999047492",
"order_total_amount": 0.1,
"openid ": "gb_1543999047492",
"nickname": "小张子",
"headimgurl": "https://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4TMaE…zXTfZQugNBA/132",
"create_time": "2099-09-10 09:10:00",
"product_info": [{
"product_id": "10001",
"product_name": "商品1",
"product_image_url": "https://qn-file.rrxiu.net/prize_icon_v2.png",
"product_type": 13,
"product_num": 1,
"product_price": 0.1,
}],
"receiver_name": "张三",
"receiver_phone": "15800001111",
"receiver_adds": "北京市朝阳区幸福大厦101",
"source_name": "百度",
}]
}
返回值示例， json格式 Content-type: application/json
{
"result": 0,
"data": {
"update_type": 1,
"rows": [{
"order_no": "TP1543999047492",
"express_name": "顺风快递",
"express_no": "SF10001",
"is_success": 1,
"msg": "",
}]
},
"msg": "ok"
}
2.订单发货状态更新接口
开发注意：
该接口由人人秀提供给第三方开发者调用，第三方开发者调用该接口完成订单发货更新
每次请用都需要重新生成签名，否则会提示签名过期
请求地址 | https://open.rrx.cn/api/v1/order/shipping | |
请求方式 | POST 方式 Content-type：application/x-www-form-urlencoded | |
参数说明 | ||
参数名称 | 是否必须 | 说明 |
app_key | 是 | 人人秀平台分配的AppKey |
time_stamp | 是 | 1970-01-01开始的时间戳，精确到毫秒 |
sign | 是 | 根据签名算法计算所得，如何计算签名 |
shipping_list | 是 | 订单发货更新列表 详情见shipping_list参数说明 |
响应参数 | ||
参数 | 是否必须 | 参数说明 |
result | 是 | 0：成功 1：失败 |
msg | 否 | result为1时，返回错误原因 |
| fail_list | 否 | result为0时，如果部分订单错误则有值 |
响应示例返回JSON格式结果。 | ||
成功 | {"result":0,"msg":"ok",fail_list:[]} | |
失败 | {"result":1,"msg":"签名错误"} | |
shopping_list 参数说明
参数名称 | 数据类型 | 说明 |
order_no | string(32) | 人人秀订单号 |
express_no | string(60) | 快递发货单号 |
express_name | string(60) | 快递公司名称 |
fail_list 参数说明
参数名称 | 数据类型 | 说明 |
order_no | string(32) | 人人秀订单号 |
error_msg | string(100) | 错误原因 |
请求参数示例
{
"app_key": "96c84928b1dce057d110ea3b3880fc83",
"time_stamp":"1543999047492",
"sign ":"051BF3517D40AB9D7D6B45EF6E4EB7F9",
"shipping_list":[{
"order_no": "TP1543999047492",
"express_name": "顺风快递",
"express_no": "SF10001",
}]
}
返回值示例， json格式 Content-type: application/json
{
"result": 0,
"msg": "ok"
}
枚举值
express_name，快递公司枚举值：顺风快递、顺风快运、其他。
活动支持说明
1.支持开启抽奖类活动，仅活动奖品支持快递发货的奖品，如实物奖；
2.支持电商类活动玩法，仅支持添加活动商品，如拼团、秒杀；
3.支持搭建商城玩法，商品购买、兑换订单；
