temu

type AdCreateRequest struct {
	CreateAdReqs []AdCreateRequestItem `json:"createAdReqs"` // 创建广告请求
}

type AdCreateRequestItem struct {
	ProductId int64 `json:"productId"` // 货品 ID
	Roas      int   `json:"roas"`      // 目标广告投资回报率，按照实际值乘 10000
	Budget    int   `json:"budget"`    // 广告日预算金额，不限制则传 -1
}

type AdCreateResult struct {
	ProductId int64       `json:"productId"`
	Success   bool        `json:"success"`
	Message   null.String `json:"message"`
}

type AdLogQueryParams struct {
	ProductId null.Int `json:"productId,omitempty"` // 货品 ID
	StartTime int64    `json:"startTime"`           // 查询开始时间，毫秒级时间戳（值以当地时间0点为开始时间）
	EndTime   int64    `json:"endTime"`             // 查询结束时间，毫秒级时间戳（值以当地时间23点59分59秒999毫秒为结束时间）
}

type AdMallReportQueryParams struct {
	StartTs int64 `json:"startTs"` // 查询开始时间，毫秒级时间戳（值以当地时间0点为开始时间）
	EndTs   int64 `json:"endTs"`   // 查询结束时间，毫秒级时间戳（值以当地时间23点59分59秒999毫秒为结束时间）
}

type AdProductReportQueryParams struct {
	ProductId int64 `json:"productId"` // 货品 ID
	StartTs   int64 `json:"startTs"`   // 查询开始时间，毫秒级时间戳（值以当地时间0点为开始时间）
	EndTs     int64 `json:"endTs"`     // 查询结束时间，毫秒级时间戳（值以当地时间23点59分59秒999毫秒为结束时间）
}

type AdQueryParams struct {
	GoodsInfoList []int `json:"productId"`
}

type AdRoasRequest struct {
	GoodsInfoList []struct {
		ProductIds []int64 `json:"productIds"` // 货品 ID
	} `json:"goodsInfoList"`
}

type AdRoasResult struct {
	ProductId int64 `json:"productId"`
	PredList  []struct {
		Roas string `json:"roas"` // 推荐 roas(广告投资回报率)
	} `json:"predList"`
}

type AdUpdateRequest struct {
	ModifyAdDTOs []AdUpdateRequestItem `json:"modifyAdDTOs"`
}

type AdUpdateRequestItem struct {
	ProductId int64 `json:"productId"` // 货品 ID
	Roas      int   `json:"roas"`      // 目标广告投资回报率，按照实际值乘 10000
	Budget    int   `json:"budget"`    // 广告日预算金额，不限制则传 -1
	Status    int   `json:"status"`    // 修改类型：2:暂停, 3:开启
}

type AdUpdateResult = AdCreateResult

type BestSellerInvitationQueryParams struct {
	normal.ParameterWithPager
}

type BoxMarkBarcodeQueryParams struct {
	normal.Parameter
	ReturnDataKey       null.Bool `json:"return_data_key"`     // 是否以打印页面url返回，如果入参是，则不返回参数信息，返回dataKey，通过拼接https://openapi.kuajingmaihuo.com/tool/print?dataKey={返回的dataKey}，访问组装的url即可打印，打印的条码按照入参参数所得结果进行打印
	DeliveryOrderSnList []string  `json:"deliveryOrderSnList"` // 发货单对象列表
}

type Client struct {
	Env          string         // 环境
	Debug        bool           // 是否为 Debug 模式
	Region       string         // 接口所在区域
	Logger       *slog.Logger   // Log
	Services     services       // API services
	TimeLocation *time.Location // 时区
	// contains filtered or unexported fields
}

type CreateDeliveryAddressRequest struct {
	WarehouseType            int64  `json:"warehouseType"`                      // 仓库类型
	WarehouseAreaType        string `json:"warehouseAreaType"`                  // 仓库面积类型
	ProvinceCode             int64  `json:"provinceCode"`                       // 省份编码
	ProvinceName             string `json:"provinceName"`                       // 省名
	CityCode                 int64  `json:"cityCode"`                           // 市编码
	CityName                 string `json:"cityName"`                           // 市名
	DistrictCode             int64  `json:"districtCode"`                       // 区编码
	DistrictName             string `json:"districtName"`                       // 区名
	TownCode                 int64  `json:"townCode,omitempty"`                 // 城镇编码
	TownName                 string `json:"townName,omitempty"`                 // 城镇
	ContactPersonName        string `json:"contactPersonName"`                  // 联系人
	ContactPersonPhoneAreaNo string `json:"contactPersonPhoneAreaNo,omitempty"` // 联系人电话区号
	ContactPersonPhone       string `json:"contactPersonPhone"`                 // 联系人电话
	AddressLabel             string `json:"addressLabel"`                       // 地址标签
	AddressDetail            string `json:"addressDetail"`                      // 详细地址
}

type CustomGoodsBarcodeQueryParams struct {
	NormalGoodsBarcodeQueryParams
	ProductSkuIdList         []int64   `json:"productSkuIdList,omitempty"`         // 货品 SKU ID 列表
	SkcExtCode               string    `json:"skcExtCode,omitempty"`               // SKC 货号
	ProductSkcIdList         []int64   `json:"productSkcIdList,omitempty"`         // 货品 SKC ID 列表
	SkuExtCode               string    `json:"skuExtCode,omitempty"`               // SKU 货号
	LabelCode                int64     `json:"labelCode,omitempty"`                // 标签条码
	PersonalProductSkuIdList []int64   `json:"personalProductSkuIdList,omitempty"` // 定制品 SKU ID
	CreateTimeStart          string    `json:"createTimeStart,omitempty"`          // 定制品创建时间，支持毫秒时间戳
	CreateTimeEnd            string    `json:"createTimeEnd,omitempty"`            // 定制品创建时间，支持毫秒时间戳
	ReturnDataKey            null.Bool `json:"return_data_key"`                    // 是否以打印页面url返回，如果入参是，则不返回参数信息，返回dataKey，通过拼接https://openapi.kuajingmaihuo.com/tool/print?dataKey={返回的dataKey}，访问组装的url即可打印，打印的条码按照入参参数所得结果进行打印
}

type EditPackageRequestItem struct {
	PackageSn      string `json:"packageSn"`      // 包裹号
	TrackingNumber string `json:"trackingNumber"` // 运单号
	ShipCompanyId  int64  `json:"shipCompanyId"`  // 物流公司 id
}

type GoodsBrandQueryParams struct {
	normal.ParameterWithPager
	Page      int    `json:"page"`                // 页码
	Vid       int64  `json:"vid,omitempty"`       // 搜索的属性 ID
	BrandName string `json:"BrandName,omitempty"` // 搜索的品牌名称
}

type GoodsCategoryQueryParams struct {
	SiteId      int       `json:"siteId"`                // 站点 id，当前固定传 1
	ParentCatId null.Int  `json:"parentCatId,omitempty"` // 上级分类 ID
	ShowHidden  null.Bool `json:"showHidden"`            // 是否展示隐藏类目，默认不展示
}

type GoodsCertificationNeedUploadItemRequest struct {
	CertType  int   `json:"certType"`  // 资质类型
	ProductId int64 `json:"productId"` // 货品 ID
}

type GoodsCertificationQueryParams struct {
	CertTypeList []int  `json:"certTypeList,omitempty"` // 资质类型 ID 列表
	ProductId    int64  `json:"productId"`              // 货品 ID
	Language     string `json:"language,omitempty"`     // 语言
}

type GoodsCertificationUploadFile struct {
	FileName      string   `json:"fileName"`                // 文件名称
	FileUrl       string   `json:"fileUrl"`                 // 文件 Url
	ShowCustomer  bool     `json:"showCustomer"`            // 是否同意向消费者展示
	ExpireTime    null.Int `json:"expireTime,omitempty"`    // 失效时间
	EffectiveTime null.Int `json:"effectiveTime,omitempty"` // 生效时间
}

type GoodsCertificationUploadFileRequest struct {
	Base64File string `json:"base64File"` // 支持格式有：jpg/jpeg、png,pdf格式，注意入参图片必须转码为base64编码
	FileName   string `json:"fileName"`   // 文件名，主要用来辨别格式，名字不采用，仅支持jpg/jpeg、png,pdf格式
	IsRealPic  bool   `json:"isRealPic"`  // 是否实拍图，是的话结果连接不需要签名就可以展示，不是的话就需要签名才能展示
}

type GoodsCertificationUploadRequest struct {
	ProductId             int64 `json:"productId"` // 货品 ID
	ProductCatCertReqList []struct {
		CertType           int                            `json:"certType"`           // 资质类型
		AuthCode           string                         `json:"authCode"`           // 资质编号
		ProductCertFiles   []GoodsCertificationUploadFile `json:"productCertFiles"`   // 货品资质文件列表
		InspectReportFiles []GoodsCertificationUploadFile `json:"inspectReportFiles"` // 检测报告文件列表
		RealPictures       []struct {
			ImageUrl string `json:"imageUrl"` // 图片 Url
		} `json:"realPictures"` // 实物图列表
	} `json:"productCatCertReqList"` // 货品类目资质请求列表，仅传需上传的资质类型，审核通过/审核中的勿传
}

type GoodsCreateGoodsLayerDecoration struct {
	FloorId     null.Int `json:"floorId"`  // 楼层id,null:新增,否则为更新
	GoodsId     int64    `json:"goodsId"`  // 商品 ID
	Lang        string   `json:"lang"`     // 语言类型
	Type        string   `json:"type"`     // 组件类型type,图片-image,文本-text 商详需要包含至少一个图片类型组件
	Priority    int      `json:"priority"` // 楼层排序
	Key         string   `json:"key"`      // 楼层类型的key,目前默认传'DecImage'
	ContentList []struct {
		ImgUrl            string `json:"imgUrl"` // 图片地址--通用，图片最大3M
		Width             int    `json:"width"`  // 图片宽度--通用，宽度最小480px
		Text              string `json:"text"`   // 文字信息--文字模块，文本-text必填，长度限制500字符内
		Height            int    `json:"height"` // 图片高度--通用，高度最小480px
		TextModuleDetails struct {
			BackgroundColor string `json:"backgroundColor"` // 背景颜色文本-text必填，六位值，例#ffffff
			FontFamily      int    `json:"fontFamily"`      // 字体类型文本-text不传
			FontSize        int    `json:"fontSize"`        // 文字模块字体大小文本-text必传12
			Align           string `json:"align"`           // 文字对齐方式，left--左对齐；right--右对齐；center--居中；justify--两端对齐文本-text必填
			FontColor       string `json:"fontColor"`       // 文字颜色文本-text必填，六位值，例#333333
		} `json:"textModuleDetails"` // 文字模块详情文本-text必填
	} `json:"contentList"` // 楼层内容
}

type GoodsCreateModel struct {
	ModelProfileUrl string `json:"modelProfileUrl"` // 模特头像
	SizeSpecName    string `json:"sizeSpecName"`    // 试穿尺码规格名称
	ModelId         int    `json:"modelId"`         // 模特id，通过模特信息查询接口获取
	SizeSpecId      int    `json:"sizeSpecId"`      // 试穿尺码规格id
	ModelWaist      string `json:"modelWaist"`      // 模特腰围文本, modelType=2传空值
	ModelType       int    `json:"modelType"`       // 模特类型，1：成衣模特，2：鞋模
	ModelName       string `json:"modelName"`       // 模特名称
	ModelHeight     string `json:"modelHeight"`     // 模特身高文本modelType=2传空值
	ModelFeature    int    `json:"modelFeature"`    // 模特特性，1：真实模特
	ModelFootWidth  string `json:"modelFootWidth"`  // 模特脚宽文本modelType=1传空值
	ModelBust       string `json:"modelBust"`       // 模特胸围文本modelType=2传空值
	ModelFootLength string `json:"modelFootLength"` // 模特脚长文本modelType=1传空值
	TryOnResult     int    `json:"tryOnResult"`     // 试穿心得 TRUE_TO_SIZE(1, "舒适"),    TOO_SMALL(2, "紧身"),    TOO_LARGE(3, "宽松"),
	ModelHip        string `json:"modelHip"`        // 模特臀围文本modelType=2传空值
}

