DAGMAR / Studiu de caz 11 / Integrare API custom

Integrare Trendyol API cu WooCommerce.
Catalog pregătit. Fluxuri controlate.

Implementarea custom DAGMAR pregătește produsele pentru Trendyol, gestionează cozile de stoc și preț și corelează comenzile cu WooCommerce și ERP-ul Supplier. Fiecare etapă are validări și stări proprii.

Product V2 și Brand FactoryStocuri și prețuri prin APIComenzi și facturi Supplier

Explorează integrarea Proiectul DAGMAR

Lista de produse din panoul de partener Trendyol, cu imagini, SKU, EAN, prețuri și stocuri. Cele trei linii afișate au starea Document în așteptare. — **Catalogul din panoul de partener Trendyol**Dovadă din panoul de partener: produsele au ajuns în catalogul contului, însă liniile afișate sunt în proces de aprobare, cu documente în așteptare. Captura nu este o ofertă publică.

Catalog administrativ: produsele sunt în verificare la momentul capturii.

01Produse, categorii și branduri corelate

02Cozi și rezultate urmărite separat

03Comenzi conectate la circuitul ERP

01 / Conectare Trendyol API

Accesul se configurează.
Automatizările se aleg.

Integrarea grupează catalogul, mapările, brandurile, comenzile, stocul, prețul și facturile într-o administrare dedicată WooCommerce.

Permisiunea LIVE pentru scrierile către Trendyol este separată de activarea importului automat de comenzi, a sincronizării stoc/preț și a procesării facturilor. În configurația capturată, mediul este PROD, LIVE este activ, iar cele trei automatizări sunt dezactivate.

Operatorul poate folosi acțiunile manuale și poate urmări starea fiecărei operațiuni. Importul comenzilor are propriul control, distinct de scrierile către marketplace.

Setările Trendyol arată mediu PROD, multiplicator de preț 1,1600, multiplicator de stoc 1,0000 și scrieri LIVE bifate. Importul automat de comenzi, sincronizarea automată de stoc și preț și uploadul automat al facturilor Supplier sunt debifate. — **Scrieri LIVE și automatizări configurate separat**Permisiunea de scriere LIVE este activă, iar cele trei automatizări sunt oprite în configurația capturată. Identificatorul contului și câmpurile de acces sunt excluse din imagine.

CATALOG

Date pregătite pentru Product V2

Selecție de produse, identificatori, categorii, branduri, atribute și imagini adaptate fluxului Trendyol.

OFERTE

Reguli pentru stoc și preț

Multiplicatori separați și o coadă persistentă pentru actualizarea ofertelor eligibile.

COMENZI ȘI DOCUMENTE

Legătura cu WooCommerce și ERP

Referințe pentru comenzi și pachete, cantități active, validări comerciale și coada facturilor.

Panoul operațional și compatibilitatea Supplier

Snapshotul din administrare arată 118 mapări de produse, o comandă, 327 de operațiuni în coadă și o factură. Acești indicatori descriu registrele locale, iar aprobarea produselor și finalizarea operațiunilor au stări separate.

Panoul integrării arată API configurat, mediu PROD, scrieri LIVE active, multiplicatori de preț 1,1600 și stoc 1,0000, compatibilitatea Supplier și contoare: 118 produse mapate, o comandă, 327 înregistrări în coadă și o factură. — **Starea integrării custom WooCommerce–Trendyol**Panoul reunește configurarea și volumele locale ale integrării custom. Cele 118 produse mapate reprezintă evidența locală, nu un contor de oferte publicate.

Tabelul de compatibilitate detectează Supplier Sync 1.3.6, Supplier Clients 2.1.14 și Supplier Invoices 1.0.14, alături de versiunile minime cerute de integrarea Trendyol. — **Compatibilitatea cu fluxul ERP Supplier**Integrarea verifică modulele Supplier folosite în fluxul ERP pentru sincronizare, clienți și facturi. Tabelul arată compatibilitatea detectată.

02 / Catalog WooCommerce pentru Trendyol

Produsele au o selecție.
Brandurile au o corespondență.

Catalogul pornește din categoria WooCommerce și/sau brandul PWB selectat. Variațiile BAX sunt excluse din acest flux. EAN și concentrația alcoolică se pot completa direct în administrare.

Selecție comercială și date complete

Se lucrează cu un catalog delimitat.

Tabelul arată produsele selecției, datele necesare și starea pregătirii. Excluderile comerciale sunt păstrate în configurația integrării Trendyol, iar datele EAN și ALC se salvează în câmpurile WooCommerce aferente.

