此API已被弃用。

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

了解更多内容API生命周期和弃用政策。

笔记:找到较新版本的3.0这里。

费用报告标题包含费用报告的分类信息,并用作费用条目的容器。

资源URI.

https://www.concursolutions.com/api/expense/expensereport/v1.1/Report/

发布费用报告标题

发布用于OAUTH访问令牌中指定的用户的新增或现有报告的费用报告标题信息。如果OAuth消费者具有必要的角色,它们可以更新属于其他用户的报告。使用此函数创建报告,然后使用邮政费用输入功能发送费用线项。

笔记

  • 发布费用报告信息是一个多级过程。
  • 无法修改具有以下状态的报告:
    • 处理付款
    • 有薪酬的
    • 付款确认成功

要求

参数

范围 必填/可选 描述
{_reportid_} 可选的 报告的唯一标识符。仅在更新现有报告时使用。

例子:

https://www.concursolutions.com/api/expense/expensereport/v1.1/report/ {重新}

乌利来源:ReportId值由GOT报告列表返回并获取报告详细信息功能,并作为其中的一部分报告详细信息 - URL此功能返回的元素。

标题

  • 授权 - 具有OAuth令牌的授权标题,用于有效的同意用户。必需的。
  • 内容类型 - 应用程序/ XML

Concur用户必须具有以下任主之一:

  • 费用用户:此角色允许用户创建和修改自己的报告。
  • Web服务管理员(Professional / Premium):此角色允许用户修改所有用户的报告。
  • 可以管理(标准):此角色允许用户修改所有用户的报告。

有效载荷

此请求应包含一个报告具有以下子元素的父元素。

元素 必需(必须包含值)? 描述
名称 y 费用报告名称。
目的 取决于配置 报告的经营宗旨。最大长度:500。
评论 取决于配置 报告标题评论。最大长度:500。
orgunit1通过orgunit6. 取决于配置 自定义组织单位字段。可能需要根据配置。请参阅流程>邮政费用报告数据费用段报告,用于收集必要的现场信息所需的步骤。
Custom1到Custom20. 取决于配置 费用报告标题表单上的自定义字段。可能需要根据配置。请参阅流程>邮政费用报告数据费用段报告,用于收集必要的现场信息所需的步骤。
笔记:如果任何自定义字段配置为包含列表值,请参阅发布自定义列表项页面,了解有关如何正确提交列表项值的信息。
userdefineddate. 取决于配置 用户为报表选择的日期。格式:YYYY-MM-DD HH:MM:SS.0

回复

标题

  • 内容类型 - 应用程序/ XML

有效载荷

响应将包括一个eportDetails.父元素。此元素将包含一个ReportStatus.儿童元素。这ReportStatus.元素将包含以下子元素。

元素 描述
地位 请求的状态。
报告详细信息 - URL 将报告详细信息发布到本报告时使用的URI。

例子

新报表请求的XML示例

https://www.concursolutions.com/api/expense/expensereport/v1.1/report http / 1.1授权:oauth{访问令牌}内容类型:应用程序/ XML
<报告XMLNS =.“http://www.concursolutions.com/api/expense/expensereport/2011/03”>1月份费用<目的>1月份的所有费用<评论>包括客户会议。我们NW.雷德蒙德客户当地的2011-03-26 15:15:07.0

XML成功响应的示例

http / 1.1 200确定内容类型:应用程序/ XML
XMLNS =.“http://www.concursolutions.com/api/expense/expensereport/2011/03”XMLNS:i =“http://www.w3.org/2001/xmlschema-instance”><状态>成功https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nxxkgllnrodp$sie8hq1uvioj2abps7dcp.

发布报告标题批处理请求

发布一批费用报告标题。费用报告标题包含费用报告的分类信息。使用此端点创建一批报告,然后使用邮政费用输入功能发送费用线项。所有批量操作允许每批最多1000个标题。如果发送具有超过1000个标题的批处理请求,则只会处理批处理中的前1000个标题。
笔记:发布费用报告信息是一个多级过程。有关发布新费用报告和条目所需的步骤,请参阅“费用报告Web服务”页面的进程部分。

