查询产品Sku信息
# 查询产品Sku信息
### 请求地址
| HTTP Method | Path |
| :- | :-|
| GET | /api/v1/goodssku |
### 请求参数
| 参数名称 | 类型 | 必填 | 描述 |
| :- | :-| :- | :- |
| goodsId | int | 是 | 产品id |
| skuId | int | 是 | 产品sku id |
| useDate | string | 否 | 入住日期/使用日期 |
| returnDate | string | 否 | 离店日期/回程日期 |
| num | int | 否 | 预订份数 |
### 请求Body
无
### 响应Body，Data部分
| 参数名称 | 类型 | 描述 |
| :- | :-| :- |
| goodsId | int | 产品id |
| skuId | int | 产品skuid |
| goodsInfo | GoodsInfo | 产品信息 |
| skuInfo | SkuInfo | 产品规格sku信息 |
*GoodsInfo*
| 参数名称 | 类型 | 描述 |
| :- | :-| :- |
| goodsId | int | 产品id |
| baseInfoId | int | 资源id(除酒店资源) |
| hid | int | 酒店id |
| categoryId | byte | 产品种类id |
| goodsName | string | 产品名称 |
| imgList | string | 图片列表，多个英文逗号分隔 |
| strengths | string | 产品亮点 |
| orderInfo | string | 预订须知 |
| instructions | string | 使用说明 |
| attentions | string | 注意事项 |
| pcDesc | string | 图文详情 |
| isOrderInfo | byte | 是否需要预订，0-预订 1-预售 |
| isDeliver | byte | 是否发货 0-否 1-是 （电商产品使用）|
| deliverDays | int | 多少填内发货(电商使用) |
| deliverType | byte | 配送方式 0 快递发货 1 上门自提 (电商使用)|
| expressFeeType | string | 快递运费类别 0 统一运费 1 运费模板 |
| playDays | int | 游玩天数 |
| playPersons | int | 游玩人数 |
| travelSettingType | byte | 1.按人数设置 2.按份数设置 |
| travelPersonType | byte | 1 全部出行人(按人数设置)2 一个出行人(按人数设置)3 不需要出行人(按人数设置)4 用户选择份数(按份数设置)5 一份(按份数设置)|
| isNeedIDCard | byte | 是否需要身份证 0-否 1-是 |
| goodsStatus | byte | 产品状态 1-上架 2-下架 |
| refundType | int | 0-不退， 1-条件退款， 2-随时退 |
| isAutoRefund | bool | 过期未使用是否自动退款 |
*SkuInfo*
| 参数名称 | 类型 | 描述 |
| :- | :-| :- |
| skuId | int | 产品规格skuid |
| isVirtual | byte | 是否虚拟产品 0 否 1 是 |
| skuName | string | 规格名称 |
| skuDesc | string | 规格描述 |
| skuImgs | string | 规格图片 |
| saleDateType | byte | 售卖时间 0-不限制 1-指定时间段 |
| saleStartDate | datetime | 开始售卖时间 |
| saleEndDate | datetime | 结束售卖时间 |
| useDateType | byte | 使用有效期类型 0-不限 1-有效期 2-有效天数 |
| validStartDate | datetime | 开始有效期 |
| validEndDate | datetime | 结束有效期 |
| validDays | int | 购买后有效天数 |
| isRoomNight | byte | 是否可拆分 0-不可拆分 1-可拆分 |
| roomNight | int | 间夜数 is_room_night=1 |
| nights | int | 包含晚数 is_room_night=0 |
| roomNumber | int | 包含间数(门票表示包含张数)is_room_night=0 |
| aheadTime | int | 需提前兑换天数 |
| aheadDateTime | timespan | 提前兑换当天的时间点 |
| stock | int | 库存 |
| marketPrice | decimal | 市场价 |
| price | decimal | 售价 |
| feeInclude | string | 费用包含 |
### 业务错误码
| Error Code | HTTP Status Code | Error Message |
| :- | :-| :- | :-|
| SkuNotExist | 404 | 产品SKU不存在 |
| SkuUnderstock | 200 | 库存不足 |
| SkuOutOfServiceTime | 200 | 产品不在售卖时间内 |
### 请求示例
``` http
GET http://test.openapi.huitravel.com/api/v1/goodssku?goodsId=51&skuId=98 HTTP/1.1
accessKeyId: 7568512625
signatureNonce: 0.016536587391298537
timestamp: 2020-11-27T09:26:16Z
signature: 6c8eb3781257e911283bf6852a87d56ad275046d
...
```
``` json
HTTP/1.1 200 OK
{
"goodsId":51,
"skuId":98,
"goodsInfo":{
"goodsId":51,
"baseInfoId":0,
"hid":23422,
"categoryId":5,
"goodsName":"澄江抚仙湖样样好生态农庄",
"imgList":"http://sfile.huizhi-intl.com/test/9a364304-6323-420e-b4e3-4bd15fc45156.jpg",
"strengths":"",
"orderInfo":"",
"instructions":"澄江抚仙湖样样好生态农庄",
"attentions":"",
"pcDesc":"<p></p>",
"isOrderInfo":1,
"isDeliver":0,
"deliverDays":0,
"deliverType":"",
"expressFeeType":0,
"playDays":0,
"playPersons":0,
"travelSettingType":0,
"travelPersonType":0,
"isNeedIDCard":1,
"goodsStatus":1,
"refundType":1,
"isAutoRefund":false
},
"skuInfo":{
"skuId":98,
"skuPrices":[
{
"date":"2020-11-26T00:00:00",
"num":30,
"price":0.21,
"diffPrice":0.01
}
],
"extCode":"",
"minuteAffterBuy":0,
"isVirtual":0,
"skuName":"澄江抚仙湖样样好生态农庄1号",
"skuDesc":"",
"skuSort":0,
"skuImgs":"",
"saleDateType":0,
"saleStartDate":"2000-01-01T00:00:00",
"saleEndDate":"2000-01-01T00:00:00",
"useDateType":2,
"validStartDate":"2000-01-01T00:00:00",
"validEndDate":"2000-01-01T00:00:00",
"validDays":30,
"isRoomNight":0,
"roomNight":1,
"nights":2,
"roomNumber":1,
"aheadTime":0,
"aheadDateTime":"00:00:00",
"stockType":3,
"isTotalStock":0,
"stock":0,
"marketCurr":"RMB",
"marketPrice":3,
"curr":"RMB",
"price":0.21,
"unitName":"",
"feeInclude":""
}
}
```