Furnizori și feed-uri

Ce poți face aici

Un furnizor este compania de la care cumperi. Un feed este fișierul sau adresa (CSV, XML, JSON, Excel sau API) din care aduci produsele lui. Aici configurezi feed-urile, mapezi coloanele din feed pe câmpurile catalogului, alegi ce produse intră în magazin (promovare) și vezi ce a adus fiecare sincronizare.

Fluxul complet: feed → produse furnizor (o listă intermediară, nevizibilă în magazin) → promovare → produse în catalog (vizibile).

Cum ajungi aici

Meniul lateral → Catalog → Furnizori (/furnizori). Din rândul unui furnizor: Feed-uri, Produse, Configurare promovare, Editează.

Lista de furnizori.

Pas cu pas

Adaugi un furnizor

1. Adaugă furnizor → Informații de bază (nume, cod), Date companie (CUI, adresă), Informații de contact, Setări.
2. Salvează. Furnizorul apare în listă cu 0 feed-uri.

Configurezi un feed

Configurarea unui feed — sursă, mapare, filtre.

1. Din furnizor → Feed-uri → Feed nou.
2. Informații de bază: Denumire, Tip feed (CSV / XML / JSON / Excel / API), Frecvența actualizare (ore), Feed activ.
3. Sursă: URL Feed sau Sau încarcă fișier. Pentru feed-uri protejate deschide Opțiuni avansate (utilizator, parolă, headers personalizate).
4. Mapare câmpuri: apasă Încarcă preview ca să vezi structura feed-ului, apoi trage câmpurile din feed peste câmpurile din baza de date. Obligatorii: SKU, Nume, Preț achiziție. Poți mapa mai multe coloane pe Imagini (image1, image2…). Câmpurile nemapate (culoare, mărime, material) devin specificații ale produsului.
5. Adaugă transformări unde e nevoie (ex.: parseFloat pentru prețuri cu virgulă) și completează Valori implicite (fallback): TVA (providers-field-mapper-default-vat-input), Prețul include TVA (providers-field-mapper-price-includes-vat-true / -false), Monedă (providers-field-mapper-default-currency-select) și Statusul produselor cu stoc 0 (providers-field-mapper-zero-stock-select).
6. Testează mapări (providers-field-mapper-test-mappings-btn) arată cum ar arăta primele produse. Câmpurile obligatorii lipsă apar în roșu.
7. Filtre sincronizare (opțional): Preț minim/maxim, Stoc minim. Produsele care nu trec de filtre nu sunt importate; filtrele nu afectează produsele deja sincronizate.
8. Salvează. Prima sincronizare pornește la următoarea rulare programată sau manual, cu Sincronizează acum.

Alegi ce intră în magazin — configurarea promovării

Configurarea promovării.

1. Din furnizor → Configurare promovare. Tab-urile: Detalii, Feed-uri, Produse, Promovare (provider-promotion-config-tab-*).
2. Mod promovare: Manual (promovezi tu, explicit), Automatic (la intervalul din Frecvență, provider-promotion-config-promotion-frequency-input), Hibrid (sugestii automate, aprobare manuală).
3. Selecție: Toate produsele, Doar produsele incluse (whitelist — doar cele marcate explicit Incluse), Toate exceptând excluse (blacklist).
4. Opțional, restrânge pe branduri sau categorii (liste separate prin virgulă) și completează Sursa implicită pentru câmpuri (ce feed câștigă când același SKU vine din două feed-uri).
5. Salvează (provider-promotion-config-save-btn). Pagina arată Ultima promovare și Următoarea promovare.

Promovezi manual

Produsele furnizorului.

1. Din furnizor → Produse. Caută după nume, SKU, brand sau categorie; filtrează după Feed, Status Feed, Promovare, Selecție.
2. Bifează produse → Promovează produse selectate, sau Promovează tot pentru toată selecția curentă.
3. Un produs promovat apare în Produse cu sursa feed și cu Sincronizare automată activă.

Produse deconectate

Feed-urile unui furnizor, cu ultima și următoarea sincronizare.

1. Verifică produse deconectate (provider-products-check-orphaned-btn) caută produsele promovate care nu mai au selecție activă (au fost excluse sau feed-ul nu le mai conține).
2. În fereastra Produse deconectate (orphaned-products-modal), Reconectează (orphaned-reconnect-btn) le readuce sub sincronizare. Fără reconectare, produsul rămâne în catalog cu ultimul preț și stoc cunoscut și nu se mai actualizează niciodată singur.

Administrezi furnizorii și feed-urile

