Reconciliation periods

Acknowledge a period disposition

Records that a change made after the period was locked has been seen and accepted. Clearing every open disposition returns the period to valid. Requires the reconciliations:write permission.

POST

https://services.magicdoor.com/accounting/company-portal/reconciliations/periods/{reconciliationPeriodId}/dispositions/{dispositionId}/acknowledge

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.

Path parameters

reconciliationPeriodIdstringrequired

Snowflake id of the reconciliation period.

example: 1830472847398411100

dispositionIdstringrequired

Snowflake id of the disposition, from the period's dispositions.

example: 1830472847398411200

Response

200 · The disposition, now `acknowledged`. Acknowledging one that already is returns it unchanged.

idstring

Snowflake id of the disposition.

reconciliationItemIdstring

The reconciliation item the change concerns. Absent when the change is not tied to one.

bankFeedEntryIdstring

The bank feed entry the change concerns. Absent when it is not tied to one.

transactionIdstring

The transaction the change concerns. Absent when it is not tied to one.

statusenum<string>

open until a property manager acknowledges it, then acknowledged.

openacknowledged

reasonenum<string>

What happened after the lock: the bank edited an entry, the bank withdrew an entry, a new entry arrived inside the period, or a transaction the period's items point at changed.

sourceModifiedAfterLocksourceRemovedAfterLockentryPostedAfterLockaccountingTargetChangedAfterLock

acknowledgedstring · date-time

When it was acknowledged, in the company's timezone. Absent while open.

acknowledgedBystring

Id of the property manager who acknowledged it. Absent while open.

canAcknowledgeboolean

Whether this disposition is currently acknowledgeable.

createdstring · date-time

When it was raised, in the company's timezone.

updatedstring · date-time

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

401 · The access token is missing, expired, or not for this company.

403 · The caller does not hold the `reconciliations:write` permission.

404 · The period is not the caller's, or no disposition with this id belongs to that period.

Why dispositions exist

A locked period is supposed to be settled. When something underneath it moves — the bank edits or withdraws an entry, a new entry lands inside the period, or a transaction one of its items points at changes — MagicDoor raises a disposition and marks the period invalidated. Every later period becomes impacted, because its opening balance rests on this one.

Acknowledging is not fixing

Acknowledging says a human has looked and is content to leave the locked figures as they are. If the change genuinely alters the reconciliation, reopen the period and redo it instead. A disposition is acknowledged once, on the period it directly affects — the impacted periods behind it clear themselves.