Catalog & Import filtrează categoria Vinuri — Exclusiv Dagmar împreună cu brandul Marques de Riscal, elimină variațiile BAX și arată șase produse în selecție, READY zero și șase deja în flux. — **Selecție de catalog după categorie și brand**Selecția combină categoria cu brandul și include numai produsele unitare eligibile pentru listă. În acest exemplu toate cele șase produse sunt deja în flux.

Tabelul celor șase produse Marques de Riscal afișează SKU, EAN, ALC, preț WooCommerce și preț Trendyol. SKU 26670 are 45,00 lei și 52,20 RON; SKU 28280 are 81,50 lei și 94,54 RON. Toate rândurile au status QUEUED. — **SKU, EAN, alcool și preț în catalogul pregătit**Valorile locale arată aplicarea multiplicatorului de preț 1,16 în exemplele vizibile. Statusul QUEUED arată că produsele sunt în flux, fără a demonstra prețul unei oferte publice.

Filtre și acțiuni asupra selecției

Filtrarea pe categorii delimitează aria mapărilor. În catalog, căutarea, plafonul de preț și statusul completează selecția. Acțiunile bulk permit includerea, excluderea și pregătirea produselor eligibile pentru coada Product Create.

Interfața mapărilor arată un cache de 100.060 branduri și 3.136 categorii leaf, apoi filtrarea categoriilor WooCommerce Spumante EXCLUSIV și Exclusiv Dagmar. — **Cache de marketplace și filtrarea mapărilor**Cache-ul oferă valorile de referință pentru mapări. Filtrarea restrânge interfața la ramurile comerciale selectate și păstrează mapările din afara selecției.

Panoul Product Create descrie verificarea SKU, EAN, ALC, mapărilor, prețului, TVA și imaginii derivate 1200×1800. Importul automat este oprit; coada globală arată Processing 100 și Success 18. — **Validare locală și procesare controlată a catalogului**Validarea și comenzile de procesare au loc înaintea trimiterii. Contorul local Success 18 descrie procesarea Product Create și nu demonstrează 18 oferte aprobate.

Identificatori comuni între platforme

Categoria și brandul se leagă explicit.

Categoria WooCommerce este asociată unei categorii finale Trendyol. Brandurile PWB primesc identificatorul corespondent din marketplace.

Caracteristicile produsului sunt construite din taxonomiile WooCommerce și regulile implementate pentru denumirile și valorile acceptate de categoria Trendyol. Verificarea evidențiază datele obligatorii lipsă și avertismentele.

Două mapări existente leagă Spumante EXCLUSIV de categoria Trendyol Șampanie și vin spumant 5644 și Exclusiv Dagmar de categoria Vin 5643. — **Maparea categoriilor WooCommerce în Trendyol**Categoriile interne WooCommerce sunt asociate cu categorii leaf Trendyol, păstrând vizibilă structura comercială internă.

Administrare · exemplu de configurare

Asocierea brandurilor WooCommerce cu TrendyolMapările existente și lipsurile rămân vizibile separat. Exemplul Aperol nu are un brand Trendyol selectat.

Brand Factory / PWB → Trendyol

Asocierile și imaginile se pregătesc împreună.

Instrumentul pornește din brandurile WooCommerce, permite căutarea corespondenței și pregătește informațiile pentru solicitările de brand. Numele brandului, logo-ul și imaginile produselor pot fi folosite în solicitarea de creare a brandului.

Lista separă brandurile mapate de cele care încă necesită asociere. Rezultatul unei solicitări și identificatorul returnat de API sunt folosite pentru asocierea brandului în catalog.

Administrare · exemplu de configurare

Brand Factory: verificare înainte de creareFluxul verifică existența brandului înainte de creare și poate mapa local un brand existent. Captura arată regulile și controlul de procesare, fără un răspuns nou de creare.

Imagini și branduri rămase de asociat

Administrare · exemplu de configurare

Logo PWB și imagini reprezentative de produsSursele vizuale sunt inspectabile pe fiecare brand. Un logo PWB lipsă este indicat explicit, separat de existența unei mapări Trendyol.

Administrare · exemplu de configurare

Un brand nemapat rămâne o acțiune explicităAperol este încă nemapat în captura primită. Butonul arată acțiunea disponibilă și nu dovedește că aceasta a fost executată.

SKU-ul și codul de bare au roluri distincte.SKU-ul WooCommerce este păstrat drept cod comercial al produsului. Barcode-ul identifică produsul în fluxul Trendyol, iar identificatorul produsului părinte grupează variațiile eligibile.

