跳到主要内容

管理人对顾问费用的决定

当与基金关联的顾问录入一笔费用或发送一张发票时，QI Tech 会先进行审核。之后，该费用或发票处于 pending_manager_approval，等待管理人批准或拒绝。共有两个调用：

等待决定的内容出现位置调用
带计提的费用费用状态为 pending_manager_approval对费用作出决定
发票（合并分析）consolidation_analysis.status 为 pending_manager_approval对发票作出决定

如需找出等待管理人处理的内容，请在费用列表中使用 status=pending_manager_approval 筛选，或在分析列表中使用 status=pending_manager_approval 筛选。

录入或发送该费用或发票、或开启当前有效分析的一方，不能对其作出决定。通过 API 调用时，比对的身份为管理人的 key。管理人自己录入的费用不经过此环节。

决定请求体​

两个调用使用相同的请求体。

Corpo da requisição — reprovação
{
    "status": "reproved",
    "reproval_details": "Valor diverge do orçamento aprovado."
}
字段类型是否必填描述
statusstring是approved 或 reproved。
reproval_detailsstring条件必填拒绝原因，1 至 1000 个字符。reproved 时必填；approved 时会被忽略。

对费用作出决定​

适用范围
角色主机所需权限
管理人manager-api写入

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

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

批准或拒绝处于 pending_manager_approval 的顾问费用。适用于合并分析不在复核中的情形；如果发票正在复核，请通过发票作出决定。

STATUS
200

返回该费用，结构与按 key 查询相同，permission_type: viewer，不含 status_events 和 consolidation_status_events：

  • 拒绝： reproved，reproval_reason: manager_reproval。当前有效的合并分析也变为 reproved。
  • 批准： 以 in_provision 计入投资组合；如果合同仍在审核中，则进入 pending_contract_analysis。已过去的付款日期或计提日期会顺延至从今天起的第一个工作日。

对发票作出决定​

适用范围
角色主机所需权限
管理人manager-api写入

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

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

批准或拒绝顾问的发票。适用于合并分析处于 pending_manager_approval 的情形。

STATUS
200

返回该合并分析，结构与合并分析相同：

  • 拒绝： 分析为 reproved，reproval_reason: manager_reproval。
    • 仍处于 in_manual_analysis 或 pending_manager_approval 的费用会被一并拒绝。
    • 对于返佣，费用本身不变，管理费的分析如仍未结束，则以 rebate_inconsistency 被拒绝。
  • 批准： 分析为 approved。
    • 费用完成合并，付款排期在分析日期，或第一个可用的工作日（17 点之后则为下一个工作日）。
    • 尚未进入投资组合的费用会先进入投资组合再完成合并；如果合同仍在审核中，则进入 pending_contract_analysis。
    • 对于管理费，已批准的返佣会先完成合并，每笔按其自身金额合并。total_rebate_value 更新为这些返佣的总额，管理费则按 payment_value（净额）完成合并。
    • 对于返佣，只批准其分析；返佣与管理费一同完成合并。

错误​

状态code发生情形
400EXP000154费用或分析不处于 pending_manager_approval。
400EXP000162该费用的发票正在复核中：请通过发票作出决定。
400EXP000150reproved 未提供 reproval_details。
400QIT000001请求体无效：缺少 status、status 不是 approved 或 reproved、reproval_details 为空或超过 1000 个字符，或包含未定义的字段。
400EXP000153批准时：该合同已不再接受此费用。
400EXP000037, EXP000008, EXP000009, EXP000027批准尚未进入投资组合的费用时：日期与基金的会计日期不兼容，或不是工作日。
400EXP000157批准管理费的发票时，仍有返佣在审核中。
400EXP000085, EXP000086, EXP000036批准发票时：该费用没有收款人或收款目标。
400EXP000043, EXP000044批准 Boleto 付款的发票时：缺少数字行，或 Boleto 金额与合并金额不同。
400EXP000011, EXP000051, EXP000073, EXP000074批准发票时：该费用已合并、已取消、已支付或已完成。
400EXP000069该基金类别不属于该管理人。
403EXP000207您录入或发送了该费用或发票，或开启了当前有效的分析：不能对其作出决定。
404EXP000010该费用在基金中不存在。
503EXP000132API 无法读取该合同。请重试。
Exemplo
{
  "title": "Expense Not Pending Manager Approval",
  "description": "The expense is in status pre_approved, not pending manager approval.",
  "translation": "A despesa esta no status pre_approved, nao aguardando aprovacao do gestor.",
  "code": "EXP000154"
}

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