Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

Table of Contents

添加产品

URLhttp://test.birdsystem.com/client/Product/

接口功能

添加产品

支持格式


开发人员


请求方式

POST

发布日期


...

添加产品时, 需要以表单form的格式POST如下数据到接口: (注意不是json格式)

字段注释是否必填类型

name

产品中文名称

必填

VARCHAR(100)

url链接
VARCHAR(50)

name_customs

产品英文名称

必填

VARCHAR(100)

material材质
VARCHAR(50)
usage用途
VARCHAR(50)
brand品牌
VARCHAR(50)
color颜色
VARCHAR(100)
model型号
VARCHAR(100)
shape_type

形状


普通形状NORMAL_SHAPE(默认)

轴状体NORMAL_SHAPE

不规则形状RREGULAR_SHAPE

customs_category_id

海关分类编码ID


INT(10) . 参考接口:  获取海关分类 

product_product_customs_property[]产品属性

INT(10) . 参考接口:  获取产品属性 . 这些属性ID一般不常变动. 如有多个海关属性, 请传多个同名的form 字段, 例如:

product_product_customs_property[] = 1
product_product_customs_property[] = 3

note

备注


VARCHAR(100)

client_ref

客户自定义SKU编码(不能和其他SKU重复)


VARCHAR(50)

commodity_code

商品报关编码


VARCHAR(50)

weight

重量 默认单位 g


DECIMAL(10,2)

length

长度 默认单位 mm


DECIMAL(10,2)

width

宽度 默认单位 mm


DECIMAL(10,2)

depth

高度(深度)默认单位 mm


DECIMAL(10,2)

company_product-is_shared_internal

是否是共享产品


TINYINT(1)

description

产品描述


TEXT

company_product-price

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


FLOAT(8,2)

company_product-cost

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


FLOAT(8,2)

price_customs_import

海关进口价格 (美元)


FLOAT(8,2)

price_customs_export

海关出口价格(美元)

必填

FLOAT(8,2)

sales_price

销售价格 (美元)
FLOAT(8,2)

company_product-low_stock_level

低库存报警线


INT(5)

inventory_time

在途产品入库时间


INT(3)

attachment_url附件URL

VARCHAR(2000)

在创建或者更新产品时,同时上传一个或者多个附件, 一个URL指向一个附件,多个URL用\n换行符分隔.

ps: 附件是在后台队列中异步下载的,不会马上体现在界面上,可以通过 “查看后台运行任务” 来查看队列任务

附件可以是图片,pdf, doc,excel等文档,与产品详细页面的附件上传是同一个功能。

override_old_attachment是否覆盖旧的附件 (仅更新产品时有效)

TINYINT(1)

当当前请求是修改已有产品,且有提供附件时, 是否要覆盖掉旧的附件

status

不填写时,默认为preparing;

当值为PENDING时,添加的产品直接是待处理状态,不需要再更改状态


ENUM('PREPARING','PENDING')
is_need_to_record_sn是否需要记录产品sn唯一码
BOOL

country_of_origin

产地
国家的二字码:CN, GB 等

...