Item.php 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503
  1. <?php
  2. /**
  3. * Item(商品)结构
  4. * @author auto create
  5. */
  6. class Item
  7. {
  8. /**
  9. * 售后服务ID,该字段仅在taobao.item.get接口中返回
  10. **/
  11. public $after_sale_id;
  12. /**
  13. * 商品上传后的状态。onsale出售中,instock库中
  14. **/
  15. public $approve_status;
  16. /**
  17. * 返点比例
  18. **/
  19. public $auction_point;
  20. /**
  21. * 代充商品类型。只有少数类目下的商品可以标记上此字段,具体哪些类目可以上传可以通过taobao.itemcat.features.get获得。在代充商品的类目下,不传表示不标记商品类型(交易搜索中就不能通过标记搜到相关的交易了)。可选类型:
  22. time_card(点卡软件代充)
  23. fee_card(话费软件代充)
  24. **/
  25. public $auto_fill;
  26. /**
  27. * 自动重发,true/false
  28. **/
  29. public $auto_repost;
  30. /**
  31. * 商品级别的条形码
  32. **/
  33. public $barcode;
  34. /**
  35. * 商品所属的叶子类目 id
  36. **/
  37. public $cid;
  38. /**
  39. * 货到付款运费模板ID
  40. **/
  41. public $cod_postage_id;
  42. /**
  43. * 属性值的备注,格式:pid:vid:备注信息1;pid2:vid2:备注信息2;
  44. **/
  45. public $cpv_memo;
  46. /**
  47. * Item的发布时间,目前仅供taobao.item.add和taobao.item.get可用
  48. **/
  49. public $created;
  50. /**
  51. * 村淘特有商品级数据结构
  52. **/
  53. public $cuntao_item_specific;
  54. /**
  55. * 定制工具Id
  56. **/
  57. public $custom_made_type_id;
  58. /**
  59. * 下架时间(格式:yyyy-MM-dd HH:mm:ss)
  60. **/
  61. public $delist_time;
  62. /**
  63. * 商品描述, 字数要大于5个字节,小于25000个字节
  64. **/
  65. public $desc;
  66. /**
  67. * 宝贝描述规范化模块锚点信息
  68. **/
  69. public $desc_module_info;
  70. /**
  71. * 商品描述模块化,模块列表,由List转化成jsonArray存入,后端逻辑验证通过,拼装成模块内容+锚点导航后存入desc中。数据结构具体参见Item_Desc_Module
  72. **/
  73. public $desc_modules;
  74. /**
  75. * 商品url
  76. **/
  77. public $detail_url;
  78. /**
  79. * ems费用,格式:5.00;单位:元;精确到:分
  80. **/
  81. public $ems_fee;
  82. /**
  83. * 快递费用,格式:5.00;单位:元;精确到:分
  84. **/
  85. public $express_fee;
  86. /**
  87. * 宝贝特征值,
  88. 只有在Top支持的特征值才能保存到宝贝上
  89. **/
  90. public $features;
  91. /**
  92. * 食品安全信息,包括:生产许可证编号、产品标准号、厂名、厂址等
  93. **/
  94. public $food_security;
  95. /**
  96. * 运费承担方式,seller(卖家承担),buyer(买家承担)
  97. **/
  98. public $freight_payer;
  99. /**
  100. * 全球购商品采购地信息(地区/国家),代表全球购商品的产地信息。
  101. **/
  102. public $global_stock_country;
  103. /**
  104. * 全球购商品采购地信息(库存类型),有两种库存类型:现货和代购;
  105. 参数值为1时代表现货,值为2时代表代购
  106. **/
  107. public $global_stock_type;
  108. /**
  109. * 支持会员打折,true/false
  110. **/
  111. public $has_discount;
  112. /**
  113. * 是否有发票,true/false
  114. **/
  115. public $has_invoice;
  116. /**
  117. * 橱窗推荐,true/false
  118. **/
  119. public $has_showcase;
  120. /**
  121. * 是否有保修,true/false
  122. **/
  123. public $has_warranty;
  124. /**
  125. * 商品id(注意:iid近期即将废弃,请用num_iid参数)
  126. **/
  127. public $iid;
  128. /**
  129. * 加价幅度。如果为0,代表系统代理幅度。
  130. 在竞拍中,为了超越上一个出价,会员需要在当前出价上增加金额,这个金额就是加价幅度。卖家在发布宝贝的时候可以自定义加价幅度,也可以让系统自动代理加价。系统自动代理加价的加价幅度随着当前出价金额的增加而增加,我们建议会员使用系统自动代理加价,并请买家在出价前看清楚加价幅度的具体金额。另外需要注意是,此功能只适用于拍卖的商品。
  131. 以下是系统自动代理加价幅度表:
  132. 当前价(加价幅度 )
  133. 1-40( 1 )、41-100( 2 )、101-200(5 )、201-500 (10)、501-1001(15)、001-2000(25)、2001-5000(50)、5001-10000(100)
  134. 10001以上 200
  135. **/
  136. public $increment;
  137. /**
  138. * 用户内店宝贝装修模板id
  139. **/
  140. public $inner_shop_auction_template_id;
  141. /**
  142. * 针对当前商品的自定义属性值
  143. **/
  144. public $input_custom_cpv;
  145. /**
  146. * 用户自行输入的类目属性ID串。结构:"pid1,pid2,pid3",如:"20000"(表示品牌) 注:通常一个类目下用户可输入的关键属性不超过1个。
  147. **/
  148. public $input_pids;
  149. /**
  150. * 用户自行输入的子属性名和属性值,结构:"父属性值;一级子属性名;一级子属性值;二级子属性名;自定义输入值,....",如:“耐克;耐克系列;科比系列;科比系列;2K5”,input_str需要与input_pids一一对应,注:通常一个类目下用户可输入的关键属性不超过1个。所有属性别名加起来不能超过 3999字节。
  151. **/
  152. public $input_str;
  153. /**
  154. * 是否是3D淘宝的商品
  155. **/
  156. public $is3_d;
  157. /**
  158. * true:商品是区域限售商品;false:商品不是区域限售商品。
  159. **/
  160. public $is_area_sale;
  161. /**
  162. * 是否在外部网店显示
  163. **/
  164. public $is_ex;
  165. /**
  166. * 非分销商品:0,代销:1,经销:2
  167. **/
  168. public $is_fenxiao;
  169. /**
  170. * 是否24小时闪电发货
  171. **/
  172. public $is_lightning_consignment;
  173. /**
  174. * 商品是否为先行赔付
  175. taobao.items.search和taobao.items.vip.search专用
  176. **/
  177. public $is_prepay;
  178. /**
  179. * 是否在淘宝显示
  180. **/
  181. public $is_taobao;
  182. /**
  183. * 是否定时上架商品
  184. **/
  185. public $is_timing;
  186. /**
  187. * 虚拟商品的状态字段
  188. **/
  189. public $is_virtual;
  190. /**
  191. * 标示商品是否为新品。
  192. 值含义:true-是,false-否。
  193. **/
  194. public $is_xinpin;
  195. /**
  196. * 商品图片列表(包括主图)。fields中只设置item_img可以返回ItemImg结构体中所有字段,如果设置为item_img.id、item_img.url、item_img.position等形式就只会返回相应的字段
  197. **/
  198. public $item_imgs;
  199. /**
  200. * 表示商品的体积,用于按体积计费的运费模板。该值的单位为立方米(m3)。
  201. 该值支持两种格式的设置:格式1:bulk:3,单位为立方米(m3),表示直接设置为商品的体积。格式2:weight:10;breadth:10;height:10,单位为米(m)
  202. **/
  203. public $item_size;
  204. /**
  205. * 商品的重量,用于按重量计费的运费模板。注意:单位为kg
  206. **/
  207. public $item_weight;
  208. /**
  209. * 门店大屏图
  210. **/
  211. public $large_screen_image_url;
  212. /**
  213. * 上架时间(格式:yyyy-MM-dd HH:mm:ss)
  214. **/
  215. public $list_time;
  216. /**
  217. * 本地生活电子交易凭证业务,目前此字段只涉及到的信息为有效期:
  218. 如果有效期为起止日期类型,此值为2012-08-06,2012-08-16
  219. 如果有效期为【购买成功日 至】类型则格式为2012-08-16
  220. 如果有效期为天数类型则格式为3
  221. **/
  222. public $locality_life;
  223. /**
  224. * 商品所在地
  225. **/
  226. public $location;
  227. /**
  228. * 商品修改时间(格式:yyyy-MM-dd HH:mm:ss)
  229. **/
  230. public $modified;
  231. /**
  232. * 宝贝主图视频的数据信息,包括:视频ID,视频缩略图URL,视频时长,视频状态等信息。
  233. **/
  234. public $mpic_video;
  235. /**
  236. * 是否为新消保法中的7天无理由退货
  237. **/
  238. public $newprepay;
  239. /**
  240. * 卖家昵称
  241. **/
  242. public $nick;
  243. /**
  244. * 商品数量
  245. **/
  246. public $num;
  247. /**
  248. * 商品数字id
  249. **/
  250. public $num_iid;
  251. /**
  252. * 是否淘1站商品
  253. **/
  254. public $one_station;
  255. /**
  256. * 商家外部编码(可与商家外部系统对接)
  257. **/
  258. public $outer_id;
  259. /**
  260. * 用户外店装修模板id
  261. **/
  262. public $outer_shop_auction_template_id;
  263. /**
  264. * 用于保存拍卖有关的信息
  265. **/
  266. public $paimai_info;
  267. /**
  268. * 周期销售库存
  269. **/
  270. public $period_sold_quantity;
  271. /**
  272. * 商品主图片地址
  273. **/
  274. public $pic_url;
  275. /**
  276. * 平邮费用,格式:5.00;单位:元;精确到:分
  277. **/
  278. public $post_fee;
  279. /**
  280. * 宝贝所属的运费模板ID,如果没有返回则说明没有使用运费模板
  281. **/
  282. public $postage_id;
  283. /**
  284. * 商品价格,格式:5.00;单位:元;精确到:分
  285. **/
  286. public $price;
  287. /**
  288. * 宝贝所属产品的id(可能为空). 该字段可以通过taobao.products.search 得到
  289. **/
  290. public $product_id;
  291. /**
  292. * 消保类型,多个类型以,分割。可取以下值:
  293. 2:假一赔三;4:7天无理由退换货;taobao.items.search和taobao.items.vip.search专用
  294. **/
  295. public $promoted_service;
  296. /**
  297. * 商品属性图片列表。fields中只设置prop_img可以返回PropImg结构体中所有字段,如果设置为prop_img.id、prop_img.url、prop_img.properties、prop_img.position等形式就只会返回相应的字段
  298. **/
  299. public $prop_imgs;
  300. /**
  301. * 属性值别名
  302. **/
  303. public $property_alias;
  304. /**
  305. * 商品属性 格式:pid:vid;pid:vid
  306. **/
  307. public $props;
  308. /**
  309. * 商品属性名称。标识着props内容里面的pid和vid所对应的名称。格式为:pid1:vid1:pid_name1:vid_name1;pid2:vid2:pid_name2:vid_name2……(<strong>注:</strong><font color="red">属性名称中的冒号":"被转换为:"#cln#";
  310. 分号";"被转换为:"#scln#"
  311. </font>)
  312. **/
  313. public $props_name;
  314. /**
  315. * 商品所属卖家的信用等级数,1表示1心,2表示2心……,只有调用商品搜索:taobao.items.get和taobao.items.search的时候才能返回
  316. **/
  317. public $score;
  318. /**
  319. * 秒杀商品类型。打上秒杀标记的商品,用户只能下架并不能再上架,其他任何编辑或删除操作都不能进行。如果用户想取消秒杀标记,需要联系小二进行操作。如果秒杀结束需要自由编辑请联系活动负责人(小二)去掉秒杀标记。可选类型
  320. web_only(只能通过web网络秒杀)
  321. wap_only(只能通过wap网络秒杀)
  322. web_and_wap(既能通过web秒杀也能通过wap秒杀)
  323. **/
  324. public $second_kill;
  325. /**
  326. * 商品卖点信息,天猫商家使用字段,最长150个字符。
  327. **/
  328. public $sell_point;
  329. /**
  330. * 是否承诺退换货服务!
  331. **/
  332. public $sell_promise;
  333. /**
  334. * 商品所属的店铺内卖家自定义类目列表
  335. **/
  336. public $seller_cids;
  337. /**
  338. * Sku列表。fields中只设置sku可以返回Sku结构体中所有字段,如果设置为sku.sku_id、sku.properties、sku.quantity等形式就只会返回相应的字段
  339. **/
  340. public $skus;
  341. /**
  342. * 商品销量
  343. **/
  344. public $sold_quantity;
  345. /**
  346. * 商品新旧程度(全新:new,闲置:unused,二手:second)
  347. **/
  348. public $stuff_status;
  349. /**
  350. * 商品是否支持拍下减库存:1支持;2取消支持(付款减库存);0(默认)不更改 集市卖家默认拍下减库存; 商城卖家默认付款减库存
  351. **/
  352. public $sub_stock;
  353. /**
  354. * 页面模板id
  355. **/
  356. public $template_id;
  357. /**
  358. * 商品标题,不能超过60字节
  359. **/
  360. public $title;
  361. /**
  362. * 商品类型(fixed:一口价;auction:拍卖)注:取消团购
  363. **/
  364. public $type;
  365. /**
  366. * 有效期,7或者14(默认是14天)
  367. **/
  368. public $valid_thru;
  369. /**
  370. * 该字段废弃,请勿使用。
  371. **/
  372. public $video_id;
  373. /**
  374. * 商品视频列表(目前只支持单个视频关联)。fields中只设置video可以返回Video结构体中所有字段,如果设置为video.id、video.video_id、
  375. video.url等形式就只会返回相应的字段
  376. **/
  377. public $videos;
  378. /**
  379. * 商品是否违规,违规:true , 不违规:false
  380. **/
  381. public $violation;
  382. /**
  383. * 商品30天交易量,只有调用商品搜索:taobao.items.get和taobao.items.search的时候才能返回
  384. **/
  385. public $volume;
  386. /**
  387. * 不带html标签的desc文本信息,该字段只在taobao.item.get接口中返回
  388. **/
  389. public $wap_desc;
  390. /**
  391. * 适合wap应用的商品详情url ,该字段只在taobao.item.get接口中返回
  392. **/
  393. public $wap_detail_url;
  394. /**
  395. * 无线的宝贝描述
  396. **/
  397. public $wireless_desc;
  398. /**
  399. * 预扣库存,即付款减库存的商品现在有多少处于未付款状态的订单
  400. **/
  401. public $with_hold_quantity;
  402. /**
  403. * 商品所属的商家的旺旺在线状况,
  404. taobao.items.search和taobao.items.vip.search专用
  405. **/
  406. public $ww_status;
  407. }
  408. ?>