Skip to content

一、原有接口修改

入库:

1.获取全部供应商 ok

/station/stock/settle_supplier/get
请求参数:
无修改
返回值:
无修改

2.查询入库清单 ok

进首页时默认搜索条件是按照时间搜索;
station/stock/in_stock_sheet/list

请求参数:
修改点:
1.添加搜索时间条件~~~~
type:
1-按入库时间搜索
2-按建单时间搜索

注意:这里的入库清单实际上是新交互里面的详情信息,而详情里面没有分摊,折让信息,
所以要接口互换,把清单改成详情接口,详情接口改成清单列表接口。

2.添加搜索文本内容:原来只有id搜索,现在可以用供应商信息搜索
参数:
    param_check_dict = {
    "type": Param(int),
    "start": Param(date),
    "end": Param(date),
    "status": Param(int),
    "search_text": Param(str, optional=True),
    "export": Param(int, optional=True),
    "offset": Param(int, optional=True),
    "limit": Param(int, optional=True)
}
    }
返回值:
   {
  "code": 0,
  "msg": "ok",
  "data": [
    {
      "status": 1,
      "supplier_name": "拉就是了对方",
      "submit_time": "-",
      "id": "T002-JHD-2016-12-13-00002",
      "supplier_id": "T002"
    },
    {
      "supplier_id": "T002",
      "sku_money": 4400,
      "status": 1,
      "submit_time": "-",
      "supplier_name": "拉就是了对方",
      "id": "T002-JHD-2016-12-13-00001"
    },
    {
      "supplier_id": "T002",
      "sku_money": 4400,
      "supplier_name": "拉就是了对方",
      "status": 1,
      "submit_time": "2016-12-08T00:00:00",
      "id": "T002-JHD-2016-12-13-00003"
    },
    {
      "supplier_name": "拉就是了对方",
      "id": "T002-JHD-2016-12-13-00004",
      "sku_money": 4400,
      "status": 1,
      "submit_time": "-",
      "supplier_id": "T002"
    },
    {
      "supplier_id": "T002",
      "sku_money": 4400,
      "supplier_name": "试试是啥",
      "status": 1,
      "submit_time": "-",
      "id": "T002-JHD-2016-12-13-00005"
    },
    {
      "supplier_name": "试试是啥",
      "sku_money": 4400,
      "supplier_id": "T002",
      "status": 1,
      "submit_time": "-",
      "id": "T002-JHD-2016-12-13-00006"
    }
  ]
}

2.编辑入库单信息 ok

注意:
1.因为分摊会对商品产生影响,所以在点击分摊时候会自动保存前面填写的商品一次,
填写完分摊之后重新拉取数据,刷新界面,此时如果在去修改商品明细,就提示
改商品已分摊,无法修改
2.分摊里面要传分摊商品的sku_id
接口名:station/in_stock_sheet/modify
Method:POST
请求参数:
    details     M       list  # 保存商品明细列表
    discount     M       list # 折让信息

    share      M       list # 分摊信息 method: MONEY = 1 AMOUNT = 2   ,type:  ADD = 1  SUBSTRACT = 2   , reason:  TRANSPORT_COST = 1  OTHER_COST = 2
分摊里面记着传share_skus列表
    sku_id:D00531       M       list    # sku_id
    id:T002-JHD-2016-11-30-00001        M   str # 入库单id
    in_stock_type:normal    M   str  #  入库类型
    amount:1        M   int     # 入库数
    price:1         M   int     # 入库单价

响应:
    code    M   int     返回码,0表示成功,其他表示错误
    msg     M   string  返回信息
    data    M   list    返回json数据,结构看示例

示例:
request:
    POST http://teststation.guanmai.cn/station/stock/in_stock_sheet/modify
    POST参数:
        id: 13133,
        submit_time: '2015-02-02 10:00',
        is_submit: 1,

        details: [
                {
                    'id': '商品ID',
                    'name': '商品ID',
                    'category': '商品分类',
                    'std_unit': '斤',
                    'quantity': 20,  #  退货数
                    'unit_price': 240,   # 退货单价
                }
            ],
       # 分摊
       fentans: [
          {
              'remark': 备注,
              'money': 123,
              'operator': 操作人,
              'method': 1,
              'reason': 1,
              'type': 1
          }
       ]
        // 折让
        discount:[
            {
                'reason': 1-运输费用分摊;2-其他费用分摊,
                'type': 1-加钱;2-减钱,
                'money': 1234,
                'remark': '备注'
            }
        ]
        station_id: 'T002'


