DAGMAR / Studiu de caz 10 / Integrare API custom

Integrare eMAG cu WooCommerce.
Catalog, stocuri și comenzi conectate.

O integrare custom cu eMAG Marketplace leagă produsele WooCommerce de ofertele, stocurile și comenzile din marketplace. La DAGMAR, circuitul continuă către ERP-ul Supplier și întoarce factura la comanda potrivită.

Publicare și mapare catalogSincronizare stocuri și prețuriImport comenzi eMAG

Explorează integrarea Proiectul DAGMAR

Pagina publică eMAG pentru Marques de Riscal Reserva 2019, cod produs 28280, cu fotografie, preț 119,32 lei, garanție SGR 0,50 lei, disponibilitate și vânzător DAGMAR. Preferința de ridicare a sesiunii este mascată. — **Oferta DAGMAR pe eMAG**Exemplu public: produsul 28280 este vândut și livrat de DAGMAR, cu prețul și SGR afișate separat. Valorile descriu momentul capturii.

Oferta publică este verificată separat de validările catalogului.

01Produse și caracteristici mapate

02Stoc și preț sincronizate prin API

03Comenzi și documente corelate

01 / Integrare eMAG Marketplace prin API

Trei componente custom.
Responsabilități clare.

Publicarea unui produs, actualizarea ofertei și importul unei comenzi sunt operațiuni diferite. Implementarea DAGMAR le conectează prin SKU și identificatori de comandă, cu reguli, cozi și jurnale dedicate.

CATALOG MANAGER

Catalog pregătit pentru eMAG

Mapări de categorii și caracteristici, EAN, imagini, descriere și verificarea datelor înaintea publicării.

BIDIRECTIONAL SYNC

Ofertă și mișcări de stoc

Actualizări WooCommerce → eMAG și procesarea comenzilor eMAG care afectează stocul local.

EMAG ORDERS

Comanda în WooCommerce

Import după procesarea stocului, cu produse, SGR, transport și valori pregătite pentru circuitul ERP.

Magazinul și ERP-ul fac parte din același circuit.Supplier alimentează stocurile și prețurile WooCommerce. Integrarea eMAG sincronizează ofertele și aduce comenzile în magazin, de unde acestea pot fi preluate în gestiune.

Integrarea ERP–WooCommerce

Fluxul și starea catalogului în administrare

Captura arată 2.926 de categorii eMAG în cache și două mapări de categorii. Contorul „Publicate/verificate” este zero în acest panou; oferta publică prezentată în studiu este o ofertă existentă, documentată separat.

Panoul Catalog Manager explică fluxul WooCommerce către Catalog Manager, Product Offer eMAG și sincronizarea bidirecțională a stocului și prețului. — **Din catalogul WooCommerce în oferta eMAG**Crearea produsului și actualizarea ulterioară a ofertei au roluri separate în integrarea custom WooCommerce–eMAG.

Status Catalog Manager: credentiale disponibile, 2.926 de categorii eMAG în cache, două mapări WooCommerce către eMAG, zero intrări în coadă și zero publicate/verificate. — **Starea catalogului și a mapărilor**Captura arată 2.926 de categorii în cache și două mapări; contorul publicate/verificate este zero în acest panou.

02 / Publicare produse WooCommerce în eMAG

Categoriile se leagă.
Caracteristicile se verifică.

Categoria WooCommerce este asociată unei categorii eMAG, iar caracteristicile pot porni din atributele magazinului, brand, EAN sau valori fixe. Datele obligatorii sunt verificate înainte de transmitere.

Catalogul se încarcă după selectarea categoriei sau brandului. EAN și concentrația alcoolică au câmpuri de administrare, iar variațiile BAX sunt excluse din acest flux de publicare.

Interfața mapării categoriilor arată două asocieri existente: Exclusiv Dagmar cu Vinuri 4011 și Spumante EXCLUSIV cu Șampanie și vin spumant 3987. — **Maparea categoriilor WooCommerce către eMAG**Mapările existente leagă selecțiile comerciale WooCommerce de categoriile eMAG și oferă acces la configurarea caracteristicilor.

Selecție documentată / șase produse unitare

Fiecare produs are o stare explicabilă.

Exemplul din administrare arată patru produse identificate ca existente în eMAG și două blocate la verificare. Contorul READY este zero în selecția capturată.

Selecție Catalog Manager pentru categoria Exclusiv Dagmar și brandul Marques de Riscal: șase produse unitare, READY 0, BLOCKED 2 și EXISTS eMAG 4. — **Selecția catalogului după categorie și brand**Catalogul se încarcă pentru categoria și brandul selectate. Exemplul conține șase produse unitare, cu stări diferențiate.

