CSV Packing List
The CSV export produces a flat, comma-separated text file with one row per item placement. It is the simplest export format and is intended for integration with external systems — warehouse management platforms, custom automation scripts, or any tool that accepts CSV input.
Generating a CSV
- Open the load plan in the editor
- Click Export in the top toolbar (or press Ctrl+E)
- Select CSV Packing List
- Click Generate — the file downloads immediately
The only option that affects the CSV is the loading direction in the export dialog — it determines the order of the rows (see below). The CSV is generated instantly.
File Format
The CSV uses:
- Encoding: UTF-8
- Delimiter: comma (
,) - Line endings: CRLF (Windows-compatible)
- Header row: yes, first row
- Text quoting: fields containing commas or special characters are quoted with double-quotes
Column Reference
Rows are ordered by the loading sequence — the first row is the first item to load. There is no separate step-number column; the row order is the sequence.
| Column Name | Type | Description |
|---|---|---|
Item Name | Text | Item name from the plan |
SKU | Text | Product SKU — empty string if not set |
Container | Text | Container name (e.g., "Container 1", "Container 2") |
Position X (mm) | Number | Distance from the far-end wall, along the container length — the door is at the maximum X |
Position Y (mm) | Number | Distance from floor to item's bottom face |
Position Z (mm) | Number | Distance from the left wall, across the container width |
Width (mm) | Number | Space the item occupies across the container width in its placed orientation |
Height (mm) | Number | Space the item occupies vertically in its placed orientation |
Length (mm) | Number | Space the item occupies along the container length in its placed orientation |
Weight (kg) | Number | Item weight in kg |
Rotation | Text | Applied rotation code: LWH, WLH, LHW, HLW, WHL, or HWL |
Status | Text | Placed, Warning (placed with constraint warnings), or Unplaced |
Sample Output
Item Name,SKU,Container,Position X (mm),Position Y (mm),Position Z (mm),Width (mm),Height (mm),Length (mm),Weight (kg),Rotation,Status
Machine Base,SKU-205,Container 1,0,0,0,900,900,"2,000",480.0,LWH,Placed
Carton A,SKU-001,Container 1,"2,000",0,0,400,300,600,12.5,LWH,Placed
Carton A,SKU-001,Container 1,"2,000",0,400,400,300,600,12.5,LWH,Placed
Drum 200L,,Container 1,"2,600",0,0,580,910,580,210.0,WHL,Placed
Fragile Panel,SKU-310,Container 2,300,300,0,800,50,600,8.2,LHW,Placed
Oversized Crate,SKU-999,,,,,"2,100","1,800","3,000",950.0,LWH,UnplacedValues of 1,000 and above use a thousands separator and are therefore double-quoted in the CSV — a standards-compliant CSV parser handles this transparently. Unplaced items appear at the end of the file with empty Container, Position, and Rotation columns and Status Unplaced (their dimension columns show the item's base dimensions). This allows downstream systems to identify items that require manual intervention.
Coordinate System
All position values are in millimeters and reference the near corner of the item's bounding box:
- Position X — distance along the container length, measured from the far-end wall. X = 0 is the wall opposite the door; the door is at the maximum X (the container's inner length)
- Position Y — vertical distance from the floor to the bottom face of the item (0 = floor level)
- Position Z — distance across the container width, measured from the left wall (0 = left wall, looking from the door toward the far end)
The container's interior origin (0, 0, 0) is the floor corner at the far end, on the left wall. Because loading starts at the far end and works toward the door, the loading sequence progresses from low X to high X.
Rotation Codes
The rotation code spells out the item's own dimensions — L (Length), W (Width), H (Height) — in their order along the container's length, width, and height axes:
| Code | Meaning |
|---|---|
LWH | Original orientation: Length along the container length, Width across the width, Height vertical |
WLH | Rotated 90° horizontally: Width along the container length, Length across the width, Height vertical |
LHW | On its side: Length along the container length, Height across the width, Width vertical |
HLW | Height along the container length, Length across the width, Width vertical |
WHL | Width along the container length, Height across the width, Length vertical |
HWL | Height along the container length, Width across the width, Length vertical |
The Width, Height, and Length columns in the CSV always reflect the oriented dimensions — the space the item occupies across the container width, vertically, and along the container length respectively, after the rotation has been applied.
Units
The CSV is always exported in metric units — dimensions in millimeters, weight in kilograms — regardless of the display unit preference in Settings. This keeps the file format stable for automated importers: column headers are always (mm) and (kg).
If your WMS expects imperial input, convert during import. A silent mm-vs-inch mismatch causes significant positioning errors.
Integration Notes
The CSV is suitable for direct import into most WMS platforms. Common integration patterns:
- Pick sequence generation — the rows are already in loading order; number them on import if your system needs explicit step numbers
- Position verification — compare exported positions with physical measurements to validate the load
- ERP back-writing — import Container and Position data to update shipment records
- Custom label generation — use Item Name, SKU, Load Step, and Position columns to generate placement labels
For richer data including compliance checks and score breakdowns, use the Excel export instead.