Skip to content

货位管理

页面接口

/stock/shelf/get 获取货位信息(修改老接口,去掉了层级的概念)

接口
    /stock/shelf/get
Method
    get
请求参数:
   无
响应:
    code : 0
    msg : "ok"
    data: [
                {
                    level               M         int           级别
                    shelf               M         list          货位信息
                }

                ......
          ]

          其中shelf的内容具体如下:
          shelf:[
                    {
                        name            M         str           货位名称
                        parent_id       M         str           父id           
                        shelf_id        M         int           货位id
                    }

                    ......
                ] 

/stock/shelf/spu/summary 按货位/按商品 搜索统计信息 (新接口)

接口
    /stock/shelf/spu/summary

Method
    get

请求参数:
    shelf_id              O          int        货位id(未分配:-1)
    spu_id                O          str        商品id

响应:
    code : 0
    msg : "ok"
    若传过来参数为:shelf_id,则返回:
    data:
              {
                    spu_sum                              M         int             商品总数
                    stock_sum                            M         double          库存总数
                    stock_sum_money                      M         double          库存总货值
              }
    若传过来参数为:spu_id,则返回:
    data:
          {
                shelf_sum                          M         int             商品总数
                stock_sum                          M         double          库存总数
                stock_sum_money                    M         double          库存总货值

          }

/stock/shelf/spu/list 按货位搜索查询库存大于0的商品列表(包括对搜索结果进行按商品名或id的二次查询)

接口
    /stock/shelf/spu/list

Method
    get

请求参数:
    shelf_id              O          int        货位id
    q                     O          str        商品id/商品名
    page_obj              O          string     起始页(不包含),默认第0页
    limit                 O          int        返回条数,默认10。传0表示返回所有数据
    offset                O          int        查询起点偏移条数,默认0

响应:
    code : 0
    msg : "ok"
    data:
         [
             {
                 spu_id                          M          str              商品id
                 spu_name                        M          str              商品名称
                 image                           M          str              商品图片(spu主图)
                 batch_count                     M          int              该商品的批次数
                 stock_num                       M          double           该商品的库存数
                 stock_money                     M          double           该商品的库存货值
             }

             ......
         ]

    pagination: 
              {                                 
                  more                            M       bool    是否有更多数据
                  page_obj                        M       string
              }

/stock/shelf/spu_negative/list 按货位搜索查询负库存列表

接口
   /stock/shelf/spu_negative/list

Method
    get

请求参数:
    shelf_id              M          int        货位id
    page_obj              O          string     起始页(不包含),默认第0页
    limit                 O          int        返回条数,默认10。传0表示返回所有数据
    offset                O          int        查询起点偏移条数,默认0

响应:
    code : 0
    msg : "ok"
    data:[
              {
                  spu_id                          M          str              商品id
                  spu_name                        M          str              商品名称
                  image                           M          str              商品图片(spu主图)
                  batch_count                     M          int              该商品的批次数
                  stock_num                       M          double           该商品的库存数
                  stock_money                     M          double           该商品的库存货值
              }

              ......
          ]
    pagination: 
              {                                 
                  more                            M       bool    是否有更多数据
                  page_obj                        M       string
              }

/stock/list 获取商品列表(复用老接口)

接口:
    /stock/list
Method
    get
请求参数:
    category1_ids           O          list            一级分类
    category2_ids           O          list            二级分类
    text                    O          str             商品名称或id
    limit                   O          int             返回条数,默认10。传0表示返回所有数据
    offset                  O          int             查询起点偏移条数,默认0
响应:
    具体看页面

/stock/shelf/list 按商品搜索查询货位列表(包括对搜索结果进行按货位名的二次查询)

    /stock/shelf/list

Method
    get

请求参数:
        spu_id                  O          str        商品id
        shelf_name              O          str        货位name
        page_obj                O          string     起始页(不包含),默认第0页
        limit                   O          int        返回条数,默认10。传0表示返回所有数据
        offset                  O          int        查询起点偏移条数,默认0