• Din rândul unui furnizor: Editează furnizor, Gestionează feed-uri, Vezi produse, Configurare promovare, Șterge furnizor (cere confirmare; produsele promovate rămân în catalog, deconectate). În masă: Activează furnizorii selectați, Dezactivează furnizorii selectați, Șterge furnizorii selectați.
• Coloanele listei: Feed-uri, Produse, Automatizare (Manual / Auto — modul de promovare), Următoarea sincronizare, Ultima actualizare.
• În Feed-uri furnizor: Adaugă feed, iar pe fiecare feed Sincronizează (rulare imediată), Editează, Șterge feed-ul (produsele deja promovate rămân). Fiecare feed arată Frecvență sincronizare, Ultima actualizare, Următoarea actualizare și, la eroare, mesajul exact (Eroare:).

Maparea câmpurilor, în detaliu

Secțiunea Mapare câmpuri are tab-urile Câmpuri disponibile (ce a găsit preview-ul în feed), Date brute (primele rânduri așa cum vin) și Date mapate (cum ar arăta produsele după mapare). Trage un câmp din stânga peste un câmp al catalogului; Șterge mapare scoate o legătură, Șterge sursă scoate un câmp din listă, Șterge toate mapările pornește de la zero. Secțiunile marcate cu * sunt obligatorii; Câmpuri obligatorii lipsă apare în roșu cât timp SKU, Nume sau Preț achiziție nu sunt mapate.

Selecția produselor (whitelist / blacklist)

În tab-ul Produse al furnizorului fiecare produs are un comutator Include / Exclude (coloana Selecție: Inclus, Exclus sau neutru). Modificările se strâng în Selecții nesalvate → Salvează selecțiile; Resetează selectate și Deselectează toate anulează. Filtre de selecție restrânge lista după Feed, Status Feed, Promovare (Nepromovat / Pregătit / Promovat / Eliminat / Lipsă) și Selecție. În configurarea promovării, Lista Albă = doar cele incluse, Lista Neagră = toate exceptând excluse.

Promovează în bloc / Promovează tot cer confirmare (Confirmă promovarea selecției) și rulează ca operațiune; Program promovare arată Ultima promovare / Următoarea promovare când modul este Automat sau Hibrid.

Câmpurile explicate

Câmp	Ce înseamnă
Frecvența actualizare (ore)	Cât de des se sincronizează feed-ul. Programarea efectivă este în Definiții job-uri și respectă limitele magazinului.
Preț achiziție / Preț original furnizor / Reducere furnizor	Ce plătești tu, prețul de listă al furnizorului și reducerea lui. Prețul de vânzare = preț achiziție + markup-ul din fișa produsului.
Monedă	Dacă feed-ul are prețuri în EUR, conversia folosește cursul din Setări → Localizare → Curs valutar. Mapează moneda dacă feed-ul o conține — altfel se folosește valoarea implicită.
Status Feed	Starea produsului în ultimul feed: prezent, lipsă (discontinued), indisponibil.
Statusul produselor cu stoc 0	Ce status primesc în catalog produsele ajunse la stoc zero (ex.: OUT_OF_STOCK, ON_ORDER).

Întrebări frecvente

Feed-ul a rulat, dar produsele nu sunt în magazin. Verifică pașii: (1) sincronizarea a reușit în Istoric Operațiuni? (2) produsele sunt promovate? (3) au categorie activă? — vezi și Categorii din feed.

Prețurile sunt de 4–5 ori mai mari sau au reduceri absurde. Aproape sigur moneda: feed-ul e în EUR, dar prețul a fost citit ca RON, sau invers. Corectează maparea Monedă / valoarea implicită, apoi rulează sincronizarea din nou.

Am oprit feed-ul; produsele lui au dispărut? Nu. Dezactivarea feed-ului oprește actualizările, produsele rămân în catalog cu ultimele valori. Ca să le scoți din magazin, schimbă-le statusul (din Import / Export pentru volume mari).

Același SKU vine de la doi furnizori. Fiecare feed creează propriul produs de furnizor; în catalog câștigă Sursa implicită pentru câmpuri din configurarea promovării. Vezi și Duplicate.

Probleme cunoscute

• Feed-urile foarte mari (sute de MB) se procesează integral în memorie; dacă sincronizarea eșuează cu eroare de memorie, împarte feed-ul sau cere furnizorului un export filtrat.
• Datele de autentificare ale feed-ului (utilizator, parolă, headers) sunt afișate în clar în formular; folosește credențiale dedicate, cu drepturi doar de citire.