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.
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
Response
Queued import job
Changes
No recorded changes to this operation across all 5 revisions of this API.