Insurance

セット販売の保険商品の統合

この機能により、レンタカー料金に保険をセットにして旅行者に提供することができます。これにより、バンドルプランを検索結果ページ上で料金タイプとして表示できるようになります。

重要

バンドル保険は現在、ドイツ（DE）の販売拠点でのみご利用いただけます。

利用可能な

「Availability」レスポンスに含まれる各車両の結果には、「insurance_coverage」オブジェクトが含まれる場合があります。レンタカーに関するすべての保険情報（レンタル料金に追加料金なしで含まれているもの、または追加購入可能なものを含め）は、この項目にまとめられています。含まれるフィールドについては、以下をご覧ください。

フィールド	説明
`included`	当該ベンダーが取り扱う保険商品の概要図です。各製品には、補足製品と同じフィールドが含まれています。
`supplemental`	この車両には、さまざまなオプションの保険商品をご用意しております。

料金に含まれているサービス

衝突損害免責特約（CDW）

included.collision_damage_waiverオブジェクトには、以下のフィールドが含まれています：

フィールド	説明	例
`description`	補償内容の略称です。	衝突損害免責特約
`deductible`	補償対象となる事故が発生した場合、補償が適用される前に、旅行者が負担しなければならない金額です。
`trip_rate`	参考情報として、すでにオファーの合計金額に算入されている費用です。

補足

supplemental配列に含まれるオプションの保険商品には、以下のフィールドがあります：

フィールド	説明	例
`provider`	保険会社の名称。	自動車保険の業者
`description`	補償内容の略称です。	完全補償
`benefits.refundable_deductible`	記載がある場合は、保険金請求の際に返金される可能性のある免責額の一部について説明しています（通貨、金額、割合）。
`benefits.additional_protection`	この保険には、さまざまな追加の補償が含まれています。	フロントガラス
`trip_rate`	ご予約全体にかかる保険の合計金額（1日あたりの金額ではありません）。
`cancel_penalties`	当該保険商品に特有の解約手数料。車両に標準装備されているものに加え、以下の点もご確認ください`cancel_penalties`。
`links.details`	自動車と保険のセット商品の詳細ページへのURLです。

保険のセットプラン

在庫

insurance-bundledのオファーを表示するには、以下のクエリパラメータを使用します：

フィールド	説明
`include=insurance_bundle`	結果として`insurance_coverage` を返します。これがなければ、セット販売の保険プランは「利用可能」の応答から除外されます。
`filter=insurance_bundle`	検索結果を、保険のセット割引が利用できる車に限定します。`include=insurance_bundle`と組み合わせて使用すると、バンドルされた結果のみを表示できます。

**注 : **

予約可能状況のレスポンスに含まれる「rate.pricing」オブジェクトには、バンドルされた保険の費用は反映されていません。これは、予約時点では、保険（またはどの補償プラン）が車両のオファーにバンドルされるか、APIがまだ把握していないためです。
「Details」レスポンスに含まれる「rate.pricing.totals.insurance」は、その時点でAPIがバンドルの作成を意図していると認識しているため、商品詳細ページに表示されるバンドル保険の合計金額を反映します。
現在、2種類の保険商品をご用意しております。「フルプロテクション」と「エクストラカバー」です。レンタカーの料金や含まれる補償内容に応じて、適切な保険商品をご提案いたします。

在庫状況の回答例

