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.

Setup

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

# Configure warehouse locations
$ hyperfold fulfill location list
# 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
# View inventory by warehouse
$ hyperfold fulfill inventory --location=wh_la_001

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

# Configure shipping rates and carriers
$ hyperfold fulfill carrier list
# 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

Automation

// ShipStation automation rules - Auto-fulfill orders meeting criteria
// Agent workflow for fulfillment
@OnACPEvent("order.confirmed")
async handleOrderFulfillment(event: OrderEvent) {
  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)
  });
  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%)