03 / Product V2 și publicare prin API

Datele se verifică.
Rezultatele se citesc pe etape.

Pregătirea Product V2 verifică identificatorii, categoria, brandul, TVA-ul, SGR-ul, atributele și imaginile. Lipsa datelor obligatorii blochează trimiterea produsului până la corectare.

Integrarea pregătește imagini JPEG de 1200 × 1800 px, pe fundal alb, cu produsul încadrat integral. Titlul și descrierea sunt construite pentru catalogul Trendyol, inclusiv bannerul DAGMAR în descriere.

Formularul Product V2 permite introducerea unui SKU WooCommerce sau a unui ID explicit, tratează SKU-urile numerice și exclude variațiile BAX din analiză. — **Analiză după SKU sau ID WooCommerce**Punctul de intrare în analiză diferențiază SKU-ul de ID-ul intern WooCommerce și limitează selecția la variațiile unitare. Captura arată formularul, fără un rezultat de preview.

01 / PREGĂTIRE LOCALĂ

READY

Datele trec verificarea locală de bază. Validarea completă a atributelor și imaginilor precedă trimiterea.

02 / PROCESARE API

Batch

Cererea primește un identificator, apoi rezultatele sunt reconciliate pe barcode.

03 / MARKETPLACE

Aprobare și vânzare

Starea produsului și disponibilitatea magazinului se verifică în Trendyol.

Maparea rămâne legată de starea produsului.

Registrul local păstrează produsul WooCommerce, codurile comerciale și statusul cunoscut. Capturile includ produse marcate under_review și queued; aceste stări descriu etape diferite ale fluxului.

Administrare · exemplu de configurare

Produse urmărite cu starea under_reviewProdusele au identificatori comerciali și mapări locale, iar starea afișată este under_review. Aceste rânduri nu dovedesc aprobarea sau afișarea unei oferte publice.

Administrare · exemplu de configurare

Stări distincte pentru produsele din fluxAceeași evidență locală păstrează distinct produsele under_review și queued; introducerea în coadă nu echivalează cu aprobarea în marketplace.

Un lot reușit și o respingere au explicații separate.

Istoricul capturat arată două operațiuni Product Create cu status success și două respingeri anterioare care invocă regulile categoriei. Mesajul returnat este păstrat pentru corectarea și reluarea operațiunii.

Coada este persistentă, iar trimiterea produselor se face în loturi de maximum 100. Rezultatul este asociat fiecărui barcode, pentru a păstra distinct succesul sau eroarea fiecărui produs.

Tabelul batch-urilor Product Create arată două rânduri success și două failed, cu referințe de produse, mesaje de eroare și date. Identificatorii batch-urilor sunt mascați. — **Batch-uri Product Create: rezultate distincte**Răspunsurile de procesare sunt păstrate pe batch. Success la Product Create nu înlocuiește aprobarea produselor în panoul de partener.

Detaliu al celor două batch-uri Product Create failed: mesajul precizează reguli de transport, legale sau de platformă pentru RO și categoria 5644. — **Restricție de categorie vizibilă în răspuns**Răspunsul păstrează motivul respingerii pentru categoria 5644. Cazul este documentat ca eroare, fără a-l prezenta drept rezolvat.

Starea catalogului în portalul partenerului

În captura portalului, 118 produse sunt în așteptarea aprobării sau documentelor, iar numărul produselor active este zero. Bannerul indică magazinul în vacanță, cu produsele închise vânzării. Acest exemplu documentează catalogul și procesul de verificare din acel moment.

Panoul de partener Trendyol arată zero produse active, 118 produse în proces de aprobare și un produs inactiv; filtrul Aprobare în așteptare are 118 rezultate. — **118 produse în proces de aprobare**Contoarele separă catalogul trimis de produsele active: în momentul capturii, 118 produse sunt în proces de aprobare și zero sunt active.

Avertismentul Trendyol precizează că magazinul este în vacanță și produsele nu sunt deschise spre vânzare. Sub acesta se văd contoarele de aprobare și produse active. — **Starea magazinului și disponibilitatea comercială**Starea contului influențează disponibilitatea: captura arată modul de vacanță activ și mesajul explicit că produsele nu sunt deschise spre vânzare.

04 / Sincronizare stocuri și prețuri Trendyol

Două valori comerciale.
Două reguli separate.

Stocul și prețul pornesc din WooCommerce, inclusiv după actualizările venite din ERP-ul Supplier. Integrarea Trendyol aplică propriile reguli și pregătește actualizările pentru ofertele mapate și aprobate.