response:
    {
        'code': 0,
        'msg': 'ok',
    }



   逻辑:
   参数校验
   接受传入参数
   根据传入参数进行查询操作
   返回数据

3.新建入库单 ok

station/stock/in_stock_sheet/create
op:add
请求参数:
supplier_id:T002
supplier_name:试试是啥
返回数据:
sheet_no:"T002-JHD-2016-11-17-00002" ------> id

4.查看入库单详情 ok

station/stock/in_stock_sheet/new_detail
请求数据:
sheet_no:T002-JHD-2016-11-17-00001 ------> id
export: 是否导出
返回参数:

        {
  "data": {
    "id": "T002-JHD-2016-12-13-00002",
    "creator": "k10admin",
    "update_time": "2016-12-13T20:20:16.991",
    "station_id": "T002",
    "details": [
      {
        "unit_price": 245.4545,
        "std_unit": "斤",
        "category": "食用菌菇",
        "quantity": "22",
        "name": "鲜白云耳",
        "id": "D601830",
        "operator": "k10admin"
      }
    ],
    "discount": [
      {
        "remark": "哈哈",
        "create_time": "2016-12-13 20:20:39",
        "reason": 1,
        "money": 100,
        "operator": "k10admin",
        "type": 1
      }
    ],
    "type": 1,
    "share": [
      {
        "remark": "111",
        "id": 1,
        "create_time": "2016-12-13 20:20:39",
        "reason": 1,
        "money": 1000,
        "operator": "k10admin",
        "method": 1,
        "share_sku_ids": [
          "D601830"
        ],
        "type": 1
      }
    ],
    "supplier_id": "T002",
    "status": 2,
    "sku_money": 5399.999,
    "submit_time": "2016-12-08T00:00:00",
    "supplier_name": "试试是啥",
    "delta_money": 100,
    "date_time": "2016-12-13T20:20:16.991"
  },
  "code": 0,
  "msg": "ok"
}

搜索分摊商品分类信息

station/stock/in_stock_sheet/search_share_sku
参数:
id:订单id

5.查看分摊,折让信息 删除(合并到详情中了)

station/stock/in_stock_sheet/deal
无修改

6.提交入库单 删除(合并到详情中了)

station/stock/in_stock_sheet/submit
状态:submit
修改点:
sheet_no --> id
#因为分摊折让是分开进行的,需要独立接口,所以这里不用进行整合,
#原来,分摊,折让,商品信息是分开的,现在集合到一个提交入库单接口中,
#整个信息传给我。我在去修改所有信息。

6.入库,退货搜索商品接口

/station/stock/in_stock_sku/supply_sku
参数:
source:supply_sku # 固定
id: 订单号
name: 搜索名字
方法:GET

6.入库冲销

station/stock/in_stock_sheet/cancel
参数:
    id

6.入库审核

station/stock/in_stock_sheet/review
Method:POST
    请求参数:
        id          M   int         出库单ID
        is_pass                         M   int         状态1-通过 2-不通过

    响应:
        code    M   int     返回码,0表示成功,其他表示错误
        msg     M   string  返回信息

7.导出入库单(合并)

in_stock_sheet/export
修改:原来没有导出功能,增加列表所有字段到导出内容中

8.出库单费用分摊添加,删除 (合并)

station/stock/in_stock_sheet/fentan
op:add
op:del
修改点:原来是一次只能添加一条,现在弃用,改到保存草稿功能中批量保存,逻辑不变
最新修改:还是沿用原来的一次一条添加删除
请求参数:
op:add
sheet_no:T002-JHD-2016-11-17-00001 ------> id
reason:1
type:1
money:1
method:1
in_sku_logs:582d6973b1d1ea358df48302
remark:1

