客如云 API

查询供应链物品接口

测试环境

https://gldopenapi.keruyun.com

POST

/open/v1/supplyChain/warehouse/findSku

(下行接口)第三方合作方调用此接口，查询供应链物品

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://gldopenapi.keruyun.com/open/v1/supplyChain/warehouse/findSku?appKey=&shopIdenty=&brandId=&version=&timestamp=&sign=' \
--header 'Content-Type: application/json' \
--data-raw '{
  "brandId": 5200,
  "commercialId": -1,
  "shopId": -1,
  "start": 0,
  "limit": 1
}'

响应示例

{
    "code": 0,
    "message": "成功[OK]",
    "messageUuid": "f3947f2883e74b81bea5e45ace25456d",
    "result": {
        "data": [
            {
                "id": 364099009814576100,
                "shopId": 810094162,
                "shopName": "体验区测试品牌01store品牌1门店1",
                "typeCode": "MST190",
                "typeName": "饮用水(同步)",
                "skuCode": "SKU1660",
                "skuName": "测试AA",
                "wmType": 0,
                "barcode": "",
                "properties": [],
                "balancePrice": 10,
                "purchasePrice": 10,
                "skuUnits": [
                    {
                        "id": 364099009885879300,
                        "unitName": "听",
                        "skuConvert": 1,
                        "unitSmall": 1,
                        "unitPurchase": 1,
                        "unitStander": 1
                    }
                ],
                "skuLots": [
                    {
                        "id": 364099198727438340,
                        "warehouseId": 37844913051684860,
                        "warehouseCode": "WH001",
                        "storageId": -1,
                        "storageCode": "默认存储区",
                        "binId": -1,
                        "binCode": "默认库位",
                        "lotId": -1,
                        "qty": 99,
                        "price": 10,
                        "amount": 990,
                        "creatorId": 37931932893321220,
                        "creatorName": "123",
                        "createTime": "2020-06-01 17:20:13.0",
                        "updaterId": 37931932893321220,
                        "updaterName": "123",
                        "updateTime": "2020-08-28 14:41:06.0"
                    }
                ],
                "isDisable": 0,
                "isDelete": 0,
                "createTime": 1591003168000,
                "updateTime": 1600774000000,
                "guaranteePeriod": 0
            }
        ],
        "num": 1,
        "total": 658
    }
}

请求参数

Query 参数

appKey

string

必需

开发者申请服务客如云分配的appKey

默认值:

shopIdenty

string

必需

客如云门店id （门店维度接口传递门店ID）

默认值:

brandId

string

必需

客如云品牌id（品牌授权的接口传递品牌ID）

默认值:

version

string

必需

版本,默认2.0（1.0版本仍可用）

默认值:

2.0

timestamp

string

必需

时间戳,单位:秒,时间戳校验签名,开放平台校验签名时用此参数和服务器当前时间戳对比不能大于300秒，我方服务器使用阿里云授时中心

默认值:

sign

string

必需

签名，64位长度的字符串，获取规则详见签名规则

默认值:

Body 参数application/json

brandId

integer

必需

commercialId

integer

必需

shopId

integer

必需

客如云门店ID，（如果是品牌，请传-1）,默认-1

start

integer

偏移量

必需

limit

integer

单页条数

必需

typeName

string

商品类别

可选

wmType

integer

可选

库存类型: 1:预制商品, 2:现制品, 3:外购商品, 4:原料, 5:半成品，不传获取全部, 不传获取全部

skuCode

string

商品编码

可选

skuName

string

商品名称

可选

isDisable

integer

可选

商品状态:0启用；1停用

isDelete

integer

可选

商品状态：0正常;1删除

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

返回编码，详见错误码

message

string

返回信息

必需

messageUuid

string

消息uuid

必需

result

object

可选

返回响应数据，详见SupplyChainPageResponse

data

array [object {19}]

物品列表

可选

num

integer

必需

total

integer

总条数

必需

private

integer

本次请求返回条数

必需

券反核销

查询仓库列表