SortSwift
DocsSign InGet started
InventoryInventory OverviewBulk Lot BuilderMaster SetsChaos Sorting
Syncing
DocumentationSign In
SortSwift Docs
Getting Started
Core Features
Integrations & Tools
Support

Documentation In Progress

Content may be inaccurate or incomplete. For reliable help, contact support or join Discord

Retrying Failed Imports

Retry failed CSV imports, view error details, and resolve import issues.

Retry functionality is available at /inventory/csv-history.

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:

  1. Click the expand icon on the failed import row
  2. Wait for detailed error data to load
  3. Review the list of errors showing which rows failed
  4. Each error entry shows: row number, error message, and the problematic data
  5. Error messages explain why each row failed (missing SKU, invalid format, etc.)
  6. 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:

  1. Export error details to CSV to review problematic rows
  2. Open the original CSV file in Excel or spreadsheet editor
  3. Find rows with errors (use row numbers from error export)
  4. Fix issues: correct SKUs, fill missing fields, fix formatting
  5. Save the corrected CSV file
  6. 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:

  1. Navigate to /inventory/csv-history
  2. Use Status filter dropdown and select "Error" to show only failed imports
  3. Locate the failed import row in the table (red status badge, non-zero error count)
  4. Optionally click expand icon to view detailed error information first
  5. Click the Retry icon button (RetryIcon, color="primary") in the Actions column
  6. System sends POST request to /inventory/csvlogs/{csvLogId}/retry
  7. Success message appears: "CSV log import retried successfully." in snackbar
  8. Table automatically refreshes (fetchCsvLogs called) to show updated status
  9. New import log entry created with same filename and configuration
  10. Monitor the new log entry status - it may show "In Progress" initially
  11. 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
SortSwift

The all-in-one TCG store platform that unifies inventory, POS, scanning, buylist automation, and syncing to modernize your card shop operations.

Product
OverviewFeaturesPricing

© 2025 SortSwift. All rights reserved.Magic: The Gathering and its respective properties are © Wizards of the Coast.Yu-Gi-Oh! and its respective properties are © 2025 Studio Dice/SHUEISHA, TV TOKYO, KONAMI.Cardfight!! Vanguard and Weiß Schwarz are © bushiroad All Rights Reserved.Shadowverse: Evolve is © Cygames, Inc.Godzilla Card Game is TM & © TOHO CO., LTD.hololive OFFICIAL CARD GAME is © COVER©2025 Pokémon. ©1995 - 2025 Nintendo/Creatures Inc./GAME FREAK Inc. TM, ®Nintendo.Disney Lorcana and its respective properties are © Disney

Privacy PolicyTerms of ServiceAccessibility