9.出库单费用折让添加,删除 (合并)

station/stock/in_stock_sheet/zhezhang
op:add
op:del
修改点:原来是一次只能添加一条,现在弃用,改到保存草稿功能中批量保存,逻辑不变
最新修改:还是沿用原来的一次一条添加删除
请求参数:
op:add
sheet_no:T002-JHD-2016-11-17-00001 ------> id
reason:2
type:1
money:1
remark:1

10.出库单红冲 ok

station/stock/in_stock_sheet/cancel
op:del
请求参数:
op:del
sheet_no:T002-JHD-2016-11-17-00001 ------> id

11.入库商品 ok

station/stock/in_stock_sku/supply_sku
请求参数:
op:add
sku_id:D42848
sheet_no:T002-JHD-2016-11-17-00002 ------> id
in_stock_type:normal
amount:1
price:1
create_time:
返回参数:
无修改

12.审核不通过 ok

station/stock/in_stock_sheet/submit
状态:regect
无修改

盘点:

1.获取一级二级分类接口

station/skucategories
无修改

2.获取全部库存接口

station/stock/get_stocks
进页面默认调一次接口
无修改

3.搜索库存接口

station/stock/get_stock
修改点:
1.搜索文本原来只是按照商品名称搜索,新增ID也可以搜索

4.入库记录

station/stock/in_stock_sku
修改点:
1.查询条件新增时间段限制
2.删除入库类型条件限制
3.搜索文本新增id搜索

5.出库记录

station/stock/out_stock_sku
修改点:
1.查询条件新增时间段限制
2.查询条件新增一级,二级分类条件
3.搜索文本新增id搜索
4.删除原有出库类型条件

6.退货记录

station/stock/return_supply_sku
修改点:
1.查询条件新增时间段限制
2.查询条件新增一级,二级分类条件
3.搜索文本新增id搜索
4.删除原有选择供应商条件

7.报溢记录

station/stock/stock_increase
修改点:
1.查询条件新增时间段限制
2.搜索文本新增商品信息查询

8.报损记录

station/stock/stock_loss
修改点:
1.查询条件新增时间段限制
2.搜索文本新增商品信息查询

9.退货入库

无修改

10.退货接口

原有接口步骤:
第一步要先调用:station/stock/return_supply_sku/supply_sku?spu_id=C298005

第二部调用:station/stock/return_supply_sheet/changeble
supplier_id:T004
settle_supplier_id:T544

第二部调用:station/stock/return_supply_sheet
op:add
supplier_id:T004
settle_supplier_id:T544
sku_id:D1774439
amount:1
price:1
remark:1

供应商结款

1.待处理单据列表 ok

station/stock/settle_sheet/list
请求参数:
    param_check_dict = {
    "type": Param(int), # 时间类型1,2,3一次按照ui显示
    "receipt_type": Param(int), # 订单状态 0-全部 1-入库 2-退货
    "start": Param(date), # 开始
    "end": Param(str), # 结束 
    "settle_supplier_id": Param(str, optional=True) # 结算供应商id

}

2.结款单审核 ok

station/stock/in_stock_sheet/submit
无修改

3.加入结款单 ok

station/stock/settle_sheet
请求参数:
    op:add
    supplier_id:T003
    settle_supplier_id:T515
    sheet_nos:T002-JHD-2016-11-09-00002
    remark:1
返回参数:
无修改

4.结款单据列表 ok

station/stock/settle_sheet
这里结款单据将详情带进了列表中,需要拆分成结款单列表,结款单详情两个接口
请求参数:
和待处理单据共用一个搜索条件
返回参数:
   "status":1,
   "zhezhang_num":1,
   "sheet_nos":[
       "T002-JHD-2016-11-15-00001"
   ],
   "settle_supplier_id":"T1285"

结款单详情

station/stock/settle_sheet/details
请求参数:
id
返回参数:
无修改

5.提交结款单 ok

station/stock/settle_sheet/submit
请求参数:
op:submit
sheet_no:T002-FKD-2016-11-15-00001
返回参数:
无修改