STOC TRANSMIS

Cantitate WooCommerce
× multiplicator de stoc

Rezultatul se rotunjește în jos și are limita de 20.000 de unități. Pentru produsele fără gestiune numerică, baza este 1 dacă sunt în stoc și 0 dacă sunt indisponibile.

PREȚ CALCULAT

Preț obișnuit WooCommerce
× multiplicator comercial

Prețul este rotunjit la două zecimale. Dacă prețul obișnuit lipsește, este folosit prețul activ. Aceeași valoare este trimisă pentru listPrice și salePrice.

Exemplu din catalog / SKU 28280

81,50 lei × 1,16 = 94,54 RONPrețul WooCommerce și valoarea calculată pentru Trendyol, în captura locală. Produsul este în stare QUEUED.

Multiplicatorul de preț este comercial. Cota TVA are un câmp separat, iar această formulă nu efectuează o conversie explicită între preț net și brut. Reducerile dinamice afișate în magazin trebuie corelate cu regula de preț a integrării.

Actualizarea are o intrare proprie.

Coada păstrează valorile pregătite, referința produsului și starea procesării. După transmitere, identificatorul de batch permite urmărirea rezultatului API.

Snapshotul din coadă păstrează valorile calculate la pregătirea operațiunii. Activarea procesării automate și permisiunea LIVE rămân controale distincte.

Coada de stoc și preț arată SKU, EAN, stări superseded și pending, zero încercări și câmpuri Batch necompletate în primele rânduri. — **Coada locală pentru stoc și preț**Înregistrările pending și superseded documentează coada locală de actualizări. Aceste linii nu confirmă trimiterea sau aplicarea unui stoc în Trendyol.

Evenimentul explică de unde a pornit operațiunea.

Jurnalul capturat arată evenimente stock_change care pun stocul și prețul în coada Trendyol. Referința produsului și momentul sunt păstrate împreună.

Valoarea HTTP 0 din aceste rânduri însoțește înregistrarea locală în coadă. Rezultatul unei transmiteri către API se urmărește în etapa de procesare.

Jurnalul inventory conține evenimente info cu mesajul Stoc/preț pus în coada Trendyol: stock_change și valoarea HTTP zero. — **Jurnalul introducerii în coadă**Evenimentele confirmă introducerea actualizărilor în coadă. HTTP 0 din aceste rânduri nu reprezintă un răspuns de succes al API-ului Trendyol.

Gestiunea rămâne sursa din amonte.Regulile de alimentare ERP → WooCommerce și multiplicatorii Trendyol au roluri separate în circuitul stocurilor și prețurilor.

Integrarea ERP–WooCommerce

05 / Import comenzi Trendyol în WooCommerce

Comanda păstrează legăturile.
Pachetele rămân identificabile.

Numărul comenzii Trendyol este asociat unei comenzi WooCommerce, iar identificatorii pachetelor și liniilor susțin urmărirea importului. Recitirea aceleiași comenzi folosește asocierea existentă.

Exemplul capturat arată o comandă WooCommerce corelată cu o comandă și un pachet Trendyol, în status Picking. Acțiunea de recuperare poate reciti o comandă după numărul extern.

Panoul de comenzi arată controale de import și recuperare după orderNumber, plus o asociere Trendyol–WooCommerce–pachet cu status Picking. Identificatorii celor trei evidențe sunt mascați. — **Comandă Trendyol asociată cu WooCommerce**Rândul documentează asocierea unei comenzi cu WooCommerce și statusul Picking din captură. Nu este o confirmare de livrare sau închidere a comenzii.

Stoc după cantitatea activă

Importatorul urmărește cantitatea deja alocată pe linie și aplică diferența necesară. Cantitățile anulate sau UnSupplied eliberează alocarea; statusul Returned nu produce automat aceeași restocare.

Valori comerciale păstrate

Produsele sunt identificate prin SKU și mapările existente, cu EAN exact drept fallback. Importul separă valoarea produsului, TVA-ul și SGR-ul și păstrează datele de facturare și livrare disponibile.

Verificarea precedă exportul în ERP.Importurile incomplete și diferențele de reconciliere de cel puțin 0,02 RON pentru un pachet activ blochează trimiterea în Supplier. Comanda rămâne vizibilă în WooCommerce, pentru corectare și reluare.

01 / IMPORT MARKETPLACE

Trendyol → WooCommerce

Referințe, produse, cantități și date comerciale reunite în comanda locală.

02 / VERIFICARE ȘI TRIMITERE

WooCommerce → Supplier

