AcuOps Compatibility Matrix
Acumatica Version Support
| Acumatica Version |
API Version |
Status |
Notes |
| 2024 R2 (24.200) |
24.200.001 |
Tested |
Primary development target |
| 2024 R1 (24.100) |
24.100.001 |
Compatible |
No known issues |
| 2023 R2 (23.200) |
23.200.001 |
Compatible |
Supported with minor limitations |
| 2023 R1 (23.100) |
23.100.001 |
Compatible |
Minimum recommended version |
| 2022 R2 (22.200) |
22.200.001 |
Legacy |
Minimum supported version |
| < 22.200 |
— |
Not Supported |
Customization API changes |
Customization API Requirements
AcuOps requires the following Acumatica Customization API endpoints:
| Endpoint |
Method |
Purpose |
Min Version |
/entity/auth/login |
POST |
Session authentication |
22.200 |
/entity/auth/logout |
POST |
Session cleanup |
22.200 |
/CustomizationApi/Import |
POST |
Upload customization package |
22.200 |
/CustomizationApi/publishBegin |
POST |
Start publication |
22.200 |
/CustomizationApi/publishEnd |
POST |
Poll publication status |
22.200 |
/CustomizationApi/getProject |
POST |
Download published project |
23.100 |
Hosting Environment Compatibility
| Environment |
Status |
Notes |
| Acumatica Cloud (SaaS) |
Tested |
Primary target. <Table> elements cause NullReferenceException — use <Sql> |
| Acumatica Private Cloud |
Compatible |
Same API surface as SaaS |
| Acumatica On-Premise |
Compatible |
Requires network access to API endpoints |
| Platform |
Status |
Notes |
| GitHub Actions |
Tested |
Primary CI/CD target, all workflows validated |
| GitLab CI |
Compatible |
Adaptor scripts provided (use scripts/deploy.py) |
| Azure DevOps |
Compatible |
Use scripts/deploy.py or scripts/deploy.sh |
| Jenkins |
Compatible |
Use scripts/deploy.py with Python 3.10+ |
Python Version Requirements
| Component |
Min Python |
Recommended |
deploy.py |
3.10 |
3.12 |
validate-project.py |
3.10 |
3.12 |
intelligence.py |
3.10 |
3.12 |
certification-checklist.py |
3.10 |
3.12 |
generate-solution-objects.py |
3.10 |
3.12 |
| Test suite (pytest) |
3.10 |
3.12 |
Known Limitations
Acumatica Cloud (SaaS)
<Table> elements: Always cause NullReferenceException on cloud instances. Use <Sql> with ALTER TABLE ... IF NOT EXISTS instead.- SM204505 Import screen: Does not accept
<SqlScript> elements (throws "Unknown tag SqlScript"). Use <Sql> elements.
- Concurrent API sessions: License-limited (typically 2-3 concurrent). AcuOps includes session gate coordination via Redis.
- Publishing: Restarts the Acumatica application pool. Schedule deployments during maintenance windows.
Version-Specific Notes
- 24.200:
ARCustomerClass is not a public type (CS0246). Use PX.Objects.AR.CustomerClass.
- 23.200:
getProject endpoint may return different XML format than 24.x.
- 22.200: Minimum version. Some Deploy Intelligence features may have reduced accuracy due to API differences.