POST api/Order/ScenicSpot/AddOrder/V53InsuranceAndHoleTeamChk

对景区类供应商发起预订的接口(包括分时段和不分时段的模式)。 V53版本,含有整团入园参数和购买保险参数。。

Request Information

URI Parameters

None.

Body Parameters

OrderAddV53Parm
NameDescriptionTypeAdditional information
orderdetails

订单明细信息,指明定购产品及数量,此少需要包含一个明细。

Collection of OrderAddItemV53Parm

Required

mobile

手机号码,如果系统有依据订单的通知(如退款完成,订单取票等),将发送到这个手机上。 如果订单整没有提供证件号,所有门票都是前台取票的,取票凭证会发送到这个手机上。

string

Required

Max length: 11

otheruserid

其他用户ID号,指用户在第三方系统的用户账号,主要用于官方网站和官方微信的对接,第三方OTA不能使用。

integer

None.

identificationnumber

身份证号,如果订单内的门票均是非实名的且需要取票的,客人可以使用这个证件号到前台或自助机上取票

string

Max length: 20

effectdate

生效日期,格式:yyyyMMdd。

string

Required

Max length: 8

needinvoice

是否需要发票,“1”表示需要,“0”表示不需要。

string

Max length: 1

invoicetitle

发票上打印的购货人单位名称

string

Max length: 100

invoicecode

购货人统一社会信用代码,当需要发票为“1”,但此项为空时,则发票将开“个人”。

string

Max length: 30

senderid

被接口方的业务单据ID,示例:同程网接口调用,此值表示同程网业务系统内对应的订单的单据号,此值在接口方系统内应为唯一值。不提供此参数时,系统将不会执行回调通知。提供这个参数还可以防止订单的重复提交。

string

Max length: 50

servicecode

服务项目ID(线路ID),此值仅在分时段景区中必须。

string

Max length: 2

timespanindex

时段序号,当门票系统处于分时段售检票模式时,此值必须;否则此值没有意义。指定时段:取值1,2,3,4,5之类的自然数,此时该时段必须是门票系统中存在的、可用的、有足够余额的,否则会占用失败;-1表示自动时段号,系统会自动检索有足够余量的时段,且时间最前的优先,来占用时段,若当天已无时段可用或没有足够的余额容纳本次占用时,预定会失败。

integer

None.

tripbillcode

行程单编号,在文档编写之时,此值只能对应张家界的全域通和一诚通行程单。

string

Max length: 50

guidernumber

导游证号

string

Max length: 20

marketareaid

市场区划的代码

string

Max length: 6

reserve1

预留一字段(对应T_SP_YD表中的BL2字段 varchar(200)) 原保留2字段用于存储预订明细表中该订单的总人数 2019-11-09 by TangYu 应卧龙要求进行修改

string

Max length: 50

reserve2

预留二字段(对应T_SP_YD表中的BZ字段 text) 原备注字段用于存储预订明细表中该订单的实名信息 2019-11-09 by TangYu 应卧龙要求进行修改

string

Max length: 50

TeamCode

导游,旅行社提交时,可以携带此参数,用于指明团队编号。

string

Max length: 20

Request Formats

application/json, text/json

