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.

Adding Locations

# 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

# 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

# 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:

# 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

# 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