此API已被弃用。

合作伙伴和客户使用已弃用API应联系SAP Confur并讨论转移到最新版本。

详情请参阅API生命周期和弃用策略。

当SAP Concur公司中的任何用户更改其SAP Concur帐户或数据的指定功能时，对通知的订阅。目前支持以下事件的通知:行程更改(创建或更新)，旅行简介基本信息更改。

此功能要求合作伙伴与SAP Convur公司的管理用户完成OAuth进程。此资源只能由已选择用户API范围的合作伙伴应用程序访问。

URI

认购：

https://www.concursolutions.com/api/company/v1.0/subscribe

取消订阅:

https://www.concursolutions.com/api/company/v1.0/unsubscribe.

内容类型

应用程序/ xml

运营

更改行程，请邮寄公司通知订阅

描述

当公司中的任何用户添加、修改或取消行程时，向合作伙伴订阅或取消通知。合作伙伴必须通过公司的管理用户通过OAuth获得授权，以访问公司的旅行信息。

邮寄公司通知订阅行程变更申请

头

请求参数

姓名 描述
类型=行程 必需的。订阅的类型。

例子

认购：

https://www.concursolutions.com/api/company/v1.0/subscribe?type=itinerary.

取消订阅:

https://www.concursolutions.com/api/company/v1.0/unsubscribce?type=itinerary.
授权标题

必需的。公司管理用户的带有OAuth令牌的授权头。在SAP Concur中，用户必须具有以下用户角色之一:用于专业的公司管理员或Web服务管理员，或用于标准的管理员。

XML示例请求

文章http://www.concursolutions.com/api/company/v1.0/subscribe?type=itinerary HTTP/1.1授权:OAuth{访问令牌}

邮政公司通知订阅的行程变更响应

通知格式

在应用程序审查期间，通知将被发送到合作伙伴已向SAP Concur注册的Postback URL。对于所有通知类型，合作伙伴只能有一个回发URL。通知将包括类型那oauth_token_key那userid_type.,userid_value.查询参数，指定更新的用户：

https://postbackurl.com?type=itinerary&oaauth_token_key=

计划更改响应模式的公司通知订阅

响应机构将包括一个通知父元素，具有以下子元素。

元素 描述
ObjectType 行程
ObjectURI 对象的URI。开发人员可以使用适当的获取端点ObjectURI以获得旅行的完整细节。
EventDateTime. 事件发生后。格式：YYYY-MM-DDTHH：MM：SS
EventType 改变的类型。格式:CREATE、UPDATE、CANCEL
语境 这还没有使用，但将在未来用于指定行程中的变化。开发人员可以将其与EventType决定如何处理通知。
TripId 旅行的唯一标识符。格式:字符串

成功响应的XML示例

200 OK.

XML通知示例

发布https://www.postbackurl.com?type.=Itinerary＆Oauth_Token_Key.= {oauthtoken}＆userid_type.=login&userid_value=cm@example.com http / 1.1内容类型：应用程序/ XML
<？xml version = " 1.0 " encoding = " utf - 8 " ?><通知>行程< / ObjectType >< ObjectURI >https://www.concursolutions.com/api/travel/trip/v1.1/naIzQJ0y2DBWjCIQOb2SHTsozwBsHDkdP2013 - 02年- 13 - t08:12:35< / EventDateTime >< EventType >创建<上下文/ >naIzQJ0y2DBWjCIQOb2SHTsozwBsHDkdP< / TripId >

邮政公司通知订阅付款变更

描述

当公司付款信息发生变化时，订阅或取消订阅合作伙伴的通知。合作伙伴必须在公司的管理用户使用OAuth接收授权，以访问公司的付款信息形式。

邮递公司通知订阅付款更改请求

头

请求参数

姓名 描述
type = fop. 订阅的类型。必需的。

例子

认购：

https://www.concursolutions.com/api/company/v1.0/subscribe?type=fop

取消订阅:

https://www.concursolutions.com/api/company/v1.0/unsubscribe?type=fop.

头

授权标题

必需的。为所需的SAP Concur用户提供带有OAuth令牌的授权头。该令牌是作为OAuth 2.0 Web流授权流程。

XML示例请求

发布https://www.concursolutions.com/api/company/v1.0/subscribe?type.=fop HTTP/1.1授权:OAuth{访问令牌}

支付后通知订阅的付款方式变更响应

通知格式

在应用程序审查期间，通知将被发送到供应商已向Concur注册的Postback URL。对于所有通知类型，供应商只能有一个回发URL。通知将包括类型和oauth_token_key查询参数，指定更新用户的OAuth信息:

https://postbackurl.com?type=FOP&oauth_token_key= {oauth_token}

成功响应的XML示例

200 OK.

邮寄公司通知订阅旅行资料更改

描述

当公司的旅行简档信息发生变化时，订阅或取消订阅合作伙伴的通知。合作伙伴必须通过公司的管理用户通过OAuth获得授权，以访问公司的旅行信息。

请注意:当用户的旅行简介的任何区域被更新时，Concur将发送通知。这可能包括Travel Profile web服务中不可用的字段。

邮寄公司通知订阅旅行资料更改请求

头

请求参数
姓名 描述
类型=概要 必需的。订阅的类型。

例子

认购：

https://www.concursolutions.com/api/company/v1.0/subscribe?type=profile.

取消订阅:

https://www.concursolutions.com/api/company/v1.0/unsubscribe?type=profile
授权标题

必需的。公司管理用户的带有OAuth令牌的授权头。在SAP Concur中，用户必须具有以下用户角色之一:用于专业的公司管理员或Web服务管理员，或用于标准的管理员。

XML示例请求

文章< https://www.concursolutions.com/api/company/v1.0/subscribe?type=个人资料> http / 1.1授权：OAuth{访问令牌}

邮政公司通知旅行资料的订阅变更响应

通知格式

在应用程序审查期间，通知将被发送到合作伙伴已向SAP Concur注册的Postback URL。对于所有通知类型，合作伙伴只能有一个回发URL。通知将包括类型那oauth_token_key那userid_type.,userid_value.查询参数，指定更新的用户：

https://postbackurl.com?type=profile&oaauth_token_key=

合作伙伴可以使用此信息来获取旅行简介请求。

成功响应的XML示例

200 OK.