Prophet 21 (Epicor) API
Prophet 21 is Epicor's cloud ERP built by distributors for distributors, running order management, inventory, warehouse, purchasing, financials, and service workloads across wholesale distribution verticals. An unofficial API lets you programmatically pull orders, customers, inventory, vendors, and financial transactions—and push updates like new orders, quotes, purchase orders, and payments back into Prophet 21.
What is Prophet 21 (Epicor)?
Prophet 21 is Epicor's cloud ERP, described as designed by distributors for distributors, combining operational management with AI-infused analytics. Wholesale distributors use Prophet 21 to run quote-to-cash order management, real-time inventory and warehouse operations, purchasing and vendor management, financials, service and maintenance, eCommerce, and CRM—across verticals like industrial, electrical, HVAC, plumbing, medical supply, fasteners, fluid power, and pipes, valves and fittings.
Core product areas include:
- Order Management (quote-to-cash processing with integrated workflows)
- Inventory Management (real-time stock visibility with machine-learning forecasting)
- Warehouse Management (cloud-enabled receiving, picking, and cycle counting)
- Purchasing (centralized procurement and vendor management)
- Financials (real-time general ledger and financial reporting)
- Service & Maintenance, eCommerce, CRM, and Business Intelligence (Epicor Grow)
Common data entities:
- Orders, Quotes, Order Lines, Shipments, Invoices
- Customers, Ship-To Locations, Contacts, Pricing, Terms
- Inventory Items, Stock Locations, Bins, Inventory Receipts, Transfers
- Vendors, Purchase Orders, Receipts, AP Vouchers
- General Ledger Accounts, AR/AP Transactions, Payments
- Service Orders, Technicians, Maintenance Schedules
The Prophet 21 (Epicor) Integration Challenge
Distributors run mission-critical workloads on Prophet 21 daily, but turning its module- and session-driven workflows into reliable API-driven automation is non-trivial:
- Multiple API surfaces: Prophet 21 exposes a v2 metadata-driven REST API, an Entity API, an Interactive API, and an OData Data Services API—each with different scopes, semantics, and coverage
- Session and transaction nuance: The Interactive API operates against a live Prophet 21 session, so headless automation must manage session state, business rules, and transaction sequencing
- Cloud vs. on-prem variability: Endpoint availability, middleware, and the data dictionary differ by deployment model and Prophet 21 version
- Authentication complexity: Distributor environments combine credentialed logins with token issuance and, increasingly, MFA—complicating unattended access
- Deep data dictionary: Locating the right tables and columns across orders, inventory, purchasing, and financials requires navigating a large, distributor-specific schema
- Customization per distributor: Custom fields, pricing rules, and workflow configuration vary by tenant, so generic integrations break across customers
How Supergood Creates Prophet 21 (Epicor) APIs
Supergood reverse-engineers authenticated flows and Prophet 21's native API surfaces—v2 REST, Entity, Interactive, and OData Data Services—to deliver a resilient, normalized API layer for your Prophet 21 environment, whether cloud-hosted or on-prem.
- Handles credentialed logins, token issuance, and MFA securely in a managed session
- Maintains session continuity for Interactive API transactions with automated refresh and change detection
- Normalizes responses across Orders, Inventory, Purchasing, and Financials so you integrate once and rely on consistent objects
- Aligns with distributor-specific custom fields, pricing rules, and data-dictionary mappings to ensure accurate access
Use Prophet 21 with AI agents: Prophet 21 MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, deployment model, and authentication setup.
- Supergood Generates and Validates Your API
We deliver a production-ready Prophet 21 adapter tailored to your distributor configuration and data dictionary.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Prophet 21 evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a Prophet 21 environment with credentials or MFA and obtain a session token for downstream calls.
Sales
/ordersList sales orders and quotes with filters for customer, status, date range, and ship-to location.
Sales
/create_orderCreate a new sales order or quote with line items, pricing, and shipping details against the distributor's configuration.
Inventory
/inventoryRetrieve inventory items, on-hand quantities, and stock locations across warehouses and bins.
Purchasing
/purchase_ordersPull purchase orders, vendor records, and receipt status with filters for vendor, status, and date.
Purchasing
/create_purchase_orderCreate a purchase order against a vendor with line items, quantities, and expected receipt dates.
Customers
/customersList customers, ship-to locations, contacts, and pricing terms for CRM and AR workflows.
Financials
/general_ledgerRead general ledger accounts, AR/AP transactions, and payment activity for reconciliation.
Use Cases
Sync orders and inventory into your data stack
- Pull sales orders, quotes, and shipments from Prophet 21 into a single warehouse - Stream real-time on-hand inventory and stock locations to BI and replenishment tools - Reconcile customer and ship-to records across systems for a unified view
Automate quote-to-cash order entry
- Push new orders and quotes from eCommerce, EDI, or CRM directly into Prophet 21 - Apply distributor-specific pricing, terms, and customer entitlements - Return order confirmations and shipment status without portal clicks
Streamline purchasing and vendor management
- Create purchase orders and pull vendor records and receipt status programmatically - Trigger replenishment POs from inventory thresholds and demand forecasts - Sync AP vouchers and receipts into procurement and finance systems
Reconcile financials and AR/AP
- Sync general ledger, AR, and AP transactions into accounting and reporting tools - Match payments and invoices against orders and purchase orders - Surface delinquent accounts and credit holds to collections workflows
Technical Specifications
Authentication
Credentialed login, token issuance, and MFA handled in a managed session
Connectivity
Authenticated flows plus Prophet 21's native v2 REST, Entity, Interactive, and OData Data Services APIs where exposed
Response format
Normalized JSON across Orders, Inventory, Purchasing, Customers, and Financials objects
Rate limits
Adaptive throttling tuned to your environment to avoid server-side and middleware limits
Session management
Automatic session refresh, Interactive API state handling, and credential rotation
Data freshness
Near real-time pulls for orders, inventory, and financials with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks for order changes, inventory adjustments, shipments, and PO receipts
Latency
Sub-second reads on cached entities; multi-second writes when posting through order and purchasing workflows
Throughput
Horizontally scaled workers sized to high-volume distribution order and inventory loads
Reliability
Retry, backoff, and idempotency keys for order, PO, and payment transactions
Adaptation
Continuous monitoring of Prophet 21 releases, API changes, and distributor-specific configuration drift
Frequently asked questions
Supergood works across Prophet 21's native surfaces—the v2 metadata-driven REST API, the Entity API, the Interactive API, and the OData Data Services API—and normalizes them into a single consistent interface so you integrate once regardless of which underlying surface serves the data.
Yes. Supergood adapts to either deployment model. For Epicor-hosted cloud tenants we work against your environment's authenticated surfaces; for on-prem or hybrid distributors we operate against the same APIs with network configuration tuned to your setup.
Each environment is profiled against its data dictionary, custom fields, and pricing rules. Supergood preserves your distributor-specific schema and entitlements rather than forcing a generic model.
Yes. In addition to reads, Supergood supports writes—creating sales orders, quotes, and purchase orders with line items, pricing, and terms, with idempotency and retry handling to keep transactions safe.
The Interactive API operates against a live Prophet 21 session. Supergood manages session state, transaction sequencing, and business-rule validation automatically, so you get clean API calls without managing session lifecycle yourself.