Etsy Integration for ERPNext

Legal Disclaimer

"Etsy" is a trademark of Etsy, Inc. This application uses the Etsy API but is not endorsed, certified, or affiliated with Etsy, Inc. in any way. This software is provided "as is" under the GPL-3.0 license, without warranty of any kind, express or implied. The authors and contributors accept no liability for any damages, data loss, account suspension, or other consequences arising from the use or misuse of this software. Use of the Etsy API is subject to Etsy's API Terms of Use — you are solely responsible for compliance.

Welcome to the official documentation for the ERPNext Etsy Integration app. This Frappe framework application seamlessly synchronizes your Etsy shop data with ERPNext, automating your e-commerce workflows.

Quick Start

Ready to get started? Follow our Getting Started guide to install the app, connect your Etsy shop, and import your first data in minutes.

Overview

The Etsy Integration app connects your Etsy shop(s) to ERPNext, enabling automatic synchronization of:

• Orders & Receipts — Sales Orders, Sales Invoices, and Payment Entries
• Customers & Contacts — Buyer information and addresses
• Listings & Items — Product catalog with variants and attributes

Built on the Frappe framework and designed specifically for ERPNext v15, this integration uses Etsy's official API v3 with secure OAuth2 authentication.

Key Features

• Sales Order Automation — Import Etsy orders as complete Sales Orders with Customers, Invoices, and Payment Entries
• Listing Management — Sync product listings with automatic Item Template, Variant, and Attribute creation
• Multi-Shop Support — Manage multiple Etsy shops from a single ERPNext instance with independent configuration
• Flexible Sync — Manual on-demand imports, scheduled background jobs, or bulk historical imports
• Secure Auth — OAuth 2.0 PKCE flow with automatic token refresh

Documentation

• Prerequisites & Installation — Install the app via Frappe Bench
• Setup Your First Etsy Shop — Create and configure an Etsy Shop in ERPNext
• Connect to Etsy API — Create an Etsy Personal App and authenticate
• First Import & Next Steps — Import data and enable automatic sync
• User Guide — In-depth configuration, features, and troubleshooting
• Developer Guide — Contributing, code style, and development setup

Support

• Issues: Report bugs and request features on GitHub Issues
• Repository: github.com/maeurerdev/erpnext-etsy

License

This project is licensed under the GNU General Public License (v3).