Management fees

Charge management fees

Charges management fees to properties, one entry per property and period, and returns the fees that were created. Credit is applied oldest first, up to the creditAmount you name.

POST
https://api.portal.magicdoor.com/company-app/management-fees/add

Authorization

Authorizationstringrequired
Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Body

application/json

managementFeesobject[]required

The fees to charge. At least one.

chargeDatestring · date

The day to record the charge on. Left out, today is used.

calculateFeesUntilstring · date-time

Only used when the fees came from the calculate endpoint — the cut-off that calculation ran to, read in the company's timezone. It does not change what is charged.

Response

200 · The management fees that were created, as a bare array.

idstring

The management fee. A Snowflake id sent as a decimal string.

chargeDatestring · date

The day the fee was charged.

periodStartstring · date

The first day of the period the fee covers.

periodEndstring · date

The last day of the period the fee covers.

totalAmountnumber

What the fee comes to in dollars and cents. Positive — money the property owes the management company.

creditedAmountnumber

How much of it has been covered by management fee credits.

paidAmountnumber

How much of it has actually been drawn out to the company.

outstandingAmountnumber

What is left: the fee less credit and payment. Zero means it is fully settled.

memostring

A note on the fee. Absent when none was set.

referencestring

A reference on the fee. Absent when none was set.

companyVendorIdstring

The vendor record standing for the management company itself, which the fee is billed from.

lineItemsobject[]

The fee broken down by property, in display order.

filesobject[]

Files attached to the fee.

metadataobject

Free-form key-value pairs kept on the fee.

createdstring · date-time

When the fee was created, in the company's timezone.

updatedstring · date-time

When it last changed, in the company's timezone.

creatorobject

Who created the record.

vendorobject

The vendor record standing for the management company, resolved.

portfoliosobject[]

The portfolios the fee's lines belong to, resolved.

propertiesobject[]

The properties the fee's lines are charged to, resolved.

unitsobject[]

The units the fee's lines refer to, resolved.

leasesobject[]

The leases the fee's lines refer to, resolved.

transactionsobject[]

The accounting transactions behind the credits and payouts, resolved.

bankAccountsobject[]

The bank accounts those transactions moved money through, resolved.

chartOfAccountsobject[]

The chart of accounts the fee books to, resolved.

hydratedFilesobject[]

The attachments in files, resolved to full file records.

creatorInfoobject

The person behind creator, resolved.

400 · `managementFees` is empty, an amount is below 0.01, or `periodEnd` is not later than `periodStart`.

401 · The access token is missing, expired, or does not belong to a property manager.

404 · A property in the request does not exist for the caller's company.

422 · A property in the request is deactivated, or the accounting service refused the charge.