WooCommerce · Trendyol MarketplaceMATRICEA CATALOGULUI
Trendyol Connector: integrare Trendyol WooCommerce printr-o matrice de catalog verificabilă.
Conectorul potrivește produsele și variațiile WooCommerce cu taxonomia, valorile și stările Trendyol. Categoria finală, atributele, familia, titlul, imaginile și EAN-ul sunt verificate înaintea publicării. Ingestia comenzilor rămâne în Marketplace Hub, iar eventuala reaprovizionare eligibilă după retur este o decizie manuală separată.
- Categorii finale și atribute explicite
- Payload validat fără publicare și poartă EAN
- Operații Product V2 diferențiate
- Stări de comandă urmărite pe linie
Conectorul necesită WooCommerce și Marketplace Hub active. Instalarea nu publică produse, iar publicarea manuală și sincronizarea automată pentru stoc și preț pornesc oprite; fiecare operațiune externă se verifică separat.
O familie, mai multe intersecții verificatemapare, conținut, ofertă și stare operațională
MODEL CONCEPTUAL01 / DIAGNOSTIC CONECTAREREFERINȚĂ · COMERCIANT · WEBHOOK
Accesul este verificat pe trei suprafețe care pot răspunde diferit.
Conectorul separă diagnosticul API-ului de referință de citirea contextului comerciantului și de citirea contextului webhook. Astfel, o conexiune parțial funcțională nu este prezentată ca pregătire completă.
API de referință
Verifică autentificarea și accesul la resursele necesare pentru nomenclatoare.
ACCES TEHNICAPI comerciant
Verifică identificatorul comerciantului și citirea contextului catalogului asociat.
CONTEXT COMERCIALAPI webhook
Verifică separat citirea contextului; dreptul de creare este probat numai la înregistrarea explicită.
EVENIMENTE COMENZI
02 / RUTARE ȘI ATRIBUTECATEGORIE FINALĂ · PRIORITATE · NOMENCLATOR
Categoria nu este ghicită; este aleasă prin o ordine explicită de potrivire.
Trendyol acceptă publicarea într-o categorie finală. Conectorul verifică mai întâi excepția activă a produsului, apoi regulile de rutare ordonate și, la final, maparea categoriei comerciale de bază. O țintă care nu mai este finală nu este folosită.
- 01Excepție pe produs
SKU-ul părinte sau produsul poate avea propria categorie finală, cu prioritatea cea mai mare.
- 02Regulă de rutare
O categorie WooCommerce mai specifică poate conduce spre o destinație Trendyol diferită.
- 03Mapare de bază
Categoria comercială selectată oferă destinația de rezervă pentru produsele eligibile.
Separă prezentările
De regulă, culoarea diferențiază cardurile sau grupările de conținut.
Unește variațiile
De regulă, mărimea rămâne selector în interiorul aceleiași familii.
03 / FAMILIE, CONȚINUT ȘI SIMULARE
Culoarea și mărimea ocupă roluri diferite în aceeași familie.
Conectorul pregătește și validează payloadul Product V2 pentru fiecare variație fără o operație de scriere sau publicare în Trendyol; poate consulta nomenclatoarele necesare.
Produs și culoare
Regula analizată folosește titlul produsului părinte și culoarea mapată. Brandul este transmis separat, iar mărimea rămâne selector.
Identitate stabilă
Variațiile împart identificatorul familiei, iar mărimile aceleiași culori păstrează un titlu comun.
Galerie pe culoare
Conectorul încearcă asocierea imaginilor cu acea culoare când miniaturile și metadatele disponibile permit potrivirea. Fără ghid sunt disponibile opt poziții; cu ghid, cel mult șapte imagini de produs îl preced pe ultima poziție.
Poartă de publicare
Lipsa EAN-ului rămâne vizibilă în simulare, dar publicarea controlată și catalogul în masă cer un cod valid pentru fiecare variație.
Fără erori blocante
Familia poate ajunge la următoarea confirmare, dacă poarta EAN este îndeplinită.
Avertizare vizibilă
Semnalul cere atenție, fără să devină automat o eroare a structurii candidate.
Date obligatorii lipsă
Categoria, brandul, familia, conținutul, atributele sau oferta trebuie corectate în datele sursă.
04 / DOUĂ MODURI DE PUBLICARE
Produsul pilot și catalogul eligibil au reguli operaționale diferite.
Separarea este intenționată: controlul manual limitează efectul unui test, iar procesarea în masă poate continua după o eroare izolată și păstrează propria stare de execuție.PISTĂ APRODUS PILOT
Publicare controlată
- permisiunea manuală trebuie activată explicit;
- familia trece prin simulare și poarta EAN;
- un produs nou este creat inițial cu stoc zero;
- produsul existent folosește operația potrivită stării sale;
- trimiterea este reală și asincronă numai după confirmare.
PISTĂ BCATALOG ELIGIBIL
Procesare în masă
- rulează independent de permisiunea publicării manuale;
- produsele noi folosesc stocul WooCommerce curent;
- conținutul aprobat și cel neaprobat urmează operații diferite;
- familiile excluse sunt omise, iar cel mult ultimele 100 de erori sunt păstrate pentru reluarea cerută de operator;
- execuția de fundal poate fi pusă pe pauză și continuată.
| Stare găsită | Tratament | Verificare ulterioară |
|---|---|---|
| Produs nou | creare Product V2 | manual: urmărirea lotului și recitire separată; în bulk: dacă aprobarea apare în fereastra finită de urmărire, poate urma oferta |
| În verificare | actualizare pentru conținut neaprobat | recitire înaintea stocului și prețului |
| Aprobat | titlu, descriere și imagini | în bulk poate urma oferta; manual, oferta rămâne separată |
05 / STOC, PREȚ ȘI RECONCILIERESURSĂ · LOT · DIFERENȚĂ
WooCommerce rămâne referința, iar diferențele devin elemente de reconciliat.
Stocul și prețul pot fi trimise prin lucrări separate numai pentru SKU-urile mapate și aprobate. Conectorul folosește o fereastră de cincisprezece minute pentru a evita retrimiterea aceluiași payload, iar identificatorul lotului păstrează o urmă pentru procesarea la distanță.
Cantitate WooCommerce
Valoarea vandabilă pornește din magazin și este trimisă numai pentru o mapare Trendyol cunoscută și aprobată.
Curent și de listă
Pentru SKU-ul mapat și aprobat, prețul curent alimentează oferta, iar prețul regulat poate furniza valoarea de listă.
Urmărire BatchRequest
Pentru sincronizarea individuală, identificatorul lotului și valorile așteptate sunt păstrate local; o verificare ulterioară citește starea procesării.
Catalog aprobat
Verificarea periodică compară ofertele aprobate; corecția WooCommerce către Trendyol rămâne opțională.
06 / COMENZI, LINII ȘI RETURURIWEBHOOK · REZERVARE · ELIBERARE
Două căi pot observa comanda, iar efectul de stoc al liniei este protejat împotriva repetării prin Hub.
Webhook-ul este canalul principal, iar citirea periodică este programată la interval de un minut ca mecanism de rezervă; momentul efectiv depinde de cronul WordPress și nu reprezintă un SLA de timp real. Conectorul păstrează o cheie pentru efectul de stoc al fiecărei linii, reducând riscul ca aceeași schimbare observată pe ambele căi să aplice din nou cantitatea.
- 01Comandă în așteptare
Linia validă poate înregistra rezervarea cantității WooCommerce sub propria cheie de efect.
- 02Stare observată din nou
Evidența locală poate fi actualizată, iar cheia mișcării limitează repetarea aceluiași efect asupra stocului.
- 03Anulare sau nefurnizare
Linia eligibilă poate elibera cantitatea rezervată folosind cheia efectului corespunzător.
- 04Retur
Numai reclamațiile eligibile pot duce la reaprovizionare manuală, după inspecția fizică.
07 / CE LIVRĂM
O matrice adaptată la catalogul, contul și operarea ta.
Implementarea de referință oferă mecanismele tehnice. Configurația finală pornește din taxonomiile, variațiile, media, regulile comerciale și responsabilitatea fiecărui sistem din proiect.Conectare diagnosticată
Citirea și contextul celor trei suprafețe API sunt verificate separat; crearea webhook-ului se probează numai la înregistrarea explicită.
REFERINȚĂ · COMERCIANT · WEBHOOKCategorii finale
Mapări de bază, reguli prioritare, excepții pe produs și excluderi documentate.
FINALĂ · PRIORITATE · EXCEPȚIEValori permise
Surse WooCommerce, slicer, varianter și normalizări pentru atributele cu nomenclator restricționat; valorile custom rămân posibile numai când definiția categoriei le permite.
CULOARE · MĂRIME · SURSEFamilie și media
Titlu, descriere, brand separat, reguli pentru galeria pe culoare și tabel de mărimi pregătit.
PRODUCT V2 · EAN · VERIFICAREPilot și catalog
Validarea payloadului fără publicare în Trendyol, confirmare manuală, procesare de fundal și erori acționabile.
CREARE · ACTUALIZARE · LOTStoc și preț
Lucrări delimitate, identificatori de lot și comparație periodică cu sursa WooCommerce.
DEDUPLICARE · STARE · DIFERENȚĂRegistru pe linie
Webhook, mecanism de rezervă, chei care limitează repetarea aceluiași efect de stoc pe linie și reaprovizionare manuală numai pentru reclamațiile eligibile după inspecție.
LINIE · STOC · RETURTestare și operare
Scenarii reprezentative, lansare graduală, diagnostic și proceduri de intervenție.
MEDIU DE TESTARE · PILOT · SUPORT08 / COMPATIBILITATE ȘI LIMITE
Versiunile minime sunt cunoscute; compatibilitatea reală se testează.
Cerințele de mai jos descriu versiunea analizată. Tema, extensiile, cronul, catalogul, media și permisiunile contului trebuie validate în mediul magazinului.| Componentă | Cerință a versiunii analizate | Ce validăm |
|---|---|---|
| WordPress | versiunea 6.8 sau mai nouă | permisiuni, cron și execuție de fundal |
| PHP | versiunea 8.0 sau mai nouă și extensia mbstring | stocarea credențialelor, memoria și limitele de execuție |
| WooCommerce | versiunea 9.0 sau mai nouă | produse, variații, stoc și prețuri |
| Marketplace Hub | versiunea 0.2.1 sau mai nouă | adaptor, cozi, mapări și mișcări |
| Procesare media | formate sursă lizibile și suport GD pentru conversie | copiile media 1200 × 1800 și păstrarea originalelor |
| Bază de date | MySQL sau MariaDB și drepturi pentru tabelele operaționale | creare, actualizare și reîmprospătarea cache-ului de categorii |
| Compatibilități Woo | HPOS, blocuri coș/checkout și editor produs declarate | extensiile care ating aceleași fluxuri |
| Trendyol România | cont și acces API potrivit operațiilor | comerciant, piață, brand și taxonomii |
09 / IMPLEMENTARE
Completăm matricea de la acces la prima familie urmărită cap-coadă.
Fiecare etapă are date de intrare, o verificare și o decizie explicită înainte de extinderea efectului.- 01AUDIT
Catalog și autoritate
Inventariem produsele, variațiile, EAN-urile, categoriile, media și sursa pentru stoc și preț.
- 02ACCES
Diagnostic pe trei niveluri
Verificăm referințele, contextul comerciantului și citirea contextului webhook; dreptul de creare este probat numai la înregistrarea explicită.
- 03MAPARE
Categorii și valori
Definim destinațiile finale, regulile prioritare, excepțiile, slicer-ul și varianter-ul.
- 04SIMULARE
Familie reprezentativă
Corectăm în datele sursă EAN-ul, titlul, descrierea, imaginile, atributele și oferta.
- 05PILOT
Publicare controlată
Confirmăm prima familie, urmărim lotul și separăm primirea tehnică de aprobarea conținutului.
- 06OPERARE
Extindere graduală
Activăm loturile, oferta, comenzile și reconcilierea numai după verificarea scenariilor de revenire.
11 / ÎNTREBĂRI FRECVENTE
Ce verificăm înainte de prima operație reală.
Întrebările și răspunsurile provin din registrul unic al portofoliului, pentru ca pagina vizibilă și datele structurate să rămână aliniate.01Trendyol 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 reale, extensiile PHP, accesul HTTPS, cronul, URL-urile publice pentru media și endpointul public necesar notificărilor de comandă.
02Oprirea Live Sync blochează orice scriere către Trendyol?
Nu. Live Sync controlează trimiterea evenimentelor de stoc și preț venite prin Hub. Publicarea manuală, catalogul în loturi, sincronizările pornite explicit și remedierea prin reconciliere sunt operațiuni separate și trebuie configurate ori oprite individual.
03Conectorul poate publica produse cu variații?
Da. Construiește familii și variații pe baza produsului părinte, culorii și mărimii, însă fiecare element trebuie să treacă verificările categoriei, atributelor și imaginilor și să aibă un EAN-13 valid înainte de publicare.
04Cum sunt alese categoria și atributele Trendyol?
Conectorul folosește categorii finale și nomenclatoarele citite din API, păstrează mapări locale și permite excluderi sau o categorie specifică la nivel de produs. Sinonimele și normalizările proiectului ajută potrivirea valorilor atributelor, dar nu garantează compatibilitatea cu orice catalog.
05Ce face verificarea înainte de publicare?
Pregătește candidatul și verifică produsul, categoria, brandul, EAN-ul, atributele, prețul, stocul, descrierea și imaginile fără să execute operația de scriere în Trendyol. Poate totuși citi nomenclatoare prin API și poate genera local copii JPEG necesare galeriei.
06Cum sunt pregătite imaginile pentru Trendyol?
Conectorul încearcă să asocieze galeria unei culori folosind thumbnailul variației, legăturile dintre atașamente și metadatele disponibile; rezultatul depinde de structura catalogului. Limita este de opt imagini, iar un ghid de mărimi poate ocupa ultimul loc. Procesarea pe un canvas JPEG de 1200 × 1800 depinde de GD, de suportul formatelor și de accesul la directorul WordPress de încărcări.
07Ce se sincronizează între WooCommerce și Trendyol?
Pentru SKU-urile mapate și aprobate, WooCommerce rămâne sursa pentru stoc și preț. Actualizările sunt asincrone, cererile identice sunt deduplicate într-o fereastră de 15 minute, iar reconcilierea periodică și remedierea automată sunt opționale și unidirecționale către Trendyol.
08Comenzile Trendyol devin comenzi WooCommerce?
Nu. Webhook-ul procesează payloadul primit, iar pollingul programat citește Order V2; ambele păstrează datele în Marketplace Hub. Cheia liniei limitează repetarea aceluiași efect asupra stocului, fără să transforme întregul flux într-o procesare exact o singură dată ori în timp real.
09Conectorul automatizează retururile, AWB-ul și factura?
Nu. O linie anulată sau nefurnizată poate elibera stocul o singură dată, însă starea Returned nu repune marfa automat în stoc. Pentru anumite reclamații eligibile există o acțiune manuală după inspecție. AWB-ul, factura, etichetele, trackingul, aprobarea rambursării și schimbarea statusului coletului nu sunt funcții ale build-ului auditat.
10Ce cerințe și limite trebuie validate înainte de lansare?
Build-ul necesită WordPress 6.8+, WooCommerce 9.0+, Marketplace Hub 0.2.1+, PHP 8.0+, mbstring, acces HTTPS, cron funcțional și drepturi pentru tabelele operaționale MySQL ori MariaDB. GD cu JPEG și directorul de încărcări inscriptibil sunt necesare pentru conversii. Protecția credențialelor folosește Sodium ori AES-GCM când sunt disponibile; fallback-ul Base64 nu este criptare. Nu garantăm aprobarea, sincronizarea instantanee, eliminarea supravânzării sau reluarea automată a fiecărei scrieri.
12 / URMĂTORUL PAS