Application Integration Manual
Two different stories:
| Path | One-line summary |
|---|---|
| Marketplace App | Metadata package executed by Qefro Runtime. No backend required. |
| External SDK Connection | Connect an existing ERP / POS / CRM with the Qefro SDK over /qefro. |
Developer → Create App Metadata → Validate → Package → Publish
→ Install into Workspace → Qefro Runtime
External ERP / POS / CRM → Qefro SDK → /qefro → Qefro Runtime
Do not start from “write a /qefro server to publish a Marketplace
App.” That is the external-integration path.
Full comparison: Runtime vs SDK.
Start here
- Build your first app — metadata Marketplace App
- Runtime vs SDK — which path you are on
- Building Applications for Qefro — both paths in one manual
- Integration models
Tutorials
| Tutorial | Path | Reference implementation |
|---|---|---|
| Managed Marketplace App | Metadata → Runtime | restaurant-pro-runtime, real-estate-runtime, shopify-runtime (collection) |
| External SDK Connection | SDK → /qefro | abm-demo, mock-order-status-sdk (Focus / Yaaz / ABM style) |
| Migration: External → Managed | SDK packaging | Same SDK app, different plumbing |
Protocol & SDK (external systems)
| Topic | Doc |
|---|---|
| SDK application development | sdk-application-development.md |
/qefro protocol | qefro-protocol.md |
| Tools | tools.md |
| Authentication (HMAC) | authentication.md |
| Tenancy & workspaces | tenancy-and-workspaces.md |
Platform capabilities
| Capability | Doc |
|---|---|
| Managed storage | storage.md · solutions/managed-storage |
Customer Hub (ctx.customer) | customer-hub.md |
| Organization | organization.md |
| Marketing | marketing.md |
| Workflows / FlowRunner | workflows.md · solutions/workflows |
Ship & operate
| Topic | Doc |
|---|---|
| Deployment (SDK processes) | deployment/external-and-managed.md |
| Marketplace publishing | marketplace-publishing.md |
| Testing | testing.md |
| Security | security.md |
| Troubleshooting | troubleshooting.md |
Related docs (existing hubs)
- Solution Development — metadata packaging, UI, marketplace
- Register SDK Business Tools — Org Portal sync walkthrough
- JavaScript SDK — language-specific API notes
Verified against: Marketplace hosting: runtime packages
(restaurant-pro-runtime), @qefro-ai/backend 1.7.0 for the SDK
path, protocol version 1.