shipstation-orders

# ShipStation Order Monitor

Monitor ShipStation for new orders and issues. Perfect for e-commerce businesses using ShipStation to aggregate orders from multiple marketplaces.

## Features

- ✅ New order notifications
- ⚠️ Alert for orders stuck in processing (>48h)
- 🛑 Flag orders on hold
- 🚚 Immediate alert for expedited/2-day/priority orders
- 📊 Daily summary reports
- 🔄 Automatic state tracking (avoids duplicate alerts)

## Requirements

- ShipStation account with API access
- Node.js (included with OpenClaw)

## Setup

### 1. Get ShipStation API Credentials

1. Log into ShipStation
2. Go to **Settings** → **Account** → **API Settings**
3. Use **Legacy API** (V1) - generate API Key + API Secret

### 2. Configure Credentials

Create `.env` file in your workspace:

```bash
SHIPSTATION_API_KEY=your_api_key_here
SHIPSTATION_API_SECRET=your_api_secret_here
```

### 3. Test the Monitor

```bash
node check-orders.js
```

Output shows:
- Total orders in last 24h
- New orders detected
- Any alerts

Exit codes:
- `0` - Success, no alerts
- `1` - Success, alerts found
- `2` - Error (API failure, bad credentials)

### 4. Set Up Heartbeat Monitoring (Optional)

Add to your agent's `HEARTBEAT.md`:

```markdown
## Check Orders

Every 15 minutes:

1. Run: `node check-orders.js`
2. Parse results
3. If new orders or alerts → notify via sessions_send
4. If nothing → HEARTBEAT_OK
```

Or use a cron job for scheduled checks.

## Usage

### Manual Check

```bash
node check-orders.js
```

### In Agent Heartbeat

```javascript
const { exec } = require('child_process');

exec('node check-orders.js', (error, stdout, stderr) => {
  const results = JSON.parse(stdout);
  
  if (results.newOrdersList.length > 0) {
    // Notify about new orders
  }
  
  if (results.alerts.length > 0) {
    // Notify about issues
  }
});
```

## Alert Conditions

**New Orders:**
- Any order in `awaiting_shipment` or `awaiting_payment` status

**Issues Flagged:**
- Orders awaiting shipment > 48 hours
- Or...

# ShipStation Order Monitor

OpenClaw skill for monitoring ShipStation orders and detecting issues.

## Quick Start

```bash
# 1. Copy .env.example to .env and add your credentials
cp .env.example .env

# 2. Edit .env with your ShipStation API key + secret

# 3. Test it
node check-orders.js
```

See [SKILL.md](SKILL.md) for full documentation.

## What It Does

- Monitors orders from all your connected marketplaces (Amazon, Etsy, Shopify, TikTok, etc.)
- Alerts you about new orders
- Flags orders stuck in processing (>48h)
- Detects orders on hold
- Alerts on expedited / second-day / priority orders
- Tracks state to avoid duplicate notifications

## Scripts

- `check-orders.js` → order intake + issue detection
- `check-shipping.js` → expedited shipping alert detection

## Install via ClawHub

```bash
clawhub install shipstation-orders
```

## License

MIT