6.结款单审核不通过

station/stock/settle_sheet/submit
请求参数:
op:reject
id 单号
返回参数:
无

7.标记结款

station/stock/settle_sheet/pay
请求参数:
op : pay
id 单号
real_pay 真实支付
running_number 流水号

8.取消支付

station/stock/settle_sheet/pay
请求参数:
op :unpay
id 单号

9.结款单红冲

station/stock/settle_sheet
请求参数:
op : del
id 单号

10.导出接口

station/stock/settle_sheet/export
请求参数:
id 单号

1.采购入库接口(所有搜索接口都要按照这个规格修改)

接口名:/station/stock/in_stock_sheet
Method: GET
    原有参数:
         'begin':
         'end':
         'sheet_no':
         'supplier_id':
         'settle_supplier_id':
         'status':
         'cur_page':
         'cnt_per_page':
    现有参数:
         type       M   int          时间类型:1-按入库时间搜索;2-按建单时间搜索;
        start  M   date          开始日期
        end        M   date          截止日期
        status          O   int             状态:0-全部,1-待提交,2-已提交待审核,3-审核通过待结款,4-已结款,5-审核不通过,6-已删除
        search_text O   string          搜索文本(单号,供应商信息)
        export          O   int             是否导出:0-不导出,默认;1-导出;
        offset          O   int             分页offset
        limit           O   int             分页limit
    改动点:
        1.新增type入库时间搜索条件
        2.搜索文本框新增可输入供应商信息搜索
        3.新增导出功能
响应:
    code    int     M       0表示请求成功,其他表示请求失败
    data    null    M       无返回数据
    msg     string  M       请求成功是'ok',请求失败则是错误信息

示例:
request:
    http://teststation.guanmai.cn/station/stock/settle_supplier
    POST参数:
        cur_page:0
        cnt_per_page:10
        begin:2016-11-13
        end:2016-11-14

response:
    {
    "msg":"ok",
    "code":0,
    "data":{
        "total":48,
        "res":Array[10],
        "cur_page":0
    }
}
修改点:
返回参数内容不变,数据结构修改
修改data结构为:
data:{
    pagination:{
        total:"",
        cur_page:""
    },
    in_stock_list:[]
}

二、新增接口

出库表

