Despre API-ul NextUp ERP

Documentația tehnică pentru cele 139 operațiuni JSON-RPC expuse de Web Services NextUp ERP. Acest portal vă ghidează de la primii pași (GetAuthenticationToken) până la fluxurile complete (comanda → factură → aviz → chitanță) și conține referință completă pentru fiecare operațiune.

Important pentru integrări noi: începeți cu Quickstart. Acolo veți obține primul token în mai puțin de 5 minute folosind serverul de tip Sandbox local.

Arhitectura generală

NextUp ERP expune toate operațiunile printr-un singur endpoint, DoAction, ce respectă convențiile JSON-RPC. Toate apelurile au aceeași formă:

Există trei moduri de consumare a serviciilor (toate echivalente funcțional):

Mod	URL	Content-Type	Când se folosește
POST	/NextUpServices/Services/POST/	text/plain	Recomandat — orice payload, orice client HTTP
GET	/NextUpServices/Services/GET/{json}	—	Debugging rapid din browser
AJAX	$.ajax cu dataType: json, contentType: text/plain	text/plain	Frontend legacy (de la v7.47.1)

Content-Type pentru POST

Real NextUp cere Content-Type: text/plain, nu application/json. Trimiterea altui content-type duce la răspuns gol. Proxy-ul nostru îl setează automat.

Conceptele de bază

1. DoAction

Toate operațiunile sunt apeluri către DoAction. Numele real al operațiunii se trimite în câmpul Method:

{
  "Method": "GetAuthenticationToken",
  "Params": { "UserName": "demo_user", "Password": "Demo1234", "Database": "99999999" }
}

2. Token GUID

După GetAuthenticationToken veți primi un token de 32 caractere hexazecimale lowercase (ex: 55020f7fddda40ceb18636405b161f5a). Toate operațiunile ulterioare necesită acest token, transmis în câmpul AuthenticationToken al payload-ului:

{
  "AuthenticationToken": "55020f7fddda40ceb18636405b161f5a",
  "Method": "GetAllArticles",
  "Params": {}
}

Detalii complete: Autentificare și gestionarea token-ului.

3. Sesiune

Un token este legat de o singură societate (parametrul Database din login). Pentru a lucra cu o altă societate, faceți un nou GetAuthenticationToken cu acel Database. Token-ul implicit expiră după o oră, cu excepția cazului în care administratorul a configurat altfel.

4. Societate

Codul societății (Database) corespunde codului CIF intern sau unui cod alfanumeric definit la AddSociety. În acest portal folosim societatea de test 99999999.

5. Envelope răspuns

Toate răspunsurile au aceeași formă, indiferent de operațiune:

Succes

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

Eroare

{ "Result": false, "Error": "Mesaj descriptiv în limba română" }

NextUp nu returnează coduri HTTP 4xx/5xx pentru erori de business — totul vine prin câmpul Error. Singurele coduri non-200 apar pentru probleme de transport (firewall, DNS, timeout).

Cele trei medii din Sandbox

Mediu	Adresă	Pentru ce
Development	http://1.2.3.4:8888/NextUpServices/Services	Serverul ERP real din LAN-ul dvs.
Mock Server	http://localhost:4000/NextUpServices/Services	Replică funcțională cu date de test reproductibile.
Production	(de configurat la go-live)	NextUp ERP de producție

Comutarea între medii se face din header-ul Swagger UI sau prin header-ul X-NextUp-Env: dev|mock|prod.

Lista celor 139 operațiuni, grupate

Categorie	Op.	Tag în referință
Configurare	5	Configurare
Societate / Useri	14	Societate-Useri
Parteneri	11	Parteneri
Persoane / Delegați	7	Persoane-Delegati
Agenți	5	Agenti
Articole	15	Articole
Depozite	5	Depozite
Serii documente	11	Serii-documente
Documente de vânzare	29	Documente-vanzare
Documente de intrare	7	Documente-intrare
Alte documente	12	Alte-documente
Contracte	7	Contracte
Note contabile	6	Note-contabile
Utilitare	5	Utilitare
TOTAL	139

Ce găsiți în continuare

• Quickstart — login → primul articol → prima comandă în 4 pași.
• Autentificare — token-ul GUID, refresh, expirare, multi-societate.
• Catalog erori — fiecare tip de eroare cu interpretare și recomandare.
• Modele de date — entitățile principale cu diagrame relaționale.
• Exemple de cod — cURL, Node.js, PHP, Python pentru operațiile-cheie.
• Mock Server — cum se rulează replica locală.
• Swagger UI — interfața interactivă pentru testat fiecare apel.
• FAQ & Troubleshooting — probleme frecvente și soluții.
• Referință API completă — 139 pagini auto-generate, una per operațiune.

---

NEXTUP Management Solutions S.R.L.