Management fee rebate

A rebate offsets part of a fund's management fee (management_tax) and is created as a distribution fee (distribution_fee). It uses the same call as expense creation: just send the fee's key in rebated_expense_key. The accepted fees and the balance of each one are in Management fees eligible for rebate.

Management fees eligible for rebate

Lists the fund's management fees (management_tax) in in_provision or on_demand_recognition, with the balance available for a rebate.

Available on

Profile	Host	Required permission
Manager	manager-api	Read
Consultant	consultant-api	Read Expenses or Read Consolidations

Base URL for each host: Environments (Hosts).

ENDPOINT

/expense/fund_class/{fund_class_key}/expenses/rebate_eligible

METHOD

GET

Query parameters: page (starting at 0) and limit (from 0 to 100, default 10).

Response body

{
    "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
}

Field	Description
provisioned_value	The fee's provisioned amount; on on_demand_recognition, the recognized amount. 0 when the fee has no amount yet.
open_rebate_value	Sum of the rebates with the analysis in pending_submission, in_manual_analysis or pending_manager_approval.
approved_rebate_value	Sum of the rebates with an approved analysis.
available_rebate_value	provisioned_value minus the rebates that are neither canceled nor rejected (expense or analysis).
provision_finished	true when the fee is in in_provision and the fund's accounting date has already reached end_deferral_date.
unavailable_reason	no_available_balance when there is no balance. Absent in all other cases.

Create a rebate

Available on

Profile	Host	Required permission
Manager	manager-api	Write
Consultant	consultant-api	Create and Edit Expenses or Submit Consolidations

Base URL for each host: Environments (Hosts).

ENDPOINT

/expense/fund_class/{fund_class_key}/expense

METHOD

POST

Path parameters

Parameter	Type	Description
fund_class_key	string	Fund class key (UUID).

Request body — management fee rebate

{
    "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..."
        }
    ]
}

The body fields are those of creation, with the restrictions below. The payment object follows Payment details.

Rebate rules

• Fields. expense_type, if sent, must be distribution_fee. contract_key, payment_date, start_deferral_date and end_deferral_date are forbidden, and is_reimbursement cannot be true.
• Payment date. It is the one of the management fee's consolidation analysis.
• Submission. A rebate is always submitted in the same call, with or without submit. Include the calculation memory (calculation_memory).
• Management fee. It must be in in_provision or on_demand_recognition, with the consolidation analysis not under review. The fee's payment date cannot have passed.
• Amount. It must fit in the fee's balance: the provisioned amount (the recognized amount, on on_demand_recognition) minus the rebates that are neither canceled nor rejected.
• After submission. The rebate stays pre_approved, and its analysis only moves forward with the management fee's analysis: the invoice is submitted through the fee.

Response

STATUS

201

The expense, in the same structure as the creation response, with status pre_approved.

Errors

Status	code	When it happens
400	QIT000001	Invalid body: missing required field, field forbidden on a rebate (a date, for example) or unexpected field.
400	EXP000069	The fund class does not belong to the manager.
400	EXP000136	A document is not valid Base64.
400	EXP000137	A document exceeds 20 MB.
400	EXP000133	Rebate with an expense_type other than distribution_fee.
400	EXP000125	contract_key sent on a rebate.
400	EXP000206	Rebate with is_reimbursement: true.
400	EXP000090	rebated_expense_key does not point to a management fee.
400	EXP000089	The rebate's management fee is neither in in_provision nor in on_demand_recognition.
400	EXP000166	The management fee's consolidation analysis is under review.
400	EXP000087	The rebate amount exceeds the management fee's balance: the provisioned amount (the recognized amount, on on_demand_recognition) minus the rebates that are neither canceled nor rejected.
400	EXP000121	The management fee's payment date has already passed.
400	EXP000138	Submission without a calculation memory.
400	EXP000178 to EXP000183, EXP000208 to EXP000211 and other payment errors	See Payment details.
403	EXP000124	The consultant has no active link with the fund. Usually consultant-api rejects the request earlier, with 401 (CIT000018).
404	EXP000001	The fund class does not exist.
404	EXP000010	The rebated_expense_key fee does not exist in the fund.
409	EXP000080	The expense_key has already been used in the fund. Retrieve the existing expense.
413	EXP000177	The body exceeds 100 MB.
500	QIT000500	limit or page out of range. Validation of these parameters comes back as an internal error: fix the parameter and retry the call.

Authentication, permission and host errors: see API Errors.