REST API v1
Prefix /api. Bearer + X-Company-Id pe resursele de date. Schema completă: OpenAPI.
Descoperire & sănătate
| Metodă | Path | Auth | Descriere |
|---|
| GET | /api | opțional | Index / descoperire |
| GET | /api/health | nu | Health check (DB, cache, queue, heartbeats, module) |
Integrări inbound (Bearer partajat)
| Metodă | Path | Note |
|---|
| GET | /api/integrations/etsm/ping | Conectivitate eTSM |
| POST | /api/integrations/etsm/receptions | Ca POST /api/receptions; obligatoriu X-Company-Id |
| GET | /api/integrations/mdm/ping | Conectivitate MDM |
| GET | /api/integrations/mdm/sync-fields | Câmpuri sincronizabile |
| GET | /api/integrations/mdm/clients/{client3plId}/articles | Listă articole (limit max 1000) |
| PATCH | /api/integrations/mdm/articles/by-code/{code} | Update parțial; X-Company-Id obligatoriu |
Articole
| Metodă | Path | Descriere |
|---|
| GET | /api/articles | Listă paginată |
| GET | /api/articles/sync | Sincronizare incrementală (updated_since, cursor) |
| POST | /api/articles | Creare |
| GET | /api/articles/{id} | Detaliu |
| PUT | /api/articles/{id} | Actualizare |
| PATCH | /api/articles/by-code/{articleCode} | Update parțial după cod (fără id intern) |
Stoc, comenzi, inbound, retururi
| Metodă | Path | Descriere |
|---|
| GET | /api/stock | Niveluri stoc (max 200/pagină) |
| GET/POST | /api/sales-orders | Listă / creare SO |
| GET/PUT | /api/sales-orders/{id} | Detaliu / update |
| GET/POST | /api/purchase-orders | Listă / creare PO |
| GET/PUT | /api/purchase-orders/{id} | Detaliu / update |
| GET/POST | /api/receptions | Listă / creare recepție |
| GET/PUT | /api/receptions/{id} | Detaliu / update |
| GET/POST | /api/returns | Listă (limită 100) / creare |
| GET | /api/returns/{id} | Detaliu |
Referință & webhook-uri
| Metodă | Path | Descriere |
|---|
| GET | /api/companies | Companii accesibile (selector playground) |
| GET | /api/clients, /api/clients/{id} | Companii client 3PL |
| GET | /api/partners, /{id} | Parteneri |
| GET | /api/warehouses, /{id} | Depozite |
| GET/POST | /api/webhooks | Abonamente webhook |
| GET/PUT/DELETE | /api/webhooks/{id} | Detaliu / update / ștergere |
Exemplu: listă articole
curl -s -X GET "https://www.flowscmc.ro/api/articles?page=1&per_page=20" \
-H "Authorization: Bearer TOKENUL_DVS" \
-H "X-Company-Id: 1" \
-H "Accept: application/json"
Cantități pe linii
La articol, prima UM (um3pl) este pentru manipulare fizică în depozit; UM2/UM3 sunt nivele de ambalare. Pe documente folosiți um3pl + quantity_um3pl. Dacă articolul sau catalogul UM cere întregi, zecimalele sunt respinse cu eroare de validare.
