Documentație API

Obține un Bearer token trimitând email și parolă:

POST https://flowscmc.ro/api/auth/token
Content-Type: application/json

{
  "email": "your@email.com",
  "password": "your-password"
}

// Response:
{
  "token": "1|abc123...",
  "user": { "id": 1, "name": "...", "email": "..." }
}

Folosește tokenul în toate request-urile ulterioare:

Authorization: Bearer 1|abc123...

Pentru a revoca tokenul curent (deconectare):

POST https://flowscmc.ro/api/auth/revoke
Authorization: Bearer 1|abc123...

Pentru a filtra datele după companie, trimite header-ul opțional:

X-Company-Id: 123

Utilizatorul trebuie să aibă acces la compania specificată. Fără acest header, super-admin văd toate companiile; utilizatorii obișnuiți văd compania lor principală.

La definirea articolului, prima UM din sistem (câmpul um3pl, UM 3PL în interfață) trebuie să fie cea pentru manipularea fizică în depozit. UM2 și UM3 sunt pentru nivele superioare de ambalare, dacă este nevoie.

Comenzile de achiziție, comenzile de vânzare, recepțiile și retururile folosesc pe linie câmpurile um3pl și quantity_um3pl. Puteți trimite zecimale cu virgulă (ex. 1,5); API-ul normalizează la punct înainte de validare.

Dacă articolul impune cantități întregi pe UM 3PL sau catalogul UM al furnizorului 3PL marchează acel cod ca „doar întregi”, quantity_um3pl trebuie să fie număr întreg; altfel validarea eșuează cu răspunsul standard de erori.

Configurați ETSM_INBOUND_BEARER_TOKEN în mediu. Header: Authorization: Bearer <acel token>. Pentru recepții: POST /api/integrations/etsm/receptions cu același corp JSON ca POST /api/receptions și X-Company-Id = id-ul companiei client. GET /api/integrations/etsm/ping verifică tokenul.

GET https://flowscmc.ro/api/integrations/etsm/ping
Authorization: Bearer <ETSM_INBOUND_BEARER_TOKEN>

POST https://flowscmc.ro/api/integrations/etsm/receptions
Authorization: Bearer <ETSM_INBOUND_BEARER_TOKEN>
X-Company-Id: 123
Content-Type: application/json

{ ... same JSON as POST /api/receptions ... }

Endpointurile de listă suportă paginarea prin parametri de interogare:

?page=1&per_page=25

Implicit per_page: 25. Maxim per_page: 100 (200 pentru stoc). Răspunsul include meta și linkuri.

Interogare articole și alte date prin GraphQL. Necesită token Bearer și header X-Company-Id.

URL de bază: https://flowscmc.ro/graphql

Exemplu interogare – listă articole:

POST https://flowscmc.ro/graphql
Authorization: Bearer YOUR_TOKEN
X-Company-Id: 1
Content-Type: application/json

{
  "query": "{ articles(limit: 10) { id article_code description } }"
}

Folosiți același token Bearer și antetul X-Company-Id ca pentru endpointurile REST.

GET /api/health returnează același JSON ca GET /health și GET /up (fără autentificare). Răspunsul include verificări agregate, heartbeats (nume scheduler, ultimul ping, ok), integrări și module. Dacă tabela heartbeats e goală, items conține un rând placeholder pentru cron și no_records este true până rulează scheduler-ul (heartbeat:ping).

{
  "status": "healthy",
  "app": { "name": "3PL", "env": "production" },
  "urls": {
    "app": "https://example.com",
    "api": "https://example.com/api"
  },
  "checks": {
    "database": true,
    "cache": true,
    "queue": true,
    "redis": true,
    "storage": true,
    "storage_public": true,
    "heartbeat": true
  },
  "heartbeats": {
    "stale_after_minutes": 15,
    "no_records": false,
    "items": [
      { "name": "cron", "last_ping_at": "2026-04-09T12:00:00.123456Z", "last_ping_at_ms": 1775736000123, "ok": true }
    ]
  },
  "integrations": { "anaf": true },
  "modules": [ { "slug": "api", "name": "API" } ],
  "timestamp": "2026-04-09T12:00:00+00:00"
}

urls.app și urls.api provin din APP_URL (bază aplicație și /api). Prometheus: adăugați ?format=prometheus. Interfață cu heartbeats live: Platformă → Health (super-admin).

curl -X GET "https://flowscmc.ro/api/articles" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Company-Id: 1" \
  -H "Accept: application/json"

• POST /api/auth/token: 10 request-uri pe minut
• Endpoint-uri date: 60 request-uri pe minut