機能仕様
API情報
当該機能は、フライト、ホテル、レンタカーといった旅行情報をTripCaseへ登録する機能です。
| 最新バージョン | ：2.0 |
ご利用上の注意
- TripCaseAPIにて利用する接続トークンは、ユーザー様毎に提供いたします。
また、テスト環境、本番環境でそれぞれ接続トークンは異なる為、お取扱いにはご注意ください。
テスト環境のトークン：「XMLタグ定義書（リクエスト）」に記載しております。
本番環境のトークン：御社でのテスト環境での検証完了後にお渡しします。検証が完了しましたら、テスト環境で利用されたアカウント情報（メールアドレス）とともに、弊社までご連絡ください。
また、当該機能はフライトやホテルといった旅行情報をTripCaseへ登録する機能に限定され、INFINI LINX PLUSなどで作成したPNRを直接操作する機能ではありません。
INFINI LINX PLUSなどをご利用いただく場合のみ、自動更新の対象になります。
更新履歴
ImportItineraryRequest v2.0 on April 09, 2018
- 新規リリースしました。
※詳細についてはXMLタグ定義書をご参照ください。
リクエストサンプル
選択<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ImportItineraryRequest xmlns="https://www.tripcase.com/api/partner_import" UserEmail="TripCaseユーザのメールアドレス" Version="2.0">
<PartnerCredentials AuthToken="弊社から提供する接続トークン"/>
<Itinerary Name="Auto_def_trip" Reference="123456789" ReferenceTerm="TravelProBooking">
<Air DepartureDateTime="2018-04-01T16:50:00.000Z" ArrivalDateTime="2018-04-01T16:35:00.000Z" FlightNumber="10" ConfirmationNumber="54321" LoyaltyNumber="ABCDE" AirlineCode="NH">
<DepartureAirport Code="NRT" Type="IATA"/>
<ArrivalAirport Code="JFK" Type="IATA"/>
</Air>
<LocationEvent ConfirmationNumber="lodging1" StartDateTime="2018-04-01T18:00:00.000Z" EndDateTime="2018-04-07T10:00:00.000Z" Type="lodging">
<Location>
<LocationReference Reference="" Context="sabre" Type="lodging"/>
<Address City="NewYork" State="NY" Country="US" Postal="11430">
<Line>1 Off Airport Road</Line>
</Address>
</Location>
</LocationEvent>
<LocationEvent ConfirmationNumber="meeting1" StartDateTime="2018-04-02T12:00:00.000Z" EndDateTime="2018-04-02T14:00:00.000Z" Name="MEETING" Type="meeting">
<Location>
<Address City="NewYork" State="NY" Country="US">
<Line>1 Off Airport Road</Line>
</Address>
<GeoCode Accuracy="point" Lat="32.919884" Lng="-97.020435"/>
</Location>
</LocationEvent>
<LocationEvent ConfirmationNumber="food1" StartDateTime="2018-04-02T18:00:00.000Z" EndDateTime="2018-04-02T20:30:00.000Z" Name="Pearl Oyster Bar" Type="food_drink">
<Location>
<Address>
<Line>18 Cornelia Street</Line>
<Line>New York, NY 10014</Line>
</Address>
<ClosestAirport Code="JFK" Type="IATA"/>
</Location>
</LocationEvent>
<LocationEvent ConfirmationNumber="activity1" StartDateTime="2018-04-03T12:00:00.000Z" EndDateTime="2018-04-03T19:00:00.000Z" Name="ACTIVITY" Type="activity">
<Location>
<Address City="NewYork" State="NY" Country="US">
<Line>1 Off Airport Road</Line>
</Address>
<GeoCode Accuracy="point" Lat="32.919884" Lng="-97.020435"/>
</Location>
</LocationEvent>
<LocationEvent ConfirmationNumber="attraction1" StartDateTime="2018-04-04T11:00:00.000Z" EndDateTime="2018-02-08T17:00:00.000Z" Name="ATTRACTION" Type="attraction">
<Location>
<Address City="NewYork" State="NY" Country="US">
<Line>1 Off Airport Road</Line>
</Address>
<GeoCode Accuracy="point" Lat="32.919884" Lng="-97.020435"/>
</Location>
</LocationEvent>
<TourEvent Type="rail" Name="NYCT">
<TourStop StartDateTime="2018-04-05T15:20:00" EndDateTime="2018-04-05T15:40:00">
<Location>
<Address City="NewYork" Country="US"/>
<ClosestAirport Code="JFK"/>
</Location>
</TourStop>
</TourEvent>
<TourEvent ConfirmationNumber="cruise1" Name="AMAZING CRUISE" Type="cruise">
<TourStop StartDateTime="2018-04-05T16:00:00.000Z" EndDateTime="2018-04-05T19:30:00.000Z">
<Location>
<Address City="NewYork" State="NY" Country="US">
<Line>1 Off Airport Road</Line>
</Address>
<GeoCode Accuracy="point" Lat="32.919884" Lng="-97.020435"/>
</Location>
</TourStop>
</TourEvent>
<TourEvent Type="ground_transportation" Name="Bus" >
<TourStop StartDateTime="2018-04-05T19:55:00" EndDateTime="2018-04-05T20:20:00">
<Location>
<Address City="NewYork" State="NY" Country="US">
<Line>1 Off Airport Road</Line>
</Address>
<GeoCode Lat="32.919884" Lng="-97.020435" Accuracy="point"/>
</Location>
</TourStop>
</TourEvent>
<TourEvent ConfirmationNumber="ncar1" Name="location rental" Type="vehicle">
<TourStop StartDateTime="2018-04-06T09:00:00.000Z" EndDateTime="2018-04-06T10:00:00.000Z">
<Location>
<LocationReference Reference="NYC" Context="ZI" Type="car_rental"/>
</Location>
</TourStop>
<TourStop StartDateTime="2018-04-06T19:00:00.000Z" EndDateTime="2018-04-06T20:00:00.000Z">
<Location>
<LocationReference Reference="NYC" Context="ZI" Type="car_rental"/>
</Location>
</TourStop>
</TourEvent>
<TourEvent Type="ferry" Name="Ferry’s R Us" >
<TourStop StartDateTime="2018-04-06T12:00:00" EndDateTime="2018-04-06T12:30:00">
<Location>
<Address City="NewYork" State="NY" Country="US">
<Line>1 Off Airport Road</Line>
</Address>
<GeoCode Lat="32.919884" Lng="-97.020435" Accuracy="point"/>
</Location>
</TourStop>
</TourEvent>
<Air DepartureDateTime="2018-04-07T12:00:00.000Z" ArrivalDateTime="2018-04-07T15:00:00.000Z" FlightNumber="9" ConfirmationNumber="12345" LoyaltyNumber="EDCBA" AirlineCode="NH">
<DepartureAirport Code="JFK" Type="IATA"/>
<ArrivalAirport Code="NRT" Type="IATA"/>
</Air>
</Itinerary>
</ImportItineraryRequest>
レスポンスサンプル
選択<?xml version="1.0" encoding="UTF-8" ?>
<ImportItineraryResponse Success="true" />
XMLタグ定義書
-
- リクエスト (2018/05/10更新)
-
- レスポンス (2018/04/09更新)
XMLスキーマ
XMLスキーマをご利用いただけます。
【注意点】
各種XMLスキーマは、Sabre社提供のオリジナル版となるため、「XMLタグ定義書」の記載上、
利用不可の情報が含まれております。
スキーマを利用してアプリケーションを構築される場合の各タグの利用可否は、
必ず「XMLタグ定義書」にてご確認ください。
※弊社にて「XMLタグ定義書」を作成する際、各タグの利用可否確認を行っております。
【注意点】
各種XMLスキーマは、Sabre社提供のオリジナル版となるため、「XMLタグ定義書」の記載上、
利用不可の情報が含まれております。
スキーマを利用してアプリケーションを構築される場合の各タグの利用可否は、
必ず「XMLタグ定義書」にてご確認ください。
※弊社にて「XMLタグ定義書」を作成する際、各タグの利用可否確認を行っております。
-
- スキーマ
エラー集
TripCase APIのエラーレスポンスを例示します。※下記以外のエラーについてはINFINIまでお問い合わせください。
| # | エラーメッセージ | エラー内容 |
|---|---|---|
| 1 | ItineraryReference did not match any source '#{fail_identifier}' | リファレンスが一致しませんでした。 |
| 2 | An unknown airline '#{self.AirlineCode}' | 航空コードが見つかりませんでした。 |
| 3 | An unknown airport '#{departure_airport_code}' | 出発地に指定された空港コードが見つかりませんでした。 |
| 4 | Unknown airport '#{arrival_airport_code}' | 到着地に空港コードが見つかりませんでした。 |
| 5 | LocationEvent Type '#{alpha}' should be {alpha}' when used with the LocationReference given | LocationEventの”Type”が” LocationReference”と同時に利用された場合、”Type”は同一で指定してください。 |
| 6 | The first and last tour stop locations must be of the same type | Tourstopの“Type”が同一ではありません。 |
| 7 | An Address must have at least a City and Country (and usually a State) when importing Vehicle | “Vehicle”を指定する場合、”City”と”Country”、または”State”を指定してください。 |
| 8 | You must specify a GeoCode or ClosestAirport when providing an Address with no structured fields (City/Country) | ”GeoCode”、または” ClosestAirport”を指定する必要があります。 |
| 9 | You must specify an Address or LocationReference | ”Address”か”LocatuinReference”を指定する必要があります。 |
| 10 | An Unknown IATA code '#{closest_airport_code' | 指定された終了地点の空港コードは”IATA”には存在しませんでした。 |
| 11 | An Address must have at least a City and Country (and usually a State) when structured attributes are provided | 構造化フィールドを利用した場合は、”City”と”Country”、または”State”を指定してください。 |
| 12 | Could not geocode address | ジオコードを作成することができませんでした。 |
| 13 | Multiple city-level geocodes were returned for given address | 指定されたアドレスには、都市レベルのジオコードが複数存在します。 |
| 14 | Could not geocode address to a minimum city level accuracy | 所在地からジオコードを取得することができませんでした。 |
| 15 | An unknown location reference '#{self.to_s]' | ロケーションが指定できませんでした。 |