API文档中心

开发文档

概念术语 获取access_token 计算签名 响应与限制 示例与SDK

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接口参数说明


参数 类型 必选? 示例 描述
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 详细的配送时间要求
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 鲜花+蛋糕

响应结构体


名称 类型 示例 描述
order_sn long 20170520123456 订单编号

 

{
 "code":200,
 "result":{
    "order_sn":20170520123456
   },
  "error":""
}

 

新手指南
咨询建议
在线客服