费用类型和付款方式

基金费用的 type 和 payment_method 取值，以及在录入费用之前使用的两个调用：列出费用类型（及每种类型的要求），以及列出基金中接受某一类型的合同。

费用类型

type	说明	合同	通过 API 录入
administration_tax	管理费	是，来自基金设立	否：由 QI Tech 计算
management_tax	投资管理费	是，来自基金设立	否：由 QI Tech 计算
performance_fee	业绩报酬	是，来自基金设立	否：由 QI Tech 计算
custody_tax	托管费	是	否：由 QI Tech 计算
audit_tax	审计费	是	是
consulting_fee	顾问费	是	是
distribution_fee	分销费	是（返还除外）	是
bank_account	银行账户	是	是
bankslip_fee	Boleto 手续费	是	是
sale_commission_tax	销售佣金	是	是
certifier_fee	认证	是	是
rating_agency_fee	评级机构	是	是
lawyer_fee	律师	是	是
bookkeeping_fee	登记托管费	是	是
insurance_fee	保险	是	是
collection_agent_fee	催收代理费	是	是
servicing_fee	服务费（servicing）	是	是
fund_structuring_fee	结构设计费	是	是
credit_rights_registration_fee	信用权利登记费	是，来自基金设立	是
origination_fee	发起费	是	是
pass_through_agent_fee	转付代理费	是	不接受
cvm_tax	CVM 费用	否	是
anbima_tax	ANBIMA 费用	否	是
cetip_tax	CETIP 费用	否	否：由 QI Tech 计算
selic_tax	SELIC 费用	否	否：由 QI Tech 计算
notary	公证处	否	是
court_fee	诉讼费用	否	是

对于需要合同的类型，录入前供应商和合同必须已存在。无合同的类型可直接录入费用。

付款方式

payment_method	说明
transfer	TED 转账至 payment.target_account 中的账户。
pix	通过 Pix 转账至 payment.target_account 中的账户、payment.target_pix_key 中的 Pix 密钥，或使用 payment.pix_qrcode 中的二维码。
bank_slip	支付 payment.bank_slip.digitable_line 中的 Boleto。
automatic_debit	从 payment.source_account 中的基金账户自动扣款。

列出费用类型

适用范围

角色	主机	所需权限
管理人	manager-api	读取
顾问	consultant-api	有效集成

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

ENDPOINT

/expense/expense_types

方法

GET

STATUS

200

Corpo da resposta

{
    "data": [
        {
            "expense_type": "cvm_tax",
            "requires_contract": false,
            "requires_invoice": false
        },
        {
            "expense_type": "notary",
            "requires_contract": false,
            "requires_invoice": true
        },
        {
            "expense_type": "audit_tax",
            "requires_contract": true,
            "requires_invoice": true
        }
    ]
}

字段	描述
expense_type	费用类型。
requires_contract	当录入需要 contract_key 时为 true。
requires_invoice	当合并分析需要发票时为 true。

列表包含可录入的类型：除由 QI Tech 计算的类型（cetip_tax、selic_tax、custody_tax、administration_tax、management_tax 和 performance_fee）之外的全部类型。pass_through_agent_fee 会出现在列表中，但目前尚不能通过 API 录入。

按费用类型列出基金合同

适用范围

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

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

ENDPOINT

/expense/fund_class/{fund_class_key}/expense_type/{expense_type}/contracts

方法

GET

路径参数

参数	类型	描述
fund_class_key	string	基金类别的 key（UUID）。
expense_type	string	费用类型。

查询参数

参数	类型	是否必填	描述
limit	integer	否	每页条数，1 至 100。默认：10。
page	integer	否	页码，从 0 开始。默认：0。

列出基金中涵盖该类型、且处于进行中或 active 状态的合同。

STATUS

200

Corpo da resposta

{
    "requires_contract": true,
    "automatic_calculation": null,
    "data": [
        {
            "contract_key": "0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
            "name": "Auditoria 2026",
            "status": "active",
            "accepts_expense": true,
            "vendor": {
                "vendor_key": "5d2e7b9a-3c4f-4e8a-b1d6-9f0a2c3e4b57",
                "name": "AUDITORES EXEMPLO S.A.",
                "document_number": "44.555.666/0001-81",
                "status": "registered",
                "agent_key": "a7498c6c-1893-42ec-a8f3-bc6ad0c6b52c"
            }
        }
    ],
    "limit": 10,
    "page": 0,
    "is_last_page": true
}

字段	描述
requires_contract	无合同的类型为 false；此时 data 为空。
automatic_calculation	当该类型在本页某个合同中为自动计算时，为 {"target": ...}；否则为 null。
data[].accepts_expense	当该合同接受由管理人或顾问录入的该类型费用时为 true。仍在审核中的合同也接受，费用会在 pending_contract_analysis 中等待。该类型在此合同中自动计算时为 false。
data[].vendor	合同的供应商，与合同属性中相同。

错误

状态	code	发生情形
400	EXP000069	该基金类别不属于该管理人。
403	EXP000124	顾问与该基金没有有效关联。通常 consultant-api 会先以 401（CIT000018）拒绝。
404	EXP000005	费用类型不存在。
500	QIT000500	limit 或 page 超出范围或不是整数。这些参数的校验会以内部错误返回：请修正参数后重新调用。

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