此资源用于添加预算调整。每个预算项目细节可能有一个或多个预算调整,可以进行调整,以手动添加或减去预算,花费或待定余额。

创建预算调整

创建一个或多个预算调整。

  • 如果使用滚动调整功能,则对给定月份,调整类型,金额类型,预算和描述的所有调整将组合为一个调整。看参数以下。
  • 预算项目名称,财政年度,财政期间名称和所有者电子邮件的组合确定调整影响的预算。看架构以下
  • 金额类型确定调整如何影响预算。预算金额调整减少或增加了顶线预算金额,同时花费和待定金额影响预算余额。
  • 可能无法通过API删除或更新调整。

范围

BudgetItem.write.- 请参阅范围使用有关详细信息。

要求

Uri.

模板
发布/预算/ V4 /调整

参数

名称 类型 格式 描述
veremonthlyrollingupdate 布尔基 询问 必需的如果为true,则给定月份,调整类型,金额类型和描述的所有调整将卷到一次调整。这对于每天或每周更新的自动化进程非常有用,并且不想杂乱最终用户仪表板。

标题

有效载荷

预算调整

回复

状态代码

  • 200 OK.成功呼叫,响应在身体中。
  • 400个糟糕的要求该请求被确定为服务器无效。可能在有效载荷中发送的数据上的验证失败。响应将在身体中有一个验证错误列表。有关示例400响应,请参阅下面。
  • 403禁止用户没有必要的权限来执行请求。
  • 404没有找到无法找到或不存在资源。
  • 500内部服务器错误响应机构中的错误消息。
  • 504网关超时响应机构中的错误消息。

标题

有效载荷

要么是“成功”或错误响应

例子

要求

post https://us.api.concursolutions.com/Budget/v4/Adjustments ?usemonthlyrollingupdate.=错误的授权:持票人{令牌}内容类型:应用程序/ JSON接受:应用程序/ JSON
[{“budgettiptemname”“API Budget-Oregon”“fiscearname”“2018”“budgetowneremail”“m.jones@example.com”“fiscalperiodname”“2018  -  Q3”“数量”100.“调整型”“资金转账”“QuantyType”“预算额”“描述”“初始7月调整”“交易日期”“2018-07-11”},{“budgettiptemname”“API预算旅行”“fiscearname”“2018”“budgetowneremail”“m.jones@example.com”“fiscalperiodname”“2018  -  Q3”“数量”100.“调整型”“费用”“QuantyType”“spent_amount”“交易日期”“2018-07-10”}]

回复

成功响应
HTTP / 1.1 200 OK Cache-Control:No-Store Connection:保持活动内容长度:9内容类型:应用程序/ JSON;Charset.=UTF-8日期:FRI,2018年9月21日15:24:27 GMT到期:星期四,2018年9月20日15:24:27 GMT Pragma:No-Cache不同:Origin Concur-ColrelationID:86A0D9FE-9E98-43C3-89D8-A2917DD844CB
“成功”
失败响应
HTTP / 1.1 400 BAD请求缓存控制:无存储连接:关闭内容长度:242内容类型:应用程序/ JSON;Charset.=UTF-8日期:FRI,21 SEP 2018年9月15:29:05 GMT到期:THU,20 SEP 2018 2018年15:29:05 GMT Pragma:无缓存同意 - 相关性:561CE34C-6542-4BAE-82A2-AA6CCD8C6B22
{“信息”{“地位”错误的“errormessagelist”[{“errortype”“错误”“错误代码”“budget.budget_period_required”“错误信息”“记录1)记录1)预算期缺失”}]}}

架构

预算调整

名称 类型 格式 描述
BudgetTITEMNAME. 细绳 - 必需的调整预算的名称。
fiscearname. 细绳 - 必需的预算的财政年度的名称。财政年度的默认名称是数字,四位数年份。例子:2019年
Fiscalperiodname. 细绳 - 必需的将使用此预算金额的具体财政期间。财政期间的默认名称是:每月:<财政年度> - <三字母的月份缩写>(示例:2019年6月)。季刊:<财政年名称> - Q <季度>(例如:2019 - Q2)。每年:<财政年名称>(例如:2019年)。
Budgetowneremail. 细绳 - 必需的负责预算的用户,如配置。
数量 十进制 - 必需的预算货币金额将进行调整。量可以是正值或负值,但它不能为零。
调整型 细绳 - 必需的正在制作的调整类型。只有一个用户参考字段。支持的值:Budget_Balance.资金转账费用付钱请求采购申请要求
QuantyType. 细绳 - 必需的预算的类型的平衡调整。影响预算中的值更新。支持的值:预算额spent_amount.pending_amount.
描述 细绳 - 用户友好的调整描述。
交易日期 日期 yyyy-mm-dd 如果金额类型是spent_amount或pedending_amount需要调整支出的交易日期。必须在财政期间。

错误响应

名称 类型 格式 描述
地位 布尔基 - 错误的如果出现错误。
artormessagelist. 大批 错误信息 检测到所有错误的列表。

错误信息

名称 类型 格式 描述
纠刊 细绳 - 警告或错误。
错误代码 细绳 - 此错误的文本代码。
错误信息 细绳 - 普通语言错误消息。