Location Snapshots
Table of Contents
- 1. Use Cases — 3 common scenarios
- 2. Features — Filter / Summary Stats / Trend Chart / Data Table
- 3. FAQ — 5 FAQs + Notes
- 4. Related Features
1. Use Cases
Quick Links: Query monthly storage statistics | Analyze shelf type usage trends | Export details for billing
Scenario 1: Query monthly storage statistics
Situation: At month-end, you need to calculate a merchant's storage usage for warehouse fee billing.
Steps:
- Select date range (use the "Last Month" shortcut)
- Select the merchant
- Click "Generate Report"
Result: The page displays "Total Location-Days", "Avg Daily Locations" and "Total Units"—ready for billing calculations.
Scenario 2: Analyze shelf type usage trends
Situation: The warehouse manager wants to understand usage trends by shelf type to plan storage allocation.
Steps:
- Select a longer date range (e.g., this month or last month)
- Select a merchant
- Click "Generate Report"
- View the trend chart to observe usage changes by shelf type
Result: The trend chart shows daily usage for each shelf type in different colors, clearly revealing peaks and valleys.
Scenario 3: Export details for billing
Situation: Finance needs detailed storage records for invoice reconciliation or to provide to merchants.
Steps:
- Select date range and merchant
- Click "Export Detail"
Result: When the export finishes, the file downloads automatically. It contains daily per-location usage details, suitable for financial reconciliation or sharing with merchants.
2. Features
Location Snapshots provides storage usage statistics for merchants over a specified time period. The system records daily storage status for each location, allowing you to query statistics, analyze trends, and export detailed reports. This data is typically used for calculating storage fees (billed by location-days).
Quick Jump: Filter Section | Summary Statistics | Trend Chart | Data Table
2.1 Filter Section
| Filter | Purpose | How to Use |
|---|---|---|
| Date Range | Specify the query period | Select start and end dates from the date picker |
| Merchant | Select the merchant to query | Choose from the dropdown menu; type to search by name |
Date Presets:
- Last Month: Automatically selects first to last day of the previous month
- This Month: Automatically selects first day of current month to today
💡 Tip: You can query data from up to 13 months ago.
2.2 Summary Statistics
After generating the report, the page displays these statistics:
| Metric | Description |
|---|---|
| Total Location-Days | Sum of all location usage days (billing basis) |
| Avg Daily Locations | Average number of locations used per day |
| Total Units | Total quantity of items stored across all locations |
2.3 Trend Chart
When query results span multiple days, the system displays a line chart:
- X-axis: Date
- Y-axis: Location count
- Multiple lines: One line per shelf type, distinguished by color
💡 Tip: Hover over the chart to view detailed data for each date.
2.4 Data Table
| Column | Description | Sortable | Filterable |
|---|---|---|---|
| Date | The snapshot record date | Yes | No |
| Shelf Type | The type of shelf (e.g., standard shelf, pallet location) | No | Yes |
| Location Count | Number of locations used for that type on that day | Yes | No |
| Total Quantity | Total items stored in that shelf type on that day | Yes | No |
The table footer shows a "Subtotal" for the current page.
3. FAQ
3.1 FAQ
▪ What are "location-days"?
Location-days are the basis for calculating storage fees. If a merchant uses 10 locations on a given day, that equals 10 location-days. The sum across all days in a month gives the total location-days.
▪ When is snapshot data generated?
The system automatically records the storage status of all locations at a fixed time each day, creating that day's snapshot.
▪ Why is there no data for certain dates?
Possible reasons:
- The merchant didn't use any locations on that date
- The snapshot hasn't been generated yet (today's snapshot is typically created the next day)
- System maintenance or issues on that day
▪ What does the exported file contain?
The exported file is a day-by-day, location-by-location detail report including date, shelf location, zone, temperature, shelf type, product SKU and name, and stored quantity—more comprehensive than the summary shown on the page. The file downloads automatically when the export finishes.
▪ How far back can I query data?
The system retains location snapshot data for the past 13 months. Data beyond this period cannot be queried.
3.2 Notes
⚠️ Important
- You must select both a date range and merchant to generate reports
- Location snapshot data is for reference only; actual billing is based on the billing system
- Exporting large amounts of data may take a few minutes; the file downloads automatically when done
- Review storage usage trends regularly to adjust inventory strategies
4. Related Features
- Shelves: Manage warehouse shelf configuration
- Inventory List: View real-time inventory status
- Billings: View warehouse billing details