Multi-Shop Setup¶
Manage multiple Etsy shops from a single ERPNext instance.
How It Works¶
- Create one Etsy Shop document per Etsy shop
- Each shop has:
- Independent OAuth credentials
- Separate configuration (naming series, accounts, etc.)
- Isolated synchronization (one shop's sync doesn't affect another)
Benefits¶
- Centralized Management: View and manage all shops from one ERPNext instance
- Separate Accounting: Configure different accounts per shop for clean financial reporting
- Scalability: Add new shops without changing the setup
Example Setup¶
ERPNext Instance
├── Etsy Shop: "Handmade Jewelry"
│ ├── Company: My Business LLC
│ ├── Customer Naming: JewelryCustomer-{ETSY_BUYER_ID}
│ └── Bank Account: Jewelry Etsy Account
├── Etsy Shop: "Vintage Clothing"
│ ├── Company: My Business LLC
│ ├── Customer Naming: VintageCustomer-{ETSY_BUYER_ID}
│ └── Bank Account: Vintage Etsy Account

Cross-Shop Considerations¶
- Customer Matching: If the same Etsy buyer purchases from multiple shops, separate Customers are created (because naming series differ)
- To unify customers, use the same naming series and Customer Group across shops
- Item Conflicts: If two shops sell items with the same Etsy Product ID, the
etsy_product_idunique constraint prevents conflicts
Configuration Tips¶
- Create separate Etsy Shop documents for each shop
- Use different naming series to distinguish orders (e.g.,
Shop1-,Shop2-) - Consider using different companies or cost centers for accounting separation
- Stagger sync schedules to distribute server load