要求

参数

范围 必填/可选 描述
必需的 批处理关键字。

例子:

https://www.concursolutions.com/api/expense/expensereport/v1.1/report/batch.

标题

  • 授权
  • 内容类型 - 应用程序/ XML

Concur用户必须具有以下任主之一:

  • 费用用户:此角色允许用户创建和修改自己的报告。
  • Web服务管理员(Professional / Premium):此角色允许用户为所有用户创建和修改报告。
  • 可以管理(标准):此角色允许用户为所有用户创建和修改报告。

有效载荷

此请求应包含一个父元素与a报告每个包含的报告的父元素。这报告元素包含以下子元素。

报告元素
元素 必需(必须包含值)? 描述
指数 y 标题在批处理中的位置。应以1开始并按顺序增量。如果出现错误,则使用此值来标识记录。
登录ID y 报告所有者的同意登录ID。
名称 y 费用报告名称。
目的 取决于配置 报告的经营宗旨。最大长度:500。
评论 取决于配置 报告标题评论。最大长度:500。
orgunit1通过orgunit6. 取决于配置 自定义组织单位字段。可能需要根据配置。请参阅流程>邮政费用报告数据费用段报告,用于收集必要的现场信息所需的步骤。
Custom1到Custom20. 取决于配置 费用报告标题表单上的自定义字段。可能需要根据配置。请参阅流程>邮政费用报告数据费用段报告,用于收集必要的现场信息所需的步骤。
笔记:如果配置为包含列表值的任何自定义字段,请参阅发布自定义列表项页面,了解有关如何正确提交列表项值的信息。
userdefineddate. 取决于配置 用户为报表选择的日期。格式:YYYY-MM-DD HH:MM:SS.0

回复

标题

  • 内容类型 - 应用程序/ XML

有效载荷

此请求将返回一个报告 - 批量结果具有以下子元素的父元素。

元素 描述
记录成功 已成功添加的记录数量。
记录 - 失败 未成功添加的记录数量。
错误 这将包含一个错误每个记录失败的父元素。有关的详细信息错误儿童元素,看错误儿童元素下表。
eportDetails. 此父元素将包含一个ReportStatus.所有报告标题的子元素没有导致错误。有关的详细信息ReportStatus.儿童元素,看ReportStatus子元素下表。

错误元素

元素 描述
指数 标题在批处理中的位置
登录ID 用户的同意登录ID。
信息 错误消息。

ReportStatus元素

元素 描述
地位 请求的状态。
报告详细信息 - URL 将报告详细信息发布到本报告时使用的URI。

例子

XML示例请求

post https://www.concursolutions.com/api/expense/expensereport/v1.1/report/batch http / 1.1授权:oauth{访问令牌}内容类型:应用程序/ XML
<批量XMLNS =.“http://www.concursolutions.com/api/expense/expensereport/2011/03”><报告><索引>1cmiller@example.com.1月份费用<目的>1月份的所有费用<评论>包括客户会议。我们NW.雷德蒙德客户当地的2011-01-26 12:15:00.0<报告><索引>2tbrown@example.com.纽约之旅<目的>纽约销售会议<评论> 我们 图森客户偏僻的2011-02-04 15:25:07.0

XML示例响应成功和失败

http / 1.1 200确定内容类型:应用程序/ XML
<报告 - 批量结果XMLNS =.“http://www.concursolutions.com/api/expense/expensereport/2011/03”XMLNS:i =“http://www.w3.org/2001/xmlschema-instance”><记录 - 成功>1<记录失败>1<错误><索引>2tbrown@example.com.无效的值:orgunit2><索引>1<状态>成功https://www.concursolutions.com/api/expense/expensereport/v1.1/nxxkgllnrodp$sie8hq1uvioj2abps7dcp.