type GoodsCreateProductCarouseVideo struct {
	Vid      string `json:"vid"`      // 视频 VID
	CoverUrl string `json:"coverUrl"` // 视频封面图
	VideoUrl string `json:"videoUrl"` // 视频 URL
	Width    int    `json:"width"`    // 视频宽度
	Height   int    `json:"height"`   // 视频高度
}

type GoodsCreateProductCustom struct {
	GoodsLabelName   string `json:"goodsLabelName"`   // 货品关务标签名称
	IsRecommendedTag bool   `json:"isRecommendedTag"` // 是否使用推荐标签
}

type GoodsCreateProductGuideFile struct {
	FileName      string   `json:"fileName"`      // 文件名称
	PdfMaterialId int      `json:"pdfMaterialId"` // pdf文件id，通过file.upload上传返回得到
	Languages     []string `json:"languages"`     // 语言（zh-中文、en-英文）
}

type GoodsCreateProductI18n struct {
	Language    string `json:"language"`    // 语言编码，en-美国
	ProductName string `json:"productName"` // 对应语言的商品标题
}

type GoodsCreateProductOuterPackage struct {
	PackageShape int `json:"packageShape"` // 外包装形状0:不规则形状 1:长方体 2:圆柱体
	PackageType  int `json:"packageType"`  // 外包装类型0:硬包装 1:软包装+硬物 2:软包装+软物
}

type GoodsCreateProductOuterPackageImage struct {
	ImageUrl string `json:"imageUrl"` // 图片链接，通过图片上传接口，imageBizType=1获取
}

type GoodsCreateProductProperty struct {
	TemplatePid      int64  `json:"templatePid"`      // 模板属性 id
	Pid              int64  `json:"pid"`              // 属性 id
	RefPid           int64  `json:"refPid"`           // 引用属性 id
	PropName         string `json:"propName"`         // 引用属性名
	Vid              int64  `json:"vid"`              // 基础属性值 id，没有的情况传 0
	PropValue        string `json:"propValue"`        // 基础属性值
	ValueUnit        string `json:"valueUnit"`        // 属性值单位，没有的情况传空字符串
	NumberInputValue string `json:"numberInputValue"` // 属性输入值，例如：65.66
	ValueExtendInfo  string `json:"valueExtendInfo"`  // 属性扩展信息，attrs.get 返回
}

type GoodsCreateProductSaleExtAttr struct {
	ProductSecondHandReq struct {
		IsSecondHand    bool `json:"isSecondHand"`    // 是否二手货品，二手店铺传true，其他店铺不传值
		SecondHandLevel int  `json:"secondHandLevel"` // 成色定义，二手货品必传值，非二手货品不可传值，枚举值：（1：接近全新，2：状况极佳，3：状况良好，4：尚可接受）
	} `json:"productSecondHandReq"` // 货品二手信息，二手店铺传值，其他店铺不传值
	InventoryRegion int `json:"inventoryRegion"` // 备货区域
	// 满足如下两个条件时，必填无充电器版本货品id
	// 引用属性：refPid=6919, propName="是否售卖不含充电器的同款商品"
	// 属性值：vid=147374, value="是"
	ProductNoChargerReq struct {
		NoChargerProductIds []int `json:"noChargerProductIds"` // 无充电器版本spuid，至少入参1个，至多入参3个
	} `json:"productNoChargerReq"` // 无充电器版本spuid请求
}

type GoodsCreateProductSemiManaged struct {
	BindSiteIds []int `json:"bindSiteIds"` // 绑定站点列表
	// 半托管-素材语种策略，不传默认2
	// 1：仅站点本地语种素材，允许只上传站点本地语种的素材（多语言素材节点上传本地素材，英语素材也可使用本地语种素材填充）
	// 关联节点如下：
	// - 多语言标题（productI18nReqs）
	// - 多语言素材（materialMultiLanguages、carouselImageI18nReqs、productSkcCarouselImageI18nReqs、productSkuThumbUrlI18nReqs）
	//
	// 当前支持日本站、墨西哥站，使用语言如下：
	// 日本站：多语言标题和素材均使用ja
	// 墨西哥站：多语言标题语言传es-MX。多语言素材语言传es
	//
	// 2：英语以及其他语种
	SemiLanguageStrategy int `json:"emiLanguageStrategy"` // 半托管-素材语种策略
}

type GoodsCreateProductShipment struct {
	FreightTemplateId   string `json:"freightTemplateId"`   // 运费模板 id，使用 temu.logistics.template.get 查询，详见：https://seller.kuajingmaihuo.com/sop/view/867739977041685428#pa858C
	ShipmentLimitSecond int    `json:"shipmentLimitSecond"` // 承诺发货时间(单位:s)，可选值：86400，172800，259200（仅定制品可用）
}

type GoodsCreateProductSkc struct {
	PreviewImgUrls                  []string                `json:"previewImgUrls"`                  // SKC 轮播图列表
	ProductSkcCarouselImageI18nReqs []ProductImageUrl       `json:"productSkcCarouselImageI18nReqs"` // SKC 多语言轮播图，服饰类必传，非服饰不传
	ColorImageUrl                   string                  `json:"colorImageUrl"`                   // SKC 色块图，可通过（temu.colorimageurl.get）转换获取
	MainProductSkuSpecReqs          []entity.Specification  `json:"mainProductSkuSpecReqs"`          // 主销售规格列表
	IsBasePlate                     int                     `json:"isBasePlate"`                     // 是否底板
	ProductSkuReqs                  []GoodsCreateProductSku `json:"productSkuReqs"`                  // 货品 sku 列表
	ExtCode                         string                  `json:"extCode"`                         // 货号
}

type GoodsCreateProductSku struct {
	ThumbUrl                   string                                        `json:"thumbUrl"`                             // 预览图
	ProductSkuThumbUrlI18nReqs []ProductImageUrl                             `json:"productSkuThumbUrlI18nReqs"`           // SKU多语言预览图，服饰类不传，非服饰非必传 （英国英语、中东英语必传）
	CurrencyType               string                                        `json:"currencyType"`                         // 币种 (CNY: 人民币, USD: 美元) (默认人民币)
	ProductSkuSpecReqs         []entity.Specification                        `json:"productSkuSpecReqs"`                   // 货品sku规格列表
	SupplierPrice              int64                                         `json:"supplierPrice"`                        // 全托供货价 （单位：人民币-分/美元-美分），半托不传
	SiteSupplierPrices         []GoodsCreateProductSkuSiteSupplierPrice      `json:"siteSupplierPrices"`                   // 站点供货价列表，半托必传
	ProductSkuStockQuantityReq *GoodsCreateProductSkuProductSkuStockQuantity `json:"productSkuStockQuantityReq,omitempty"` // 货品sku仓库库存，半托管发品必传
	ProductSkuMultiPackReq     *GoodsCreateProductSkuProductSkuMultiPack     `json:"productSkuMultiPackReq,omitempty"`     // 货品多包规请求
	// 货品sku建议价格请求
	// 1. 建议零售价是制造商为产品设定的建议零售价或推荐零售价。建议零售价必须是市场上的真实销售价格，且符合任何可适用的法律法规的规定。如您的商品在欧盟市场上销售，则该产品必须有欧盟零售商以此价格进行真实的广告宣传和销售。如果您的产品没有符合这些标准的建议零售价，请勿填写建议零售价，而应该填写NA。当您所提供的建议零售价有所更新时，您需要确保对建议零售价进行更新。
	// 2. 通过输入建议零售价，您确认：
	//  a. - 您不是该产品在所销售的市场上唯一的卖家（因此在该市场上，建议零售价可以被用作比较价格）；并且
	//  b. - 您有证据表明您提供的建议零售价是该产品真实的一般销售价格，如您的商品在欧盟市场上销售，则该产品必须有欧盟零售商以此价格进行真实的广告宣传和销售，且该建议零售价是经由制造商审慎计算的。当Temu要求的时候，您必须向其提供此类证据。
	// 3. 如果得知或发现建议零售价不符合上述标准，Temu 有权自行决定删除任何建议零售价相关信息。
	ProductSkuSuggestedPriceReq *GoodsCreateProductSkuSuggestedPrice `json:"productSkuSuggestedPriceReq,omitempty"` // 货品sku建议价格请求
	ProductSkuWhExtAttrReq      *GoodsCreateProductSkuWhExtAttr      `json:"productSkuWhExtAttrReq,omitempty"`      // 货品sku扩展属性
	ExtCode                     string                               `json:"extCode"`                               // 货品 skc 外部编码，没有的场景传空字符串
}

type GoodsCreateProductSkuProductSkuMultiPack struct {
	NumberOfPieces          int `json:"numberOfPieces"` // 件数，单品默认是1
	ProductSkuNetContentReq struct {
		NetContentUnitCode int `json:"netContentUnitCode"` // 净含量单位，1：液体盎司，2：毫升，3：加仑，4：升，5：克，6：千克，7：常衡盎司，8：磅
		NetContentNumber   int `json:"netContentNumber"`   // 净含量数值
	} `json:"productSkuNetContentReq"` // 净含量请求，传空对象表示空，指定类目灰度管控
	SkuClassification  int `json:"skuClassification"`  // sku分类，1：单品，2：组合装，3：混合套装
	PieceUnitCode      int `json:"pieceUnitCode"`      // 单件单位，1：件，2：双，3：包
	IndividuallyPacked int `json:"individuallyPacked"` // 是否独立包装，当 sku 分类为同款多件装或混合套装时，必填 1:是，0:否
}

type GoodsCreateProductSkuProductSkuStockQuantity struct {
	WarehouseStockQuantityReqs []struct {
		TargetStockAvailable int    `json:"targetStockAvailable"` // sku目标库存值（覆盖写）
		WarehouseId          string `json:"warehouseId"`          // 仓库 ID
	} `json:"warehouseStockQuantityReqs"` // 仓库存库存请求列表
}

type GoodsCreateProductSkuSiteSupplierPrice struct {
	SiteId        int64 `json:"siteId"`        // 申报价格站点id
	SupplierPrice int64 `json:"supplierPrice"` // 站点申报价格，单位 人民币：分，美元：美分
}

