メインコンテンツまでスキップ

EX予約/スマートEX

EX予約（エクスプレス予約）とは、ＪＲ東海、ＪＲ西日本、ＪＲ九州の東海道・山陽・九州新幹線の会員制ネット予約サービスです。また、年会費不要のスマートEXもあります。

ここでは、EX予約とスマートEXをまとめて「EX予約/スマートEX」と表現し、「mixway API」が定義した料金計算について説明します。

用語について​

「mixway API」が定義する割引事業者の商品名称説明
ＥＸ予約EX予約サービス、EX予約サービス（往復割引）EX予約の基本商品。
ＥＸ予約(ｅ特急券)e特急券EX予約の基本商品(特急券の割引のみ)。
ＥＸ予約(ＥＸ早特)EX早特3、EX早特7EX予約の早めの予約でさらにおトクな早特商品。
ＥＸ予約(ＥＸ早特１)EX早特1EX予約の早めの予約でさらにおトクな早特商品。
ＥＸ予約(ＥＸ早特２１)EX早特21ワイドEX予約の早めの予約でさらにおトクな早特商品。
ＥＸ予約(ＥＸ早特２８)EX早特28ワイドEX予約の早めの予約でさらにおトクな早特商品。
ＥＸ予約(ＥＸグリーン早特)EXグリーン早特3ワイド、EXこだまグリーン早特3EX予約の早めの予約でさらにおトクな早特商品。
スマートＥＸスマートEXサービス、スマートEXサービス（往復割引）スマートEXの基本商品。
スマートＥＸ(ＥＸ早特)EX早特3、EX早特7スマートEXの早特商品。
スマートＥＸ(ＥＸ早特１)EX早特1スマートEXの早特商品。
スマートＥＸ(ＥＸ早特２１)EX早特21ワイドスマートEXの早特商品。
スマートＥＸ(ＥＸ早特２８)EX早特28ワイドスマートEXの早特商品。
スマートＥＸ(ＥＸグリーン早特)EXグリーン早特3ワイド、EXこだまグリーン早特3スマートEXの早特商品。

※ 2024年3月現在。

割引の適用について​

EX予約/スマートEXは、区間・日付・便等の条件が合致した時に割引が適用されます。
「mixway API」では、ダイヤによる探索・平均待ち時間による探索ともに、探索条件で指定された割引が適用できない場合、
以下の様に、より割引率が大きい順番で適用可能な割引を探します。

※ 経路探索で回数券が指定された場合は、回数券が優先されます。
※ ＥＸ早特１ は自由席に対する割引であるため、指定席/グリーンに対する割引である他の早特商品が指定された場合に適用されることはありません。


■ 探索条件で ＥＸ早特２８ または ＥＸ早特２１ または ＥＸ早特 が指定された場合（ＥＸ予約、スマートＥＸとも共通）

ＥＸ早特２８ > ＥＸ早特２１ > ＥＸ早特 > 通常のＥＸ予約/スマートＥＸ料金

■ 探索条件で ＥＸグリーン早特 または ＥＸ早特 が指定された場合（ＥＸ予約、スマートＥＸとも共通）

ＥＸグリーン早特 > ＥＸ早特 > 通常のＥＸ予約/スマートＥＸ料金

■ 探索条件で ＥＸ早特１ が指定された場合（ＥＸ予約、スマートＥＸとも共通）

ＥＸ早特１ > 通常のＥＸ予約/スマートＥＸ料金

以下、具体例になります。

■ 例. 探索条件に「ＥＸ予約(ＥＸ早特)」を指定し、「東京-新大阪」間の経路探索をした場合

「東京-新大阪」は、「ＥＸ予約(ＥＸ早特)」の設定区間ではありませんが、「ＥＸ予約」の設定区間ではあるため、「ＥＸ予約」が適用されます。

■ 例. 探索条件に「ＥＸ予約(ＥＸ早特)」を指定し、「東京-岡山」間の経路探索をした場合

