# Process Uploaded CSV (Batch Invoice Mapping) After uploading, call this with separator and header info to build the column mapping. Endpoint: POST /api/v3/imports/invoices/process Version: 3.1.0 Security: apiKeyAuth ## Query parameters: - `api_key` (string, required) Your API Key. Example: "YOUR_API_KEY" ## Request fields (application/json): - `process` (object, required) - `process.separator` (string) Column separator. auto detects it from the first line. The value is lowercased before matching (e.g. TAB works as tab). Enum: "auto", ",", "comma", ";", "semicolon", "\t", "tab", "|", "pipe" - `process.exclude_first_line` (boolean) ## Response 201 fields (application/json): - `import` (object) - `import.batch_metadata_id` (integer) - `import.batch_name` (string,null) Example: "My import" - `import.status` (string) Enum: "started", "mapping", "validating", "validated", "configured", "importing", "sending_email", "completed", "failed" - `import.date` (string) Example: "2026-06-08T15:19:10.908Z" - `import.expires_at` (string) Example: "2026-06-08T15:19:10.908Z" - `import.doc_type` (string,null) - `import.doc_status` (string,null) - `import.sequence_id` (integer,null) - `import.sequence` (string,null) - `import.send_by_email` (boolean) - `import.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" - `import.separator` (string) Example: "," - `import.filename` (string) Example: "import.csv" - `import.exemption_reason_id` (integer,null) - `import.discount_type` (string,null) - `import.mapping` (object) - `import.mapping.client` (object) - `import.mapping.document` (object) - `import.mapping.items` (array) - `import.mapping.cells` (array) - `import.mapping.cells.cell` (string) Example: "A" - `import.mapping.cells.field_name` (string) Example: "date" - `import.mapping.cells.example` (string) Example: "2024-01-15" ## 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)