跳到主要内容

管理费返佣

返佣用于抵扣基金某笔管理费（management_tax）的一部分，并作为分销费（distribution_fee）录入。它使用与录入费用相同的调用：只需在 rebated_expense_key 中填写该管理费的 key。可接受的管理费及其余额参见可返佣的管理费。

可返佣的管理费​

列出基金中处于 in_provision 或 on_demand_recognition 的管理费（management_tax），以及可用于返佣的余额。

适用范围
角色主机所需权限
管理人manager-api读取
顾问consultant-api读取费用或读取合并

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

ENDPOINT
/expense/fund_class/{fund_class_key}/expenses/rebate_eligible
方法
GET

查询参数：page（从 0 开始）和 limit（0 至 100，默认 10）。

Corpo da resposta
{
    "data": [
        {
            "expense_key": "c9d8e7f6-a5b4-4c3d-8e2f-1a0b9c8d7e6f",
            "start_deferral_date": "2026-11-03",
            "end_deferral_date": "2026-11-28",
            "payment_date": "2026-12-01",
            "provisioned_value": 12000.0,
            "open_rebate_value": 1000.0,
            "approved_rebate_value": 500.0,
            "available_rebate_value": 10500.0,
            "provision_finished": false
        }
    ],
    "limit": 10,
    "page": 0,
    "is_last_page": true
}
字段描述
provisioned_value管理费的计提金额；on_demand_recognition 时为已确认金额。管理费尚无金额时为 0。
open_rebate_value分析处于 pending_submission、in_manual_analysis 或 pending_manager_approval 的返佣总额。
approved_rebate_value分析已批准的返佣总额。
available_rebate_valueprovisioned_value 减去未取消且未拒绝（费用或分析）的返佣。
provision_finished当该管理费处于 in_provision 且基金的会计日期已到达 end_deferral_date 时为 true。
unavailable_reason没有余额时为 no_available_balance。其他情况下不出现。

录入返佣​

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

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

ENDPOINT
/expense/fund_class/{fund_class_key}/expense
方法
POST

路径参数​

参数类型描述
fund_class_keystring基金类别的 key（UUID）。
Corpo da requisição — rebate de taxa de gestão
{
    "rebated_expense_key": "c9d8e7f6-a5b4-4c3d-8e2f-1a0b9c8d7e6f",
    "description": "Rebate distribuidor 11/2026",
    "payment_value": 1000.00,
    "payment_method": "transfer",
    "payment": {
        "target": {
            "name": "DISTRIBUIDORA EXEMPLO LTDA",
            "document_number": "55.666.777/0001-81"
        },
        "target_account": {
            "account_number": "98765",
            "account_branch": "1234",
            "account_digit": "1",
            "financial_institution_code": "237"
        }
    },
    "documents": [
        {
            "name": "memoria_de_calculo_rebate.pdf",
            "document_type": "calculation_memory",
            "document_b64": "JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoK..."
        }
    ]
}

请求体字段与录入相同，但受以下限制。payment 对象参见付款数据。

返佣规则​

  • 字段。 如发送 expense_type，必须为 distribution_fee。禁止提供 contract_key、payment_date、start_deferral_date 和 end_deferral_date，且 is_reimbursement 不能为 true。
  • 付款日期。 为管理费合并分析的付款日期。
  • 提交。 无论是否使用 submit，返佣始终在同一次调用中提交。请附上计算说明（calculation_memory）。
  • 管理费。 必须处于 in_provision 或 on_demand_recognition，且其合并分析不在复核中。管理费的付款日期不能已过。
  • 金额。 必须在管理费余额之内：计提金额（on_demand_recognition 时为已确认金额）减去未取消且未拒绝的返佣。
  • 提交之后。 返佣保持 pre_approved，其分析只会随管理费的分析一起推进：发票通过管理费发送。

响应​

STATUS
201

返回该费用，结构与录入的响应相同，状态为 pre_approved。

错误​

状态code发生情形
400QIT000001请求体无效：缺少必填字段、返佣禁止提供的字段（例如日期）或未定义的字段。
400EXP000069该基金类别不属于该管理人。
400EXP000136某个文件不是有效的 Base64。
400EXP000137某个文件超过 20 MB。
400EXP000133返佣的 expense_type 不是 distribution_fee。
400EXP000125在返佣中发送了 contract_key。
400EXP000206返佣带有 is_reimbursement: true。
400EXP000090rebated_expense_key 指向的不是管理费。
400EXP000089返佣对应的管理费既不在 in_provision 也不在 on_demand_recognition。
400EXP000166管理费的合并分析正在复核中。
400EXP000087返佣金额超过管理费的余额：计提金额（on_demand_recognition 时为已确认金额）减去未取消且未拒绝的返佣。
400EXP000121管理费的付款日期已过。
400EXP000138提交时没有计算说明。
400EXP000178 至 EXP000183、EXP000208 至 EXP000211 及其他 payment 错误参见付款数据。
403EXP000124顾问与该基金没有有效关联。通常 consultant-api 会先以 401（CIT000018）拒绝。
404EXP000001该基金类别不存在。
404EXP000010rebated_expense_key 对应的管理费在基金中不存在。
409EXP000080该 expense_key 已在基金中使用过。请查询已存在的费用。
413EXP000177请求体超过 100 MB。
500QIT000500limit 或 page 超出范围。这些参数的校验错误会以内部错误返回：请修正参数后重试。

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