API文档中心
开发文档
API文档
店铺服务
订单管理
转单售后
消息服务
字典服务
公共参数
请求地址(仅支持HTTP POST请求方式)
环境 | 请求地址 |
---|---|
正式环境 | //api.zhuandan.com/api/order.concise.pushNew |
注意:使用简化接口发布订单因使用地址信息,系统匹配省市区信息可能存在异常情况,建议使用发布转单接口提交完整的订单信息下单
系统参数说明:
参数名 | 参数类型 | 参数描述 | 示例值 |
---|---|---|---|
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 抢单,2 报价单,传入指定配送门店时,订单类型为:指定下单 | |
out_order_sn | long | 必选 | 商家订单编号2~20位 | |
delivery_type | int | 必选 | 订单配送方式:1 快递配送,2:送货上门 | |
toStoreName | String | 可选 | 指定的配送店铺,店主手机号,可为空,留空或不传表示抢单模式派发 | |
deadline | String | 必选 | 抢单截止时间,抢单模式创建订单时必选 | |
buyer_name | String | 可选 | 订货人姓名 | |
buyer_mobile | String | 可选 | 订货人手机号码 | |
buyer_phone | String | 可选 | 订货人其它电话号码 | |
delivery_date | String | 必选 | 配送日期,送货上门时必选 | |
delivery_time_type | String | 可选 | 配送时间字典ID(可通过获取配送时间字典接口获取值,当为自定义配送时间时delivery_time值为必选) | |
delivery_time | String | 可选 | 详细的配送时间要求 | |
consignee | String | 必选 | 收货人姓名 | |
mobile | String | 必选 | 收货人电话 | |
address | String | 必选 | 收货人详细联系地址 | |
delivery_geo | String | 必传 | 收货地址经纬度坐标(高德系) | |
order_amount | double | 必选 | 订单发单价格,单位:人民币元 | |
card_con | String | 可选 | 贺卡内容,至多200字 | |
order_remarks | String | 可选 | 订单备注信息,至多200字 | |
material | String | 必选 | 商品描述,至多400字 | |
quantity | int | 必选 | 商品数量 | |
sample_pic | String | 必选 | 商品图地址(只支持一张商品图) | |
goods_type | String | 可选 | 商品类型,固定值范围:cake(蛋糕),flower(鲜花),combination(鲜花+蛋糕),other(其他),已作废 | |
product_type | int | 必须 | 订单类型:0 其它,1 鲜花,2 蛋糕, 3 鲜花+蛋糕,默认:其它订单 | |
physical_audit | int | 可选 | 是否需要实物照审核:0 不需要, 1 需要 | |
create_user_id | int | 可选 | 转单宝子账号ID或主账号ID,开启转单展示子账户电话时,订单将展示该ID电话 |
成功响应示例
{
"code": 200,
"result": {
"store_name": "拾光里测试花店",
"order_sn": "20200330317269531"
}
}
失败响应示例
{
"message": "商家订单编号[out_order_sn]不可缺",
"code": 403
}