# 5、通用信息


## 5.1 商品结构与关系

![img](https://s3.forcloudcdn.com/item/images/dmc/bc3a5a59-d896-4947-8546-e6ef3412c417-884x635.png)



## 5.2 商品信息结构详述

5.2.1 商品基本信息
| 名称  描述 | 备注 
|------------|------------|------------|
| titleLang | 标题多语言,结构Map 类型,key:多语言代码,value:标题内容  notes:  1.目前支持 zh,en,ar 语言展示  2.不允许输入表情符 | 多语言代码 |
| overviewLang
| 概括内容多语言,结构Map 类型,key:多语言代码,value:详情内容  notes:1.目前支持 zh,en,ar 语言展示  2.不允许输入表情符   |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------|
| itemNo | 商品货号,最好维护成店铺下所有商品唯一 |  |
| deliverDay  履约时效(3天/7天)，选择7天,可售国家不能包括中东国家 |  
|------------------------------------|---------------------------------------------------------------------------------------------|------|

5.2.2 商品属性
商品属性属于对商品的描述信息 1. 用户可以根据这些商品属性词搜索到需要的商品 , 促成订单。 2. 用户可以在详情页面查看到商品的描述内容。
| 名称  描述 | 备注 
|------------|------------|------------|
| propertyId | 属性项id  notes:require = true 时必须填写 |  |
| propName  属性项名称 |  
|------------------------------|---------------------|------|
| valueId | 属性值id,propDataType = 2 时必须填写 |  |
| valueName  属性值名称,传入中文即可 |  
|---------------------------------|------------------------------------------|------|
| propDataType | 属性类型：  2：限制可选项类型；3：自定义文本类型；4：自定义数值类型；5：自定义时间类型 |  |
| customAttr  自定义属性类型需要填写的信息 |  
|------------------------------------|------------------------------------------------|------|

5.2.3 sku
一个商品拥有多个 sku, 每个 sku 是包含 2 级 sku 属性 ,sku 数量 = L1(第一级 sku 属性 ) * L2( 第二级 sku 属性 )
notes: 第一级 sku 属性 : sku图片只能挂载第一级 sku 属性上
| 关键字段  描述 |  
|------------------|------------|------|
| skuProperties | sku属性,必须是2级sku属性 |  |
| purchasePrice  美元预估收入,预估收入定价模式店铺必填 |  
|---------------------------------------------|---------------------------------------------------------------|------|
| counrtySalePrice | 美元售价，直接定售价模式店铺必填 |  |
| stock  库存 |  
|---------------------|------------|------|
| skuNo | sku编码,必须是全店铺唯一 |  |
| gtin  gtin码 | gtin码标准参考 
|------------------|---------------------|---------------------------------|
| weight | 称重 | 重要,涉及国际物流成本计算,影响预估收入计算与商品售价 |
| volume  体积 | 重要,涉及国际物流成本计算,影响预估收入计算与商品售价 
|------------------------|------------|---------------------------------------------------------------------------------------|

5.2.4 商品尺码表
| 字段  描述 | 备注 
|------------|------------|------------|
| sizeItem | 尺码列,此数据可以通过获取类目详情接口获取 |  |
| sizeRow
| 尺码行数据Q:sku属性有两级,如何区分使用哪级属性作为尺码行?A:/getPostCategoryDetail ,properties.sku = true && properties.feature.size_group = 1 为sku尺码属性项   |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------|
| sizeVals | 尺码值,map 结构,key:尺码行id,value:数组,对应每一列的数值 |  |

5.2.5 商品图片
商品图片需展示完整商品，不可包含其他非售卖商品。图片不能带有 logo 、文字或水印，宽高比例为 1 ： 1 （建议 750x750 ），大小不超过 1M 。
平台会对非平台图片进行下载转换 , 请输入图片最好是可下载正常的商品。
简单检测 header 200 , 无重定向 302,content-length > 0

| 关键字段  描述 | 备注 
|------------------|------------|------------|
| headPics | 头图-限制8张,第一张图片为封面图 |  |
| descPics  详情图-18张 |  
|------------------------------|---------------------------|------|

####



## 5.3 附录

通用返回码 通用返回码
| 返回码  描述 | 备注 
|---------------|------------|------------|
| 1001 | 成功 |  |
| 1002  业务失败 |  
|------------------|------------------|------|
| 500 | 服务器发生异常 |  |
| 400  参数异常 |  
|---------------|------------------|------|
| 404 | 找不到数据 |  |
| 0  未知异常 |  
|---------|------------------|------|

国家编码
两位数国家 / 地区代码。格式为 ISO 3166-1-alpha 2
见： [https://zh.wikipedia.org/wiki/ISO_3166-1 ]()

#### 当前平台可售国家清单 | 阿富汗 | AF |
| 阿尔及利亚  DZ |
|---------------------|------------|
| 安道尔 | AD |
| 安哥拉  AO |
|---------------|------------|
| 安圭拉 | AI |
| 安提瓜和巴布达  AG |
|---------------------------|------------|
| 阿根廷 | AR |
| 亚美尼亚  AM |
|------------------|------------|
| 阿鲁巴 | AW |
| 阿塞拜疆  AZ |
|------------------|------------|
| 巴哈马 | BS |
| 孟加拉国  BD |
|------------------|------------|
| 巴巴多斯 | BB |
| 白俄罗斯  BY |
|------------------|------------|
| 伯利兹 | BZ |
| 贝宁  BJ |
|------------|------------|
| 百慕大 | BM |
| 不丹  BT |
|------------|------------|
| 博茨瓦纳 | BW |
| 布韦岛  BV |
|---------------|------------|
| 英属维尔京群岛 | VG |
| 文莱  BN |
|------------|------------|
| 保加利亚 | BG |
| 布基纳法索  BF |
|---------------------|------------|
| 布隆迪 | BI |
| 柬埔寨  KH |
|---------------|------------|
| 喀麦隆 | CM |
| 加拿大  CA |
|---------------|------------|
| 佛得角 | CV |
| 加勒比荷兰  BQ |
|---------------------|------------|
| 开曼群岛 | KY |
| 中非  CF |
|------------|------------|
| 乍得 | TD |
| 智利  CL |
|------------|------------|
| 中国 | CN |
| 科科斯（基林）群岛  CC |
|---------------------------------|------------|
| 哥伦比亚 | CO |
| 科摩罗  KM |
|---------------|------------|
| 刚果（金） | CD |
| 库克群岛  CK |
|------------------|------------|
| 哥斯达黎加 | CR |
| 古巴  CU |
|------------|------------|
| 库拉索 | CW |
| 塞浦路斯  CY |
|------------------|------------|
| 科特迪瓦 | CI |
| 吉布提  DJ |
|---------------|------------|
| 多米尼克 | DM |
| 多米尼加  DO |
|------------------|------------|
| 厄瓜多尔 | EC |
| 埃及  EG |
|------------|------------|
| 萨尔瓦多 | SV |
| 赤道几内亚  GQ |
|---------------------|------------|
| 厄立特里亚 | ER |
| 爱沙尼亚  EE |
|------------------|------------|
| 埃塞俄比亚 | ET |
| 福克兰群岛  FK |
|---------------------|------------|
| 法罗群岛 | FO |
| 斐济  FJ |
|------------|------------|
| 法属波利尼西亚 | PF |
| 加蓬  GA |
|------------|------------|
| 冈比亚 | GM |
| 格鲁吉亚  GE |
|------------------|------------|
| 加纳 | GH |
| 直布罗陀  GI |
|------------------|------------|
| 格陵兰 | GL |
| 格林纳达  GD |
|------------------|------------|
| 瓜德罗普 | GP |
| 危地马拉  GT |
|------------------|------------|
| 根西 | GG |
| 几内亚  GN |
|---------------|------------|
| 几内亚比绍 | GW |
| 圭亚那  GY |
|---------------|------------|
| 海地 | HT |
| 洪都拉斯  HN |
|------------------|------------|
| 中国香港 | HK |
| 冰岛  IS |
|------------|------------|
| 印度尼西亚 | ID |
| 伊朗  IR |
|------------|------------|
| 伊拉克 | IQ |
| 爱尔兰  IE |
|---------------|------------|
| 马恩岛 | IM |
| 牙买加  JM |
|---------------|------------|
| 日本 | JP |
| 泽西  JE |
|------------|------------|
| 哈萨克斯坦 | KZ |
| 肯尼亚  KE |
|---------------|------------|
| 基里巴斯 | KI |
| 吉尔吉斯斯坦  KG |
|------------------------|------------|
| 老挝 | LA |
| 拉脱维亚  LV |
|------------------|------------|
| 黎巴嫩 | LB |
| 莱索托  LS |
|---------------|------------|
| 利比里亚 | LR |
| 利比亚  LY |
|---------------|------------|
| 列支敦士登 | LI |
| 立陶宛  LT |
|---------------|------------|
| 马其顿 | MK |
| 马达加斯加  MG |
|---------------------|------------|
| 马拉维 | MW |
| 马来西亚  MY |
|------------------|------------|
| 马尔代夫 | MV |
| 马里  ML |
|------------|------------|
| 马耳他 | MT |
| 马绍尔群岛  MH |
|---------------------|------------|
| 马提尼克 | MQ |
| 毛里塔尼亚  MR |
|---------------------|------------|
| 毛里求斯 | MU |
| 摩尔多瓦  MD |
|------------------|------------|
| 摩纳哥 | MC |
| 蒙古  MN |
|------------|------------|
| 黑山 | ME |
| 蒙特塞拉特  MS |
|---------------------|------------|
| 莫桑比克 | MZ |
| 缅甸  MM |
|------------|------------|
| 纳米比亚 | NA |
| 瑙鲁  NR |
|------------|------------|
| 尼泊尔 | NP |
| 新喀里多尼亚  NC |
|------------------------|------------|
| 新西兰 | NZ |
| 尼加拉瓜  NI |
|------------------|------------|
| 尼日尔 | NE |
| 尼日利亚  NG |
|------------------|------------|
| 诺福克岛 | NF |
| 朝鲜  KP |
|------------|------------|
| 北马里亚纳群岛 | MP |
| 巴基斯坦  PK |
|------------------|------------|
| 帕劳 | PW |
| 巴拿马  PA |
|---------------|------------|
| 巴布亚新几内亚 | PG |
| 巴拉圭  PY |
|---------------|------------|
| 秘鲁 | PE |
| 菲律宾  PH |
|---------------|------------|
| 罗马尼亚 | RO |
| 卢旺达  RW |
|---------------|------------|
| 萨摩亚 | WS |
| 圣马力诺  SM |
|------------------|------------|
| 塞内加尔 | SN |
| 塞尔维亚  RS |
|------------------|------------|
| 塞舌尔 | SC |
| 新加坡  SG |
|---------------|------------|
| 荷属圣马丁 | SX |
| 斯洛文尼亚  SI |
|---------------------|------------|
| 所罗门群岛 | SB |
| 索马里  SO |
|---------------|------------|
| 南非 | ZA |
| 南乔治亚和南桑威奇群岛  GS |
|---------------------------------------|------------|
| 韩国 | KR |
| 斯里兰卡  LK |
|------------------|------------|
| 圣赫勒拿 | SH |
| 圣基茨和尼维斯  KN |
|---------------------------|------------|
| 圣卢西亚 | LC |
| 圣文森特和格林纳丁斯  VC |
|------------------------------------|------------|
| 苏丹 | SD |
| 苏里南  SR |
|---------------|------------|
| 斯威士兰 | SZ |
| 叙利亚  SY |
|---------------|------------|
| 圣多美和普林西比 | ST |
| 中国台湾  TW |
|------------------|------------|
| 塔吉克斯坦 | TJ |
| 坦桑尼亚  TZ |
|------------------|------------|
| 泰国 | TH |
| 东帝汶  TL |
|---------------|------------|
| 多哥 | TG |
| 汤加  TO |
|------------|------------|
| 特立尼达和多巴哥 | TT |
| 突尼斯  TN |
|---------------|------------|
| 土耳其 | TR |
| 土库曼斯坦  TM |
|---------------------|------------|
| 特克斯和凯科斯群岛 | TC |
| 图瓦卢  TV |
|---------------|------------|
| 美国 | US |
| 乌干达  UG |
|---------------|------------|
| 乌克兰 | UA |
| 乌拉圭  UY |
|---------------|------------|
| 乌兹别克斯坦 | UZ |
| 瓦努阿图  VU |
|------------------|------------|
| 梵蒂冈 | VA |
| 委内瑞拉  VE |
|------------------|------------|
| 越南 | VN |
| 阿拉伯撒哈拉民主共和国  EH |
|---------------------------------------|------------|
| 也门 | YE |
| 赞比亚  ZM |
|---------------|------------|
| 津巴布韦 | ZW |