Administrare · exemplu de configurare

Oferte existente: SKU, EAN, caracteristici și prețPatru linii sunt marcate EXISTS. Tabelul documentează datele locale folosite în integrare, fără să reprezinte o nouă publicare demonstrată.

Un exemplu real de control

O valoare neacceptată este semnalată.

Previzualizarea produsului Baron, SKU 26669, indică o valoare a atributului „Tip” care nu se regăsește în lista permisă. Raportul arată ce trebuie corectat înaintea unei noi trimiteri.

Existența unei oferte în marketplace și validarea datelor pentru publicare sunt verificări distincte. Un produs existent poate avea nevoie de corectarea mapării locale.

Două produse din selecție sunt BLOCKED deoarece valoarea Vin pentru câmpul Tip nu există în lista permisă eMAG. Sunt vizibile SKU-urile, EAN-urile și celelalte date. — **Validare înainte de publicarea în eMAG**Cele două linii sunt oprite de validarea locală a valorii Tip; pagina prezintă cazul real, fără a-l considera rezolvat.

Previzualizarea locală pentru Baron de Chirel 2017, SKU 26669, arată mesajul Blocat: Tip, valoarea Vin nu există în lista permisă eMAG. — **Previzualizare locală cu motivul blocării**Previzualizarea locală verifică eligibilitatea datelor înaintea publicării. Mesajul din această captură este o blocare de validare.

Previzualizare tehnică

Valoarea WooCommerce și valoarea trimisă.

Tabelul caracteristicilor explică sursa, obligativitatea și rezultatul mapării. Previzualizarea datelor API reunește titlul, descrierea, imaginile, stocul și valorile comerciale pregătite pentru eMAG.

Tabel de previzualizare cu ID-uri de caracteristici eMAG, surse WooCommerce, valori, obligativitate și statusuri. Tip are INVALID_VALUE, iar alte câmpuri sunt OK sau EMPTY_OPTIONAL. — **Caracteristicile și valorile pregătite pentru eMAG**Caracteristicile au surse și statusuri explicite. Vin este respins pentru Tip în acest exemplu local; celelalte valori se văd separat.

Fragment al payloadului local pentru SKU 26669: category_id 4011, vendor_category_id 1887, limba ro_RO, denumire, part_number și începutul descrierii cu imaginea DAGMAR. — **Payload pregătit pentru oferta eMAG**Payloadul arată datele pregătite de integrare. Captura reprezintă previzualizarea locală, nu un răspuns de acceptare API.

Parametrii de publicare ai catalogului

Setările includ bannerul descrierii, identificatorii cotelor TVA, termenul de pregătire, garanția și limita imaginilor. Credențialele și multiplicatorul comercial sunt reutilizate din componenta de sincronizare.

Setări Catalog Manager: imagine înaintea descrierii, VAT ID 9 pentru 21% și 10 pentru 11%, handling time două zile, warranty zero luni, maximum șase imagini și interval worker opt secunde. — **Setări pentru catalogul WooCommerce–eMAG**Setările separă identitatea vizuală, câmpurile comerciale și ritmul procesării; valorile sunt cele afișate în configurarea primită.

03 / Rezultatul public din marketplace

Oferta are un vânzător.
Produsul are propriul context.

Captura publică pentru Marqués de Riscal Reserva 2019 arată oferta vândută de DAGMAR, prețul și disponibilitatea din momentul documentării. Descrierea și caracteristicile completează informația comercială.

Specificații publice eMAG pentru Marques de Riscal Reserva 2019: tip Sec, țară Spania, soiuri Tempranillo și Graciano, regiune Rioja, cantitate 0,75 l, ambalaj sticlă și culoare roșu. — **Specificațiile produsului publicat pe eMAG**Specificațiile produsului public sunt prezentate pe câmpuri, alături de brandul Marques de Riscal.

Fragment din descrierea publică eMAG pentru Marques de Riscal Reserva 2019 de 0,75 l, cu titlu și text editorial despre produs. — **Conținut editorial pe pagina eMAG**Pagina eMAG include și conținut editorial. Acest exemplu public este distinct de previzualizarea locală a altui produs.

Validarea locală și afișarea publică au repere diferite.READY indică pregătirea locală. Răspunsul API și recitirea ofertei verifică etapele de transmitere. Pagina publică documentează oferta vizibilă cumpărătorului și vânzătorul selectat.

