产品查询

产品查询

产品查询:接口描述

URL

http://<系统域名>/client/Product/

接口功能

查询产品

支持格式

JSON

开发人员

 

请求方式

GET

发布日期

 

批量获取产品的示例如下:
批量获取产品信息

curl -X GET \ https://<系统域名>/client/product \ -H 'api_key: 248ccb90dff2b99465b54c113765360c' \ -H 'company_id: 36' \ -H 'content-type: application/json'

参数描述

批量获取产品与单个获取产品的信息格式相同,如下:

返回字段说明如下:

字段

注释

类型

字段

注释

类型

id

产品ID

INT(10)

name

产品中文名称

VARCHAR(100)

name_customs

产品英文名称

VARCHAR(100)

customs_category_id

海关分类编码ID

INT(10)

material

材料

VARCHAR(100)

usage

用途

VARCHAR(100)

brand

品牌

VARCHAR(100)

color

颜色

VARCHAR(100)

model

型号

VARCHAR(100)

url

链接

VARCHAR(500)

note

备注

VARCHAR(100)

shape_type

形状

普通形状NORMAL_SHAPE(默认)

轴状体NORMAL_SHAPE

不规则形状RREGULAR_SHAPE

client_ref

客户自定义SKU编码

VARCHAR(50)

weight

重量 默认单位 g

DECIMAL(10,2)

length

长度 默认单位 mm

DECIMAL(10,2)

width

宽度 默认单位 mm

DECIMAL(10,2)

depth

高度(深度) 默认单位 mm

DECIMAL(10,2)

is_shared_internal

是否是共享产品

TINYINT(1)

description

产品描述

TEXT

price

产品价格(货币每个站点不同,详询客服)

FLOAT(8,2)

cost

产品成本(货币每个站点不同,详询客服)

FLOAT(8,2)

price_customs_import

海关进口价格 (美元)

FLOAT(8,2)

price_customs_export

海关出口价格 (美元)

FLOAT(8,2)

low_stock_level

低库存报警线

INT(5)

inventory_time

在途产品入库天数

INT(3)

company_product-live_stock

当前站的产品库存

INT(10)

live_stock

所的站的产品库存之和

INT(10)

last_update_status_time

最后更新时间

DATETIME

company_product-last_in_stock_time

最后入库时间

DATETIME

company_product-last_out_stock_time

最后出库时间

DATETIME

company_product-last_stock_update_time

最后库存变动时间

DATETIME

create_time

创建时间

DATETIME

update_time

更新时间

DATETIME

dynamic_warehouse_stock_sequence

动态仓库存出库顺序

DYNAMIC_WAREHOUSE_STOCK_FIRST

(动态仓库存优先)

ORIGIN_WAREHOUSE_STOCK_FIRST

(起始仓库存优先)

status

产品状态

VARCHAR(50)

is_dynamic_warehouse_unsalable_product

是否动态仓滞销货

TINYINT(1)

country_of_origin

产地

国家的二字码:CN, GB 等

sales_price

平台销售价格

FLOAT(8,2)

可作为查询条件的参数如下:产品状态

字段

注释

类型

字段

注释

类型

status

产品状态


字符串,只能是 'PREPARING','PENDING','ACTIVE','PROBLEM','RECHECK','DELETED','OUT_OF_STOCK','DEPRECATED','REVIEWING',

'HOLD_INBOUND','HOLD_OUTBOUND' 这些值中的任意一个. 状态解释如下:

PREPARING:   准备中状态, 客户还在完善产品的各种信息, 新创建的产品默认是此状态.

PENDING: 待处理状态, 客户已经将产品信息完善好, 转交给仓库核查处理

PROBLEM: 仓库审核有问题, 需要客户再检查和完善

RECHECK: 客户修改好了, 待仓库重新审核

REVIEWING: 仓库审核中

ACTIVE: 产品经过仓库审核, 已是正常状态, 可下订单和下头程发货单

DELETED: 已删除此产品

OUT_OF_STOCK: 售罄状态, 待补充库存

DEPRECATED: 已下架, 不会继续销售

HOLD_INBOUND:只出不进, 只允许下订单, 不允许下头程发货单进行备货
HOLD_OUTBOUND:只进不出, 只允许下头程发货单备货, 不允许下订单

客户端可以操作的产品状态流: 

当前状态  → 允许跳转的状态

PREPARING → PENDING, PROBLEM, DELETED
PENDING → PREPARING,PROBLEM,DELETED
PROBLEM →  RECHECK,DELETED
ACTIVE → PROBLEM,DELETED

产品标准的状态流: 

PREPARING → PENDING → REVIEWING → ACTIVE

client_ref

客户SKU

字符串

company_ref

系统SKU

字符串(admin端存在)

name

产品名称

字符串

company_product-is_shared_internal

是否内部共享

数字,0或者1

company_product-is_shared_external

是否外部共享

数字,0或者1(admin端存在)

commodity_code

报关编码

字符串

with_parent_client_product

当前账号有父账号时,是否返回当前账号的父账号下的产品

数字,0或者1, 默认是1,会返回。

with_child_client_product

当前账号有子账号时,是否返回当前账号的子账号下的产品

数字,0或者1, 默认是1,  会返回。

请求描述

(以下为折叠内容,签署合同时以下信息无需参考,仅供第三方对接参考)