WooCommerce · eMAG MarketplaceLINIA DE PUBLICARE
eMAG Connector: integrare eMAG WooCommerce, controlată de la catalog la comandă.
Conectorul pregătește produsele și variațiile pentru eMAG, verifică mapările, titlurile, identificatorii, informațiile GPSR și imaginile, apoi separă simularea de orice scriere reală în eMAG. Publicarea, actualizările de catalog, stocul, prețul și comenzile rămân fluxuri distincte, urmărite prin Marketplace Hub.
- Simulare locală înaintea trimiterii
- Publicare controlată, familie cu familie
- WooCommerce ca sursă pentru stoc și preț
- Efecte de stoc aplicate o singură dată
Conectorul necesită WooCommerce și Marketplace Hub active. Instalarea nu pornește automat scrierile către eMAG; accesul API, mapările și permisiunile de publicare sunt configurate și testate explicit.
Date pregătite înainte de scrierefamilie, documentație, ofertă și dovezi separate
DATE DEMONSTRATIVETraseul controlat al unui produs către eMAG
- 01Mapeazăcategorie și caracteristici
- 02Simuleazăerori, avertizări și ofertă
- 03Confirmăprodus, familie sau lot
- 04Urmăreșterăspuns, aprobare și dovezi
- 05Sincronizeazăstoc, preț și comenzi
01 / MAPARE CATALOGCATEGORIE · CARACTERISTICI · FAMILIE
Structura WooCommerce este tradusă în nomenclatorul categoriei eMAG.
Conectorul citește și păstrează local categoriile eMAG, asociază taxonomiile WooCommerce și permite o categorie specifică pentru produsele care ies din regula generală. Produsele excluse rămân în afara simulării, publicării și sincronizărilor de ofertă.
Categorie verificată
Maparea generală poate fi înlocuită explicit la nivel de produs, fără a amesteca identificatorii altui marketplace.
Caracteristici admise
Valorile pentru mărime, culoare, material și alte câmpuri sunt comparate cu nomenclatorul categoriei selectate.
Familie întreagă
Familia WooCommerce și variațiile sunt pregătite împreună, fără împărțirea familiei între cereri.
Titlu controlat
Șablonul combină câmpuri WooCommerce, brand, material, culoare și mărime, cu previzualizare înainte de trimitere.
02 / SIMULARE ȘI GPSRDATE LOCALE · ERORI · AVERTIZĂRI
Înaintea publicării, conectorul construiește candidatul complet local.
Simularea pregătește structura care ar urma să fie trimisă, dar nu apelează operația de scriere. Verifică familia, identificatorii, descrierea, imaginile, prețul, TVA-ul, stocul și câmpurile de conformitate configurate pentru produs.
Verificări trecute
Produsul poate ajunge la confirmarea manuală; avertizările rămân vizibile.
Necesită atenție
Semnalul este informativ și nu schimbă singur starea de publicare.
Trimitere blocată
Familia completă rămâne local până când datele obligatorii sunt corectate.
- Identitate produsSKU, EAN acolo unde categoria îl cere și compoziția stabilă a variațiilor.
- DocumentațieTitlu, descriere, caracteristici și galerie cu cel puțin o fotografie reală de produs.
- Conformitate GPSRProducător, reprezentant în Uniunea Europeană și informații de siguranță configurate.
- OfertăPreț, TVA, depozit, termen de procesare, garanție, statut și stoc în limitele acceptate.
03 / PUBLICARE ȘI LOTURI
Scrierea pornește după o confirmare și lasă o urmă pentru fiecare familie.
Produsele noi sunt trimise inactive, iar activarea se face separat după aprobarea documentației. Pentru catalogul extins, conectorul folosește operațiuni reluabile și păstrează familiile intacte.
Publicare controlată
Operatorul verifică simularea, activează permisiunea și confirmă explicit produsul înainte de trimitere.
Numai produse noi
Modul implicit omite întreaga familie dacă un membru este deja mapat local sau identificat în eMAG.
Familii nedivizate
Un pas procesează până la 20 de produse părinte și 50 de entități eMAG. O familie care depășește limita nu este fragmentată sau trimisă și necesită restructurare.
Documentație și galerie
Înlocuirea completă pentru ofertele existente este o operațiune separată, cu confirmare nouă la fiecare pornire sau reluare.
04 / STOC, PREȚ ȘI RECONCILIERESURSĂ · DEDUPLICARE · DOVADĂ
WooCommerce rămâne sursa comercială, iar oferta eMAG primește actualizări delimitate.
Stocul și prețul pot fi trimise manual pentru un SKU, în lot sau prin sincronizarea activă. Actualizările automate sunt deduplicate și limitate ca ritm, iar o schimbare de ofertă nu retrimite implicit documentația și imaginile produsului.
Cantitate WooCommerce
Valoarea vandabilă este normalizată pentru intervalul acceptat de eMAG și propagată prin Hub către adaptoarele active.
Calcul configurat
Multiplicatorul și TVA-ul sunt aplicate controlat, cu limite de siguranță pentru oferta transmisă.
Activare păstrată
Actualizarea unei oferte existente păstrează starea eMAG citită înaintea unei corecții de documentație.
Citire fără retrimitere
Dovezile neînchise pot fi verificate local sau prin citire, separat de orice nouă scriere de catalog.
05 / COMENZI ȘI NOTIFICĂRI APIPRELUARE · STOC · CONFIRMARE
Evenimentul eMAG este preluat și normalizat, iar efectul asupra stocului este aplicat o singură dată.
Notificarea API poate porni citirea comenzii, iar o verificare de rezervă este programată la interval de un minut, în funcție de cron. Marketplace Hub păstrează comanda externă, identifică liniile după SKU și protejează scăderea stocului împotriva procesării repetate.
- 01Notificare sau verificare periodică
Conectorul solicită detaliile comenzii din API, fără a avea încredere în datele unei simple notificări.
- 02Normalizare în Marketplace Hub
Identificatorul extern și liniile comenzii sunt păstrate într-un registru separat.
- 03Mișcare de stoc protejată
Fiecare linie aplică efectul cantitativ o singură dată, apoi actualizarea poate reveni către canalele active.
- 04Confirmare către eMAG
Comanda este confirmată numai după procesarea locală reușită.
06 / CE LIVRĂM
O integrare adaptată la catalogul și operarea magazinului tău.
Implementarea de referință oferă mecanismele, dar configurația finală pornește din taxonomiile, atributele, regulile comerciale și responsabilitățile proiectului.Acces API protejat
Adresă API fixă, credențiale stocate criptat, test de conexiune și scrieri dezactivate inițial.
ACCES · TEST · PERMISIUNIMapări și excluderi
Categorii, caracteristici, reguli pe produs, titluri, familii și identificatori.
TAXONOMII · VARIAȚII · SKUDate GPSR
Structura pentru producător, reprezentant european și informații de siguranță.
CONFIGURARE · VALIDARE · DOVADĂSimulare și porți
Erori blocante, avertizări vizibile, publicare manuală și produse noi inactive.
VERIFICARE · CONFIRMARE · CONTROLLoturi și reconciliere
Pauză, reluare, erori acționabile și tratarea separată a rezultatelor incerte.
STARE · DOVEZI · RECUPERAREOfertă și comenzi
Stoc, preț, notificări API, verificare periodică, anulări și limite pentru retur.
HUB · SINCRONIZARE · JURNALGalerie verificată
Procesare JPEG, manifest stabil și verificare ulterioară fără retrimitere automată.
ORDINE · IDENTITATE · CITIRETeste și operare
Matrice de scenarii, lansare graduală, proceduri de intervenție și documentație.
MEDIU DE TESTARE · PILOT · SUPORT07 / COMPATIBILITATE ȘI LIMITE
Contractul tehnic este clar, iar potrivirea se confirmă prin audit.
Versiunile minime descriu pachetul analizat. Tema, extensiile, catalogul, contul eMAG și infrastructura de programare trebuie verificate în mediul proiectului.| Componentă | Cerință a versiunii analizate | Ce validăm |
|---|---|---|
| WordPress | versiunea 6.8 sau mai nouă | programare, permisiuni și mediu |
| PHP | versiunea 8.0 sau mai nouă | extensii criptografice și limite |
| WooCommerce | versiunea 9.0 sau mai nouă | produse, variații, HPOS și stoc |
| Marketplace Hub | versiunea 0.2.1 sau mai nouă | adaptor, cozi, comenzi și mișcări |
| eMAG | cont Marketplace și acces API România | drepturi, categorii și nomenclatoare |
| Bază de date | MySQL 5.7.5+ sau MariaDB 10.0+ | mutexuri multiple și blocare sigură |
| Extensii PHP | mbstring; Sodium ori OpenSSL AES-256-GCM; Imagick ori GD cu JPEG | text, protecția accesului API și procesarea galeriei |
| Programare | execuție de fundal funcțională | frecvență, volum, concurență și alerte |
08 / IMPLEMENTARE
De la audit la primul lot, fiecare poartă are un criteriu de ieșire.
Activăm fluxurile gradual, după ce datele și efectele lor pot fi verificate în ambele sisteme.- 01AUDIT
Catalog și responsabilități
Inventariem taxonomiile, atributele, SKU-urile, sursa stocului, TVA-ul, media și fluxul comenzilor.
- 02CONFIGURARE
Acces și mapări
Testăm API-ul, încărcăm nomenclatoarele și definim categorii, caracteristici, excluderi și GPSR.
- 03SIMULARE
Familii reprezentative
Corectăm erorile local și verificăm titlurile, variațiile, imaginile și oferta fără scriere externă.
- 04PILOT
Publicare inactivă
Trimitem controlat un set restrâns, urmărim răspunsurile, aprobarea și mapările înainte de activare.
- 05LANSARE
Loturi și fluxuri active
Creștem gradual volumul, apoi activăm stocul, prețul și comenzile cu monitorizare și proceduri de revenire.
10 / ÎNTREBĂRI FRECVENTE
Ce verificăm înainte de prima trimitere reală.
Răspunsurile provin din registrul unic al portofoliului, pentru ca pagina și datele structurate să rămână aliniate.01eMAG Connector funcționează fără Marketplace Hub?
Nu. Implementarea auditată este un adaptor pentru Marketplace Hub și necesită WooCommerce. Înainte de instalare verificăm versiunile, categoria de catalog, MySQL ori MariaDB, mbstring, extensia criptografică, procesarea JPEG și compatibilitatea cu magazinul real.
02Instalarea publică automat produsele în eMAG?
Nu. Scrierile manuale și sincronizarea automată sunt oprite implicit. Conexiunea, mapările, simularea și produsul pilot trebuie validate înainte ca o operațiune externă să fie activată explicit.
03Poate mapa automat toate categoriile și caracteristicile?
Conectorul citește taxonomia disponibilă contului eMAG, însă legăturile comerciale se aleg și se verifică explicit. Categoriile, caracteristicile, familiile, excluderile și excepțiile pe produs trebuie adaptate catalogului real.
04Ce face simularea locală înainte de publicare?
Construiește cererea candidată și verifică produsul, categoria, titlul, descrierea, caracteristicile, familia, EAN-ul, prețul, TVA-ul, stocul, imaginile și datele GPSR fără să scrie în eMAG. Erorile blochează, iar avertizările rămân informative.
05Produsele devin active imediat după trimitere?
Nu. Produsele noi sunt trimise inițial inactive. Un răspuns tehnic reușit confirmă primirea cererii, nu aprobarea produsului; activarea este separată și cere verificarea aprobării atribuite documentației curente.
06Importul sigur poate suprascrie produse existente?
Modul implicit pentru produse noi omite întreaga familie când identifică un membru deja mapat sau existent în eMAG. Corectarea documentației și înlocuirea galeriei unei oferte existente folosesc o operațiune separată, confirmată explicit. Aceasta nu este o garanție create-only: scrierile simultane din panoul eMAG ori din alte integrări rămân în afara blocării locale.
07Care sistem rămâne sursa pentru stoc și preț?
WooCommerce rămâne sursa comercială. Conectorul poate trimite valorile manual, în lot sau automat pentru SKU-urile mapate și poate verifica periodic diferențele prin reconciliere. Procesarea este asincronă și depinde de server și de API.
08Comenzile eMAG devin automat comenzi WooCommerce?
Nu. Implementarea auditată le normalizează și le păstrează în Marketplace Hub, apoi validează SKU-urile și aplică o singură dată efectul necesar asupra stocului WooCommerce înainte de confirmarea către eMAG.
09Cum sunt tratate anulările, retururile, AWB-urile și facturile?
Anularea confirmată poate elibera stocul o singură dată, iar returul cere inspecție fizică înainte de reaprovizionare. AWB-ul este emis în panoul eMAG Marketplace. Conectorul poate urmări livrarea și poate atașa un PDF furnizat de un sistem fiscal separat, dar nu emite factura.
10Integrarea garantează aprobarea sau sincronizarea instantanee?
Nu. Aprobarea aparține eMAG, iar timpul de procesare depinde de API, programarea serverului, volumul catalogului și limitele canalului. Implementarea oferă validări, stări și mecanisme controlate de recuperare, fără garanția eliminării tuturor diferențelor ori a supravânzării.
11 / URMĂTORUL PAS