04 / Sincronizare stocuri și prețuri eMAG

Oferta se actualizează.
Stocul urmează comenzile.

Sincronizarea outbound trimite stocul și prețul din WooCommerce. Fluxul inbound citește comenzile eMAG și ajustează cantitățile locale după alocarea deja înregistrată.

Preț net folosit de integrareMultiplicator comercial eMAGPreț net transmis prin API

Preț și TVA / roluri separate

Multiplicatorul este o regulă comercială.

Catalogul și sincronizarea generală folosesc prețul activ salvat în WooCommerce. Puntea explicită Supplier pornește din prețul net primit din gestiune.

Multiplicatorul eMAG se aplică valorii nete; TVA-ul este tratat separat prin configurarea ofertei. Reducerile dinamice din magazin au propriul mecanism și trebuie corelate distinct.

Limitele min/max trimise împreună cu prețul sunt repere de protecție: 50% și 100% din valoarea transmisă.

DAGMAR eMAG Bidirectional Sync explică folosirea SKU-ului WooCommerce ca ID de ofertă eMAG și formula preț WooCommerce fără TVA înmulțit cu multiplicatorul. — **SKU-ul și formula de preț în sincronizarea eMAG**WooCommerce este reperul pentru SKU, stoc și preț. Formula transmisă către eMAG folosește valoarea fără TVA și multiplicatorul configurat.

Actualizările merg prin coadă.

Modificările eligibile sunt puse în coada ofertelor eMAG. Stocul este recitit din WooCommerce înainte de transmitere, iar rezultatul API este păstrat în jurnal.

Sincronizarea completă este construită în jurul ofertelor existente în eMAG. Cazurile în care oferta nu mai este găsită sunt semnalate și pot fi oprite din reîncercarea repetată.

Coada WooCommerce către eMAG arată zero produse în coadă, 57 de oferte cunoscute în index și opțiunile sincronizării complete pentru stoc și preț. — **Coada de actualizări pentru ofertele existente**Panoul indică 57 de oferte cunoscute și descrie includerea SKU-urilor comune WooCommerce–eMAG în actualizarea completă.

Comanda modifică alocarea o singură dată.

Componenta de stoc urmărește cantitatea deja alocată pe linia comenzii și aplică diferența necesară. Recitirea aceleiași comenzi nu produce încă o scădere identică.

Confirmarea eMAG și prelucrarea stocului au stări în jurnal. Restocarea la anulare și la retur sunt controlate prin opțiuni separate.

Jurnal de comenzi eMAG cu data, status numeric, completitudine, tip, acknowledged și sursă poll. Identificatorii comenzilor sunt mascați. — **Comenzi eMAG și confirmări ACK**Rândurile afișate documentează citirea periodică și confirmarea comenzilor; ACK este vizibil într-o coloană separată.

Actualizare reală / HTTP 200

Rezultatul poate fi urmărit pe SKU.

Jurnalul capturat include actualizări reușite de stoc. Sursa, SKU-ul, valoarea transmisă și rezultatul sunt vizibile împreună.

Două evenimente de jurnal pentru SKU 28148: stoc eMAG 221 actualizat cu succes HTTP 200 și ajustarea stocului WooCommerce cu minus o unitate. Referința comenzii este mascată. — **Actualizare reală de stoc după o comandă eMAG**Jurnalul arată două operațiuni distincte pentru SKU 28148: ajustarea stocului WooCommerce și actualizarea stocului eMAG.

Configurare, instrumente și diagnostic operațional

Capturile arată opțiunile sincronizării, instrumentele de verificare și rezultate care necesită interpretare: erori temporare sau oferte inexistente. O confirmare de primire a unei operațiuni este distinctă de finalizarea procesării.

Configurarea sincronizării eMAG arată warehouse 1, multiplicator de preț 1,21, sincronizarea automată a stocului și prețului, prelucrarea comenzilor și ACK active; restocarea pentru Returned este debifată. — **Stoc, preț, ACK și restocare configurabile**Opțiunile pentru sincronizare, confirmare și restocare sunt distincte. În captura primită, restocarea comenzilor Returned este inactivă.

Formulare pentru testarea conexiunii eMAG, citirea ofertei, actualizarea stocului și previzualizarea sau trimiterea prețului pentru un SKU. — **Controale de verificare și sincronizare manuală**Previzualizarea prețului are un control separat de trimitere. Captura arată formularele, fără un rezultat de calcul afișat.

