API文档中心
开发文档
API文档
店铺服务
订单管理
转单售后
消息服务
字典服务
公共参数
请求地址(仅支持HTTP POST请求方式)
环境 | 请求地址 |
---|---|
正式环境 | //api.zhuandan.com/v1/Orders/pushNewOrder |
系统参数说明:
参数名 | 参数类型 | 参数描述 | 示例值 |
---|---|---|---|
app_key | String(32) | 应用的app key | adc7a8960911564e89ce69fd92546aaa |
access_token | String(32) | 获取到的应用授权 | adc7a8960911564e89ce69fd92546aaa |
timestamp | String(10) | 当前请求时间戳 | 1401935833(允许时差±5分钟,单位秒) |
sig | String(32) | 接口请求签名 | adc7a8960911564e89ce69fd92546aaa |
API接口参数说明
参数 | 类型 | 必选? | 示例 | 描述 |
---|---|---|---|---|
order_type | int | 必须 | 1 | 订单类型:1 抢单, 2 报价单,当指定配送门店时,改订单类型值不可用,订单变为:指定订单 |
out_order_sn | long | 必选 | 2318382138218321 | 商家订单编号2~20位 |
delivery_type | int | 必选 | 2 | 订单配送方式:1 快递配送,2:送货上门 |
toStoreName | String | 可选 | 13800138000 | 指定的配送店铺,店主手机号,可为空,留空或不传表示抢单模式派发 |
deadline | string | 必选 | 2017-05-20 12:20 | 抢单截止时间,抢单模式创建订单时必选 |
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 | 详细的配送时间要求,时间段要求:可传入:09:20 - 09:40 |
send_time | string | 可选 | 09:20 | 最早期望送达时间,格式:HH:II,仅时间,与delivery_time同效 |
latest_send_time | string | 可选 | 10:10 | 最晚期望送达时间,格式:HH:II,仅时间,与delivery_time同效 |
consignee | string | 必选 | 李三 | 收货人姓名 |
mobile | 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 | 订单发单价格,单位:人民币元 |
card_con | string | 可选 | 贺卡内容,至多200字 | |
order_remarks | string | 可选 | 订单备注信息,至多200字 | |
product_type | int | 可选 | 1 | 订单类型:0 其它,1 鲜花, 2 蛋糕,3 鲜花+蛋糕 |
physical_audit | int | 可选 | 0 | 是否需要实物照审核:0 不需要,1 需要 |
create_user_id | int | 可选 | 10086 | 转单宝子账号ID或主账号ID,开启转单展示子账户电话时,订单将展示该ID电话 |
响应结构体
名称 | 类型 | 示例 | 描述 |
---|---|---|---|
order_sn | long | 20170520123456 | 订单编号 |
{
"code":200,
"result":{
"order_sn":20170520123456
},
"error":""
}