Import Totes
Bulk create or update totes via CSV.
Bulk create or update multiple totes via CSV. Use this to set up totes for a new warehouse or add totes in bulk.
CSV Columns
| Column | Required | Description |
|---|---|---|
id | No | Existing tote ID. If provided, updates the tote. If empty, creates a new one. |
name | Yes | Tote identifier (e.g., "TOTE-001") |
barcode | No | Tote barcode. Auto-generated if omitted for new totes. |
warehouse | Yes | Warehouse name (must match exactly) |
Conflict Protection
Export current records as your starting template. When an export includes _lock (Do not modify), keep its value and the existing row's id unchanged while editing other fields.
- Unchanged rows and edits already matching the saved record are skipped.
- If both the CSV and saved record changed since export, a conflicting edit is rejected. Export the latest data, review the other changes, and reapply your edit.
- A locked row without its original ID is rejected.
- For a new record, leave both the ID and lock empty.
- Omitting a lock on an existing record removes conflict protection; it does not force an otherwise invalid edit to succeed.
Adding New Entries
To add new totes, add rows with both the id and _lock (Do not modify) columns left empty. The system creates new tote records.
Bulk delete is not supported. To remove totes, delete them individually through the UI or API.
Example CSV
id,name,barcode,warehouse
,TOTE-001,,Main Warehouse
,TOTE-002,,Main Warehouse
,TOTE-003,CUSTOM-BC-003,Main Warehouse
abc123-def456,TOTE-004,,Main WarehouseHow to Import
- Navigate to ShipOS → Inventory → Totes (opens the Cybership dashboard in a new tab)
- Click Import
- Upload your CSV
- Import processes asynchronously via background job
- Monitor progress in real-time
- Review completion status and any errors (includes row numbers for debugging)
Wait for the job to finish and inspect created, updated, skipped, and failed rows. A row-based import can partly succeed. Correct failed rows before retrying; do not assume the whole file was rolled back or that repeating new rows is harmless.
Export existing totes first to use as a template. See Export Totes.
Validation Rules
- Warehouse names must match existing records exactly (case-sensitive)
- When updating (ID provided), the tote must exist and belong to your team
- Barcodes are auto-generated if not provided for new totes