[
  {
    ...
    "insurance_coverage": {
      "included": {
        "collision_damage_waiver": {
          "description": "Collision Damage Waiver",
          "deductible": {
            "billable_currency": {
              "value": "1500.00",
              "currency": "USD"
            },
            "request_currency": {
              "value": "1500.00",
              "currency": "USD"
            }
          }
        }
      },
      "supplemental": [
        {
          "provider": "[vendor name]",
          "description": "Full Protection",
          "benefits": {
            "refundable_deductible": {
              "currency": "USD",
              "amount": "1500.00",
              "percent": "100%"
            }
          },
          "trip_rate": {
            "billable_currency": {
              "value": "100.00",
              "currency": "USD"
            },
            "request_currency": {
              "value": "100.00",
              "currency": "USD"
            }
          },
          "cancel_penalties": [
            {
              "end": "2018-02-12T11:59:00",
              "currency": "USD",
              "amount": "100.00"
            }
          ],
          "links": {
            "details": {
              "method": "GET",
              "href": "https://test.ean.com/v2/cars/1234/details?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
            }
          }
        }
      ]
    },
    ...
    "cancel_penalties": [
      {
        "currency": "USD",
        "start": "2018-02-12T11:59:00",
        "end": "2018-02-12T11:59:00",
        "amount": "50.00"
      }
    ],
    "links": {
      "details": {
        "method": "GET",
        "href": "https://test.ean.com/v2/cars/1234/details?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
      }
    }
  }
]

詳細情報

エンドポイント： GET /v2/cars/{car_rental_id}/details

バンドル保険に関する「詳細」リンクは、補足資料の「links.details」内の「InsuranceProduct」にある「Availability」の結果に記載されています。詳細な料金、利用規約、および予約リンクについては、お電話にてお問い合わせください。

ここで紹介するinsurance_coverage オブジェクトは、『Availability』に記載されているものと同じ構造となっています。チェックアウトを行う際は、これを正式なバージョンとしてご使用ください。

注：に掲載されている料金およびポリシーの詳細は、空室状況の回答に記載されている内容よりも優先されます。

補足的な補償

insurance_coverage.supplementalに含まれるフィールドについては、以下をご覧ください。

フィールド	説明	例
`provider`	保険会社の名称。	自動車保険会社
`description`	補償内容の略称です。	完全補償
`benefits.refundable_deductible`	記載がある場合は、保険金請求の際に返金される可能性のある免責額の一部について説明します（通貨、金額、割合）。
`benefits.content`	旅行者に補償内容の詳細を表示するための、`{ title, description }` オブジェクトの配列です。
`benefits.additional_protection`	この保険には、さまざまな追加の補償が含まれています。	フロントガラス
`disclaimer`	チェックアウト時に保険を追加する前に、旅行者が同意しなければならない文章です。これを表示し、ご予約の前にご承諾をいただいてください。
`trip_rate`	ご予約全体にかかる保険の合計金額（1日あたりの金額ではありません）。
`cancel_penalties`	当該保険商品に特有の解約違約金。お車の`cancel_penalties` に加え、以下の点もご確認ください。
`links.terms_and_conditions`	保険約款のURLです。
`links.product_information`	保険商品情報文書（IPID）のURL。

保険に関連するその他の分野

フィールド	説明
`rate.pricing.totals.insurance`	セット料金の保険料総額です。

詳細な応答例

{
  ...
  "insurance_coverage": {
    "included": {
      "collision_damage_waiver": {
        "description": "Collision Damage Waiver",
        "deductible": {
          "billable_currency": {
            "value": "1500.00",
            "currency": "USD"
          },
          "request_currency": {
            "value": "1500.00",
            "currency": "USD"
          }
        }
      }
    },
    "supplemental": [
      {
        "provider": "[vendor name]",
        "description": "Full Protection",
        "benefits": {
          "refundable_deductible": {
            "currency": "USD",
            "amount": "1500.00",
            "percent": "100%"
          },
          "content": [
            {
              "title": "Zero excess if the vehicle is damaged or stolen",
              "description": "Full Protection covers the full excess amount so you won’t have to pay if something goes wrong."
            },
            {
              "title": "Damages commonly excluded by rental companies",
              "description": "Includes windows, windscreens, tyres, wheels, mirrors/glass, roof, underbody, hitting an animal and more"
            },
            {
              "title": "Roadside assistance and repair costs",
              "description": "Includes towing, key loss & replacement and vehicle lockout"
            },
            {
              "title": "Free cancellation at anytime before pick-up"
            }
          ]
        },
        "disclaimer": "By adding protection you confirm you have read and agree to the Policy Terms and Insurance Product Information Document. By selecting this insurance you confirm you are a resident of Germany, and you are over 18 years old.",
        "trip_rate": {
          "billable_currency": {
            "value": "100.00",
            "currency": "USD"
          },
          "request_currency": {
            "value": "100.00",
            "currency": "USD"
          }
        },
        "cancel_penalties": [
          {
            "end": "2018-02-12T11:59:00",
            "currency": "USD",
            "amount": "100.00"
          }
        ],
        "links": {
          "terms_and_conditions": {
            "method": "GET",
            "href": "https://www.rentalcover.com/policy-wording/collinsoneu-fp-ob"
          },
          "product_information": {
            "method": "GET",
            "href": "https://static.xcover.com/media/pds/7fd53012-812d-4316-bb72-95f46534da7e/Expedia_RC-FP-DE.pdf"
          }
        }
      }
    ]
  },
  ...
  "rate": {
    ...
    "pricing": {
      ...
      "totals": {
        ...
        "insurance": {
          "request_currency": {
            "value": "100.00",
            "currency": "USD"
          }
        },
        ...
      }
    }
  },
  ...
  "cancel_penalties": [
    {
      "currency": "USD",
      "start": "2018-02-12T11:59:00",
      "end": "2018-02-12T11:59:00",
      "amount": "50.00"
    }
  ],
  "links": {
    "payment": {
      "method": "POST",
      "href": "https://pay-test.ean.com/v1/payments?token=K~IjZ45n9y8TKnmQeJ2jQKZxJcYDFCOjkqIl6wLmcyVQlZBVUKLZctxg=="
    },
    "book": {
      "method": "POST",
      "href": "https://test.ean.com/v2/itineraries/car?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
    }
  }
}

お支払いの登録

エンドポイント： POST /v2/payments?token=<TOKEN>

「支払い登録」のリンクは、レスポンス本文内の「links.payment」の下にある「Details」レスポンスに記載されています。この番号にお電話いただき、お支払い方法を登録して、予約用のpayment_token を取得してください。

予約

エンドポイント： POST /v2/itineraries/car

「詳細」の返信にある書籍のリンクをご利用ください。そのリンク先のトークンには、バンドルされた保険を含め、すべてのセッション状態が格納されています。

保険に関連するその他のリクエスト本文フィールドについては、以下をご覧ください。

フィールド	説明
`primary_driver.country_of_residence`	運転者の主たる居住地の、ISO 3166-1 α-2に基づく2文字の国コード。ご予約に保険が含まれている場合、この欄は必須となります。
`primary_driver.state_province_code`	運転者の主たる居住地の2文字の州・県コード、または3文字の行政区画コードを、ISO 3166-1 alpha-2またはISO 3166-1 alpha-3の形式で記載してください。保険付きのレンタカーをご予約の際は、この欄への入力が必要です。

予約が正常に完了すると、HTTP 201ステータスコードとともに以下の内容が返されます：

itinerary_id - 恒久的な予約番号。
links.retrieve - このリンクから予約の詳細を取得してください。

Retrieve

エンドポイント： GET /itineraries/{itinerary_id}/car

予約の応答に含まれる取得リンクを使用するか、affiliate_reference_id を使用して検索してください。GET /itineraries/car?affiliate_reference_id=.....

ご予約後、旅程表が確認できるようになるまで、少し時間がかかる場合がございます。ご予約直後にエラーが表示された場合は、数分お待ちの上、再度お試しください。

回答（RetrieveResponse）には、以下が含まれますが、これらに限定されるものではありません：