type GoodsCreateProductSkuSuggestedPrice struct {
	// 特殊建议价格，用来标记商家是否有建议价格，传参规则如下：
	// - 传参为NA，则认为商家没有货品建议价格，即suggestedPrice和suggestedPriceCurrencyType这两个字段都不需要传；
	// - 不传该字段，则要求suggestedPrice和suggestedPriceCurrencyType字段必传，不传则会报错；
	// 示例：
	// - productSkuSuggestedPriceReq
	// -specialSuggestedPrice：NA
	// -----------------------------------------
	// - productSkuSuggestedPriceReq
	// -suggestedPriceCurrencyType：CNY
	// -suggestedPrice：10
	SpecialSuggestedPrice      string `json:"specialSuggestedPrice"`                //  特殊建议价格，用来标记商家是否有建议价格
	SuggestedPriceCurrencyType string `json:"suggestedPriceCurrencyType,omitempty"` // 建议价格币种（USD:美元,CNY:人民币,JPY:日元,CAD:加拿大元,GBP:英镑,AUD:澳大利亚元,NZD:新西兰元,EUR:欧元,MXN:墨西哥比索,PLN:波兰兹罗提,SEK:瑞典克朗,CHF:瑞士法郎,KRW:韩元,SAR:沙特里亚尔,SGD:新加坡元,AED:阿联酋迪拉姆,KWD:科威特第纳尔,NOK:挪威克朗,CLP:智利比索,MYR:马来西亚林吉特,PHP:菲律宾比索,TWD:新台湾元,THB:泰铢,QAR:卡塔尔里亚尔,JOD:约旦第纳尔,BRL:巴西雷亚尔,OMR:阿曼里亚尔,BHD:巴林第纳尔,ILS:以色列新锡克尔,ZAR:南非兰特,CZK:捷克克朗,HUF:匈牙利福林,DKK:丹麦克朗,RON:罗马尼亚列伊,BGN:保加利亚列瓦,HKD:港元,COP:哥伦比亚比索,GEL:格鲁吉亚拉里）
	// 建议价格，币种枚举值：
	// 备注：辅助单位分别为0、1、2、3分别对应前端录入信息时需要原值上
	// ×1、10、100、1000，再把转换后的数据传给后端
	//export declare enum Currency {
	//    /** 美元，辅助单位为 2 */
	//    USD = "USD",
	//    /** 人民币，辅助单位为 2 */
	//    CNY = "CNY",
	//    /** 日元，辅助单位为 0 */
	//    JPY = "JPY",
	//    /** 加拿大元, 辅助单位为 2 */
	//    CAD = "CAD",
	//    /** 英镑，辅助单位为 2 */
	//    GBP = "GBP",
	//    /** 澳大利亚，辅助单位为 2 */
	//    AUD = "AUD",
	//    /** 新西兰，辅助单位为 2 */
	//    NZD = "NZD",
	//    /**
	//     * 欧盟地区，统一用欧元，辅助单位为 2
	//     * 欧元区： 亚克罗提利与德凯利亚、 安道尔（AD）、 奥地利（AT）、 比利时（BE）、 赛普勒斯（CY）、 爱沙尼亚（EE）、
	//     * 芬兰（FI）、 法国（FR）、 德国（DE）、 希腊（GR）、 瓜德罗普（GP）、 爱尔兰（IE）、
	//     * 义大利（IT）、 科索沃、 拉脱维亚（LV）、 立陶宛（LT）、 卢森堡（LU）、 马尔他（MT）、 马提尼克（MQ）、
	//     * 马约特（YT）、 摩纳哥（MC）、 蒙特内哥罗（ME）、 荷兰（NL）、 葡萄牙（PT）、 留尼汪（RE）、 圣巴泰勒米（BL）、
	//     * 圣皮埃尔和密克隆（PM）、 圣马力诺（SM）、 斯洛伐克（SK）、 斯洛维尼亚（SI）、 西班牙（ES）、 梵蒂冈（VA）;
	//     */
	//    EUR = "EUR",
	//    /** 墨西哥，辅助单位为 2 */
	//    MXN = "MXN",
	//    /** 波兰，辅助单位为 2 */
	//    PLN = "PLN",
	//    /** 瑞典，辅助单位为 2 */
	//    SEK = "SEK",
	//    /** 瑞士，辅助单位为 2 */
	//    CHF = "CHF",
	//    /** 韩元，辅助单位为 0 */
	//    KRW = "KRW",
	//    /** 沙特, 辅助单位为 2 */
	//    SAR = "SAR",
	//    /** 新加坡, 辅助单位为 2 */
	//    SGD = "SGD",
	//    /** 阿联酋, 辅助单位为 2 */
	//    AED = "AED",
	//    /** 科威特，辅助单位为 3 */
	//    KWD = "KWD",
	//    /** 挪威, 辅助单位为 2 */
	//    NOK = "NOK",
	//    /** 智利, 辅助单位为 0 */
	//    CLP = "CLP",
	//    /** 马来西亚, 辅助单位为 2 */
	//    MYR = "MYR",
	//    /** 菲律宾, 辅助单位为 2 */
	//    PHP = "PHP",
	//    /** 台湾, 辅助单位为 2 */
	//    TWD = "TWD",
	//    /** 泰国, 辅助单位为 2 */
	//    THB = "THB",
	//    /** 卡塔尔, 辅助单位为 2 */
	//    QAR = "QAR",
	//    /** 约旦, 辅助单位为 3 */
	//    JOD = "JOD",
	//    /** 巴西, 辅助单位为 2 */
	//    BRL = "BRL",
	//    /** 阿曼, 辅助单位为 3 */
	//    OMR = "OMR",
	//    /** 巴林, 辅助单位为 3 */
	//    BHD = "BHD",
	//    /** 以色列, 辅助单位为 2 */
	//    ILS = "ILS",
	//    /** 南非, 辅助单位为 2 */
	//    ZAR = "ZAR",
	//    /** 捷克, 辅助单位为 2，但是输入的时候不能输入小数需特殊处理 */
	//    CZK = "CZK",
	//    /** 匈牙利, 辅助单位为 2，但是输入的时候不能输入小数需特殊处理 */
	//    HUF = "HUF",
	//    /** 丹麦, 辅助单位为 2 */
	//    DKK = "DKK",
	//    /** 罗马尼亚, 辅助单位为 2 */
	//    RON = "RON",
	//    /** 保加利亚, 辅助单位为 2 */
	//    BGN = "BGN",
	//    /** 香港, 辅助单位为 2 */
	//    HKD = "HKD",
	//    /** 哥伦比亚, 辅助单位为 2 */
	//    COP = "COP",
	//    /** 格鲁吉亚拉里, 辅助单位为 2 */
	//    GEL = "GEL"
	// }
	SuggestedPrice int `json:"suggestedPrice,omitempty"` // 建议价格
}

type GoodsCreateProductSkuWhExtAttr struct {
	ProductSkuWeightReq         GoodsCreateProductSkuWhExtAttrSensitiveLimitProductSkuWeight `json:"productSkuWeightReq"`                   // 货品sku重量
	ProductSkuSameReferPriceReq GoodsCreateProductSkuWhExtAttrSameReferPrice                 `json:"productSkuSameReferPriceReq"`           // 同款参考
	ProductSkuSensitiveLimitReq *GoodsCreateProductSkuWhExtAttrSensitiveLimit                `json:"productSkuSensitiveLimitReq,omitempty"` // 货品sku敏感属性限制请求
	ProductSkuVolumeReq         GoodsCreateProductSkuWhExtAttrVolume                         `json:"productSkuVolumeReq"`                   // 货品sku体积
	ProductSkuSensitiveAttrReq  GoodsCreateProductSkuWhExtAttrSensitiveAttr                  `json:"productSkuSensitiveAttrReq"`            // 货品 sku 敏感属性请求
	ProductSkuBarCodeReqs       []GoodsCreateProductSkuWhExtAttrBarCode                      `json:"productSkuBarCodeReqs,omitempty"`
}

type GoodsCreateProductSkuWhExtAttrBarCode struct {
	Code     string `json:"code"`     // 商品标准编码
	CodeType int    `json:"codeType"` // 条码类型 (1: EAN, 2: UPC, 3: ISBN)
}

type GoodsCreateProductSkuWhExtAttrSameReferPrice struct {
	Url string `json:"url"` // 站外同款商品售卖链接，有效链接规则，链接开头含：http:// 、 https:// 等
}

type GoodsCreateProductSkuWhExtAttrSensitiveAttr struct {
	IsSensitive   int   `json:"isSensitive"`   // 是否敏感属性，0：非敏感，1：敏感
	SensitiveList []int `json:"sensitiveList"` // 敏感类型，        PURE_ELECTRIC(110001, "纯电"),    INTERNAL_ELECTRIC(120001, "内电"),    MAGNETISM(130001, "磁性"),    LIQUID(140001, "液体"),    POWDER(150001, "粉末"),    PASTE(160001, "膏体"),    CUTTER(170001, "刀具")
}

type GoodsCreateProductSkuWhExtAttrSensitiveLimit struct {
	MaxBatteryCapacity   int `json:"maxBatteryCapacity"`   // 最大电池容量 (Wh)
	MaxBatteryCapacityHp int `json:"maxBatteryCapacityHp"` // 最大电池容量 (mWh)
	MaxLiquidCapacity    int `json:"maxLiquidCapacity"`    // 最大液体容量 (mL)
	MaxLiquidCapacityHp  int `json:"maxLiquidCapacityHp"`  // 最大液体容量 (μL)
	MaxKnifeLength       int `json:"maxKnifeLength"`       // 最大刀具长度 (mm)
	MaxKnifeLengthHp     int `json:"maxKnifeLengthHp"`     // 最大刀具长度 (μm)
	KnifeTipAngle        struct {
		Degrees int `json:"degrees"` //	度数
	} `json:"knifeTipAngle"` // 刀尖角度
}

type GoodsCreateProductSkuWhExtAttrSensitiveLimitProductSkuWeight struct {
	Value int `json:"value"` // 重量值，单位mg
}

type GoodsCreateProductSkuWhExtAttrVolume struct {
	Len    int `json:"len"`    // 长，单位mm
	Width  int `json:"width"`  // 宽，单位mm
	Height int `json:"height"` // 高，单位mm
}

type GoodsCreateProductSpecProperty struct {
	TemplatePid      int64  `json:"templatePid"`      // 模板属性id
	Pid              int64  `json:"pid"`              // 属性 id
	RefPid           int64  `json:"refPid"`           // 引用属性 id
	PropName         string `json:"propName"`         // 引用属性名
	Vid              int64  `json:"vid"`              // 基础属性值id，没有的情况传0
	PropValue        string `json:"propValue"`        // 基础属性值
	ParentSpecId     int    `json:"parentSpecId"`     // 父规格id
	ParentSpecName   string `json:"parentSpecName"`   // 父规格名称
	SpecId           int    `json:"specId"`           // 规格id
	SpecName         string `json:"specName"`         // 规格名称
	ValueGroupId     int    `json:"valueGroupId"`     // 属性值组id，没有的情况传0
	ValueGroupName   string `json:"valueGroupName"`   // 属性值组名称，没有的情况传空字符串
	ValueUnit        string `json:"valueUnit"`        // 属性值单位，没有的情况传空字符串
	NumberInputValue string `json:"numberInputValue"` // 属性输入值，例如：65.66
	ValueExtendInfo  string `json:"valueExtendInfo"`  // 属性组扩展信息（色板）
}

type GoodsCreateProductWarehouse struct {
	TargetRouteList []struct {
		SiteIdList  []int  `json:"siteIdList"`  // 站点列表
		WarehouseId string `json:"warehouseId"` // 仓库ID，使用goods.warehouse.list.get查询
	} `json:"targetRouteList"` // 商品的目标路由列表
}

type GoodsCreateProductWhExtAttr struct {
	OuterGoodsUrl string `json:"outerGoodsUrl"` //  站外商品链接
	ProductOrigin struct {
		Region1ShortName string `json:"region1ShortName"` // 一级区域简称 (二字简码)
		// 枚举值：https://seller.kuajingmaihuo.com/sop/view/735407268315104853
		Region2Id string `json:"region2Id"` // 二级区域地址ID，当region1ShortName为CN时，必传
	} `json:"productOrigin"` // 货品产地 (灰度内必传)，请注意，日本站点发品必须传产地，否则会被拦截
}

