Property Connector PC Integration API

概述
更新房价
- 请求
- 示例
更新房量
- 请求
- 示例
更新房态和入住限制
- 请求
- 示例
Delta vs Overlay

概述

PC Integration API 采用三种消息类型交换 ARI（房态、房价、房量）数据，所有这些信息都要实现。

更新房价 Update Rate：PMS 推送房价更新。
更新库存 Update Inventory：PMS 推送库存更新。
更新房态、可用性 Update Availability：PMS 推送房态、可用性更新。本接口设计有四个可用性级别。产品级别是必须提供的，其他级别是可选的。请根据 PMS具备的可用性来开发。

注意事项：
① 更新消息的请求从 PMS 推至德比软件，德比软件将返回响应。因为消息在德比软系统中排队。请注意：为了获得最佳性能，德比软件将异步处理相关消息，这些消息按 FIFO 队列中的接收时间顺序处理。如果您在推送过程中遇到任何错误，主要是因为网络问题，请重试您的请求，确保每个 ARI 更新消息都能被正常推送至德比软件。
② 为了优化性能并减少消息字节，德比软件服务器支持 GZIP 压缩格式。将消息推至德比软件时，建议 PMS 的应用程序将消息压缩为 GZIP。使用这种方式时，您需要在 HTTP 请求头中添加 "Content-Encoding: gzip"，以便我们的服务器知道请求消息是以 GZIP 格式发送过来的，并将其自动解码。

更新房价

此 API 用于单个酒店的房型+价格码组合的房价。如果同时修改了多个价格码的房价，您的消息必须分批处理并将其发送到 DerbySoft 以避免过大的单个消息。

POST /pcapigateway/tunnel/{accountId}/rate HTTP/1.1
Authorization: Bearer 53ac07777cdffac2d53000002d698728ce964432d7167596bc005c5fc
Accept-Encoding: gzip
Content-Encoding: gzip
Content-Type: application/json;charset=utf-8

请求

字段	类型	是否必填	描述	评论
hotelId	String	是	酒店代码	/
roomId	String	是	房型代码	/
rateId	String	是	价格代码	/
startDate	Date: yyyy-MM-dd	是	开始日期 - 将在数据库应用更新房价的开始日期	/
endDate	Date: yyyy-MM-dd	是	结束日期 - 将在数据库应用更新房价的结束日期	/
type	Enum -Delta -Overlay	是	Delta: 德比软件仅更新在消息中的房型代码+价格代码组成的产品的房价，并保持数据库中的其他产品房价不变。它通常用于将房价变化推送给德比软件。 Overlay: 德比软件将对数据库执行删除和插入操作。当激活新酒店，它通常用于从 PMS 进行全量更新或手动更新。	详细信息
currencyCode	String	是	货币代码以 ISO 4217 为标准	/
rates	List[rates]	是	/	/
rates/startDate	Date: yyyy-MM-dd	是	开始日期	/
rates/endDate	Date: yyyy-MM-dd	是	结束日期	/
rates/baseByGuestAmts	List[baseByGuestAmt]	是	/	/
baseByGuestAmts /ageQualifyingCode	Integer	是	“8”=儿童 “10” = 成人	/
baseByGuestAmts /numberOfGuests	Integer	是	总人数	/
baseByGuestAmts /amountAfterTax	BigDecimal	否	价格(含税)	税前金额和税后金额少有1个
baseByGuestAmts /amountBeforeTax	BigDecimal	否	价格（不含税费）	税前金额和税后金额少有1个
rates/additionalGuestAmounts	List[additionalGuestAmounts]	否
additionalGuestAmounts/ageQualifyingCode	Integer	是	“8”=儿童 “10” = 成人
additionalGuestAmounts/amountAfterTax	BigDecimal	否	价格(含税)	税前金额和税后金额少有1个
additionalGuestAmounts/amountBeforeTax	BigDecimal	否	价格（不含税费）	税前金额和税后金额少有1个

示例

1.1 更新包含税/服务费的房价