「新幹線のぞみ」の場合は、「ＥＸ予約(ＥＸ早特)」の対象列車なので、「ＥＸ予約(ＥＸ早特)」が適用されます。
「新幹線ひかり」の場合は、「ＥＸ予約(ＥＸ早特)」の対象列車ではありませんが、「ＥＸ予約」の対象列車ではあるため、「ＥＸ予約」が適用されます。

※ 2024年3月現在。


ヒント

EX予約/スマートEXは、指定された割引と適用される割引が一致しないケースがあります。
金額のみを案内した場合、意図しない割引が適用された金額になっていることがあるため、
どの割引が適用されたか、指定した割引と変わったか、など注意を促せるような実装をすることを推奨します。

どの割引が適用されたか、指定した割引と変わったか、については「探索条件の指定とは別の割引が適用された場合」をご確認ください。

探索条件の指定とは別の割引が適用された場合​

別の割引が適用された場合、レスポンス結果には以下の名称を返します。

  • 適用された名称: remark、fullRemark
  • 指定された名称: expectedRemark、expectedFullRemark

以下は、探索条件で「ＥＸ予約(ＥＸ早特２１)」を指定し、「ＥＸ予約(ＥＸ早特)」が適用されたレスポンス例になります。

GET /v1/json/search/course/extreme?key=アクセスキーを入力してください&viaList=22828:25978&searchType=departure&time=1500&conditionDetail=T3221233232319:F332112212030:A23121141:
{
  "ResultSet": {
    "Course": [
      {
        "Price": [
          {
            "kind": "FareSummary",
            "Oneway": "0",
            "Round": "0"
          },
          {
            "fareRevisionStatus": "none",
            "toLineIndex": "1",
            "fromLineIndex": "1",
            "kind": "Fare",
            "index": "1",
            "selected": "true",
            "Type": "Fare",
            "Oneway": {
              "text": "0",
              "remark": "ＥＸ早特", // 適用された割引の名称
              "expectedRemark": "ＥＸ早特２１", // 探索条件で指定された割引の名称
              "fullRemark": "ＥＸ予約(ＥＸ早特)", // 適用された割引の名称(詳細)
              "expectedFullRemark": "ＥＸ予約(ＥＸ早特２１)", // 探索条件で指定された割引の名称(詳細)
              "includedInCharge": "true"
            },
            "RevisionStatus": "latest",
            "Round": {
              "text": "0",
              "remark": "ＥＸ早特",
              "expectedRemark": "ＥＸ早特２１",
              "fullRemark": "ＥＸ予約(ＥＸ早特)",
              "expectedFullRemark": "ＥＸ予約(ＥＸ早特２１)",
              "includedInCharge": "true"
            }
          },
          {
            "kind": "ChargeSummary",
            "Oneway": "12490",
            "Round": "24980"
          },
          {
            "fareRevisionStatus": "none",
            "toLineIndex": "1",
            "fromLineIndex": "1",
            "kind": "Charge",
            "index": "1",
            "selected": "true",
            "Name": "指定席",
            "Type": "Reserved",
            "Oneway": {
              "text": "12490",
              "remark": "ＥＸ早特",
              "expectedRemark": "ＥＸ早特２１",
              "fullRemark": "ＥＸ予約(ＥＸ早特)",
              "expectedFullRemark": "ＥＸ予約(ＥＸ早特２１)"
            },
            "RevisionStatus": "latest",
            "Round": {
              "text": "24980",
              "remark": "ＥＸ早特",
              "expectedRemark": "ＥＸ早特２１",
              "fullRemark": "ＥＸ予約(ＥＸ早特)",
              "expectedFullRemark": "ＥＸ予約(ＥＸ早特２１)"
            }
          },
          {
            "fareRevisionStatus": "none",
            "toLineIndex": "1",
            "fromLineIndex": "1",
            "kind": "Charge",
            "index": "2",
            "selected": "false",
            "Name": "指定席(S WorkPシート)",
            "Type": "SWorkPSeat",
            "Oneway": {
              "text": "14490",
              "remark": "ＥＸ早特",
              "expectedRemark": "ＥＸ早特２１",
              "fullRemark": "ＥＸ予約(ＥＸ早特)",
              "expectedFullRemark": "ＥＸ予約(ＥＸ早特２１)"
            },
            "RevisionStatus": "latest",
            "Round": {
              "text": "28980",
              "remark": "ＥＸ早特",
              "expectedRemark": "ＥＸ早特２１",
              "fullRemark": "ＥＸ予約(ＥＸ早特)",
              "expectedFullRemark": "ＥＸ予約(ＥＸ早特２１)"
            }
          },
          {
            "fareRevisionStatus": "none",
            "toLineIndex": "1",
            "fromLineIndex": "1",
            "kind": "Charge",
            "index": "3",
            "selected": "false",
            "Name": "グリーン",
            "Type": "Green",
            "Oneway": {
              "text": "14670",
              "remark": "ＥＸ早特",
              "expectedRemark": "ＥＸ早特２１",
              "fullRemark": "ＥＸ予約(ＥＸ早特)",
              "expectedFullRemark": "ＥＸ予約(ＥＸ早特２１)"
            },
            "RevisionStatus": "latest",
            "Round": {
              "text": "29340",
              "remark": "ＥＸ早特",
              "expectedRemark": "ＥＸ早特２１",
              "fullRemark": "ＥＸ予約(ＥＸ早特)",
              "expectedFullRemark": "ＥＸ予約(ＥＸ早特２１)"
            }
          }
        ],
        "Route": {
          "Line": [
            {
              "Name": "ＪＲ新幹線ひかり",
              // ...
            }
          ],
          // ...
        }
      },
      // ...
    ]
  }
}