type GoodsCreateRequest struct {
	Cat1Id                       int64                                 `json:"cat1Id"`                             // 一级类目id
	Cat2Id                       int64                                 `json:"cat2Id"`                             // 二级类目id
	Cat3Id                       int64                                 `json:"cat3Id"`                             // 三级类目id
	Cat4Id                       int64                                 `json:"cat4Id"`                             // 四级类目id（没有的情况传 0）
	Cat5Id                       int64                                 `json:"cat5Id"`                             // 五级类目id（没有的情况传 0）
	Cat6Id                       int64                                 `json:"cat6Id"`                             // 六级类目id（没有的情况传 0）
	Cat7Id                       int64                                 `json:"cat7Id"`                             // 七级类目id（没有的情况传 0）
	Cat8Id                       int64                                 `json:"cat8Id"`                             // 八级类目id（没有的情况传 0）
	Cat9Id                       int64                                 `json:"cat9Id"`                             // 九级类目id（没有的情况传 0）
	Cat10Id                      int64                                 `json:"cat10Id"`                            // 十级类目id（没有的情况传 0）
	ProductWarehouseRouteReq     *GoodsCreateProductWarehouse          `json:"productWarehouseRouteReq,omitempty"` // 库存仓库配置对象。	半托管发品必传，全托管店铺不需要传这个属性，传入会报错。
	ProductI18nReqs              []GoodsCreateProductI18n              `json:"productI18nReqs,omitempty"`          // 多语言标题设置
	ProductName                  string                                `json:"productName"`                        // 货品名称
	ProductCarouseVideoReqList   []GoodsCreateProductCarouseVideo      `json:"productCarouseVideoReqList"`         // 商品主图视频 关于如何上传视频，请对接视频上传相关接口，获取图片相关参数即可用于此处入参 https://seller.kuajingmaihuo.com/sop/view/852640595329867111
	ProductCustomReq             *GoodsCreateProductCustom             `json:"productCustomReq,omitempty"`         // 货品关务标签
	CarouselImageUrls            []string                              `json:"carouselImageUrls"`                  // 货品轮播图
	CarouselImageI18nReqs        []ProductImageUrl                     `json:"carouselImageI18nReqs"`              // 货品 SPU 多语言轮播图，服饰类不传，非服饰必传
	ProductOuterPackageImageReqs []GoodsCreateProductOuterPackageImage `json:"productOuterPackageImageReqs"`       // 外包装图片
	MaterialImgUrl               string                                `json:"materialImgUrl"`                     // 素材图
	ProductPropertyReqs          []GoodsCreateProductProperty          `json:"productPropertyReqs"`                // 货品属性
	ProductSpecPropertyReqs      []GoodsCreateProductSpecProperty      `json:"productSpecPropertyReqs"`
	// 货品规格属性
	ProductSaleExtAttrReq    *GoodsCreateProductSaleExtAttr    `json:"productSaleExtAttrReq,omitempty"`  // 货品销售类扩展属性请求
	ProductWhExtAttrReq      GoodsCreateProductWhExtAttr       `json:"productWhExtAttrReq"`              // 货品仓配供应链侧扩展属性请求
	ProductSkcReqs           []GoodsCreateProductSkc           `json:"productSkcReqs"`                   // 货品 skc 列表
	SizeTemplateIds          []int                             `json:"sizeTemplateIds"`                  // 尺码表模板id（从sizecharts.template.create获取），无尺码表时传空数组[]
	GoodsModelReqs           []GoodsCreateModel                `json:"goodsModelReqs"`                   // 商品模特列表请求
	ShowSizeTemplateIds      []int64                           `json:"showSizeTemplateIds"`              // 套装尺码表展示，至多2个尺码表模板id入参
	ProductOuterPackageReq   *GoodsCreateProductOuterPackage   `json:"productOuterPackageReq,omitempty"` // 货品外包装信息
	ProductGuideFileReqs     []GoodsCreateProductGuideFile     `json:"productGuideFileReqs"`             // 说明书请求对象
	GoodsLayerDecorationReqs []GoodsCreateGoodsLayerDecoration `json:"goodsLayerDecorationReqs"`         // 商详装饰
	PersonalizationSwitch    int                               `json:"personalizationSwitch"`            // 是否定制品，API发品标记定制品后，请及时在卖家中心配置定制模版信息，否则无法正常加站点售卖 0：非定制品、1：定制品
	ProductSemiManagedReq    *GoodsCreateProductSemiManaged    `json:"productSemiManagedReq,omitempty"`  // 半托管相关信息
	ProductShipmentReq       *GoodsCreateProductShipment       `json:"productShipmentReq,omitempty"`     // 半托管货品配送信息请求
	AddProductChannelType    int                               `json:"addProductChannelType"`            // 发品渠道
	MaterialMultiLanguages   []string                          `json:"materialMultiLanguages"`           // 图片多语言列表
}

type GoodsCreateResult struct {
	ProductId      int64 `json:"productId"` // 货品 id
	ProductSkcList []struct {
		ProductSkcId int64 `json:"productSkcId"` // skc id
	} `json:"productSkcList"` //  skc列表
	ProductSkuList []struct {
		ProductSkcId int64                  `json:"productSkcId "` // SKC ID
		ProductSkuId int64                  `json:"productSkuId"`  // sku id
		ExtCode      string                 `json:"extCode"`       // sku 外部编码
		SkuSpecList  []entity.Specification `json:"skuSpecList"`   // sku 规格
	} `json:"productSkuList"` // sku 列表
}

type GoodsEditPropertyItem struct {
	Vid              int64  `json:"vid"`              // 基础属性值 ID，没有的情况传 0
	ValueUnit        string `json:"valueUnit"`        // 属性值单位，没有的情况传空字符串
	Pid              int64  `json:"pid"`              // 属性 ID
	TemplatePid      int64  `json:"templatePid"`      // 模板属性 ID
	NumberInputValue string `json:"numberInputValue"` // 数值录入
	PropValue        string `json:"propValue"`        // 基础属性值
	PropName         string `json:"propName"`         // 引用属性名
	RefPid           int64  `json:"refPid"`           // 引用属性 ID
}

type GoodsEditPropertyRequest struct {
	ProductId         int64                   `json:"productId"`
	ProductProperties []GoodsEditPropertyItem `json:"productProperties"` // 货品属性
}

type GoodsEditSensitiveAttrRequest struct {
	ProductId  int64 `json:"productId"`
	SkuReqList []struct {
		ProductSkuId                int64 `json:"productSkuId"` // 货品 skuId
		ProductSkuSensitiveLimitReq struct {
			MaxBatteryCapacityHp int64 `json:"maxBatteryCapacityHp"` // 最大电池容量 (mWh)
			MaxLiquidCapacityHp  int64 `json:"maxLiquidCapacityHp"`  // 最大液体容量 (μL)
			MaxKnifeLengthHp     int64 `json:"maxKnifeLengthHp"`     //	最大刀具长度 (μm)
			KnifeTipAngle        struct {
				Degrees int `json:"degrees"` // 度[1, 360]
			} `json:"knifeTipAngle"` // 刀尖角度
		} `json:"productSkuSensitiveLimitReq"` // 货品 sku 敏感属性限制请求 (编辑场景、没有限制时, 传空对象)
		ProductSkuSensitiveAttrReq struct {
			IsSensitive   int   `json:"isSensitive"`   // 是否敏感属性，0：非敏感，1：敏感
			SensitiveList []int `json:"sensitiveList"` // 敏感类型， PURE_ELECTRIC(110001, "纯电"), INTERNAL_ELECTRIC(120001, "内电"), MAGNETISM(130001, "磁性"), LIQUID(140001, "液体"), POWDER(150001, "粉末"), PASTE(160001, "膏体"), CUTTER(170001, "刀具")
		} `json:"productSkuSensitiveAttrReq"` // 货品 sku 敏感属性请求
	} `json:"skuReqList"` // sku 敏感品属性请求列表
}

type GoodsImageUploadOption struct {
	Boost              bool `json:"boost"`              // 是否 AI 清晰度提升
	CateId             int  `json:"cateId"`             // 叶子类目 ID，按不同类型进行裁剪，当doIntelligenceCrop=true生效
	DoIntelligenceCrop bool `json:"doIntelligenceCrop"` // 是否 AI 智能裁剪，true-根据sizeMode返回一组智能裁剪图（1张原图+3张裁剪图）
	SizeMode           int  `json:"sizeMode"`           // 返回尺寸大小，0-原图大小，1-800*800（1:1），2-1350*1800（3:4）
}

type GoodsImageUploadRequest struct {
	Image        string                  `json:"image"`                  // 支持格式有：jpg/jpeg、png等图片格式，注意入参图片必须转码为base64编码
	ImageBizType null.Int                `json:"imageBizType,omitempty"` // 枚举值：0、1，入参1返回的 url 用以货品发布时的外包装使用
	Options      *GoodsImageUploadOption `json:"options,omitempty"`      // 图片上传选项
}

type GoodsLifeCycleQueryParams struct {
	normal.ParameterWithPager
	Page             int     `json:"pageNum"`                    // 页码
	ProductSkuIdList []int64 `json:"productSkuIdList,omitempty"` // 货品 skuId 列表
	MallId           int64   `json:"mallId,omitempty"`           // 商家店铺 ID
}

type GoodsMigrateRequest struct {
	MigrationList []struct {
		ProductSemiManagedReq struct {
			BindSiteIds         []int `json:"bindSiteIds"`         // 绑定站点列表
			SemiManagedSiteMode int   `json:"semiManagedSiteMode"` // 半托管站点售卖模式
		} `json:"productSemiManagedReq"` // 半托管货品信息
		ProductWarehouseRouteReq struct {
			TargetRouteList []struct {
				SiteIdList  []int  `json:"siteIdList"`  // 站点 ID 列表
				WarehouseId string `json:"warehouseId"` // 仓库 ID
			} `json:"targetRouteList"` // 目标自发货站点-仓关系列表
		} `json:"productWarehouseRouteReq"` // 货品仓库路由信息
		SkcDetails []struct {
			SkuDetails []struct {
				CurrencyType string `json:"currencyType"` // 币种
				SpecList     []struct {
					SpecId         int    `json:"specId"`         // 规格id
					ParentSpecName string `json:"parentSpecName"` // 父规格名称
					ParentSpecId   int    `json:"parentSpecId"`   // 父规格id
					SpecName       string `json:"specName"`       // 规格名称
				} `json:"specList"` // sku 规格列表
			} `json:"skuDetails"` // sku明细列表
		} `json:"skcDetails"` // skc 明细列表
	} `json:"migrationList"` // 搬运列表
}

type GoodsPriceFullAdjustmentConfirmItem struct {
	PriceOrderSn string `json:"priceOrderSn"` // 调价单号
	Result       int    `json:"result"`       // 审核结果 1-通过
}

type GoodsPriceFullAdjustmentConfirmRequest struct {
	AdjustList []GoodsPriceFullAdjustmentConfirmItem `json:"adjustList"` // 调价列表
}

type GoodsPriceFullAdjustmentQueryParams struct {
	normal.ParameterWithPager
	SkcId               []int64  `json:"skcId"`               // Skc ID
	ExtCodeType         int      `json:"extCodeType"`         // 货号类型 1-skc货号 2-sku货号
	PriceOrderSn        []string `json:"priceOrderSn"`        // 调价单号
	PriceType           int      `json:"priceType"`           // 价格类型, 0-日常价，1-活动价
	FilterProductSource int      `json:"filterProductSource"` // 调价来源. 可选值含义说明:[1:超越爆款计划;2:绿通优先发货;3:其他;47:广告渠道补贴;]
	Source              int      `json:"source"`              // 申请来源 1-运营，2-供应商
	ProductName         string   `json:"productName"`         // 货品名称
	SupportPersonal     int      `json:"supportPersonal"`     // 是否支持定制化商品，1的时候是定制,0 是查非定制，为空不做筛选
	ExtCodes            []string `json:"extCodes"`            // 货号列表
	CreatedAtEnd        int64    `json:"createdAtEnd"`        // 创建日期-结束，精确到毫秒(13位)
	CreatedAtBegin      int64    `json:"createdAtBegin"`      // 创建日期-开始，精确到毫秒(13位)
	Status              int      `json:"status"`              // 状态 0-待调价，1-带供应商确认，2-调价成功，3-调价失败
}

type GoodsPriceQueryParams struct {
	ProductSkuIds []int64 `json:"productSkuIds"` // 货品 SKU ID
}

type GoodsPriceReviewQueryParams struct {
	normal.ParameterWithPager
	IdLt            int64 `json:"idLt,omitempty"`            // id 范围查询最大值
	IdGt            int64 `json:"idGt,omitempty"`            // id 范围查询最小值
	OrderStatusList []int `json:"orderStatusList,omitempty"` // 核价单状态列表. 可选值含义说明:[0:待核价;1:待供应商确认;2:核价通过;3:核价驳回;4:废弃;5:价格同步中;]
}

type GoodsPriceReviewRejectRequest struct {
	OrderId           int64 `json:"orderId"` // 核价单 ID
	BargainReasonList []struct {
		Type   int    `json:"type"`   // 重新报价原因类型. 可选值含义说明:[0:材质;1:功能;2:其他;3:品类;4:外观;5:版型;6:图案;7:规格尺寸;8:品牌;]
		Reason string `json:"reason"` // 具体原因
	} `json:"bargainReasonList,omitempty"` // 重新报价原因列表
	ExternalLinkList []string `json:"externalLinkList"` // 外部链接，最多录入5个链接
	PriceItemList    []struct {
		ProductSkuId int64   `json:"productSkuId"`
		Price        float64 `json:"price"`
	} `json:"priceItemList,omitempty"`
}

type GoodsQuantityQueryParams struct {
	ProductSkcId int64 `json:"productSkcId"` // 货品 SKC ID
}

type GoodsQuantityUpdateRequest struct {
	QuantityChangeMode int               `json:"quantityChangeMode"`     // 更新库存数量方式（1-增减变更 2-覆盖变更，默认为1）
	ProductSkcId       null.Int          `json:"productSkcId,omitempty"` // 货品 SKC ID
	SkuStockChangeList []StockChangeItem `json:"skuStockChangeList"`     // 虚拟库存调整信息
}

