公共参数
请求地址(仅支持HTTP POST请求方式)
| 环境 |
请求地址 |
| 正式环境 |
//api.zhuandan.com/v1/Orders/importOrder |
系统参数说明:
| 参数名 |
参数类型 |
参数描述 |
示例值 |
| app_key |
String(32) |
应用的app key |
adc7a8960911564e89ce69fd92546aaa |
| access_token |
String(32) |
获取到的应用授权 |
adc7a8960911564e89ce69fd92546aaa |
| timestamp |
String(10) |
当前请求时间戳 |
1401935833(允许时差±5分钟,单位秒) |
| sig |
String(32) |
接口请求签名 |
adc7a8960911564e89ce69fd92546aaa |
API接口参数说明
| 参数 |
类型 |
必选? |
示例 |
描述 |
| order_sn |
long |
必选 |
2318382138218321 |
商家订单编号2~20位 |
| shop_name |
int |
可选 |
2 |
来源店铺名称 |
| delivery_type |
int |
必选 |
2 |
订单配送方式:1 快递配送,2:送货上门 |
| create_time |
long |
必选 |
1234567890 |
订单创建时间,时间戳 |
| order_wares |
json |
必选 |
[{...}] |
订单商品信息,单个订单至多支持5种不同商品 |
| └ item_name |
string |
可选 |
简要的商品名 |
商品名称 |
| └ item_remarks |
string |
必选 |
详细描述商品信息 |
商品详细组成描述信息 |
| └ item_total |
int |
必选 |
1 |
商品总的件数 |
| └ item_img |
|
必选 |
|
商品图片信息,单个商品最多支持三张图片信息 |
| └ 0 |
string |
必选 |
//img.abc.com/aaa.jpg |
完整的图片地址信息 |
| └ 1 |
string |
可选 |
//img.abc.com/aaa.jpg |
完整的图片地址信息 |
| └ 2 |
string |
可选 |
//img.abc.com/aaa.jpg |
完整的图片地址信息 |
| delivery_date |
string |
必选 |
2017-05-20 |
配送日期,送货上门时必选 |
| delivery_time_type |
string |
可选 |
6 |
配送时间字典ID(可通过获取配送时间字典接口获取值,当为自定义配送时间时delivery_time值为必选) |
| delivery_time |
string |
可选 |
09:20 |
详细的配送时间要求 |
| consignee |
string |
必选 |
李三 |
收货人姓名 |
| mobile |
string |
必选 |
13800138000 |
收货人手机号 |
| phone |
string |
可选 |
13800138000 |
收货人电话 |
| province |
string |
必选 |
110000 |
收货人所在省/直辖市 |
| city |
string |
必选 |
110100 |
收货人所在城市 |
| county |
string |
可选 |
110101 |
收货人所在地区 |
| address |
string |
必选 |
四川省成都市武侯区XX街道XX路XX号 |
收货人详细联系地址 |
| delivery_geo |
string |
可选 |
113.257858,22.850400 |
配送目的地经纬度坐标(高德系经纬度坐标) |
| order_amount |
double |
必选 |
90.00 |
订单发单价格,单位:人民币元 |
| pay_status |
int |
必选 |
1 |
订单支付状态,0未支付,1已支付 |
| card_con |
string |
可选 |
|
贺卡内容,至多200字 |
| order_remarks |
string |
可选 |
|
订单备注信息,至多200字 |
| product_type |
int |
可选 |
0 |
订单类型:0 其他,1 鲜花,2 蛋糕,3 鲜花+蛋糕,默认其他 |
响应结构体
| 名称 |
类型 |
示例 |
描述 |
| order_sn |
long |
20170520123456 |
订单编号 |
响应示例
{
"code":200,
"result":{
"order_sn":20170520123456
},
"error":""
}