Retry failed CSV imports, view error details, and resolve import issues.
Retry Overview
The retry feature allows you to reprocess failed CSV imports:
- Failed Imports Only: Retry button only appears on imports with "error" or "failed" status
- Reprocess File: Retries the import using the original CSV file
- Error Resolution: Fix issues in source data, then retry
- New Log Entry: Retry creates a new import log entry
- Preserved Data: Original failed import log remains for reference
Identifying Failed Imports
How to find imports that need retrying:
- Status Indicator: Failed imports show red "Failed" or "Error" status badge
- Error Count: Failed imports have a non-zero error count
- Status Filter: Use status filter dropdown to show only "Failed" imports
- Retry Icon: Retry button (circular arrow icon) appears in action column for failed imports
- Expand Details: Click expand icon to see detailed error messages
Viewing Error Details
Before retrying, review the specific errors:
- Click the expand icon on the failed import row
- Wait for detailed error data to load
- Review the list of errors showing which rows failed
- Each error entry shows: row number, error message, and the problematic data
- Error messages explain why each row failed (missing SKU, invalid format, etc.)
- Export errors to CSV for analysis using "Export Error Details" button
Common Import Errors
Typical errors you may encounter:
- Invalid SKU: SKU not found or doesn't match existing inventory
- Missing Required Fields: Required columns (SKU, quantity, etc.) are empty
- Duplicate Entries: Same SKU appears multiple times when not allowed
- Invalid Format: Data format doesn't match expected type (number, date, etc.)
- Out of Range: Quantity or price values outside acceptable ranges
- Missing Product: SKU references a product that doesn't exist in inventory
- Duplicate SKU: Import mode doesn't allow duplicate SKUs in same file
Fixing Errors Before Retry
Steps to fix common issues:
- Export error details to CSV to review problematic rows
- Open the original CSV file in Excel or spreadsheet editor
- Find rows with errors (use row numbers from error export)
- Fix issues: correct SKUs, fill missing fields, fix formatting
- Save the corrected CSV file
- Re-upload the corrected file (or retry if errors were system-side)
Retry Process - Step by Step
Detailed step-by-step process to retry a failed import:
- Navigate to /inventory/csv-history
- Use Status filter dropdown and select "Error" to show only failed imports
- Locate the failed import row in the table (red status badge, non-zero error count)
- Optionally click expand icon to view detailed error information first
- Click the Retry icon button (RetryIcon, color="primary") in the Actions column
- System sends POST request to
/inventory/csvlogs/{csvLogId}/retry - Success message appears: "CSV log import retried successfully." in snackbar
- Table automatically refreshes (fetchCsvLogs called) to show updated status
- New import log entry created with same filename and configuration
- Monitor the new log entry status - it may show "In Progress" initially
- Check new log entry to verify if retry was successful or if it failed again
Retry Behavior
What happens when you retry:
- New Import: Retry creates a new import log entry (doesn't modify original)
- Original Preserved: Original failed import log remains visible for reference
- Same Configuration: Retry uses same import settings as original
- Original File: Uses the same CSV file that was originally uploaded
- Fresh Processing: All rows are re-processed from scratch
- Status Update: New log shows updated status (Completed/Failed)
Retry Limitations
Important considerations:
- File Must Exist: Original CSV file must still be available on server
- No File Changes: Retry uses original file - you can't upload a corrected version via retry
- Same Errors: If source file has errors, retry will fail again with same errors
- Upload New Instead: For corrected files, upload a new CSV instead of retrying
- System Errors: Retry useful for temporary system errors that may now be resolved
- Partial Success: Retry processes all rows again, not just failed ones
Important: If your CSV file has data errors, fix them in the file and upload a new import rather than retrying. Retry is best for temporary system errors that may have been resolved.