• 130
  • 1241
  • 57

携程酒店

携程 企业专用

携程酒店信息查询,在线预订和支付下单,正式使用需要缴纳¥5000保证金,(!注post内容是json串如{"Key":"appkey"}而不是Key=appkey,建议使用浏览器插件测试,如火狐的HttpReqeuster, 谷歌的DHC)

  • API文档
  • 错误码参照
  • 示例代码
  • 联系我们
立即调用
接口地址:http://api2.juheapi.com/xiecheng/hotel/plan
返回格式:json
请求方式:post(application/json; utf-8)
请求示例:http://api2.juheapi.com/xiecheng/hotel/plan
接口备注:查询酒店价格计划

请求参数说明:

名称 必填 类型 说明
  Key string juhe appkey
  HotelCodes list 要查询的酒店id列表
  Start string 起始日期, 格式: "yyyy-MM-dd HH:mm:ss"
  End string 结束日期, 格式: "yyyy-MM-dd HH:mm:ss"

返回参数说明:

名称 类型 说明
  error_code string 返回码
  reason string 返回码说明
  result obj 国家列表

JSON返回示例:

{
  "error_code": "200",
  "reason": "请求成功",
  "result": [
    {
      // 预订规则列表
      "BookingRules": "",
      "Description": {
        "Name": "家庭房(预付)"
      },
      "HotelCode": "1064882",
      // 市场代码
      "IsCommissionable": "false",
      // 市场代码
      "MarketCode": "63",
      "Offers": "",
      // 价格计划类型代码
      "RatePlanCategory": "501",
      // 价格计划代码
      "RatePlanCode": "5837868",
      "RateReturn": "false",
      "Rates": [
        {
          // 价格结束时间
          "End": "2015-3-1 0:00:00",
          "IsInstantConfirm": "false",
          // 价格开始时间
          "Start": "2015-3-1 0:00:00",
          // open可售状态,onrequest 房源紧张,close表示不可售
          "Status": "Open",
          // 按客人数量的基础价格列表
          "BaseByGuestAmts": {
            // 按客人数量的基础价格
            "BaseByGuestAmt": {
              "AmountBeforeTax": "698.00",
              "CurrencyCode": "CNY",
              // 门市价
              "ListPrice": "1588.00",
              // 此价格使用与几个客人/房间
              "NumberOfGuests": "2",
              "TPA_Extensions": {
                "OtherCurrency": {
                  // 价格不含税价
                  "AmountPercentType": {
                    "Amount": "698.00",
                    // 币种
                    "CurrencyCode": "CNY"
                  }
                }
              }
            }
          },
          // 取消制度列表
          "CancelPolicies": {
            // 取消制度
            "CancelPenalty": {
              // 结束时间,表示在这个时间段取消是需要扣除罚金,start表示了最迟的取消时间,在这个时间前取消不需要扣除罚金
              "End": "2015-3-2 0:00:00",
              // 开始时间
              "Start": "2015-2-28 12:00:00",
              // 罚金金额=担保金额=当日房价
              "AmountPercent": {
                // 金额
                "Amount": "698.00",
                // 货币代码
                "CurrencyCode": "CNY"
              },
              // 附加信息
              "TPA_Extensions": {
                "OtherCurrency": {
                  "AmountPercentType": {
                    "Amount": "698.00",
                    "CurrencyCode": "CNY"
                  }
                }
              }
            }
          },
          // 额外费用列表:比如宽带费/加床费/加早餐费
          "Fees": {
            // 额外费用信息
            "Fee": [
              {
                // 金额
                "Amount": "150.00",
                // 扣款单位:如每房每晚/每人
                "ChargeUnit": "25",
                // 费用类型代码,参考CodeList(FTT)
                "Code": "38",
                // 币种
                "CurrencyCode": "CNY",
                // 费用描述
                "Description": {
                  "Text": "收费加床"
                },
                "TPA_Extensions": {
                  "OtherCurrency": {
                    "AmountPercentType": {
                      "Amount": "150.00",
                      "CurrencyCode": "CNY"
                    }
                  }
                }
              },
              {
                "Amount": "58.00",
                "ChargeUnit": "21",
                "Code": "1001",
                "CurrencyCode": "CNY",
                "Description": {
                  "Text": "自助餐"
                }
              }
            ]
          },
          // 担保制度列表,担保金额等于当日房价
          "GuaranteePolicies": {
            // 担保制度
            "GuaranteePolicy": {
              // 担保类型代码,参考CodeList(RGC)
              "GuaranteeCode": "3",
              // 在此时间之前不需要担保
              "HoldTime": "18:00:00.0000000+08:00"
            }
          },
          // 餐食信息
          "MealsIncluded": {
            // 是否含早
            "Breakfast": "true",
            // 早餐的数量
            "NumberOfBreakfast": "1"
          },
          // 附加信息
          "TPA_Extensions": {
            "PayChange": "FTP",
            // 促销信息
            "RebatePromotion": {
              // 金额
              "Amount": "70",
              // 活动类型,参考CodeList(RBP)
              "Code": "503",
              // 币种
              "CurrencyCode": "CNY",
              // 结束时间
              "EndPeriod": "2015-12-31",
              // 活动名称
              "ProgramName": "2012年全年消费券返现活动",
              // 开始时间
              "StartPeriod": "2015-01-14",
              // 活动描述
              "Description": {
                "Text": "使用携程消费券成功预订并入住,且完成Email确认,订单成交后3个工作日内将获得70元返现至您的现金账户。"
              }
            }
          }
        }
      ],
      "RestrictedDisplayIndicator": "true",
      // 特定价格计划范围内的酒店可卖产品描述列表,这里特指房型描述
      "SellableProducts": {
        "SellableProduct": {
          "InvCode": "2566247"
        }
      }
    }
  ]
}

服务级错误码参照(error_code):

  错误码 说明

系统级错误码参照:

  错误码 说明 旧版本(resultcode)

错误码格式说明(示例:200201):

  2 002 01
  服务级错误(1为系统级错误) 服务模块代码(即数据ID) 具体错误代码

完整教学代码示例:

  语言 标题 提供者 时间

常见问题:

  内容 详细
  常见问题: http://www.juhe.cn/qa/index/1547809928

联系我们

  内容 详细
  接口测试: API测试工具
  技术支持: info@juhe.cn
  联系电话: 400-882-7715
  在线客服QQ: 800076065

现在注册,百款接口免费测试

免费注册