此API已弃用。

使用已弃用API的合作伙伴和客户应该联系SAP Concur,并讨论如何转移到最新版本。

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

Concur公司的参会者。此资源可用于检索Concur公司中的任何参与者的信息,无论他们是私有还是共享的。在未来的版本中,该资源将得到增强,以提供完整的与会者管理功能。

这个API允许开发人员在Concur中管理与会者。与会者资源可用于检索私有与会者或共享与会者的与会者信息。在未来的版本中,Attendee资源将被更新为管理Concur中的所有参与者的附加功能。

Attendee资源用于批量管理与会者,可用于添加、更新或去激活与会者。此资源提供的功能类似于在Concur中导入与会者列表。使用该资源添加的与会者将被添加到“共享与会者列表”中(系统所有,所有用户均可使用)。

产品的限制

Concur产品是高度可配置的,并不是所有客户都可以访问所有特性。

在评审过程之前,合作开发人员必须确定他们的解决方案需要哪些配置。

现有客户端可以使用Concur Advantage Technical Services创建使用其配置的自定义应用程序。

另请参阅

URI

https://www.concursolutions.com/api/expense/v2.0/attendees

资源

让与会者

检索与指定搜索条件匹配的参与者。开发人员可以指定一个或多个外部ID或参与者ID来搜索Expense数据库。

请求

参数

参数 必需的/可选 描述
attendeeID 可选 路径:在Concur中参与者的唯一标识符。该信息在AttendeeID元素的响应得到报告细节函数。
externalid 可选 查询:与会者在Concur之外的唯一标识符。该信息在ExternalID元素的响应得到报告细节函数。最多可以以逗号分隔的列表提供10个外部id。

例子:

https://www.concursolutions.com/apiexpense/v2.0/attendees?externalid= https://www.concursolutions.com/api/expense/v2.0/attendees/ https://www.concursolutions.com/apiexpense/v2.0/attendees?externalid= {attendeeID} {externalID} {externalID1}, {externalID2}, {externalID3}

  • RFC 7235授权-具有OAuth 2.0访问令牌的Concur用户的授权头。必需的。要管理整个公司的数据,与访问令牌关联的Concur帐户必须具有以下角色之一:
    • 专业Web服务管理员
    • 能执行标准。
  • RFC 7231内容类型应用程序/ xmlapplication / json

获取与会者详情响应

内容类型

  • application / json
  • 应用程序/ xml

内容的身体

这个请求将返回一个与会者父元素包含出席者子元素。

与会者元素

元素 描述
AttendeeType 与会者的类型。最大40个字符。
FirstName 与会者的名字。最大的50个字符。
与会者的姓。最多132个字符。
公司 与会者的公司名称。最多150个字符。
标题 出席者的头衔。最多32个字符。
ExternalID 与会者的唯一标识符,在Concur之外管理。最大48个字符。
通过Custom20 Custom1 来自自定义字段的详细信息。它们可能没有数据,这取决于配置。有关此父元素的子元素的信息,请参见自定义子元素下面的表。
HasExceptionsPrevYear 参加者在前一年是否有例外,根据每年参加者的总限额。最大1字符。格式:Y / N
HasExceptionsYTD 参加者在本年度是否有例外,根据每年参加者的总限额。最大1字符。格式:Y / N
IsDeleted 与会者是否被删除。最大1字符。格式:Y / N
OwnerEmpName 拥有与会者记录的员工的姓名。
TotalAmountPrevYear 上一历年用于出席者的总金额。
TotalAmountYTD 在本日历年度用于出席者的总金额。
VersionNumber 与会者的版本号。
AttendeeID 与会者在Concur中的唯一标识符。
AttendeeTypeCode 参与者类型的唯一标识符。
AttendeeOwnerID 与会者所属的个人或系统的唯一标识符。
CurrencyCode 3个字母的ISO 4217货币代码与参加者有关的金额。

自定义元素

元素 描述
类型 自定义字段类型。将是下列之一:数量,布尔值,ConnectedList,日期,整数,列表,数字,文本。
价值 自定义字段中的值。最多100个字符。
代码 自定义列表字段将在此元素中包含列表项代码。

例子

带有与会者ID的XML示例请求

得到https://www.concursolutions.com/api/expense/v2.0/attendees/nFaAj0ncBsvkgnPMY5QWfBbbWyvsQh2oW美元授权:OAuth令牌

带有外部ID的XML示例请求

得到https://www.concursolutions.com/api/expense/v2.0/attendees?externalid234567年授权:OAuth令牌

成功响应的XML示例

HTTP/1.1 200 OK内容类型:application/xml
<与会者xmlns =“http://www.concursolutions.com/api/expense/expensereport/2012/07”xmlns:我=“http://www.w3.org/2001/XMLSchema-instance”><出席者>< AttendeeType >BUSGUEST< / AttendeeType ><名>克里斯< / FirstName >< LastName >米勒< / LastName ><公司/><标题/>< ExternalID >234567< / ExternalID >< Custom1/>< Custom2/>< Custom3/>< Custom4/>< Custom5/>< Custom6/>< Custom7/>< Custom8/>< Custom9/>< Custom10/>< Custom11/>< Custom12/>< Custom13/>< Custom14/>< Custom15/>< Custom16/>< Custom17/>< Custom18/>< Custom19/>< Custom20/>< HasExceptionsPrevYear >N< / HasExceptionsPrevYear >< HasExceptionsYTD >N< / HasExceptionsYTD >< IsDeleted >N< / IsDeleted >< OwnerEmpName >戴维斯,帕特< / OwnerEmpName >< TotalAmountPrevYear >0.00000000< / TotalAmountPrevYear >< TotalAmountYTD >0.00000000< / TotalAmountYTD >< VersionNumber >1< / VersionNumber >< AttendeeID >nFaAj0ncBsvkgnPMY5QWfBbbWyv sQh2oW美元< / AttendeeID >< AttendeeTypeCode >BUSGUEST< / AttendeeTypeCode >< AttendeeOwnerID >pd123456< / AttendeeOwnerID >< CurrencyCode >美元< / CurrencyCode >< /与会者>< /与会者>

反应和错误

指的是HTTP规范页以了解常见响应和错误的详细信息。

与会者列表错误

web服务不会为批处理操作返回4xx HTTP响应代码,即使批处理中的每个项目都未能创建或更新。客户必须检查响应,以查找单个批处理项目的警告或错误。

当批处理项出现错误时,前十个错误将在< >错误元素,其中包括错误代码、导致错误的项和错误消息。任何附加的错误消息都会被截断。这可以防止在出现格式化错误时产生大量错误数据。

XML响应错误码

错误代码 消息
1101 找不到参与者批处理元素。
1102 解析与会者记录X时出错
1201 与会者记录缺少外部id
1202 失踪的出席者类型
1203 失踪的货币代码
1204 外部id太长
1205 与会者类型太长
1206 无效活动的价值。
1207 NOSHOWS类型的参与者被忽略。
1208 无效的货币代码
1209 缺少必需字段X
1210 字段X的时间戳无效
1211 X字段的货币或货币价值无效
1212 X字段的金钱或数值无效
1213 字段X的无效整数
1214 字段X的布尔值无效
1215 字段X的字符值无效
1216 字段X的varchar值无效
1217 值对字段X太长
1218 无效的出席者类型
1219 在记录X中为X字段指定了多个值
1221 字段X的代码无效
1222 字段X缺少代码
1301 创建与会者时出现意外错误
1302 更新与会者时出现意外错误
1303 获取与会者类型列表时出现意外错误
1304 处理批处理请求时出现意外错误。
1305 无法为不存在的与会者更新与会者数据。