Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents


1、接口说明:

URL

http://test.birdsystem.com/client/product/Get-Product-Available-Quantity?ids=2989352

接口功能


获取产品有效库存

支持格式

JSON
URL

开发人员


请求方式

GET

发布日期


请求json参数说明:

参数

必选

说明

类型

ids

Status
colourRed
title必填

产品id

VARCHAR(255)

返回字段:

返回字段

字段类型

说明

live_stock

INT

当前站点库存

current_locked_stock

INT

当前站点下被占有库存

dynamic_warehouse_available_stock

INT

动态仓可用库存

id

INT

产品ID

接口示例:

接口请求示例

地址:http://test.birdsystem.com/client/product/Get-Product-Available-Quantity?ids=2989352

Code Block
languagejs
  # api_key和company_id和提交数据中的delivery_service_id需要替换成实际数据
  -Headers 'api_key: {{bs.default_api_key}}' \	#所需登录站点company_id
  -Headers 'company_id: {{bs.default_company_id}}' \	#所需登录账号的api_key
  -Headers 'content-type: application/json' \

请求参数示例

请求方式url:支持获取多个产品库存信息

url:https://branch.birdsystem.com/client/product/Get-Product-Available-Quantity?ids=2989429,2989354

请求方式json:

Code Block
{
    "ids":2989354
    }

接口返回示例

Code Block
{
    "data": [
        {
            "live_stock": 94,
            "current_locked_stock": 21,
            "dynamic_warehouse_available_stock": 0,
            "id": 2989352
        }
    ],
    "success": true,
    "refresh": false,
    "moduleName": "client"
}

返回异常示例

请求参数:

Code Block
{
    "ids":2981
}

返回结果:

Code Block
{
    "success": false,
    "message": "Product with id 2981 does not belong to you."
}

需确保请求参数的ids的值在是正确的

地址: http://test.birdsystem.com/client/product/Get-Product-Available-Quantity?ids=1302332

只读,批量获取产品可用库存

参数

字段

备注

类型

说明

ids

产品id集合

string

多个产品id以 ',' 分割,查询定向共享产品时格式为 产品ID|D,

例如客户2定向共享给客户1的产品3,客户1查询的时候格式为3|D。查询多个产品时参数ids=2,3|D

company_id

查询对应站点的库存

int

返回

Code Block
{
    "data": [
        {
            "live_stock": 551,     //当前库存
            "current_locked_stock": 64,    //占用库存
            "dynamic_warehouse_available_stock": 0,  //动态仓有效库存
            "id": 50631
        },
        {
            "live_stock": 61,  //当前库存
            "current_locked_stock": 18,   //占用库存
            "dynamic_warehouse_available_stock": 0,   //动态仓有效库存
            "id": 2023320
        }
    ],
    "success": true,
    "refresh": false,
    "moduleName": "client"
}

可用库存为live_stock - current_locked_stock