The ERPNext Medusa Integration is a Frappe app that creates a live bridge between your ERPNext instance and a Medusa headless eCommerce storefront. Products you publish in ERPNext automatically appear in your Medusa catalog; orders placed in your storefront flow back as Sales Orders, Invoices, and Delivery Notes — all without manual data entry.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/aerele/medusa_integration/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Install the app via bench and complete your first product sync in under 10 minutes.
Configuration
Connect to Medusa by entering your backend URL and admin credentials in the Medusa Configuration doctype.
Sync Guides
Learn how products, orders, inventory, customers, and prices are kept in sync between both platforms.
API Reference
Full reference for every whitelisted endpoint exposed by the integration to your Medusa storefront.
How it works
The integration hooks into ERPNext’s document event system and exposes a set of whitelisted API endpoints that your Medusa storefront can call. When you save a Website Item, the app pushes it to Medusa’s product catalog. When a customer places an order, Medusa calls the integration’s quotation endpoints to create the corresponding documents in ERPNext.Install via bench
Add
medusa_integration to your ERPNext site using bench get-app and run migrations.Configure the connection
Open Medusa Configuration in ERPNext, enter your Medusa backend URL and admin credentials, and enable the integration.
Sync your catalog
Save or re-save your Website Items to push products to Medusa, or run the bulk export utility to migrate your entire catalog at once.
Key capabilities
Product sync
Publish ERPNext Website Items to Medusa, including descriptions, collections, specifications, and pricing.
Order lifecycle
Quotations, Sales Orders, Invoices, Delivery Notes, and payments — all synchronized bidirectionally.
Inventory updates
Stock levels are updated in Medusa on a daily schedule so your storefront always reflects real availability.
Customer management
Leads and Customers created in Medusa are synced to ERPNext with Medusa IDs for two-way lookup.
Price management
Standard Selling price lists and customer-specific negotiated prices are exported to Medusa price lists.
Advanced hooks
Explore all document events, scheduled tasks, and extension points available in the integration.