About the NextUp ERP API

Technical documentation for the 139 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)

Content-Type for POST

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:

Success

{ "Result": <payload>, "Error": null }

Error

{ "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 139 operations, grouped

Category	Ops	Reference tag
Configuration	5	Configurare
Company / Users	14	Societate-Useri
Partners	11	Parteneri
People / Delegates	7	Persoane-Delegati
Agents	5	Agenti
Articles	15	Articole
Warehouses	5	Depozite
Document series	11	Serii-documente
Sales documents	29	Documente-vanzare
Inbound documents	7	Documente-intrare
Other documents	12	Alte-documente
Contracts	7	Contracte
Accounting notes	6	Note-contabile
Utilities	5	Utilitare
TOTAL	139

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 — 139 auto-generated pages, one per operation.

---

NEXTUP Management Solutions S.R.L.