Cumulus Retail API
Cumulus Retail is Celerant's all-in-one POS and eCommerce platform for independent retailers, unifying point of sale, inventory, online stores, and marketplace selling. An unofficial API lets you programmatically pull products, inventory, orders, and customer records—and push updates like new orders, price changes, stock adjustments, and customer data back into Cumulus across every channel.
What is Cumulus Retail?
Cumulus Retail is Celerant Technology's all-in-one POS and eCommerce platform built for independent, small-to-midsize retailers. It unifies an "Always On" hybrid point of sale, integrated eCommerce websites, connected inventory, and marketplace selling so a single product, customer, and order record stays consistent across the store counter, the web store, and channels like Amazon, Walmart, and eBay.
Core product areas include:
- Point of Sale ("Always On" hybrid POS, mobile/line-busting POS, gift cards, layaways)
- eCommerce & Sales Channels (integrated web store, mobile shopping apps, BOPIS, marketplace integrations to Amazon, Walmart, eBay)
- Inventory Management (connected cross-channel inventory, vendor catalog imports, automated ordering, drop-shipping, product feeds)
- Marketing & Customer Engagement (trigger-based email marketing, SEO services, mobile push notifications)
- Back Office (centralized product and customer management, multi-channel order fulfillment, QuickBooks accounting sync)
Common data entities:
- Products, SKUs, Variants, Categories, Vendor Catalogs
- Inventory Levels, Stock Adjustments, Transfers, Purchase Orders
- Orders, Line Items, Fulfillments, Returns, Layaways
- Customers, Loyalty Records, Gift Cards
- Pricing, Promotions, Discounts, Tax Rules
- Marketplace Listings, Channel Feeds, Drop-Ship Orders
The Cumulus Retail Integration Challenge
Retailers run their entire counter-to-web operation on Cumulus, but the platform's data is largely trapped behind a vendor-managed integration model rather than an open developer API:
- No self-serve developer portal: Celerant configures integrations on your behalf—you hand API credentials to a Celerant Web Implementation Manager rather than reading public docs and building against them
- Pre-built connectors only: Native links to Shopify, BigCommerce, Adobe Commerce, WooCommerce, QuickBooks, PayPal, and Meta cover common cases, but anything off that list needs custom, vendor-gated work
- Hybrid "Always On" architecture: An onsite server keeps stores running during outages, which means data lives partly on-premise and partly in the cloud, complicating headless access
- Multi-channel ID fragmentation: The same product or order can carry different identifiers across POS, the web store, and marketplace listings, so reconciling a single source of truth is non-trivial
- Authenticated portal workflows: Reporting, inventory, and order management happen through the back-office UI, with session-based auth that resists straightforward automation
- Real-time inventory sensitivity: Overselling prevention depends on near-instant stock updates across channels, so any integration must handle freshness and write ordering carefully
How Supergood Creates Cumulus Retail APIs
Supergood reverse-engineers Cumulus Retail's authenticated browser and back-office flows to deliver a resilient, normalized API layer for your store—without waiting on a Celerant implementation queue or a custom partner build.
- Handles username/password and MFA securely in a managed session
- Maintains session continuity with automated refresh and change detection
- Normalizes responses across products, inventory, orders, and customers so you integrate once and rely on consistent objects across POS, web, and marketplace channels
- Reconciles multi-channel identifiers so a single product or order maps cleanly regardless of where it originated
Use Cumulus Retail with AI agents: Cumulus Retail MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your channels, modules, and authentication model.
- Supergood Generates and Validates Your API
We deliver a production-ready Cumulus Retail adapter tailored to your store configuration and sales channels.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Cumulus Retail evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a Cumulus Retail store using username/password, or MFA and obtain a session token for downstream calls.
Catalog
/productsList products, SKUs, variants, and vendor catalog items with filters for category, channel, and active status.
Inventory
/inventoryRetrieve cross-channel inventory levels, stock adjustments, and transfers to keep external systems in sync and prevent overselling.
Inventory
/update_inventoryPush stock adjustments, price changes, and product updates back into Cumulus across POS, web store, and marketplace listings.
Orders
/ordersPull orders, line items, fulfillments, returns, and layaways across in-store, eCommerce, and marketplace channels.
Customers
/customersRetrieve customer records, loyalty data, and gift card balances for CRM, marketing, and reporting workflows.
Use Cases
Unify product and inventory across every channel
- Pull products, SKUs, and variants from Cumulus into a single catalog warehouse - Sync real-time inventory levels to external storefronts and marketplaces to prevent overselling - Push price changes and stock adjustments back into Cumulus from your PIM or ERP
Centralize omnichannel order data
- Stream in-store, web, and marketplace orders into a single order pipeline - Track fulfillments, returns, and layaways across channels in downstream systems - Trigger 3PL, shipping, and BOPIS workflows without back-office clicks
Power customer and loyalty workflows
- Sync customer, loyalty, and gift card records into your CRM and marketing tools - Build unified customer profiles across POS and eCommerce purchases - Drive trigger-based campaigns from real-time purchase and inventory events
Automate accounting and reporting
- Push sales, payments, and refunds into your general ledger beyond the native QuickBooks link - Reconcile multi-channel revenue against inventory cost in real time - Feed BI dashboards with normalized order, product, and customer data
Technical Specifications
Authentication
Username/password and MFA handled in a managed session
Connectivity
Authenticated browser and back-office flows, reconciling the hybrid onsite-server and cloud architecture
Response format
Normalized JSON across products, inventory, orders, and customer objects
Rate limits
Adaptive throttling tuned to your store to avoid back-office and channel-side limits
Session management
Automatic session refresh, MFA replay handling, and credential rotation
Data freshness
Near real-time pulls for inventory and orders with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks for new orders, inventory changes, price updates, and customer activity
Latency
Sub-second reads on cached catalog and inventory; multi-second writes when posting orders and stock adjustments
Throughput
Horizontally scaled workers sized to multi-channel order and catalog volume
Reliability
Retry, backoff, and idempotency keys for inventory adjustments and order writes to prevent duplicates
Adaptation
Continuous monitoring of Cumulus Retail and Celerant releases and channel-connector changes
Frequently asked questions
Not in the usual sense. Celerant manages integrations on your behalf—you provide API credentials to a Celerant Web Implementation Manager rather than reading public docs and self-serving. Supergood gives you a normalized, programmatic API surface against your own store without waiting on an implementation queue.
Yes. Supergood normalizes products, inventory, and orders across in-store POS, the Cumulus eCommerce site, and marketplace channels like Amazon, Walmart, and eBay, reconciling identifiers so a single record maps cleanly regardless of where it originated.
Cumulus keeps an onsite server running during outages, so data lives partly on-premise and partly in the cloud. Supergood operates against your authenticated surfaces with network configuration tuned to your environment, reconciling both sides into one consistent API.
No. Supergood works alongside Celerant's pre-built connectors. Use it for anything off that list—custom storefronts, ERPs, data warehouses, or AI agents—while your native integrations keep running.
No. Supergood works with your existing Cumulus credentials and authenticated sessions, so you can stand up an API layer without a custom Celerant partner build or development cycle.