type GoodsQueryParams struct {
	normal.ParameterWithPager
	Page                   int       `json:"page"`                             // 页码
	Cat1Id                 int64     `json:"cat1Id,omitempty"`                 // 一级分类 ID
	Cat2Id                 int64     `json:"cat2Id,omitempty"`                 // 二级分类 ID
	Cat3Id                 int64     `json:"cat3Id,omitempty"`                 // 三级分类 ID
	Cat4Id                 int64     `json:"cat4Id,omitempty"`                 // 四级分类 ID
	Cat5Id                 int64     `json:"cat5Id,omitempty"`                 // 五级分类 ID
	Cat6Id                 int64     `json:"cat6Id,omitempty"`                 // 六级分类 ID
	Cat7Id                 int64     `json:"cat7Id,omitempty"`                 // 七级分类 ID
	Cat8Id                 int64     `json:"cat8Id,omitempty"`                 // 八级分类 ID
	Cat9Id                 int64     `json:"cat9Id,omitempty"`                 // 九级分类 ID
	Cat10Id                int64     `json:"cat10Id,omitempty"`                // 十级分类 ID
	SkcExtCode             string    `json:"skcExtCode,omitempty"`             // 货品 SKC 外部编码
	SupportPersonalization int       `json:"supportPersonalization,omitempty"` // 是否支持定制品模板
	BindSiteIds            []int     `json:"bindSiteIds,omitempty"`            // 经营站点
	ProductName            string    `json:"productName,omitempty"`            // 货品名称
	ProductSkcIds          []int64   `json:"productSkcIds,omitempty"`          // SKC 列表
	SkuExtCodes            []string  `json:"skuExtCodes,omitempty"`            // SKU 货号列表
	QuickSellAgtSignStatus null.Int  `json:"quickSellAgtSignStatus,omitempty"` // 快速售卖协议签署状态 0-未签署 1-已签署
	MatchJitMode           null.Bool `json:"matchJitMode,omitempty"`           // 是否命中 JIT 模式
	SkcSiteStatus          null.Int  `json:"skcSiteStatus,omitempty"`          // skc 加站点状态 (0: 未加入站点, 1: 已加入站点)
	CreatedAtStart         string    `json:"createdAtStart,omitempty"`         // 创建时间开始（年-月-日 时:分:秒）
	CreatedAtEnd           string    `json:"createdAtEnd,omitempty"`           // 创建时间结束（年-月-日 时:分:秒）
}

type GoodsSalesQueryParams struct {
	normal.ParameterWithPager
	IsLack                    null.Int  `json:"isLack,omitempty"`                    // 是否缺货 0-不缺货 1-缺货
	ProductSkcIdList          []int64   `json:"productSkcIdList,omitempty"`          // skc列表
	MaxRemanentInventoryNum   int       `json:"maxRemanentInventoryNum,omitempty"`   // sku最大剩余库存
	OnSalesDurationOfflineLte int       `json:"onSalesDurationOfflineLte,omitempty"` // 加入站点时长小于等于
	MinRemanentInventoryNum   int       `json:"minRemanentInventoryNum,omitempty"`   // sku最小剩余库存
	SelectStatusList          []int     `json:"selectStatusList,omitempty"`          // 选品状态 10-待下首单 11-已下首单 12-已加入站点 13-已下架
	TodaySaleVolumMax         int       `json:"todaySaleVolumMax,omitempty"`         // SKC今日销量最大值
	MaxAvailableSaleDays      int       `json:"maxAvailableSaleDays,omitempty"`      // 最大可售天数
	OnSalesDurationOfflineGte int       `json:"onSalesDurationOfflineGte,omitempty"` // 加入站点时长大于等于
	SkuExtCodeList            []string  `json:"skuExtCodeList,omitempty"`            // sku货号列表
	ProductName               string    `json:"productName,omitempty"`               // 货品名称
	ThirtyDaysSaleVolumMax    int       `json:"thirtyDaysSaleVolumMax,omitempty"`    // SKC近30天销量最大值
	ThirtyDaysSaleVolumMin    int       `json:"thirtyDaysSaleVolumMin,omitempty"`    // SKC近30天销量最小值
	CategoryList              []int     `json:"categoryList,omitempty"`              // 类目列表
	IsTrustManagementMall     null.Bool `json:"isTrustManagementMall,omitempty"`     // 是否托管店铺
	SevenDaysSaleVolumMax     int       `json:"sevenDaysSaleVolumMax,omitempty"`     // SKC近7天销量最大值
	SettlementType            null.Int  `json:"settlementType,omitempty"`            // 结算类型 0-非vmi 1-vmi
	StockStatusList           []int     `json:"stockStatusList,omitempty"`           // 售罄状态 (0-库存充足 1-即将售罄 2-已经售罄)
	SkcExtCodeList            []int     `json:"skcExtCodeList,omitempty"`            // skc货号列表
	TodaySaleVolumMin         int       `json:"todaySaleVolumMin,omitempty"`         // SKC今日销量最小值
	SevenDaysSaleVolumMin     int       `json:"sevenDaysSaleVolumMin,omitempty"`     // SKC近7天销量最小值
	OrderByDesc               null.Int  `json:"orderByDesc,omitempty"`               // 排序，0-升序，1-降序
	IsAdviceStock             null.Bool `json:"isAdviceStock,omitempty"`             // 是否建议备货
	PictureAuditStatusList    []int     `json:"pictureAuditStatusList,omitempty"`    // 图片审核状态 1-未完成；2-已完成
	IsCustomGoods             null.Bool `json:"isCustomGoods,omitempty"`             // 是否为定制品
	OrderByParam              string    `json:"orderByParam,omitempty"`              // 排序参数，传入后端返回的字段
	MinAvailableSaleDays      string    `json:"minAvailableSaleDays,omitempty"`      // 最小可售天数
}

type GoodsSizeChartClassQueryParams struct {
	CatId int64 `json:"catId,omitempty"` // 叶子类目id，通过bg.goods.cats.get获取
}

type GoodsSizeChartQueryParams struct {
	normal.ParameterWithPager
	CatId int64 `json:"catId,omitempty"` // 类目 ID
}

type GoodsSpecificationCreateRequest struct {
	ParentSpecId int `json:"parentSpecId"` // 父规格 ID
	// 限制的特殊字符枚举如下
	// - emoji表情符号
	// - }、{、!、<、@、>、？、$、^、…、€、®、™、©、£、†、o、â、¥、¢、‡
	SpecName string `json:"specName"` // 子规格名称
}

type GoodsUpdateRequest struct {
	ProductId           int64 `json:"productId"`  // 货品 ID
	SupplierId          int64 `json:"supplierId"` // 供应商 ID
	ProductWhExtAttrReq struct {
		ProductOrigin struct {
			Region2Id        int64  `json:"region2Id,omitempty"` // 省份，当region1ShortName为CN时，省份必传。枚举值：https://partner.kuajingmaihuo.com/document?cataId=875196199516&docId=894069632221
			Region1ShortName string `json:"region1ShortName"`    // 一级区域简称 (二字简码)
		} `json:"productOrigin"` // 货品产地
	} `json:"productWhExtAttrReq"` // 货品仓配供应链侧扩展属性请求
}

type GoodsWarehouseOpenApiUser struct {
	SupplierId int `json:"supplierId"` // 供应商 ID
}

type GoodsWarehouseQueryParams struct {
	SiteIdList  []int                     `json:"siteIdList"`  // 站点列表
	OpenApiUser GoodsWarehouseOpenApiUser `json:"openApiUser"` // 用户信息
}

type JitPresaleRuleSignRequest struct {
	ProductId      int64  `json:"productId"`      // 货品 ID，货品需要处于 JIT 开启状态，才能签署 JIT 协议
	AgtVersion     int    `json:"agtVersion"`     // JIT 预售协议版本号
	ProductAgtType int    `json:"productAgtType"` // 货品协议类型（1: JIT 模式快速售卖协议）
	Url            string `json:"url"`            // JIT 协议链接
}

type Logger interface {
	Errorf(format string, v ...interface{})
	Warnf(format string, v ...interface{})
	Debugf(format string, v ...interface{})
}

type LogisticsChangeRequest struct {
	ExpressBatchSn                  string                                                         `json:"expressBatchSn"`                            // 发货批次
	SelfDeliveryInfo                *ShipOrderPackingSendSelfDeliveryInformation                   `json:"selfDeliveryInfo,omitempty"`                // 自送信息
	ThirdPartyDeliveryInfo          *ShipOrderPackingSendPlatformRecommendationDeliveryInformation `json:"thirdPartyDeliveryInfo,omitempty"`          // 公司指定物流
	ThirdPartyExpressDeliveryInfoVO *ShipOrderPackingSendThirdPartyDeliveryInformation             `json:"thirdPartyExpressDeliveryInfoVO,omitempty"` // 第三方配送
}

type LogisticsMatchRequest struct {
	DeliveryAddressId         int64                  `json:"deliveryAddressId,omitempty"`  // 发货地址
	PredictTotalPackageWeight int                    `json:"predictTotalPackageWeight"`    // 预估总包裹重量，单位g
	UrgencyType               null.Int               `json:"urgencyType,omitempty"`        // 是否是紧急发货单，0-普通 1-急采
	SubWarehouseId            int64                  `json:"subWarehouseId"`               // 收货子仓 ID
	TotalPackageNum           int                    `json:"totalPackageNum"`              // 包裹件数
	ReceiveAddressInfo        *entity.ReceiveAddress `json:"receiveAddressInfo,omitempty"` // 收货地址
	DeliveryOrderSns          []string               `json:"deliveryOrderSns,omitempty"`   // 发货单列表
}

type LogisticsVerifyRequest struct {
	ShippingId int64  `json:"shippingId"` // 物流公司 ID
	ExpressNo  string `json:"expressNo"`  // 物流单号
}

type NormalGoodsBarcodeQueryParams struct {
	normal.ParameterWithPager
	ProductSkuIdList []int64   `json:"productSkuIdList,omitempty"` // 货品 sku id 列表
	SkcExtCode       string    `json:"skcExtCode,omitempty"`       // skc 货号
	ProductSkcIdList []int64   `json:"productSkcIdList,omitempty"` // 货品 skc id 列表
	SkuExtCode       string    `json:"skuExtCode,omitempty"`       // sku 货号
	LabelCode        int       `json:"labelCode,omitempty"`        // 标签条码
	ReturnDataKey    null.Bool `json:"return_data_key"`            // 是否以打印页面url返回，如果入参是，则不返回参数信息，返回dataKey，通过拼接https://openapi.kuajingmaihuo.com/tool/print?dataKey={返回的dataKey}，访问组装的url即可打印，打印的条码按照入参参数所得结果进行打印
}

type PictureCompressionRequest struct {
	Urls []string `json:"urls"` // 需要压缩的图片链接
}

type ProductImageUrl struct {
	ImgUrlList []string `json:"imgUrlList"` // 图片列表
	Language   string   `json:"language"`   // 语言
}

type PurchaseOrderApplyDetail struct {
	ProductSkuId               int64 `json:"productSkuId"`               // skuId
	ProductSkuPurchaseQuantity int   `json:"productSkuPurchaseQuantity"` // 申请备货数量
}

type PurchaseOrderApplyRequest struct {
	normal.Parameter
	ProductSkcId            int64                      `json:"productSkcId"`                      // skcId
	ExpectLatestDeliverTime string                     `json:"expectLatestDeliverTime,omitempty"` // 最晚发货时间
	ExpectLatestArrivalTime string                     `json:"expectLatestArrivalTime,omitempty"` // 最晚送达时间
	PurchaseDetailList      []PurchaseOrderApplyDetail `json:"purchaseDetailList"`                // 详情
}

type PurchaseOrderEditItem struct {
	ProductSkuId               int64 `json:"productSkuId"`               // 货品 SKU ID
	ProductSkuPurchaseQuantity int   `json:"productSkuPurchaseQuantity"` // 货品 SKU 下单数量
}

