此API已被弃用。

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

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

拿到费用报告清单

检索报告列表。此端点可用于查看一个用户的报告，或查看整个公司的最近报告。如果您获取一个用户的报告，则可以查看在OAuth访问令牌中指定的用户拥有的报告。如果您选择获取公司的所有报告，则必须使用LastModified日期查询字符串查看24小时内的报告。您可以提供可选视图来定位搜索结果。如果没有提供视图或日期字符串，Web服务将返回指定用户的所有最新报告。如果是LastModified提供查询字符串，结果不会基于指定的用户过滤。此端点可以支持频繁的请求，其中开发人员跟踪端点被调用的前一个日期/时间，并将其用作下一个请求的日期/时间。

要求

URI

得到https://www.concursolutions.com/api/expense/expensereport/v1.1/ReportsList/ {_View_}

参数

可以使用以下可选报告视图值附加此URI：

价值 描述
最近 返回指定用户过去31天内已修改的所有报告。
活跃的 返回指定用户的所有未订阅的和未付款（未支付付款状态）报告。
UNSUBMITTED 返回指定用户所有未提交的报告。
等待 返回指定用户的所有待处理报告。
批准 返回指定用户的所有批准的报告。
加工过的 返回指定用户的所有已处理的报告。
有薪酬的 返回指定用户的所有付费报告。
付款确认成功 返回指定用户的所有付费报告。
FORTHISMONTH 指定用户将在本月创建日期返回所有报告。
Forlastmonth. 返回指定用户上一个月的所有带有创建日期的报告。
FORTHISQUARTER 通过指定的用户返回在此日历季度的创建日期的所有报告。
forlastquarter. 返回指定用户在上一个日历季度中创建日期的所有报告。
犹太人 通过指定的用户将在今年的创建日期返回所有报告。
FORLASTYEAR 返回指定用户在过去一年中创建日期的所有报告。
批准 返回指定用户尚未批准的所有报告。
批准 返回当月指定用户批准或待批准的所有报告。
赞助莫尼斯 返回当前月份在指定用户批准的所有报告。
APPROVEDTHISQUARTER 返回当前日历季度中指定用户已批准或待批准的所有报告。
APPROVEDLASTQUARTER 返回上一个日历季度中由指定用户批准的所有报告。
APPROVEDTHISYEAR 返回当前日历年度内指定用户批准或待批准的所有报告。
APPROVEDLASTYEAR 返回上一个日历年度中由指定用户批准的所有报告。

该请求可以包含一个可选查询字符串，指定最后修改日期(在协调世界时期报告的AKA UTC）。此查询字符串将在提供的日期后24小时内返回修改后修改的报告。您可以在UTC中提供时间，并且查询将返回具有更大的最后修改日期的报告（最多24小时）或等于提供的时间。提供的日期/时间可以在数据库中的任何时间和数据库中创建的第一个费用报告日期。该格式为日期或日期和时间组合：

/ api /费用/ expensereport / v1.1 reportslist / UNSUBMITTED / LastModified吗?= 2011 - 07 - 06 - t12:23:00日期

或

/ api /费用/ expensereport / v1.1 reportslist / UNSUBMITTED / LastModified吗?日期= 2011-07-06

LastModified查询字符串只支持以下状态:ALL, ACTIVE, UNSUBMITTED, APPROVED, PENDING, PROCESSED, PAID, PAYMENTCONFIRMED, RECENT, TOAPPROVE

笔记：

  • LastModified查询字符串返回所有用户的报告，忽略OAuth访问令牌中指定的用户帐户。
  • 当使用LastModified查询时，ApprovalURL元素不会出现。

头

  • 内容类型application / xml

响应

头

  • 内容类型application / xml

有效载荷

这个请求将返回一个ReportsList具有xmlns版本属性的父元素和a报告ummary.每份报告的子元素。这报告ummary.元素将有以下子元素:

价值 描述
ApprovalURL 用户可以使用的URL登录以批准报告。此元素在请求Toapprove状态时会出现，并且在使用DIOModifed查询时不会出现。此URL仅在公司不使用强制上使用“强制”选项时才工作。
eportName. 报告的名称。
ReportId 报表的唯一标识符，出现在Concur Expense UI中。
reporttotal. 报告的总金额。
ReportCurrency 这3个字母的ISO 4217货币代码对于费用报告货币。
报告日期 报告的创建日期。
持久 关于该报告的最新评论文本。
报告详细信息 - URL 访问报表摘要详细信息的URL。
Report-Full-Details-Url 访问完整报告详细信息的URL。
ExpenseUserXUserID 此报表所属用户的用户ID。
ApproverXUserID 用户费用批准者的用户ID。
员工姓名 费用报告人的姓名。格式:Firstname姓

笔记：

这ApprovalURL提供到Expense的链接，在大多数情况下可与SSO一起使用。可以将链接放入浏览器窗口，然后审批者自动登录到Expense和费用报告将打开如果：

  • 该公司使用支持concurrent的SSO平台(确实如此)不是使用强制选项)和......
  • 审批者目前在公司网络上或正在使用VPN

否则，当批准点击链接时，将显示“费用登录”页面。批准者登录并遵循批准报告的正常步骤。