Hyperfold AI

ShipStation Integration

Multi-carrier shipping with warehouse management and automation.

Overview

ShipStation is a leading shipping platform supporting 100+ carriers and integrations. Connect ShipStation to enable your Fulfillment Agent to automatically create shipping labels, manage inventory, and track packages.

ShipStation is recommended for merchants with multiple warehouses or carrier accounts. For simpler setups, consider Shippo.

Setup

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
40
41
42
43
44
# Connect ShipStation
$ hyperfold fulfill add shipstation
 
Enter your ShipStation API Key: xxx
Enter your ShipStation API Secret: xxx
 
Testing connection...
✓ Connected to ShipStation
 
SHIPSTATION CONNECTED
  Account:          Acme Sports
  Warehouses:       3 detected
  Carriers:         USPS, FedEx, UPS
 
Importing carrier rates...
✓ USPS rates imported
✓ FedEx rates imported
✓ UPS rates imported
 
# View connection status
$ hyperfold fulfill show shipstation
 
INTEGRATION: ShipStation
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
Account:            Acme Sports
Status:             connected
Connected:          2025-01-15T10:00:00Z
 
WAREHOUSES
  LA Warehouse       Los Angeles, CA (primary)
  Chicago DC         Chicago, IL
  NYC Fulfillment    New York, NY
 
CARRIERS
  ✓ USPS            Priority, First Class, Express
  ✓ FedEx           Ground, Express, 2Day
  ✓ UPS             Ground, Next Day Air
 
METRICS (30 days)
  Orders Created:   2,847
  Shipped:          2,834
  Avg Ship Time:    1.2 days
  On-Time Rate:     98.4%

Prerequisites

  • ShipStation account (any plan)
  • API credentials from ShipStation settings
  • At least one carrier connected in ShipStation

Warehouses

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
40
# Configure warehouse locations
$ hyperfold fulfill location list
 
WAREHOUSES
 
ID            NAME                ADDRESS                 STATUS
wh_la_001     LA Warehouse        Los Angeles, CA         primary
wh_chi_002    Chicago DC          Chicago, IL             active
wh_nyc_003    NYC Fulfillment     New York, NY            active
 
# Set warehouse priority
$ hyperfold fulfill location config wh_la_001 \
  --priority=1 \
  --regions=west,southwest \
  --cutoff-time="14:00"
 
# Configure inventory sync
$ hyperfold fulfill location sync wh_la_001 \
  --schedule="*/15 * * * *" \
  --on-order=true
 
Inventory sync configured:
  Warehouse:        LA Warehouse
  Frequency:        Every 15 minutes
  Real-time:        On order creation
 
# View inventory by warehouse
$ hyperfold fulfill inventory --location=wh_la_001
 
INVENTORY: LA Warehouse
 
SKU               PRODUCT                     QTY    RESERVED  AVAILABLE
SHOE-AERO-X2      AeroRun X2 Waterproof      45     3         42
SOCK-WOOL-M       Merino Running Socks       120    8         112
JACKET-WIND-L     Windbreaker Jacket         28     0         28
...
 
Total SKUs: 1,247
Low Stock: 23
Out of Stock: 5

Warehouse Features

FeatureDescription
Priority RoutingRoute orders to closest/preferred warehouse
Inventory SyncReal-time stock levels across locations
Cutoff TimesSame-day shipping deadlines per warehouse
Regional CoverageAssign warehouses to geographic regions

Shipping

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
40
41
# Configure shipping rates and carriers
$ hyperfold fulfill carrier list
 
CARRIERS
 
CARRIER     SERVICES                        STATUS    RATE SOURCE
USPS        Priority, First Class, Express  active    ShipStation
FedEx       Ground, Express, 2Day, Overnight active   ShipStation
UPS         Ground, Next Day, 2nd Day       active    ShipStation
 
# Set carrier preferences
$ hyperfold fulfill carrier config \
  --default=usps_priority \
  --fallback=fedex_ground,ups_ground
 
# Configure shipping rules
$ hyperfold fulfill policy create \
  --name="Standard Domestic" \
  --rules='[
    {"weight_max": 1, "carrier": "usps_first_class"},
    {"weight_max": 5, "carrier": "usps_priority"},
    {"weight_max": 50, "carrier": "fedex_ground"}
  ]' \
  --free-shipping-threshold=75
 
# View rate comparison
$ hyperfold fulfill rates \
  --origin=wh_la_001 \
  --destination="Seattle, WA 98101" \
  --weight=2
 
SHIPPING RATES: LA → Seattle, WA (2 lbs)
 
CARRIER              SERVICE          RATE      DELIVERY
USPS                 First Class      $4.50     4-5 days
USPS                 Priority         $8.75     2-3 days
FedEx                Ground           $9.20     3-4 days
FedEx                Express          $18.50    1-2 days
UPS                  Ground           $9.80     3-4 days
 
Recommended: USPS Priority ($8.75, 2-3 days)

Automation

typescript
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
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
# ShipStation automation rules
 
# Auto-fulfill orders meeting criteria
$ hyperfold fulfill automation create \
  --name="Auto-fulfill Standard" \
  --trigger="order.confirmed" \
  --conditions='[
    {"field": "shipping_method", "eq": "standard"},
    {"field": "payment_status", "eq": "captured"},
    {"field": "fraud_risk", "lt": "medium"}
  ]' \
  --actions='["create_label", "update_order", "notify_customer"]'
 
# Agent workflow for fulfillment
@OnACPEvent("order.confirmed")
async handleOrderFulfillment(event: OrderEvent) {
  // Create shipment in ShipStation
  const shipment = await this.tools.fulfillment.createShipment({
    provider: "shipstation",
    order_id: event.order.id,
    items: event.order.items,
    shipping_address: event.order.shipping,
    service: this.selectShippingService(event.order),
    warehouse: await this.selectWarehouse(event.order)
  });
 
  // ShipStation generates label and tracking
  if (shipment.status === "label_created") {
    await this.notifyCustomer({
      type: "shipped",
      tracking_number: shipment.tracking_number,
      carrier: shipment.carrier,
      estimated_delivery: shipment.estimated_delivery
    });
  }
 
  return { shipment_id: shipment.id };
}
 
# Monitor fulfillment performance
$ hyperfold fulfill stats --since=30d
 
FULFILLMENT STATISTICS (30 days)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
ORDERS
  Total:            2,847
  Fulfilled:        2,834 (99.5%)
  Pending:          13
 
PERFORMANCE
  Avg Processing:   4.2 hours
  Avg Ship Time:    1.2 days
  On-Time Rate:     98.4%
 
CARRIERS
  USPS:             1,562 (55%)
  FedEx:            854 (30%)
  UPS:              418 (15%)
 
SHIPPING COSTS
  Total:            $28,470.00
  Avg per Order:    $10.05
Configure fulfillment policies with fulfillment policy.