Quickstart — primul apel în 5 minute

Acest ghid vă duce de la zero la prima comandă de vânzare creată cu succes în 4 pași.

0. Pre-requisite

• IP-ul serverului NextUp ERP (ex.: 192.168.x.x) — comunicat de echipa NextUp
• Port-ul de acces (default 8080)
• Credențiale demo pentru autentificare (vezi pasul 1)
• Client HTTP — cURL, Postman, sau orice limbaj de programare cu suport pentru request-uri POST
• Acces de rețea către server (firewall, VPN, etc. dacă serverul nu e în LAN-ul dvs.)

În toate exemplele de mai jos, înlocuiți <server-ip>:<port> cu valorile reale (ex.: 192.168.3.193:8080).

1. Obțineți primul token (Logon)

cURL

curl -X POST http://<server-ip>:<port>/NextUpServices/Services/POST/ \
  -H "Content-Type: text/plain" \
  -d '{
    "Method": "GetAuthenticationToken",
    "Params": {
      "UserName": "demo_user",
      "Password": "Demo1234",
      "Database": "99999999"
    }
  }'

Răspuns:

{ "Result": "7952bcb9539ee7a1920da3d2a3301b37", "Error": null }

Salvați token-ul într-o variabilă de mediu:

export NX_TOKEN=7952bcb9539ee7a1920da3d2a3301b37

2. Listați articolele existente

cURL

curl -X POST http://<server-ip>:<port>/NextUpServices/Services/POST/ \
  -H "Content-Type: text/plain" \
  -d "{
    \"AuthenticationToken\": \"$NX_TOKEN\",
    \"Method\": \"GetAllArticles\",
    \"Params\": {}
  }"

Răspuns (exemplu cu 5 articole demo):

{
  "Result": [
    { "Id": 101, "Code": "0000001", "Name": "Consultanta IT (ora)", "SalePrice": 250.00, ... },
    { "Id": 102, "Code": "0000002", "Name": "Laptop Demo 14\"",     "SalePrice": 4500.00, ... },
    { "Id": 103, "Code": "0000003", "Name": "Mouse wireless",        "SalePrice": 89.00, ... },
    { "Id": 104, "Code": "0000004", "Name": "Tastatura mecanica",    "SalePrice": 420.00, ... },
    { "Id": 105, "Code": "0000005", "Name": "Hartie A4 500 coli",    "SalePrice": 32.00, ... }
  ],
  "Error": null
}

3. Adăugați un articol nou

cURL

curl -X POST http://<server-ip>:<port>/NextUpServices/Services/POST/ \
  -H "Content-Type: text/plain" \
  -d "{
    \"AuthenticationToken\": \"$NX_TOKEN\",
    \"Method\": \"AddArticle\",
    \"Params\": {
      \"Code\": \"0000010\",
      \"Name\": \"Servicii consultanță avansată\",
      \"VATRateId\": 1,
      \"SalePrice\": 350.00
    }
  }"

Răspuns:

{ "Result": { "Id": 201, "Code": "0000010" }, "Error": null }

4. Creați prima comandă de vânzare

cURL

curl -X POST http://<server-ip>:<port>/NextUpServices/Services/POST/ \
  -H "Content-Type: text/plain" \
  -d "{
    \"AuthenticationToken\": \"$NX_TOKEN\",
    \"Method\": \"AddSaleOrder\",
    \"Params\": {
      \"PartnerId\": 27501,
      \"Date\": \"2026-05-13\",
      \"Currency\": \"RON\",
      \"Lines\": [
        { \"ArticleCode\": \"0000002\", \"Quantity\": 1, \"UnitPrice\": 4500.00, \"VATRateId\": 1, \"WarehouseId\": 1 },
        { \"ArticleCode\": \"0000003\", \"Quantity\": 1, \"UnitPrice\": 89.00,   \"VATRateId\": 1, \"WarehouseId\": 1 }
      ]
    }
  }"

Răspuns:

{ "Result": { "Id": 9101, "Number": "COM-000556" }, "Error": null }

🎉 Felicitări — primul apel CRUD complet, tot lanțul Logon → Read → Write a fost validat în Sandbox.

Pași următori

Vreau să...	Mergeți la
...înțeleg mai bine token-ul și expirarea	Autentificare
...văd toate cele 107 operațiuni cu parametri	Referință API
...înțeleg modelele de date (Article, Partner, ...)	Modele de date
...văd exemple complete în Node.js / PHP / Python	Exemple de cod
...rezolv o eroare pe care am întâlnit-o	Catalog erori sau FAQ

Operațiuni demo recomandate pentru următoarele 30 minute

1. GetAllPartners — vedeți cei 3 parteneri demo.
2. AddPartner — creați un partener nou (atenție la cod unic).
3. GetAllWarehouses — listați cele 2 depozite demo.
4. GetAllDocumentSeries — vedeți seriile pentru FAC, CHI, AVZ, COM, NIR.
5. AddSaleInvoice — creați o factură (atenție: serverul verifică stocul!).
6. AddDeliveryNote — creați un aviz.
7. SaveReceiptWithoutMarking — chitanță fără marcare bonuri.
8. GetSaleInvoice — listați facturile create.