運賃が料金に含まれる場合​

EX予約/スマートEXは、運賃と料金が一体型となったサービスです（e特急券を除く）。
「mixway API」では、EX予約/スマートEXの対象区間の運賃は0円となり、運賃を料金に含める形で表現します。

新宿-東京間の運賃(200円)と、東京-新大阪間のEX予約/スマートEXの料金(11000円)に分けて計算される。EX予約/スマートEXの対象区間の運賃は料金に含まれている。


以下は、探索条件で「ＥＸ予約(ＥＸ早特２１)」を指定し、「ＥＸ予約(ＥＸ早特２１)」が適用されたレスポンス例になります。

GET /v1/json/search/course/extreme?key=アクセスキーを入力してください&viaList=22741:25978&searchType=departure&time=0600&conditionDetail=T3221233232319:F332112212040:A23121141:
{
  "ResultSet": {
    "apiVersion": "1.27.0.0",
    "engineVersion": "202507_01a",
    "Course": [
      {
        "Price": [
          {
            "kind": "FareSummary",
            "Oneway": "210",
            "Round": "420"
          },
          // EX予約/スマートEXの対象でない区間は所定の運賃となります。
          {
            "fareRevisionStatus": "none",
            "toLineIndex": "1",
            "fromLineIndex": "1",
            "kind": "Fare",
            "index": "1",
            "selected": "true",
            "Type": "Fare",
            "Oneway": "210",
            "RevisionStatus": "latest",
            "Round": "420"
          },
          // EX予約/スマートEXが適用された区間の運賃は0円となり、運賃が料金に含まれることを表す`includedInCharge: "true"`を返します。
          {
            "fareRevisionStatus": "none",
            "toLineIndex": "2",
            "fromLineIndex": "2",
            "kind": "Fare",
            "index": "2",
            "selected": "true",
            "Type": "Fare",
            "Oneway": {
              "text": "0",
              "remark": "ＥＸ早特２１",
              "fullRemark": "ＥＸ予約(ＥＸ早特２１)",
              "includedInCharge": "true"
            },
            "RevisionStatus": "latest",
            "Round": {
              "text": "0",
              "remark": "ＥＸ早特２１",
              "fullRemark": "ＥＸ予約(ＥＸ早特２１)",
              "includedInCharge": "true"
            }
          },
          {
            "kind": "ChargeSummary",
            "Oneway": "12980",
            "Round": "25960"
          },
          // EX予約/スマートEXが適用された区間の料金は、運賃が含まれた金額になります。
          {
            "fareRevisionStatus": "none",
            "toLineIndex": "2",
            "fromLineIndex": "2",
            "kind": "Charge",
            "index": "1",
            "selected": "true",
            "Name": "指定席",
            "Type": "Reserved",
            "Oneway": {
              "text": "12980",
              "remark": "ＥＸ早特２１",
              "fullRemark": "ＥＸ予約(ＥＸ早特２１)"
            },
            "RevisionStatus": "latest",
            "Round": {
              "text": "25960",
              "remark": "ＥＸ早特２１",
              "fullRemark": "ＥＸ予約(ＥＸ早特２１)"
            }
          },
          // ...
        ],
        "Route": {
          "Line": [
            {
              "Name": "ＪＲ山手線内回り・渋谷・品川方面",
              // ...
            },
            {
              "Name": "ＪＲ新幹線のぞみ",
              // ...
            }
          ],
          // ...
        }
      },
      // ...
    ]
  }
}

