Acumatica API
Acumatica is a cloud ERP for mid-market companies spanning financials, distribution, manufacturing, construction, retail-commerce, and field service. Its contract-based REST API lets you programmatically read and write customers, sales orders, invoices, bills, stock items, projects, and more—while Supergood handles OAuth, session management, per-tenant endpoint versioning, and normalization so you integrate once across modules.
What is Acumatica?
Acumatica is a cloud-based enterprise resource planning (ERP) platform for mid-market companies, delivering financials, distribution, manufacturing, construction, professional services, retail-commerce, and field service management from a single system. Customers run general ledger, AP/AR, order and inventory management, project accounting, CRM, payroll, and POS workloads on Acumatica, extend it through low-code/no-code customization, and integrate third-party tools via the Acumatica Marketplace.
Core editions and modules include:
- Financial Management (general ledger, AP/AR, cash management, multi-entity and intercompany accounting)
- Distribution Management (order management, inventory, warehouse management system, purchasing)
- Manufacturing Management (production, MRP, bill of materials, product configurator)
- Construction and Project Accounting (jobs, commitments, change orders, retainage)
- Retail-Commerce and Point-of-Sale, Field Service Management, CRM, and Payroll
Common data entities:
- Customers, Vendors, Contacts, Leads, Opportunities
- Sales Orders, Shipments, Invoices, Bills, Payments, Adjustments
- Stock Items, Non-Stock Items, Warehouses, Inventory Receipts/Issues
- Projects, Tasks, Cost Codes, Change Orders, Time Entries
- GL Transactions, Journals, Sub-accounts, Branches, Financial Periods
The Acumatica Integration Challenge
Acumatica exposes a capable contract-based REST API, but turning a customized, multi-module ERP tenant into reliable API-driven automation is non-trivial:
- Versioned, per-tenant endpoints: REST paths embed an endpoint version (e.g. /entity/Default/24.200.001/SalesOrder) and customers extend the Default endpoint, so generic integrations break across tenants and upgrades
- OAuth and session complexity: OAuth 2.0 (authorization code, resource owner password, implicit) and cookie-based login each behave differently, and token/session handling complicates headless automation
- Module-specific object models: Financials, Distribution, Manufacturing, Construction, and Field Service each carry their own entities, IDs, and lifecycle states that must be reconciled
- Customization drift: Low-code/no-code customization projects, custom fields, and added screen actions change the shape of what the API returns per deployment
- Rate and request limits: A configurable maximum-requests-per-minute setting plus large result sets require careful $filter/$top/$skip paging and backoff to avoid timeouts
- Business-date and branch context: Calls often need PX-CbApiBusinessDate and PX-CbApiBranch headers, and posting transactions requires correct period and sub-account handling
How Supergood Creates Acumatica APIs
Supergood reverse-engineers authenticated flows and Acumatica's contract-based REST and OData surfaces to deliver a resilient API layer for your Acumatica tenant—across financials, distribution, manufacturing, construction, and field service modules.
- Handles OAuth 2.0 flows and cookie-based login, including MFA, with secure managed sessions
- Pins and adapts to your tenant's endpoint version and customized Default endpoint so upgrades don't break integrations
- Normalizes responses across Customers, Orders, Invoices, Bills, Stock Items, and Projects so you integrate once and rely on consistent objects
- Manages paging, business-date and branch headers, and request-rate limits to keep large pulls reliable
Use Acumatica with AI agents: Acumatica MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, endpoint version, and authentication model.
- Supergood Generates and Validates Your API
We deliver a production-ready Acumatica adapter tailored to your tenant configuration and customizations.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Acumatica evolves.
API Endpoints
Authentication
/authenticateAuthenticate to an Acumatica tenant via OAuth 2.0 or cookie-based login and obtain a session token for downstream calls.
Sales
/sales_ordersList sales orders with filters for customer, status, order type, and last-modified date, with paging via $top/$skip.
Sales
/create_sales_orderCreate a sales order against the tenant's configured order type, including line items, ship-to, and pricing.
Financials
/invoicesRetrieve AR invoices and bills with status, due date, branch, and customer/vendor filters.
Financials
/create_billCreate an AP bill against a vendor with line distributions, project allocation, and business-date context.
Inventory
/stock_itemsPull stock and non-stock items with warehouse availability, pricing, and attribute details.
Use Cases
Sync orders and inventory into downstream systems
- Pull sales orders, shipments, and stock-item availability into a warehouse or commerce platform - Stream invoice and payment events to BI and finance tooling - Reconcile customer and item records across modules for a unified view
Automate AP and AR workflows
- Create AP bills and apply payments programmatically with correct branch and period context - Pull AR invoices and aging to drive collections and cash-application automation - Match vendor and customer balances against the general ledger
Connect project and construction data
- Sync projects, tasks, cost codes, and change orders into reporting and PM tools - Push time and expense entries back into project accounting - Surface commitments and budget-vs-actual to downstream dashboards
Keep manufacturing and field service in sync
- Pull production orders, BOMs, and MRP output into planning systems - Sync field service appointments, equipment, and stock usage - Trigger replenishment and purchasing workflows from inventory thresholds
Technical Specifications
Authentication
OAuth 2.0 (authorization code, resource owner password, implicit) and cookie-based login handled in a managed session
Connectivity
Contract-based REST API plus OData (GI-based and DAC-based) surfaced through the tenant's versioned Default endpoint
Response format
Normalized JSON across Customers, Orders, Invoices, Bills, Stock Items, and Projects
Rate limits
Adaptive throttling tuned to the tenant's maximum-requests-per-minute setting to avoid server-side limits and timeouts
Session management
Automatic token refresh, cookie/session continuity, and credential rotation
Data freshness
Near real-time pulls using last-modified filters with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging
Webhooks
Event delivery via Acumatica push notifications and webhooks for record create, update, and status changes
Latency
Sub-second reads on cached entities; multi-second writes when posting through order, billing, and project workflows
Throughput
Horizontally scaled workers sized to multi-module volume across financials, distribution, and manufacturing
Reliability
Retry, backoff, and idempotency handling for orders, bills, and inventory transactions
Adaptation
Continuous monitoring of Acumatica releases, endpoint-version bumps, and per-tenant customization drift
Frequently asked questions
Yes. Supergood pins to your tenant's endpoint version and adapts to extensions of the Default endpoint and custom fields, so customizations and upgrades don't break the integration.
Both OAuth 2.0 flows (authorization code, resource owner password, implicit) and cookie-based login are supported, including MFA, with credentials held in a managed encrypted session.
Yes. Financials, Distribution, Manufacturing, Construction, and Field Service entities are exposed through one normalized API surface, so you integrate once across modules.
Supergood tunes request pacing to your tenant's maximum-requests-per-minute setting and uses $top/$skip paging with backoff to keep large pulls reliable and avoid timeouts.
Yes. Supergood consumes Acumatica push notifications and webhooks to deliver near real-time create, update, and status-change events to your downstream systems.