ERPNext Universal Marketplace Connector Framework (SDK)

ECOSIRE builds you a proper Frappe app — its own module, DocTypes, hooks.py, and fixtures — that factors all the common work into one reusable core. At the center is a pluggable channel adapter interface: a Python base class with a fixed contract (fetch_orders, push_inventory, push_price, acknowledge_fulfilment, normalize_payload) that each channel subclasses. A Marketplace Channel DocType holds per-channel credentials and settings, and a shared sync engine — driven by Frappe scheduler_events and background jobs on the long/default queues — walks every enabled channel on a cadence you set, so adding a new marketplace means writing one adapter, not another integration. Field mapping is data, not code: a visual mapping UI (child-table DocTypes plus a client script) lets your team map channel fields to ERPNext fields, set transforms and defaults, and match SKUs to Item codes without redeploying. hooks.py doc events keep ERPNext the source of truth — a stock movement on Stock Ledger Entry or a price change on Item Price enqueues an outbound push automatically.

Reliability is built into the core rather than bolted on. Every outbound call goes through a rate-limit-aware request queue that respects each channel's throttle (token-bucket per channel key) so you never trip 429s during a big catalogue push. Failures are captured in a Connector Error Log DocType with the full request/response, classified as retryable or fatal, and retried with exponential backoff; anything that exhausts its retries lands in a dead-letter queue an operator can inspect, edit, and replay from the ERPNext desk — no lost orders, no silent drops. Whitelisted methods (@frappe.whitelist()) expose webhook receivers and manual-sync triggers, permissions and role profiles (a "Marketplace Manager" role) gate who can edit mappings versus who can only view logs, and structured logging plus a sync dashboard give you observability across every channel at once. It targets ERPNext/Frappe v15 and v16.

Because this is build-to-order, you are not downloading a finished app — you are commissioning one scoped to the channels and DocTypes you actually use. We start with a short scoping call to confirm your target marketplaces, sync directions, and volume, then build your version of the framework (core plus the specific adapters you need to seed it), validate it on a staging bench through UAT, and hand over installable source and the git repository. Typical delivery is 2–4 weeks from confirmed scope depending on how many channel adapters ship in the first release. You keep the code, so your team can author further adapters against the same interface long after go-live.