運賃が料金に含まれない場合​

「ＥＸ予約(ｅ特急券)」は特急券のみの割引となるため、運賃は所定の金額となり、料金は割引が適用された特急券の金額となります。

新宿-新大阪間の運賃と、東京-新大阪間の特急料金に分けて計算される。ＥＸ予約(ｅ特急券)区間の運賃は料金に含まれない。


以下は、探索条件で「ＥＸ予約(ｅ特急券)」を指定し、「ＥＸ予約(ｅ特急券)」が適用されたレスポンス例になります。

GET /v1/json/search/course/extreme?key=アクセスキーを入力してください&viaList=22741:25978&searchType=departure&time=0600&conditionDetail=T3221233232319:F332112212020:A23121141:
{
  "ResultSet": {
    "apiVersion": "1.27.0.0",
    "engineVersion": "202507_01a",
    "Course": [
      {
        "Price": [
          // ...
          // ｅ特急券が適用された区間は、所定の運賃を返します。
          {
            "fareRevisionStatus": "none",
            "toLineIndex": "2",
            "fromLineIndex": "1",
            "kind": "Fare",
            "index": "1",
            "selected": "true",
            "Type": "Fare",
            "Oneway": "8910",
            "RevisionStatus": "latest",
            "Round": "17820"
          },
          // ｅ特急券が適用された区間の料金は、ｅ特急券の割引が適用されたｅ特急のみの金額になります。
          {
            "fareRevisionStatus": "none",
            "toLineIndex": "2",
            "fromLineIndex": "2",
            "kind": "Charge",
            "index": "1",
            "selected": "false",
            "Name": "指定席",
            "Type": "Reserved",
            "Oneway": {
              "text": "5120",
              "remark": "ｅ特急券",
              "fullRemark": "ＥＸ予約(ｅ特急券)"
            },
            "RevisionStatus": "latest",
            "Round": {
              "text": "10240",
              "remark": "ｅ特急券",
              "fullRemark": "ＥＸ予約(ｅ特急券)"
            },
            "Rate": {
              "text": "Low",
              "area": "Main"
            }
          },
          // ...
        ],
        "Route": {
          "Line": [
            {
              "Name": "ＪＲ山手線内回り・渋谷・品川方面",
              // ...
            },
            {
              "Name": "ＪＲ新幹線のぞみ",
              // ...
            }
          ],
          // ...
        }
      },
      // ...
    ]
  }
}