Hyperfold AI

fulfillment location

Configure warehouse locations and order routing for fulfillment optimization.

Overview

The hyperfold fulfill location command manages your warehouse and fulfillment center locations. Configure multiple locations to enable intelligent order routing, reducing shipping costs and delivery times.

Before adding locations, ensure you have at least one fulfillment provider configured.

Adding Locations

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# Add a warehouse location
$ hyperfold fulfill location add \
  --name="Los Angeles Warehouse" \
  --address="123 Commerce St, Los Angeles, CA 90001" \
  --provider=shipstation
 
✓ Location validated
✓ Connected to ShipStation warehouse
 
LOCATION CONFIGURED
  Location ID:       loc_la_001
  Name:              Los Angeles Warehouse
  Provider:          ShipStation
  Address:           123 Commerce St, Los Angeles, CA 90001
  Status:            active
 
# Add with priority settings
$ hyperfold fulfill location add \
  --name="Chicago Distribution Center" \
  --address="456 Logistics Ave, Chicago, IL 60601" \
  --provider=shipstation \
  --priority=2 \
  --regions=midwest,northeast

Location Management

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
# List all locations
$ hyperfold fulfill location list
 
WAREHOUSE LOCATIONS
 
ID            NAME                    ADDRESS                 PROVIDER      PRIORITY
loc_la_001    Los Angeles Warehouse   Los Angeles, CA         ShipStation   1
loc_chi_002   Chicago DC              Chicago, IL             ShipStation   2
loc_nyc_003   NYC Fulfillment         New York, NY            Shippo        3
loc_custom    In-House Warehouse      Austin, TX              Custom        4
 
# Show location details
$ hyperfold fulfill location show loc_la_001
 
LOCATION: Los Angeles Warehouse
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
Address:            123 Commerce St
                    Los Angeles, CA 90001
Provider:           ShipStation
Priority:           1 (primary)
Regions:            west, southwest
 
OPERATING HOURS
  Mon-Fri:          8:00 AM - 6:00 PM PST
  Saturday:         9:00 AM - 2:00 PM PST
  Sunday:           Closed
 
INVENTORY
  Total SKUs:       2,847
  In Stock:         2,654 (93%)
  Low Stock:        142 (5%)
  Out of Stock:     51 (2%)
 
PERFORMANCE (30 days)
  Orders Shipped:   4,521
  Avg Pick Time:    45 min
  On-Time Rate:     98.7%
  Error Rate:       0.3%

Configuration

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# Set location operating hours
$ hyperfold fulfill location config loc_la_001 \
  --hours="Mon-Fri:08:00-18:00,Sat:09:00-14:00"
 
# Configure cutoff times
$ hyperfold fulfill location config loc_la_001 \
  --same-day-cutoff="14:00" \
  --next-day-cutoff="16:00"
 
# Set regional coverage
$ hyperfold fulfill location config loc_la_001 \
  --regions=west,southwest,mountain \
  --max-distance=1500
 
# Enable/disable location
$ hyperfold fulfill location disable loc_nyc_003 \
  --reason="Renovation" \
  --until="2025-02-01"

Configuration Options

OptionDescription
--hoursOperating hours in format Day:HH:MM-HH:MM
--same-day-cutoffCutoff time for same-day shipping
--next-day-cutoffCutoff time for next-day shipping
--regionsGeographic regions served
--max-distanceMaximum shipping distance in miles
--priorityRouting priority (1 = highest)

Order Routing

Configure how orders are routed to warehouse locations:

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
# Configure order routing rules
$ hyperfold fulfill location routing \
  --strategy=nearest \
  --fallback=round_robin
 
ROUTING CONFIGURATION
  Strategy:          nearest (ship from closest warehouse)
  Fallback:          round_robin (if primary unavailable)
  Consider:          inventory, distance, capacity
 
# Set custom routing rules
$ hyperfold fulfill location routing \
  --rules='[
    {"region": "west", "location": "loc_la_001", "priority": 1},
    {"region": "midwest", "location": "loc_chi_002", "priority": 1},
    {"region": "*", "location": "loc_la_001", "priority": 2}
  ]'
 
# Preview routing for an order
$ hyperfold fulfill location route-preview \
  --destination="Seattle, WA" \
  --items='[{"sku": "SHOE-001", "qty": 2}]'
 
ROUTING PREVIEW
  Destination:       Seattle, WA
  Items:             SHOE-001 x 2
 
  Recommended:       Los Angeles Warehouse (loc_la_001)
  Distance:          1,135 miles
  Shipping Est:      $8.50 (USPS Priority)
  Delivery Est:      2-3 days
 
  Alternative:       Chicago DC (loc_chi_002)
  Distance:          2,013 miles
  Shipping Est:      $12.00 (USPS Priority)
  Delivery Est:      3-4 days

Routing Strategies

Nearest

Route to the closest warehouse with available inventory. Minimizes shipping distance and delivery time.

Priority

Route based on configured priority scores. Primary warehouse handles orders unless at capacity or out of stock.

Cost Optimized

Route to minimize total shipping cost, considering carrier rates and distance from each location.

Round Robin

Distribute orders evenly across locations to balance warehouse workload.

Inventory Sync

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# Sync inventory from location
$ hyperfold fulfill location sync loc_la_001
 
Syncing inventory from Los Angeles Warehouse...
 
INVENTORY SYNC
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
SKUs Synced:        2,847
Updated:            156
New:                12
Removed:            3
Errors:             0
 
Changes:
  SHOE-RUN-BLK-10   42 → 38 (-4)
  SOCK-WOOL-M       0 → 50 (+50)  NEW
  JACKET-WIND-L     15 → 0 (-15)  OUT OF STOCK
 
# Configure automatic sync
$ hyperfold fulfill location sync loc_la_001 \
  --schedule="*/15 * * * *" \
  --on-order=true
 
Inventory sync scheduled:
  Interval:          Every 15 minutes
  On Order:          Sync after each order
  Webhook:           Enabled for real-time updates
Inventory sync frequency affects API usage. For high-volume stores, use webhook-based real-time updates instead of frequent polling.
Next, configure fulfillment policies for shipping rules and carrier selection.