# 商品
#### 發布與編輯商品接口
> 調用該接口前，請確保發布商品的店鋪可以正常發布商品。發布商品前店鋪需要設置售賣區域，運費模板，如果有規格的話需要編輯規格值。
```
<pre class="calibre14">```
get:/index.php?ctl=Api_Goods_Goods&met=AddOrEditGoodsApi&typ=json
int:common_id#商品common_id。發布商品不用填寫，編輯商品需要填寫
string:name#商品名稱
row:spec#規格商品信息
string:code#商家貨號
string:action#發布商品不用傳值，編輯時傳值為‘edit’
int:shop_id#店鋪id
int:cat_id#商品分類id
row:sgcate_id#店鋪分類
string:cat_name#商品分類名稱，需要完整分類等級，例如“一級類目 > 二級分類 > 三級分類”
int:brand_id#品牌id
string:promotion_tips#副標題
string:imagePath#商品主圖
string:viedoPath#商品視頻
float:price#商品價格，精確到兩位小數
float:market_price#市場價格
float:coet_price#成本價格
int:stock#商品庫存
int:alarm#庫存預警值
int:formatid_top#頂部關聯版式
int:formatid_bottom#底部關聯版式
float:cubage=1#商品重量，默認為1
int:is_return#7天無理由退貨 1-退貨 0-不退
string:service#售后服務
string:packing_list#包裝清單
int:state=1#商品狀態，0下架，1正常，10違規（禁售）
string:is_recommend#是否推薦 1-不推薦 2-推薦
row:property#商品屬性
string:spec_name#規格名稱
int:transport_area_id#選擇售賣區域id
int:is_gv#是否是虛擬商品，0-不是 1-是
int:g_vindate#虛擬商品有效期（2019-04-24）
int:g_vinvalidrefund#支持過期退款 0-不支持 1-支持
string:starttime#定期發布商品（年-月-日）
string:hour#定時發布商品-時
string:minute#定時發布商品-分
row:spec_val#規格值
string:body#內容詳情
int:is_limit#商品是否限購 #0-不限購
row:fenxiao#分銷分傭比例
<<<
success
Array
(
[cmd_id] => -140
[status] => 200
[msg] => success
[data] => Array
(
[common_id] => 43 //新增成功后的商品common_id
)
)
<<<
error
Array
(
[cmd_id] => -140
[status] => 250
[msg] => '含有違禁詞'
[data] => Array ( )
)
Array
(
[cmd_id] => -140
[status] => 250
[msg] => '商品發布數量超出平臺限制！'
[data] => Array ( )
)
Array
(
[cmd_id] => -140
[status] => 250
[msg] => '市場價不能低于供貨價格'
[data] => Array ( )
)
Array
(
[cmd_id] => -140
[status] => 250
[msg] => '市場價不能低于商品價格'
[data] => Array ( )
)
Array
(
[cmd_id] => -140
[status] => 250
[msg] => '售后服務信息最多輸入200個字符'
[data] => Array ( )
)
Array
(
[cmd_id] => -140
[status] => 250
[msg] => '售賣區域有誤'
[data] => Array ( )
)
Array
(
[cmd_id] => -140
[status] => 250
[msg] => '請設置售賣區域'
[data] => Array ( )
)
Array
(
[cmd_id] => -140
[status] => 250
[msg] => '請設置運費模板'
[data] => Array ( )
)
Array
(
[cmd_id] => -140
[status] => 250
[msg] => '發布時間不能小于當前時間'
[data] => Array ( )
)
Array
(
[cmd_id] => -140
[status] => 250
[msg] => '最高零售價格不能低于最低零售價格'
[data] => Array ( )
)
```
```
```
<pre class="calibre14">```
$fenxiao <span class="token">=</span> Array
<span class="token1">(</span>
<span class="token1">[</span><span class="token6">0</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">3.00</span> <span class="token5">//一級傭金比例</span>
<span class="token1">[</span><span class="token6">1</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">2.00</span> <span class="token5">//二級傭金比例</span>
<span class="token1">[</span><span class="token6">2</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">1.00</span> <span class="token5">//三級傭金比例</span>
<span class="token1">)</span>
$property <span class="token">=</span> Array
<span class="token1">(</span>
<span class="token1">[</span>property_151<span class="token1">]</span> <span class="token">=</span><span class="token">></span> Array
<span class="token1">(</span>
<span class="token1">[</span><span class="token6">0</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> 測試屬性<span class="token6">1</span> <span class="token5">//屬性名稱</span>
<span class="token1">[</span><span class="token6">1</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">390</span> <span class="token5">//屬性值id</span>
<span class="token1">[</span><span class="token6">2</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> select <span class="token5">//顯示類型</span>
<span class="token1">[</span><span class="token6">3</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">151</span> <span class="token5">//屬性id</span>
<span class="token1">)</span>
<span class="token1">)</span>
$spec_name <span class="token">=</span> Array
<span class="token1">(</span>
<span class="token1">[</span><span class="token6">10</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> 測試規格<span class="token6">1</span> <span class="token5">//主鍵為規格id，值為規格名稱</span>
<span class="token1">[</span><span class="token6">11</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> 測試規格<span class="token6">2</span>
<span class="token1">)</span>
$spec_val <span class="token">=</span><span class="token">></span> Array
<span class="token1">(</span>
<span class="token1">[</span><span class="token6">10</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> Array <span class="token5">//主鍵為規格id</span>
<span class="token1">(</span>
<span class="token1">[</span><span class="token6">45</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> S <span class="token5">//主鍵為規格值id，值為規格值名稱</span>
<span class="token1">[</span><span class="token6">46</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> M
<span class="token1">)</span>
<span class="token1">[</span><span class="token6">11</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> Array
<span class="token1">(</span>
<span class="token1">[</span><span class="token6">47</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">10</span>
<span class="token1">)</span>
<span class="token1">)</span>
$spec <span class="token">=</span><span class="token">></span> Array
<span class="token1">(</span>
<span class="token1">[</span>i_4547<span class="token1">]</span> <span class="token">=</span><span class="token">></span> Array <span class="token5">//主鍵為'i_'拼接規格值id，規格值id由小到大排序</span>
<span class="token1">(</span>
<span class="token1">[</span>goods_id<span class="token1">]</span> <span class="token">=</span><span class="token">></span>
<span class="token1">[</span>sp_value<span class="token1">]</span> <span class="token">=</span><span class="token">></span> Array
<span class="token1">(</span>
<span class="token1">[</span><span class="token6">45</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> S <span class="token5">//主鍵為規格值id，值為規格值名稱</span>
<span class="token1">[</span><span class="token6">47</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">10</span>
<span class="token1">)</span>
<span class="token1">[</span>market_price<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">200.3</span> <span class="token5">//市場價</span>
<span class="token1">[</span>price<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">152.3</span> <span class="token5">//商品價格</span>
<span class="token1">[</span>stock<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">1000</span> <span class="token5">//庫存</span>
<span class="token1">[</span>alarm<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">10</span> <span class="token5">//庫存預警值</span>
<span class="token1">[</span>sku<span class="token1">]</span> <span class="token">=</span><span class="token">></span> A001 <span class="token5">//商家貨號</span>
<span class="token1">)</span>
<span class="token1">[</span>i_4647<span class="token1">]</span> <span class="token">=</span><span class="token">></span> Array
<span class="token1">(</span>
<span class="token1">[</span>goods_id<span class="token1">]</span> <span class="token">=</span><span class="token">></span>
<span class="token1">[</span>sp_value<span class="token1">]</span> <span class="token">=</span><span class="token">></span> Array
<span class="token1">(</span>
<span class="token1">[</span><span class="token6">46</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> M
<span class="token1">[</span><span class="token6">47</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">10</span>
<span class="token1">)</span>
<span class="token1">[</span>market_price<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">200.3</span>
<span class="token1">[</span>price<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">152.3</span>
<span class="token1">[</span>stock<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">2000</span>
<span class="token1">[</span>alarm<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">20</span>
<span class="token1">[</span>sku<span class="token1">]</span> <span class="token">=</span><span class="token">></span> A002
<span class="token1">)</span>
<span class="token1">)</span>
$sgcate_id <span class="token">=</span><span class="token">></span> Array
<span class="token1">(</span>
<span class="token1">[</span><span class="token6">0</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">2</span> <span class="token5">//店鋪分類id</span>
<span class="token1">)</span>
```
```
#### 編輯圖片
```
<pre class="calibre14">```
get:/index.php?ctl=Api_Goods_Goods&met=saveGoodsImage&typ=json
*int:common_id#商品common_id
*row:image#商品圖片信息
int:is_color#是否含有顏色規格 1-有，不含有顏色規格不傳值
<<<
success
{
????"cmd_id":-140,
????"status":200,
????"msg":"success",
????"data":[
????????[
????????????{
????????????????"name":"[http://localhost/bbc/shop/image.php/shop/data/upload/media/421aa90e079fa326b6494f812ad13e79/10018/4/image/20190419/1555661347887530.png]", //圖片地址
????????????????"default":"1", //默認主題，1是，0否
????????????????"displayorder":"0" //排序
????????????},
????????????{
????????????????"name":"",
????????????????"default":"",
????????????????"displayorder":"0"
????????????},
????????????{
????????????????"name":"",
????????????????"default":"",
????????????????"displayorder":"0"
????????????},
????????????{
????????????????"name":"",
????????????????"default":"",
????????????????"displayorder":"0"
????????????},
????????????{
????????????????"name":"",
????????????????"default":"",
????????????????"displayorder":"0"
????????????}
????????]
????]
}
<<<
error
{
????"cmd_id":-140,
????"status":250,
????"msg":"缺少common_id",
????"data":[ ]
}
{
????"cmd_id":-140,
????"status":250,
????"msg":"缺少圖片信息",
????"data":[ ]
}
```
```
```
<pre class="calibre15">```
<span class="token">~</span><span class="token">~</span><span class="token">~</span>
$image <span class="token">=</span><span class="token">></span> Array
<span class="token1">(</span>
<span class="token1">[</span><span class="token6">53</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> Array <span class="token5">//有顏色規格則主鍵為顏色規格id ,沒有顏色規格則主鍵為0</span>
<span class="token1">(</span>
<span class="token1">[</span><span class="token6">0</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> Array
<span class="token1">(</span>
<span class="token1">[</span>name<span class="token1">]</span> <span class="token">=</span><span class="token">></span> http<span class="token1">:</span><span class="token">/</span><span class="token">/</span>localhost<span class="token">/</span>bbc<span class="token">/</span>shop<span class="token">/</span>image<span class="token1">.</span>php<span class="token">/</span>shop<span class="token">/</span>data<span class="token">/</span>upload<span class="token">/</span>media<span class="token">/</span><span class="token6">421</span>aa90e079fa326b6494f812ad13e79<span class="token">/</span><span class="token6">10018</span><span class="token">/</span><span class="token6">4</span><span class="token">/</span>image<span class="token">/</span><span class="token6">20190419</span><span class="token">/</span><span class="token6">1555661347887530.</span>png <span class="token5">//圖片地址</span>
<span class="token1">[</span>default<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">1</span> <span class="token5">//默認主題，1是，0否</span>
<span class="token1">[</span>displayorder<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">0</span> <span class="token5">//排序</span>
<span class="token1">)</span>
<span class="token1">[</span><span class="token6">1</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> Array
<span class="token1">(</span>
<span class="token1">[</span>name<span class="token1">]</span> <span class="token">=</span><span class="token">></span>
<span class="token1">[</span>default<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">0</span>
<span class="token1">[</span>displayorder<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">0</span>
<span class="token1">)</span>
<span class="token1">[</span><span class="token6">2</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> Array
<span class="token1">(</span>
<span class="token1">[</span>name<span class="token1">]</span> <span class="token">=</span><span class="token">></span>
<span class="token1">[</span>default<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">0</span>
<span class="token1">[</span>displayorder<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">0</span>
<span class="token1">)</span>
<span class="token1">[</span><span class="token6">3</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> Array
<span class="token1">(</span>
<span class="token1">[</span>name<span class="token1">]</span> <span class="token">=</span><span class="token">></span>
<span class="token1">[</span>default<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">0</span>
<span class="token1">[</span>displayorder<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">0</span>
<span class="token1">)</span>
<span class="token1">[</span><span class="token6">4</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> Array
<span class="token1">(</span>
<span class="token1">[</span>name<span class="token1">]</span> <span class="token">=</span><span class="token">></span>
<span class="token1">[</span>default<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">0</span>
<span class="token1">[</span>displayorder<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">0</span>
<span class="token1">)</span>
<span class="token1">)</span>
<span class="token1">[</span><span class="token6">165</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> Array
<span class="token1">(</span>
<span class="token1">[</span><span class="token6">0</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> Array
<span class="token1">(</span>
<span class="token1">[</span>name<span class="token1">]</span> <span class="token">=</span><span class="token">></span> http<span class="token1">:</span><span class="token">/</span><span class="token">/</span>localhost<span class="token">/</span>bbc<span class="token">/</span>shop<span class="token">/</span>image<span class="token1">.</span>php<span class="token">/</span>shop<span class="token">/</span>data<span class="token">/</span>upload<span class="token">/</span>media<span class="token">/</span><span class="token6">421</span>aa90e079fa326b6494f812ad13e79<span class="token">/</span><span class="token6">10018</span><span class="token">/</span><span class="token6">4</span><span class="token">/</span>image<span class="token">/</span><span class="token6">20190507</span><span class="token">/</span><span class="token6">1557208836124082.</span>png
<span class="token1">[</span>default<span class="token1">]</span> <span class="token">=</span><span class="token">></span>
<span class="token1">[</span>displayorder<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">0</span>
<span class="token1">)</span>
<span class="token1">[</span><span class="token6">1</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> Array
<span class="token1">(</span>
<span class="token1">[</span>name<span class="token1">]</span> <span class="token">=</span><span class="token">></span> http<span class="token1">:</span><span class="token">/</span><span class="token">/</span>localhost<span class="token">/</span>bbc_jiheng<span class="token">/</span>shop<span class="token">/</span>image<span class="token1">.</span>php<span class="token">/</span>shop<span class="token">/</span>data<span class="token">/</span>upload<span class="token">/</span>media<span class="token">/</span><span class="token6">421</span>aa90e079fa326b6494f812ad13e79<span class="token">/</span><span class="token6">10018</span><span class="token">/</span><span class="token6">4</span><span class="token">/</span>image<span class="token">/</span><span class="token6">20190507</span><span class="token">/</span><span class="token6">1557208894771000.</span>png
<span class="token1">[</span>default<span class="token1">]</span> <span class="token">=</span><span class="token">></span>
<span class="token1">[</span>displayorder<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">0</span>
<span class="token1">)</span>
<span class="token1">[</span><span class="token6">2</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> Array
<span class="token1">(</span>
<span class="token1">[</span>name<span class="token1">]</span> <span class="token">=</span><span class="token">></span>
<span class="token1">[</span>default<span class="token1">]</span> <span class="token">=</span><span class="token">></span>
<span class="token1">[</span>displayorder<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">0</span>
<span class="token1">)</span>
<span class="token1">[</span><span class="token6">3</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> Array
<span class="token1">(</span>
<span class="token1">[</span>name<span class="token1">]</span> <span class="token">=</span><span class="token">></span>
<span class="token1">[</span>default<span class="token1">]</span> <span class="token">=</span><span class="token">></span>
<span class="token1">[</span>displayorder<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">0</span>
<span class="token1">)</span>
<span class="token1">[</span><span class="token6">4</span><span class="token1">]</span> <span class="token">=</span><span class="token">></span> Array
<span class="token1">(</span>
<span class="token1">[</span>name<span class="token1">]</span> <span class="token">=</span><span class="token">></span>
<span class="token1">[</span>default<span class="token1">]</span> <span class="token">=</span><span class="token">></span>
<span class="token1">[</span>displayorder<span class="token1">]</span> <span class="token">=</span><span class="token">></span> <span class="token6">0</span>
<span class="token1">)</span>
<span class="token1">)</span>
<span class="token1">)</span>
<span class="token">~</span><span class="token">~</span><span class="token">~</span>
```
```
- 序言
- 系統要求
- 版本更新日志
- 遠豐商城技術對接說明
- 開發指導
- 框架內容
- 基礎
- 開發規范
- 目錄結構
- 架構
- 架構總覽
- 數據庫
- 數據庫連接
- 基本使用
- 緩存
- 配置
- 路由
- 數據字典
- ucenter
- shop
- paycenter
- ucenter_admin
- shop_admin
- paycenter_admin
- 通訊內容
- 商家中心
- 頂部導航欄
- 店鋪信息欄
- 店鋪及商品提示欄
- 交易提示欄
- 銷售情況統計欄
- 單品銷量排行欄
- 店鋪運營推廣欄
- 平臺聯系方式欄
- 訂單物流
- 商品
- 商品列表
- 商品詳情
- 商品發布與編輯
- 分銷商品
- 關聯版式
- 商品規格
- 圖片空間
- 淘寶導入
- 訂單流程
- 交易訂單
- 訂單退款/退貨
- 促銷
- 團購管理
- 加價購
- 限時折扣
- 滿即送
- 代金券管理
- 分銷
- 店鋪
- 店鋪設置
- 自銷產品供應商
- 實體店鋪
- 品牌申請
- 店鋪信息
- 消費者保障服務
- 門店賬號
- 分銷商--產品供應商
- 分銷明細
- 批發市場
- 售后服務
- 咨詢管理
- 投訴管理
- 退款管理
- 退貨管理
- 云方案架構
- 負載集群
- 云存儲
- 接口
- Api接口說明
- 品牌
- 商品規格
- 商品類型
- 商品分類
- 商品
- 訂單
- 商品/店鋪收藏
- 足跡
- 退款及退貨
- 商家店鋪
- 會員
- 入駐協議
- 訂單接口
- 商品接口
- 訂單物流接口
- 商家中心接口
- 促銷接口
- 快遞鳥物流接口
- 代金券接口
- 首頁版塊
- 團購
- 平臺紅包
- 限時折扣接口
- 拼團接口
- wap首頁模板
- 雜項
- 遠程上傳圖片
- JS
- 銀聯支付
- 多語言
- 商品評分
- 圖片加載
- 買家申請退款退貨
- 商家退款退貨
- 平臺退款退貨
- 添加發票
- 提交訂單
- 確認訂單
- 運費銷售區域
- 獲取會員地址
- 充值
- 導出XLS
- 商城系統集成
- 多語言實現
- 三級分銷推廣鏈接發展推廣員
- app.ini.php
- 去分銷
- 版本更新
- 物流支持
- 運營人員建議
- 業務邏輯
- 統計結算
- 客服消息
- 賬號
- 三級分銷
- IM
- 配置
- 平臺帳號
- 活動數據表說明