Direct Answers · ERPNext Developer SDK
Q: How does the Quantbit ERPNext Developer SDK help ISVs build custom integrations?

Quantbit's Developer SDK provides a documented REST API layer built on top of ERPNext's native Frappe API, pre-built authentication patterns in OAuth 2.0 and API key formats, a webhook infrastructure for event-driven integrations, and a dedicated sandbox ERPNext environment for development and testing. The SDK abstracts the complexity of ERPNext's internal document model so integration partners can build faster without needing deep Frappe framework expertise. Partner support is available during development for architecture questions and API troubleshooting.

Q: What do ERPNext integration partners need to build a connector for their software product?

To build a certified ERPNext connector through Quantbit's partner programme, an ISV needs access to ERPNext's REST API documentation, a sandbox environment with representative data for testing, and understanding of ERPNext's core document model. Quantbit's Developer SDK provides all of this alongside pre-built patterns for common integration scenarios — inbound webhook handling, outbound data push, scheduled batch sync, and bidirectional field mapping. Partners also receive a technical review before certification to ensure the integration follows Quantbit's data quality and security standards.

🧑‍💻 Developer SDK

Build the ERPNext Integration Your Customers Keep Asking For.

ISVs, system integrators, and technology partners — if your customers use ERPNext and your software, they want the two to work together. Quantbit's Developer SDK gives you the infrastructure, documentation, and sandbox environment to build it right and certify it fast.

JavaScript · Quantbit ERPNext SDK
// Initialize the ERPNext connector import { QuantbitERPNext } from '@quantbit/erpnext-sdk';   const erp = new QuantbitERPNext({ baseUrl: 'https://yourcompany.erpnext.com', apiKey: process.env.ERP_API_KEY });   // Push a sales order from your app to ERPNext const order = await erp.createDocument({ doctype: 'Sales Order', customer: 'Ramesh Traders', items: [{ item_code: 'SKU-001', qty: 100 }] });   // Subscribe to ERPNext webhook events erp.onWebhook('Payment Entry', async (event) => { await updateYourSystem(event.data); });   // ✓ Certified · ✓ Tested in sandbox · ✓ Ready
SDK Components

Everything You Need to Build a Production-Ready ERPNext Integration

Building on ERPNext's Frappe API directly is powerful but complex. The Quantbit Developer SDK gives you the building blocks to go from idea to certified integration faster.

📡

REST API Layer

A documented, versioned REST API on top of ERPNext's native Frappe API — with consistent response formats, standardized error codes, and predictable endpoint patterns across all ERPNext doctypes.

  • CRUD operations for all standard ERPNext doctypes
  • Consistent JSON response envelope
  • Pagination and filtering parameters
  • Bulk operations for high-volume integrations
  • Rate limiting documentation and headers
  • Versioned endpoints (breaking changes announced 90 days ahead)
  • OpenAPI 3.0 specification available
🔔

Webhook Infrastructure

Event-driven integrations react to ERPNext events in real time — invoice submission, payment entry, work order completion, stock movement. Our webhook layer handles delivery, retry, and signature verification.

  • Webhook endpoint registration via API
  • HMAC-SHA256 signature for payload verification
  • Configurable retry with exponential backoff
  • Webhook delivery log in developer portal
  • Batch event delivery option for high-frequency events
  • Event filtering by doctype and field conditions
  • Test event delivery from sandbox
🔐

Authentication & Security

Multiple authentication methods to fit how your integration architecture works — API keys for server-to-server, OAuth 2.0 for user-authorized integrations, and token refresh for long-running processes.

  • API Key + Secret (server-to-server)
  • OAuth 2.0 Authorization Code Flow
  • OAuth 2.0 Client Credentials Flow
  • Token refresh handling in SDK client libraries
  • Scoped permissions per integration
  • IP allowlist for server-to-server integrations
  • mTLS option for high-security environments
🧪

Sandbox Environment

