Accountants

Explicitly release inactive cash mappings and approve their replacements

Dry run is the default and changes nothing. Apply requires the same source run, complete expected current mapping IDs, reason, exact transfers, expiry and digest returned by the dry run. In one transaction the API records immutable releases and replacement mappings with actor and API-key audit. Old QuickBooks accounts must be inactive Bank/Card accounts with no current source activity since the cutoff; replacements must be active accounts of the same type/currency on the same GL and cash source. Concurrent source/mapping or pending import/writeback work blocks apply. No bank/GL status, provenance, journal, provider or historical receipt is changed. Released old accounts with new activity hold imports instead of falling through to Ask My Accountant. Requires fresh accountant assignment; the reviewed service principal may call this high-impact route.

post/accountant/companies/{customerId}/integrations/quickbooks/account-mapping-transfers

Request

  • Base URL: https://api.medianfi.com/api/v1
  • URL: https://api.medianfi.com/api/v1/accountant/companies/{customerId}/integrations/quickbooks/account-mapping-transfers
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Request body

dryRunboolean
expectedSourceRunIdstring uuid required
expectedMappingIdsstring[] required
reasonstring required
expiresAtstring date-time

Required on apply; copy the dry-run expiry (at most ten minutes).

planDigeststring

Required on apply; copy the dry-run digest.

Response

Prepared transfer plan or atomically applied mappings

successtrue required

Changes

No recorded changes to this operation across all 1 revision of this API.