Skip to main content

Quickstart — your first call in 5 minutes

This guide takes you from zero to your first successfully created sales order in 4 steps.

0. Prerequisites​

  • NextUp ERP server IP (e.g. 192.168.x.x) — provided by the NextUp team
  • Access port (default 8080)
  • Demo credentials for authentication (see step 1)
  • HTTP client — cURL, Postman, or any programming language with POST request support
  • Network access to the server (firewall, VPN, etc. if the server is not on your LAN)

In all examples below, replace <server-ip>:<port> with the actual values (e.g. 192.168.3.193:8080).

1. Obtain your first 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"
    }
  }'

Response:

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

Save the token in an environment variable:

export NX_TOKEN=7952bcb9539ee7a1920da3d2a3301b37

2. List the existing articles​

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

Response (example with 5 demo articles):

{
  "Result": [
    { "Id": 101, "Code": "0000001", "Name": "IT consulting (hour)", "SalePrice": 250.00, ... },
    { "Id": 102, "Code": "0000002", "Name": "Demo Laptop 14\"",      "SalePrice": 4500.00, ... },
    { "Id": 103, "Code": "0000003", "Name": "Wireless mouse",         "SalePrice": 89.00, ... },
    { "Id": 104, "Code": "0000004", "Name": "Mechanical keyboard",    "SalePrice": 420.00, ... },
    { "Id": 105, "Code": "0000005", "Name": "A4 paper 500 sheets",    "SalePrice": 32.00, ... }
  ],
  "Error": null
}

3. Add a new article​

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\": \"Advanced consulting services\",
      \"VATRateId\": 1,
      \"SalePrice\": 350.00
    }
  }"

Response:

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

4. Create your first sales order​

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 }
      ]
    }
  }"

Response:

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

🎉 Congratulations — your first complete CRUD call; the whole Logon → Read → Write chain has been validated.

Next steps​

I want to...Go to
...better understand the token and its expiryAuthentication
...see all 107 operations with their parametersAPI Reference
...understand the data models (Article, Partner, ...)Data models
...see complete examples in Node.js / PHP / PythonCode samples
...resolve an error I ran intoError catalog or FAQ
  1. GetAllPartners — see the 3 demo partners.
  2. AddPartner — create a new partner (mind the unique code).
  3. GetAllWarehouses — list the 2 demo warehouses.
  4. GetAllDocumentSeries — see the series for FAC, CHI, AVZ, COM, NIR.
  5. AddSaleInvoice — create an invoice (note: the server checks stock!).
  6. AddDeliveryNote — create a delivery note.
  7. SaveReceiptWithoutMarking — a receipt without fiscal-receipt marking.
  8. GetSaleInvoice — list the invoices you created.