Imports

Queue a QuickBooks financials import (chart + journal CSVs)

Queues a rebuild of the organization's books from a QuickBooks chart-of-accounts CSV and journal CSV and returns 202 with the pending job at once. A background worker provisions accounts, posts grouped journal entries, and optionally sets reconciliation baselines in one all-or-nothing transaction. Poll GET /bulk/import-jobs/{id} until status is completed (job.result summarizes the import) or failed (job.errorMessage explains why; nothing was imported). Send the RAW QuickBooks exports unchanged - reformatted/normalized files are rejected. Create the company with setupMode 'import' so the imported chart is not merged with the default seed. Always preview first. Prefer file keys from POST /bulk/qbo-financials/uploads; inline CSV content is stored as a temporary import file for the worker. Source files are attached to the completed import and scheduled for recoverable temporary retention. Reusing an idempotencyKey returns the original job. Only one QuickBooks import may be queued or running per company; a second returns 409 with code qbo_import_already_running.

post/bulk/qbo-financials/import

Request

  • Base URL: https://ledgerhq.pro/api/v1
  • URL: https://ledgerhq.pro/api/v1/bulk/qbo-financials/import
  • Auth: one of:
    • HTTP bearer and API key in header x-organization-id
    • HTTP bearer and API key in header x-organization-id

Request body

coaCsvContentstring

Inline chart CSV (or use coaFileKey)

journalCsvContentstring

Inline journal CSV (or use journalFileKey)

coaFileKeystring
journalFileKeystring
coaFileNamestring required
journalFileNamestring required
replaceExistingLedgerboolean
idempotencyKeystring

Stable retry key for this exact import request.

Response

Queued import job

Changes

No recorded changes to this operation across all 5 revisions of this API.