行程审批v1

这个API已经退役。

退休日期:2018/10/08

使用已弃用API的合作伙伴和客户应与SAP Concur联系，讨论迁移到最新版本。

欲知详情，请浏览API生命周期和弃用策略。

Trip Approval资源允许客户端批准或拒绝旅行。客户端发送旅行的唯一标识符、审批人电子邮件和要执行的工作流操作(批准或拒绝)。

资源URI

https://www.concursolutions.com/api/tws/v1.0/TripApproval/DoApproval

支持的内容类型

  • 应用程序/ xml

支持的接受类型

  • 应用程序/ xml

更新行程审批状态

更新指定的行程，由所提供的审批人批准或拒绝。可以提供ItinLocator或RecordLocator值。

请求

POST /api/tws/v1.0/TripApproval/DoApproval HTTPS/1.1主机:www.concursolutions.com授权:OAuth｛访问令牌｝

内容类型

应用程序/ xml

授权头

授权标头必须有一个OAuth令牌，用于有效的concurrent行程审批者。

请求体元素

该请求将包含带有TransactionId属性的TripApprovalRQ父元素。TransactionId值用于标识请求和响应对，可以包含任何不包含特殊字符的字母数字字符串。TripApprovalRQ元素包含以下子元素:

元素 需要吗? 描述
版本 Y web服务的版本。目前1.0。
ItinLocator N 行程服务记录定位器(也称为Itin定位器或行程定位器)。不是GDS记录定位器。如果ItinLocator的值未知，则应该传递RecordLocator元素。
RecordLocator Y，如果ItinLocator没有发送 GDS记录定位器。仅当ItinLocator未知时才应该传递。
ApproverLogin Y 旅行审批人的登录ID。
行动 Y 要采取的工作流操作。支持的值为approve、reject。

响应

响应体元素

该请求将返回带有匹配TransactionId属性的TripApprovalRS父元素。TripApprovalRS元素将包含以下子元素:

元素 需要吗? 描述
版本 Y web服务的版本。目前1.0。
ItinLocator N 行程服务记录定位器(也称为Itin定位器或行程定位器)。不是GDS记录定位器。如果ItinLocator的值未知，则应该传递RecordLocator元素。
RecordLocator Y，如果ItinLocator没有发送 GDS记录定位器。仅当ItinLocator未知时才应该传递。
ApproverLogin Y 旅行审批人的登录ID。
行动 Y 要采取的工作流操作。支持的值为approve、reject。

例子

示例1:在响应成功的情况下更新已批准的旅行

请求
帖子/ api / tws / v1.0 / TripApproval / DoApprovalHTTPS/1．1宿主：www.concursolutions.com授权：OAuth{访问令牌}内容类型：应用程序/ xml.．.< TripApprovalRQTransactionId =“1 cc6ea2d c711 - 409 e - bb51 - 63 b2bdd485fc”><版本>1．0> < /版本< ItinLocator >CQ-BB8-16JED-3ZW< / ItinLocator >< ApproverLogin >cm@example.com< / ApproverLogin ><行动>批准> < /行动< / TripApprovalRQ >
响应
HTTPS/1．1200好吧内容类型：应用程序/ xml< TripApprovalRSTransactionId =“1 cc6ea2d c711 - 409 e - bb51 - 63 b2bdd485fc”><版本>1．0> < /版本< >状态成功> < /状态< / TripApprovalRS >

例2:更新一个已批准但有错误的行程

请求
帖子/ api / tws / v1.0 / TripApproval / DoApprovalHTTPS/1．1宿主：www.concursolutions.com授权：OAuth{访问令牌}内容类型：应用程序/ xml< TripApprovalRQTransactionId =“1 cc6ea2d c711 - 409 e - bb51 - 63 b2bdd485fc”><版本>1．0> < /版本< ItinLocator >CQ-BB8-16JED-3ZW< / ItinLocator >< ApproverLogin >cm@example.com< / ApproverLogin ><行动>批准> < /行动< / TripApprovalRQ >
响应
HTTPS/1．1200好吧内容类型：应用程序/ xml< TripApprovalRSTransactionId =“1 cc6ea2d c711 - 409 e - bb51 - 63 b2bdd485fc”><版本>1．0> < /版本< >状态失败> < /状态<错误代码=“506”>没有为这个ItinLocator或RecordLocator找到tripId。> < /错误< / TripApprovalRS >

错误代码

代码 描述
501 TripId或ItinLocator缺失。
503 ManagerId是必需的。这有时在ApproverLogin无效时返回。
504 必须采取行动。
505 无效操作(必须是批准或拒绝)。
506 没有为这个ItinLocator或RecordLocator找到tripId。
507 没有请求数据。
508 请求数据不是格式良好的XML。
509 XML验证错误。如果可用，将提供XML模式验证错误。
510 未找到TripLocator或RecordLocator
600 在批准旅行时发生错误。
700 拒绝行程时发生错误。

在本页