"King"房型+"BARN"价格计划在3/1~3/31的房价有变化，房价包含税/服务费。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "roomId": "King",
  "rateId": "BARN",
  "startDate": "2021-03-01",
  "endDate": "2021-03-31",
  "type": "Delta",
  "currencyCode": "USD",
  "rates": [
    {
      "startDate": "2021-03-01",
      "endDate": "2021-03-31",
      "baseByGuestAmts": [
        {
          "ageQualifyingCode": 10,
          "numberOfGuests": 1,
          "amountAfterTax": 120
        },
        {
          "ageQualifyingCode": 10,
          "numberOfGuests": 2,
          "amountAfterTax": 120
        }
      ]
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
         "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

1.2 更新不含税/服务费的房价

"King"房型+"BAR"价格计划在3/1~3/31的房价有变化，房价不含税/服务费。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "roomId": "King",
  "rateId": "BAR",
  "startDate": "2021-03-01",
  "endDate": "2021-03-31",
  "type": "Delta",
  "currencyCode": "USD",
  "rates": [
    {
      "startDate": "2021-03-01",
      "endDate": "2021-03-31",
      "baseByGuestAmts": [
        {
          "ageQualifyingCode": 10,
          "numberOfGuests": 1,
          "amountBeforeTax": 100
        },
        {
          "ageQualifyingCode": 10,
          "numberOfGuests": 2,
          "amountBeforeTax": 100
        }
      ]
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
         "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

1.3 同时更新包含税/服务费的价格和不含税/服务费的价格

"King"房型+"BAR"价格计划在3/1~3/31的房价有变化，且同时推送包含税/服务费的房价和不含税/服务费的房价。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "roomId": "King",
  "rateId": "BAR",
  "startDate": "2021-03-01",
  "endDate": "2021-03-31",
  "type": "Delta",
  "currencyCode": "USD",
  "rates": [
    {
      "startDate": "2021-03-01",
      "endDate": "2021-03-31",
      "baseByGuestAmts": [
        {
          "ageQualifyingCode": 10,
          "numberOfGuests": 1,
          "amountAfterTax": 132,
          "amountBeforeTax": 120
        },
        {
          "ageQualifyingCode": 10,
          "numberOfGuests": 2,
          "amountAfterTax": 132,
          "amountBeforeTax": 120
        }
      ]
    }
  ]
}
  "hotelId": "FSDH",
  "roomId": "King",
  "rateId": "BAR",
  "startDate": "2021-03-01",
  "endDate": "2021-03-31",
  "type": "Delta",
  "currencyCode": "USD",
  "rates": [
    {
      "startDate": "2021-03-01",
      "endDate": "2021-03-31",
      "baseByGuestAmts": [
        {
          "ageQualifyingCode": 10,
          "numberOfGuests": 1,
          "amountBeforeTax": 100
        },
        {
          "ageQualifyingCode": 10,
          "numberOfGuests": 2,
          "amountBeforeTax": 100
        }
      ]
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
         "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

1.4 更新特定房型（最多3人）的房价

"King"房型（最多3人）+"BARN"价格计划在3/1~3/31的房价有变化，房价以3人为基础，包含税/服务费。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "roomId": "King",
  "rateId": "BARN",
  "startDate": "2021-03-01",
  "endDate": "2021-03-31",
  "type": "Delta",
  "currencyCode": "USD",
  "rates": [
    {
      "startDate": "2021-03-01",
      "endDate": "2021-03-31",
      "baseByGuestAmts": [
        {
          "ageQualifyingCode": 10,
          "numberOfGuests": 1,
          "amountAfterTax": 132
        },
        {
          "ageQualifyingCode": 10,
          "numberOfGuests": 2,
          "amountAfterTax": 132
        },
        {
          "ageQualifyingCode": 10,
          "numberOfGuests": 3,
          "amountAfterTax": 132
        }
      ]
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
         "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

"King"房型（最多3人）+"BARN"价格计划在3/1~3/31的房价有变化，房价根据入住人数而定，包含税/服务费。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "roomId": "King",
  "rateId": "BARN",
  "startDate": "2021-03-01",
  "endDate": "2021-03-31",
  "type": "Delta",
  "currencyCode": "USD",
  "rates": [
    {
      "startDate": "2021-03-01",
      "endDate": "2021-03-31",
      "baseByGuestAmts": [
        {
          "ageQualifyingCode": 10,
          "numberOfGuests": 1,
          "amountAfterTax": 132
        },
        {
          "ageQualifyingCode": 10,
          "numberOfGuests": 2,
          "amountAfterTax": 137.5
        },
        {
          "ageQualifyingCode": 10,
          "numberOfGuests": 3,
          "amountAfterTax": 143
        }
      ]
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
         "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

1.5 更新包含额外住客价格的房价

"King"房型（最多3人）+"BARN"价格计划在3/1~3/31的房价有变化，房价以2人为基础，包含税/服务费，第3人将以额外住客价格收费。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "roomId": "King",
  "rateId": "BARN",
  "startDate": "2021-03-01",
  "endDate": "2021-03-31",
  "type": "Delta",
  "currencyCode": "USD",
  "rates": [
    {
      "startDate": "2021-03-01",
      "endDate": "2021-03-31",
      "baseByGuestAmts": [
        {
          "ageQualifyingCode": 10,
          "numberOfGuests": 1,
          "amountAfterTax": 132
        },
        {
          "ageQualifyingCode": 10,
          "numberOfGuests": 2,
          "amountAfterTax": 132
        }
      ],
      "additionalGuestAmounts": [
        {
          "ageQualifyingCode": 10,
          "amountAfterTax": 7.5
        }
      ]
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
         "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

1.6 全量推送房价

"King"房型+"BARN"价格计划在1/10~2/28和3/1~3/31有2种不同的房价，并全量推送，房价包含税/服务费。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "roomId": "King",
  "rateId": "BARN",
  "startDate": "2021-01-10",
  "endDate": "2021-03-31",
  "type": "Overlay",
  "currencyCode": "USD",
  "rates": [
    {
      "startDate": "2021-01-10",
      "endDate": "2021-02-28",
      "baseByGuestAmts": [
        {
          "ageQualifyingCode": 10,
          "numberOfGuests": 1,
          "amountAfterTax": 120
        },
        {
          "ageQualifyingCode": 10,
          "numberOfGuests": 2,
          "amountAfterTax": 120
        },
        {
          "ageQualifyingCode": 10,
          "numberOfGuests": 3,
          "amountAfterTax": 120
        }
      ]
    },
    {
      "startDate": "2021-03-01",
      "endDate": "2021-03-31",
      "baseByGuestAmts": [
        {
          "ageQualifyingCode": 10,
          "numberOfGuests": 1,
          "amountAfterTax": 130
        },
        {
          "ageQualifyingCode": 10,
          "numberOfGuests": 2,
          "amountAfterTax": 130
        },
        {
          "ageQualifyingCode": 10,
          "numberOfGuests": 3,
          "amountAfterTax": 130
        }
      ]
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
         "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

1.7 清除房价

清除"King"房型+"BAR"价格计划在1/23~2/23的房价。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "roomId": "King",
  "rateId": "BAR",
  "startDate": "2021-01-23",
  "endDate": "2021-02-23",
  "type": "Overlay",
  "currencyCode": "USD",
  "rates": []
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
         "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

更新房量

此 API 用于更新单个酒店的一种房型的房量。如果同时修改多个房型，您的消息必须拆分为批处理并将其发送到德比软件以避免过大的单个消息。

POST /pcapigateway/tunnel/{acountId}/inventory HTTP/1.1
Authorization: Bearer 53ac07777cdffac2d53000002d698728ce964432d7167596bc005c5fc
Accept-Encoding: gzip
Content-Encoding: gzip
Content-Type: application/json;charset=utf-8

请求

字段	类型	是否必填	描述	说明
hotelId	String	是	酒店代码	/
roomId	String	是	房型代码	/
startDate	Date: yyyy-MM-dd	是	开始日期 - 将在数据库应用更新房量的开始日期	/
endDate	Date: yyyy-MM-dd	是	结束日期 - 将在数据库应用更新房量的结束日期	/
type	Enum - Delta - Overlay	是	Delta: 德比软件仅更新消息中房型的房量，并保持数据库中的其他房量不变。它通常用于将房量变化推送给德比。 Overlay: 德比软件将执行删除并插入数据库操作。它通常用于从 PMS 进行全量刷新，例如新酒店激活或手动刷新。	详细信息
inventories	List[DailyInventory]	是	/	/
DailyInventory/startDate	Date: yyyy-MM-dd	是	Start date 开始日期	/
DailyInventory/endDate	Date: yyyy-MM-dd	是	End date 结束日期	/
DailyInventory/availableInvCount	Integer	是	可售房量	/

示例

2.1 更新房量

"King"房型在1/23~1/25和2/3~2/23的房量有变化，其他日期没有变化。

请求

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "hotelId":"FSDH",
    "roomId":"King",
    "startDate":"2021-01-23",
    "endDate":"2021-02-23",
    "type":"Delta",
    "inventories":[
        {
            "startDate":"2021-01-23",
            "endDate":"2021-01-25",
            "availableInvCount":10
        },
        {
            "startDate":"2021-02-03",
            "endDate":"2021-02-23",
            "availableInvCount":50
        }
    ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

2.2 全量房量

"King"房型在1/23~2/20和2/21~2/23价格有2种不同的房量，并全量推送。

请求

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "hotelId":"FSDH",
    "roomId":"King",
    "startDate":"2021-01-23",
    "endDate":"2021-02-23",
    "type":"Overlay",
    "inventories":[
        {
            "startDate":"2021-01-23",
            "endDate":"2021-02-20",
            "availableInvCount":10
        },
        {
            "startDate":"2021-02-21",
            "endDate":"2021-02-23",
            "availableInvCount":50
        }
    ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

2.3 清除指定房型的量

清除"King"房型在1/23~2/23的房量。

请求

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "hotelId":"FSDH",
    "roomId":"King",
    "startDate":"2021-01-23",
    "endDate":"2021-02-23",
    "type":"Overlay",
    "inventories":[]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

更新房态和入住限制

此API用于更新单个酒店的四个级别的房态和入住限制。如果同时修改了多个房态和入住限制，PMS必须将消息拆分为分批处理并发送给德比软件，避免单条消息的内容过大。

POST /pcapigateway/tunnel/{acountId}/availability HTTP/1.1
Authorization: Bearer 53ac07777cdffac2d53000002d698728ce964432d7167596bc005c5fc
Accept-Encoding: gzip
Content-Encoding: gzip
Content-Type: application/json;charset=utf-8

请求

字段	类型	是否必填	描述	说明
hotelId	String	是	酒店代码	/
roomId	String	否	房型代码	/
rateId	String	否	价格代码	/
startDate	Date:yyyy-MM-dd	是	开始日期	/
endDate	Date:yyyy-MM-dd	是	结束日期	包含结束日期
type	Enum - Delta - Overlay	是	Delta: 德比软件仅更新消息中的房态和可用性，并在数据库中保留其他房态和可用性，而无需更改。它通常用于推送房态和可用性变化过德比软件。 Overlay: 德比软件将执行删除并插入数据库操作。它通常用于从 PMS 进行全量刷新，例如新酒店激活或手动刷新。	详细信息
restrictions	List[DailyRestriction]	是	/	/
DailyRestriction/startDate	/	是	/	/
DailyRestriction/endDate	/	是	/	/
DailyRestriction/restriction	Object[Restriction]	/	/	/
Restriction/masterClose	Boolean	是	/	/
Restriction/closedToArrival	Boolean	否	不允许入住,表示是否允许当天到达入住	/
Restriction/closedToDeparture	Boolean	否	不允许离店,表示是否允许当天离店	/
Restriction/maxStayThrough	Integer	否	如果预订的任何部分与具体日期有关，客人可以最多住几晚。默认情况下0表示对此没有限制。	/
Restriction/minStayThrough	Integer	否	如果预订的任何部分与具体日期有关，客人必须停留的最低天数。默认情况下0表示对此没有限制。	/
Restriction/maxStayArrival	Integer	否	限制在某个日期抵店时预订者可以入住的最大入住天数。默认情况下0表示对此没有限制。	/
Restriction/minStayArrival	Integer	否	限制在某个日期抵店时预订者可以入住的最小入住天数。默认情况下0表示对此没有限制。	/
Restriction/maxAdvanceDay	Integer	否	限制在某个日期抵店时预订者提前预订的最大天数。默认情况下0表示对此没有限制。	/
Restriction/minAdvanceDay	Integer	否	限制在某个日期抵店时预订者提前预订的最小天数。默认情况下0表示对此没有限制。	/

可用性级别

酒店级：设置某个预订限制对整个酒店的产品有效。消息中hotelId必填，roomId和rateId为空。如果您的PMS不支持此级别，则可选。
价格级：设置某个预订限制仅针对使用指定价格代码的产品有效。消息中的hotelId和rateId必填，roomId为空。如果您的PMS不支持此级别，则可选。
房型级：设置某个预订限制仅针对指定房型有效。消息中的hotelId和roomId必填，rateId为空。如果您的PMS不支持此级别，则可选。
产品级 (房型代码+价格代码)：设置某个预订限制仅针对指定房型且使用指定价格代码的产品有效。消息中的hotelId、roomId和rateId在消息中都是必填。

注意事项：
德比软件按四个级别分别存储所有可用性，德比软件按四个级别分别存储所有可用性，这种设计是因为一些PMS系统以级别形式管理可用性。请根据您的PMS支持的级别推送。

预订限制	酒店级	价格级	房型级	产品级 (房型代码+价格代码)	计算结果 (产品级实际预订限制)
masterClose	$1	$2	$3	$4	masterClose = $1 \|\| $2 \|\| $3 \|\| $4 (任一级别关房，则关房)
closedToArrival	$1	$2	$3	$4	closedToArrival = $1 \|\| $2 \|\| $3 \|\| $4 (任一级别打开，则打开)
closedToDeparture	$1	$2	$3	$4	closedToDeparture = $1 \|\| $2 \|\| $3 \|\| $4 (任一级别打开，则打开)
maxStayThrough	$1	$2	$3	$4	maxStayThrough = Min($1, $2, $3, $4) (取4个级别的最小值)
minStayThrough	$1	$2	$3	$4	minStayThrough = Max($1, $2, $3, $4) (取4个级别的最大值)
maxStayArrival	$1	$2	$3	$4	maxStayArrival = Min($1, $2, $3, $4) (取4个级别的最小值)
minStayArrival	$1	$2	$3	$4	minStayArrival = Max($1, $2, $3, $4) (取4个级别的最大值)
maxAdvanceDay	$1	$2	$3	$4	maxAdvanceDay = Min($1, $2, $3, $4) (取4个级别的最小值)
minAdvanceDay	$1	$2	$3	$4	minAdvanceDay = Max($1, $2, $3, $4) (取4个级别的最大值)

示例

3.1 更新产品级可用性（关房）

"King"房型+"BAR"价格计划在1/23~1/25的可用性有变化，限制为关房。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "roomId": "King",
  "rateId": "BAR",
  "startDate": "2021-01-23",
  "endDate": "2021-01-25",
  "type": "Delta",
  "restrictions": [
    {
      "startDate": "2021-01-23",
      "endDate": "2021-01-25",
      "restriction": {
        "masterClose": true
      }
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

3.2 更新产品级可用性（开房）

"King"房型+"BAR"价格计划在1/26~1/28的可用性有变化，限制为开房。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "roomId": "King",
  "rateId": "BAR",
  "startDate": "2021-01-26",
  "endDate": "2021-01-28",
  "type": "Delta",
  "restrictions": [
    {
      "startDate": "2021-01-26",
      "endDate": "2021-01-28",
      "restriction": {
        "masterClose": false
      }
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

3.3 更新产品级可用性（不允许入住）

"King"房型+"BAR"价格计划在1/29~1/31的可用性有变化，限制为不允许入住。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "roomId": "King",
  "rateId": "BAR",
  "startDate": "2021-01-29",
  "endDate": "2021-01-31",
  "type": "Delta",
  "restrictions": [
    {
      "startDate": "2021-01-29",
      "endDate": "2021-01-31",
      "restriction": {
        "masterClose": false,
        "closedToArrival": true
      }
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

3.4 更新产品级可用性（不允许离店）

"King"房型+"BAR"价格计划在2/1~2/3的可用性有变化，限制为不允许离店。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "roomId": "King",
  "rateId": "BAR",
  "startDate": "2021-02-01",
  "endDate": "2021-02-03",
  "type": "Delta",
  "restrictions": [
    {
      "startDate": "2021-02-01",
      "endDate": "2021-02-03",
      "restriction": {
        "masterClose": false,
        "closedToDeparture": true
      }
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

3.5 更新产品级可用性（最小连住）

"King"房型+"BAR"价格计划在2/4~2/6的可用性有变化，限制为最小连住3天。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "roomId": "King",
  "rateId": "BAR",
  "startDate": "2021-02-04",
  "endDate": "2021-02-06",
  "type": "Delta",
  "restrictions": [
    {
      "startDate": "2021-02-04",
      "endDate": "2021-02-06",
      "restriction": {
        "masterClose": false,
        "minStayArrival": 3
      }
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

3.6 更新产品级可用性（最多连住）

"King"房型+"BAR"价格计划在2/7~2/9的可用性有变化，限制为最多连住5天。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "roomId": "King",
  "rateId": "BAR",
  "startDate": "2021-02-07",
  "endDate": "2021-02-09",
  "type": "Delta",
  "restrictions": [
    {
      "startDate": "2021-02-07",
      "endDate": "2021-02-09",
      "restriction": {
        "masterClose": false,
        "maxStayArrival": 5
      }
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

3.7 更新产品级可用性（最小入住）

"King"房型+"BAR"价格计划在2/10~2/12的可用性有变化，限制为最小入住3天。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "roomId": "King",
  "rateId": "BAR",
  "startDate": "2021-02-10",
  "endDate": "2021-02-12",
  "type": "Delta",
  "restrictions": [
    {
      "startDate": "2021-02-10",
      "endDate": "2021-02-12",
      "restriction": {
        "masterClose": false,
        "minStayThrough": 3
      }
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

3.8 更新产品级可用性（最多入住）

"King"房型+"BAR"价格计划在2/13~2/15的可用性有变化，限制为最多入住7天。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "roomId": "King",
  "rateId": "BAR",
  "startDate": "2021-02-13",
  "endDate": "2021-02-15",
  "type": "Delta",
  "restrictions": [
    {
      "startDate": "2021-02-13",
      "endDate": "2021-02-15",
      "restriction": {
        "masterClose": false,
        "maxStayThrough": 7
      }
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

3.9 更新产品级可用性（最小提前预订）

"King"房型+"BAR"价格计划在2/16~2/18的可用性有变化，限制为最小提前3天预订。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "roomId": "King",
  "rateId": "BAR",
  "startDate": "2021-02-16",
  "endDate": "2021-02-19",
  "type": "Delta",
  "restrictions": [
    {
      "startDate": "2021-02-16",
      "endDate": "2021-02-19",
      "restriction": {
        "masterClose": false,
        "minAdvanceDay": 3
      }
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

3.10 更新产品级可用性（最大提前预订）

"King"房型+"BAR"价格计划在2/19~2/20的可用性有变化，限制为最大提前5天预订。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "roomId": "King",
  "rateId": "BAR",
  "startDate": "2021-02-19",
  "endDate": "2021-02-20",
  "type": "Delta",
  "restrictions": [
    {
      "startDate": "2021-02-19",
      "endDate": "2021-02-20",
      "restriction": {
        "masterClose": false,
        "maxAdvanceDay": 5
      }
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

3.11 全量更新产品级可用性

"King"房型+"BAR"价格计划在1/23~2/20的可用性进行全量推送。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "roomId": "King",
  "rateId": "BAR",
  "startDate": "2021-01-23",
  "endDate": "2021-02-20",
  "type": "Overlay",
  "restrictions": [
    {
      "startDate": "2021-01-23",
      "endDate": "2021-01-25",
      "restriction": {
        "masterClose": true
      }
    },
    {
      "startDate": "2021-01-26",
      "endDate": "2021-01-28",
      "restriction": {
        "masterClose": false
      }
    },
    {
      "startDate": "2021-01-29",
      "endDate": "2021-01-31",
      "restriction": {
        "masterClose": false,
        "closedToArrival": true
      }
    },
    {
      "startDate": "2021-02-01",
      "endDate": "2021-02-03",
      "restriction": {
        "masterClose": false,
        "closedToDeparture": true
      }
    },
    {
      "startDate": "2021-02-04",
      "endDate": "2021-02-06",
      "restriction": {
        "masterClose": false,
        "minStayArrival": 3
      }
    },
    {
      "startDate": "2021-02-07",
      "endDate": "2021-02-09",
      "restriction": {
        "masterClose": false,
        "maxStayArrival": 5
      }
    },
    {
      "startDate": "2021-02-10",
      "endDate": "2021-02-12",
      "restriction": {
        "masterClose": false,
        "minStayThrough": 3
      }
    },
    {
      "startDate": "2021-02-13",
      "endDate": "2021-02-15",
      "restriction": {
        "masterClose": false,
        "maxStayThrough": 7
      }
    },
    {
      "startDate": "2021-02-16",
      "endDate": "2021-02-18",
      "restriction": {
        "masterClose": false,
        "minAdvanceDay": 3
      }
    },
    {
      "startDate": "2021-02-19",
      "endDate": "2021-02-20",
      "restriction": {
        "masterClose": false,
        "maxAdvanceDay": 5
      }
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

3.12 更新酒店级可用性（关房）

酒店在2/19~2/20的可用性有变化，限制为关房。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "startDate": "2021-02-19",
  "endDate": "2021-02-20",
  "type": "Delta",
  "restrictions": [
    {
      "startDate": "2021-02-19",
      "endDate": "2021-02-20",
      "restriction": {
        "masterClose": true
      }
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

3.13 全量更新酒店级可用性

酒店在1/23~2/23的可用性进行全量推送，其中1/23~1/25和2/22~2/23限制为关房。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "startDate": "2021-01-23",
  "endDate": "2021-02-23",
  "type": "Overlay",
  "restrictions": [
    {
      "startDate": "2021-01-23",
      "endDate": "2021-01-25",
      "restriction": {
        "masterClose": true
      }
    },
    {
      "startDate": "2021-01-26",
      "endDate": "2021-02-21",
      "restriction": {
        "masterClose": false
      }
    },
    {
      "startDate": "2021-02-22",
      "endDate": "2021-02-23",
      "restriction": {
        "masterClose": true
      }
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

3.14 更新房型级可用性（不允许入住）

"King"房型在1/26~1/28的可用性有变化，限制为不允许入住。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "roomId": "King",
  "startDate": "2021-01-26",
  "endDate": "2021-01-28",
  "type": "Delta",
  "restrictions": [
    {
      "startDate": "2021-01-26",
      "endDate": "2021-01-28",
      "restriction": {
        "masterClose": false,
        "closedToArrival": true
      }
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

3.15 全量更新房型级可用性

"King"房型在1/23~2/20的可用性进行全量推送，其中1/26~1/28和2/7~2/8的限制为不允许入住，2/5的限制为关房。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "roomId": "King",
  "startDate": "2021-01-23",
  "endDate": "2021-02-23",
  "type": "Delta",
  "restrictions": [
    {
      "startDate": "2021-01-23",
      "endDate": "2021-01-25",
      "restriction": {
        "masterClose": false
      }
    },
    {
      "startDate": "2021-01-26",
      "endDate": "2021-01-28",
      "restriction": {
        "masterClose": false,
        "closedToArrival": true
      }
    },
    {
      "startDate": "2021-01-29",
      "endDate": "2021-02-04",
      "restriction": {
        "masterClose": false
      }
    },
    {
      "startDate": "2021-02-05",
      "endDate": "2021-02-05",
      "restriction": {
        "masterClose": true
      }
    },
    {
      "startDate": "2021-02-06",
      "endDate": "2021-02-06",
      "restriction": {
        "masterClose": false
      }
    },
    {
      "startDate": "2021-02-07",
      "endDate": "2021-02-08",
      "restriction": {
        "masterClose": false,
        "closedToArrival": true
      }
    },
    {
      "startDate": "2021-02-09",
      "endDate": "2021-02-23",
      "restriction": {
        "masterClose": false
      }
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

3.16 更新价格计划级可用性（最小连住和最大连住）

"BAR"价格计划在2/1~2/10的可用性有变化，限制为最小连住2天和最大连住7天。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "rateId": "BAR",
  "startDate": "2021-02-01",
  "endDate": "2021-02-10",
  "type": "Delta",
  "restrictions": [
    {
      "startDate": "2021-02-01",
      "endDate": "2021-02-10",
      "restriction": {
        "masterClose": false,
        "minStayArrival": 2,
        "maxStayArrival": 7
      }
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

3.17 全量更新价格计划级可用性

"BAR"价格计划在1/23~2/20的可用性进行全量推送，其中2/1~2/10的限制为最小连住2天和最大连住7天。

请求

{
  "header": {
    "echoToken": "25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
    "timeStamp": "2021-01-10T17:09:04.674Z",
    "version": "0.1"
  },
  "hotelId": "FSDH",
  "rateId": "BAR",
  "startDate": "2021-01-23",
  "endDate": "2021-02-23",
  "type": "Delta",
  "restrictions": [
    {
      "startDate": "2021-01-23",
      "endDate": "2021-01-31",
      "restriction": {
        "masterClose": false
      }
    },
    {
      "startDate": "2021-02-01",
      "endDate": "2021-02-10",
      "restriction": {
        "masterClose": false,
        "minStayArrival": 2,
        "maxStayArrival": 7
      }
    },
    {
      "startDate": "2021-02-11",
      "endDate": "2021-02-23",
      "restriction": {
        "masterClose": false
      }
    }
  ]
}

成功响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    }
}

失败响应

{
    "header":{
        "echoToken":"25c8cb40-52a0-449f-8fc9-0187c6f3f19e",
        "timeStamp":"2021-01-10T17:09:04.674Z",
        "version":"0.1"
    },
    "errorCode":"InvalidField",
    "errorMessage":"Invalid token"
}

Delta vs Overlay

PMS和德比软件之间交互ARI 消息有两个主要场景。

Overylay：是PMS 触发的全量更新，比如激活新酒店，或者修复异步问题。在这种情况下，德比将清除在特定日期范围的所有数据并将请求中涉及的信息存储到数据库。
Delta：主要用于从 PMS 接收ARI更改的常规流程。例如，在我们的数据库中有三种产品A, B和C。如果你的PMS用Overlay推送A和D给我们，我们的系统会清理A, B和C，但只存储A和D到数据库中，这样更新后我们只有A和D产品。如果你用Delta推送A和D给我们，我们的系统会更新A并将D插入到数据库中，这样我们的数据库中就有了A, B, C和D。

房价、房量、可用性

概述

更新房价

请求

示例

1.1 更新包含税/服务费的房价

1.2 更新不含税/服务费的房价

1.3 同时更新包含税/服务费的价格和不含税/服务费的价格

1.4 更新特定房型（最多3人）的房价

1.5 更新包含额外住客价格的房价

1.6 全量推送房价

1.7 清除房价

更新房量

请求

示例

2.1 更新房量

2.2 全量房量

2.3 清除指定房型的量

更新房态和入住限制

请求

示例

3.1 更新产品级可用性（关房）

3.2 更新产品级可用性（开房）

3.3 更新产品级可用性（不允许入住）

3.4 更新产品级可用性（不允许离店）

3.5 更新产品级可用性（最小连住）

3.6 更新产品级可用性（最多连住）

3.7 更新产品级可用性（最小入住）

3.8 更新产品级可用性（最多入住）

3.9 更新产品级可用性（最小提前预订）

3.10 更新产品级可用性（最大提前预订）

3.11 全量更新产品级可用性

3.12 更新酒店级可用性（关房）

3.13 全量更新酒店级可用性

3.14 更新房型级可用性（不允许入住）

3.15 全量更新房型级可用性

3.16 更新价格计划级可用性（最小连住和最大连住）

3.17 全量更新价格计划级可用性

Delta vs Overlay