Sincronizarea cu Shopify

Produsele create in BrandSync pot fi sincronizate catre Shopify apasand butonul "Sincronizeaza in Shopify".

Sincronizarea trimite produsul catre site-urile Shopify asociate produsului (pentru Simplu) sau variantelor (pentru produse cu Variante).

Ce se sincronizeaza

Data	Sursa in BrandSync	Unde apare in Shopify
Titlu	Denumire Shopify (per limba + tip descriere)	Product title
Descriere	Descriere Shopify (HTML)	Product description
Vendor	Brand → Nume	Vendor
Tip produs	Tip Shopify	Product type
Taguri	Taguri Shopify per site	Tags
URL/Handle	URL Shopify per site	URL handle
Meta descriere	Denumire Shopify → Meta Descriere	SEO meta description
Pret	Pret cu TVA (compare_at_price)	Compare at price
SKU	Cod Intern	SKU
Greutate	Greutate Bruta	Weight (grame)
Cod de bare	Cod EAN (implicit)	Barcode
Imagini	Imagini produs	Product images
Status	Activ/Inactiv	Active/Draft
Apartenenta la catalog (B2B)	Shopify Catalog (tab-ul pe Produs)	Publication la catalogul B2B (doar pentru site-urile B2B)

Verificarea automata a campurilor

Inainte de sincronizare, sistemul verifica automat toate campurile obligatorii. Daca lipseste ceva, apare un mesaj cu lista detaliata a campurilor lipsa, organizat pe:

• Produs — campuri lipsa la nivel de produs
• Site — campuri lipsa per site Shopify
• Varianta — campuri lipsa per varianta

Campuri obligatorii — Produs (nivel general)

Camp	Detalii
Brand	Brandul trebuie selectat
Tip Shopify	Tipul produsului pe Shopify (lookup)
Site-uri Shopify	Produsul (Simplu) sau cel putin o varianta trebuie sa aiba site-uri Shopify asociate

Campuri obligatorii — Per site Shopify

Pentru fiecare site asociat produsului/variantei, trebuie sa existe:

Camp	Detalii
URL Shopify	Handle-ul URL al produsului pe acel site
Pret	Un pret cu TVA (etb_pretcutva) pentru acel site
Denumire Shopify	O denumire (titlu) in limba si tipul de descriere al site-ului
Descriere Shopify	O descriere in aceeasi limba si tip de descriere

Campuri obligatorii suplimentare — Produs cu Variante

Pe langa campurile de mai sus, fiecare varianta activa trebuie sa aiba:

Camp pe varianta	Detalii
Variatie	Tipul de variatie: Gramaj, Culoare sau ambele
Gramaj	Selectat (lookup), daca variatie = Gramaj
Traducere Culoare	Cel putin 1 traducere de culoare, daca variatie = Culoare
Pret per site	Un pret cu TVA pe fiecare site Shopify asociat variantei

NOTA

Mesajul de eroare specifica exact ce lipseste, pe ce site si pe care varianta. De exemplu:

Site "Eternal RO B2B":
- URL Shopify
- Pret (master)

Varianta "GA6035BK":
- Pret pentru Eternal HU B2B

Procesul de sincronizare

1. Deschideti produsul
2. Apasati "Sincronizeaza in Shopify"
3. Sistemul verifica campurile obligatorii
4. Daca totul este corect, produsul este trimis catre site-urile Shopify asociate produsului/variantelor
5. Primiti o notificare cu rezultatul (succes sau eroare)

Creare produs nou in Shopify

Cand un produs este sincronizat pentru prima data:

• Produsul este creat cu status Active in Shopify
• Pretul este setat atat ca Price cat si ca Compare at price
• Un Shopify ID Map este creat automat pentru a lega produsul din BrandSync cu cel din Shopify
• Imaginile sunt incarcate din BrandSync in Shopify

Produs cu variante — prima sincronizare

• Produsul este creat cu optiunile corespunzatoare (Gramaj, Culoare sau ambele)
• Numele optiunilor sunt traduse conform configurarii site-ului (ex: "Gramaj" pentru RO, "Kiszerelés" pentru HU)
• Fiecare varianta este creata individual cu SKU, pret, greutate si cod de bare
• Varianta implicita ("Default Title") creata de Shopify este stearsa automat

Adoptare produs existent din Shopify

Daca un produs nu are inca o mapare (Shopify ID Map) pentru un site, dar exista deja in Shopify cu acelasi SKU, sistemul il adopta automat in loc sa creeze un duplicat.

Cum functioneaza

1. Inainte de a crea un produs nou, flow-ul interogheaza Shopify cu SKU-urile din BrandSync:
   • Cod Intern master (pentru produse Simple)
   • Cod Intern variante (pentru produse cu Variante)
2. Daca exista o potrivire exacta pe SKU in Shopify, produsul gasit este "adoptat":
   • Se creeaza un Shopify ID Map care leaga produsul din BrandSync de cel existent din Shopify
   • Flow-ul se re-declanseaza automat pentru a actualiza produsul adoptat cu datele curente din BrandSync
3. Daca nu exista potrivire, produsul este creat de la zero ca in mod normal

