Shopify Store Management (ERPNext)

Enterprise Shopify connector for ERPNext - products, orders, customers, inventory with honest sync reporting

Enterprise Shopify connector for ERPNext by ECOSIRE — products, orders, customers, and inventory with honest sync reporting (every run records created / updated / skipped / failed with per-item reasons — never an unconditional green toast).

This repository hosts BOTH implementations of the product: Odoo on branches 17.0 / 18.0 / 19.0 (+ main), ERPNext on branches version-15 / version-16. One license key covers your platform — the license server differentiates by platform.

Requirements (ERPNext branches)

• Frappe / ERPNext v16 (version-16) or v15 (version-15)
• [ecosire_connect](https://github.com/ecosire/ecosire_connect) — ECOSIRE connector framework
• [ecosire_license_client](https://github.com/ecosire/ecosire_license_client) (branches version-15/16) — license client
• A valid ECOSIRE license key for shopify_store_management (get one)

Setup

1. License: create an Ecosire License record — App Name shopify_store_management, your key → Activate. 2. Shopify token: in your Shopify admin create a custom app (Settings → Apps → Develop apps) with scopes read_products, read_orders, read_customers, read_inventory, write_inventory, read_locations and copy the Admin API access token. 3. Store: create a Shopify Store record — shop URL (mystore.myshopify.com), token, ERPNext defaults (company, warehouse, item group, price list) → Test Connection (captures the Shopify location used for inventory push). 4. Enable the syncs you want. Manual "Sync Now" buttons are on the store form; results land in Ecosire Sync Log.

Sync matrix (pilot)

| Flow | Direction | Schedule | Notes | |---|---|---|---| | Products/variants | Shopify → ERPNext Items + mappings | hourly | match SKU → barcode → name, else create | | Customers | Shopify → ERPNext Customers | hourly | idempotent by Shopify customer id | | Orders | Shopify → DRAFT Sales Orders | 15 min | unmapped line / foreign currency ⇒ skipped with reason | | Inventory | ERPNext Bin qty → Shopify | 10 min | ERP is stock master |

Deferred to parity releases

Webhooks (real-time), refunds → credit notes, fraud/risk scoring, payouts, analytics dashboard, collections, product export, OAuth app flow. The Odoo branches already ship most of these; ERPNext parity lands by wave.

Requirements

• ERPNext v15 or v16 (Frappe Framework)
• ECOSIRE Connect (ecosire_connect) — included foundation app
• ECOSIRE License Client (ecosire_license_client) — included foundation app