基础清单接口文档
/station/order/customer/search 搜索商户
接口名：/station/order/customer/search
Method : GET
请求参数：
search_text M string 搜索内容，支持三种格式，纯数字的sid、带S0开头的sid、商户名称
offset O int 分页offset
limit O int 分页limit
响应：
code M int 返回码，0表示成功，其他表示错误
msg M string 错误信息
data M dict 返回json数据
示例
request
http://station.guanmai.cn/station/order/customer/search?search_text=999&offset=0&limit=10
response
{
"code": 0,
"msg": "ok",
"data": {
"pagination": {
"limit": 10,
"offset": 0,
"count": 14
},
"list": [
{
"lng": 0,
"finance_status": 0,
"resname": "产品技术测试1",
"service_station_id": "T002",
"receiver_phone": "12345678965",
"address_sign_id": 30100100000,
"receiver_name": "希捷1",
"address": "产品技术测试1",
"lat": 0,
"map_address": null,
"address_id": 3386,
"keycustomer": 0,
"id": 6384
},
]
}
}
/station/order/service_time 拉取商户服务时间
接口名：/station/order/service_time
Method：GET
请求：
address_id M int 商户ID
响应：
code M int 返回码，0表示成功，其他表示错误
msg M string 错误信息
示例：
request
http://station.guanmai.cn/station/order/service_time?address_id=999
response
{
"code": 0,
"msg": "ok",
"data": [
{
"receive_time_limit": {
"receiveTimeSpan": "30",
"start": "06:00",
"s_span_time": 6,
"end": "23:30",
"e_span_time": 6
},
"name": "小农女默认服务时间",
"service_time_creator": "T001",
"task_begin_time": "06:00",
"_id": "ST001",
"desc": "小农女默认服务时间",
"receive_time": {
"defaultSpanEndFlag": 1,
"defaultSpanStartFlag": 1,
"defaultEnd": "07:30",
"defaultStart": "07:00"
},
"final_distribute_time": "06:00",
"type": 0,
"final_distribute_time_span": 1,
"order_time_limit": {
"start": "06:00",
"end": "02:00",
"e_span_time": 1
}
}
]
}
/station/skus/addr 搜索商品
接口名：/station/skus/addr
Method：GET
请求：
address_id M int 商户ID
search_text M string 商品sku_id或者商品名称
time_config_id M string 时间配置ID
fetch_category O int 0-表示不拉取分类；1-表示拉取分类；
active O int 0-表示拉取全部状态商品；1-表示只拉取有效的商品；
offset O int 分页offset
limit O int 分页limit
响应：
code M int 返回码，0表示成功，其他表示错误
msg M string 错误信息
示例：
request
http://station.guanmai.cn/station/skus/addr?address_id=6191&offset=0&limit=10&search_text=上海青&fetch_category=1&active=1&time_config_id=ST001
response
{
"code": 0,
"msg": "ok",
"data": [
{
"name": "上海青|中条|优质|件",
"desc": "云南产，棵底直径约为3-4cm，泡沫箱装，净重35斤/件。",
"spu_id": "C00035",
"category_title_1": "蔬菜",
"supplier_name": "小农女",
"unit_price": 3.88,
"std_unit_name": "斤",
"state": 1,
"id": "D804813",
"spu_remark": "",
"category_id_2": "B101",
"sale_price": 174.6,
"category_id_1": "A101",
"sync_origin_id": "D804813",
"category_title_2": "叶菜类",
"sale_ratio": 45,
"sale_num_least": 1,
"salemenu_id": "S0520",
"is_weigh": true,
"station_id": "T002",
"sale_unit_name": "件"
},
]
}
/station/check_unpay 检查商户是否欠款
接口名：/station/check_unpay
Method：GET
请求：
address_id M int 商户SID
响应：
code M int 返回码，0表示成功，其他表示错误
msg M string 错误信息
data M null 无数据
示例：
request
http://station.guanmai.cn/station/check_unpay?address_id=999
response
{
"code": 1,
"msg": "☆该商户还有 2笔订单 共计 353.85元应付账款未结清;\n\n暂无法下单,sorry!!",
"data": null
}
/station/order/create 下单
接口名：/station/order/create
Method：GET
请求：
details M string 商品相关的json数据
address_id M int 商户SID
uid M int 商户UID
receive_begin_time M string 订单收货开始时间
receive_end_time M string 订单收货结束时间
time_config_id string 时间配置ID
force O int 是否强制合单标志，0-不合单，新建一个订单；1-强制合单；
remark O str 订单备注
响应：
code M int 返回码，0表示成功，其他表示错误
msg M string 错误信息
data M dict 新建的订单ID或者更改的订单ID数据
示例：
request
http://station.guanmai.cn/station/order/create
POST参数：
details: [{"sku_id":"D804813","amount":1,"unit_price":123,"spu_remark":"666","spu_id":"C00035"}]
address_id: 20508
uid: 25512
receive_begin_time: 2016-10-16 06:00
receive_end_time: 2016-10-16 23:30
time_config_id: ST001
response
{
"data": {
"exceed_order_time_ids": [],
"not_enough_inventories": [],
"update_order_ids": [],
"error_sku_ids": [],
"new_order_ids": ["PL316101"],
"detail_url": "/station/order/edit/PL316101"
},
"msg": "ok",
"code": 0
}
/station/order/edit/{{order_id}} 拉取订单详情
接口名：/station/order/edit/{{order_id}}
Method：GET
请求：
order_id M string 订单ID
响应：
code M int 返回码，0表示成功，其他表示错误
msg M string 错误信息
data M dict 订单详情数据，数据字段为订单表字段；
示例：
request
http://station.guanmai.cn/station/order/edit/PL12345
response
{
"code": 0,
"data": {
"source_order_ids": [],
"freight": 2000,
"time_config_id": "ST001",
"customer": {
"receiver_phone": "18682285748",
"address": "小梅沙 海琴路23号 (师傅尽量在10点过后去 不要太早，谢谢)",
"uid": "16934",
"receive_end_time": "2016-10-16 23:30",
"address_id": "8219",
"receiver_name": "邓生",
"extender": {
"resname": "正宗粉面馆",
"order_pay_method": 2
},
"address_sign_id": "30700100000",
"receive_begin_time": "2016-10-16 06:00",
"supply_station_id": "T002"
},
"status": 1,
"origin_total_price": 17460,
"_abnormal_lock": "no",
"_id": "PL316101",
"salemenu_ids": [
"S0520"
],
"total_pay": 14300,
"details": [
{
"spu_id": "C00035",
"category_title_2": "叶菜类",
"accept_quantity": 1,
"version": 311,
"name": "上海青|中条|优质|件",
"quantity": 1,
"sync_origin": "D804813",
"sale_ratio": 45,
"real_item_price": 12300,
"sale_unit_name": "件",
"total_item_price": 12300,
"category_title_1": "蔬菜",
"std_unit_name": "斤",
"id": "D804813",
"real_quantity": 1,
"supplier_name": "小农女",
"total_item_pay": 12300,
"sale_num_least": 1,
"purchase_quantity": 1,
"origins": [],
"spu_remark": "test",
"salemenu_id": "S0520",
"sale_price": 123,
"last_in_stock_price": {
"earlier": [
{
"price": 600,
"purchase_supplier_id": "T37433",
"purchase_supplier_name": "sdgasdga",
"is_priority": true # 优先供应商
}
],
"newest: {
"price": 0,
"purchase_supplier_id": "T34874",
"purchase_supplier_name": "蒙牛牛奶报价"
}
},
}
],
"_lock": "no",
"fake_total_price": 17460,
"time_config_info": {
"_id": "ST001",
"desc": "小农女默认服务时间",
"final_distribute_time": "06:00",
"order_time_limit": {
"end": "02:00",
"start": "06:00",
"e_span_time": 1
},
"type": 0,
"task_begin_time": "06:00",
"final_distribute_time_span": 1,
"receive_time_limit": {
"end": "23:30",
"receiveTimeSpan": "30",
"start": "06:00",
"s_span_time": 6,
"e_span_time": 6
},
"service_time_creator": "T001",
"name": "小农女默认服务时间"
},
"district_code": "440300",
"sort_id": 0,
"date_time": "2016-10-10T12:01:52.789",
"is_aggregation": 0,
"station_id": "T002",
"remark": null,
"real_price": 17460,
"total_price": 12300
},
"msg": "ok"
}
/station/order/edit/{{order_id}} 修改订单商品、收货时间
接口名：/station/order/edit/{{order_id}}
Method：GET
请求：
order_id M string 订单ID
details M list[dict] 商品数据
order_data M dict 订单的收货时间
响应：
code M int 返回码，0表示成功，其他表示错误
msg M string 错误信息
data M dict 订单详情数据，数据字段为订单表字段；
示例：
request:
http://station.guanmai.cn/station/order/edit/PL316101
POST参数：
order_id：PL316101
details：[{"sku_id":"D804813","amount":2,"unit_price":"10","spu_remark":"update","spu_id":"C00035"}]
order_data: {"receive_begin_time":"2016-10-16 06:00","receive_end_time":"2016-10-16 23:30"}
response:
{
"code": 0,
"data": {"order_id": "PL316101"},
"msg": "ok"
}
/station/orders 拉取订单列表
接口名：/station/orders
Method：GET
请求：
query_type M int 搜索类型 [1: 按照下单时间搜索，2: 按照运营周期搜索，3: 按照收货日期搜索]
if query_type == 1
start_date M string 开始下单日期(精确到天)
end_date M string 截止下单日期(精确到天)
if query_type == 2
time_config_id M string 时间配置ID
cycle_start_time M string 开始周期时间(精确到分钟)
cycle_end_time M string 结束周期时间(精确到分钟)
if query_type == 3
receive_start_date M string 开始收货日期(精确到天)
receive_end_date M string 结束收货日期(精确到天)
search_text M string 搜索内容
sort_type O string 排序类型(date_desc日期倒序(默认);date_asc日期升序;price_desc价格倒序;price_asc价格升序)
status O int 订单状态
offset O int 分页offset
limit O int 分页limit
响应：
code M int 返回码，0表示成功，其他表示错误
msg M string 错误信息
data M list 订单列表数据，数据字段为订单表字段；
示例：
request:
http://station.dev.guanmai.cn/station/orders?query_type=1&start_date=2017-05-01&end_date=2017-05-07&search_text=&offset=0&limit=20
http://station.dev.guanmai.cn/station/orders?query_type=2&time_config_id=ST001&cycle_start_time=2017-05-01+06%3A00&cycle_end_time=2017-05-07+23%3A00&search_text=&offset=0&limit=20
http://station.dev.guanmai.cn/station/orders?query_type=3&receive_start_date=2017-05-01&receive_end_date=2017-05-07&search_text=&offset=0&limit=20
response：
{
"code": 0,
"data": {
"pagination": {
"offset": 0,
"count": 8,
"limit": 20
},
"list": [
{
"driver_id": 『新增』,
"driver_name": 『新增』,
"freight": 20,
"details": [
{
"sync_origin_id": "D805892",
"spu_id": "C00935",
"total_item_pay": 25.76,
"accept_quantity": 7,
"version": 55,
"quantity": 7,
"spu_remark": "",
"real_item_price": 25.76,
"total_item_price": 25.76,
"sale_price": 3.68,
"id": "D805892",
"real_quantity": 7
}
],
"time_config_info": {
"_id": "ST001",
"desc": "小农女默认服务时间",
"final_distribute_time": "06:00",
"order_time_limit": {
"end": "02:00",
"start": "06:00",
"e_span_time": 1
},
"type": 0,
"task_begin_time": "06:00",
"final_distribute_time_span": 1,
"receive_time_limit": {
"end": "23:30",
"receiveTimeSpan": "30",
"start": "06:00",
"s_span_time": 6,
"e_span_time": 6
},
"service_time_creator": "T001",
"name": "小农女默认服务时间"
},
"customer": {
"receiver_phone": "产品技术测试1111111",
"address": "产品技术测试1111111",
"station_id": "",
"new_consumer": 0,
"address_id": "10936",
"salemenu_id": "",
"receiver_name": "产品技术测试1111111",
"extender": {
"resname": "产品技术测试1111111"
},
"id": "22953"
},
"receive_end_time": "2016-10-16 23:30",
"status": 1,
"origin_total_price": 25.76,
"date_time": 1476065329.588,
"receive_begin_time": "2016-10-16 06:00",
"station_id": "T002",
"id": "PL316094",
"date_time_str": "2016-10-10 10:08:49",
"total_price": 25.76
},
]
},
"msg": "ok"
}
/station/order/set_status 批量修改订单状态
接口名：/station/order/set_status
Method：POST
请求：
order_ids M string 订单ID，多个使用,分隔；
status M int 新的订单状态
响应：
code M int 返回码，0表示成功，其他表示错误
msg M string 错误信息
data M dict data包含一个count字段，表示修改成功的数量；
示例：
request:
http://station.guanmai.cn/station/order/set_status
POST参数：
order_ids：PL316101,PL316099
status：5
response:
{
"code": 0,
"data": {
"count": 2
},
"msg": "ok"
}
/station/order/delete 删除订单
接口名：/station/order/delete
Method：POST
请求：
order_id M string 订单ID；
响应：
code M int 返回码，0表示成功，其他表示错误
msg M string 错误信息
data M null 无数据；
示例：
request:
http://station.guanmai.cn/station/order/delete
POST参数：
order_id：PL316099
response:
{
"code": 0,
"data": null,
"msg": "ok"
}
/station/order/remove/details 删除订单商品
接口名：/station/order/remove/details
Method：POST
请求：
order_id M string 订单ID；
order_detail_ids M string 要删除的商品SKU ID，多个使用,分隔；
响应：
code M int 返回码，0表示成功，其他表示错误
msg M string 错误信息
data M null 无数据；
示例：
request:
http://station.guanmai.cn/station/order/remove/details
POST参数：
order_id：PL316099
order_detail_ids：D805892
response：
{
"code": 0,
"data": null,
"msg": "ok"
}
/station/order/import 导出下单商品模板
接口名：/station/order/import
Method：GET
请求：
sid M int 商户ID；
time_config_id M string 时间配置ID；
响应：
下载一个excel文件
示例：
request:
http://station.guanmai.cn/station/order/import?sid=10936&time_config_id=ST001
/station/order/import 导入下单商品模板
接口名：/station/order/import
Method：POST
请求：
sid M int 商户ID；
file M file 商品模板excel；
响应：
code M int 返回码，0表示成功，其他表示错误
msg M string 错误信息
data M null 无数据；
示例：
request:
http://station.guanmai.cn/station/order/import
POST参数：
file：上传的商品模板文件；
sid：商户ID；
response：
{
"code": 0,
"data": [],
"msg": "ok"
}