Jurnalul sincronizării include erori HTTP 502 la citirea comenzilor, actualizări de stoc cu success HTTP 200 și linii skipped pentru oferte inexistente, chiar dacă răspunsul HTTP este 200. Referința comenzii este mascată. — **Jurnal de sincronizare: succes, erori și oferte lipsă**Statusul operațional completează codul HTTP: în aceste exemple există success, error și skipped, cu mesaje specifice.

05 / Import comenzi eMAG în WooCommerce

Întâi stocul.
Apoi comanda importată.

Două componente colaborează într-o ordine precisă. Stock Sync procesează stocul, apoi eMAG Orders creează comanda WooCommerce după confirmarea unei prelucrări reușite.

01 / STOCK SYNC

Procesează alocarea

Urmărește cantitățile eMAG și modifică stocul WooCommerce.

02 / EMAG ORDERS

Construiește comanda

Importă produsele și valorile, cu stocul deja gestionat de prima componentă.

Numărul extern rămâne asociat.

Lista corelează identificatorul eMAG cu ID-ul intern WooCommerce, totalul și livrarea. Importul este deduplicat după referința externă.

Comenzile folosesc statusul eMAG și păstrează datele necesare circuitului Supplier.

Lista comenzilor eMAG importate în WooCommerce arată date, totaluri, metode de livrare și stări Supplier imported. Identitățile, identificatorii și locațiile de livrare sunt mascate. — **Comenzi eMAG importate în WooCommerce**Lista reunește comenzile importate și starea preluării în ERP. Totalurile și datele operaționale rămân lizibile.

Fiecare etapă are un rezultat.

Jurnalul documentează importurile, mesajele de procesare și punerea emailului intern în coadă. Această ultimă stare confirmă pregătirea notificării, distinct de livrarea ei în inbox.

Operațiunile de recuperare reiau fluxul comun, cu verificarea comenzilor deja existente.

Jurnalul eMAG Orders arată comenzi create în WooCommerce, notificări interne puse în fluxul New Order, o recuperare queued și erori de recovery. Identificatorii și destinatarul sunt mascați. — **Import, notificare internă și recuperare**Evenimentele import și email sunt separate. Mesajul email confirmă introducerea în fluxul intern, nu livrarea unei facturi către client.

Starea integrării și opțiunile importului

Panoul eMAG Orders detectează sincronizarea bidirecțională, API-ul eMAG, Supplier Clients Sync și fluxul de email intern. Importul automat al comenzilor noi este activ. — **Importul eMAG în WooCommerce și legătura ERP**Importul comenzilor are un modul separat. Panoul precizează că mișcarea stocului rămâne responsabilitatea sincronizării bidirecționale.

Setările eMAG Orders arată importul automat în WooCommerce și emailul intern pentru comenzile eMAG, cu explicația fallbackului periodic. Adresa destinatarului este mascată. — **Setări pentru import și emailul intern**Importul automat și notificarea internă sunt activate. Aceasta este notificarea operațională New Order, distinctă de emailul facturii către client.

Importul comercial și modificările ulterioare au limite explicite.Modulul eMAG Orders păstrează valorile comerciale ale comenzii importate. La reîntâlnirea ei actualizează contextul de status, iar mișcările de stoc sunt urmărite de componenta dedicată.

06 / eMAG, WooCommerce și ERP custom

Valori comerciale.
Pregătite pentru facturare.

Comanda eMAG importată este transformată în datele acceptate de ERP-ul Supplier/VFP. Previzualizarea separă produsele, garanția SGR și transportul facturabil.

Voucherele de produs sunt absorbite în valorile produselor. SGR este preluat din datele comenzii eMAG și păstrat distinct. Totalul încasat de marketplace este un reper de diagnostic.

Integrare ERP: comenzi și facturi

Panoul unei comenzi eMAG în WooCommerce arată total facturabil 215,79 RON, încasare eMAG 230,76 RON, transport eMAG ignorat 12,99 RON și un avertisment de diferență de 0,01 lei pentru SKU 28280. Identificatorul și locația sunt mascate. — **Total facturabil, încasare și transport eMAG**Panoul separă totalul facturabil de încasarea eMAG și transportul ignorat. Avertismentul de un ban este informativ și nu blochează trimiterea.

Transportul și liniile comerciale din implementarea DAGMAR
Livrare	Tratament în WooCommerce / ERP
eMAG / EasyBox / FANbox	Informația de livrare este păstrată; transportul marketplace nu devine linie facturabilă DAGMAR.
Cargus	Transportul facturabil este separat în valoare netă și TVA, apoi mapat pe linia de transport Supplier.
Voucher	Ajustarea urmează liniile comerciale existente, fără a crea o linie separată de voucher în ERP.

