# Configure Batch Invoice Job Updates the active batch invoice job with configuration options (name, document type, sequence, etc.) and transitions status to "configured". Endpoint: PUT /api/v3/imports/invoices/configure Version: 3.1.0 Security: apiKeyAuth ## Query parameters: - `api_key` (string, required) Your API Key. Example: "YOUR_API_KEY" ## Request fields (application/json): - `configure` (object, required) - `configure.name` (string, required) Required (leading/trailing spaces are stripped). Must not be used by another document batch of the account ("Name is already used by another import batch"; blank → "Name can't be blank"). Example: "My import batch" - `configure.doc_type` (string) Enum: "invoices", "invoice_receipts" - `configure.doc_status` (string) Enum: "draft", "final" - `configure.sequence_id` (integer) Must be a sequence of the account ("must belong to the current account"), of the same category as doc_type ("must match the selected document type") and registered at the tax authority ("must be a registered sequence"). See configure_options for the valid sequences. Example: 12345 - `configure.send_by_email` (boolean) - `configure.exemption_reason_id` (integer) Must be an existing exemption reason ("must be a valid exemption reason that exists"). Example: 1 - `configure.discount_type` (string) Enum: "percentage", "absolute" ## Response 200 fields (application/json): - `configure` (object) - `configure.id` (integer) Example: 123 - `configure.account_id` (integer) - `configure.user_id` (integer) - `configure.name` (string,null) Example: "My import batch" - `configure.status` (string) Enum: "started", "mapping", "validating", "validated", "configured", "importing", "sending_email", "completed", "failed" - `configure.doc_type` (string) Example: "invoices" - `configure.doc_status` (string) Example: "draft" - `configure.filename` (string) Example: "import.csv" - `configure.import_type` (string) Example: "invoices" - `configure.separator` (string) Example: "," - `configure.header` (string,null) Stored as a string: the exclude_first_line value sent to process, as Rails casts it (JSON true → "t", false → "f"). Null until the CSV is processed, and still null after processing when exclude_first_line was not sent. Example: "t" - `configure.created_at` (string) Example: "2026-06-08T15:19:10.908Z" - `configure.updated_at` (string) Example: "2026-06-08T15:19:10.908Z" - `configure.expires_at` (string) Example: "2026-06-08T15:19:10.908Z" - `configure.sequence_id` (integer,null) Example: 12345 - `configure.send_by_email` (boolean) - `configure.exemption_reason_id` (integer,null) - `configure.discount_type` (string,null) Example: "percentage" ## Response 400 fields (application/json): - `errors` (array) Example: [{"error":"An unexpected error occurred"}] - `errors.error` (string) ## Response 401 fields (application/json): - `errors` (array) Example: [{"error":"Authentication Error"}] - `errors.error` (string) ## Response 404 fields (application/json): - `errors` (array) Example: [{"error":"Resource not found"}] - `errors.error` (string) ## Response 422 fields (application/json): - `errors` (array) Example: [{"error":"An unexpected error occurred"}] - `errors.error` (string)