ShipStation Integration for ERPNext

Seamless shipping, label generation, and order fulfillment for ERPNext

Report Bug · Request Feature

Table of Contents

1. About The Project
2. Installation
3. Configuration
   • API Options
4. Contributing
5. License

About The Project

ShipStation Integration connects your ERPNext instance with ShipStation for streamlined order management, shipping label generation, and fulfillment tracking. It supports both the classic ShipStation API (v1) and the newer ShipStation API v2 for enhanced carrier access and rate shopping.

Features

Multi-Account & Store Management

• Sync multiple ShipStation accounts with a single ERPNext instance
• Configure individual stores with different companies, warehouses, cost centers, and account heads
• Periodically fetch products, orders, and shipments from all connected accounts
• Amazon marketplace integration with hooks for custom order processing

Shipping & Labels (v1)

• Shipping label generation directly from Delivery Notes
• Configurable per ShipStation account

Rate Shopping & Labels (v2)

• Compare rates across multiple carriers before purchasing
• Direct label generation without requiring orders in ShipStation
• Rate shopping UI in Delivery Notes — view pricing and select the best option
• Void labels when needed

Fulfillment Sync (v2)

• Push fulfillment data back to connected marketplaces
• Automatic tracking number updates

Webhooks

• v1 store-based webhooks for order and shipment events
• v2 environment-based webhooks for batch completion and tracking updates

(back to top)

Installation

1. Navigate to your bench directory

   cd frappe-bench

2. Get the app

   bench get-app https://github.com/AgriTheory/shipstation_integration

3. Install the app on your site

   bench --site your-site.localhost install-app shipstation_integration

4. Run migrations

   bench --site your-site.localhost migrate

(back to top)

Configuration

1. Navigate to Shipstation Settings in ERPNext
2. Enter your ShipStation API credentials (v1: API Key + Secret)
3. Optionally enable ShipStation API v2 and enter your v2 API key for rate shopping and direct label generation
4. Configure your stores, linking each to the appropriate company and warehouse
5. Set up webhooks to receive order and shipment updates

API Options

This integration supports the classic ShipStation API (v1), the newer ShipStation API v2, or both together. You can choose based on your needs:

v1 Only — Use if you need to sync orders from ShipStation-connected marketplaces (Amazon, Shopify, etc.) and generate labels through ShipStation's order workflow.

v2 Only — Use if you just need to ship packages and compare rates without marketplace integrations. Labels can be purchased directly without orders existing in ShipStation.

Both — Get the full feature set: order management flows through v1, while v2 provides rate shopping and direct label purchase capabilities.

Feature	v1 Only	v2 Only	Both
Order sync from marketplaces	✓		✓
Auto-shipment creation	✓		✓
Store management	✓		✓
Rate shopping before purchase		✓	✓
Direct label purchase		✓	✓
Fulfillment push to marketplaces		✓	✓
Tags & product import	✓		✓

To configure:

• v1: Check Enabled and enter your API Key + API Secret
• v2: Check Enable ShipStation API v2 and enter your ShipStation API Key

(back to top)

Contributing

Contributions are welcome! Please see the contribution guidelines for more information.

(back to top)

License

Distributed under the MIT License. See license.txt for more information.

(back to top)