查询供应商列表 - 客如云 API

(下行接口)第三方合作方调用此接口，查询供应商列表

curl --location --request POST 'https://gldopenapi.keruyun.com/open/v1/supplyChain/supplier/fetchSupplierList?appKey=&shopIdenty=&brandId=&version=&timestamp=&sign=' \ --header 'Content-Type: application/json' \ --data-raw '{ "shopId": "75", "isDisable": 33 }'

{ "result": [ { "id": 4965, "supplierCode": "SP001", "supplierName": "默认供应商", "taxRate": 0, "isDisable": 0, "fullName": "", "contact": "", "website": "", "contactTel": "", "contactMail": "", "contactQq": "", "contractNo": "", "zipCode": "", "address": "", "invoiceName": "", "cuitNumber": "", "memo": "", "openingBank": "", "bankAccountNumber": "" }, { "id": 4982, "supplierCode": "SP002", "supplierName": "店长的店", "taxRate": 12, "isDisable": 0, "fullName": "", "contact": "", "website": "", "contactTel": "", "contactMail": "", "contactQq": "", "contractNo": "", "zipCode": "", "address": "", "invoiceName": "", "cuitNumber": "", "memo": "", "openingBank": "", "bankAccountNumber": "" } ], "code": 0, "message": "成功[OK]", "messageUuid": "2d88ff963f2f48c8880bae8ed22ca8d9" }

请求参数

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

shopId

string

必需

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

isDisable

integer

可选

状态：0停用 1启用，不传获取全部

supplierCateCode

string

供应商类型编码

可选

supplierCode

string

供应商编码

可选

supplierName

string

供应商名称

可选

示例

返回响应

🟢200成功

application/json

Body

result

array [object {19}]

可选

返回响应数据，详见SupplierVo

integer

供应商ID

必需

supplierCode

string

供应商编码

必需

supplierName

string

供应商名称

必需

taxRate

integer

税率

必需

isDisable

integer

必需

状态：0停用 1启用

fullName

string

供应商全称

必需

contact

string

联系人

必需

website

string

网址

可选

contactTel

string

联系电话

必需

contactMail

string

联系邮箱

可选

contactQq

string

联系QQ／微信

可选

contractNo

string

合同编号

必需

zipCode

string

邮编

可选

address

string

地址

可选

invoiceName

string

开票全称

可选

cuitNumber

string

税号

可选

memo

string

备注

可选

openingBank

string

银行名称

可选

bankAccountNumber

string

银行账号

可选

code

integer

必需

返回编码，详见错误码

message

string

返回信息

必需

messageUuid

string

消息uuid

必需