发布费用报告工作流程操作

为所提供的费用报告发布工作流操作。工作流操作在工作流过程中移动费用报告。

工作流程操作

可用的行动是：

批准:报告成功完成当前工作流步骤。该报告将继续在工作流中运行，并且可能需要基于配置的额外批准。如果报告处于Processing Payment状态，它将被移动到Paid状态。
笔记：
1. 报告不能从处理付款到支付，直到所有的费用条目都已提取或手动支付。等到提取过程完成报告，然后发送批准工作流程操作。
2. 处理器角色或未执行Processor工作流步骤的费用报告不支持此API。
发送回员工：该报告被发送回员工进行修订。当用户重新提交报告时，它会再次通过整个工作流程。
回想一下员工：此工作流程操作由员工启动，仅在提交报告后可用。由于配置，某些客户端可能无法使用此工作流操作。

警告:在调用此端点之前，调用者必须的“批准状态”ApprovalStatusName在响应中的元素得到报告细节为了确保报告处于工作流程步骤，调用者预期。在任何情况下，呼叫者都应该在没有确定的情况下呼叫此端点而不确定报告，则呼叫者预期的工作流程。

工作流程角色

工作流中的每个工作流程都与工作流角色相关联。专业客户端可以在费用管理员的工作流程区域中配置工作流程步骤和角色。评估OAuth消费者以确定消费者在SAP同意中的作用。如下部分中所述存在两种不同类型的工作流角色。

系统角色

当可以以编程方式完成工作流程操作时使用系统角色。根据客户的业务流程，可以以这种方式完成任何工作流程操作。添加报告工作流程步骤时可以配置工作流角色。有些步骤可能需要系统角色。使用此角色时，OAuth消费者必须具有以下用户角色：

标准/开发人员沙箱:可以管理
专业:公司管理员或Web服务管理员

费用报告所有者必须在系统角色可以更改其报告之前分配给他们的审批人或处理器。

审批人角色

当工作流操作应该由特定的用户完成时，使用Approver角色。当审批人对报告进行评估后，想要呈现报告列表以批准并发送工作流操作的开发人员使用了approver角色。此角色要求具有正确SAP Concur角色(费用审批者、授权审批者、成本对象审批者或专业费用处理器，或标准的可管理或可批准报告角色)的用户在提供工作流操作之前使用标准OAuth进行身份验证。用户还必须具有对所提供的报告ID的访问权限(是一个有效的审批者或处理器)。

请求

请求参数

路径参数

参数	必填/可选	描述
｛WorkflowStepid.} / workflowaction	要求	所需工作流程步骤的标识符和workflowaction关键字。

例子：https://www.concursolutions.com/api/expense/expensereport/v1.1/report/ {workflowstepId} / workflowaction

URI来源：的WorkflowActionURL元素中返回URI得到报告细节响应。

标题

授权头

为有效的SAP Concur用户提供带有OAuth令牌的授权头。必需的。

内容类型标题

应用程序/ XML

要求身体

请求模式

这个请求应该包含一个WorkflowAction具有以下子元素的父元素。

WorkflowAction子元素

元素	必填/可选	描述
行动	要求	工作流程的名称。可能的值是：批准，发送回员工,或回想一下员工．必须是工作流步骤可用的工作流操作之一。咨询费用管理>工作流了解细节。
评论	需要，寄回员工	必须与之使用发送回员工工作流程。此评论可见，无论员工，审批人，授权请求管理员和/或处理器都可以使用报告评论。最大长度：2000

响应模式

这个请求将返回一个ActionStatus具有以下子元素的父元素。

ActionStatus元素

元素	描述
信息	错误消息。仅在生成工作流操作错误时才出现。
状态	报表工作流程操作的状态。

例子

XML示例请求

         帖子https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nx2WRNzp18 wjehk % wqEL6EDHRwi9r paQS1UqyL6a454QitqQ / workflowaction美元HTTP/1.1授权：OAuth{访问令牌}.．. Approve Approved via SAP Concur 
        

XML成功响应的示例

         <？XML Version =“1.0”编码=“UTF-8”？>< ActionStatusXMLNS =“http://www.concursolutions.com/api/expense/expensereport/2011/03”XMLNS：i =“http://www.w3.org/2001/xmlschema-instance”><消息>成功!< >状态成功!> < /状态< / ActionStatus >
        

带有错误的响应的XML示例

         <？XML Version =“1.0”编码=“UTF-8”？>< ActionStatusXMLNS =“http://www.concursolutions.com/api/expense/expensereport/2011/03”XMLNS：i =“http://www.w3.org/2001/xmlschema-instance”><消息>该操作无法执行，因为项目最近已被更改。请刷新列表再试一次。< >状态失败> < /状态< / ActionStatus >
        