# 拉取产品接口
* * * * *
**V2.2更新:**
* 请求参数新增:
* system:产品来源 默认为false, 只获取系统自有产品,如果为字符串则表示查询特定系统的产品
* 产品返回属性新增:
* fullRefund:是否仅支持整单退款。为1时,只能整单退。不可部分退
* * * * *
* * * * *
**V2.1更新:**
* 请求参数新增:
* simples:简单模式 默认为0, 为1时不再返回purchaseNote值,即各项图文说明
* 产品返回属性新增:
* teamType:产品类型,默认normal ,subscribe类型产品下单时需提供出游日期
* beginTime:产品有效期开始时间,2015-12-28 00:00:00 格式要求:yyyy-MM-dd HH:mm:ss
* expireTime:产品有效期结束时间,2015-12-28 00:00:00 格式要求:yyyy-MM-dd HH:mm:ss
* servicePhone:服务电话设置,接待时间和服务电话的配置信息
* refundRule:退款规则,退款限制分钟数,退款类型
* * * * *
+++
post:/openapi/index.php?method=getTeam
*int:partnerId#联合分配的合作方ID。
*json:body#提交内容json格式数据,参考提交数据demo
<<<
提交数据demo
{
"partnerId": 1985,
"body": {
"method": "page",
"currentPage": 0,
"pageSize": 20,
"LHDealIds": [
"852"
]
}
}
*号代表字段为必填项
body字段介绍
*string: method # 请求方法 page为分页查询,multi为指定id查询(使用单个和指定多个产品信息)
int : currentPage # 当前页数 ,method为page是必填
int : pageSize # 每页数量 ,method为page是必填
int : simples # 简单模式 默认为0 (不再返回purchaseNote 包含的各项说明)
array : LHDealIds # 产品ID ,为multi时必填。array[string]
<<<
success
{
"code": 10000,
"describe": "success",
"partnerId": 3528,
"totalSize": 40,
"body": [
{
"partnerId": 3528,
"LHSupplierId": "string",
"LHDealId": "string",
"teamType": "string",
"name": "string",
"pics": ["string"],
"startTime": "string",
"endTime": "string",
"beginTime": "string",
"expireTime": "string",
"marketPrice": 1.5,
"sellPrice": 1,
"buyPrice": 0.5,
"stock": 990,
"allowday": 0,
"aftertime": 0,
"canRefund": 1,
"fullRefund":1,
"refundRule": {
"refundType": 1,
"refundMinute": 0
},
"maxBuyCount": 0,
"minBuyCount":1,
"servicePhone": {
"phone": "string",
"startHour": "8",
"startMin": "00",
"endHour": "22",
"endMin": "00"
},
"purchaseNote": {
"chargeIncludeNote": "string",
"refundNote": "string",
"useNote": "string",
"importantNote": "string",
"imageTextNote": "string"
},
"visitorRequire": {
"name": 1,
"mobile": 1,
"credentials": 0,
"address": 0,
"zipcode": 0,
"email": 0
}
}
]
}
<<<
error
{
"code":20000,
"describe":"iteam not found",
"partnerId":3528,
"totalSize": null,
"body":null
}
<<<
返回参数说明:
开头为 '*' 表示必填项
*int : code # 交互码 取值请参考交互码类型映射表
*string: describe # 交互描述
*int : partnerId # 合作方ID
int : totalSize # 合作方产品总数量 分页查询时必传
*json : body # 返回body内容,有产品是必传,字段说明如下↓
返回body内容说明
*int : partnerId # 合作方ID
string: LHSupplierId # 联合接入的商家id
*string: LHDealId # 产品ID
string: teamType # 产品类型 默认normal, subscribe:指定日期产品 取值参考teamType说明
*string: name # 产品名称
*array : pics # 产品图片列表 array[string]类型
*time : startTime # 产品上架时间 2015-12-28 00:00:00 格式要求:yyyy-MM-dd HH:mm:ss
*time : endTime # 产品下架时间 2015-12-28 00:00:00 格式要求:yyyy-MM-dd HH:mm:ss
*time : beginTime # 开始验票时间 2015-12-28 00:00:00 格式要求:yyyy-MM-dd HH:mm:ss
*time : expireTime # 结束验票时间 2015-12-28 00:00:00 格式要求:yyyy-MM-dd HH:mm:ss
*number: marketPrice # 市场价
*number: sellPrice # 售价
*number: buyPrice # 成本价(双方的结算价格)
*int : stock # 库存数量 不限制 stock = 100000000
*int : allowday # 次日生效 1:次日可用 0:当日可用
int : aftertime # 延时生效时间 单位小时,买票后X小时可验票
int : maxBuyCount# 最大购买数量 0为不限
int : minBuyCount # 最小购买数量
*int : canRefund # 受否支持退款 0:不可退;1:可退
int : fullRefund # 整单退款 0:不限;1:只能整单退款(V2.2新增)
*json : limitRule # 限购规则 取值参考 limitRuleInfo说明,字段说明如下↓
*json : refundRule # 退款规则 取值参考refundRuleInfo说明,字段说明如下↓
*json : servicePhone # 服务电话及时间设置,取值参考ServicePhoneInfo说明,字段说明如下↓
*json : purchaseNote # 各项说明,取值参考PurchaseNoteInfo说明,字段说明如下↓
*json : visitorRequire #用户必填项说明,取值参考VisitorInfo说明,字段说明如下↓
limitRuleInfo各项说明(V2.2新增)
~~~
string : limit # phone:手机。idcard:身份证
int : limitType # 限购的类型,0:用门票张数,1:用订单数
int : LimitDayType # 天数类型:0下单日,1出游日
int : limitDays # 几天内限购
int : limitNumber # 限购的数量
~~~
refundRuleInfo各项说明 (V2.1新增)
*int : refundType # 退款类型 配合退款时间限制 默认1
1.有效期内随便退;
2:有效期结束前XX分钟可退;
3:有效期结束后XX分钟可退;
4:出游日期截至前XX分钟可退;
5:出游日期截至后XX分钟可退
6:出游日期开始前XX分钟可退
结束前的时间从当天的23:59:59开始往前计算。
结束后的时间从次日00:00:00往后计算 如有效期为2016-4-30日,提前312分钟(5小时12分钟),则实际截至时间为2016-4-30 18:47:59(23-5时59-12分59秒)前可退。
开始前从当天的00:00开始往前算分钟数
*int: refundMinute # 退款限制分钟数 默认为0
ServicePhoneInfo字段介绍 *为必填项(V2.1新增)
*num:phone # 热线电话
*num:startHour # 开始小时
*num:startMin # 开始分钟
*num:endHour # 结束小时
*num:endMin # 结束分钟
teamType说明 normal :正常票; subscribe:指定出行日期门票
PurchaseNoteInfo各项说明
*string: includeNote # 费用说明(对应后台包含)
*string: refundNote # 退款说明(对应后台备注)
*string: useNote # 使用说明(对应后台简介)
*string: importantNote # 重要说明(对应后台特别说明)
*string: imageTextNote # 图文详情(对应后台产品详情)
VisitorInfo字段介绍 *为必填项
*int:name # 用户姓名 联合系统默认必填项
*int:mobile # 使用者手机号 联合系统默认必填项
int:credentials # 使用者身份证号 可选
int:address# 地址 可选
int:zipcode# 邮编 可选
int:email # 邮箱 可选
+++