Cand este util

• Ati sters din greseala o inregistrare din Shopify ID Map
• Migrati produse dintr-un Shopify existent in BrandSync
• Ati creat manual un produs in Shopify si vreti sa il legati de BrandSync

Important

• Potrivirea se face numai pe SKU exact (camp sku in Shopify, nu pe titlu, handle sau descriere)
• Daca master-ul nu are Cod Intern (produse cu Variante), se cauta doar dupa SKU-urile variantelor
• Dupa adoptare, la urmatoarea sincronizare produsul este actualizat conform regulilor din capitolul urmator

Actualizarea unui produs existent

Cand un produs deja sincronizat este re-sincronizat:

• Titlul, descrierea, vendor, tip, taguri, handle, meta descriere sunt actualizate
• Compare at price este actualizat (pretul de vanzare nu se modifica)
• Variantele noi sunt create, variantele existente sunt actualizate
• Status-ul se actualizeaza conform starii din BrandSync (Activ → Active, Inactiv → Draft)

Dezactivarea unui produs

Cand un produs este dezactivat in BrandSync si apoi sincronizat:

• Status-ul in Shopify devine Draft (produsul nu mai este vizibil pe site)
• Produsul nu este sters din Shopify — poate fi reactivat ulterior

Stergerea variantelor

Cand o varianta este dezactivata in BrandSync si produsul este re-sincronizat:

• Varianta este stearsa din Shopify
• Maparea din Shopify ID Map este stearsa automat

Imagini

Incarcarea imaginilor

1. Incarcati imagini pe produs folosind componenta de Media Upload din formularul produsului
2. Setati o imagine ca principala (eticheta cu steaua)
3. Optional: asociati o imagine la o varianta specifica (pentru produse cu variante)
4. Sincronizati produsul — imaginile sunt incarcate in Shopify

Reordonarea imaginilor (drag-and-drop)

Imaginile din galerie pot fi reordonate prin drag and drop. Ordinea pe care o stabilesti aici este folosita la sincronizarea cu Shopify si eMag — adica clientul vede imaginile in exact ordinea pe care o aranjezi tu.

Cum se reordoneaza

1. Pe fiecare card de imagine, in coltul stanga-sus, apare o iconita cu puncte — de aici o tragi
2. In coltul dreapta-sus al fiecarui card vezi pozitia curenta (1, 2, 3 ...)
3. Apuca cardul de iconita cu puncte si trage-l la pozitia dorita
4. Sistemul actualizeaza automat pozitiile tuturor imaginilor afectate
5. Sincronizeaza produsul (Shopify si/sau eMag) pentru ca noua ordine sa fie aplicata pe canalele de vanzare

TIP

Imaginile noi pe care le incarci sunt adaugate la sfarsitul galeriei. Daca vrei sa apara la inceput, trage-le acolo dupa upload.

INFO

Pozitia este per produs — toate variantele unui produs cu Variante folosesc aceeasi galerie ordonata. Daca vrei imagini specifice unei variante, ataseaza-le acelei variante (vezi sectiunea urmatoare); pozitia in galerie ramane controlata de la nivel de produs.

Imaginea principala

Imaginea marcata ca principala in BrandSync este o eticheta separata — eMag o foloseste ca imagine de afisare. Marcajul de "principala" este independent de pozitia din galerie: pozitia 1 nu inseamna automat principala, si principala nu trebuie sa fie pe pozitia 1. Setati ambele dupa nevoie.

Imagini pe variante

Imaginile asociate unei variante specifice sunt legate de acea varianta in Shopify. Aceasta inseamna ca atunci cand un client selecteaza varianta respectiva, Shopify afiseaza automat imaginea corespunzatoare.

Stergerea imaginilor

Cand o imagine este stearsa din BrandSync:

• Maparea din Shopify Image Map este stearsa automat
• La urmatoarea sincronizare, imaginea este stearsa si din Shopify

Prima sincronizare a unui produs existent

Daca un produs exista deja in Shopify (cu imagini) si este sincronizat pentru prima data din BrandSync:

• Imaginile din Shopify (care nu au mapare) sunt sterse
• Imaginile din BrandSync sunt incarcate in Shopify
• Rezultat: Shopify arata exact imaginile din BrandSync

Cataloage B2B

Site-urile Eternal HU B2B, Eternal RO B2B si Schwarzkopf PRO B2B folosesc Cataloage Shopify pentru a oferi preturi diferite diverselor categorii de clienti. BrandSync permite gestionarea apartenentelor produs ↔ catalog direct din formularul produsului.

Tab-ul Shopify Catalog

Pe formularul Produs apare tab-ul Shopify Catalog numai daca produsul este asociat cu cel putin unul din cele 3 site-uri B2B (conform grilei Site-uri Shopify).

In cadrul tab-ului exista un subgrid Catalogs care afiseaza toate cataloagele Shopify in care se afla acest produs (pe toate site-urile B2B unde este vandut).

NOTA

Cataloagele se definesc doar in Shopify. BrandSync nu creeaza cataloage noi — doar gestioneaza apartenenta produselor la cataloagele existente.

Adaugarea unui produs intr-un catalog