type PurchaseOrderEditRequest struct {
	SubPurchaseOrderSn string                  `json:"subPurchaseOrderSn"` // 采购子单号（订单号） 支持修改（待创建）普通备货单的备货数量 备货数量仅支持向下修改
	PurchaseDetailList []PurchaseOrderEditItem `json:"purchaseDetailList"` // 采购详情列表
}

type PurchaseOrderQueryParams struct {
	normal.ParameterWithPager
	SettlementType                  null.Int  `json:"settlementType,omitempty"`                  // 结算类型 0-非vmi(采购) 1-vmi(备货)
	UrgencyType                     null.Int  `json:"urgencyType,omitempty"`                     // 是否紧急 0-否 1-是
	StatusList                      []int     `json:"statusList,omitempty"`                      // 订单状态 0-待接单；1-已接单，待发货；2-已送货；3-已收货；4-已拒收；5-已验收，全部退回；6-已验收；7-已入库；8-作废；9-已超时；10-已取消
	SubPurchaseOrderSnList          []string  `json:"subPurchaseOrderSnList,omitempty"`          // 订单号（采购子单号）
	ProductSnList                   []string  `json:"productSnList,omitempty"`                   // 货号列表
	ProductSkcIdList                []int64   `json:"productSkcIdList,omitempty"`                // skc 列表
	PurchaseTimeFrom                string    `json:"purchaseTimeFrom,omitempty"`                // 下单时间-开始：毫秒
	PurchaseTimeTo                  string    `json:"purchaseTimeTo,omitempty"`                  // 下单时间-结束：毫秒
	DeliverOrderSnList              []string  `json:"deliverOrderSnList,omitempty"`              // 发货单号列表
	IsDelayDeliver                  null.Bool `json:"isDelayDeliver,omitempty"`                  // 是否延迟发货
	IsDelayArrival                  null.Bool `json:"isDelayArrival,omitempty"`                  // 是否延迟到货
	ExpectLatestDeliverTimeFrom     string    `json:"expectLatestDeliverTimeFrom,omitempty"`     // 要求最晚发货时间-开始（时间戳 单位：毫秒）
	ExpectLatestDeliverTimeTo       string    `json:"expectLatestDeliverTimeTo,omitempty"`       // 要求最晚发货时间-结束（时间戳 单位：毫秒）
	ExpectLatestArrivalTimeFrom     string    `json:"expectLatestArrivalTimeFrom,omitempty"`     // 要求最晚到达时间-开始（时间戳 单位：毫秒）
	ExpectLatestArrivalTimeTo       string    `json:"expectLatestArrivalTimeTo,omitempty"`       // 要求最晚到达时间-结束（时间戳 单位：毫秒）
	PurchaseStockType               null.Int  `json:"purchaseStockType,omitempty"`               // 是否是JIT备货， 0-普通，1-JIT备货
	IsFirst                         null.Bool `json:"isFirst,omitempty"`                         // 是否首单 0-否 1-是
	IsCustomGoods                   null.Bool `json:"isCustomGoods,omitempty"`                   // 是否为定制品
	OriginalPurchaseOrderSnList     []string  `json:"originalPurchaseOrderSnList,omitempty"`     // 母订单号列表
	DeliverOrArrivalDelayStatusList []int     `json:"deliverOrArrivalDelayStatusList,omitempty"` // 发货或者到货逾期状态 101-发货即将逾期，102-发货已逾期，201-到货即将逾期，202-到货已逾期
	TodayCanDeliver                 null.Bool `json:"todayCanDeliver,omitempty"`                 // 是否今日可发货
	SkuLackSnapshot                 null.Int  `json:"skuLackSnapshot,omitempty"`                 // 创单时是否存在缺货sku，0-不存在 1-存在
	QcReject                        null.Int  `json:"qcReject,omitempty"`                        // 创单时是否存在质检不合格sku，0-不存在 1-存在
	QcOption                        null.Int  `json:"qcOption,omitempty"`                        // 是否存在质检不合格的sku，10-是，20-否
	SourceList                      []int     `json:"sourceList,omitempty"`                      // 下单来源，0-运营下单，1-卖家下单，9999-平台下单
	IsSystemAutoPurchaseSource      null.Bool `json:"isSystemAutoPurchaseSource,omitempty"`      // 是否系统下单 是-系统自动下单 否-其他
	LackOrSoldOutTagList            []int     `json:"lackOrSoldOutTagList,omitempty"`            // 标签：1-含缺货SKU；2-含售罄SKU
	IsTodayPlatformPurchase         null.Bool `json:"isTodayPlatformPurchase,omitempty"`         // 是否今日平台下单
	JoinDeliveryPlatform            null.Bool `json:"joinDeliveryPlatform,omitempty"`            // 是否加入了发货台
	OrderType                       null.Int  `json:"orderType,omitempty"`                       // 订单类型（1：普通备货单、2：紧急备货单、3：定制备货单）此参数为扩展参数，用于简化备货类型查询处理
}

type SemiOnlineOrderLogisticsServiceProviderQueryParams struct {
	WarehouseId         string     `json:"warehouseId"`                   // 仓库 id
	OrderSnList         []string   `json:"orderSnList"`                   // O 单（orderSn 非 parentOrderSn）列表（至少包含一个 O 单号）
	Weight              float64    `json:"weight"`                        // 重量（默认 2 位小数，美国lb，其他国家kg）
	WeightUnit          string     `json:"weightUnit"`                    // 重量单位
	Length              null.Float `json:"length,omitempty"`              // 包裹长度（默认 2 位小数）
	Width               float64    `json:"width"`                         // 包裹宽度（默认 2 位小数）
	Height              float64    `json:"height"`                        // 包裹高度（默认 2 位小数）
	DimensionUnit       string     `json:"dimensionUnit"`                 // 尺寸单位（美国 in，其他国家 cm）
	SignatureOnDelivery null.Bool  `json:"signatureOnDelivery,omitempty"` // 是否需要签名签收服务
}

type SemiOnlineOrderLogisticsShipmentAdditionalPackage struct {
	ExtendWeightUnit string   `json:"extendWeightUnit,omitempty"` // 扩展重量单位
	ExtendWeight     string   `json:"extendWeight,omitempty"`     // 扩展重量
	WeightUnit       string   `json:"weightUnit"`                 // 重量单位
	DimensionUnit    string   `json:"dimensionUnit"`              // 尺寸单位
	Weight           string   `json:"weight"`                     // 包裹重量（默认 2 位小数）
	Length           string   `json:"length"`                     // 包裹长度（默认 2 位小数）
	Height           string   `json:"height"`                     // 包裹高度（默认 2 位小数）
	Width            string   `json:"width"`                      // 包裹宽度（默认 2 位小数）
	WarehouseId      string   `json:"warehouseId"`                // 仓库 ID
	ShipCompanyId    string   `json:"shipCompanyId"`              // 物流公司 ID
	ChannelId        int64    `json:"channelId"`                  // 物流渠道 ID
	SignServiceId    null.Int `json:"signServiceId,omitempty"`    // 想使用的签收服务 ID
}

type SemiOnlineOrderLogisticsShipmentCreateRequest struct {
	SendType           int                                              `json:"sendType"`                     // 发货类型：0-单个运单发货 1-拆成多个运单发货 2-合并发货
	ShipLater          bool                                             `json:"shipLater"`                    // 下 call 成功后是否延迟发货（TRUE：下call成功之后延迟发货，FALSE/不填：下call成功订单自动流转为已发货）
	ShipLaterLimitTime null.Int                                         `json:"shipLaterLimitTime,omitempty"` // 稍后发货兜底配置时间（单位:h），枚举：24, 48, 72, 96
	SendRequestList    []SemiOnlineOrderLogisticsShipmentCreateSendItem `json:"sendRequestList"`              // 包裹信息
}

type SemiOnlineOrderLogisticsShipmentCreateSendItem struct {
	ShipCompanyId      int64                                               `json:"shipCompanyId"`                // 物流公司 id
	TrackingNumber     null.String                                         `json:"trackingNumber,omitempty"`     // 运单号
	OrderSendInfoList  []SemiOnlineOrderLogisticsShipmentPackageItem       `json:"orderSendInfoList"`            // 发货商品信息
	WarehouseId        string                                              `json:"warehouseId"`                  // 仓库id
	Weight             string                                              `json:"weight"`                       // 重量（默认 2 位小数）
	WeightUnit         string                                              `json:"weightUnit"`                   // 重量单位，美国为 lb（磅），其他国家为 kg（千克）
	Length             string                                              `json:"length"`                       // 包裹长度（默认 2 位小数）
	Width              string                                              `json:"width"`                        // 包裹宽度（默认 2 位小数）
	Height             string                                              `json:"height"`                       // 包裹高度（默认 2 位小数）
	DimensionUnit      string                                              `json:"dimensionUnit"`                // 尺寸单位高度，美国为in（英寸）其他国家为cm（厘米）
	ChannelId          int64                                               `json:"channelId"`                    // 渠道id，取自 shipservice.get
	PickupStartTime    null.Int                                            `json:"pickupStartTime,omitempty"`    // 预约上门取件开始时间（当渠道为需要下 call 同时入参预约时间渠道时，需入参。剩余渠道无需入参。）
	PickupEndTime      null.Int                                            `json:"pickupEndTime,omitempty"`      // 预约上门取件结束时间（当渠道为需要下 call 同时入参预约时间渠道时，需入参。剩余渠道无需入参。）
	SignServiceId      null.Int                                            `json:"signServiceId,omitempty"`      // 想使用的签收服务 ID
	SplitSubPackage    bool                                                `json:"splitSubPackage"`              // 是否为单件 SKU 拆多包裹（TRUE：是单件SKU多包裹场景 FALSE/不填：不是单件SKU多包裹场景）
	SendSubRequestList []SemiOnlineOrderLogisticsShipmentAdditionalPackage `json:"sendSubRequestList,omitempty"` // 单件 sku 多包裹场景，附属包裹入参
}

type SemiOnlineOrderLogisticsShipmentDocumentRequest struct {
	// - SHIPPING_LABEL_PDF:入参此参数，返回的 URL 加签后只返回 PDF 格式的面单文件
	// - 不入参，按照旧有逻辑返回面单文件，即按物流商的面单文件返回确定图片格式或 PDF 格式；
	// - 入不合法的参数值：接口报错，报错文案：Document type is invalid.
	DocumentType  string   `json:"documentType"`  // 文件类型
	PackageSnList []string `json:"packageSnList"` // 需要打印面单的包裹号列表
	// 自行添加，非接口字段，用于下载面单文件
	Download      bool `json:"download"`      // 是否下载面单文件
	RetryDownload bool `json:"retryDownload"` // 面单文件已经存在的情况下是否重新下载，为 false 的情况下直接返回，不会去再次请求
}

type SemiOnlineOrderLogisticsShipmentPackageItem struct {
	ParentOrderSn string `json:"parentOrderSn"` // 父订单号
	OrderSn       string `json:"orderSn"`       // 订单号
	GoodsId       int64  `json:"goodsId"`       // 商品 goodsId
	SkuId         int64  `json:"skuId"`         // 商品 skuId
	Quantity      int    `json:"quantity"`      // 发货数量
}

type SemiOnlineOrderLogisticsShipmentUpdatePackage struct {
	PackageSn         string                                        `json:"packageSn"`         // 包裹号
	PickupStartTime   int64                                         `json:"pickupStartTime"`   // 预约上门取件的开始时间 秒级时间戳
	PickupEndTime     int64                                         `json:"pickupEndTime"`     // 预约上门取件的结束时间 秒级时间戳
	SignServiceId     int64                                         `json:"signServiceId"`     // 签收服务 ID
	ChannelId         int64                                         `json:"channelId"`         // 渠道 ID
	ShipCompanyId     int64                                         `json:"shipCompanyId"`     // 物流公司 ID
	OrderSendInfoList []SemiOnlineOrderLogisticsShipmentPackageItem `json:"orderSendInfoList"` // 发货商品信息
	// TRUE：是单件SKU多包裹场景
	// FALSE/不填：不是单件SKU多包裹场景
	SplitSubPackage    bool                                                `json:"splitSubPackage"`    // 是否为单件SKU拆多包裹
	SendSubRequestList []SemiOnlineOrderLogisticsShipmentAdditionalPackage `json:"sendSubRequestList"` // 单件sku多包裹场景，附属包裹入参
	// 具体确认场景，目前存在枚举为：
	// SUCCESSFUL_RETRY//确认是下call成功之后再次call
	// NO_DELIVERY_ON_SATURDAY//确认允许周六不上门派送】强制发货
	// DENY_CANCELLATION//确认驳回取消待确认请求，强制发货
	// DENY_ADDRESS_CHANGE://确认驳回改地址待确认请求，强制发货
	// DENY_PARENT_RISK_WARNING//确认驳回风控，强制发货
	ConfirmAcceptance []string `json:"confirmAcceptance"` // 确认场景
	WarehouseId       int64    `json:"warehouseId"`       // 仓库 id
	Weight            string   `json:"weight"`            // 包裹重量（默认 2 位小数）
	WeightUnit        string   `json:"weightUnit"`        // 重量单位
	Height            string   `json:"height"`            // 包包裹高度（默认 2 位小数）
	Length            string   `json:"length"`            // 包裹长度（默认 2 位小数）
	Width             string   `json:"width"`             // 包裹宽度（默认 2 位小数）
	DimensionUnit     string   `json:"dimensionUnit"`     // 尺寸单位高度
}

