# 4、数据类型说明 ## 4.1 MultiLanguageMap 说明：多语言字段 类型 Map ,该字段为动态字段,key:国家编码,value:内容。 e.g: {"ar":"ar title","zh":"中文标题","en":"english title"} 数据类型说明 MultiLanguageMap | 字段名称 描述 | 是否必填 类型 | |------------------|------------|------------------|------------| | zh | 中文 | N | string | | ar 阿语 | N string | |------------|------------|---------|------------------------| | en | 英文 | N | string | | ... 更多国家 | N string | |---------------|------------------|---------|------------------------| ## 4.2 PostCategoryDTO 说明：发布类目基础信息 PostCategoryDTO | 字段名称 描述 | 是否必填 类型 | |------------------|------------|------------------|------------| | id | 类目ID | Y | integer | | isLeaf 是否叶子 | Y boolean | |------------------------|------------------|---------|---------------------------| | parentId | 父类目Id | Y | integer | | level 类目所在层级 | Y integer | |---------------------|------------------------|---------|---------------------------| | names | 类目名称,包含多语言,key:对应国家,value: 标题信息 e.g { "ar": "ar title", "zh": "中文标题", "en": "english title" } | Y | MultiLanguageMap |------------------------------------------------------| ## 4.3 PostCategoryDetailDTO 说明：类目详情信息 PostCategoryDetailDTO | 字段名称 描述 | 是否必填 类型 | |------------------|------------|------------------|------------| | id | 类目id | Y | integer | | names 类目多语言名称 | Y MultiLanguageMap | |---------------------|---------------------------|---------|------------------------------------------------------| | isSkuVolumeRequired | 是否必填体积 | Y | boolean | | needSizeChart 是否尺码必填 | Y boolean | |---------------------------------------------|------------------------|---------|---------------------------| | sizeChart | 尺码表,只包含sizeItem 纵坐标 | N | OpenSizeChartDTO | | properties 商品,商品sku 属性集合 | Y PropertyValueDTO[] | |------------------------------------|---------------------------------------------|---------|------------------------------------------------------------| ### ## 4.4 PropertyValueDTO 说明：类目详情信息 PropertyValueDTO | 字段名称 描述 | 是否必填 类型 | |------------------|------------|------------------|------------| | propertyType | 属性类型 SKU(2, "销售属性"), ITEM(3, "商品属性") | Y | integer | | propertyId 属性ID | Y integer | |------------------------------------|------------------|---------|---------------------------| | dataType | 类型 OPTIONAL(2, "限制可选项类型"),CUSTOM_NUMBER(4, "自定义数值类型"),CUSTOM_TEXT(3, "自定义文本类型"),CUSTOM_TIME(5, "自定义时间类型") N | integer |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------|---------------------------| | require | 是否必填属性 | Y | boolean | | maxElementSize 属性可选最大数量,适用于限制可选项类型 | Y integer | |------------------------------------------------|---------------------------------------------------------------|---------|---------------------------| | isBrandProperty | 是否品牌属性品牌可选范围为对应认证的品牌 Y | boolean |------------------------------------------------------------------|---------|---------------------------| | names | 属性名称 | Y | MultiLanguageMap | | values 属性值,限制可选项类型存在该字段 | N ValueDTO[] | |------------------------|------------------------------------------------------|---------|------------------------------------| | feature | 属性特征(自定义类型信息,尺码信息) | N | PropertyFeatureDTO | | sku 是否sku属性,与properyType 冗余 | Y boolean | |---------------|---------------------------------------------------------------------------|---------|---------------------------| | skuSpec | sku属性适用,sku 维度数,1 = 第一级sku属性,2 = 第二sku属性 | N | integer | ## 4.5 ValueDTO 说明：属性值信息 ValueDTO | 字段名称 描述 | 是否必填 类型 | |------------------|------------|------------------|------------| | valueId | 属性值信息 | Y | integer | | seqId 排序号 | N integer | |---------------------|---------------|---------|---------------------------| | names | 属性值名称 | Y | CustomMap |---------------------------------| ## 4.6 PropertyFeatureDTO 说明：属性项特征 PropertyFeatureDTO | 字段名称 描述 | 是否必填 类型 | |------------------|------------|------------------|------------| | sizeGroup | 是否尺码组,用于sku属性下标志尺码属性, 1 = 尺码 | N | string | | custom 自定义信息 | N | |------------------------|---------------------|---------|------| ## 4.7 OpenSizeChartDTO 说明：尺码表 OpenSizeChartDTO | 字段名称 描述 | 是否必填 类型 | |------------------|------------|------------------|------------| | sizeItem | 尺码表纵坐标 e.g 腰围,肩宽 | N | BasePropertyDTO[] | | sizeRow 尺码表横坐标 e.g XL,M,S | N SizeRowDTO[] | |---------------------------|---------------------------------------------------------|---------|------------------------------------------| | sizeVals | 尺码表值,key 为尺码项的valueId ，e.g:L码对应的id | N | Map> | ## 4.8 BasePropertyDTO 说明：尺码属性信息 BasePropertyDTO | 字段名称 描述 | 是否必填 类型 | |------------------|------------|------------------|------------| | property | 尺码项ID | N | integer | | require 是否必填 | N boolean | |---------------------------|------------------|---------|---------------------------| | unit | 单位符号,e.g:cm | N | string | | names 尺码项名称 | N MultiLanguageMap | |---------------------|---------------------|---------|------------------------------------------------------| ## 4.9 CustomMap 说明：自定义属性信息 CustomMap | 字段名称 描述 | 是否必填 类型 | |------------------|------------|------------------|------------| | unit | 自定义数值 ：单位 | N | string | | customType 自定义数值：维度数量 一维:1 | N string | |------------------------------------|------------------------------------------------------|---------|------------------------| | format | 自定义时间：时间格式如：yyyy-MM N | string |---------------------------------------------------------------|---------|------------------------| | lan | 自定义文本 : 语言如 ： en N | string |------------------------------------------------------|---------|------------------------| ## 4.10 ItemOpenDTO 说明：商品信息 ItemOpenDTO | 字段名称 描述 | 是否必填 类型 | |------------------|------------|------------------|------------| | itemId | 商品id,仅修改,查询接口使用 | N | integer | | catId 类目ID | Y integer | |---------------------|------------------|---------|---------------------------| | titleLang | 多语言标题 | Y | MultiLanguageMap | | overviewLang 多语言标题 | N MultiLanguageMap | |------------------------------------------|---------------------|---------|------------------------------------------------------| | headPics | 头图 | Y | string[] | | descPics 描述图 | N string[] | |------------------------------|---------------|---------|------------------------------| | countryCodeList | 指定售卖区域 | Y | string[] | | itemNo 商品货号 | Y string | |------------------------|------------------|---------|------------------------| | deliverDay | 履约时效 5 天（当前仅支持5天） | Y | integer | | skuList sku信息 | Y SkuOpenDTO[] | |---------------------------|---------------------|---------|------------------------------------------| | itemProperties | 商品属性 | Y | PropertyValueDisplayDTO[] | | itemStatus 商品状态,查询接口透出,发布修改接口无需传入 | N integer | |------------------------------------|------------------------------------------------------------------------|---------|---------------------------| | sizeChart | 尺码表 | N | OpenSizeChartDTO[] | | editStatus 编辑状态,仅查询使用 | N integer | |------------------------------------|------------------------------------|---------|---------------------------| | editStatusName | 编辑状态名称,仅查询使用 | N | string | | megadealPic 商品白底图, 目前主要用于平台 megadeal 活动展示 | N string | |---------------------------------------|---------------------------------------------------------------------------------------------|---------|------------------------| ## 4.11 SkuOpenDTO 说明：SKU 信息 SkuOpenDTO | 字段名称 描述 | 是否必填 类型 | |------------------|------------|------------------|------------| | skuId | skuId,发布商品postItem不需要传,editItem必须补充 | N | integer | | purchasePrice 采购价,保留2位小数 | Y decimal(16,2) | |---------------------------------------------|------------------------------------|---------|---------------------------------------------| | countrySalePrice | 直接定售价店铺必填；所有国家的统一售价，必填，货币为美金，2位小数；如果想对特定区域单独定价，可以补充给到指定国家需要指定的售价，货币为美金，2位小数 | N | CountrySalePriceDTO | | stock 库存 | Y integer | |---------------------|------------|---------|---------------------------| | status | sku状态 0:下架 1:上架 | Y | integer | | weight 称重(g) | Y integer | |------------------------|---------------------|---------|---------------------------| | volume | 体积 | N | VolumeDTO | | skuNo sku 编码(PO编号),最好维护店铺唯一 | N string | |---------------------|---------------------------------------------------------------------|---------|------------------------| | gtin | gtn码 | N | string | | image | sku 图片地址,该地址是可访问,可下载的图片,后缀jpg,png | Y | string |------------------------| | skuProperties | sku 规则/尺寸信息 当只传一级属性,系统会默认补充通用属性(如图),最好补充完整,让流量侧可分析 | Y | PropertyValueDisplayDTO[] | ### ### ### 4.12、 PropertyValueDisplayDTO PropertyValueDisplayDTO 说明：商品属性值信息 | 字段名称 描述 | 是否必填 类型 | |------------------|------------|------------------|------------| | propertyId | 属性ID | Y | integer | | valueId 属性值ID | Y integer | |---------------------------|---------------------|---------|---------------------------| | propName | 属性名称 | N | string | | valueName 属性值名称 | N string | |---------------------------------|---------------------|---------|------------------------| | propDataType | 2：限制可选项类型；3：自定义文本类型；4：自定义数值类型；5：自定义时间类型 限制可选项类型：valueId,propertyId,propDataType 必填自定义文类型型：propertyId,propDataType,customAttr.source 必填自定义时间类型：propertyId,propDataType,customAttr.source 必填自定数值类型：propertyId,propDataType,customAttr.customType,customAttr.unit 必填 Y | integer |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------|---------------------------| | customAttrDTO | 自定义属性信息 | N | CustomAttrDTO | | valueAliasName 多语言别名信息 | N MultiLanguageMap | |------------------------------------------------|---------------------------|---------|------------------------------------------------------| ### ### 4.13、 CustomAttrDTO CustomAttrDTO 说明：自定义属性信息 | 字段名称 描述 | 是否必填 类型 | |------------------|------------|------------------|------------| | source | 自定义文本/自定义时间 -文本内容,长度不能 > 256字符备注：自定义文本：app直接透出文本,用于图书作者,ISBN编码类自定义时间 - 时间信息 如：2021-02 Y | string |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------|------------------------| | customType | 自定义数值：维度数量,对应类目详情接口 properties.feature.custom.$.customTypecustomType = 1 一维 N | string |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------|------------------------| | unit | 自定义数值unit : 单位,e.g:cm | N | string | ### ### 4.14、 CountrySalePriceDTO CountrySalePriceDTO 说明：指定国家售卖信息, 直接定售价店铺必填；其中 “saleprice” 为所有国家的统一售价，必填，货币为美金， 2 位小数；如果想对特定区域单独定价，可以补充给到指定国家需要指定的售价，货币为美金， 2 位小数 | 字段名称 描述 | 是否必填 类型 | |------------------|------------|------------------|------------| | commonSalePrice | 通用国家售价,两位小数,美元 | Y | decimal | | countrySalePrice 指定国家售价,美元,e.g:{"SA":12,32,"UK":15.13} | Y Map | |------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------|---------|---------------------------------------------------------------| ### ### 4.15、 VolumeDTO VolumeDTO 说明：体积信息,用于抛重计算,公式 (长x宽x高)/5 | 字段名称 描述 | 是否必填 类型 | |------------------|------------|------------------|------------| | length | 长cm | Y | integer | | width 宽cm | Y integer | |---------------------|---------------|---------|---------------------------| | height | 高cm | Y | integer | ### 4.16、 ItemPageDTO ItemPageDTO 说明：分页内容 | 字段名称 描述 | 类型 |------------------|------------|------------| | totalCount | 总数 | integer | | pageNo 当前页 | integer |------------------------|---------------|---------------------------| | pageSize | 大小 | integer | | content 内容 | T[] |---------------------------|------------|---------------| ### 4.17、 ItemOpenDataDTO ItemOpenDataDTO 说明：商品分页信息实体 | 字段名称 描述 | 类型 |------------------|------------|------------| | itemId | 商品ID | integer | | itemNo 商品货号 | string |------------------------|------------------|------------------------| | title | 商品标题-中文 | string | | itemUrls 商品轮播图URL list | string[] |------------------------------|---------------------------------------------|------------------------------| | stock | 商品库存总数 | integer | | itemStatus 1.商品状态，包括：在售:1；下架：2；待发布：100010； 2.原字段名为 status, 旧版本接口仍可兼容使用 | integer |------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------| | editStatus | 1.商品审核状态，包括 601：存草稿；603：审核中；604：审核不通过；605：审核通过； 2.原字段名为 aduitStatus, 旧版本接口仍可兼容使用 | integer | | categoryId 所属类目id | integer |------------------------------------|------------------------|---------------------------| | purchasePriceMax | 预估收入定价店铺会返回预估收入价格，货币为美金，所有sku的最大价格 | double | | purchasePriceMin 预估收入定价店铺会返回预估收入价格，货币为美金，所有sku的最小价格 | double |------------------------------------------------------|------------------------------------------------------------------------------------------------------------|------------------------| | salePriceMax | 直接定售价店铺会返回多区域的统一售价，货币为美金，所有sku的最大价格 | double | | salePriceMin 直接定售价店铺会返回多区域的统一售价，货币为美金，所有sku的最小价格 | double |------------------------------------------|---------------------------------------------------------------------------------------------------------------|------------------------| | createTime | 商品创建时间 | datetime | | modifyTime 商品更新时间(不包括下单,库存变动,价格变动时间) | datetime |------------------------------------|---------------------------------------------------------------------------------|------------------------------| ### 4.18、 ItemOperationResultDTO ItemOperationResultDTO 说明：商品操作实体 | 字段名称 描述 | 类型 |------------------|------------|------------| | itemId | 商品id,操作对象为itemId 则返回 | integer | | skuId skuId,操作对象为skuId则返回 | integer |---------------------|---------------------------------------------------------------|---------------------------| | success | 是否成功 | boolean | | error 错误信息 | string |---------------------|------------------|------------------------| | msg | 消息 | string | ### ### 4.19、SizeRow DTO SizeRowDTO 说明：尺码行信息 | 字段名称 描述 | 是否必填 类型 | |------------------|------------|------------------|------------| | propertyId | 尺码项ID | N | integer | | valueId 尺码值id | N integer | |---------------------------|---------------------|---------|---------------------------| | name | 名称 | N | string | ### 4.20、SizeRowValue DTO SizeRowValueDTO 说明：尺码行数据信息 | 字段名称 描述 | 是否必填 类型 | |------------------|------------|------------------|------------| | propertyId | 尺码项ID | N | integer | | valueId 尺码值id | N integer | |---------------------------|---------------------|---------|---------------------------| | desc | 尺码值,可填写范围 '-' 分隔 | N | string |