using System; using System.Xml.Serialization; using System.Collections.Generic; namespace Top.Api.Domain { /// /// Item Data Structure. /// [Serializable] public class Item : TopObject { /// /// 售后服务ID,该字段仅在taobao.item.get接口中返回 /// [XmlElement("after_sale_id")] public long AfterSaleId { get; set; } /// /// 商品上传后的状态。onsale出售中,instock库中 /// [XmlElement("approve_status")] public string ApproveStatus { get; set; } /// /// 返点比例 /// [XmlElement("auction_point")] public long AuctionPoint { get; set; } /// /// 代充商品类型。只有少数类目下的商品可以标记上此字段,具体哪些类目可以上传可以通过taobao.itemcat.features.get获得。在代充商品的类目下,不传表示不标记商品类型(交易搜索中就不能通过标记搜到相关的交易了)。可选类型:time_card(点卡软件代充)fee_card(话费软件代充) /// [XmlElement("auto_fill")] public string AutoFill { get; set; } /// /// 自动重发,true/false /// [XmlElement("auto_repost")] public bool AutoRepost { get; set; } /// /// 商品级别的条形码 /// [XmlElement("barcode")] public string Barcode { get; set; } /// /// 基础色数据 /// [XmlElement("change_prop")] public string ChangeProp { get; set; } /// /// 天猫超市扩展字段,天猫超市专用。 /// [XmlElement("chaoshi_extends_info")] public string ChaoshiExtendsInfo { get; set; } /// /// 支持3期、6期、12期免息 /// [XmlElement("charge_free_list")] public string ChargeFreeList { get; set; } /// /// 商品所属的叶子类目 id /// [XmlElement("cid")] public long Cid { get; set; } /// /// 货到付款运费模板ID /// [XmlElement("cod_postage_id")] public long CodPostageId { get; set; } /// /// 属性值的备注,格式:pid:vid:备注信息1;pid2:vid2:备注信息2; /// [XmlElement("cpv_memo")] public string CpvMemo { get; set; } /// /// Item的发布时间,目前仅供taobao.item.add和taobao.item.get可用 /// [XmlElement("created")] public string Created { get; set; } /// /// 村淘特有商品级数据结构 /// [XmlElement("cuntao_item_specific")] public string CuntaoItemSpecific { get; set; } /// /// 定制工具Id /// [XmlElement("custom_made_type_id")] public string CustomMadeTypeId { get; set; } /// /// 下架时间(格式:yyyy-MM-dd HH:mm:ss) /// [XmlElement("delist_time")] public string DelistTime { get; set; } /// /// 发货时间信息 /// [XmlElement("delivery_time")] public string DeliveryTime { get; set; } /// /// 商品描述, 字数要大于5个字节,小于25000个字节 /// [XmlElement("desc")] public string Desc { get; set; } /// /// 宝贝描述规范化模块锚点信息 /// [XmlElement("desc_module_info")] public string DescModuleInfo { get; set; } /// /// 商品描述模块化,模块列表,由List转化成jsonArray存入,后端逻辑验证通过,拼装成模块内容+锚点导航后存入desc中。数据结构具体参见Item_Desc_Module /// [XmlElement("desc_modules")] public string DescModules { get; set; } /// /// 商品url /// [XmlElement("detail_url")] public string DetailUrl { get; set; } /// /// ems费用,格式:5.00;单位:元;精确到:分 /// [XmlElement("ems_fee")] public string EmsFee { get; set; } /// /// 快递费用,格式:5.00;单位:元;精确到:分 /// [XmlElement("express_fee")] public string ExpressFee { get; set; } /// /// 宝贝特征值,只有在Top支持的特征值才能保存到宝贝上 /// [XmlElement("features")] public string Features { get; set; } /// /// 食品安全信息,包括:生产许可证编号、产品标准号、厂名、厂址等 /// [XmlElement("food_security")] public string FoodSecurity { get; set; } /// /// 运费承担方式,seller(卖家承担),buyer(买家承担) /// [XmlElement("freight_payer")] public string FreightPayer { get; set; } /// /// 全球购商品采购地信息(地区/国家),代表全球购商品的产地信息。 /// [XmlElement("global_stock_country")] public string GlobalStockCountry { get; set; } /// /// 全球购商品发货地,发货地现在有两种类型:“国内”和“海外及港澳台”,参数值为1时代表“国内”,值为2时代表“海外及港澳台” /// [XmlElement("global_stock_delivery_place")] public string GlobalStockDeliveryPlace { get; set; } /// /// 全球购商品卖家包税承诺,当值为true时,代表卖家承诺包税。 /// [XmlElement("global_stock_tax_free_promise")] public bool GlobalStockTaxFreePromise { get; set; } /// /// 全球购商品采购地信息(库存类型),有两种库存类型:现货和代购;参数值为1时代表现货,值为2时代表代购 /// [XmlElement("global_stock_type")] public string GlobalStockType { get; set; } /// /// 支持会员打折,true/false /// [XmlElement("has_discount")] public bool HasDiscount { get; set; } /// /// 是否有发票,true/false /// [XmlElement("has_invoice")] public bool HasInvoice { get; set; } /// /// 橱窗推荐,true/false /// [XmlElement("has_showcase")] public bool HasShowcase { get; set; } /// /// 是否有保修,true/false /// [XmlElement("has_warranty")] public bool HasWarranty { get; set; } /// /// 商品id(注意:iid近期即将废弃,请用num_iid参数) /// [XmlElement("iid")] public string Iid { get; set; } /// /// 加价幅度。如果为0,代表系统代理幅度。在竞拍中,为了超越上一个出价,会员需要在当前出价上增加金额,这个金额就是加价幅度。卖家在发布宝贝的时候可以自定义加价幅度,也可以让系统自动代理加价。系统自动代理加价的加价幅度随着当前出价金额的增加而增加,我们建议会员使用系统自动代理加价,并请买家在出价前看清楚加价幅度的具体金额。另外需要注意是,此功能只适用于拍卖的商品。以下是系统自动代理加价幅度表:当前价(加价幅度 )1-40( 1 )、41-100( 2 )、101-200(5 )、201-500 (10)、501-1001(15)、001-2000(25)、2001-5000(50)、5001-10000(100)10001以上 200 /// [XmlElement("increment")] public string Increment { get; set; } /// /// 用户内店宝贝装修模板id /// [XmlElement("inner_shop_auction_template_id")] public long InnerShopAuctionTemplateId { get; set; } /// /// 针对当前商品的自定义属性值 /// [XmlElement("input_custom_cpv")] public string InputCustomCpv { get; set; } /// /// 用户自行输入的类目属性ID串。结构:"pid1,pid2,pid3",如:"20000"(表示品牌) 注:通常一个类目下用户可输入的关键属性不超过1个。 /// [XmlElement("input_pids")] public string InputPids { get; set; } /// /// 用户自行输入的子属性名和属性值,结构:"父属性值;一级子属性名;一级子属性值;二级子属性名;自定义输入值,....",如:“耐克;耐克系列;科比系列;科比系列;2K5”,input_str需要与input_pids一一对应,注:通常一个类目下用户可输入的关键属性不超过1个。所有属性别名加起来不能超过 3999字节。 /// [XmlElement("input_str")] public string InputStr { get; set; } /// /// 是否是3D淘宝的商品 /// [XmlElement("is_3D")] public bool Is3D { get; set; } /// /// true:商品是区域限售商品;false:商品不是区域限售商品。 /// [XmlElement("is_area_sale")] public bool IsAreaSale { get; set; } /// /// 是否为达尔文挂接成功了的商品 /// [XmlElement("is_cspu")] public bool IsCspu { get; set; } /// /// 是否在外部网店显示 /// [XmlElement("is_ex")] public bool IsEx { get; set; } /// /// 非分销商品:0,代销:1,经销:2 /// [XmlElement("is_fenxiao")] public long IsFenxiao { get; set; } /// /// 是否24小时闪电发货 /// [XmlElement("is_lightning_consignment")] public bool IsLightningConsignment { get; set; } /// /// 商品是否为先行赔付taobao.items.search和taobao.items.vip.search专用 /// [XmlElement("is_prepay")] public bool IsPrepay { get; set; } /// /// 是否在淘宝显示 /// [XmlElement("is_taobao")] public bool IsTaobao { get; set; } /// /// 是否定时上架商品 /// [XmlElement("is_timing")] public bool IsTiming { get; set; } /// /// 虚拟商品的状态字段 /// [XmlElement("is_virtual")] public bool IsVirtual { get; set; } /// /// 标示商品是否为新品。值含义:true-是,false-否。 /// [XmlElement("is_xinpin")] public bool IsXinpin { get; set; } /// /// 商品图片列表(包括主图)。fields中只设置item_img可以返回ItemImg结构体中所有字段,如果设置为item_img.id、item_img.url、item_img.position等形式就只会返回相应的字段 /// [XmlArray("item_imgs")] [XmlArrayItem("item_img")] public List ItemImgs { get; set; } /// /// itemRectangleImgs /// [XmlArray("item_rectangle_imgs")] [XmlArrayItem("item_img")] public List ItemRectangleImgs { get; set; } /// /// 表示商品的体积,用于按体积计费的运费模板。该值的单位为立方米(m3)。该值支持两种格式的设置:格式1:bulk:3,单位为立方米(m3),表示直接设置为商品的体积。格式2:weight:10;breadth:10;height:10,单位为米(m) /// [XmlElement("item_size")] public string ItemSize { get; set; } /// /// 商品的重量,用于按重量计费的运费模板。注意:单位为kg /// [XmlElement("item_weight")] public string ItemWeight { get; set; } /// /// 商品无线主图 /// [XmlArray("item_wireless_imgs")] [XmlArrayItem("item_img")] public List ItemWirelessImgs { get; set; } /// /// 门店大屏图 /// [XmlElement("large_screen_image_url")] public string LargeScreenImageUrl { get; set; } /// /// 上架时间(格式:yyyy-MM-dd HH:mm:ss) /// [XmlElement("list_time")] public string ListTime { get; set; } /// /// 本地生活电子交易凭证业务,目前此字段只涉及到的信息为有效期:如果有效期为起止日期类型,此值为2012-08-06,2012-08-16如果有效期为【购买成功日 至】类型则格式为2012-08-16如果有效期为天数类型则格式为3 /// [XmlElement("locality_life")] public string LocalityLife { get; set; } /// /// 商品所在地 /// [XmlElement("location")] public Top.Api.Domain.Location Location { get; set; } /// /// 商品修改时间(格式:yyyy-MM-dd HH:mm:ss) /// [XmlElement("modified")] public string Modified { get; set; } /// /// 宝贝主图视频的数据信息,包括:视频ID,视频缩略图URL,视频时长,视频状态等信息。 /// [XmlElement("mpic_video")] public string MpicVideo { get; set; } /// /// 家装分阶段价格数据结构 /// [XmlElement("ms_payment")] public string MsPayment { get; set; } /// /// 是否为新消保法中的7天无理由退货 /// [XmlElement("newprepay")] public string Newprepay { get; set; } /// /// 卖家昵称 /// [XmlElement("nick")] public string Nick { get; set; } /// /// 商品数量 /// [XmlElement("num")] public long Num { get; set; } /// /// 商品数字id /// [XmlElement("num_iid")] public long NumIid { get; set; } /// /// 是否绑定o2o /// [XmlElement("o2o_bind_service")] public bool O2oBindService { get; set; } /// /// 是否淘1站商品 /// [XmlElement("one_station")] public bool OneStation { get; set; } /// /// 商家外部编码(可与商家外部系统对接) /// [XmlElement("outer_id")] public string OuterId { get; set; } /// /// 用户外店装修模板id /// [XmlElement("outer_shop_auction_template_id")] public long OuterShopAuctionTemplateId { get; set; } /// /// 用于保存拍卖有关的信息 /// [XmlElement("paimai_info")] public string PaimaiInfo { get; set; } /// /// 周期销售库存 /// [XmlElement("period_sold_quantity")] public long PeriodSoldQuantity { get; set; } /// /// 商品主图片地址 /// [XmlElement("pic_url")] public string PicUrl { get; set; } /// /// 平邮费用,格式:5.00;单位:元;精确到:分 /// [XmlElement("post_fee")] public string PostFee { get; set; } /// /// 宝贝所属的运费模板ID,如果没有返回则说明没有使用运费模板 /// [XmlElement("postage_id")] public long PostageId { get; set; } /// /// 商品价格,格式:5.00;单位:元;精确到:分 /// [XmlElement("price")] public string Price { get; set; } /// /// 宝贝所属产品的id(可能为空). 该字段可以通过taobao.products.search 得到 /// [XmlElement("product_id")] public long ProductId { get; set; } /// /// 消保类型,多个类型以,分割。可取以下值:2:假一赔三;4:7天无理由退换货;taobao.items.search和taobao.items.vip.search专用 /// [XmlElement("promoted_service")] public string PromotedService { get; set; } /// /// 商品属性图片列表。fields中只设置prop_img可以返回PropImg结构体中所有字段,如果设置为prop_img.id、prop_img.url、prop_img.properties、prop_img.position等形式就只会返回相应的字段 /// [XmlArray("prop_imgs")] [XmlArrayItem("prop_img")] public List PropImgs { get; set; } /// /// 属性值别名 /// [XmlElement("property_alias")] public string PropertyAlias { get; set; } /// /// 商品属性 格式:pid:vid;pid:vid /// [XmlElement("props")] public string Props { get; set; } /// /// 商品属性名称。标识着props内容里面的pid和vid所对应的名称。格式为:pid1:vid1:pid_name1:vid_name1;pid2:vid2:pid_name2:vid_name2……(注:属性名称中的冒号":"被转换为:"#cln#"; 分号";"被转换为:"#scln#") /// [XmlElement("props_name")] public string PropsName { get; set; } /// /// 商品资质的信息,用URLEncoder做过转换,使用时,需要URLDecoder转换回来,默认字符集为:UTF-8 /// [XmlElement("qualification")] public string Qualification { get; set; } /// /// 商品所属卖家的信用等级数,1表示1心,2表示2心……,只有调用商品搜索:taobao.items.get和taobao.items.search的时候才能返回 /// [XmlElement("score")] public long Score { get; set; } /// /// 秒杀商品类型。打上秒杀标记的商品,用户只能下架并不能再上架,其他任何编辑或删除操作都不能进行。如果用户想取消秒杀标记,需要联系小二进行操作。如果秒杀结束需要自由编辑请联系活动负责人(小二)去掉秒杀标记。可选类型web_only(只能通过web网络秒杀)wap_only(只能通过wap网络秒杀)web_and_wap(既能通过web秒杀也能通过wap秒杀) /// [XmlElement("second_kill")] public string SecondKill { get; set; } /// /// 商品卖点信息,天猫商家使用字段,最长150个字符。 /// [XmlElement("sell_point")] public string SellPoint { get; set; } /// /// 是否承诺退换货服务! /// [XmlElement("sell_promise")] public bool SellPromise { get; set; } /// /// 商品所属的店铺内卖家自定义类目列表 /// [XmlElement("seller_cids")] public string SellerCids { get; set; } /// /// Sku列表。fields中只设置sku可以返回Sku结构体中所有字段,如果设置为sku.sku_id、sku.properties、sku.quantity等形式就只会返回相应的字段 /// [XmlArray("skus")] [XmlArrayItem("sku")] public List Skus { get; set; } /// /// 商品销量 /// [XmlElement("sold_quantity")] public long SoldQuantity { get; set; } /// /// 手机类目spu 确认信息字段 /// [XmlElement("spu_confirm")] public bool SpuConfirm { get; set; } /// /// 商品新旧程度(全新:new,闲置:unused,二手:second) /// [XmlElement("stuff_status")] public string StuffStatus { get; set; } /// /// 商品是否支持拍下减库存:1支持;2取消支持(付款减库存);0(默认)不更改 集市卖家默认拍下减库存; 商城卖家默认付款减库存 /// [XmlElement("sub_stock")] public long SubStock { get; set; } /// /// 是否支持分期免息 /// [XmlElement("support_charge_free")] public bool SupportChargeFree { get; set; } /// /// 页面模板id /// [XmlElement("template_id")] public string TemplateId { get; set; } /// /// 商品标题,不能超过60字节 /// [XmlElement("title")] public string Title { get; set; } /// /// 商品类型(fixed:一口价;auction:拍卖)注:取消团购 /// [XmlElement("type")] public string Type { get; set; } /// /// 有效期,7或者14(默认是14天) /// [XmlElement("valid_thru")] public long ValidThru { get; set; } /// /// 商品竖图 /// [XmlArray("vertical_imgs")] [XmlArrayItem("item_img")] public List VerticalImgs { get; set; } /// /// 该字段废弃,请勿使用。 /// [XmlElement("video_id")] public long VideoId { get; set; } /// /// 商品视频列表(目前只支持单个视频关联)。fields中只设置video可以返回Video结构体中所有字段,如果设置为video.id、video.video_id、video.url等形式就只会返回相应的字段 /// [XmlArray("videos")] [XmlArrayItem("video")] public List Videos { get; set; } /// /// 商品是否违规,违规:true , 不违规:false /// [XmlElement("violation")] public bool Violation { get; set; } /// /// 商品30天交易量,只有调用商品搜索:taobao.items.get和taobao.items.search的时候才能返回 /// [XmlElement("volume")] public long Volume { get; set; } /// /// 不带html标签的desc文本信息,该字段只在taobao.item.get接口中返回 /// [XmlElement("wap_desc")] public string WapDesc { get; set; } /// /// 适合wap应用的商品详情url ,该字段只在taobao.item.get接口中返回 /// [XmlElement("wap_detail_url")] public string WapDetailUrl { get; set; } /// /// 白底图URL /// [XmlElement("white_bg_image")] public string WhiteBgImage { get; set; } /// /// 无线的宝贝描述 /// [XmlElement("wireless_desc")] public string WirelessDesc { get; set; } /// /// 预扣库存,即付款减库存的商品现在有多少处于未付款状态的订单 /// [XmlElement("with_hold_quantity")] public long WithHoldQuantity { get; set; } /// /// 商品所属的商家的旺旺在线状况,taobao.items.search和taobao.items.vip.search专用 /// [XmlElement("ww_status")] public bool WwStatus { get; set; } } }