Cum adaugi un produs cu MPN atribuit de job-ul CRON

Scop

Pagina arată cum adaugi în Entity Manager un produs simplu de vânzare și cum îi dai MPN-ul, codul intern prin care bonurile, stocul și vânzările se leagă de produs. MPN-ul se atribuie cu job-ul programat „MPNs Generation for Products”, care dă următorul număr liber și nu lasă dubluri. Ghidul arată și cele două variante din editor (editarea manuală și „Obține MPN”) și de ce nu le folosim aici.

Exemplul folosit: cartea Albinuța de Grigore Vieru, ilustrații de Lică Sainciuc (Editura Cartier, 2024), cu codul de bare 9789975867979, vândută la Sectia Producere (Singera).

Ce îți trebuie înainte

• Un cont cu drept de creare și editare a folderelor în catalog și de editare a prețului și stocului pe POS.
• Dreptul de a porni job-ul „MPNs Generation for Products” (Storage → CRON JOBS).
• Datele produsului: numele, o descriere, codul de bare de pe ambalaj, o poză (fișier pe calculator), prețul fără TVA, cota de TVA și cantitatea inițială.

Pașii

1. Deschide folderul zilei

În panoul de administrare, secțiunea Stock Storage, apasă țigla Entity Manager și mărește fereastra. În arbore apasă Depozite („archive”), deschide fila Conținut și apasă folderul Produse 2026-10-22.

2. Creează folderul produsului și pune tipul product

1. În fila Conținut a folderului zilei apasă Adaugă sub-folder, scrie numele tehnic albinuta-vieru (litere, cifre, cratime), apasă Creează, apoi Deschide.
2. În fila General, la Tip, apasă Schimbă tipul, alege cardul product și apasă Aplică. Tipul se pune primul: fără tipul product, produsul nu primește MPN.

3. MPN-ul: cele două variante din editor (nu le folosim)

Deschide fila Proprietăți, coboară la Vezi alte proprietăți ce pot fi adăugate și deschide lista. Rândul product:mpn („necompletat”) are două butoane:

• Completează — editarea manuală. Apare avertismentul: „MPN-ul nu se editează de aici: îl atribuie cron job-ul „MPNs Generation for Products” (Cron Jobs → Products & costs), care dă următorul număr liber. Un MPN scris manual poate fi deja al altui produs, iar bonurile, stocul și istoricul vânzărilor se leagă de produs prin MPN.” Editarea cere tastarea codului afișat („Tastează MPN ca să editezi manual”) și butonul Editez manual. Aici apăsăm Renunță.

  

• Obține MPN — metoda rapidă. Apare avertismentul: „Metodă rapidă, din indexul din cache: cel mai mare MPN numeric + 1, atribuit de server sub lock — două cereri „Obține MPN” nu primesc același număr. Fără garanție față de cron job-ul „MPNs Generation for Products” și față de editările manuale; metoda sigură rămâne cron job-ul.”, apoi „Propus: …” și „Tastează … ca să atribui” cu butonul Atribuie. Aici apăsăm Renunță, fără „Atribuie”.

  

4. MPN-ul prin job-ul CRON (metoda sigură)

1. Minimizează Entity Manager, deschide meniul din dreapta-sus (⋮) și alege Storage.
2. Apasă CRON JOBS, apoi fila PRODUCTS & COSTS.
3. La rândul MPNs Generation for Products apasă butonul mpns-generation.
4. În jurnalul de sub tabel (CronJob Logger) apar: „Detected 1 products without MPNs”, „Writing … albinuta-vieru … MPN: 2498” și „CronJob finished: mpns-generation”.

Varianta „mpns-generation-dry-run” (rândul de deasupra) arată ce produse ar primi MPN, fără să scrie nimic. Pentru mai multe produse noi rulezi job-ul o singură dată, după ce toate au tipul product.

5. Verifică MPN-ul în fișa produsului

Apasă Dashboard, deschide din nou Entity Manager, alege produsul din rândul Recente și fila Proprietăți. Apasă ↻ Reîncarcă (sus, în dreapta), ca editorul să citească datele noi: caseta MPN arată 2498.

6. Completează fila General

• Nume — „Albinuța — Grigore Vieru”, apoi Enter (numele de pe site, din căutare și de pe bon).
• Despre (scurt, public) — Editează, o frază de prezentare, salvezi cu bifa din dreapta.
• Descriere — Editează, lipești datele ediției în format Markdown (editura, colecția, anul, formatul, paginile, ISBN-ul), salvezi cu bifa.
• SKU intern — Generează PID; fără SKU intern produsul nu apare pe site.
• Unitate — „buc” e deja aleasă.

7. Codul de bare

În fila Proprietăți, la Coduri de bare, scrie codul de pe produs (la o carte, ISBN-ul de 13 cifre), apasă Adaugă, apoi Aplică. Lista se salvează o dată, completă.

8. Poza principală

Fila Media → slotul photo_00 („principală”) → Încarcă → alegi fișierul → în fereastra de confirmare apeși Încarcă.

9. Preț și stoc pe punctul de vânzare

Fila POS → rândul Sectia Producere ( Singera ) (SGA MD-2091-001) → Completează câmpurile:

• Preț NET — 165,83, Enter (prețul fără TVA; 199,00 / 1,2).
• Cod TVA — A · 20%; „Preț cu TVA (calculat)” arată 199,00 MDL.
• Stoc disponibil — +10 în câmpul Δ, Enter; sub câmp apare „acum 10 buc”.

10. Verifică rezultatul

1. Apasă ↻ Reîncarcă, apoi Produse 2026-10-22 din calea de sus și fila Conținut.
2. În selectorul de POS alege Sectia Producere ( Singera ): rândul cărții arată 10 buc.
3. Apasă Căutare generală (Cached Index), scrie codul de bare în Search și mărește fereastra: rândul cărții arată MPN 2498, codul de bare, Price 165.83, Price+VAT 199.00, VAT A și Stock 10.

Rezultatul

Cartea există în catalog ca produs, cu MPN 2498 atribuit de job-ul CRON, nume, descrieri, SKU intern, cod de bare și poză, și se vinde la Sectia Producere cu 165,83 MDL fără TVA (199,00 MDL cu TVA 20%) și 10 bucăți pe stoc.

Greșeli frecvente

• MPN scris de mână — un număr ales manual poate fi deja al altui produs; folosește job-ul CRON.
• „Obține MPN” ca metodă de bază — e rapidă, dar fără garanție față de job-ul CRON.
• Job-ul rulat înainte de tipul product — produsul fără tip nu primește MPN.
• MPN-ul nu apare imediat — apasă „↻ Reîncarcă” în Entity Manager.
• Prețul cu TVA în câmpul Preț NET — câmpul cere prețul fără TVA.
• Prețul pus doar pe POS principal — pune prețul și stocul pe POS-ul unde se vinde produsul.