GET api/WebInterface/ScenicSpot/Products?dwlx={dwlx}&dwid={dwid}&startdate={startdate}&enddate={enddate}&servicecode={servicecode}&tripbillcode={tripbillcode}&queryarea={queryarea}
从景区获取可以预定(预购)的产品(门票)列表(包括分时段和不分时段的模式)
Request Information
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
dwlx |
代理商单位类型 |
string |
Required |
dwid |
代理商单位ID |
string |
Required |
startdate |
计划的出行起始日期,可以为空,为空时表示当天,格式YYYYMMDD |
string |
Default value is |
enddate |
计划的出行截止日期,可以为空,为空时表示当天后的第七天,格式YYYYMMDD |
string |
Default value is |
servicecode |
(可选)线路ID,仅在分时段景区中这个项。非分时段的景区将不理会这个参数。在分时段景区系统指定这个参数时,将仅返回对应线路的门票类型。 |
string |
Default value is |
tripbillcode |
(可选)行程单号或行程单条码内容(仅用于张家界团队) |
string |
Default value is |
queryarea | string |
Default value is |
Body Parameters
None.
Response Information
Resource Description
从景区获取可以预定(预购)的产品(门票)列表(包括分时段和不分时段的模式)
Collection of ProductsName | Description | Type | Additional information |
---|---|---|---|
productid |
产品ID,通常为一个GUID值的string值(VARCHAR36),同门票系统中的“门票类型ID”,不会为空。 |
string |
None. |
productname |
产品名称,同门票系统中的“门票类型名称”,不会为空。 |
string |
None. |
unit |
单位,通常为"张",但也有可能为“份”,不能折散销售的大套票可能为“份” |
string |
None. |
price |
价格,此值恒大于等于0 |
decimal number |
None. |
initdate |
有效起始日期,格式YYYYMMDD,此值主要用于区分淡旺季,指明当前票种从何日开始售起 |
string |
None. |
enddate |
有效截止日期,格式YYYYMMDD,此值主要用于区分淡旺季,指明当前票种售至何日止 |
string |
None. |
conditionsofsale |
出售条件,有1至8个选项 |
string |
None. |
minimum |
最小单笔出售数量,0表示没有限制 |
integer |
None. |
maximum |
最大单笔出售数量,0 表示没有限制,正整数表示当前票种,所有渠道可售量之和 |
integer |
None. |
singleidmaximum |
单ID日最大购买限制,0表示没有限制,正整数表示前票种每个代理商可以销售的最大量 |
integer |
None. |
preorderdays |
当前票种有效时长,1日有效(使用当天有效)为1,2日有效为2,依此类推 |
integer |
None. |
effectbegperiod |
生效起始周期,MMDD ,此值主要用于区分淡旺季,前面initdate和enddate是已经经过运算,折算成了当前时间至对应截止日期的值,此处是未经过运算,在门票系统的设置值 |
string |
None. |
effectendperiod |
生效截止周期MMDD ,此值主要用于区分淡旺季 |
string |
None. |
effectperiodnegated |
生效周期取反,“1”表示一年中除effectbegperiod至effectendperiod是有效的 |
string |
None. |
webpredays |
互联网预定提前日数:此值为0表示,当天订,当天可以使用;此值为1表示必须提前一天及以上预订;2表示必须提前两天及以上预定,依此类推。 |
integer |
None. |
needname |
实名制约束,"1"表示必须一个证件号一张门票,“0”表示不需要实名制 |
string |
None. |
qtneedname |
前台实名制约束,同上 |
string |
None. |
timesegmenttype |
时段资源类型,1是占用网络票资源,2是占用前台资源。 |
string |
None. |
perpersonperticket |
是否一人一票,“1”表示一人一票。 |
string |
None. |
isnormalticket |
是否为常规门票,对应到系统中的“是否作门票使用”的设置。 作门票使用是指“可以被前台和互联网出售”的常规门票,用于区别可以使用返款余额支付的返款票。 “1”表示是,其他值表示否。 |
string |
None. |
isrebateticket |
是否作为返利票,对应到系统中的“是否作返款票使用”设置。 只有这种类型的票,才能被“返款余额支付”。 “1”表示是,其他值表示否。 |
string |
None. |
pzcount |
支持凭证数量 |
byte |
None. |
webadvancehourcount |
互联网预定提前小时数 |
integer |
None. |
webadvancedaycount |
提前日数 |
integer |
None. |
effectivemode |
生效期计算的模式。 "A", "授权之日起,有效日数内有效" "B", "授权之日起,有效日数内有效,但不能越年" "C", "指定日期范围内有效" |
string |
None. |
effectivenumberofdays |
当前票种有效期长,1日有效(使用当天有效)为1,2日有效为2,依此类推。 此日数是指从“生效日期”(约定的游览日期起,几天内可用)。 |
integer |
None. |
effectivestartdate |
起始日期 |
string |
None. |
effectiveenddate |
截止日期 |
string |
None. |
hint |
规则描述 |
string |
None. |
Response Formats
application/json, text/json
[ { "productid": "sample string 1", "productname": "sample string 2", "unit": "sample string 3", "price": 4.0, "initdate": "sample string 5", "enddate": "sample string 6", "conditionsofsale": "sample string 7", "minimum": 8, "maximum": 9, "singleidmaximum": 10, "preorderdays": 11, "effectbegperiod": "sample string 12", "effectendperiod": "sample string 13", "effectperiodnegated": "sample string 14", "webpredays": 15, "needname": "sample string 16", "qtneedname": "sample string 17", "timesegmenttype": "sample string 18", "perpersonperticket": "sample string 19", "isnormalticket": "sample string 20", "isrebateticket": "sample string 21", "pzcount": 64, "webadvancehourcount": 23, "webadvancedaycount": 24, "effectivemode": "sample string 25", "effectivenumberofdays": 26, "effectivestartdate": "sample string 27", "effectiveenddate": "sample string 28", "hint": "sample string 29" }, { "productid": "sample string 1", "productname": "sample string 2", "unit": "sample string 3", "price": 4.0, "initdate": "sample string 5", "enddate": "sample string 6", "conditionsofsale": "sample string 7", "minimum": 8, "maximum": 9, "singleidmaximum": 10, "preorderdays": 11, "effectbegperiod": "sample string 12", "effectendperiod": "sample string 13", "effectperiodnegated": "sample string 14", "webpredays": 15, "needname": "sample string 16", "qtneedname": "sample string 17", "timesegmenttype": "sample string 18", "perpersonperticket": "sample string 19", "isnormalticket": "sample string 20", "isrebateticket": "sample string 21", "pzcount": 64, "webadvancehourcount": 23, "webadvancedaycount": 24, "effectivemode": "sample string 25", "effectivenumberofdays": 26, "effectivestartdate": "sample string 27", "effectiveenddate": "sample string 28", "hint": "sample string 29" } ]
application/xml, text/xml
<ArrayOfProducts xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer.Tour.V5.Result.WebInterface"> <Products> <conditionsofsale>sample string 7</conditionsofsale> <effectbegperiod>sample string 12</effectbegperiod> <effectendperiod>sample string 13</effectendperiod> <effectiveenddate>sample string 28</effectiveenddate> <effectivemode>sample string 25</effectivemode> <effectivenumberofdays>26</effectivenumberofdays> <effectivestartdate>sample string 27</effectivestartdate> <effectperiodnegated>sample string 14</effectperiodnegated> <enddate>sample string 6</enddate> <hint>sample string 29</hint> <initdate>sample string 5</initdate> <isnormalticket>sample string 20</isnormalticket> <isrebateticket>sample string 21</isrebateticket> <maximum>9</maximum> <minimum>8</minimum> <needname>sample string 16</needname> <perpersonperticket>sample string 19</perpersonperticket> <preorderdays>11</preorderdays> <price>4</price> <productid>sample string 1</productid> <productname>sample string 2</productname> <pzcount>64</pzcount> <qtneedname>sample string 17</qtneedname> <singleidmaximum>10</singleidmaximum> <timesegmenttype>sample string 18</timesegmenttype> <unit>sample string 3</unit> <webadvancedaycount>24</webadvancedaycount> <webadvancehourcount>23</webadvancehourcount> <webpredays>15</webpredays> </Products> <Products> <conditionsofsale>sample string 7</conditionsofsale> <effectbegperiod>sample string 12</effectbegperiod> <effectendperiod>sample string 13</effectendperiod> <effectiveenddate>sample string 28</effectiveenddate> <effectivemode>sample string 25</effectivemode> <effectivenumberofdays>26</effectivenumberofdays> <effectivestartdate>sample string 27</effectivestartdate> <effectperiodnegated>sample string 14</effectperiodnegated> <enddate>sample string 6</enddate> <hint>sample string 29</hint> <initdate>sample string 5</initdate> <isnormalticket>sample string 20</isnormalticket> <isrebateticket>sample string 21</isrebateticket> <maximum>9</maximum> <minimum>8</minimum> <needname>sample string 16</needname> <perpersonperticket>sample string 19</perpersonperticket> <preorderdays>11</preorderdays> <price>4</price> <productid>sample string 1</productid> <productname>sample string 2</productname> <pzcount>64</pzcount> <qtneedname>sample string 17</qtneedname> <singleidmaximum>10</singleidmaximum> <timesegmenttype>sample string 18</timesegmenttype> <unit>sample string 3</unit> <webadvancedaycount>24</webadvancedaycount> <webadvancehourcount>23</webadvancehourcount> <webpredays>15</webpredays> </Products> </ArrayOfProducts>
application/bson
Binary JSON content. See http://bsonspec.org for details.