1. Deschideti produsul pe formularul Produs → tab-ul Shopify Catalog
2. Apasati + New Produs Catalog
3. Selectati catalogul dorit din lookup-ul Catalog (sunt listate doar cataloagele din site-urile B2B unde produsul este vandut)
4. Salvati
5. Apasati Sincronizeaza in Shopify pe formularul produsului — produsul este publicat in catalog pe Shopify

WARNING

Doar salvarea randului NU publica produsul in catalog pe Shopify. Trebuie apasat butonul Sincronizeaza in Shopify pentru a trimite apartenenta catre Shopify.

Eliminarea unui produs dintr-un catalog

1. Selectati randul dorit din subgridul Catalogs
2. Apasati Delete (butonul standard din bara subgridului)
3. Confirmati actiunea

Eliminarea este imediata — produsul este scos din catalog pe Shopify si randul de legatura este sters din BrandSync in aceeasi operatie. Nu mai este nevoie sa apasati Sincronizeaza in Shopify dupa eliminare.

TIP

Daca o eliminare esueaza pe Shopify (de ex. problema de conexiune), randul nu se sterge din BrandSync — puteti reincerca operatia.

Sincronizarea cataloagelor din Shopify

Cand se creeaza un catalog nou in Shopify admin, acesta nu apare automat in BrandSync. Pentru a-l aduce in BrandSync:

1. Deschideti orice produs B2B → tab-ul Shopify Catalog
2. Apasati butonul Sync Catalogs din bara subgridului
3. Sistemul interogheaza cele 3 site-uri B2B si adauga cataloagele noi in BrandSync
4. Cataloagele aparute vor fi disponibile in lookup-ul + New Produs Catalog pe orice produs B2B

Butonul Sync Catalogs sincronizeaza doar lista de cataloage (masterul) — nu modifica apartenentele produselor existente. Cataloagele arhivate in Shopify sunt marcate automat ca inactive in BrandSync.

Cazuri speciale

Situatie	Comportament
Produs sters din BrandSync	Randurile etb_produscatalog asociate sunt sterse automat (cascade). Totusi, produsul ramane in cataloagele Shopify — recomandam eliminarea manuala din cataloage inainte de stergerea produsului.
Catalog arhivat in Shopify	La urmatorul Sync Catalogs, catalogul devine inactiv in BrandSync si nu mai apare in lookup-ul de adaugare. Apartenentele existente raman vizibile pentru istoric.
Catalog sters manual in Shopify admin	Aceeasi comportare ca la arhivare — randul devine inactiv la urmatorul Sync Catalogs.
Produs variant-master	Cataloagele se gestioneaza la nivel de master. Variantele mostenesc automat apartenenta masterului in Shopify.

Notificari

Dupa fiecare sincronizare, primiti o notificare in aplicatie:

Tip	Mesaj
Succes	{Cod Intern} - sincronizat cu succes in Shopify
Eroare	{Cod Intern} - sincronizare esuata. {detalii eroare}

Notificarile apar in coltul din dreapta sus al aplicatiei (pictograma clopotel).

Statusul sincronizarii

Pe formularul produsului, in tab-ul Sync Status, puteti vedea:

Camp	Descriere
Shopify Sync Status	Not Synced / Syncing / Synced / Failed
Shopify Last Synced On	Data si ora ultimei sincronizari
Shopify Sync Error	Mesajul de eroare (daca a esuat)

Probleme frecvente

Problema	Solutie
Eroare: campuri lipsa	Cititi mesajul de eroare — specifica ce lipseste si pe ce site/varianta. Completati si incercati din nou.
Imaginile nu apar in Shopify	Verificati ca imaginile sunt incarcate in BrandSync si ca produsul a fost re-sincronizat.
Pretul nu apare in Shopify	Verificati ca exista un pret (etb_pret) pentru site-ul respectiv.
Tagurile nu apar	Verificati ca exista taguri in grila "Tag per Site" (etb_produstagsite) pentru site-ul respectiv.
Varianta nu se sterge din Shopify	Dezactivati varianta in BrandSync si re-sincronizati produsul.
Produs inactiv inca vizibil pe Shopify	Dezactivati produsul in BrandSync si apasati "Sincronizeaza in Shopify" — statusul devine Draft.
Tab-ul Shopify Catalog nu apare	Verificati ca produsul este asociat cu cel putin unul din cele 3 site-uri B2B (Eternal HU B2B, Eternal RO B2B, Schwarzkopf PRO B2B) in grila Site-uri Shopify.
Catalog nou din Shopify nu apare in lookup	Apasati Sync Catalogs din subgridul Catalogs al unui produs B2B pentru a aduce cataloagele noi in BrandSync.
Produs adaugat in catalog nu apare pe Shopify	Dupa adaugarea randului in subgrid, trebuie apasat Sincronizeaza in Shopify — salvarea in BrandSync nu trimite automat apartenenta pe Shopify.
Eroare la Delete pe un rand din Catalogs	Verificati ca produsul exista in etb_shopifyidmap pentru site-ul respectiv (produsul trebuie sincronizat cel putin o data catre acel site inainte de a-l pune in catalog).