Sample:
{
  "orderdetails": [
    {
      "HoleTeamChk": "sample string 1",
      "BuyInsurance": "sample string 2",
      "InsurancePrice": 1.0,
      "InsuranceCount": 1,
      "InsurancePlanCode": "sample string 3",
      "InsurancePlanName": "sample string 4",
      "InsuranceDestZone": "sample string 5",
      "InsuranceTimeRange": 1,
      "InsuranceHolderType": "sample string 6",
      "InsuranceHolderCompanyName": "sample string 7",
      "InsuranceHolderCompanyCode": "sample string 8",
      "InsuranceHolderAddress": "sample string 9",
      "InsuranceHolderContactName": "sample string 10",
      "InsuranceHolderContactPhone": "sample string 11",
      "InsuranceHolderEmail": "sample string 12",
      "XB": "sample string 13",
      "Birthday": "sample string 14",
      "AdditonalReduceIdType": "sample string 15",
      "AdditonalReduceId": "sample string 16",
      "InsuranceSex": "sample string 17",
      "InsuranceBirthDay": "sample string 18",
      "InsuranceCertTypeName": "sample string 19",
      "InsuranceCertTypeCode": "sample string 20",
      "productid": "sample string 21",
      "amount": 22,
      "identificationnumber": "sample string 23",
      "fullname": "sample string 24",
      "identificationtype": "sample string 25",
      "mobile": "sample string 26",
      "gateinmode": "sample string 27",
      "seatitems": [
        {
          "seatid": "sample string 1"
        },
        {
          "seatid": "sample string 1"
        }
      ]
    },
    {
      "HoleTeamChk": "sample string 1",
      "BuyInsurance": "sample string 2",
      "InsurancePrice": 1.0,
      "InsuranceCount": 1,
      "InsurancePlanCode": "sample string 3",
      "InsurancePlanName": "sample string 4",
      "InsuranceDestZone": "sample string 5",
      "InsuranceTimeRange": 1,
      "InsuranceHolderType": "sample string 6",
      "InsuranceHolderCompanyName": "sample string 7",
      "InsuranceHolderCompanyCode": "sample string 8",
      "InsuranceHolderAddress": "sample string 9",
      "InsuranceHolderContactName": "sample string 10",
      "InsuranceHolderContactPhone": "sample string 11",
      "InsuranceHolderEmail": "sample string 12",
      "XB": "sample string 13",
      "Birthday": "sample string 14",
      "AdditonalReduceIdType": "sample string 15",
      "AdditonalReduceId": "sample string 16",
      "InsuranceSex": "sample string 17",
      "InsuranceBirthDay": "sample string 18",
      "InsuranceCertTypeName": "sample string 19",
      "InsuranceCertTypeCode": "sample string 20",
      "productid": "sample string 21",
      "amount": 22,
      "identificationnumber": "sample string 23",
      "fullname": "sample string 24",
      "identificationtype": "sample string 25",
      "mobile": "sample string 26",
      "gateinmode": "sample string 27",
      "seatitems": [
        {
          "seatid": "sample string 1"
        },
        {
          "seatid": "sample string 1"
        }
      ]
    }
  ],
  "mobile": "sample string 1",
  "otheruserid": 2,
  "identificationnumber": "sample string 3",
  "effectdate": "sample string 4",
  "needinvoice": "sample string 5",
  "invoicetitle": "sample string 6",
  "invoicecode": "sample string 7",
  "senderid": "sample string 8",
  "servicecode": "sample string 9",
  "timespanindex": 10,
  "tripbillcode": "sample string 11",
  "guidernumber": "sample string 12",
  "marketareaid": "sample string 13",
  "reserve1": "sample string 14",
  "reserve2": "sample string 15",
  "TeamCode": "sample string 16"
}

application/xml, text/xml

