Add transactions to a reconciliation
Pulls transactions into the reconciliation, marking each one included or excluded. Naming a deposit slip pulls in every transaction on it. Requires the reconciliations:write permission.
Authorization
AuthorizationstringrequiredPath parameters
bankAccountIdstringrequiredThe bank account being reconciled.
manualReconciliationIdstringrequiredSnowflake id of the reconciliation.
Body
application/json
Send transactionIds, depositSlipIds, or both — at least one of them must be non-empty. Every transaction in the call gets the same type. Re-adding a transaction that is already in this reconciliation just re-marks it, so the call is safe to repeat.
typeenum<string>requiredincluded counts these transactions toward the computed totals; excluded records that you deliberately left them out, so they stop showing up as unexplained.
transactionIdsstring[]Transactions to pull in. Each must sit on this bank account and must not already belong to a different reconciliation.
depositSlipIdsstring[]Deposit slips to pull in whole. Each must sit on this bank account; every transaction on the slip is added.
Response
200 · The reconciliation with the new entries and the recomputed balance.
idstringSnowflake id of the reconciliation.
bankAccountIdstringThe bank account being reconciled.
startDatestring · dateThe first day of the period, which is the day after the previous completed period ended. Absent on the company's very first reconciliation for this account, which has no lower bound.
endDatestring · dateThe statement date the period is being reconciled to.
openingnumberThe balance the account started the period with, as a decimal. On any reconciliation after the first this is copied from the previous completed period's closing and cannot be overridden.
additionsnumberThe total money in that the bank statement shows, as a positive decimal. This is what you declare, not what MagicDoor computed.
subtractionsnumberThe total money out that the bank statement shows, as a positive decimal. Declared, not computed.
closingnumberopening plus additions minus subtractions. MagicDoor keeps it in step with those three; you never send it.
statusenum<string>inProgress while it is being worked on, then completed or cancelled.
creatorobjectWho started the reconciliation. Deprecated mirrors of id — propertyManagerId, tenantId, vendorId, ownerId — are also present, whichever matches type.
memostringFree-text note. Absent when none was set.
createdstring · date-timeWhen the reconciliation was started, in the company's timezone.
updatedstring · date-timeWhen it last changed, in the company's timezone.
entriesEntry[]Every transaction pulled into the reconciliation, included or excluded.
actualAdditionsnumberThe sum of the included entries whose direction is in. Compare against additions.
actualSubtractionsnumberThe sum of the included entries whose direction is out. Compare against subtractions.
actualClosingnumberopening plus actualAdditions minus actualSubtractions — the balance the ledger says the account should have.
additionsDifferencenumberactualAdditions minus additions. Positive means the ledger has more money in than the statement declares.
subtractionsDifferencenumberactualSubtractions minus subtractions. Positive means the ledger has more money out than the statement declares.
closingDifferencenumberactualClosing minus closing. It must be exactly zero before the reconciliation can be completed.
depositSlipsDepositSlip[]The deposit slips the entries belong to, so you can group by slip instead of by transaction.