A full ERPNext sandbox instance with representative test data — customers, items, invoices, and transactions — so you can develop and test your integration without touching production data or bothering a live customer.

  • Dedicated sandbox URL per registered partner
  • Pre-loaded with realistic test data
  • Sandbox reset on request (monthly or on-demand)
  • Webhook test delivery tool
  • API request inspector and log
  • ERPNext v14 and v15 sandbox options
  • Data seeding scripts for your specific use case
📚

Documentation & Guides

Practical documentation written for developers who have not worked with ERPNext before — not just API reference, but architecture guides, common integration patterns, and worked examples.

  • ERPNext document model overview for integrators
  • Common integration pattern cookbook
  • API reference with request and response examples
  • Authentication implementation guides (all methods)
  • Error handling and retry recommendations
  • ERPNext permission model explained
  • Postman collection downloadable

Certification Programme

A structured review process that validates your integration against Quantbit's quality and security standards before it is listed in the integration directory and marketed to shared customers.

  • Technical review of integration architecture
  • Security assessment (auth, data handling)
  • Functional testing against certification test suite
  • "Quantbit Certified Integration" badge on approval
  • Listing in Quantbit integration partner directory
  • Co-marketing to Quantbit customer base
  • Annual re-certification for major version changes
Partner Programme

Three Tiers. Designed for Where You Are Today.

Whether you are an individual developer building your first ERPNext connector or an established ISV looking for co-selling support, there is a partner tier that fits your stage.

Silver Partner

Registered Developer

For: Freelancers, agencies, and early-stage ISVs building their first ERPNext connector

  • Sandbox environment access
  • Full API documentation
  • Community forum support
  • Postman collection
  • SDK client library (JS / Python)
  • Standard certification path
  • Integration directory listing (post certification)
Gold Partner

Technology Partner

For: ISVs with an established product that serves 10+ ERPNext customers or has a clear mutual customer base

  • Everything in Silver
  • Dedicated partner sandbox with custom data
  • Priority technical support (email, 48-hr SLA)
  • Architecture review session (2 hours)
  • Co-marketing in Quantbit customer newsletter
  • Referral to Quantbit customers who need your product
  • Joint case study development
  • Revenue share on referred implementations
Platinum Partner

Strategic Partner

For: Established software companies with significant customer overlap and commitment to joint go-to-market

  • Everything in Gold
  • Dedicated partner manager at Quantbit
  • Priority technical support (chat, 4-hr SLA)
  • Co-branded integration documentation
  • Joint webinars and content creation
  • Featured placement in integration directory
  • Early access to new ERPNext versions for testing
  • Quarterly business review with Quantbit leadership
  • Reseller agreement option
Partner Stories

Why Partners Built Their ERPNext Connector — and What Happened After

The decision to build an ERPNext connector is almost always driven by the same thing — a customer asking for it. These are the stories of what happened when partners decided to invest in the integration rather than treating it as a one-off custom job.

HR SaaS · Pune

The HR Software Company That Kept Getting the Same Request From Different Customers

A Pune-based HR and payroll SaaS company had been receiving the same request from three different customers independently over eighteen months: "Can your payroll system talk to ERPNext?" Each time, the customer wanted payroll journal entries to post automatically to ERPNext — their company's books were in ERPNext and the manual process of transferring payroll figures was error-prone and time-consuming. The product team had put the integration on the roadmap three times and deprioritized it each time because building a one-off ERPNext integration seemed like too much effort for uncertain revenue. When the fourth customer asked and threatened to switch to a competitor that had an ERPNext connector, the product head decided to invest. Using Quantbit's Developer SDK, they built the integration in six weeks — monthly payroll summary, department-wise cost allocation, and salary component mapping to ERPNext accounts. Within three months of publishing the integration, they had signed two new ERPNext customers who had chosen them specifically because of the connector. The integration had paid for itself before the end of the quarter.

