跳到主要内容

提交和取消费用

将处于 pending_submission 的费用提交审核，或取消一笔尚未计入基金投资组合的费用。只有录入该费用的一方（管理人或顾问）可以使用这两个调用。

提交后的状态取决于计提和合同情况。如需在录入时直接提交，请在录入中使用 submit: true。

提交费用​

适用范围
角色主机所需权限
管理人manager-api写入
顾问consultant-api录入和编辑费用或提交合并

各主机的 Base URL：环境（主机）。

ENDPOINT
/expense/fund_class/{fund_class_key}/expense/{expense_key}/submit
方法
PUT

路径参数​

参数类型描述
fund_class_keystring基金类别的 key（UUID）。
expense_keystring费用的 key（UUID）。

此调用没有请求体。

提交前，请确认：

  • 计算说明（calculation_memory）在费用的文件或合并分析的文件中。
  • 报销时，如果已发送发票（无合同类型为 Boleto）或类型为 cvm_tax 或 anbima_tax，分析中有付款凭证（payment_receipt）。
  • 付款日期尚未过去。
  • 合同仍接受该费用。

响应​

STATUS
200

返回处于新状态的费用，结构与按 key 查询相同，不含 status_events 和 consolidation_status_events：

情形费用状态
无计提，合同为 active 或无合同pre_approved
有计提in_manual_analysis
无计提，合同仍在审核中pending_contract_analysis

费用变为 pre_approved 或 in_manual_analysis 时，满足以下条件之一，合并分析也会进入 in_manual_analysis：

  • 发票已在合并分析的文件中（无合同类型也可以是费用或分析文件中的 Boleto）；或
  • 类型为 cvm_tax 或 anbima_tax。

否则，请稍后发送发票。

取消费用​

取消该费用及当前有效的合并分析。适用于 pending_submission、pending_contract_analysis、pre_approved、in_manual_analysis 和 pending_manager_approval 状态。API 不会取消已计入投资组合的费用（in_provision 及之后的状态）。

适用范围
角色主机所需权限
管理人manager-api写入
顾问consultant-api录入和编辑费用或提交合并

各主机的 Base URL：环境（主机）。

ENDPOINT
/expense/fund_class/{fund_class_key}/expense/{expense_key}/cancel
方法
PUT

此调用没有请求体。

响应​

STATUS
200

返回 status: canceled 的费用。

错误​

状态code发生情形
400EXP000140提交时：该费用不处于 pending_submission。
400EXP000138提交时：缺少计算说明。
400EXP000135提交时：报销没有付款凭证，且已发送发票（无合同类型为 Boleto）或类型为 cvm_tax 或 anbima_tax。
400EXP000121提交时：付款日期已经过去。请取消该费用，并以新的日期录入另一笔费用。
400EXP000126提交时：该合同在基金中已不存在。
400EXP000153提交时：该合同已不再接受此费用。
400EXP000142取消时：该费用不处于允许取消的任一状态。
400EXP000069该基金类别不属于该管理人。
403EXP000124顾问与该基金没有有效关联。通常 consultant-api 会先以 401（CIT000018）拒绝。
403EXP000156该费用不是由您录入的（permission_type 不是 owner）。
404EXP000010该费用在基金中不存在。
503EXP000132提交时：API 无法读取该合同。请重试。
Exemplo
{
  "title": "Calculation Memory Required",
  "description": "The expense requires a calculation_memory document to be submitted.",
  "translation": "A despesa exige o documento calculation_memory para ser enviada.",
  "code": "EXP000138"
}

认证、权限和主机相关错误：参见 API 错误。