预算项目

此资源用于检索和更新关于跨越单个会计年度的预算的信息。每个预算都有多个与财政期间相对应的细节——月、季度或年度预算的单个时期。

获取所有预算项目

检索每组最多50个项目的所有预算项目。由于响应大小和性能考虑，此端点不返回budgetItemDetails．使用获得预算项目检索单个预算的所有细节。

作用域

此API调用需要以下示波器之一：

请求

Uri.

模板
GET / BUDGET / V4 / BUDGETITEMHEADER

参数

的名字 类型 格式 描述
adminView 布尔 查询 如果真正的，返回该实体的所有预算，如果假，只返回当前用户拥有的预算。默认值:假
抵消 整数 查询 页偏移的开始位置。默认值:0.

头

响应

状态码

头

响应头

有效载荷

预算项目标题表

例子

请求

GET https://us.api.concursolutions.com/budget/v4/budgetItemHeader Authorization: bearing {token} Accept: application/json

响应

http./1．1200.好的cache - control：信息= 604800内容类型：application / json日期：2020年7月6日星期三17:33:03Etag：“359670651”到期：2020年7月13日last - modified：星期五，09年8月20日23:54:35 GMT内容长度：1270.concur-correlationid：DD6CEE88-B725-4C06-9EE9-0CA4AE4F16B2
{“totalRows”：122那“抵消”：0.那“限制”：50那“budgetItemHeaders”：[{“名称”：“Marketing-US-Jean诺曼底”那“坚持”：假那“budgetitemstatustystys”：“开放”那“描述”：“营销 - 美国”那“id”：“72 eee673 - 3 - d81 - 49 - c2 - 966 a - b63c7a9302e6”那“costObjects”：[{“代码”：“6”那“fielddefinitionid”：“86 eee673 - 3 - d81 - 49 - c2 - 966 a - b63c7a9302e2”那“价值”：“2”那“listkey”：“1334”那“运营商”：“平等”那“显示名称”：“国家代码”}]，“periodType”：“每年”那“积极的”：真正的那“拥有”：假那“BudgetAmounts”: {“pendingAmount”：1178.37697091那“unExpensedAmount”：2310.73578092那“spendAmount”：35.78378912那“调整下行amount”：0.那“avableamount”：8785.83923997那“unExpensedSettings”：零那“临界点”：“下”那“consumedPercent”：12}，“createdDate”：“2019 - 06 - 26 t17:49:53.102z”那“budgetitemheaderid”：“72 eee673 - 3 - d81 - 49 - c2 - 966 a - b63c7a9302e6”那“budgetName”：“Marketing-US-Jean诺曼底”那“货币代码”：“欧元”那“annualBudget”：10000.00000000那“budgetCategory”: {“名称”：“机票”那“描述”：零那“statusType”：“开放”那“id”：“27451C2D-9121-44BD-B4B0-F2119D2071C7”}，“所有者”: {“externalUserCUUID”：“8002250890004822936”那“employeeUuid”：“210 fe25f e326 - 495 c - 847 a - de333173f616”那“id”：“f779261d - 77 - ce - 4123 - b739 d842ef6f104d”那“名称”：“琼诺曼底”那“电子邮件”：“jean.normandy@xyz.com”那“employeeId”：“jean.normandy”}，“BudgetAppropers”：[{“externalUserCUUID”：“8002250890004822936”那“employeeUuid”：“210 fe25f e326 - 495 c - 847 a - de333173f616”那“id”：“f779261d - 77 - ce - 4123 - b739 d842ef6f104d”那“名称”：“琼诺曼底”那“电子邮件”：“jean.normandy@xyz.com”那“employeeId”：“jean.normandy”}]，“Budget Managers”：[{“externalUserCUUID”：“1563846384638464842”那“employeeUuid”：“13 a13839 - 68 - d6 - 4 - ee8 - 90 - e9 - 58604278 - aa8f”那“id”：“e2bae688 e000 - 464 a - 8728 e1362c94f172”那“名称”：“沃尔特·古普塔”那“电子邮件”：“walter.gupta@xyz.com”那“employeeId”：“walter.gupta”}]，“budgettype”：“personal_use”那“budgetViewers”：[{“externalUserCUUID”：“5005380230004873464”那“employeeUuid”：“EB6082B0-3A9A-4E79-A350-E6E067F34969”那“id”：“7 ce7dfe0 - 6168 - 4 - b93 bb35 - 386 bf023acc6”那“名称”：“丹·李”那“电子邮件”：“dan.lee@xyz.com”那“employeeId”：“dan.lee”}]，“dateRange”：零那“财政年度”: {“名称”：“2017”那“显示名称”：“2017”那“startDate可以”：“2017-01-01”那“endDate”：“2017-12-31”那“状态”：“开放”那“id”：“a4f9d57f——14 - ac - 4 - f03 b5aa - 4256 e5cff790”那“最后修改”：“2017-03-26 20:53:19”那“currentYear”：假}}，{“额外的预算项目标题为简洁删除”：“为简洁起见，删除了额外预算项目的标题”}]，“href”：“https://us.api.concursolutions.com/budget/v1.1/budgetItemHeader/?offset=0”那“下一个”: {“href”：“http://budget -服务- rqa3 budget.us -西方- 2. - nonprod.cnqr.delivery/budget/v1.1/budgetitemheader/?adminview=true&offset=50”}，“以前”：零}

获得预算项目

检索单个预算项目的详细信息。

作用域

此API调用需要以下示波器之一：

请求

Uri.

模板
GET /预算/ v4 / budgetItemHeader /{id}

参数

的名字 类型 格式 描述
id 字符串 uuid 预算项目头的关键字段。

头

响应

状态码

头

响应头

有效载荷

预算项目标题

例子

请求

获取https://us.api.concursolutions.com/budget/v4/budgetitemheader/72eee673-3d81- 49c2-9302e6授权：持票人{token}

响应

http./1．1200.好的cache - control：信息= 604800内容类型：application / json日期：2020年7月6日星期三17:33:03Etag：“359670651”到期：2020年7月13日last - modified：星期五，09年8月20日23:54:35 GMT内容长度：1270.concur-correlationid：cfb55 918 - 06 - a1 - 47 - da - 8 ef1 - 774 a45427af9
{“名称”：“Marketing-US-Jean诺曼底”那“坚持”：假那“budgetitemstatustystys”：“开放”那“描述”：“营销 - 美国”那“id”：“72 eee673 - 3 - d81 - 49 - c2 - 966 a - b63c7a9302e6”那“costObjects”：[{“代码”：“6”那“fielddefinitionid”：“86 eee673 - 3 - d81 - 49 - c2 - 966 a - b63c7a9302e2”那“价值”：“2”那“listkey”：“1334”那“运营商”：“平等”那“显示名称”：“国家代码”}]，“periodType”：“季度”那“积极的”：真正的那“拥有”：假那“BudgetAmounts”: {“pendingAmount”：6870.48165307那“unExpensedAmount”：102126.89000000那“spendAmount”：764.86966050那“调整下行amount”：0.那“avableamount”：2364.64868643那“unExpensedSettings”：零那“临界点”：“下”那“consumedPercent”：76}，“createdDate”：“2019 - 06 - 26 t17:49:53.102z”那“货币代码”：“欧元”那“annualBudget”：10000.00000000那“budgetCategory”：零那“所有者”: {“externalUserCUUID”：“8002250890004822936”那“employeeUuid”：“210 fe25f e326 - 495 c - 847 a - de333173f616”那“id”：“f779261d - 77 - ce - 4123 - b739 d842ef6f104d”那“名称”：“琼诺曼底”那“电子邮件”：“jean.normandy@xyz.com”那“employeeId”：“jean.normandy”}，“BudgetAppropers”：[{“externalUserCUUID”：“8002250890004822936”那“employeeUuid”：“210 fe25f e326 - 495 c - 847 a - de333173f616”那“id”：“f779261d - 77 - ce - 4123 - b739 d842ef6f104d”那“名称”：“琼诺曼底”那“电子邮件”：“jean.normandy@xyz.com”那“employeeId”：“jean.normandy”}]，“Budget Managers”：[{“externalUserCUUID”：“1563846384638464842”那“employeeUuid”：“13 a13839 - 68 - d6 - 4 - ee8 - 90 - e9 - 58604278 - aa8f”那“id”：“e2bae688 e000 - 464 a - 8728 e1362c94f172”那“名称”：“沃尔特·古普塔”那“电子邮件”：“walter.gupta@xyz.com”那“employeeId”：“walter.gupta”}]，“budgettype”：“personal_use”那“budgetViewers”：[{“externalUserCUUID”：“5005380230004873464”那“employeeUuid”：“EB6082B0-3A9A-4E79-A350-E6E067F34969”那“id”：“7 ce7dfe0 - 6168 - 4 - b93 bb35 - 386 bf023acc6”那“名称”：“丹·李”那“电子邮件”：“dan.lee@xyz.com”那“employeeId”：“dan.lee”}]，“budgetItemDetails”：[{“budgetitemheaderid”：“72 eee673 - 3 - d81 - 49 - c2 - 966 a - b63c7a9302e6”那“budgetName”：“Marketing-US-Jean诺曼底”那“货币代码”：“美元”那“数量”：2500.00000000那“id”：“4 c165d40 - 804 f - 4 aaa - b900 a46538537f6a”那“budgetItemDetailStatusType”：“开放”那“BudgetAmounts”: {“pendingAmount”：6870.48165307那“unExpensedAmount”：102126.89000000那“spendAmount”：764.86966050那“调整下行amount”：0.那“avableamount”：-5135.35131357那“unExpensedSettings”：零那“consumedPercent”：305那“临界点”：“在”}，“detaildashboardbudgetItemadjustmentdtos”：[{“adjustmentType”：“BUDGET_BALANCE”那“数量”：0.那“QuantyType”：“QUICK_EXPENSE”那“描述”：“字符串”那“交易日期”：“2019-06-26”}]，“fiscalperiod”: {“名称”：“2017 - Q1”那“fiscalPeriodStatus”：“开放”那“id”：“b9659f8a - 4 - e74 - 4531 - 9 - e23 - 1222 ab1507f2”那“periodType”：“季度”那“startDate可以”：“2017-01-01”那“endDate”：“2017-03-31”那“spendDate”：零那“fiscalYearId”：“bcb41c95 - 2 d53 - 4 - a1a - 830 f - 7 - c6b01fa79da”那“现时阶段”：假}，“budgetitembalances”：[{“featureTypeCode”：“PURCHASE_REQUEST”那“featureTypeSubCode”：“没有”那“workflowState”：“提交”那“数量”：6870.48165307那“id”：“十一cb732e - cbc4 - 41 - cb - 82 - 162 d632d5499”}，{“featureTypeCode”：“费用”那“featureTypeSubCode”：“没有”那“workflowState”：“支付”那“数量”：764.86966050那“id”：“0 f09cc65 b879 - 4969 a8a1 - 9 dd52c96486d”}，{“featureTypeCode”：“费用”那“featureTypeSubCode”：“Ereeceipts”那“workflowState”：“UNSUBMITTED”那“数量”：102126.89000000那“id”：“27 c49c8a - c24d - 42 - eb - b089 - 84268350 - ae03”}]}，{“budgetitemheaderid”：“72 eee673 - 3 - d81 - 49 - c2 - 966 a - b63c7a9302e6”那“budgetName”：“Marketing-US-Jean诺曼底”那“货币代码”：“欧元”那“数量”：2500.00000000那“id”：“0A2DC181-389E-4C85-BB57-E4F1A11ACE4E”那“budgetItemDetailStatusType”：“开放”那“BudgetAmounts”: {“pendingAmount”：0.那“unExpensedAmount”：0.那“spendAmount”：0.那“调整下行amount”：0.那“avableamount”：2500.00000000那“unExpensedSettings”：零那“consumedPercent”：0.那“临界点”：“下”}，“detaildashboardbudgetItemadjustmentdtos”：[{“adjustmentType”：“BUDGET_BALANCE”那“数量”：0.那“QuantyType”：“QUICK_EXPENSE”那“描述”：“字符串”那“交易日期”：“2019-06-26”}]，“fiscalperiod”: {“名称”：“2017 - Q2”那“fiscalPeriodStatus”：“开放”那“id”：“590 d4e22-40be-43cc-ac1b-01b0d0263e19”那“periodType”：“季度”那“startDate可以”：“2017-04-01”那“endDate”：“2017-06-30”那“spendDate”：零那“fiscalYearId”：“bcb41c95 - 2 d53 - 4 - a1a - 830 f - 7 - c6b01fa79da”那“现时阶段”：真正的}，“budgetitembalances”: []}，{“为简洁起见，删除了额外的预算项目细节”：“为简洁起见，删除了额外的预算项目细节”}]，“dateRange”：零那“财政年度”: {“名称”：“2017”那“显示名称”：“2017”那“startDate可以”：“2017-01-01”那“endDate”：“2017-12-31”那“状态”：“开放”那“id”：“a4f9d57f——14 - ac - 4 - f03 b5aa - 4256 e5cff790”那“最后修改”：“2017-03-26 20:53:19”那“currentYear”：假那“monthlyFiscalPeriods”：[{“名称”：“2017 -特殊1月”那“fiscalPeriodStatus”：“开放”那“periodType”：“月”那“startDate可以”：“2017-01-01”那“endDate”：“2017-01-31”那“id”：“1929 d1d9 c99 - 6 - 4635 - 9272 - 508364193 - f8f”那“spendDate”：零那“fiscalYearId”：“2 edd7bd4-8f10-46e5-bf52-d553f6c7df80”那“现时阶段”：假}，{“名称”：“2017 -特殊2月”那“fiscalPeriodStatus”：“开放”那“periodType”：“月”那“startDate可以”：“2017-02-01”那“endDate”：“2017-02-28”那“id”：“41AA7452-E52A-4FD6-9C8A-5B199DEADAF”那“spendDate”：零那“fiscalYearId”：“2 edd7bd4-8f10-46e5-bf52-d553f6c7df80”那“现时阶段”：假}，{“名称”：“2017年 - 特别 -  Mar”那“fiscalPeriodStatus”：“开放”那“periodType”：“月”那“startDate可以”：“2017-03-01”那“endDate”：“2017-03-31”那“id”：“6 c7d0b13 - 96 b9 - 4 - d76 a083 d38c96144e2”那“spendDate”：零那“fiscalYearId”：“2 edd7bd4-8f10-46e5-bf52-d553f6c7df80”那“现时阶段”：假}]，“quarterlyFiscalPeriods”：[{“名称”：“2017年 - 特殊 -  Q1”那“fiscalPeriodStatus”：“开放”那“id”：“5 ce25dfd b2b - 4 - 8 -有限元分析- 91 eb - f8f9ad0bb896”那“periodType”：“季度”那“startDate可以”：“2017-01-01”那“endDate”：“2017-03-31”那“spendDate”：零那“fiscalYearId”：“2 edd7bd4-8f10-46e5-bf52-d553f6c7df80”那“现时阶段”：假}，{“名称”：“2017 -特殊Q2”那“fiscalPeriodStatus”：“开放”那“id”：“5 ce25dfd b2b - 4 - 8 -有限元分析- 91 eb - f8f9ad0bb896”那“periodType”：“季度”那“startDate可以”：“2017-04-01”那“endDate”：“2017-06-30”那“spendDate”：零那“fiscalYearId”：“2 edd7bd4-8f10-46e5-bf52-d553f6c7df80”那“现时阶段”：假}，{“名称”：“2017 -特殊的第三季”那“fiscalPeriodStatus”：“开放”那“id”：“5 ce25dfd b2b - 4 - 8 -有限元分析- 91 eb - f8f9ad0bb896”那“periodType”：“季度”那“startDate可以”：“2017-07-01”那“endDate”：“2017-09-30”那“spendDate”：零那“fiscalYearId”：“2 edd7bd4-8f10-46e5-bf52-d553f6c7df80”那“现时阶段”：假}，{“名称”：“2017”——特殊的第四季度那“fiscalPeriodStatus”：“开放”那“id”：“5 ce25dfd b2b - 4 - 8 -有限元分析- 91 eb - f8f9ad0bb896”那“periodType”：“季度”那“startDate可以”：“2017-10-01”那“endDate”：“2017-12-31”那“spendDate”：零那“fiscalYearId”：“2 edd7bd4-8f10-46e5-bf52-d553f6c7df80”那“现时阶段”：假}]，“年度菲尼思亚偶极”：[{“名称”：“2017 -特殊的“那“fiscalPeriodStatus”：“开放”那“id”：“a6bede66 - 4 - f3d - 412 f - a620 2 - a073013cb2a”那“periodType”：“每年”那“startDate可以”：“2017-01-01”那“endDate”：“2017-12-31”那“spendDate”：零那“fiscalYearId”：“2 edd7bd4-8f10-46e5-bf52-d553f6c7df80”那“现时阶段”：假}]，“customFiscalPeriods”: [],}}

提交预算项目

保存新的预算或更新现有的预算。

作用域

budgetitem.write——是指使用范围全部细节。

请求

Uri.

模板
POST /预算/ v4 / budgetItemHeader

参数

N/A

头

有效载荷

预算项目标题

响应

状态码

头

响应头

有效载荷

预算项目反应或错误响应

例子

请求

POST https://us.api.concursolutions.com/budget/v4/budgetItemHeader授权:承载{token}

季度预算的例子

{“名称”：“Marketing-US-Jean诺曼底”那“坚持”：假那“budgetitemstatustystys”：“开放”那“描述”：“营销 - 美国”那“id”：“72 eee673 - 3 - d81 - 49 - c2 - 966 a - b63c7a9302e6”那“costObjects”：[{“fielddefinitionid”：“86 eee673 - 3 - d81 - 49 - c2 - 966 a - b63c7a9302e2”那“代码”：“6”那“价值”：“2”那“listkey”：“1334”那“运营商”：“平等”那“显示名称”：“国家代码”}]，“periodType”：“季度”那“货币代码”：“欧元”那“budgetCategory”: {“id”：“27451C2D-9121-44BD-B4B0-F2119D2071C7”}，“所有者”: {“externalUserCUUID”：“8002250890004822936”那“employeeUuid”：“210 fe25f e326 - 495 c - 847 a - de333173f616”那“电子邮件”：“jean.normandy@xyz.com”那“employeeId”：“jean.normandy”}，“BudgetAppropers”：[{“externalUserCUUID”：“5005380230004873464”那“employeeUuid”：“EB6082B0-3A9A-4E79-A350-E6E067F34969”那“电子邮件”：“dan.lee@xyz.com”那“employeeId”：“dan.lee”}]，“Budget Managers”：[{“externalUserCUUID”：“1563846384638464842”那“employeeUuid”：“13 a13839 - 68 - d6 - 4 - ee8 - 90 - e9 - 58604278 - aa8f”那“电子邮件”：“walter.gupta@xyz.com”那“employeeId”：“walter.gupta”}]，“budgettype”：“personal_use”那“budgetViewers”：[{“externalUserCUUID”：“5005380230004873464”那“employeeUuid”：“EB6082B0-3A9A-4E79-A350-E6E067F34969”那“电子邮件”：“dan.lee@xyz.com”那“employeeId”：“dan.lee”}]，“budgetItemDetails”：[{“budgetitemheaderid”：“72 eee673 - 3 - d81 - 49 - c2 - 966 a - b63c7a9302e6”那“budgetName”：“Marketing-US-Jean诺曼底”那“货币代码”：“欧元”那“数量”：2500.00000000那“id”：“4 c165d40 - 804 f - 4 aaa - b900 a46538537f6a”那“budgetItemDetailStatusType”：“开放”那“fiscalperiod”: {“id”：“b9659f8a - 4 - e74 - 4531 - 9 - e23 - 1222 ab1507f2”}}，{“budgetitemheaderid”：“72 eee673 - 3 - d81 - 49 - c2 - 966 a - b63c7a9302e6”那“budgetName”：“Marketing-US-Jean诺曼底”那“货币代码”：“欧元”那“数量”：2500.00000000那“id”：“0A2DC181-389E-4C85-BB57-E4F1A11ACE4E”那“budgetItemDetailStatusType”：“开放”那“fiscalperiod”: {“id”：“590 d4e22-40be-43cc-ac1b-01b0d0263e19”}}，{“budgetitemheaderid”：“72 eee673 - 3 - d81 - 49 - c2 - 966 a - b63c7a9302e6”那“budgetName”：“Marketing-US-Jean诺曼底”那“货币代码”：“欧元”那“数量”：2500.00000000那“id”：“35 d7dc8a-5ec8-4d5f-ba7c-d9304f7afee3”那“budgetItemDetailStatusType”：“开放”那“fiscalperiod”: {“id”：“09 cd5be1-a21d-47f2-b6b5-8d9019709327”}}，{“budgetitemheaderid”：“72 eee673 - 3 - d81 - 49 - c2 - 966 a - b63c7a9302e6”那“budgetName”：“Marketing-US-Jean诺曼底”那“货币代码”：“欧元”那“数量”：2500.00000000那“id”：“4 ec30f7c - e7fa - 4832 - 9134 - 85 - bed9a85b9c”那“budgetItemDetailStatusType”：“开放”那“fiscalperiod”: {“id”：“c3beec03-a096-4a33-b7af-b49127742702”}}]，“财政年度”: {“id”：“a4f9d57f——14 - ac - 4 - f03 b5aa - 4256 e5cff790”}}

日期范围预算示例

{“名称”：“营销- us - jean诺曼底枣系列”那“坚持”：假那“budgetitemstatustystys”：“开放”那“描述”：“营销 - 美国”那“id”：“72 eee673 - 3 - d81 - 49 - c2 - 966 a - b63c7a9302e6”那“costObjects”：[{“代码”：“6”那“fielddefinitionid”：“86 eee673 - 3 - d81 - 49 - c2 - 966 a - b63c7a9302e2”那“价值”：“2”那“listkey”：“1334”那“运营商”：“平等”那“显示名称”：“国家代码”}]，“periodType”：“DATE_RANGE”那“货币代码”：“欧元”那“budgetCategory”: {“id”：“27451C2D-9121-44BD-B4B0-F2119D2071C7”}，“所有者”: {“externalUserCUUID”：“8002250890004822936”那“employeeUuid”：“210 fe25f e326 - 495 c - 847 a - de333173f616”那“电子邮件”：“jean.normandy@xyz.com”那“employeeId”：“jean.normandy”}，“BudgetAppropers”：[{“externalUserCUUID”：“5005380230004873464”那“employeeUuid”：“EB6082B0-3A9A-4E79-A350-E6E067F34969”那“电子邮件”：“dan.lee@xyz.com”那“employeeId”：“dan.lee”}]，“Budget Managers”：[{“externalUserCUUID”：“1563846384638464842”那“employeeUuid”：“13 a13839 - 68 - d6 - 4 - ee8 - 90 - e9 - 58604278 - aa8f”那“电子邮件”：“walter.gupta@xyz.com”那“employeeId”：“walter.gupta”}]，“budgettype”：“personal_use”那“budgetViewers”：[{“externalUserCUUID”：“5005380230004873464”那“employeeUuid”：“EB6082B0-3A9A-4E79-A350-E6E067F34969”那“电子邮件”：“dan.lee@xyz.com”那“employeeId”：“dan.lee”}]，“budgetItemDetails”：[{“budgetitemheaderid”：“72 eee673 - 3 - d81 - 49 - c2 - 966 a - b63c7a9302e6”那“budgetName”：“Marketing-US-Jean诺曼底”那“货币代码”：“欧元”那“数量”：2500.00000000那“id”：“4 c165d40 - 804 f - 4 aaa - b900 a46538537f6a”那“budgetItemDetailStatusType”：“开放”那“fiscalperiod”: {“id”：“b9659f8a - 4 - e74 - 4531 - 9 - e23 - 1222 ab1507f7”}}]，“财政年度”: {“id”：零}}

响应

成功响应
http./1．1200.好的cache - control：信息= 604800内容类型：application / json日期：2020年7月6日星期三17:33:03Etag：“359670651”到期：2020年7月13日last - modified：星期五，09年8月20日23:54:35 GMT内容长度：97concur-correlationid：809年a0898 e523 - 4114 - 950 - d - bd22705a3b25
{“成功”：真正的那“budgetitemheaderid”：“72 eee673 - 3 - d81 - 49 - c2 - 966 a - b63c7a9302e6”}
故障响应
HTTP / 1.1 400 BAD请求缓存控制：无存储连接：关闭内容长度：459内容类型：应用程序/ JSON;字符集=utf-8 Date: Fri, 21 Sep 2018 15:27:05 GMT Expires: Thu, 20 Sep 2018 15:27:05 GMT Pragma: no-cache concurrent -correlation: cea62849-02e5-4a7f-a576-68280c84bd02
{“状态”：假那“errorMessageList”：[{“errorType”：“错误”那“错误代码”：“预算。预算_ITEM_NAME_REQUIRED"那“错误信息”：“预算项目名称是必需的”}，{“errorType”：“错误”那“错误代码”：“预算。预算_ITEM_NAME_ERROR"那“错误信息”："预算项目名称应超过1个字符"}，{“errorType”：“错误”那“错误代码”：“budget.budget_item_owner_required”那“错误信息”：“预算项目所有者是必需的”}]}

删除预算项目标题

删除一个预算项目。

作用域

budgetitem.write——是指使用范围全部细节。

请求

Uri.

模板
删除/预算/ v4 / budgetItemHeader / {id}

参数

的名字 类型 格式 描述
id 字符串 路径 预算项目头的关键字段。

头

响应

状态码

头

响应头

有效载荷

预算项目反应或错误响应

例子

请求

DELETE https://us.api.concursolutions.com/budget/v4/budgetItemHeader/72eee673-3d81-49c2-966a-b63c7a9302e6授权:承载{token}

响应

HTTP/1.1 200 OK Cache-Control: no-store Connection: keep-alive Content-Length: 97 Content-Type: application/json;字符集=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
{“成功”：真正的那“budgetitemheaderid”：“72 eee673 - 3 - d81 - 49 - c2 - 966 a - b63c7a9302e6”}

模式

PagedBudgetItemHeaderList

的名字 类型 格式 描述
totalRows 整数 - 可用行的总数。
抵消 整数 - 这个结果页的起始行(从零开始)。
限制 整数 - 每页返回的结果数。最大:50
budgetItemHeaders 数组 budgetItemHeader 预算项目标题列表。每个预算项目标题代表一个财政年度的单一预算。
href 字符串 - 该页面结果的链接。
以前的 字符串 href 这href查阅结果的上一页(零如果这是结果的第一页)。
下一个 字符串 href 这href浏览结果的下一页(零如果没有剩下的结果)。

BudgetItemHeader.

的名字 类型 格式 描述
活跃的 布尔 - 只读指示该预算是否应该显示在用户屏幕上。
annualBudget 十进制 - 只读这个预算标题的总预算金额和累积余额。
BudgetAmounts. 数组 BudgetAmounts. 只读本预算的累计预算金额。
Budget Managers. 数组 budgetPerson 如果存在经理，则花费物品如果其中一个经理在提交者的管理员层次结构中或给定的花费物品的批准者中，则符合此预算。
BudgetAppropers. 数组 budgetPerson 工作流批准此预算。
budgetCategory 数组 budgetCategory 这个预算项目的预算类别。如果存在预算类别，支出项目必须匹配预算类别中的一种支出类型，才能匹配该预算。
budgetItemDetails 数组 budgetItemDetail 要求指定会计年度中每个会计期间的预算信息。
budgetitemstatustype. 字符串 - 这个预算项目的现状。支持的值：开放那关闭(本预算不包含任何开支)，删除
budgetType 字符串 - 预算类型指示预算项目是否是个人的。支持的值：PERSONAL_USE那预算那限制
budgetViewers 数组 budgetPerson 可以查看此预算的用户。
Costobjects. 数组 budgetTrackingValue 匹配支出项目的成本对象列表。
createdDate 日期 YYYY-MM-DD 只读创建预算项标头的时间。UTC的日期。
currencyCode 字符串 - 3个字母的ISO 4217货币代码用于预算货币。这是预算金额的货币代码。支出项目使用昨天的收盘价进行转换。例子:美元——美元;强——巴西雷亚尔;计算机辅助设计-加拿大元;瑞士法郎- 瑞士法郎;欧元欧元;GBO- 英镑;港币-港元;印度卢比——印度卢比;麦根——墨西哥比索;nokia-挪威克朗;se——瑞典克朗。
描述 字符串 - 要求这个预算的用户友好的名称。终端用户可在桌面和移动终端上看到此说明。
dateRange dateRange - 只读指定预算的自定义日期范围。
fiscalYear 数组 fiscalYear 要求这个预算的财政年度。属性中只能检索到该财政年度的ID财政年度服务，是创建/更新预算所必需的。
fiscalYearId 字符串 - 此预算的财政年度的唯一标识符。
id 字符串 - 此对象的键。
istest. 布尔 - 预算项目的测试标志。如果真正的，该预算将只匹配测试用户提交的支出。
lastModifiedDate dateRange - 只读最后一次预算项目标题已更新。UTC的日期。
的名字 字符串 - 要求此预算的主办名称。
拥有 字符串 - 只读指示当前用户是否此预算的所有者的标志。
老板 数组 budgetPerson 要求最终对预算负责的用户。
periodType 字符串 - 只读预算明细使用的财政年度内的时期类型。

BudgetItemDetail

的名字 类型 格式 描述
量 十进制 - 要求分配给这个财政期间的预算货币数额。可能是零。
BudgetAmounts. 数组 BudgetAmounts. 只读此预算的累积预算数。
budgetItemBalances 数组 budgetItemBalance 只读显示按产品和工作流程状态划分的预算支出。
budgetItemDetailStatusType 字符串 - 这个预算项目的现状。支持的值：开放那关闭(本预算不包含任何开支)，删除
currencyCode 字符串 - 3个字母的ISO 4217货币代码用于预算货币。例子:美元——美元;强——巴西雷亚尔;计算机辅助设计-加拿大元;瑞士法郎- 瑞士法郎;欧元欧元;GBO- 英镑;港币-港元;印度卢比——印度卢比;麦根——墨西哥比索;nokia-挪威克朗;se——瑞典克朗。
budgetName 字符串 - 只读此预算的面向管理的名称。
budgetItemHeaderId 字符串 - 只读包含此预算项细节的报头的唯一ID。
fiscalPeriod fiscalPeriod - 要求本预算金额的财政期间。只有财政期间的ID，可以从中检索财政年度服务，是创建/更新预算所必需的。
detailDashboardBudgetItemAdjustmentDTOs 数组 detailDashboardBudgetItemAdjustment 只读预算调整清单。
fiscalPeriod 数组 fiscalPeriod 要求该预算金额将被使用的具体财政期间。只有财政期间的ID，可以从中检索财政年度服务，是创建/更新预算所必需的。

BudgetAmounts

的名字 类型 格式 描述
adjustedBudgetAmount 十进制 - 只读根据本预算调整的金额。
availableAmount 十进制 - 只读可用金额累计反对此预算。使用预算设置来确定包含哪些金额以计算可用金额。
consumedPercent 十进制 - 只读预算中被认为已使用的百分比。使用预算设置来确定要包括哪些金额。
pendingamount. 十进制 - 只读待定金额累计反对此预算。
spendAmount 十进制 - 只读用过的金额从这个预算中累积起来。
阈值 字符串 - 只读该预算是否在警报限额以下、等于或超过警报限额但在控制限额以下、或等于或超过控制限额的指标。支持的值：下那警报那在
unExpensedAmount 十进制 - 只读旅行预订，快速费用或电子收据等未拓展项目的数量。
unExpensedSettings 字符串 - 只读该公司的未融合物品的预算设定。适用于公司的所有预算。支持的值：SHOW_UNSUBMITTED_EXPENSES_AS_PENDING那show_unsubmitted_expense_balance.那DO_NOT_SHOW_UNSUBMITTED_EXPENSES

BudgetPerson

提供externalUserCUUID或用户的电子邮件或员工ID以查找此人。

的名字 类型 格式 描述
externalUserCUUID 字符串 - 此用户的唯一标识符。这必须与SAP Confir配置文件服务中的CuuID匹配。
的名字 字符串 - 只读用户的名字。提供了方便。
id 字符串 - 预算服务此用户的唯一标识符。
电子邮件 字符串 - 要查找的人的电子邮件地址。
employeeId 字符串 - 只读要查找的人员的员工ID。
employeeUuid 字符串 - 此用户的唯一标识符。这必须与SAP Concur配置文件服务的UUID匹配。

BudgetCategory

的名字 类型 格式 描述
描述 字符串 - 此预算类别匹配的费用类型列表。
的名字 字符串 - 此类别的面向管理员的名称。
statusType 字符串 - 这一预算类别的现况。支持的值：开放那删除
id 字符串 - 预算类别的唯一标识符。

ExpenseType

的名字 类型 格式 描述
featureetypecode. 字符串 - 要求此费用类型适用于的产品:购买请求、发票(付款请求)、费用或请求。支持的值：PURCHASE_REQUEST那PAYMENT_REQUEST那费用那请求
expenseTypeCode 字符串 - 要求描述费用类型的字母数字代码。(例如:饭菜那AC_CATER）有效的费用类型代码由Get / BudgetCategory / Expensetype方法返回预算类别服务．
的名字 字符串 - 只读此费用类型的名称，如果它映射到SAP Concur产品中设置的费用类型。
id 字符串 - 此对象的预算服务键。

BudgetTrackingValue

的名字 类型 格式 描述
代码 字符串 - 成本对象字段的代码。这可以用来代替fieldDefinitionId，如果填充，它将具有优先级。可以为使用GET All budget tracking fields资源配置的预算跟踪字段找到此值。
价值 字符串 - 成本对象字段的值。该字段的值将被忽略，除非操作符字段为平等的那不等号那INLIST,或NOTINLIST．属性的值可以是一个或多个以逗号分隔的值INLIST或NOTINLIST选择算子。
listKey 字符串 - 在设置预算时，指定listKey这将在SAP Confur列表服务中映射到此列表的值。
操作符 字符串 - 要求匹配此跟踪字段的值时使用的比较。支持的值：平等的那INLIST那ISBLANK那不等号那NOTINLIST那ISNOTBLANK那是真的那ISFALSE那Isnottrue.那Isnotfalse.
fieldDefinitionID 字符串 - 要求此对象的字段定义ID的预算服务键。此值可用于使用GET All budget TrackingFields资源配置的预算跟踪字段。
显示名称 字符串 - 预算字段跟踪名称。

budgetitembalance.

的名字 类型 格式 描述
量 十进制 - 只读余额金额。
featureetypecode. 字符串 - 只读这个天平的产品类型。支持的值：请求那旅行那费用那PAYMENT_REQUEST
featureTypeSubCode 字符串 - 只读此余额的特征类型子代码。支持的值：Quick_expense.那ERECEIPT那CREDIT_CARD那PERSONAL_CARD那旅行那RECEIPT_CAPTURE那BILLING_STATEMENT那手册那没有一个那BUDGET_AMOUNT那spent_amount.那PENDING_AMOUNT那PRE_AUTHORIZED那purge_adjustment.
workflowState 字符串 - 只读支持的值：UNSUBMITTED那UNSUBMITTED_HELD那提交那批准那加工过的那支付．
id 字符串 - 这个特定的预算余额桶的唯一标识符..

FiscalYear

的名字 类型 格式 描述
currentYear 布尔 - 只读如果真正的，这是基于当前日期和时间的当前财政年度。假如果否则。
startDate可以 日期 YYYY-MM-DD 要求本财政年度的开始日期。开始日期和结束日期之间的距离不能超过两年。
endDate 日期 YYYY-MM-DD 要求本财政年度的结束日期。开始日期和结束日期之间的距离不能超过两年。
的名字 约会时间 - 要求本财政年度名称。这一实体必须是唯一的。
状态 字符串 - 要求本财政年度的现况。支持的值：开放那关闭那删除
id 字符串 - 此对象的预算服务键。
lastModified 约会时间 - 只读该对象最后一次更改时的UTC日期和时间。
显示名称 字符串 - 只读会计年度的显示名称。对于日期范围预算项，我们使用此字段显示。
每日担保人 数组 fiscalPeriod 只读本会计年度每月会计期间的清单。财政期间必须完成，填补父财政年度没有重叠。
季度季度季度 数组 fiscalPeriod 只读本财政年度的季度财政期清单。如果不指定此参数，则根据每月提供的“财政周期”自动生成每季度的“财政周期”。
yearlyFiscalPeriods 数组 fiscalPeriod 只读本会计年度的年度会计期间列表。如果不指定此参数，则创建一个周期来填充“财政年度”。
customfiscalperiods. 数组 fiscalPeriod 只读本财政年度的定制财政期间列表。自定义财政周期仅用于api，不会显示在用户预算仪表板上。
openAndClosedFiscalPeriods 数组 fiscalPeriod 只读本财政年度所有财政期间的列表，按状态排序。
Fiscalperiods. 数组 fiscalPeriod 只读本财政年度所有财政期间的清单。
显示名称 字符串 - 只读会计年度的显示名称。对于日期范围预算项，我们使用此字段显示。

FiscalPeriod

的名字 类型 格式 描述
currentPeriod 布尔 - 只读如果真正的，这是基于当前时间的当前财政期间。假如果否则。
startDate可以 日期 YYYY-MM-DD 要求本会计期间的开始日期。必须在母公司的财政年度内。
endDate 日期 YYYY-MM-DD 要求本财政年度的结束日期。必须在母公司的财政年度内。
的名字 字符串 - 要求本财政期间的名称。这一实体必须是唯一的。
fiscalPeriodStatus 字符串 - 要求这个财政期间的状况。支持的值：开放那关闭那删除
periodType 字符串 - 要求财政期间的类型。支持的值：每月那季度那每年那风俗那DATE_RANGE
fiscalYearId 字符串 - 父财政年度的关键为本财政期间。
id 字符串 - 此对象的预算服务键。
spendDate 日期 - 只读如果当前日期在该会计期间的开始日期之后，则该字段显示当前日期。

日期范围

的名字 类型 格式 描述
startDate可以 日期 YYYY-MM-DD 预算的开始日期。
endDate 日期 YYYY-MM-DD 预算的结束日期。

DetailDashboardBudgetItemAdjustment

的名字 类型 格式 描述
adjustmentType 字符串 - 正在进行的调整类型。只有一个用户参考字段。支持的值：BUDGET_BALANCE那FUND_TRANSFER那费用那PAYMENT_REQUEST那PURCHASE_REQUEST那请求那purge_adjustment.
量 十进制 - 调整的金额的值(+/-)。
amountType 字符串 - 字段的数量类型。支持的值：Quick_expense.那ERECEIPT那CREDIT_CARD那PERSONAL_CARD那旅行那RECEIPT_CAPTURE那BILLING_STATEMENT那手册那没有一个那BUDGET_AMOUNT那spent_amount.那PENDING_AMOUNT那PRE_AUTHORIZED那purge_adjustment.
描述 字符串 - 对调整的简要描述。
transactionDate 日期 YYYY-MM-DD 调整支出的交易日期。当调整金额类型时需要。支持的值：spent_amount.那PENDING_AMOUNT

BudgetItemResponse

的名字 类型 格式 描述
成功 布尔 - 真的或假为了成功或失败。
budgetItemHeaderId guid - 创建/更新/删除的预算项目头的键。

错误响应

的名字 类型 格式 描述
状态 布尔 - 假如果有错误。
errorMessageList 数组 errorMessage 检测到的所有错误的列表。

错误消息

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

响应头