✦ Built in 6 weeks using SDK; 2 new ERPNext customers signed in 3 months; integration paid for itself in the same quarter
Logistics SaaS · Mumbai

The Transport Management System That Turned ERPNext Into a Complete Sales-to-Delivery Platform

A Mumbai-based Transport Management System (TMS) company was serving medium-sized logistics businesses across India. Several of their clients were also ERPNext users — and the disconnect between ERPNext sales orders and the TMS was creating daily friction. Someone had to manually transfer delivery information from ERPNext to the TMS, and tracking updates from the TMS never made it back to ERPNext. The TMS company built a certified integration using Quantbit's SDK: when a delivery note is created in ERPNext, a shipment is automatically created in the TMS. When the TMS updates the delivery status, it pushes back to the Delivery Note in ERPNext. When the shipment is delivered, the proof of delivery links to the ERPNext document. The integration took eight weeks to build and certify. Since listing on Quantbit's partner directory, the TMS company has been introduced to eleven of Quantbit's logistics and trading customers — five of whom have become TMS customers as a direct result of the ERPNext integration partnership.

✦ 8 weeks to certified integration; 5 new customers from Quantbit partnership in first year; ERPNext now a sales channel
Quality Management SaaS · Nashik

The Quality Software That Could Not Compete Against "Let's Just Do It in ERPNext"

A quality management SaaS company in Nashik was selling their non-conformance and CAPA (Corrective and Preventive Action) management software to manufacturers. The objection they kept hearing in manufacturing companies that ran ERPNext was: "Why do we need separate quality software when ERPNext has quality modules?" It was a difficult objection to counter — ERPNext's quality features are reasonable, even if the QMS company's product was significantly more capable for ISO 9001 and IATF 16949 compliance. When they built a certified ERPNext integration — quality inspections in ERPNext automatically create non-conformance reports in their QMS, and CAPA closures in the QMS update the ERPNext quality record — the objection disappeared. Instead of competing with ERPNext, their software now extended it. The demo changed completely: rather than showing a standalone system, they showed ERPNext and their QMS working together. Win rate against the "let's just use ERPNext quality" objection went from 20% to 65%.

✦ Win rate against "just use ERPNext quality" objection went from 20% to 65%; integration became the product's most effective demo asset
Retail Analytics · Bengaluru

The Analytics Company That Did Not Realise ERPNext Was Already in Half Their Customers

A retail analytics company in Bengaluru was selling sell-through analysis and demand forecasting tools to consumer goods brands and retail chains. When they surveyed their 40 existing customers to understand what systems they used for inventory and sales data, they discovered that 18 of them were running ERPNext — and in every case, getting data from ERPNext into the analytics platform was a manual monthly exercise. Someone exported CSVs from ERPNext, cleaned them up, and uploaded them to the analytics platform. The analytics company built an ERPNext integration that pulled daily sales, inventory, and purchasing data automatically. For the 18 customers already on ERPNext, it was an immediate upgrade — daily analysis instead of monthly. For prospects who were ERPNext users, it was a strong differentiator. And Quantbit's partnership introduced them to ten additional ERPNext customers they had not previously reached. The integration went from a gap in their product to a genuine competitive advantage in their target market.

✦ 18 existing customers moved from monthly manual exports to daily automatic sync; 10 new prospects via Quantbit partnership
Technical Specs

The Technical Foundation Your Integration Team Needs to Know

For the engineering team evaluating what it will take to build and maintain an ERPNext integration using the Quantbit SDK.

API Standards

  • REST over HTTPS (TLS 1.2+)
  • JSON request and response bodies
  • OpenAPI 3.0 specification
  • Standard HTTP status codes
  • Idempotency keys for safe retries
  • Cursor-based pagination

SDK Client Libraries

  • JavaScript / TypeScript (Node.js + browser)
  • Python 3.8+
  • PHP 8.0+ (community maintained)
  • REST client examples for all languages
  • Postman collection (OAuth + API key)
  • GitHub repositories with examples