type SemiOnlineOrderLogisticsShipmentUpdateRequest struct {
	RetrySendPackageRequestList []SemiOnlineOrderLogisticsShipmentUpdatePackage `json:"retrySendPackageRequestList"` // 包裹信息
}

type SemiOnlineOrderLogisticsShipmentUpdateShippingTypeRequest struct {
	EditPackageRequestList []EditPackageRequestItem `json:"editPackageRequestList"` // 编辑请求列表
}

type SemiOnlineOrderPlatformLogisticsShippedPackageRequest struct {
	PackageSendInfoList []struct {
		PackageSn      string `json:"packageSn"`      // 包裹号
		TrackingNumber string `json:"trackingNumber"` // 运单号
		PackageDetail  []struct {
			ParentOrderSn string `json:"parentOrderSn"` // 父单号
			OrderSn       string `json:"orderSn"`       // 子单号
			Quantity      int    `json:"quantity"`      // 发货件数
		} `json:"packageDetail"` // 发货包裹详情
	} `json:"packageSendInfoList"` // 确认发货包裹列表
}

type SemiOnlineOrderPlatformLogisticsUnshippedPackageQueryParams struct {
	normal.ParameterWithPager
	PageNumber        int      `json:"pageNumber"`        // 第几页
	ParentOrderSnList []string `json:"parentOrderSnList"` // PO 单号列表
	OrderSnList       []string `json:"orderSnList"`       // O 单号列表
}

type SemiOrderLogisticsScanFormCreateRequest struct {
	PackageSnList []string `json:"packageSnList"` // 包裹号列表
	ShipCompanyId int64    `json:"shipCompanyId"` // 发货物流公司 ID
	WarehouseId   string   `json:"warehouseId"`   // 仓库 ID
}

type SemiOrderLogisticsShipmentConfirmInformation struct {
	CarrierId         int64                                               `json:"carrierId"`         // 物流公司 ID
	TrackingNumber    string                                              `json:"trackingNumber"`    // 运单号
	OrderSendInfoList []SemiOrderLogisticsShipmentConfirmInformationOrder `json:"orderSendInfoList"` // 发货商品信息
}

type SemiOrderLogisticsShipmentConfirmInformationOrder struct {
	ParentOrderSn string `json:"parentOrderSn"` // parentOrderSn
	OrderSn       string `json:"orderSn"`       // orderSn
	GoodsId       int64  `json:"goodsId"`       // goodsId
	SkuId         int64  `json:"skuId"`         // skuId
	Quantity      int    `json:"quantity"`      // 发货数量
}

type SemiOrderLogisticsShipmentConfirmRequest struct {
	SendType        int                                            `json:"sendType"`        // 发货类型：0-单个运单发货 1-拆成多个运单发货 2-合并发货
	SendRequestList []SemiOrderLogisticsShipmentConfirmInformation `json:"sendRequestList"` // 包裹信息
}

type SemiOrderLogisticsShipmentQueryParams struct {
	ParentOrderSn string `json:"parentOrderSn"` // 父订单号
	OrderSn       string `json:"orderSn"`       // 子订单号
}

type SemiOrderQueryParams struct {
	normal.ParameterWithPager
	PageNumber int `json:"pageNumber"` // 第几页
	// 父单状态，默认查全部枚举值如下
	// 0-全部
	// 1-”PENDING“，挂起中
	// 2-"UN_SHIPPING"，待发货
	// 3-"CANCELED",已取消
	// 4-"SHIPPED"，已发货
	// 5-“RECEIPTED”,已签收
	// 备注：
	// 本本订单还存在如下状态
	// 41-部分取消
	// 51-部分签收
	ParentOrderStatus         null.Int `json:"parentOrderStatus,omitempty"`         // 父单状态
	CreateBefore              string   `json:"createBefore,omitempty"`              // 父单创建时间结束查询时间，格式是秒时间戳。查询时间需要同时入参开始和结束时间才生效
	CreateAfter               string   `json:"createAfter,omitempty"`               // 父单创建时间开始查询时间，格式是秒时间戳
	ParentOrderSnList         []string `json:"parentOrderSnList,omitempty"`         // 父单号列表，单次请求最多 20 个
	ExpectShipLatestTimeStart string   `json:"expectShipLatestTimeStart,omitempty"` // 期望最晚发货时间开始查询时间，格式是秒时间戳
	ExpectShipLatestTimeEnd   string   `json:"expectShipLatestTimeEnd,omitempty"`   // 期望最晚发货时间结束查询时间，格式是秒时间戳。查询时间需要同时入参开始和结束时间才生效
	UpdateAtStart             string   `json:"updateAtStart,omitempty"`             // 订单更新时间开始查询时间，格式是秒时间戳
	UpdateAtEnd               string   `json:"updateAtEnd,omitempty"`               // 订单更新时间结束查询时间，格式是秒时间戳。查询时间需要同时入参开始和结束时间才生效
	RegionId                  int      `json:"regionId"`                            // 区域 ID，美国-211
	// 子订单履约类型，具体枚举值如下：
	// 1. 数组只传入 fulfillBySeller，只返回卖家履约子订单列表
	// 2. 数组只传入 fulfillByCooperativeWarehouse，只返回合作仓履约子订单列表
	// 3. 数组传入 fulfillBySeller 和 fulfillByCooperativeWarehouse，返回卖家履约子订单列表+合作仓履约子订单列表
	// 4. fulfillmentTypeList不传或者传了为空，默认返回卖家履约子订单列表
	FulfillmentTypeList []string    `json:"fulfillmentTypeList,omitempty"` // 子订单履约类型
	ParentOrderLabel    []string    `json:"parentOrderLabel,omitempty"`    // PO 单订单状态标签
	SortBy              null.String `json:"sortby,omitempty"`              // 排序依据，倒序输出。默认按照订单创建时间，对应枚举为：updateTime、createTime
}

type SemiVirtualInventoryChangeItem struct {
	ProductSkuId          int64       `json:"productSkuId"`                    // 货品 SKU ID
	StockDiff             null.Int    `json:"stockDiff,omitempty"`             // 虚拟库存变更(通过1-增减变更时：虚拟库存(含商家自管库存)变更，大于0代表在现有库存基础上增加，小于0代表在现有库存基础上减少)
	TargetStockAvailable  null.Int    `json:"targetStockAvailable,omitempty"`  // 覆盖变更目标库存值(通过2-覆盖变更时：覆盖变更目标库存值（填多少，则变更后库存则为多少，不能为负数))
	WarehouseId           null.String `json:"warehouseId"`                     // 发货仓ID(发货仓ID-当变更方式为2时，是必填字段。) 货品SKUId维度数据，欧洲地区支持分仓库存
	CurrentShippingMode   null.Int    `json:"currentShippingMode,omitempty"`   // 当前发货模式
	CurrentStockAvailable null.Int    `json:"currentStockAvailable,omitempty"` // 当前库存件数
}

type SemiVirtualInventoryQueryParams struct {
	ProductSkcId int64 `json:"productSkcId"` // 货品 SKC ID
}

type SemiVirtualInventoryUpdateRequest struct {
	QuantityChangeMode int                              `json:"quantityChangeMode"`     // 更新库存数量方式（1-增减变更 2-覆盖变更，默认为1）
	ProductSkcId       null.Int                         `json:"productSkcId,omitempty"` // 货品 SKC ID
	SkuStockChangeList []SemiVirtualInventoryChangeItem `json:"skuStockChangeList"`     // 虚拟库存调整信息
}

type ShipOrderCancelRequest struct {
	normal.Parameter
	DeliveryOrderSn string `json:"deliveryOrderSn"` // 发货单 ID
}

type ShipOrderCreateRequest struct {
	normal.Parameter
	DeliveryOrderCreateGroupList []ShipOrderCreateRequestDeliveryOrder `json:"deliveryOrderCreateGroupList"` // 发货单创建组列表
}

type ShipOrderCreateRequestDeliveryOrder struct {
	DeliveryOrderCreateInfos []ShipOrderCreateRequestOrderInfo `json:"deliveryOrderCreateInfos"`     // 发货单创建组列表
	ReceiveAddressInfo       *entity.ReceiveAddress            `json:"receiveAddressInfo,omitempty"` // 收货地址
	SubWarehouseId           null.Int                          `json:"subWarehouseId,omitempty"`     // 子仓 ID
}

type ShipOrderCreateRequestOrderDetailInfo struct {
	ProductSkuId  int64 `json:"productSkuId"`  // 定制品，传定制品id；非定制品，传货品 skuId
	DeliverSkuNum int   `json:"deliverSkuNum"` // 发货sku数目
}

type ShipOrderCreateRequestOrderInfo struct {
	SubPurchaseOrderSn      string                                  `json:"subPurchaseOrderSn"`      // 采购子单号
	DeliverOrderDetailInfos []ShipOrderCreateRequestOrderDetailInfo `json:"deliverOrderDetailInfos"` // 采购单创建信息列表
	PackageInfos            []ShipOrderCreateRequestOrderPackage    `json:"packageInfos"`            //	包裹信息列表
	DeliveryAddressId       int64                                   `json:"deliveryAddressId"`       // 发货地址 ID
}

type ShipOrderCreateRequestOrderPackage struct {
	PackageDetailSaveInfos []ShipOrderCreateRequestPackageInfo `json:"packageDetailSaveInfos"` // 包裹明细
}

type ShipOrderCreateRequestPackageInfo struct {
	ProductSkuId int64 `json:"productSkuId"` // skuId
	SkuNum       int   `json:"skuNum"`       // 发货 sku 数目
}

type ShipOrderPackageQueryParams struct {
	normal.Parameter
	DeliveryOrderSn string `json:"deliveryOrderSn"` // 发货单号
}

type ShipOrderPackageUpdateRequest struct {
	normal.Parameter
	DeliveryOrderSn         string                                            `json:"deliveryOrderSn"`         // 发货单号
	DeliverOrderDetailInfos []ShipOrderPackageUpdateRequestDeliverOrderDetail `json:"deliverOrderDetailInfos"` // 发货单详情列表
	PackageInfos            []ShipOrderPackageUpdateRequestPackage            `json:"packageInfos"`            // 包裹信息列表
}

type ShipOrderPackageUpdateRequestDeliverOrderDetail struct {
	ProductSkuId  int64 `json:"productSkuId"`  // skuId
	DeliverSkuNum int   `json:"deliverSkuNum"` // 发货 sku 数目
}

type ShipOrderPackageUpdateRequestPackage struct {
	PackageDetailSaveInfos []ShipOrderPackageUpdateRequestPackageDetail `json:"packageDetailSaveInfos"` // 包裹明细
}

type ShipOrderPackageUpdateRequestPackageDetail struct {
	ProductSkuId int64 `json:"productSkuId"` // skuId
	SkuNum       int   `json:"skuNum"`       // 发货 sku 数目
}

type ShipOrderPackingMatchRequest struct {
	normal.Parameter
	DeliveryOrderSnList []string `json:"deliveryOrderSnList"` // 发货单号
}