Operatorul verifică datele și trimite manual comanda în circuitul ERP existent.

Explorează integrarea ERP: comenzi și facturi

06 / Facturi Supplier pentru comenzile Trendyol

Factura are o comandă.
Uploadul are propria stare.

În legătura implementată cu importatorul IMAP, factura Supplier asociată comenzii poate alimenta coada Trendyol pentru pachetele eligibile. Asocierea documentului și procesarea uploadului sunt etape separate.

Coada capturată conține o factură în status pending, cu zero încercări. Ea documentează pregătirea documentului pentru procesare; confirmarea încărcării se urmărește ulterior în același registru.

După acceptarea documentului, avansarea statusului pachetului spre Invoiced are propriul rezultat. Importul PDF-ului, uploadul în marketplace și comunicarea către client rămân verificări distincte.

Coada de facturi Trendyol are o înregistrare pending, zero încercări și coloana Upload necompletată. Identificatorii comenzii WooCommerce, pachetului și facturii sunt mascați. — **Factura ERP în așteptarea procesării**Factura este înregistrată în coada integrării, cu status pending și zero încercări. Captura nu dovedește un upload reușit.

01 / DOCUMENT

Factura emisă în gestiune

ERP-ul Supplier emite documentul pentru comanda verificată și transmisă de operator.

02 / ASOCIERE

PDF-ul revine în WooCommerce

Importatorul de facturi identifică comanda, iar puntea dedicată poate pregăti pachetele Trendyol eligibile.

03 / PROCESARE

Upload urmărit separat

Coada păstrează starea, încercările, eventualele erori și momentul încărcării documentului.

Capturile prezintă configurații și rezultate ale implementării API custom DAGMAR, la momentul documentării.

Trendyol API / Întrebări despre integrare

Catalog și operațiuni.
Cu reguli explicite.

Ce include integrarea custom Trendyol cu WooCommerce?

Pregătirea catalogului pentru Product V2, categorii și branduri, validarea atributelor și imaginilor, cozi de publicare și actualizare stoc/preț, import de comenzi și legătura facturilor cu ERP-ul Supplier.

Un produs trimis prin API este deja disponibil la vânzare?

Pregătirea locală, procesarea lotului, aprobarea produsului și disponibilitatea magazinului sunt etape distincte. În portalul capturat, cele 118 produse sunt în verificare, numărul produselor active este zero, iar magazinul este în vacanță.

Cum este calculat prețul pentru Trendyol?

Integrarea folosește prețul obișnuit WooCommerce, iar dacă acesta lipsește folosește prețul activ. Aplică multiplicatorul comercial și rotunjește la două zecimale. TVA-ul are configurare separată, iar reducerile dinamice ale magazinului necesită corelare cu această regulă.

Cum sunt tratate comenzile și pachetele?

Numărul extern identifică asocierea cu WooCommerce, iar pachetele și liniile sunt urmărite separat. Cantitățile active determină diferențele de stoc. Anulările și UnSupplied pot elibera alocarea; Returned nu produce automat restocarea în această implementare.

Comenzile sunt trimise automat în ERP?

În circuitul documentat, operatorul verifică și trimite manual comanda în Supplier. Datele incomplete și diferențele comerciale care ating sau depășesc pragul de reconciliere trebuie rezolvate înainte de export.

Factura în așteptare este deja încărcată în Trendyol?

Statusul pending indică o intrare pregătită în coadă. Confirmarea uploadului, momentul procesării și rezultatul schimbării statusului pachetului se verifică separat.

Poate fi adaptată integrarea pentru alt magazin sau ERP?

Implementarea prezentată este construită pentru regulile DAGMAR. Adaptarea pornește din structura catalogului, identificatorii, fiscalitatea, cerințele categoriei și interfața aplicației de gestiune folosite.

Integrări în același ecosistem

Marketplace-uri și gestiune. Fluxuri corelate.

Explorează implementarea eMAG și circuitul comenzilor și facturilor din ERP.

Integrare eMAG WooCommerce ERP: comenzi și facturi

Pregătește integrarea Trendyol API cu WooCommerce și aplicația ta de gestiune.

Solicită integrarea Trendyol

SEO, strategie și reputație

Branding, web design și conformitate

Soluții tehnice și e-commerce

Ads, retenție și analytics

PROIECTE

IMPLEMENTĂRINOUTĂȚI

Despre Proces și echipă

Cum colaborăm

Oameni și responsabilitate

Integrare Trendyol API cu WooCommerce.
Catalog pregătit. Fluxuri controlate.