Regulile comerciale prezentate în administrare

Regulile comerciale eMAG Orders explică voucherul absorbit în produse, preluarea SGR, diferența locker versus Cargus, evitarea unei a doua mișcări de stoc și trimiterea manuală în ERP. — **Reguli pentru voucher, SGR, livrare și ERP**Importul păstrează rolurile distincte ale produselor, SGR și livrării; eMAG Orders evită dublarea mișcării de stoc.

Factura emisă în gestiune

PDF-ul revine la comanda asociată.

După verificarea și trimiterea manuală în ERP, factura emisă poate fi importată în WooCommerce prin circuitul dedicat. Importatorul include și atașarea documentului pentru comenzile eMAG eligibile.

Exemplul de factură reutilizat din studiul ERP completează traseul documentului. Primirea PDF-ului, rezultatul atașării în marketplace și emailul către client au stări separate.

Factura PDF deschisă în comanda WooCommerce, cu liniile comerciale, garanția SGR și totalul de 215,80 lei. Identificatorii și datele de facturare sunt mascate. — **PDF-ul facturii ERP în WooCommerce**PDF-ul aceluiași exemplu arată totalul 215,80 lei; panoul comenzii afișează total WooCommerce 215,79 lei.

07 / Urmărirea operațiunilor

Datele circulă.
Rezultatele se verifică.

Integrarea custom eMAG oferă operatorului repere pentru catalog, sincronizare și documente. Fiecare etapă este evaluată prin starea care îi aparține.

CATALOG

Validare și ofertă

Mapările și caracteristicile se verifică local, transmiterea are răspuns API, iar oferta publică este verificată separat.

STOC ȘI COMENZI

Operațiuni corelate

Stocul are propriul registru de procesare. Comanda este importată numai după etapa reușită a componentei de stoc.

FACTURI

Stări distincte

Procesarea emailului de intrare, atașarea PDF-ului în eMAG și trimiterea emailului către client au confirmări separate.

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

Integrare eMAG WooCommerce / Întrebări practice

Catalog și operațiuni.
Într-un flux conectat.

Ce include integrarea custom eMAG cu WooCommerce?

Pregătirea și publicarea catalogului, mapări de categorii și caracteristici, actualizări de stoc și preț, procesarea comenzilor marketplace și importul lor în WooCommerce. Circuitul DAGMAR continuă cu ERP-ul Supplier și facturile PDF.

Poate integrarea publica produse noi în eMAG?

Componenta Catalog Manager are acest flux, cu verificare și coadă. Capturile studiului arată produse existente și validări locale, inclusiv blocaje care trebuie corectate înaintea unei trimiteri noi. Publicarea și vizibilitatea în marketplace au verificări distincte.

Este multiplicatorul eMAG același lucru cu TVA-ul?

Multiplicatorul comercial se aplică prețului net folosit de integrare. Oferta are separat configurarea TVA; prețul net transmis prin API și prețul brut public au roluri diferite.

Importul comenzii scade stocul încă o dată?

Stock Sync este responsabil pentru alocarea cantităților. eMAG Orders importă ulterior comanda WooCommerce, cu etapa stocului deja tratată de prima componentă.

Cum sunt tratate anulările și retururile?

Procesarea stocului urmărește diferențele de cantitate, iar restocarea anulărilor și a comenzilor Returned are opțiuni separate. Comportamentul activ trebuie corelat cu configurația și cu recepția fizică a mărfii.

Comenzile eMAG merg automat în ERP?

În circuitul documentat, operatorul verifică și trimite manual comanda în Supplier. Confirmarea preluării în ERP, emiterea facturii și întoarcerea PDF-ului sunt etape distincte.

Poate fi conectată integrarea eMAG la un alt ERP?

Legătura cu o altă aplicație de gestiune se construiește după interfața, identificatorii și regulile comerciale disponibile. Studiul de față documentează adaptorul custom Supplier/VFP folosit de DAGMAR.

Integrarea continuă în gestiune

Marketplace, magazin online și ERP. Date corelate.

Explorează alimentarea stocurilor din gestiune și circuitul comenzilor și facturilor.

ERP: stocuri și prețuri ERP: comenzi și facturi

Conectează WooCommerce cu eMAG Marketplace printr-o integrare API custom.

Solicită integrarea eMAG

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 eMAG cu WooCommerce.
Catalog, stocuri și comenzi conectate.