| 商品数据结构描述 |
| 指卖家发布到淘宝店铺内的商品。 |
| Item(商品) |
| 名称 | 类型 | 是否必须 | 描述 |
| iid | String(32) | 必须 | 商品ID,上传时不需要 |
| title | String(30) | 必须 | 商品标题 |
| nick | String(32) | 必须 | 卖家昵称,上传、修改时不需要 |
| type | String | 必须 | 商品类型,拍卖:auction,一口价:fixed,团购:bulk |
| cid | String(32) | 必须 | 类目Id |
| seller_cids | String | 必须 | 卖家店铺内商品类目列表,按逗号分隔。注意,目前只支持一个店铺内类目 |
| props | String | 必须 | 属性和属性值列表,按逗号分隔 |
| desc | String | 必须 | 商品描述,支持HTML |
| pic_path | String | 必须 | 商品图片地址,上传时不需要 |
| num | int | 必须 | 商品数量 |
| valid_thru | int | 必须 | 商品上架期间,按天计算。只允许7天或14天 |
| list_time | Date | 必须 | 商品上架时间 |
| delist_time | Date | 必须 | 商品下架时间 |
| stuff_status | String | 必须 | 商品新旧程度,全新:new,闲置:unused,二手:second |
| location | String[8] | 必须 | 商品所在地,Location数据结构里仅包含city,state |
| price | String | 必须 | 商品价格 |
| post_fee | String | 必须 | 平邮费用 |
| express_fee | String | 必须 | 快递费用 |
| ems_fee | String | 必须 | EMS费用 |
| pay_type | String | 必须 | 付款方式: 款到发货/pay_first,货到付款/goods_first,见商品描述/custom |
| has_discount | boolean | 可选 | 是否参与会员折扣 |
| freight_payer | String | 必须 | 谁承担运费:买家承担运费/buyer,卖家承担运费/seller |
| has_invoice | booelan | 必须 | 是否有发票 |
| has_warranty | booelan | 必须 | 是否有保修 |
| has_alipay | booelan | 必须 | 是否支持支付宝 |
| has_showcase | booelan | 必须 | 是否有橱窗推荐 |
| bulk_base_num | number | 可选 |
团购的基数 |
| modified | varchar | 必须 | 商品修改时间 |
| increment | String | 必须 | 加价幅度,如果是一口价,不需要指定 |
| auto_repost | boolean | 必须 | 是否到期自动重发 |
| approve_status | String | 必须 | 商品上传后的状态:正常出售/onsale,放入仓库/instock |