Docs
Aplicație

Documentație API flowSCMC

API-uri REST (v1/v2), **GraphQL** și **webhooks** pentru integrarea cu ERP, WMS secundar, e-commerce și sisteme transport (eTSM).

★Ghid integratorArhitectură, pattern-uri, securitate, go-live 01Pornire rapidăToken, primul request, checklist 02AutentificareBearer, abilities, headers 03REST v1CRUD complet, PO, recepții, SO 04REST v2Cursor, batch, ambalaje 05GraphQLQueries, mutations, schema 06Webhooks19 evenimente, HMAC, retry 07EroriCoduri HTTP, rate limit, 422 08Integrări inboundeTSM transport 10Exemple requesturicurl copy-paste, SO, PO, webhooks 11Verificare QRAviz, recepție publică ↗PlaygroundTester REST + HMAC live

Versiuni API

Versiune Prefix Status Când o folosiți
REST v1 /api/ Stabil, complet CRUD articole, PO, recepții, SO, retururi
REST v2 /api/v2/ Evoluție activă Listări mari (cursor), ambalaje, SO status
GraphQL /graphql Stabil Aplicații custom, query-uri compuse
Webhooks outbound HTTPS Stabil Evenimente async către ERP

Descoperire automată


GET https://flowscmc.ro/api
GET https://flowscmc.ro/api/v2/meta
GET https://flowscmc.ro/openapi.json
GET https://flowscmc.ro/api/v2/openapi.json

Pe acest site: copie referință OpenAPI v2 la /openapi-v2.json.

Autentificare — rezumat

  1. POST /api/auth/token — email + parolă sau token UI → Bearer
  2. Header Authorization: Bearer {token} pe toate cererile
  3. Header X-Company-Id: {id} obligatoriu pe date operaționale
  4. Optional X-Three-Pl-Id pentru context furnizor 3PL

Detalii complete: Autentificare API.

Capabilități pe domenii

Domeniu v1 v2 GraphQL Webhooks
Articole CRUD + sync listă cursor da article.*
Stoc listă cursor da stock.*
Comenzi vânzare CRUD create + status da sales_order.*
PO / recepții CRUD — parțial reception.*
Retururi read/create — da return.*
Parteneri / depozite read — parțial —
Ambalaje — balances — packaging.*
Webhooks config CRUD list/create — —

Medii și URL-uri

Mediu Recomandare
Producție https://flowscmc.ro (sau TLD contractat)
Staging Tenant dedicat — nu amestecați token-uri
Documentație https://flowscmc.info — static, fără API live

Configurați base URL în variabilă de mediu în integrarea dvs. — nu hardcodați în cod sursă versionat.

Sandbox și testare

  • Creați token cu abilities limitate (articles:read, stock:read)
  • Folosiți Playground pentru probe manuale
  • Health check fără auth: GET /api/health
  • Verificați semnătura webhook în Playground înainte de go-live

Support integratori

Resursă Link
Erori standardizate Coduri eroare
Ghid complet Ghid integrator
Exemple curl Exemple requesturi
Manual utilizator (context business) Manual

Nu publicați token-uri, parole sau ID-uri interne în tickete — folosiți valori exemplu și timestamp-uri.

Licență și utilizare

API-ul este destinat integrărilor autorizate contractual cu operatorul 3PL. Respectați rate limits și termenii de utilizare ai platformei.

flowSCMC · documentație publică · 2026-07-29