GET api/WebInterface/ScenicSpot/Products?dwlx={dwlx}&dwid={dwid}&startdate={startdate}&enddate={enddate}&servicecode={servicecode}&tripbillcode={tripbillcode}&queryarea={queryarea}

从景区获取可以预定(预购)的产品(门票)列表(包括分时段和不分时段的模式)

Request Information

URI Parameters

NameDescriptionTypeAdditional 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 Products
NameDescriptionTypeAdditional 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

Sample:
[
  {
    "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

Sample:
<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

Sample:
Binary JSON content. See http://bsonspec.org for details.