产品修改

产品信息修改:接口描述:

URL

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

URL

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

接口功能

产品信息修改

支持格式

JSON/TEXT

开发人员

 

请求方式

POST

发布日期

 

参数描述

字段

注释

是否必填

类型

字段

注释

是否必填

类型

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 等

请求描述

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

使用接口调试工具postman
请求描述

温馨提示:

1、修改订单信息时,需提供产品ID,举例:("id": 3055883,)。
2、产品ID后面填入需修改的字段和值即可,无需填充多余上传请求
HTPP请求格式

POST /client/Product/ HTTP/1.1 Host: {{Bird_URL}} Headres: api_key: {{api_key}} company_id: {{company_id}} Cookie: PHPSESSID=3s3nejv43u9bhirsrvq9nge254 Body raw { "price_internal": null, "product_volume_level_code": null, "product_stock_volume_level_code": null, "product_sales_level_code": null, "directional_share_total": null, "total": null, "price": null, "cost": null, "is_shared_internal": null, "is_shared_external": null, "client_dispatch_product_id": null, "product_stock_level_code": null, "company_id": null, "warehouse_id": null, "live_volume": null, "sales_quantity": null, "sales_volume": null, "volume": null, "id": 3055883, "client_id": 4790, "crossing_harbor_name_id": null, "customs_clear_name_id": null, "name": "null", "name_customs": "null", "material": "", "usage": "test", "brand": "test", "url": "http://www.test.com/aaa", "color": "red", "model": "test", "country_of_origin": null, "shape_type": "NORMAL_SHAPE", "product_risk_level": "LOW", "customs_value_level": "LOW", "customs_category_id": 1519, "commodity_code": null, "note": "测试测试", "description": "测试产品", "price_customs_import": "0", "price_customs_export": "5", "price_customs_export_internal": "0", "sales_price": null, "handling_fee": "0.00", "delivery_fee_adjustment": "0.00", "client_ref": "1621838764", "company_ref": null, "weight": "0.00", "length": "0.00", "width": "0.00", "depth": "0.00", "dimension_lock": "0", "live_stock": "0", "frozen_stock": "0", "pending_stock": "0", "low_stock_level": "0", "inventory_time": "0", "is_use_delivery_cost": "0", "is_no_handling_fee": "0", "is_vip": "0", "is_dynamic_warehouse_unsalable_product": "0", "is_need_to_record_sn": "0", "last_info_check_time": null, "last_stock_update_time": null, "last_in_stock_time": null, "last_out_stock_time": null, "last_update_status_time": "2021-05-24 14:46:04", "create_time": "2021-05-24 14:46:04", "update_time": "2021-05-24 14:46:04", "note_internal": "", "dynamic_warehouse_stock_sequence": "DYNAMIC_WAREHOUSE_STOCK_FIRST", "return_action": null, "status": "PREPARING", "primary_keys": [ "id" ] }

JSON格式返回结果

{ "data": { "price_internal": null, "product_volume_level_code": null, "product_stock_volume_level_code": null, "product_sales_level_code": null, "directional_share_total": null, "total": null, "price": null, "cost": null, "is_shared_internal": null, "is_shared_external": null, "client_dispatch_product_id": null, "product_stock_level_code": null, "company_id": null, "warehouse_id": null, "live_volume": null, "sales_quantity": null, "sales_volume": null, "volume": null, "id": 3055883, "client_id": 4790, "crossing_harbor_name_id": null, "customs_clear_name_id": null, "name": "null", "name_customs": "null", "material": "", "usage": "test", "brand": "test", "url": "http://www.test.com/aaa", "color": "red", "model": "test", "country_of_origin": null, "shape_type": "NORMAL_SHAPE", "product_risk_level": "LOW", "customs_value_level": "LOW", "customs_category_id": 1519, "commodity_code": null, "note": "测试测试", "description": "测试产品", "price_customs_import": null, "price_customs_export": "5.000", "price_customs_export_internal": "0.000", "sales_price": null, "handling_fee": "0.00", "delivery_fee_adjustment": "0.00", "client_ref": "1621838764", "company_ref": null, "weight": "0.00", "length": "0.00", "width": "0.00", "depth": "0.00", "dimension_lock": "0", "live_stock": "0", "frozen_stock": "0", "pending_stock": "0", "low_stock_level": "0", "inventory_time": "0", "is_use_delivery_cost": "0", "is_no_handling_fee": "0", "is_vip": "0", "is_dynamic_warehouse_unsalable_product": "0", "is_need_to_record_sn": "0", "last_info_check_time": null, "last_stock_update_time": null, "last_in_stock_time": null, "last_out_stock_time": null, "last_update_status_time": "2021-05-24 14:46:04", "create_time": "2021-05-24 14:46:04", "update_time": "2021-05-24 15:19:45", "note_internal": "", "dynamic_warehouse_stock_sequence": "DYNAMIC_WAREHOUSE_STOCK_FIRST", "return_action": null, "status": "PREPARING", "primary_keys": [ "id" ] }, "success": true, "moduleName": "client" }