注意义务
介绍
注意义务(DoC)合作伙伴可获得旅行行程数据。以前,Itinerary API要求合作伙伴对新的或最近更改的行程进行轮询。您现在可以订阅事件并通过ID获取行程,这将提高规模和性能。Itinerary V4 API中的这个事件驱动的GET端点将提供一个可伸缩的解决方案,它允许您获得创建、更新和取消行程的接近实时的更新。
请注意:这种集成和事件驱动的Itinerary V4 API的使用只适用于DoC合作伙伴。
数据范围
将为保存到行程数据存储中的所有行程触发事件。这包括在Concur Travel、TMC线下或直接与TripLink供应商预订的行程。它还包括用户发送到TripIt或plans\@concur.com的计划,以及添加到Concur请求的旅行片段。数据源可以根据来源区分,见枚举类型的引用.
由于一些旅行数据的来源是间接的(例如通过电子邮件解析)或仅表明旅行者的意图,因此记录不完整或充满可疑数据的情况并不罕见。数据客户必须为不完整的记录开发策略,以适合他们的用例。在注意义务服务的情况下,从JFK到LHR的航班没有航班号(或虚假航班号),应被解释为旅客有意在该日期到达伦敦。
快速连接
快速连接描述客户用于将其SAP Concur站点与App Center合作伙伴的企业应用程序连接的身份验证过程。看到快速连接范围文件提供详细信息,指导您完成此所需部件的开发,以便为客户获得公司JWTs。
公司简介(可选)
如果您有兴趣获取从应用程序中心连接到您的应用程序的公司或客户的个人信息,可以使用此API。
事件详细信息
SAP Concur Event Subscription Service (ESS)支持使用合作伙伴的应用程序和webhook来设置订阅。
SAP Concur Partner Enablement团队将确保:
- 范围:
events.topic.read
和travel.itinerary.read
添加到您的应用程序。 - 事件订阅是使用你为主题提供的端点/webhook创建的
public.concur.travel.itinerary
在美国和EMEA数据中心。
当一家公司从app Center连接到您的应用程序时,事件订阅将自动更新为公司ID,并开始根据该公司的行程或旅行活动向合作伙伴发送事件。
以下是可用的不同事件类型:
ItineraryCreated
当新的旅行开始时。ItineraryUpdated
当行程有任何更新时,包括部分行程取消。
请注意:对于trip文档的每次更改,都会触发此事件,并可能导致在几分钟内返回多个事件(因为多个后端进程进行更新),您可以选择以一种合理的方式来处理该事件。
ItineraryCancelled
当旅行预订被取消时。ItineraryDeleted
用于永久删除行程时。
请注意:该行程需要被删除,因为不会有进一步的更新。
ItineraryAnonymized
用于由于GDPR、RTBF和客户端终止请求而匿名旅行。
样本事件
ItineraryCreated / ItineraryUpdated / ItineraryCancelled
{"eventType": "ItineraryCreated", "timeStamp": "2016-01-01T23:01:01.000Z", "topic": "public. concurrent .travel. ";行程”、“correlationId”:“b2fd900a - 5935 - 46 - fc - 8 d29 - 599 de9864e21”、“事实”:{" id ":“51519 e89-2c1d-47ec-bd93-7c4ace9c57e6”,“用户名”:“b7d12989 - 0489 - 471 - 81 cd - 175 f8b78afa5”、“companyId”:“ab83bc5f-f66e-4ce0-9dcc-7dbf0195e061”、“href”:{“v4”:“https://us.api.concursolutions.com/travel/v4/trips/51519e89-2c1d-47ec-bd93-7c4ace9c57e6”}}}
ItineraryDeleted / ItineraryAnonymized
{"id": "51519e89- 21c1d -47ec-bd93-7c4ace9c57e7", "eventType": "ItineraryDeleted| itineraryyanonymized ", "timeStamp": "2016-01-01T23:01:01.000Z", "topic": "public. cancel .travel. "itinerary", "correlationId": "b2fd900a-5935-46fc-8d29-599de9864e21", "facts": {"id": "51519e89- 2cid -47ec-bd93-7c4ace9c57e8", "userId": " b7d1299-0489-471a -81cd-175f8b78afa5", "companyId": "ab83bc5f-f66e-4ce0-9dcc-7dbf0195e061"}}
请注意:对于
ItineraryDeleted
和ItineraryAnonymized
事件没有回调或HREF,因为该行程记录被删除或匿名化,并且不会为行程提供进一步的更新。
免责声明: href可能会发生变化,我们建议不要存储这些值。
行程V4 API
使用公司级令牌和来自事件有效负载的href,使用旅程V4 API获取行程详细信息。
模式和示例API请求和响应可以在下面找到:
枚举类型的引用
预订所有者类型
预订级别上的BookingOwner标识预订来自的系统。
BookingOwner类型 | 描述 |
---|---|
ConcurTravel | 使用Concur Travel创建的预订或直接通过TMC代理预订,并通过GDS发送到SAP Concur解决方案。 |
OpenBookingEmail | 旅行确认邮件发送到plans@concur.com,这是Concur TripLink的一个功能。 |
ConcurConnectAPI | 通过其他预订工具进行预订,并使用SAP Concur API发布。 |
OpenBookingSupplier | Concur TripLink直接在供应商网站和移动应用程序上进行预订,然后使用SAP Concur API发布。 |
TripIt | 旅行确认邮件发送到plans@tripit.com,这是Concur TripLink的一个功能。 |
TravelRequest | 来自Concur Request的旅行计划表明旅行者有意向,但可能还没有实际的预订。 |
旅行状态值
状态类型 | 状态号 |
---|---|
确认 | 0 |
不要错过 | 1 |
撤销 | 2 |
事实上的 | 4 |
VirtualCancelled | 5 |
建议 | 6 |
BookedProposal | 7 |
删除 | 字节最大值 |
航空公司调整类型
电荷类型 | 描述 |
---|---|
V | 无效 |
R | 退款 |
C | 信用 |
一个 | 辅助 |
O | 其他 |
铁路调整类型
描述 | 电荷类型 |
---|---|
退款 | R |
信用 | C |
辅助 | 一个 |
其他 | O |
航空公司收费类型
电荷类型 | 描述 |
---|---|
T | 机票 |
J | 航空公司调整 |
问 | 机票报价 |
米 | 杂项收费秩序 |
一个 | 手动机票 |
R | 铁路付款 |
U | 轨道调整 |
l | 铁路报价 |
常见问题解答
问:当旅行者或供应商做出更改时,是否会自动更新从这个API返回的所有预订?
答:不是。在某些情况下,预订是由旅行者或安排人寄给我们的。当计划改变时,用户必须采取行动更新记录。在Concur Travel中预订的一些直接连接内容可以通过直接调用供应商来更改,在某些情况下,这会导致我们失去对预订的可见性。
问:Concur Travel是否总是在GDS中提供最新信息?
答:一般来说,是的,但是TMC需要确保预订nr采集配置正确,并且预订nr正确记录了所需的数据点。
问:Concur Travel多久从GDS队列导入预订?
答:该流程持续运行,但受到容量的影响。在正常运行期间,GDS的变化可能需要几分钟到几个小时才能反映在Concur Travel中。
问:为什么我看到一个删除事件和一个创建事件在旅行中快速连续出现?
答:由于在Concur Travel内部处理中,行程是由许多来源创建和更新的,所以系统偶尔会删除和创建,而不是更新。
问:我如何为与我们签约的公司获得即将到来的旅行(过去预订的)?
答:App Center合作伙伴应该打开一个案例,当合作伙伴需要某个公司的这些数据时,就可以获得这些信息。
Concur Travel将提供一个JSON文档,其中包含某个公司过去预订的所有即将到来的旅行。这个文档将包含旅行id和URL,以便合作伙伴从这个列表中获取这些旅行,就像他们为预先收到的任何事件所做的那样。
问:为什么我在没有收到create事件的情况下获得旅行的更新事件?
答:有一种可能性是,他们没有得到一个旅行的更新事件的创建事件(例如,在过去创建的旅行)。在这种情况下,最好获取旅行的详细信息,即使在数据存储中不存在旅行id。
Q:处理匿名事件的最佳实践应该是什么?
答:处理匿名化事件的最佳实践是通过获取更新的匿名化行程并在合作伙伴端进行更新来匿名这些行程,前提是这些行程存在于合作伙伴数据存储中,如果它们不属于数据存储的一部分,则不获取行程细节。我们提供可根据客户需求进行配置的数据保留功能。当数据保留策略对合作伙伴数据存储中不存在的旧行程立即生效时,您可能会看到许多匿名事件。
身份V4 API
您可以使用此API获取单个用户的配置信息,如电子邮件、地址、电话号码、组织、成本中心等。
您可以选择以下2个参数选项中的任意一个进行API调用:
用户标识
来自Events有效负载的值。样品请求
得到https://emea.api.concursolutions.com/profile/identity/v4/users/ {userId}
或
UserLoginId
值。样品请求
获取https://emea.api.concursolutions.com/profile/identity/v4/Users?filter=userName eq " {UserLoginId} "
模式和示例API请求和响应可以在下面找到: