GET api/WebInterface/ScenicSpot/Products/YearCard?dwlx={dwlx}&dwid={dwid}&startdate={startdate}&enddate={enddate}&queryarea={queryarea}&productid={productid}
从景区获取可以预定(预购)的年卡产品(门票)列表
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 |
| queryarea | string |
Default value is |
|
| productid | string |
Default value is |
Body Parameters
None.
Response Information
Resource Description
从景区获取可以预定(预购)的年卡产品(门票)列表
Collection of Products| Name | 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.