type ShipOrderPackingSendCreateResult struct {
	DeliveryOrderCreateInfos []struct {
		SubPurchaseOrderSn string `json:"subPurchaseOrderSn"` // 采购子单号
		PackageInfos       []struct {
			PackageDetailSaveInfos []struct {
				ProductSkuId int64 `json:"productSkuId"` // skuId
				SkuNum       int   `json:"skuNum"`       // 发货 sku 数目
			} `json:"packageDetailSaveInfos"` // 包裹明细
		} `json:"packageInfos"` // 包裹信息列表
	} `json:"deliveryOrderCreateInfos"` // 采购单创建信息列表
	DeliverOrderDetailInfos []struct {
		ProductSkuId  int64 `json:"productSkuId"`  // skuId
		DeliverSkuNum int   `json:"deliverSkuNum"` // 发货 sku 数目
	} `json:"deliverOrderDetailInfos"` // 发货单详情列表
	// DeliveryAddressId  int64                  `json:"deliveryAddressId"`  // 发货地址 ID
	ReceiveAddressInfo              *entity.ReceiveAddress                                         `json:"receiveAddressInfo"`              // 收货地址
	SubWarehouseId                  int64                                                          `json:"subWarehouseId"`                  // 子仓 ID
	DeliverMethod                   int                                                            `json:"deliverMethod"`                   // 发货方式
	DeliveryAddressId               int64                                                          `json:"deliveryAddressId"`               // 发货地址 ID
	SelfDeliveryInfo                *ShipOrderPackingSendSelfDeliveryInformation                   `json:"selfDeliveryInfo"`                // 自送信息
	ThirdPartyDeliveryInfo          *ShipOrderPackingSendPlatformRecommendationDeliveryInformation `json:"thirdPartyDeliveryInfo"`          // 公司指定物流
	ThirdPartyExpressDeliveryInfoVO *ShipOrderPackingSendThirdPartyDeliveryInformation             `json:"thirdPartyExpressDeliveryInfoVO"` // 第三方配送
}

type ShipOrderPackingSendPlatformRecommendationDeliveryInformation struct {
	ExpressCompanyId          int64   `json:"expressCompanyId,omitempty"`          // 快递公司 Id
	TmsChannelId              int64   `json:"tmsChannelId,omitempty"`              // TMS 快递产品类型 Id
	ExpressCompanyName        string  `json:"expressCompanyName,omitempty"`        // 快递公司名称
	StandbyExpress            bool    `json:"standbyExpress"`                      // 是否是备用快递公司
	ExpressDeliverySn         string  `json:"expressDeliverySn,omitempty"`         // 快递单号
	PredictTotalPackageWeight int64   `json:"predictTotalPackageWeight,omitempty"` // 预估总包裹重量不能为空,单位克.总量必须大于等于1千克且为整千克值
	ExpectPickUpGoodsTime     int64   `json:"expectPickUpGoodsTime,omitempty"`     // 预约取货时间
	ExpressPackageNum         int     `json:"expressPackageNum,omitempty"`         // 交接给快递公司的包裹数
	MinChargeAmount           float64 `json:"minChargeAmount,omitempty"`           // 最小预估运费（单位元）
	MaxChargeAmount           float64 `json:"maxChargeAmount,omitempty"`           // 最大预估运费（单位元）
	PredictId                 int64   `json:"predictId,omitempty"`                 // 预测 ID
}

type ShipOrderPackingSendRequest struct {
	normal.Parameter
	DeliverMethod                   null.Int                                                       `json:"deliverMethod"`                             // 发货方式
	DeliveryAddressId               int64                                                          `json:"deliveryAddressId"`                         // 发货地址 ID
	DeliveryOrderSnList             []string                                                       `json:"deliveryOrderSnList"`                       // 发货单号
	SelfDeliveryInfo                *ShipOrderPackingSendSelfDeliveryInformation                   `json:"selfDeliveryInfo,omitempty"`                // 自送信息
	ThirdPartyDeliveryInfo          *ShipOrderPackingSendPlatformRecommendationDeliveryInformation `json:"thirdPartyDeliveryInfo,omitempty"`          // 平台指定物流
	ThirdPartyExpressDeliveryInfoVO *ShipOrderPackingSendThirdPartyDeliveryInformation             `json:"thirdPartyExpressDeliveryInfoVO,omitempty"` // 第三方配送
}

type ShipOrderPackingSendResult struct {
	CreateExpressErrorRequestList []ShipOrderPackingSendCreateResult `json:"createExpressErrorRequestList"` // 创建快递运单失败的请求列表
	ExpressBatchSn                string                             `json:"expressBatchSn"`                // 创建生成的发货批次号
}

type ShipOrderPackingSendSelfDeliveryInformation struct {
	DriverUid             int    `json:"driverUid,omitempty"`             // 司机 uid
	DriverName            string `json:"driverName,omitempty"`            // 司机姓名
	PlateNumber           string `json:"plateNumber,omitempty"`           // 车牌号
	DeliveryContactNumber string `json:"deliveryContactNumber,omitempty"` // 电话号码
	DeliveryContactAreaNo string `json:"deliveryContactAreaNo,omitempty"` // 电话区号
	ExpressPackageNum     int    `json:"expressPackageNum,omitempty"`     // 发货总箱数
}

type ShipOrderPackingSendThirdPartyDeliveryInformation struct {
	ExpressCompanyId   int64  `json:"expressCompanyId"`            // 快递公司 Id
	ExpressCompanyName string `json:"expressCompanyName"`          // 快递公司名称
	ExpressDeliverySn  string `json:"expressDeliverySn"`           // 快递单号
	ExpressPackageNum  int    `json:"expressPackageNum,omitempty"` // 发货总箱数
}

type ShipOrderQueryParams struct {
	normal.ParameterWithPager
	DeliveryOrderSnList      []string  `json:"deliveryOrderSnList,omitempty"`      // 发货单号列表
	SubPurchaseOrderSnList   []string  `json:"subPurchaseOrderSnList,omitempty"`   // 子采购单号列表
	ExpressDeliverySnList    []string  `json:"expressDeliverySnList,omitempty"`    // 快递单号列表
	SkcExtCodeList           []string  `json:"skcExtCodeList,omitempty"`           // 货号列表
	ProductSkcIdList         []int64   `json:"productSkcIdList,omitempty"`         // skcId 列表
	SubWarehouseIdList       []int64   `json:"subWarehouseIdList,omitempty"`       // 收货子仓列表
	DeliverTimeFrom          string    `json:"deliverTimeFrom,omitempty"`          // 发货时间-开始时间
	DeliverTimeTo            string    `json:"deliverTimeTo,omitempty"`            // 发货时间-结束时间
	Status                   null.Int  `json:"status,omitempty"`                   // 发货单状态，0：待装箱发货，1：待仓库收货，2：已收货，3：已入库，4：已退货，5：已取消，6：部分收货，查询发货批次时仅支持查询发货单状态=1
	UrgencyType              null.Int  `json:"urgencyType,omitempty"`              // 是否是紧急发货单，0-普通，1-急采
	IsCustomProduct          null.Bool `json:"isCustomProduct,omitempty"`          // 是否为定制品
	IsVim                    null.Int  `json:"isVmi,omitempty"`                    // 是否是vmi，0-非VMI，1-VMI
	IsJit                    null.Bool `json:"isJit,omitempty"`                    // 是否是jit，true:jit
	LatestFeedbackStatusList []int     `json:"latestFeedbackStatusList,omitempty"` // 最新反馈状态列表，0-当前无异常，1-已提交，2-物流商处理中，3-已撤销，4-已反馈
	SortType                 null.Int  `json:"sortType,omitempty"`                 // 排序类型，0-创建时间最新在上，1-要求发货时间较早在上，2-按照仓库名称排序
	InventoryRegion          []int     `json:"inventoryRegion,omitempty"`          // 发货区域，1-国内备货，2-海外备货，3-保税仓备货
	IsPrintBoxMark           null.Int  `json:"isPrintBoxMark,omitempty"`           // 是否已打印商品打包标签，0-未打印，1-已打印
	TargetReceiveAddress     string    `json:"targetReceiveAddress,omitempty"`     // 筛选项-收货地址（精准匹配）
	TargetDeliveryAddress    string    `json:"targetDeliveryAddress,omitempty"`    // 筛选项-发货地址（精准匹配）
	OrderType                null.Int  `json:"orderType,omitempty"`                // 订单类型（1：普通备货单、2：紧急备货单、3：定制备货单）此参数为扩展参数，用于简化备货类型查询处理
}

type ShipOrderStagingAddInfo struct {
	SubPurchaseOrderSn  string `json:"subPurchaseOrderSn"`  // 采购子单号（订单号）
	DeliveryAddressType int    `json:"deliveryAddressType"` // 发货地址类型，1-内地，2-香港，内地主体（店铺货币选择CNY，默认入参1，其余主体选择2）
}

type ShipOrderStagingAddRequest struct {
	normal.Parameter
	JoinInfoList []ShipOrderStagingAddInfo `json:"joinInfoList"` // 加入发货台的信息列表
}

type ShipOrderStagingQueryParams struct {
	normal.ParameterWithPager
	SubPurchaseOrderSnList []string  `json:"subPurchaseOrderSnList,omitempty"` // 子采购单号列表
	SkcExtCode             []string  `json:"skcExtCode,omitempty"`             // 货号列表
	ProductSkcIdList       []int64   `json:"productSkcIdList,omitempty"`       // skcId列表
	SettlementType         null.Int  `json:"settlementType,omitempty"`         // 结算类型 0-非vmi 1-vmi
	IsFirstOrder           null.Bool `json:"isFirstOrder,omitempty"`           // 是否首单
	UrgencyType            null.Int  `json:"urgencyType,omitempty"`            // 是否是紧急发货单，0-普通 1-急采
	IsJit                  null.Bool `json:"isJit,omitempty"`                  // 是否是jit，true:jit
	PurchaseStockType      null.Int  `json:"purchaseStockType,omitempty"`      // 备货类型 0-普通备货 1-jit备货
	IsCustomProduct        null.Bool `json:"isCustomProduct,omitempty"`        // 是否为定制品
	SubWarehouseId         int64     `json:"subWarehouseId,omitempty"`         // 收货子仓
	InventoryRegion        []int     `json:"inventoryRegion,omitempty"`        // DOMESTIC(1, "国内备货"), OVERSEAS(2, "海外备货"), BOUNDED_WAREHOUSE(3, "保税仓备货"),
	OrderType              null.Int  `json:"orderType,omitempty"`              // 订单类型（1：普通备货单、2：紧急备货单、3：定制备货单）此参数为扩展参数，用于简化备货类型查询处理
}

type SkuVirtualStockChangeRequest struct {
	ProductSkuId     int64 `json:"productSkuId"`     // 货品 SKU ID
	VirtualStockDiff int   `json:"virtualStockDiff"` // 虚拟库存(含商家自管库存)变更，大于 0 代表增加，小于 0 代表减少
}

type StockChangeItem struct {
	ProductSkuId          int64       `json:"productSkuId"`                    // 货品 SKU ID
	StockDiff             null.Int    `json:"stockDiff,omitempty"`             // 虚拟库存变更(通过1-增减变更时：虚拟库存(含商家自管库存)变更，大于0代表在现有库存基础上增加，小于0代表在现有库存基础上减少)
	TargetStockAvailable  null.Int    `json:"targetStockAvailable,omitempty"`  // 覆盖变更目标库存值(通过2-覆盖变更时：覆盖变更目标库存值（填多少，则变更后库存则为多少，不能为负数))
	WarehouseId           null.String `json:"warehouseId"`                     // 发货仓ID(发货仓ID-当变更方式为2时，是必填字段。) 货品SKUId维度数据，欧洲地区支持分仓库存
	CurrentShippingMode   null.Int    `json:"currentShippingMode,omitempty"`   // 当前发货模式
	CurrentStockAvailable null.Int    `json:"currentStockAvailable,omitempty"` // 当前库存件数
}

type VirtualInventoryJitEditRequest struct {
	ProductSkcId              int64                          `json:"productSkcId"`              // 货品 SKC ID
	SkuVirtualStockChangeList []SkuVirtualStockChangeRequest `json:"skuVirtualStockChangeList"` // 虚拟库存模式下使用，虚拟库存调整信息.
}