About the NextUp ERP API
Technical documentation for the 107 JSON-RPC operations exposed by NextUp ERP Web Services. This portal walks you from the first steps (GetAuthenticationToken) all the way to complete flows (order → invoice → delivery note → receipt), and contains a full reference for every operation.
Important for new integrations: start with Quickstart. There you will obtain your first token in under 5 minutes using the local Sandbox server.
General architecture
NextUp ERP exposes all operations through a single endpoint, DoAction, which follows the JSON-RPC conventions. Every call has the same shape:
There are three ways to consume the services (all functionally equivalent):
| Mode | URL | Content-Type | When to use |
|---|---|---|---|
| POST | /NextUpServices/Services/POST/ | text/plain | Recommended — any payload, any HTTP client |
| GET | /NextUpServices/Services/GET/{json} | — | Quick debugging from the browser |
| AJAX | $.ajax with dataType: json, contentType: text/plain | text/plain | Legacy frontend (since v7.47.1) |
The real NextUp requires Content-Type: text/plain, not application/json. Sending another content-type results in an empty response. Our proxy sets it automatically.
Core concepts
1. DoAction
All operations are calls to DoAction. The real operation name is sent in the Method field:
{
"Method": "GetAuthenticationToken",
"Params": { "UserName": "demo_user", "Password": "Demo1234", "Database": "99999999" }
}
2. GUID token
After GetAuthenticationToken you receive a token of 32 lowercase hexadecimal characters (e.g. 55020f7fddda40ceb18636405b161f5a). All subsequent operations require this token, sent in the AuthenticationToken field of the payload:
{
"AuthenticationToken": "55020f7fddda40ceb18636405b161f5a",
"Method": "GetAllArticles",
"Params": {}
}
Full details: Authentication and token management.
3. Session
A token is bound to a single company (the Database parameter from login). To work with another company, perform a new GetAuthenticationToken with that Database. The default token expires after one hour, unless the administrator configured otherwise.
4. Company
The company code (Database) corresponds to the internal fiscal code or an alphanumeric code defined via AddSociety. In this portal we use the test company 99999999.
5. Response envelope
All responses have the same shape, regardless of the operation:
{ "Result": <payload>, "Error": null }
{ "Result": false, "Error": "Descriptive message" }
NextUp does not return HTTP 4xx/5xx codes for business errors — everything comes through the Error field. The only non-200 codes appear for transport problems (firewall, DNS, timeout).
The three Sandbox environments
| Environment | Address | Purpose |
|---|---|---|
| Development | http://1.2.3.4:8888/NextUpServices/Services | The real ERP server on your LAN |
| Mock Server | http://localhost:4000/NextUpServices/Services | Functional replica with reproducible test data. |
| Production | (to be configured at go-live) | Production NextUp ERP |
Switching between environments is done from the Swagger UI header or via the X-NextUp-Env: dev|mock|prod header.
The 107 operations, grouped
| Category | Ops | Reference tag |
|---|---|---|
| Configuration | 3 | Configurare |
| Company / Users | 14 | Societate-Useri |
| Partners | 10 | Parteneri |
| People / Delegates | 7 | Persoane-Delegati |
| Agents | 7 | Agenti |
| Articles | 15 | Articole |
| Warehouses | 5 | Depozite |
| Document series | 11 | Serii-documente |
| Sales documents | 18 | Documente-vanzare |
| Other documents | 9 | Alte-documente |
| Accounting notes | 8 | Note-contabile |
| TOTAL | 107 |
What you'll find next
- Quickstart — login → first article → first order in 4 steps.
- Authentication — the GUID token, refresh, expiry, multi-company.
- Error catalog — every error type with interpretation and recommendation.
- Data models — the principal entities with relational diagrams.
- Code samples — cURL, Node.js, PHP, Python for the key operations.
- Mock Server — how to run the local replica.
- Swagger UI — the interactive interface for testing every call.
- FAQ & Troubleshooting — frequent problems and solutions.
- Complete API reference — 107 auto-generated pages, one per operation.
NEXTUP Management Solutions S.R.L.