响应:
    code : 0
    msg : "ok"
    data:
            [
                {
                    shelf_root_name            M            str             总货位目录的名称
                    shelf_list                 M            list            总货位目录下自货位详情

                }
                ......
            ]

    shelf_list的内容格式如下:
    shelf_list:[
                    {
                        shelf_name          M           str             货位名称
                        is_distribution     M           bool            是否是未分配区域(未分配:false, 分配:true)
                        batch_count         M           int             批次数
                        stock_num           M           double          库存数
                        stock_money         M           double          库存货值
                    }
                    ......
                ]

    pagination: 
                  {                                 
                      more                            M       bool    是否有更多数据
                      page_obj                        M       string
                  }

/stock/check/batch_number/list(修改老接口) 按货位搜索后的移库列表/盘点列表/按商品搜索后的盘点列表/以及页面内按存放货位或其他搜索条件的二次搜索

接口
    /stock/check/batch_number/list
Method
    get
请求参数:
    spu_id                  O               str             商品id
    shelf_id                M               int             货位id
    view_shelf              O               int             1:表明是按货位查询时调用的
    remain_positive         O               int             1:表明是拉取正库存列表批次
    remain_negative         O               int             1:表明是拉取负库存列表批次
    batch_edit              O               int             1: 表明是盘点正库存那里,需拉取库存>=0的批次
    q                       O               str             过滤条件(供应商或批次)
    limit                   O               int             返回条数,默认10。传0表示返回所有数据
    offset                  O               int             查询起点偏移条数,默认0
    peek                    O               int             页码
响应:
    code : 0
    msg : "ok"
    data:[
              {     
                    batch_number            O       str        批次号
                    create_time             O       date       创建时间
                    life_time               O       date       保质期
                    production_time         O       date       生产日期
                    remain                  O       double     剩余库存(抄盘数)
                    settle_supplier_id      O       str        供应商id
                    supplier_name           O       str        供应商name
                    shelf_id                O       int        移出货位id
                    shelf_name              O       str        移出货位 名称
                    batch_avg_price         O       double     批次库存均价
                    std_unit_name           O       str        基本单位

              }

              ......
          ]
    pagination: 
                      {                                 
                          more                            M       bool    是否有更多数据
                          page_obj                        M       string
                          peek                            M       int   
                      }


/station/stock/inner_transfer_sheet/create 提交货位移库 (复用老接口)

接口
    /station/stock/inner_transfer_sheet/create
Method
    post
请求参数:
    status
    details: [
        {
            spu_id                      M       str         商品id
            out_batch_num               M       str         移出批次号
            remark                      M       str         备注 
            in_shelf_id                 M       str         移入货位
            out_amount                  M       double      移库数

        }

        ......
    ]
响应:
    code : 0
    msg : "ok"
    data:{
            sheet_no        M       str         移库单号
          }

/stock/check/batch_edit 提交盘点功能(批次盘点复用老接口)

接口
    /stock/check/batch_edit
Method
    post
请求参数:
    batch_number         M           str         批次号
    new_remain           M           double      实盘数
    remark               O           str         备注

响应:
    code : 0
    msg : "ok"
    data : null

/stock/shelf_location/add 增加货位信息(修改老接口)

接口
    /stock/shelf_location/add
Method
    post
请求参数:
    name                        M             str        货位名称
    parent_id                   O             int        上层目录id
响应:
    code : 0
    msg : "ok"
    data:{
                id                  M              str         货位id
          }

/stock/shelf_location/edit 编辑货位信息(复用老接口)

接口
    /stock/shelf_location/edit
Method
    post
请求参数:
    id                              M             str        货位id
    new_name                        M             str        新名称
响应:
    code : 0
    msg : "ok"
    data:null

/stock/shelf_location/delete 删除货位信息(修改老接口)

接口
    /stock/shelf_location/delete
Method
    post
请求参数:
    id                              M             str        货位id
响应:
    code : 0
    msg : "ok"
    data:null