Despre API-ul NextUp ERP
Documentația tehnică pentru cele 107 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) |
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:
{ "Result": <payload>, "Error": null }
{ "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 107 operațiuni, grupate
| Categorie | Op. | Tag în referință |
|---|---|---|
| Configurare | 3 | Configurare |
| Societate / Useri | 14 | Societate-Useri |
| Parteneri | 10 | Parteneri |
| Persoane / Delegați | 7 | Persoane-Delegati |
| Agenți | 7 | Agenti |
| Articole | 15 | Articole |
| Depozite | 5 | Depozite |
| Serii documente | 11 | Serii-documente |
| Documente de vânzare | 18 | Documente-vanzare |
| Alte documente | 9 | Alte-documente |
| Note contabile | 8 | Note-contabile |
| TOTAL | 107 |
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ă — 107 pagini auto-generate, una per operațiune.
NEXTUP Management Solutions S.R.L.