Sample:
<OrderAddV53Parm xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer.Tour.V5.Parm.WebInterface">
  <TeamCode>sample string 16</TeamCode>
  <effectdate>sample string 4</effectdate>
  <guidernumber>sample string 12</guidernumber>
  <identificationnumber>sample string 3</identificationnumber>
  <invoicecode>sample string 7</invoicecode>
  <invoicetitle>sample string 6</invoicetitle>
  <marketareaid>sample string 13</marketareaid>
  <mobile>sample string 1</mobile>
  <needinvoice>sample string 5</needinvoice>
  <orderdetails>
    <OrderAddItemV53Parm>
      <amount>22</amount>
      <fullname>sample string 24</fullname>
      <gateinmode>sample string 27</gateinmode>
      <identificationnumber>sample string 23</identificationnumber>
      <identificationtype>sample string 25</identificationtype>
      <mobile>sample string 26</mobile>
      <productid>sample string 21</productid>
      <seatitems>
        <Order2SeatItem>
          <seatid>sample string 1</seatid>
        </Order2SeatItem>
        <Order2SeatItem>
          <seatid>sample string 1</seatid>
        </Order2SeatItem>
      </seatitems>
      <AdditonalReduceId>sample string 16</AdditonalReduceId>
      <AdditonalReduceIdType>sample string 15</AdditonalReduceIdType>
      <Birthday>sample string 14</Birthday>
      <BuyInsurance>sample string 2</BuyInsurance>
      <HoleTeamChk>sample string 1</HoleTeamChk>
      <InsuranceBirthDay>sample string 18</InsuranceBirthDay>
      <InsuranceCertTypeCode>sample string 20</InsuranceCertTypeCode>
      <InsuranceCertTypeName>sample string 19</InsuranceCertTypeName>
      <InsuranceCount>1</InsuranceCount>
      <InsuranceDestZone>sample string 5</InsuranceDestZone>
      <InsuranceHolderAddress>sample string 9</InsuranceHolderAddress>
      <InsuranceHolderCompanyCode>sample string 8</InsuranceHolderCompanyCode>
      <InsuranceHolderCompanyName>sample string 7</InsuranceHolderCompanyName>
      <InsuranceHolderContactName>sample string 10</InsuranceHolderContactName>
      <InsuranceHolderContactPhone>sample string 11</InsuranceHolderContactPhone>
      <InsuranceHolderEmail>sample string 12</InsuranceHolderEmail>
      <InsuranceHolderType>sample string 6</InsuranceHolderType>
      <InsurancePlanCode>sample string 3</InsurancePlanCode>
      <InsurancePlanName>sample string 4</InsurancePlanName>
      <InsurancePrice>1</InsurancePrice>
      <InsuranceSex>sample string 17</InsuranceSex>
      <InsuranceTimeRange>1</InsuranceTimeRange>
      <XB>sample string 13</XB>
    </OrderAddItemV53Parm>
    <OrderAddItemV53Parm>
      <amount>22</amount>
      <fullname>sample string 24</fullname>
      <gateinmode>sample string 27</gateinmode>
      <identificationnumber>sample string 23</identificationnumber>
      <identificationtype>sample string 25</identificationtype>
      <mobile>sample string 26</mobile>
      <productid>sample string 21</productid>
      <seatitems>
        <Order2SeatItem>
          <seatid>sample string 1</seatid>
        </Order2SeatItem>
        <Order2SeatItem>
          <seatid>sample string 1</seatid>
        </Order2SeatItem>
      </seatitems>
      <AdditonalReduceId>sample string 16</AdditonalReduceId>
      <AdditonalReduceIdType>sample string 15</AdditonalReduceIdType>
      <Birthday>sample string 14</Birthday>
      <BuyInsurance>sample string 2</BuyInsurance>
      <HoleTeamChk>sample string 1</HoleTeamChk>
      <InsuranceBirthDay>sample string 18</InsuranceBirthDay>
      <InsuranceCertTypeCode>sample string 20</InsuranceCertTypeCode>
      <InsuranceCertTypeName>sample string 19</InsuranceCertTypeName>
      <InsuranceCount>1</InsuranceCount>
      <InsuranceDestZone>sample string 5</InsuranceDestZone>
      <InsuranceHolderAddress>sample string 9</InsuranceHolderAddress>
      <InsuranceHolderCompanyCode>sample string 8</InsuranceHolderCompanyCode>
      <InsuranceHolderCompanyName>sample string 7</InsuranceHolderCompanyName>
      <InsuranceHolderContactName>sample string 10</InsuranceHolderContactName>
      <InsuranceHolderContactPhone>sample string 11</InsuranceHolderContactPhone>
      <InsuranceHolderEmail>sample string 12</InsuranceHolderEmail>
      <InsuranceHolderType>sample string 6</InsuranceHolderType>
      <InsurancePlanCode>sample string 3</InsurancePlanCode>
      <InsurancePlanName>sample string 4</InsurancePlanName>
      <InsurancePrice>1</InsurancePrice>
      <InsuranceSex>sample string 17</InsuranceSex>
      <InsuranceTimeRange>1</InsuranceTimeRange>
      <XB>sample string 13</XB>
    </OrderAddItemV53Parm>
  </orderdetails>
  <otheruserid>2</otheruserid>
  <reserve1>sample string 14</reserve1>
  <reserve2>sample string 15</reserve2>
  <senderid>sample string 8</senderid>
  <servicecode>sample string 9</servicecode>
  <timespanindex>10</timespanindex>
  <tripbillcode>sample string 11</tripbillcode>
</OrderAddV53Parm>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

对景区类供应商发起预订的接口(包括分时段和不分时段的模式)。 V53版本,含有整团入园参数和购买保险参数。。

OrderOperatorResult
NameDescriptionTypeAdditional information
orderid

操作对应(或产生)的电子门票系统订单号。

string

None.

sendid

操作对应的第三方系统的订单号(如同程网发送过来的订单的编号),此编号由接口方提供,在提口方系统中应为唯一值。

string

None.

orderstatus

订单当前所处的状态

string

None.

resultcode

操作返回代码,0表示成功,其他值表示错误。

integer

None.

returnmessgage

从接口返回的提示消息,用于告知成功的结果或出错的原因。

string

None.

Response Formats

application/json, text/json

Sample:
{
  "orderid": "sample string 1",
  "sendid": "sample string 2",
  "orderstatus": "sample string 3",
  "resultcode": 4,
  "returnmessgage": "sample string 5"
}

application/xml, text/xml

Sample:
<OrderOperatorResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer.Tour.V5.Result.WebInterface">
  <orderid>sample string 1</orderid>
  <orderstatus>sample string 3</orderstatus>
  <resultcode>4</resultcode>
  <returnmessgage>sample string 5</returnmessgage>
  <sendid>sample string 2</sendid>
</OrderOperatorResult>