{ "_id" : "T002-CKD-2016-12-05-00011", # 出库单id "update_time" : ISODate("2016-12-05T14:37:46.742Z"), # 更新时间 "creator" : 2, # 创建人 "out_stock_target" : "111111", # 出库对象 "money" : 15840.0, # 出库金额 "create_time" : ISODate("2016-12-05T14:37:46.742Z"), # 创建时间 "status" : 3, # 出库单状态 "details" : [ { "unit_price" : 720, # 单价 "std_unit" : "斤", # 单位 "id" : "D601830", # id "quantity" : "20", # 数量 "name" : "鲜白云耳", # 名称 "category" : "食用菌菇" # 分类 } ], "out_stock_time" : ISODate("2016-12-05T00:00:00.000Z") # 出库时间 }

出库订单id检测

接口名:station/stock/out_stock_sheet/test_id
Method:GET
请求参数:
id:出库单id

1.拉取出库单列表(需要)ok

接口名:station/stock/out_stock_sheet/list
Method:GET
请求参数:
    type        M   int         时间类型:1-按出库时间搜索;2-按建单时间搜索;
    start   M   date            开始日期
    end     M   date            截止日期
    status          O   int     状态:0-全部单据状态;1-待出库;2-已出库 3-已删除 4-冲销
    search_text O   string          搜索文本
    export          O   int             是否导出:0-不导出,默认;1-导出;
    offset          O   int             分页offset
    limit           O   int             分页limit
响应:
    code    M   int     返回码,0表示成功,其他表示错误
    msg     M   string  返回信息
    data    M   list    返回json数据,结构看示例

示例:
request:
    GET http://teststation.guanmai.cn/station/out_stock_sheet/out?type=1&start_date=2016-10-25&end_date=2016-10-26

response:
    {
        'code': 0,
        'data': [
                {
                    'id':11112,                 # 出库单ID
                    'out_stock_target': '商户信息',    # 商户信息
                    'out_stock_time': '2016-10-24', # 出库时间
                    'money': 1111,      # 出库金额
                    'status': 2,        # 状态                    }
            ],
        'msg': 'ok',
    }

逻辑:
参数校验
接受传入参数
根据传入参数进行查询操作
返回数据

2.拉取出库单详情(需要)

接口名:station/stock/out_stock_sheet/detail/
Method:GET
请求参数:
    out_stock_id        M   int         出库单ID

响应:
    code    M   int     返回码,0表示成功,其他表示错误
    msg     M   string  返回信息
    data    M   json    出库单信息
示例:
request:
    GET http://teststation.guanmai.cn/out_stock_sheet/detail?out_stock_id=

response:
    {
        'code': 0,
        'msg': 'ok',
        'data': {
            'id': '出库单ID',
            'stock_target': '商户信息'
            'creator': '建单人',
            'out_stock_time': '出库时间',
            'total_price': 123434,
            'status': 1-待出库;2-已出库;3-已删除

            'details': [{
                'name': '白菜',  # 商品名
                'category': '叶菜类',  # 商品分类
                'quantity': 33,  # 出库数
                'unit_price': 100,  # 出库单价
                'total_money': 1000 ,  # 出库金额
                'operator': 'k10admin',
                'std_unit': "斤"   # 单位
            }],
            'station_id': 'k10admin',
        }
    }

逻辑:
接受参数
根据参数查询信息
返回数据

3.新建出库单(需要)

接口名:/station/stock/out_stock_sheet/create/
Method:POST
请求参数:
    out_stock_target    O   string          出库对象文本

响应:
    code    M   int     返回码,0表示成功,其他表示错误
    msg     M   string  返回信息
    data    M   json    新建的出库单信息
示例:
request:
    POST http://teststation.guanmai.cnstation/out_stock_sheet/create/
    POST参数:
        out_stock_target: "站点信息"

response:
    {
        'data': {
            'id': '出库单id',
            'out_stock_id': '商户id',
            'out_stock_target': '商户信息',
            'status': 1,
            'creator': '建单人',
            'out_stock_time': '出库时间',
            'total_price': 0
        }
        'code': 0,
        'msg': 'ok',
    }

逻辑:
接受新建参数
生成出库单号
返回单号

4.修改出库单(需要)

接口名:/station/stock/out_stock_sheet/modify/
Method:POST
请求参数:
    id  M   int             出库单ID
    is_submit       M   int             1-不提交,2-提交
    details         M   json            商品信息,结构见示例
响应:
    code    M   int     返回码,0表示成功,其他表示错误
    msg     M   string  返回信息

示例:
request:
    POST http://teststation.guanmai.cn/station/out_stock_sheet/modify/13133
    POST参数:
        id: 13133
        is_submit: True,
        out_stock_time: 2016-11-27 00:00:00
        'details': [{
                'name': '白菜',  # 商品名
                'id': 'D00001',  # sku_id
                'category': '叶菜类',  # 商品分类
                'quantity': 33,  # 出库数
                'unit_price': 100,  # 出库单价

            }]


response:
    {
        'code': 0,
        'msg': 'ok',
    }

逻辑:
接受所有参数
校验所有参数是否正确
修改出库单,分摊,折让列表,三个都是整体替换修改

5.出库单冲销(需要)

接口名:/station/stock/out_stock_sheet/cancel/
Method:POST
请求参数:
    id  M   int         出库单ID

响应:
    code    M   int     返回码,0表示成功,其他表示错误
    msg     M   string  返回信息

示例:
request:
    GET http://teststation.guanmai.cn/station/out_stock_sheet/cancel?id=

response:
    {
        'code': 0,
        'msg': 'ok',
    }

逻辑:
接受参数
逻辑删除出库单

退货表

{ "_id" : "T002-JHTHD-2016-12-09-00002", # id "details" : [ { "name" : "西生菜|块状", # 名字 "creator" : "k10admin", # 创建人 "id" : "D1723443", # sku_id "unit_price" : 681, # 单价 "category" : "甘蓝类", # 分类 "quantity" : "22", # 数量 "std_unit" : "斤" # 单位 } ], "status" : 5, # 状态 "_lock" : false, # 锁 "stock_type" : 2, # 出库类型1-自动 2-补货 "update_time" : ISODate("2016-12-09T19:08:01.379Z"), # 更新时间 "station_id" : "T002", # 站点id "discount" : [ { "remark" : "12", # 备注 "creator" : "k10admin", # 创建人 "money" : "12", # 折让金额 "operate_time" : "2016-12-09", # 操作时间 "action" : "1", # 动作 "reason" : "1" # 原因 } ], "create_time" : ISODate("2016-12-09T19:08:01.379Z"), # 创建时间 "supplier_id" : "T2384", # 供应商id "supplier_name" : "现金自采(钟家平)", # 供应商名字 "creator" : "k10admin", #出库单创建人 "sku_money" : 14982.0, # 总出库金额 "submit_time" : ISODate("2016-12-09T00:00:00.000Z") # 提交时间 }

6.拉取退货供应商列表(需要)

接口名:/station/stock/return_stock_sheet/supplier_list/
Method:GET
请求参数:

响应:
    code    M   int     返回码,0表示成功,其他表示错误
    msg     M   string  返回信息
    data     M  json     返回数据

示例:
request:
    GET http://teststation.guanmai.cn/station/return_stock_sheet/get_return_supplier

response:
    {
        'code': 0,
        'msg': 'ok',
        'data': [{
            'supplier_id': '供应商id',
            'supplier_name': '供应商名字'
        }]
    }

逻辑:
查询所有站点供应商信息
返回信息列表

7.拉取退货单列表(需要)

接口名:/station/stock/return_stock_sheet/list
Method:GET
请求参数:
    type        M   int         时间类型:1-按退货时间搜索;2-按建单时间搜索;
    start   M   date            开始时间
    end     M   date            截止时间
    status          O   int             状态 0-全部,1-待提交,2-已提交待审核,3-审核通过待付款,4-已结款,5-审核不通过,6-已删除
    search_text O   string          搜索文本
    export          O   int             是否导出:0-不导出,默认;1-导出;
    offset          O   int             分页offset
    limit           O   int             分页limit
响应:
    code    M   int     返回码,0表示成功,其他表示错误
    msg     M   string  返回信息
    data    M   list    返回json数据,结构看示例

示例:
request:
    GET http://teststation.guanmai.cn/station/return_stock_sheet/return?type=1&start_date=2016-10-25&end_date=2016-10-26

response:
    {
        'code': 0,
        'data': [
                {
                    'id':11112,                 # 退货单ID
                    'return_stock_time': '2016-10-24', # 退货时间
                    'supplier_id': 'T131',      # 供应商ID
                    ‘supplier_name': '阿米巴13', # 供应商名称
                    'money': 1111,      # 退货金额
                    'status': 2,        # 状态                    }
            ],
        'msg': 'ok',
    }

逻辑:
接受参数
按条件查询退货单列表
返回列表信息

8.拉取退货单详情(需要)

接口名:/station/stock/return_stock_sheet/detail
Method:GET
请求参数:
    id  M   int         退货单ID
    export                  O   int         0-不导出,1-导出

响应:
    code    M   int     返回码,0表示成功,其他表示错误
    msg     M   string  返回信息
    data    M   json    退货单单信息
示例:
request:
    GET http://teststation.guanmai.cn/station/return_stock_sheet/detail?id?=

response:
    {
        'code': 0,
        'msg': 'ok',
        'data': {
            'id': 'T002-YLTHD-2016-09-04-00008',
            'submit_time': '退货时间',
            'creator': '建单人',
            'supplier_id': '供应商ID',
            'supplier_name': '供应商名字'
            'total_price': 12000,
            'status': 1-已退货;2-未退货;3-已冲销,
            'details': [
                {
                    'id': '商品ID',
                    'name': '商品ID',
                    'category': '商品分类'
                    'quantity': 20,  #  退货数
                    'unit_price': 240,   # 退货单价
                    'total_item_price': 20 x 240,  # 退货金额
                    'operator': 'username',
                }
            ],
            // 折让
            'discount':[
                {
                    'operate_time': '操作时间',
                    'reason': 1-运输费用分摊;2-其他费用分摊,
                    'action': 1-加钱;2-减钱,
                    'money': 1234,
                    'remark': '备注',
                    'operator': '操作人ID',
                }
            ],
            'station_id': 'T002',
        }
    }

逻辑:
接受参数
根据单号查询详细信息
返回详细信息

9.新建退货单(需要)

接口名:/station/stock/return_stock_sheet/create
Method:POST
请求参数:
    user            M   user            django用户信息
    supplier_id     M   string          供应商ID
    supplier_name   M   stirng          供应商名称

响应:
    code    M   int     返回码,0表示成功,其他表示错误
    msg     M   string  返回信息
示例:
request:
    POST http://teststation.guanmai.cn/station/return_stock_sheet/create
    POST参数:
        supplier_id:'T131'
        supplier_name: '小农女'

response:
    {
        'code': 0,
        'msg': 'ok',
        'data': {
            'id': 134343,    # 退货单id
        },
    }

逻辑:
接受新建参数
校验参数合法性
新建退货单号
返回退货单号

10.编辑退货单(需要)

接口名:/station/stock/return_stock_sheet/modify
Method:POST
请求参数:
    id  M int               退货单ID
    return_stock_time   M   date            退货时间
    is_submit           M               1-保存草稿,2-提交
    details             M   json            原料信息,结构见示例
    discount            O   json            折让信息,结构见示例


响应:
    code    M   int     返回码,0表示成功,其他表示错误
    msg     M   string  返回信息

示例:
request:
    POST http://teststation.guanmai.cn/station/return_stock_sheet/update
    POST参数:
        return_stock_id: 13133
        return_stock_time: '2015-02-02 10:00'
        supplier_id: '供应商id'
        supplier_name: '供应商名字'
        is_submit: False
        details: [
                {
                    'id': '商品ID',
                    'name': '商品ID',
                    'category': '商品分类'
                    'quantity': 20,  #  退货数
                    'price': 240,   # 退货单价
                    'total_item_price': 20 x 240,  # 退货金额
                    'operator': 'username',
                }
            ]
        // 折让
        discount:[
            {
                'operate_time': '操作时间',
                'reason': 1-运输费用分摊;2-其他费用分摊,
                'action': 1-加钱;2-减钱,
                'money': 1234,
                'remark': '备注',
                'operator': '操作人ID',
            }
        ]
        station_id: 'T002'


response:
    {
        'code': 0,
        'msg': 'ok',
    }

逻辑:
接受修改参数
校验参数合法性
替换details,分摊,折让列表信息

11.审核退货单(需要)

接口名:/station/stock/return_stock_sheet/review
Method:POST
请求参数:
    id          M   int         出库单ID
    is_pass                         M   int         状态1-通过 2-不通过

响应:
    code    M   int     返回码,0表示成功,其他表示错误
    msg     M   string  返回信息

示例:
request:
    POST http://teststation.guanmai.cn/station/return_stock_sheet/modify_status
    POST参数
        id: '退货单id'
        status: '状态码'

response:
    {
        'code': 0,
        'msg': 'ok',
    }

逻辑:
接受参数
校验当前退货单状态:
   已提交:
       可修改状态
   其他:
       不通过

12.退货单冲销(需要)

接口名:/station/stock/return_stock_sheet/cancel
Method:GET
请求参数:
    id          M   int         出库单ID

响应:
    code    M   int     返回码,0表示成功,其他表示错误
    msg     M   string  返回信息

示例:
request:
    GET http://teststation.guanmai.cn/station/return_stock_sheet/cancel?id=

response:
    {
        'code': 0,
        'msg': 'ok',
    }

逻辑:
接受参数
校验退货单是否能冲销
   待提交,已提交:
       可冲销
   其他:
       不可冲销

退货单只有折让没有分摊

退货单折让沿用老接口

添加分摊之后,商品明细不能修改