フィールド	説明	例
`itinerary_id`	ご予約の旅程IDです。
`status`	現在の予約状況です。	`BOOKED`
`confirmation_id`	ベンダー確認番号。
`car_details`	`CarDetails`、`insurance_coverage`、`rate`、`policies` を含む、完全な ``rules_and_restrictions オブジェクトです。
`primary_driver`	ご予約時にご登録いただいた運転者情報です。
`affiliate_reference_id`	ご予約の際に登録されたアフィリエイト参照IDです。
`affiliate_metadata`	予約時に送信されたメタデータです。
`creation_time`	ISO 8601形式での予約作成日時。
`links.cancel`	`DELETE` 予約をキャンセルするためのリンクです。
`policy_id`	保険の予約番号	12345C4R1NS

Retrieveレスポンスに含まれるcar_details.insurance_coverage は、予約された保険の内容を表しています。返金およびキャンセルに関する規約については、insurance_coverage.supplemental[].cancel_penalties およびcar-level cancel_penalties をご参照ください。

注： policy_id は予約後に非同期で生成されるため、取得呼び出しを行った直後には表示されない場合があります。その後、policy_id が、次の呼び出し時に表示される可能性があります。

レスポンスの取得例

...
      "supplemental": [
        {
          "policy_id": "12345C4R1NS",
          "provider": "Cover Genius",
          "description": "Full Protection",
          "benefits": {
            "additional_protection": [
              "windshield",
              "windows",
              "mirrors",
              "wheels",
              "tires"
            ],
            "refundable_deductible": {
              "currency": "USD",
              "amount": "1500.00",
              "percent": "100%"
            },
            "content": [
              {
                "title": "Zero excess if the vehicle is damaged or stolen",
                "description": "Full Protection covers the full excess amount so you won’t have to pay if something goes wrong."
              },
              {
                "title": "Damages commonly excluded by rental companies",
                "description": "Includes windows, windscreens, tyres, wheels, mirrors/glass, roof, underbody, hitting an animal and more"
              },
              {
                "title": "Roadside assistance and repair costs",
                "description": "Includes towing, key loss & replacement and vehicle lockout"
              },
              {
                "title": "Free cancellation at anytime before pick-up"
              }
            ]
          },
          "disclaimer": "By adding protection you confirm you have read and agree to the Policy Terms and Insurance Product Information Document. By selecting this insurance you confirm you are a resident of Germany, and you are over 18 years old.",
          "trip_rate": {
            "billable_currency": {
              "value": "100.00",
              "currency": "USD"
            },
            "request_currency": {
              "value": "100.00",
              "currency": "USD"
            }
          },
          "cancel_penalties": [
            {
              "end": "2018-02-12T11:59:00",
              "currency": "USD",
              "amount": "100.00"
            }
          ],
          "links": {
            "terms_and_conditions": {
              "method": "GET",
              "href": "https://www.rentalcover.com/policy-wording/collinsoneu-fp-ob"
            },
            "product_information": {
              "method": "GET",
              "href": "https://static.xcover.com/media/pds/7fd53012-812d-4316-bb72-95f46534da7e/Expedia_RC-FP-DE.pdf"
            }
          }
        }
      ]
      ...

キャンセル

エンドポイント： DELETE /itineraries/{itinerary_id}/car

「取得」レスポンスに含まれるキャンセルリンクを使用して、車両と保険のセット予約をキャンセルしてください。

注：セット販売の保険予約の場合、追加の保険商品は個別に解約することはできません。唯一の選択肢は、バンドル全体を解約することですが、その際には、自動車本体の「cancel_penalties（）」および追加保険の規定が適用されます。cancel_penaltiesの2つの配列のうち、最も制限の厳しい組み合わせを用いて、免除の適格性を判断いたします。

API の詳細

このページで予約管理エンドポイントの定義を確認した後、API Explorerなどのテスト用ソフトウェアを使用して、サンプルやスキーマ定義と実際の出力結果がどのように異なるかを把握してください。

その他のリソース

Rapid Car APIのすべてのエンドポイントを試してみたい場合でも、そのOpenAPI仕様書をダウンロードしたい場合でも、必要なものはすべてご用意しております。