Skip to main content

Import and Send CSV Invoices (Asynchronous)

POST 

/api/v1/invoices/import/csv

Upload a CSV file. The file is parsed synchronously (header validation, row count, default-seller resolution) and an ImportJob is created. Heavy per-row processing (BIS XML render โ†’ optional signing โ†’ Schematron via Saxon-HE โ†’ queue-for-send) runs asynchronously in the background so this request returns within seconds even for large files (tens of thousands of rows).

The response is 202 Accepted with a job_id. Poll GET /api/v1/import-jobs/{job_id} for progress (counts and status) and GET /api/v1/import-jobs/{job_id}/result.json for the final transactions + errors payload once status is terminal (validated, partially_validated or failed).

Requestโ€‹

Responsesโ€‹

Successful Response