Date master
Datele master sunt **fundamentul** operațiunilor: fără articole, parteneri și depozite configurate corect, comenzile și recepțiile vor eșua la validare sau vor genera stoc incorect.
Ordinea recomandată
- Depozite — unde se află fizic marfa (configurat de 3PL)
- Articole — ce stocați (SKU per companie)
- Parteneri — cine furnizează / cine cumpără
- Opțional: import CSV masiv, apoi prima PO
Articole (SKU)
| Câmp | Reguli | Impact operațional |
|---|---|---|
| Cod articol | Unic per companie, max ~30 car. | Apare pe toate documentele |
| Denumire | Afișată în liste și PDF | Căutare Ctrl+K |
| UM | buc, kg, l, etc. | Conversii dacă modul activ |
| EAN/GTIN | Opțional | Scanare cod de bare |
| Stoc minim | Opțional | Alerte, webhook stock.low |
| Categorie | Opțional | Filtre rapoarte |
Regulă critică: articolele nu se partajează între companii. Fiecare companie client are catalog propriu (articles.client_3pl_id).
Operațiuni UI
- Creare manuală — formular Articole
- Editare — păstrați codul stabil; schimbarea codului poate afecta integrări
- Arhivare — articolul nu mai apare la comenzi noi; stoc existent rămâne vizibil
Sync via API
GET /api/articles
GET /api/articles/sync?since=2026-01-01T00:00:00Z
POST /api/articles
PATCH /api/articles/by-code/{code}
Parteneri
Partener = contrapartida comercială pe documente.
| Tip | Folosit pe | Exemplu |
|---|---|---|
| Furnizor | PO, recepții | Distribuitor mărfuri |
| Client | SO, retururi | Magazin online, retailer |
Puncte de lucru
Adrese multiple per partener:
- Livrare SO către punct specific
- Recepție de la sediu alternativ
- Date contact pentru avize
Validare
- CUI / date fiscale — conform configurării companie
- Partenerul aparține companiei selectate — nu e vizibil cross-tenant
Depozite
| Aspect | Detaliu |
|---|---|
| Proprietar | Furnizor 3PL (warehouses.three_pl_provider_id) |
| Utilizare | Mai multe companii pot opera în aceeași locație fizică |
| Stoc | Separat per companie — nu se amestecă |
| Locații | Zone, rafturi (dacă modul locații activ) |
La crearea PO/SO selectați depozitul corect — afectează disponibilul și rapoartele.
Companii client
Administrare (super-admin / admin 3PL):
| Acțiune | Efect |
|---|---|
| Creare companie | Tenant nou, catalog gol |
| Activare module | Intrări, ieșiri, API, ambalaje… |
| Trial facturare | 14/30 zile evaluare modul |
| Asignare utilizatori | Invitație via Gate |
Utilizatorii obișnuiți selectează compania — nu o creează.
Clienți (entitate CRM)
Perspectivă 3PL asupra companiilor client:
- Contracte, documente PDF
- Portal client — link public cu token limitat
- Istoric comunicări (dacă modul activ)
Import / export
Modul Export-Import (dacă activ):
| Entitate | Format | Sfaturi |
|---|---|---|
| Articole | CSV/Excel | Respectați șablonul din UI |
| Parteneri | CSV/Excel | Tip furnizor/client obligatoriu |
| Stoc inițial | CSV | Doar cu aprobare admin — afectează inventar |
Procedură sigură: import pe staging → validare → import producție.
API date master
| Resursă | Endpoint |
|---|---|
| Articole | GET/POST/PATCH /api/articles |
| Parteneri | GET /api/partners |
| Depozite | GET /api/warehouses |
| Companii | GET /api/companies |
| Clienți CRM | GET /api/clients |
Detalii: REST v1 · Ghid integrator
Greșeli frecvente
| Problemă | Cauză | Soluție |
|---|---|---|
| Articol „nu există” pe PO | Companie greșită | Schimbați compania în antet |
| Cod duplicat | Import fără verificare | Ștergeți duplicat sau merge |
| Partener pe SO greșit | Tip client vs furnizor | Editați tip partener |
| Stoc pe depozit greșit | SO creat pe alt WH | Anulați/recreați SO |
Vezi și
- Intrări — prima utilizare articole + parteneri furnizor
- Workflow — reguli stoc
- Ghid client 3PL