# Batch Invoices Bulk-create invoices from a CSV file. Flow — GET batch → upload → process → mapping → configure_options → configure → validate → validation → available_docs → POST create → status. DELETE to discard. ## Get Current Batch Invoice Job - [GET /api/v3/imports/invoices](https://docs.invoicexpress.com/v3/batch-invoices/getv3batchinvoicejob.md): Returns the most recent non-expired batch invoice metadata. Returns 204 if no active batch exists. ## Start Batch Invoice Creation - [POST /api/v3/imports/invoices](https://docs.invoicexpress.com/v3/batch-invoices/createv3batchinvoices.md): Enqueues a background job to create invoices from validated batch previews. Requires an active batch in "validated" status. ## Delete Active Batch Invoice Job - [DELETE /api/v3/imports/invoices](https://docs.invoicexpress.com/v3/batch-invoices/deletev3batchinvoicejob.md): Destroys the currently active batch invoice job and associated S3 files. ## Get Batch Invoice CSV Template - [GET /api/v3/imports/invoices/template](https://docs.invoicexpress.com/v3/batch-invoices/getv3batchinvoicetemplate.md): Returns a presigned S3 URL to download the batch invoice CSV template. Language matches the account language (en, es, pt). ## Get Batch Invoice Configuration Options - [GET /api/v3/imports/invoices/configure_options](https://docs.invoicexpress.com/v3/batch-invoices/getv3batchinvoiceconfigureoptions.md): Returns data for populating the configure step dropdowns (sequences, exemption reasons). Only series registered with the AT are listed. ## Upload CSV for Batch Invoice Import - [POST /api/v3/imports/invoices/upload](https://docs.invoicexpress.com/v3/batch-invoices/uploadv3batchinvoicecsv.md): Validates the CSV file and uploads it to S3. Creates a new batch metadata record. ## Process Uploaded CSV (Batch Invoice Mapping) - [POST /api/v3/imports/invoices/process](https://docs.invoicexpress.com/v3/batch-invoices/processv3batchinvoicecsv.md): After uploading, call this with separator and header info to build the column mapping. ## Get CSV Column Mapping - [GET /api/v3/imports/invoices/mapping](https://docs.invoicexpress.com/v3/batch-invoices/getv3batchinvoicemapping.md): Returns the CSV column-to-field mapping for the active batch invoice job. ## Save CSV Column Mapping - [PUT /api/v3/imports/invoices/mapping](https://docs.invoicexpress.com/v3/batch-invoices/savev3batchinvoicemapping.md): Saves the user-selected column-to-field mapping for the active batch invoice job. ## Configure Batch Invoice Job - [PUT /api/v3/imports/invoices/configure](https://docs.invoicexpress.com/v3/batch-invoices/configurev3batchinvoicejob.md): Updates the active batch invoice job with configuration options (name, document type, sequence, etc.) and transitions status to "configured". ## Start Batch Invoice CSV Validation - [POST /api/v3/imports/invoices/validate](https://docs.invoicexpress.com/v3/batch-invoices/validatev3batchinvoices.md): Enqueues a background job to validate the CSV rows. Requires batch in "configured" status. Poll GET /api/v3/imports/invoices/validation for results. ## Get Batch Invoice Validation Status - [GET /api/v3/imports/invoices/validation](https://docs.invoicexpress.com/v3/batch-invoices/getv3batchinvoicevalidation.md): Poll this after POST /api/v3/imports/invoices/validate to get validation status and result. ## Check Document Quota - [GET /api/v3/imports/invoices/available_docs](https://docs.invoicexpress.com/v3/batch-invoices/getv3batchinvoiceavailabledocs.md): Returns whether the account has enough document quota to create invoices from validated previews. Use before POST /api/v3/imports/invoices. ## Get Batch Invoice Creation Status - [GET /api/v3/imports/invoices/status](https://docs.invoicexpress.com/v3/batch-invoices/getv3batchinvoicestatus.md): Poll after POST /api/v3/imports/invoices to check invoice creation progress. Status values — processing (202), sending_email (202), completed (200), failed / exception_occurred / interrupted (422), stuck/unknown (500). Every body carries a success boolean.