Bulk Import States

bulk uploads follow a structured lifecycle to ensure transparency, reliability, and consistent data handling across attributes, attribute groups, product templates, products, and variants each upload is tracked using a unique feed id , allowing users to monitor progress across all stages upload & preparation states scanning the system scans the uploaded file to validate file structure detect sheets and headers check for missing or invalid formats no data is processed at this stage scanned the file structure has been successfully read and validated the system prepares the file for mapping and validation mapping required user action is required to map uploaded columns to system fields this ensures correct data alignment before processing begins ready all required mappings are completed the feed is ready to begin processing pre processing & validation states pre processing the system performs initial validations and transformations, including mandatory field checks data type validation site id verification structure validation for complex attributes invalid rows are flagged early to prevent corrupt data from entering the system processing states uploaded the file has been successfully uploaded and queued for processing (this state confirms successful file submission before active processing begins ) importing the system processes each row in the feed and applies business rules during this stage valid rows continue processing invalid rows are recorded in structured error reports progress updates appear in real time for long running feeds partial success some rows have been successfully processed while others failed validation or processing users can download detailed error reports fix failed rows re import only the corrected data this ensures large uploads are not blocked by a few invalid entries processed all rows in the feed have completed processing this state may include full success (all rows valid) partial success (some rows failed) post processing & commit states post processing final consistency checks are performed before committing data, including referential integrity validation version alignment for templates final error verification this ensures data stability across related entities ready the processed data is prepared for final commit at this stage, users can review results before publishing commit in progress the system is actively committing processed records into the live environment progress indicators show completion status for large feeds committed the feed has been successfully committed all valid rows are now live in the system any failed rows remain documented in error reports error & reporting states error the system generates structured error reports containing feed id sheet name row number entity id (where applicable) error category and message this allows precise troubleshooting and correction feed tracking & visibility each bulk upload generates a feed id which can be used to track status across pre processing, processing, and commit stages view partial success details monitor progress in real time retrieve detailed error reports status updates occur dynamically without requiring page reloads