工作流资源

管理请求的工作流转换。

在审批工作流中移动现有请求

作用域

travelrequest.write-指使用范围全部细节。

HTTP请求

请求资源的操作中列出了给定当前用户和状态的可用操作的HATEOAS链接。

旅行者的行为

  • 提交:启动审批工作流。
  • 回忆:获取请求,通常用于修改内容。
  • 取消:取消请求和附加的行程。
  • :存档请求。
  • 重开:获取已归档的请求。

非旅行者行动(批准人/处理人/外部验证/TMC代理)

  • 批准:将请求移动到下一个批准步骤。
  • 回送:拒绝请求并发送回旅行者。
URI模板
POST{数据中心}/ travelrequest / v4 /请求/ {requestUuid} /{行动}

参数

名称 类型 格式 描述
请求UUID 一串 - 要求请求的唯一标识符。
行动 一串 - 要求要执行的状态转换。支持的值:提交,批准,回忆,回送,取消,重开
议论 一串 - 仅在工作流操作已启动时使用回送. 只要员工、审批人和/或请求管理员可以使用请求注释,此注释就可见。
用户ID 一串 - 执行状态转换的用户的唯一标识符。要求与公司令牌连接时旅行者只有行动。如果为空,则为400missingRequiredParam将显示错误代码。对于非旅行者如果未提供操作,“系统,同意”将显示在请求的审核跟踪中。
companyID 一串 - 公司的唯一标识符。

有效载荷

无,除非工作流操作是回送其中可提交可选意见

{“评论”:“我的评论”}

只要员工、审批人和/或请求管理员可以使用请求注释,此注释就可见。

HTTP响应

HTTP状态代码

要了解有关此API的响应HTTP状态码的更多信息,请参阅旅行请求v4-HTTP状态代码.

有效载荷

要求-具有{requestUuid}作为唯一标识符的请求。

实例

HTTP请求

邮递https://us.api.concursolutions.com/travelrequest/v4/requests/053A479B3C9DD847B02A203C657AE26B/submit 内容类型:application/json Accept:application/json Authorization:Bearer{令牌}

HTTP响应

200行
{“href”:“https://us.api.concursolutions.com/travelrequest/v4/requests/053A479B3C9DD847B02A203C657AE26B”,“id”:“053A479B3C9DD847B02A203C657AE26B”,“approvalStatus”:{“代码”:“提交”,“姓名”:“已提交并待审批”},“批准”:错误的,“商业目的”:“里昂公司培训之旅-修改日期和成本中心+定制场”,“取消后批准”:错误的,“关闭”:错误的,“肌酸盐”:“2018-05-25T09:17:25.000Z”,“客户1”:{“价值”:“IT服务的培训部分”},“客户2”:{“代码”:“CEN1”,“价值”:“54F0CBD8833CB348BD45A6C7C621C951”},“海关3”:{“代码”:“CEN1PRO2”,“价值”:“441D6FC50766A044ACC07FF780F1BAD9”},“海关4”:{“代码”:“培训”,“价值”:“3F54AE68BA66EF49A5984E519720702A4D”},“结束日期”:"2018-07-09",“endTime”:"19:00",“everSentBack”:错误的,“费用”:[{“href”:"https://us.api.concursolutions.com/travelrequest/v4/expenses/47C8AD9E382B5143BB54DC3090577C60",“id”:“47C8AD9E382B5143BB54DC3090577C60”,“模板”:“https://us.api.concursolutions.com/travelrequest/v4/expenses/ {id}”}],“上次修改”:“2018 - 05 - 25 - t09:38:02.000z”,“mainDestination”:{“countryCode”:“FR”,“countrySubDivisionCode”:“fr - 69”,“城市”:“法国里昂”,“姓名”:“法国里昂”},“姓名”:“公司培训-2018年7月”,“所有者”:{“名字”:“约翰。”,“id”:“c0d9894b-98e2-48d5-86f9-1DEDE90DD15”,“姓氏”:“能源部”},“pendingApproval”:真正的,“政策”:{“id”:“F4C8BD31CA9D4292795BE687EB9B2A”},“请求ID”:“333X”,“startDate可以”:“2018-07-07”,“开始时间”:"06:15",“提交日期”:“2018 - 05 - 25 - t09:38:02.000z”,“总批准金额”:{“价值”:123.56,“货币”:“美元”},“totalPostedAmount”:{“价值”:123.56,“货币”:“美元”},“totalRemainingAmount”:{“价值”:123.56,“货币”:“美元”},“旅行社”:{“href”:"https://us.api.concursolutions.com/travelrequest/v4/travelagencies/2EC038D7C3CBBE4ABA0914425064D34F",“id”:“2 ec038d7c3cbbe4aba0914425064d34f”,“模板”:“https://us.api.concursolutions.com/travelrequest/v4/travelagencies/ {id}”},“业务”:[{“rel”:“召回”,“href”:"https://us.api.concursolutions.com/travelrequest/v4/requests/053A479B3C9DD847B02A203C657AE26B/recall"},{“rel”:“取消”,“href”:"https://us.api.concursolutions.com/travelrequest/v4/requests/053A479B3C9DD847B02A203C657AE26B/cancel"}]}