邮轮预订流程

邮轮预订使用 Open API v2。渠道客户端负责行程、舱房和旅客信息的交互,渠道服务端负责请求签名和订单处理。以下接口均为 POST,省略环境域名和版本前缀。

sequenceDiagram
    accTitle: 邮轮预订流程
    accDescr: 查询邮轮行程和票价,选择并锁定舱房,填写旅客信息获取报价,确认后授信下单;放弃时释放锁舱。
    autonumber
    box rgb(235, 247, 243) 渠道方
        participant C as 渠道客户端
        participant S as 渠道服务端
    end
    box rgb(255, 246, 229) YSystem
        participant Y as YSystem 服务端
    end

    C->>S: 查询行程(日期、目的地等)
    S->>Y: /cruise/itinerary/search
    Y-->>S: 行程列表(itineraryId)
    S-->>C: 展示行程
    C->>S: 选择行程,设置出行人数
    S->>Y: /cruise/fares
    Y-->>S: 舱型、票价方案及取消政策
    S-->>C: 展示舱型与票价
    C->>S: 选择舱型和票价方案
    S->>Y: /cruise/cabin/availability
    Y-->>S: 可选舱房
    S-->>C: 展示舱房
    C->>S: 选择舱房(cabinNo)
    S->>Y: /cruise/cabin/hold
    Y-->>S: holdId、expiresAt
    S-->>C: 提示锁舱有效期,填写旅客信息
    C->>S: 提交旅客信息
    S->>Y: /cruise/price
    Y-->>S: priceId、expiresAt、价格明细
    S->>Y: /cruise/cabin/diningOptions
    Y-->>S: 可选用餐安排
    S-->>C: 展示报价、条款和用餐选项
    alt 用户确认预订
        C->>S: 确认价格、旅客及用餐安排
        S->>Y: /cruise/book(priceId、travelers、cabinNo)
        Y->>Y: 校验报价与旅客,创建订单并使用渠道授信
        Y-->>S: 订单或业务错误
        S-->>C: 展示订单状态或失败原因
        opt 订单仍待确认
            S->>Y: /order/search
            Y-->>S: 最新订单与预订结果
            S-->>C: 更新预订状态
        end
    else 用户放弃或更换舱房
        C->>S: 取消当前选择
        S->>Y: /cruise/cabin/release(holdId)
        Y-->>S: 释放结果
        S-->>C: 更新舱房选择状态
    end

接入要点

旅客字段填写

/cruise/price 的 travelers 为旅客数组,每位旅客填写各自的真实信息;/cruise/book 应回传与报价时一致的旅客信息。以下为单个旅客的字段示例,完整请求还需提供 itineraryId、categoryCode、fareCode 等参数:

{
  "firstName": "三",
  "lastName": "张",
  "firstNameEn": "SAN",
  "lastNameEn": "ZHANG",
  "gender": "M",
  "birthday": "1989-01-01",
  "nationality": "CN",
  "telephoneCountryCode": "86",
  "telephone": "13800000000",
  "email": "traveler@example.com"
}

可通过 邮轮 API Demo 体验流程;完整字段见 v2 邮轮接口。