酒店v2 -介绍

Hotel Services v2 Direct Connect为Travel用户提供了访问酒店库存的方法。

SAP Concur提供的酒店服务2.0 API是基于OTA 2015酒店供应商标准的规范。请参考服务的XSD模式和WSDL服务描述。本指南提供了酒店供应商如何使用酒店服务2.0 API向Concur Travel用户提供其内容的信息。一旦酒店供应商开发并认证了其与SAP Concur的接口，他们的库存将开始出现在opted in Travel用户的酒店搜索中。此API具有客户机/服务器体系结构，其中SAP Concur充当客户机，从酒店供应商那里获取信息，酒店供应商充当服务器，响应SAP Concur的请求。本指南规定了SAP Concur所需的请求和响应格式。

此调用与入站SAP Concur web服务有以下不同之处:

  • 它使用一条外部消息，其中SAP Concur调用酒店供应商提供的面向公众的API端点。
  • 供应商配置和维护公共web服务接口。本指南指定SAP Concur所需的请求和响应格式。

产品限制

SAP Concur产品具有高度可配置性，并非所有客户端都可以访问所有功能。

支持的操作

  • 搜索
  • 可用性
  • 费率详情
  • 酒店描述
  • 预订
  • Read-Itinerary
  • 取消

非功能性需求

有效载荷限制

操作 内容长度最大响应
搜索 1 MB
可用性 5 MB
描述性信息 150 KB
费率详情 5 MB
预订 150 KB
阅读行程表 150 KB
取消 150 KB

超过这些限制的响应将被丢弃并作为错误响应处理。

操作 理想响应时间
搜索 < 4秒
可用性 <10秒
描述性信息 < 1秒
费率详情 < 2秒
预订 <10秒
阅读行程表 < 1秒
取消 <10秒

缩短响应时间有助于更快地向旅行者提供信息，从而带来更好的用户体验。SAP Concur了解，并不是每个酒店计划都管理自己的库存，并要求向其他供应商发送信息，上述数字将此情况考虑在内。

所有端点都有55秒的超时时间。如果出现超时，则没有端点将尝试重试。

SAP Concur对每个端点都进行了监控，如果检测到服务质量显著下降或差异，SAP Concur将向供应商发出通知。

注意：为防止无演出费、重复预订和其他类似问题，SAP Concur建议酒店供应商在向SAP Concur发送HotelResRS消息后5分钟内，如果SAP Concur未发送相应的ReadRQ消息，则自动取消预订。

最大连接和节流

SAP Concur无法共享关于最大连接和/或节流问题的详细信息，这是由于它们本质上的敏感性。

紧急技术联络

酒店供应商需要提供紧急技术联系电子邮件，用于沟通技术问题。

测试环境

为了允许SAP Concur执行测试，酒店供应商需要提供测试URL或在生产URL中指定测试属性。SAP Concur需要能够使用测试信用卡执行测试预订。

安全

PCI DSS合规

由于敏感数据和支付卡细节是通过API传输的，酒店供应商需要遵守PCI DSS标准。SAP Concur符合PCI DSS标准，并接受定期安全审核。

HTTPS

SAP Concur要求文件传输采用TLS 1.2（传输层安全）SSL协议。酒店供应商将提供其端点的SAP Concur HTTPS URL。应使用标准HTTPS端口443。

url

SAP Concur将从酒店供应商那里收到一个URL。所有请求都会转到那个URL。

有关所有必需HTTP标头的详细信息，请参阅标头

SAP Concur使用日期作为xs:date XML类型“2017-05-01”。

处理的HTML

不允许在XML节点和属性中使用CDATA和HTML代码。这些数据将被转义。酒店供应商不应在RatePlanID等ID元素中使用XML特殊字符-预定义的实体：&、<、>、“、”。

消息结构

HS2 API的所有消息都遵循以下结构:

请求

  • 信封
    • 标题
    • 身体
      • 大田_ RQ

注:请求中的Header元素必须包含Authentication元素。

响应

  • 信封
    • 标题
    • 身体
      • 大田_ RS

注:响应中的头不需要身份验证元素。

在这一页上