Authentication

  • API Key / Secret (HMAC signed)
  • OAuth 2.0 (Authorization Code)
  • OAuth 2.0 (Client Credentials)
  • Access token TTL: 1 hour (configurable)
  • Refresh token TTL: 30 days
  • Per-scope permission model

Webhooks

  • HTTPS endpoint registration
  • HMAC-SHA256 signature header
  • Retry: 3 attempts, 5/30/120 sec backoff
  • Delivery guarantee: at-least-once
  • Idempotency via event_id field
  • Test delivery from developer portal

Rate Limits

  • Default: 100 requests/minute per API key
  • Burst: 500 requests/minute for 10 seconds
  • Bulk endpoints: separate higher limit
  • Rate limit headers in every response
  • Higher limits available for Platinum partners

Support & SLA

  • Silver: community forum (best effort)
  • Gold: email, 48-hour response
  • Platinum: chat + email, 4-hour response
  • Architecture review for Gold+
  • Certification process: 2–4 weeks
FAQs

What Engineering and Product Teams Ask Before Starting

Do we need to know the Frappe Framework deeply to build an ERPNext integration?
No — and this is one of the key reasons the SDK exists. ERPNext is built on the Frappe framework, which has its own patterns, terminology, and conventions that are unfamiliar to developers coming from other stacks. The Quantbit SDK abstracts the Frappe-specific complexity and presents a more conventional REST API interface. You do need to understand ERPNext's document model — what doctypes exist, how they relate to each other, what the key fields are — but our documentation covers this specifically for integration developers, not Frappe app developers.
How do we handle ERPNext version upgrades? Will our integration break when the customer upgrades?
Quantbit maintains a versioned API layer that insulates integrations from ERPNext's internal changes. We announce breaking changes 90 days ahead of deprecation, giving partners time to update their integrations. For most minor and patch ERPNext upgrades, the API layer remains stable and integrations are unaffected. For major ERPNext versions (v14 to v15, for example), we test the API layer against the new version and release updated compatibility notes to partners. Certified partners receive early access to new versions for pre-release testing.
Can we build an integration that works with self-hosted ERPNext instances as well as Frappe Cloud?
Yes. The Quantbit SDK works with both Frappe Cloud hosted ERPNext and self-hosted ERPNext instances, as long as the ERPNext instance has network accessibility (usually via a public URL or VPN). For self-hosted customers, the integration setup requires the customer's IT team to whitelist the partner's IP addresses or configure an API gateway. Our documentation includes specific guidance for self-hosted deployment scenarios, which are common in manufacturing and healthcare customers in India who prefer on-premise ERPNext.
Is there a revenue share arrangement for partners who generate new ERPNext customers for Quantbit?
Yes — Gold and Platinum partners participate in a referral revenue share programme. When a customer signs up for Quantbit's ERPNext implementation or subscription services as a result of an introduction from a partner, the partner receives a referral commission. The specifics of the revenue share — percentage, qualifying conditions, and payment timing — are outlined in the partner agreement signed at Gold or Platinum tier. Partners who generate consistent customer introductions can progress to a reseller model with different commercial terms.
How long does the certification process take, and what does it involve?
The certification process typically takes two to four weeks from submission to approval. It involves three stages: a technical architecture review where we assess your integration design for security, reliability, and ERPNext best practices; a functional testing phase where we run your integration against our certification test suite in the sandbox environment; and a security check covering authentication implementation, data handling, and error disclosure. Partners receive detailed feedback at each stage and can iterate before final approval. The process is designed to be thorough but not bureaucratic — the goal is ensuring integrations that Quantbit's customers install are high quality and secure.

Your Customers Are Already Asking for the ERPNext Connector. Build It Once. Deploy It Everywhere.

Apply to the Quantbit Partner Programme and we will get you into the sandbox and building within a week. No long partner agreements upfront — start with Silver and grow from there.

Apply to Partner Programme →