A lightweight Node.js utility designed to simulate high-fidelity ShipEngine (SSAPI) tracking webhooks. This tool allows developers to test tracking integrations for FedEx, UPS, and USPS without needing real-world tracking numbers or carrier API credentials.
- Multi-Carrier Support: Pre-configured templates for FedEx, UPS, and USPS using authentic carrier event codes.
- Dynamic Time-Travel: Automatically calculates
occurred_atandcarrier_occurred_attimestamps based on relative offsets to simulate a multi-day journey. - Web Dashboard: A built-in UI to trigger simulations, customize tracking numbers, and select statuses (Accepted, In Transit, Exception, Delivered).
- Activity Log: Real-time history of fired webhooks directly on the dashboard.
- Security Ready: Includes simulated ShipEngine HMAC/RSA headers for signature verification testing.
-
Clone the repository:
git clone <your-repo-url> cd shipstation-api-tracking-simulator
-
Install dependencies npm install
-
Start the simulator npm run dev
-
Access the Dashboard Open http://localhost:3000 in your browser
- Enter your webhook URL
- Enter a tracking number
- Select the carrier and desired status
- Click Fire Webhook
- Check your endpoint to see the incoming JSON payload
- /payloads : JSON templates containing carrier specific event logic
- /public : Frontend assets for the web dashboard
- index.js : The core express server and simulation engine
MIT