网店接入API文档

网单管家

转单宝首页网单管家接入指南 API文档

免费接入网单管理

API文档中心

开发文档

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

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

参数名称	参数类型	是否必须	参数描述
source_shop_id	int	否	下单的转单宝门店ID，不传或传入错误门店ID，系统将采用账户下默认的门店作为下单门店
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
}