观麦openapi文档
以下是观麦对外开放的所有接口。
不同客户因为协议原因可使用的接口会有所不同，具体需要咨询对应的商务接口人员。
接入指引
- 向观麦对接人员获取开放平台access_id和secret
- 调用获取授权码接口，获取access_token
- 将access_token固定作为get请求的参数，调用业务接口
授权
获取授权
openapi/auth/access_token
描述
使用本平台提供的secret和access_id,换取安全传输的校验身份access_token，过期时间是1个小时，每个接口都要传输access_token。
请求参数
| 参数名 | 类型 | 必选M/可选O | 描述 |
|---|---|---|---|
| access_id | string | M | 由观麦提供 |
| secret | string | M | 由观麦提供 |
返回数据
{
"msg": "ok",
"data": {
"access_token": "swbtoen3ir2snmcabgyq5vaaa5ep42xs",
"expire_time" : "2017-07-01 12:23:32" # 这个时间过期
},
"code": 0
}
商品
商品一级分类
openapi/merchandise/category1/list
请求方法
GET
请求参数
无
返回数据
{
"msg": "ok",
"code": 0,
"data": [{
"id": "A3772", # 一级分类id
"name": "蔬菜", # 名称
}, {
"id": "A3773",
"name": "蛋类",
}, {
"id": "A3774",
"name": "鱼类",
}]
}
请求示例
https://station.guanmai.cn/openapi/category1/list?access_token=dcvvu02xr9k1mqidfi2k4s3mxv33us6i
商品二级分类
openapi/merchandise/category2/list
请求方法
GET
请求参数
| 参数名 | 类型 | 必选M/可选O | 描述 |
|---|---|---|---|
| category_id_1 | string | O | 一级分类id |
返回数据
{
"msg": "ok",
"code": 0,
"data": [{
"category_id_1": "A3772", # 一级分类id
"id": "B18242", # 二级分类
"name": "叶菜"
}, {
"category_id_1": "A3773",
"id": "B18243",
"name": "家禽",
}]
}
请求示例
https://station.guanmai.cn/openapi/category2/list?access_token=dcvvu02xr9k1mqidfi2k4s3mxv33us6i
商品spu
openapi/merchandise/spu/get
请求方法
GET
请求参数
| 参数名 | 类型 | 必选M/可选O | 描述 |
|---|---|---|---|
| spu_id | string | M | 商品id |
返回数据
{
"msg": "ok",
"code": 0,
"data": {
"desc": "ggggg", # 备注
"name": "小白菜", # 名称
"p_type": 0, # 1：通用 2：私有
"std_unit_name": "斤", # 基本单位
"id": "C841153",
"category_id_1": "A101", # 一级分类id
"category_id_2": "B101", # 二级分类id,
"detail_images": [ # 商品详情图片
"htps://img.guanmai.cn/product_pic/abcdefg.png"
],
"image": "https://img.guanmai.cn/product_pic/abcdefg.gif", # 商品图片
"alias": ["娃娃菜11"], # 别名列表
"dispatch_method": 1 # 投框方式 1 按订单投框 2 按司机投框
}
}
请求示例
https://station.guanmai.cn/openapi/spu/get?access_token=dcvvu02xr9k1mqidfi2k4s3mxv33us6i
商品spu列表
openapi/merchandise/spu/list
请求方法
GET
请求参数
| 参数名 | 类型 | 必选M/可选O | 描述 |
|---|---|---|---|
| category_id_1 | string | O | 一级分类id |
| category_id_2 | string | O | 二级分类id |
返回参数
{
"msg": "ok",
"code": 0,
"data": [{
"desc": "ggggg", # 备注
"name": "小白菜", # 名称
"p_type": 0, # 1：通用 2：私有
"std_unit_name": "斤", # 基本单位
"id": "C841153",
"category_id_1": "A101", # 一级分类id
"category_id_2": "B101", # 二级分类id
"detail_images": [ # 商品详情图片
"https://img.guanmai.cn/product_pic/abcdefg.png"
],
"image": "https://img.guanmai.cn/product_pic/abcdefg.gif", # 商品图片
"alias": ["娃娃菜11"], # 别名列表
"dispatch_method": 1 # 投框方式 1 按订单投框 2 按司机投框
}]
}
请求示例
https://station.guanmai.cn/openapi/spu/list?access_token=dcvvu02xr9k1mqidfi2k4s3mxv33us6i
商品成本信息
openapi/merchandise/cost/list
请求方法
GET
请求参数
无
返回数据
{
"msg": "ok",
"code": 0,
"data": {
"count": 100 # 商品数量
"list":[{
'spu_id':'c000070', # 商品id
'remain':-3668.0, # 库存数量
'avg_price':285.17 # 平均单价
}]
}
}
批量查询商品
openapi/merchandise/sku/list
请求方法
GET
请求参数
| 参数名 | 类型 | 必选M/可选O/条件必选C | 描述 |
|---|---|---|---|
| salemenu_id | string | C | 报价单id，报价单和店铺至少要传一个 |
| sid | int | C | 店铺id，报价单和店铺至少传一个 |
| category1_id | str | O | 一级分类id |
| category2_id | str | O | 二级分类id |
| spu_id | str | O | spu id |
| sku_ids | list | O | 商品id列表，形如：["D123456"] |
| offset | int | O | 起始位置 |
| limit | int | O | 每页条数，最大值 |
返回参数
{
"msg": "ok",
"code": 0,
"data": {
"pagination": {
"is_last": false, # 是否最后一条
"limit": 10,
"offset": 0
},
"list": [
{
"stocks": -99999, // 销售库存，-99999表示无限库存，大于0的值表示销售库存
"sale_ratio": 1, // 销售单位与基本单位的比例
"desc": "", // 商品描述
"sale_price": 500, // 销售价
"std_sale_price": 500, // 标准单位价格
"salemenu_id": "S10043", // 销售单id
"id": "D4481622", // 商品id
"spu_id": "C1456355", // spu id
"sale_unit_name": "斤", // 销售单位
"category_id_1": "A8217", // 一级分类id
"state": 1, // 商品状态 1：上架 0：下架
"category_id_2": "B39463", // 二级分类id
"name": "大白菜|包test2", // 商品名
"pinlei_id": "P391800", // 品类id
"std_unit_name": "斤", // 标准单位
"outer_id": "T001" # 自定义编码
}
]
}
}
请求示例
https://station.guanmai.cn/openapi/merchandise/sku/list?salemenu_id=S00001&category1_ids=["A001"]&category2_ids=["B001"]&offset=0&limit=10
客户
客户列表
openapi/customer/list
请求方法
GET
请求参数
| 参数名 | 类型 | 必选M/可选O | 描述 |
|---|---|---|---|
| kid | string | O | 商户公司账户id |
| resname | string | O | 店铺名 |
| offset | int | O | 分页offset，默认0 |
| limit | int | O | 分页limit，默认20 |
返回参数
{
"msg": "ok",
"code": 0,
"data": {
"pagination": {
"offset": 0,
"limit": 20
},
"list": [{
"customer_name": "", # 商户名
"whitelist": 1, # 白名单
"customer_telephone": "", # 商户电话
"username": "13435747171", # 登录账户名
"payment_telephone": "13435747171", # 结款人联系方式
"payment_name": "唐路英", # 结款人姓名
"kid": "K035840", # 账户id
"pay_method": 1, # 结款方式 1.日结，2.周结，3.月结，4.自定义
"settle_way" # 结算方式， 1：先货后款，2：先款后货
"finance_status" # 冻结状态， 0：正常；1：冻结
"check_out" # 审核状态， 0：未审核 1：已审核
"is_credit" # 账期方式， 0：按周期 1：按额度
"settle_date_type" # 日期维度， 1 按下单日期 2按收货日期
"begin_day" # 周期长度， 起始日, 周一的话就是1，每月2号就是2
"settle_day" # 结算时间， 结算日, 周一的话就是1，每月2号就是2
"balance" # 账户余额， 单位元
"address_list": [{
"create_time": "2017-03-28T03:11:05",
"resname": "港口市场100号", # 店铺名
"keycustomer": 0, # 0:默认，1:重点客户
"address_telephone": "13435747171", # 店铺电话
"addr_detail": "兴港中路161号港口市场100号", # 餐馆地址
"sid": "S030257", # 店铺id
"address_name": "唐路英" # 店铺联系人
"create_employee_id": -1 # 开户经理id， -1 表示未设置
"sales_employee_id": -1 # 销售经理id， -1 表示未设置
}],
}]
}
}
销售经理列表
请求方法
GET
请求参数
| 参数名 | 类型 | 必选M/可选O | 描述 |
|---|---|---|---|
| customer_ids | list | M | 店铺id数组 |
返回数据
{
"code": 0,
"data": {
"16": {
"full_name": "连腾飞", # 销售经理名字
"id": 16, # 店铺ID
"sales_employee_id": 769 # 销售经理id
},
"96648": {
"full_name": "zhoumin",
"id": 96648,
"sales_employee_id": 2206
}
},
"msg": "ok"
}
请求示例
http://station.guanmai.cn/openapi/customer/sale_employee?access_token=k7avqc1zb338qz1q0wh5y9slrk89z9v5382&customer_ids=[16,96648]
订单
创建订单
openapi/order/create
请求方法
POST
请求参数
| 参数名 | 类型 | 必选M/可选O | 描述 |
|---|---|---|---|
| sid | string | M | 客户id |
| products | list | M | 商品详情，字段如下 |
| receive_begin_time | datetime | M | 收货起始时间，形如：2019-01-01 00:00:00 |
| receive_end_time | datetime | M | 收货截止时间，形如：2019-01-01 00:00:00 |
| time_config_id | str | M | 时间配置id |
| remark | str | O | 订单备注 |
| receiver_name | str | O | 收货人姓名 |
| receiver_phone | str | O | 收货人电话 |
| address | str | O | 收货地址 |
product
| 参数名 | 类型 | 必选M/可选O | 描述 |
|---|---|---|---|
| sku_id | string | M | 商品id |
| amount | float | M | 商品数量 |
| unit_price | int | M | 基础单位价格，单位分 |
| spu_remark | string | O | 商品备注 |
| is_price_timing | bool | O | 商品价格时价，用0/1表示 |
返回数据
{
"data":{
"order_id": "PL000001"
},
"msg":"ok",
"code":0
}
请求示例
POST https://station.guanmai.cn/openapi/order/create?access_token=dcvvu02xr9k1mqidfi2k4s3mxv33us6i
body:
sid=123&products=[{"sku_id":"D000001","amount":1,"unit_price":100,"spu_remark":"test"}]&receive_begin_time=2019-01-01 06:00:00&receive_end_time=2019-01-01 09:00:00
订单列表
openapi/order/list
描述
批量查询的订单。可以根据下单时间、收货时间、商户名筛选。
请求方法
GET
请求参数
| 参数名 | 类型 | 必选M/可选O | 描述 |
|---|---|---|---|
| query_type | int | M | 搜索类型，1: 按照下单时间搜索 2: 按照收货日期搜索 |
| start_date | string | M | 开始日期，格式要求：年-月-日 例如：2017-06-01 |
| end_date | string | M | 截止日期，格式要求：年-月-日 例如：2017-06-01 |
| sort_type | string | O | 排序类型(date_desc日期倒序(默认);date_asc日期升序;price_desc价格倒序;price_asc价格升序) |
| status | int | O | 订单状态 |
| pay_status | int | O | 支付状态 1: '未支付', 5: '部分支付', 10: '已支付' |
| offset | int | O | 分页offset，默认0 |
| limit | int | O | 分页limit，最大100条每页 |
参数说明
原筛选已支付订单时，status会传100，现新订单中已将支付状态提取成新字段pay_status，业务状态为100的订单已变为状态15，筛选已支付的订单应使用pay_status字段，但该接口仍支持status=100的查询，该情况会查出部分支付和已支付订单，如此情况下传了pay_status，则以pay_status覆盖status=100做为支付状态查询条件。该兼容逻辑下会存在如下问题：一个status为15，pay_status=10的订单，进行status=100/15的查询时都会被查出来，此处对老用户进行限制，status=15时仅拉取未支付的订单。
返回数据
{
"data": {
"list": [
{
"origin_total_price": "146.31", # 下单原价,单位元
"date_time_str": "2017-06-14 12:09:25", # 下单时间
"receive_end_time": "2017-06-13 12:00", # 收货截止时间
"status": 10, # 订单状态 1: 等待订单出库, 5: 订单正在分拣, 10: 订单正在配送, 15: 订单已签收, 100: 订单已支付 ps:删除订单不返回
# 新订单中支付状态被单独提取成一个新字段，取消业务状态中的100/已支付状态，业务状态为100的订单已变为状态15，为兼容老接口数据结构，当订单支付状态为5/10时，会将返回数据中的业务状态修改为100
"pay_status": 1, # 支付状态 1: '未支付', 5: '部分支付', 10: '已支付'
"sort_id": null, # 分拣号
"id": "PL492271", # 订单ID
"receive_begin_time": "2017-06-13 06:00", # 收货开始时间
"total_price": "146.31", # 下单执行总价,单位元
"resname": "湘有缘饭店", # 商户名称
"freight": "20.00", # 运费，单位元
"modify_time": "2019-05-09 11:11:38", # 最后更新时间
"address_id": 123456, # 下单商户id
}
],
"pagination": {
"limit": 20,
"offset": 0
}
},
"msg": "ok",
"code": 0
}
请求示例
https://station.guanmai.cn/openapi/orders?access_token=dcvvu02xr9k1mqidfi2k4s3mxv33us6i&query_type=1&start_date=2017-06-20&end_date=2017-06-24
订单详情
openapi/order/get
请求方法
GET
请求参数
| 参数名 | 类型 | 必选M/可选O | 描述 |
|---|---|---|---|
| order_id | string | M | 订单号 |
返回数据
{
"data": {
"freight": 2000, # 运费，单位分
"status": 10, # 业务状态 1: '等待出库', 5: '正在分拣', 10: '正在配送', 15: '已签收', 100: '已支付'
# 新订单中支付状态被单独提取成一个新字段，取消业务状态中的100/已支付状态，业务状态为100的订单已变为状态15，为兼容老接口数据结构，当订单支付状态为5/10时，会将返回数据中的业务状态修改为100
"pay_status": 1, # 支付状态 1: '未支付', 5: '部分支付', 10: '已支付'
"real_price": 728.00, # 真实价格（根据真实重量算出的真实价格），单位分
"customer": {
"resname": "盐田区沙头角中学沙县小吃" # 商户信息
"address": "沙头角东和路55号", # 收货地址
"receiver_phone": "18033432789", # 收货人手机号
"receive_begin_time": "2017-06-22 06:00", # 收货开始时间
"receive_end_time": "2017-06-22 12:00", # 收货结束时间
"receiver_name": "邓华君" # 收货人姓名
},
"date_time": "2017-06-21T17:29:38.913", # 下单时间
"modify_time": "2019-05-09 11:11:38" # 最后更新时间
"remark": null, # 备注
"details": [
{
"category_title_2": "叶菜类", # 二级分类名
"std_unit_name": "斤", # 基本单位
"sale_unit_name": "斤", # 销售单位
"real_item_price": 728.00, # 真实总价，单位分
"real_quantity": 1, # 称重后数量
"category_title_1": "蔬菜", # 一级分类名
"spu_remark": "", # 备注
"accept_quantity": 1, # 收货数量
"supplier_name": "小农女", # 供应商名称
"quantity": 1, # 下单数量
"purchase_quantity": 1, # 采购数量
"sale_price": "7.28", # 销售单价，单位元
"name": "白菜苔|斤", # 商品名
"sale_ratio": 1, # 销售规格
"spu_id": "C00865", # spuid，商品id
"id": "D805677", # sku ID，修改订单时候的参数，规格id
"is_weight": true, #是否需要称重
"has_weight": true, #是否已经称重
"salemenu_name":"哈", # 采购单名称
"outer_id": "T001" # 自定义编码
}
],
"sort_id": 2, # 分拣序号
"total_pay": 2728.00, # 应付金额（加上运费的），单位分
},
"msg": "ok",
"code": 0
}
请求示例
https://station.guanmai.cn/openapi/order/get?access_token=dcvvu02xr9k1mqidfi2k4s3mxv33us6i&order_id=PL492416
订单详情v2
openapi/order/detail
请求方法
GET
请求参数
| 参数名 | 类型 | 必选M/可选O | 描述 |
|---|---|---|---|
| order_id | string | M | 订单号 |
返回数据
{
"data": {
"freight": 2000, # 运费，单位分
"status": 10, # 业务状态 1: '等待出库', 5: '正在分拣', 10: '正在配送', 15: '已签收', 100: '已支付'
# 新订单中支付状态被单独提取成一个新字段，取消业务状态中的100/已支付状态，业务状态为100的订单已变为状态15，为兼容老接口数据结构，当订单支付状态为5/10时，会将返回数据中的业务状态修改为100
"pay_status": 1, # 支付状态 1: '未支付', 5: '部分支付', 10: '已支付'
"real_price": 728.00, # 真实价格（根据真实重量算出的真实价格），单位分
"customer": {
"resname": "盐田区沙头角中学沙县小吃" # 商户信息
"address": "沙头角东和路55号", # 收货地址
"receiver_phone": "18033432789", # 收货人手机号
"receive_begin_time": "2017-06-22 06:00", # 收货开始时间
"receive_end_time": "2017-06-22 12:00", # 收货结束时间
"receiver_name": "邓华君" # 收货人姓名
},
"date_time": "2017-06-21T17:29:38.913", # 下单时间
"modify_time": "2019-05-09 11:11:38" # 最后更新时间
"remark": null, # 备注
"details": [
{
"category_title_2": "叶菜类", # 二级分类名
"std_unit_name": "斤", # 基本单位
"sale_unit_name": "斤", # 销售单位
"real_item_price": 728.00, # 真实总价，单位分
"real_quantity": 1, # 称重后数量
"category_title_1": "蔬菜", # 一级分类名
"spu_remark": "", # 备注
"accept_quantity": 1, # 收货数量
"supplier_name": "小农女", # 供应商名称
"quantity": 1, # 下单数量
"purchase_quantity": 1, # 采购数量
"sale_price": "7.28", # 销售单价，单位元
"name": "白菜苔|斤", # 商品名
"sale_ratio": 1, # 销售规格
"spu_id": "C00865", # spuid，商品id
"id": "D805677", # sku ID，修改订单时候的参数，规格id
"is_weight": true, #是否需要称重
"has_weight": true, #是否已经称重
"salemenu_name":"哈", # 采购单名称
"outer_id": "T001" # 自定义编码
}
],
"sort_id": 2, # 分拣序号
"total_pay": 2728.00, # 应付金额（加上运费的），单位分
# 相较于order/get接口新增的字段
"abnormal_money": 2, # 订单异常总额，单位元
"refund_money": 2, # 订单退货总额，单位元
"abnormals": [{
"detail_id": "D0000001", # 异常商品id
"money_delta": 10, # 异常差额，单位元
"final_amount": 1, # 记账数量（出库数减去异常数）
"type_text": "订单超时" # 异常/退货原因
}],
"refunds": [{
"detail_id": "D0000002", # 退货商品id
"real_amount": 1, # 实退数
"request_amount": 1, # 应退数
"type_text": "订单超时" # 异常/退货原因
}]
},
"msg": "ok",
"code": 0
}
请求示例
https://station.guanmai.cn/openapi/order/detail?access_token=dcvvu02xr9k1mqidfi2k4s3mxv33us6i&order_id=PL492416
订单修改
openapi/order/update
描述
可以修改订单里面商品的单价，数量，备注，以及收货时间。注意：只有订单状态是1(等待出库)和5(正在分拣)时才能够修改单价
请求方法
POST
请求参数
| 参数名 | 类型 | 必选M/可选O | 描述 |
|---|---|---|---|
| order_id | string | M | 订单号 |
| receive_begin_time | string | O | 收货开始时间，格式：年-月-日 时:分:秒 例如：2017-06-22 19:15:00 |
| receive_end_time | string | O | 收货截止时间，格式同上 |
| status | int | O | 订单状态，1:等待分拣 5:正在分拣 状态能从1>5，1>10,5>10 |
| sku_id | string | O | 商品id，修改单个商品时必传 |
| amount | int | O | 商品数量 |
| price | int | O | 商品单价，单位分 |
| remark | string | O | 商品备注 |
返回数据
{
"code": 0,
"data": null,
"msg": "ok"
}
请求示例
POST https://station.guanmai.cn/openapi/order/update?access_token=dcvvu02xr9k1mqidfi2k4s3mxv33us6i
body:
order_id=PL000001&amount=10
采购
采购单列表
openapi/stock/purchase_sheet/list
请求方法
GET
请求参数
| 参数名 | 类型 | 必选M/可选O | 描述 |
|---|---|---|---|
| start_time | string | M | 入库开始时间（查询长度限制在1个月），格式要求：年-月-日 例如：2017-06-01 |
| end_time | string | M | 入库结束时间，格式要求：年-月-日 例如：2017-06-01 |
| status | int | O | (1:已驳回;2:待入库;3:已入库) |
| offset | int | O | 分页offset，默认0 |
| limit | int | O | 分页limit，最大100条每页 |
返回数据
{
"code": 0,
"msg": "ok",
"data": {
"list":[
{
"create_time": "2017-08-07 10:32:49", # 创建时间
"operator": "k10admin", # 操作人员
"status": 2, # 状态 (1:已驳回;2:待入库;3:已入库)
"in_stock_time": "2017-08-08", #入库时间
"purchase_sku_num": 2, # 预采购商品数
“purchaser”:"抓发送d分", # 采购人员
"purchase_sku_money": 65000, # 预采购金额 分
"id": "T002-CGD-2017-08-07-00001", # 采购单号
"settle_supplier_name": "深圳市五谷丰米业有限公司" # 结算供应商
},
{
"status": 3,
"in_stock_time": "2017-08-02",
"operator": "k10admin",
"create_time": "2017-08-02 17:18:43",
“purchaser”:"抓发送d分",
"purchase_sku_num": 1,
"purchase_sku_money": 24000,
"id": "T002-CGD-2017-08-02-00001",
"settle_supplier_name": "现金自采（钟家平）"
}
],
"pagination": {
"limit": 20,
"offset": 0
}
}
}
请求示例
https://station.guanmai.cn/openapi/purchase_sheet/get?access_token=dcvvu02xr9k1mqidfi2k4s3mxv33us6i&start_time=2017-08-01&end_time=2017-08-09&sheet_no=&settle_supplier_id=&status=
采购单详情
请求方法
GET
请求参数
| 参数名 | 类型 | 必选M/可选O | 描述 |
|---|---|---|---|
| sheet_no | string | M | 采购单号 |
返回数据
{
"code": 0,
"msg": "ok",
"data": {
"create_time": "2017-08-07 10:32:49", # 创建时间
"status": 2, # 状态
"in_stock_time": "2017-08-08", # 入库时间
"id": "T002-CGD-2017-08-07-00001", # 采购单号
"settle_supplier_name": "深圳市五谷丰米业有限公司", # 结算供应商名称
"sku_data": [
{
"sku_id": "D1894374", # 商品规格id
"name": "火锅面|盈丰|7.9斤", # 商品规格名
"spu_id": "C436027", # 商品id
"spu_name": "火锅面|盈丰|7.9斤", # 商品名
"category_name_1": "粮油副食", # 一级分类名称
"category_name_2": "煮食粉面", # 二级分类名称
"std_unit_name": "箱", # 基本单位
"sale_ratio": 1, # 销售规格
"sale_unit_name": "斤", # 销售单位
"purchase_amount": 6, # 采购数
"purchase_price": 10000, # 采购金额（分）
"arrived_amount": 6, # 到货数量
"arrived_price": 10000, # 到货单价(分)
"status": 1, # (0:未到货;1:到货)
"remark": "", # 备注
"purchase_price_limit": 0, # 约定采购价(分)
},
{
"sku_id": "D1839256",
"name": "豆瓣酱|恒星红油豆瓣酱|小|8斤",
"spu_id": "C01057",
"spu_name": "豆瓣酱|恒星红油豆瓣酱|小|8斤",
"category_name_1": "粮油副食",
"category_name_2": "调味品",
"std_unit_name": "瓶",
"sale_ratio": 1,
"sale_unit_name": "瓶",
"purchase_amount": 5,
"purchase_price": 1000,
"arrived_amount": 0,
"arrived_price": 0,
"status": 0,
"remark": "",
"purchase_price_limit": null,
}
],
"tel": "", # 操作人电话号码
"operator_name": "" # 操作人员
}
}
请求示例
https://station.guanmai.cn/openapi/purchase_sheet/detail?access_token=dcvvu02xr9k1mqidfi2k4s3mxv33us6i&sheet_no=T002-CGD-2017-08-07-00001
进销存
入库单列表
openapi/in_stock_sheet/get
请求方法
GET
请求参数
| 参数名 | 类型 | 必选M/可选O | 描述 |
|---|---|---|---|
| start_time | string | O | 入库开始时间，格式要求：年-月-日 例如：2017-06-01 |
| end_time | string | O | 二级分类id |
| status | string | O | 入库单状态；-1：删除，1：未提交，2：未审计，3：审计通过，0：审计未通过，4：已支付 |
| offset | string | O | 分页offset，默认0 |
| limit | int | O | 分页limit，最大100条每页 |
返回数据
{
"code": 0,
"pagination": {
"offset": 0,
"limit": 30
},
"data": [
{
"id": "T8521-JHD-2018-12-08-00001", # 入库单ID
"status": 2, # 入库单状态
"submit_time": "2018-12-08", # 提交时间
"creator": "zhoumin", # 创建者
"details": [ # Array sku信息
{
"std_unit": "斤", # sku入库单位
"id": "D4307940", # skuID
"unit_price": 0, # sku入库单价
"name": "高级龙眼|1斤/斤", # sku名字
"quantity": 1765, # sku入库数
"spu_id": "C123456" # spu ID
}
],
"station_id": "T8521", # 站点ID
"settle_supplier_id": "T12478", # 供应商ID
"supplier_name": "综合供应商", # 供应商名称
"settle_supplier_customer_id": "GYS001", # 供应商自定义编码
}
],
"msg": "ok"
}
请求示例
http://station.guanmai.cn/openapi/in_stock_sheet/get?start_time=2018-12-06&end_time=2018-12-17&access_token=k7avqc1zb338qz1q0wh5y9slrk89z9v5382
出库单列表
openapi/out_stock_sheet/get
请求方法
GET
请求参数
| 参数名 | 类型 | 必选M/可选O | 描述 |
|---|---|---|---|
| start_time | string | O | 入库开始时间，格式要求：年-月-日 例如：2017-06-01 |
| end_time | string | O | 二级分类id |
| status | string | O | 入库单状态；-1：删除，1：未提交，2：未审计，3：审计通过，0：审计未通过，4：已支付 |
| offset | string | O | 分页offset，默认0 |
| limit | int | O | 分页limit，最大100条每页 |
返回数据
{
"code": 0,
"pagination": {
"offset": 0,
"limit": 30
},
"data": [
{
"out_stock_time": "2018-12-08", # 出库时间
"out_stock_target": "西边餐馆", # 客户名称
"id": "PL3749189", # 出库单ID
"status": 2, # 出库单状态
"creator": "系统", # 创建者
"details": [ # Array sku信息
{
"quantity": 55, # sku出库数
"id": "D4307941", # skuID
"unit_price": 0, # sku单价
"std_unit": "斤", # sku单位
"sale_ratio": 1, # 销售规格
"name": "高级龙眼2", # sku名字
"sale_unit": "斤", # 销售单位
"spu_id": "C123456" # spu ID
}
],
"station_id": "T8521", # 站点ID
"out_stock_customer_id": "S123456" # 商户ID
}
],
"msg": "ok"
}
请求示例
http://station.guanmai.cn/openapi/out_stock_sheet/get?access_token=k7avqc1zb338qz1q0wh5y9slrk89z9v5382&start_time=2018-12-06&end_time=2018-12-09
财务
到账凭证
openapi/finance/strike/list
请求方法
GET
请求参数
| 参数名 | 类型 | 必选M/可选O | 描述 |
|---|---|---|---|
| start_time | string | O | 入库开始时间，格式要求：年-月-日 例如：2017-06-01 |
| end_time | string | O | 二级分类id |
| offset | string | O | 分页offset，默认0 |
| limit | int | O | 分页limit，最大100条每页 |
返回数据
{
"data": {
"pagination": {
"offset": 0,
"limit": 100
},
"list": [
{
"district_code": "440300", # 地区编码
"update_people": "tianshisan", # 更新操作人
"deal_code": "453245632623", # 到账凭证号(到账流水)
"strike_people": "tianshisan", # 财务冲账操作人
"telephone": null, # 电话
"balance": "0.00", # 余额
"arrival_money": "68.02", # 到账金额
"arrival_time": "2018-12-05", # 到账时间
"kid": "103923", # 用户ID
"id": 1, # 到账凭证ID
"extra": null, # 备注
"order_flows": [ # Array 订单冲账流水
{
"modify_time": "2018-12-05T18:33:34", # 修改时间
"deal_code": "453245632623", # 到账凭证号
"operator_id": 2206, # 操作人id
"id": "CZ747221", # 流水id
"create_time": "2018-12-05T18:33:34", # 创建时间
"amount": "68.02", # 冲账金额
"customer": { # 账户信息
"uid": "103923", # 账户ID
"receiver_phone": "1351351351",
"address_id": "97258", # 店铺ID
"address": "sjsjisjoijgoidg", # 店铺地址
"resname": "minbg" # 店铺名
},
"operator": "tianshisan", # 操作人
"order_no": "PL3749180", # 订单号
"strike_id": 1, # 到账凭证ID
"status": 2 # 交易状态，未支付，已支付
}
],
"strike_time": "2018-12-05T18:33:34", # 冲账时间
"arrival_method": "微信对私", # 到账方式
"strike_money": "68.02", # 冲账金额
"update_time": "2018-12-05 18:33:34", # 更新时间
"arrival_id": "wechat" # 到账账号
}
]
},
"msg": "ok",
"code": 0
}
请求示例
http://station.guanmai.cn/openapi/finance/strike/list?access_token=k7avqc1zb338qz1q0wh5y9slrk89z9v5382&start_time=2018-11-07&end_time=2018-12-07