DAGMAR / Studiu de caz 09 / Integrare custom ERP

Integrare ERP WooCommerce.
De la comandă la factură.

Comenzile și clienții din magazin ajung în aplicația de gestiune. Factura emisă în ERP revine în WooCommerce, asociată comenzii. La DAGMAR, o integrare API custom conectează aceste etape cu Supplier, aplicația bazată pe Visual FoxPro.

Clienți PF / PJComenzi către ERPFacturi PDF în WooCommerce
Administrare · exemplu de configurarePanoul Supplier Factură din WooCommerce arată status FINALIZED, total WooCommerce 215,79 lei, data primirii, accesul la PDF și starea emailului client NETRIMIS. Numărul facturii este mascat.
Factura ERP atașată comenzii WooCommerceFactura PDF este asociată comenzii. În această captură, emailul către client este marcat NETRIMIS.
Factura este primită. Trimiterea emailului are propriul status.
01Identificare client și comandă
02Preluare în ERP și confirmare
03Factură și urmărirea documentului
01 / Integrare ERP cu magazinul online

Un circuit pentru date.
Un traseu pentru documente.

Integrarea cu ERP-ul custom leagă vânzarea online de operațiunile din gestiune: cine cumpără, ce produse sunt comandate, ce valori se facturează și unde se păstrează documentul final.

MAGAZIN ONLINE

WooCommerce

Client, comandă, produse, cantități, SGR, transport și totaluri.

Pregătește datele comerciale
GESTIUNE / ERP CUSTOM

Supplier / VFP

Identificarea clientului, preluarea în PAD și finalizarea facturii în aplicația de gestiune.

Confirmă importul și emite factura
DOCUMENTE ȘI CONTROL

WooCommerce

Factura asociată comenzii, statusuri de procesare și circuitul trimiterii către client.

Păstrează legătura cu vânzarea

Două sensuri ale aceleiași integrări ERP–eCommerce.Stocurile și prețurile vin din gestiune în catalog. Clienții și comenzile merg către ERP, iar documentele revin în magazin. Fiecare flux are propriile reguli, confirmări și jurnal.

Sincronizare stocuri și prețuri
Configurația reală a punții WooCommerce–ERP

Panoul administrativ documentează circuitul Supplier/VFP și opțiunile de automatizare. Capturile sunt decupate pentru a exclude cheia API și datele de contact.

Administrare · exemplu de configurarePanoul integrării ERP custom WooCommerce cu Supplier/VFP explică trecerea din coada comenzilor în PAD, confirmarea ACK și revenirea facturii PDF.
Integrare ERP WooCommerce: fluxul comenzilorFluxul implementat leagă WooCommerce de Supplier/VFP: pregătire, preluare, confirmare și factură.
Administrare · exemplu de configurareSetările integrării ERP WooCommerce: adăugarea automată în coadă este debifată, notificările sunt active, iar explicația facturii indică utilizarea emailului nativ Detalii comandă. Adresa de notificare este mascată.
Setări pentru comenzile ERP și notificăriÎn configurația capturată, Auto Sync este debifat. Notificările și mecanismul facturii către client au controale distincte.
02 / Date compatibile cu gestiunea

Persoană fizică sau firmă.
Identificare consecventă.

Integrarea pregătește datele clientului pentru schema ERP. Un identificator Supplier deja cunoscut poate fi reutilizat; pentru clienți noi, aplicația primește regulile de identificare și creare.

Exemplu PF / date anonimizate

Clientul este corelat cu comanda.

Pentru o persoană fizică fără identificator ERP cunoscut, instrucțiunile de identificare folosesc împreună numele, județul și localitatea. Un client existent este păstrat, iar unul care nu corespunde este creat în gestiune după regulile transmise.

Adresa și datele de contact sunt pregătite în structura cerută de aplicația Supplier. Datele originale din comanda WooCommerce sunt păstrate.

230,50 leiTotalul WooCommerce și totalul așteptat din previzualizarea PF.
Administrare · exemplu de configurarePrevizualizarea calculată a unei comenzi PF pentru ERP: două Sarti Rosa Aperitivo, SGR de 1,00 RON, transport net de 19,57 RON și total WooCommerce de 230,50 RON. Datele clientului sunt mascate.
Previzualizare ERP pentru client PFExemplul PF separă produsul, garanția SGR și transportul înaintea trimiterii în ERP.
Exemplu PJ / date anonimizate

Firma are identificatori proprii.

Fluxul pentru persoană juridică folosește datele de facturare ale firmei, inclusiv identificarea prin CUI atunci când este necesară asocierea. Identificatorul ERP confirmat poate fi reutilizat la comenzile următoare.

Normalizarea numelui și a identificatorilor este aplicată datelor exportate pentru compatibilitatea cu gestiunea.

390,49 leiTotalul WooCommerce și totalul așteptat din previzualizarea PJ.
Administrare · exemplu de configurarePrevizualizarea unei comenzi PJ pentru ERP: Bostavan Daos Alb Brut SKU 28350, cantitate 19, produse nete 279,87 RON, transport net 35,00 RON, SGR 9,50 RON și total 390,49 RON. Identitatea firmei este mascată.
Previzualizare ERP pentru client PJExemplul PJ transferă 19 unități, plus liniile separate pentru transport și SGR; totalul așteptat este 390,49 RON.

Identificatorul ERP are prioritate.

După confirmare, Supplier Client ID leagă clientul de gestiune. O asociere exactă existentă evită reluarea identificării numai după datele text.

Adaptor pentru aplicația existentă.

Integrarea custom pregătește denumiri, județe, localități și câmpuri fiscale în formatul cerut de Supplier/VFP, fără să rescrie identitatea clientului din WooCommerce.

03 / Comanda devine document comercial

SKU-uri și cantități.
Valori pregătite pentru ERP.

Puntea custom exportă valorile efective ale comenzii. Produsele, garanția SGR și costurile logistice sunt transformate în liniile comerciale pe care aplicația de gestiune le poate prelua.

Previzualizarea permite verificarea SKU-ului, cantității, prețului net pe unitate, valorii nete și totalurilor înainte ca administratorul să trimită comanda.

Unități comerciale și pachete compuse
Administrare · exemplu de configurareLinie WooCommerce Bostavan Daos Alb Brut, SKU 28350, cu 19 unități fizice și metadatele comerciale 3 × BAX 6. Identificatorul campaniei este mascat.
BAX Virtual: cantitatea fizică din comandăUnitățile comerciale BAX sunt păstrate în metadate, iar linia comenzii conține 19 unități fizice.
PRODUSE ȘI BAX

Unitatea corectă

În fluxurile configurate, cantitățile BAX sunt corelate cu unitățile și SKU-urile acceptate de Supplier.

PACHETE COMPOSITE

Componente facturabile

Rețeta salvată în comandă poate fi desfăcută pe SKU-uri. Addonul accesoriilor gratuite exclude componentele interne din exportul comercial.

SGR ȘI LOGISTICĂ

Linii distincte

Garanția și transportul urmează mapările dedicate din integrare, alături de valorile nete ale produselor.

Structura exportată și totalurile din previzualizare
Administrare · exemplu de configurareFragment JSON din previzualizarea integrării ERP WooCommerce: acțiune sync_client, sursă woocommerce, dry_run true, stare completed și tip client PF. Valorile personale și identificatorii sunt mascați.
Structura datelor ERP din previzualizareFragmentul arată structura previzualizării și dry_run true; nu este o confirmare a unei trimiteri LIVE.
Administrare · exemplu de configurareSumarul previzualizării ERP PF cu produse nete de 170,10 RON, transport net 19,57 RON, SGR 1,00 RON și total cu TVA 230,50 RON.
Total WooCommerce și total așteptat în ERPÎn această previzualizare, totalul WooCommerce și totalul așteptat al facturii sunt ambele 230,50 RON.
04 / Sincronizare comenzi cu ERP-ul custom

Pregătită. Preluată.
Confirmată. Documentată.

Coada decuplează magazinul de programarea aplicației de gestiune. Confirmarea preluării și factura finală sunt momente distincte, cu date care se pot urmări în WooCommerce.

Coada din WooCommerce

Comanda este verificată și pregătită.

Administratorul poate previzualiza și pune manual comanda în coadă. Auto Sync este o opțiune separată pentru statusurile prevăzute în integrare.

Coada reunește tipul clientului, statusul, preluările, identificatorul ERP și eventualele erori.

Administrare · exemplu de configurareCoada Supplier Clients pentru integrarea ERP WooCommerce arată tipuri PF și PJ, stări IMPORTED și CLAIMED și numărul preluărilor. Identitățile și identificatorii sunt mascați.
Coada comenzilor în integrarea ERPCoada face vizibile tipul clientului și stadiul preluării în ERP: CLAIMED și IMPORTED.
Programarea aplicației de gestiune

ERP-ul preia datele prin API.

Programarea externă Windows citește comenzile pregătite, identifică sau creează clientul în Supplier și importă comanda în PAD.

Jetonul cozii rămâne stabil până la confirmare, astfel încât reluarea citirii să păstreze legătura cu aceeași operațiune.

Administrare · exemplu de configurarePanoul Supplier Client Sync al unei comenzi WooCommerce arată tipul PF, statusul TRIMISĂ ÎN SUPPLIER / ÎN AȘTEPTARE FACTURARE, o preluare și data importului în PAD. Identificatorii sunt mascați.
Comandă importată în ERP, în așteptarea facturiiImportul în ERP și facturarea sunt etape distincte. Panoul arată preluarea și importul deja efectuate.
Confirmarea importului

Identificatorii revin în magazin.

Răspunsul de confirmare, ACK, poate întoarce Supplier Client ID și Supplier PAD ID. WooCommerce le păstrează pentru urmărirea comenzii și reutilizarea asocierii clientului.

Jurnalul consemnează operațiunile. Confirmarea importului în PAD este distinctă de finalizarea facturii.

Administrare · exemplu de configurareJurnalul integrării ERP custom WooCommerce arată evenimente queued, claimed și pad_import_ack, cu declanșatoare manual-bulk, windows-scheduler și supplier-ack. Datele de identificare sunt mascate.
Jurnalul ERP: coadă, preluare și ACKEvenimentele documentează parcursul queued → claimed → pad_import_ack; mesajele și statusurile rămân lizibile.
După verificarea în gestiune

Factura revine când este emisă.

Factura finalizată în ERP ajunge în WooCommerce prin interfața API sau prin circuitul de import din email. Documentul este legat de comanda identificată.

Jurnalul importurilor urmărește asocierea, sursa comenzii, rezultatul procesării și eventualele erori.

Administrare · exemplu de configurareJurnal cu facturi procesate pentru sursele emag și woocommerce, status Email success și eMAG uploaded sau not_applicable. Identificatorii facturilor și comenzilor sunt mascați.
Jurnalul importului de facturi ERPJurnalul confirmă procesarea emailurilor și încărcarea eMAG unde se aplică. Coloana Email descrie procesarea importului.

Taburile explică etapele integrării. Capturile sunt exemple istorice din administrare; această pagină de prezentare nu trimite comenzi și nu execută operațiuni în ERP.

05 / Import facturi ERP în WooCommerce

PDF-ul ajunge
la comanda potrivită.

Documentul emis în gestiune poate fi primit prin API sau preluat automat dintr-o căsuță email prin IMAP. Ambele căi folosesc mecanismul de asociere a facturii cu comanda.

Referința leagă emailul de comandă.

Circuitul de import verifică numărul facturii și referința comenzii din subiect, împreună cu identificatorul din corpul mesajului. Atașamentul trebuie să fie un singur PDF valid.

Numele fișierului PDF poate varia. Ceea ce contează pentru asociere este referința comercială verificată.

Administrare · exemplu de configurareEmail de intrare în fluxul facturilor ERP, cu subiect Factura, un fișier PDF atașat și câmpul order_id în corp. Identificatorii documentului și comenzii sunt mascați.
Factura ERP primită prin emailEmailul primit oferă documentul PDF și referința necesară asocierii cu comanda WooCommerce.

Importul și arhivarea sunt urmărite.

După procesarea completă, emailul este mutat în folderul de mesaje procesate. Reprimirea aceleiași facturi este tratată prin regulile de deduplicare.

Importatorul din email verifică documentele existente și semnalează conflictele, pentru a evita suprascrierea automată cu o altă factură.

Administrare · exemplu de configurareInterfața emailului arată folderul Facturi Procesate și mesaje cu facturi PDF. Numerele facturilor și comenzilor sunt mascate.
Arhiva emailurilor cu facturi procesateFolderul Facturi Procesate este vizibil în aceeași căsuță de email folosită pentru facturile ERP.
Activare, programare și diagnostic IMAP

Configurarea capturată prezintă activarea și starea scanărilor. Importatorul are o programare WordPress la cinci minute; execuția efectivă depinde de mecanismul cron al site-ului.

Administrare · exemplu de configurareSetările importului facturilor ERP: verificarea automată este activă, port IMAP 993, folder INBOX și atașarea automată a PDF-urilor eMAG. Datele de conectare sunt mascate.
Import automat IMAP pentru facturile ERPImportul IMAP este activat; configurarea separă conexiunea la email de asocierea facturilor cu comenzile.
Administrare · exemplu de configurarePanoul facturilor ERP arată scanarea fără cursor UID, ultima scanare automată, următoarea scanare WP-Cron și avertismentul DISABLE_WP_CRON. UID-ul informativ este mascat.
Scanare programată și diagnostic IMAPPanoul documentează programarea scanării și precizează dependența de cronul real când DISABLE_WP_CRON este activ.
Document real / date private mascate

Factura poate fi consultată din comandă.

WooCommerce păstrează referința facturii și accesul administrativ la PDF. Exemplul documentează factura primită pentru o comandă eMAG, alături de produsele și garanția aferente.

Documentul emis în ERP rămâne documentul comercial; previzualizarea din magazin oferă reperele pentru verificare.

Administrare · exemplu de configurareFactura 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 WooCommercePDF-ul aceluiași exemplu arată totalul 215,80 lei; panoul comenzii afișează total WooCommerce 215,79 lei.
Detaliul liniilor din documentul emis în ERP
Administrare · exemplu de configurareExtras anonimizat din factura ERP: două unități de vin, linia garanției SGR și totalul de plată 215,80 lei.
Linii comerciale, SGR și total în PDFFactura păstrează separat marfa și garanția SGR; extrasul prezintă totalul înscris în document.
06 / Totaluri, email și marketplace

Documentul și trimiterea.
Stări urmărite separat.

Recepția facturii, verificarea valorilor și expedierea emailului au responsabilități diferite. Interfața le prezintă separat, pentru ca operatorul să poată urmări fiecare etapă.

DOCUMENT PRIMIT

FINALIZED

Panoul din exemplu arată factura finalizată și accesul la PDF.

EMAIL CĂTRE CLIENT

NETRIMIS

Acesta este statusul vizibil în aceeași captură. Ea nu documentează trimiterea sau livrarea în inbox.

CONTROLUL VALORILOR

Totaluri verificabile

Previzualizarea și documentul emis oferă repere pentru confruntarea valorilor.

Comparația automată a totalurilor are o sursă precisă.API-ul poate primi totalul numeric al facturii și îl poate compara cu totalul WooCommerce. Importul IMAP asociază PDF-ul, fără să extragă suma contabilă din paginile documentului.

Același exemplu de factură și comandă, în capturile primite
ReperValoareCe documentează
Total WooCommerce215,79 leiValoarea afișată în panoul comenzii
Total din PDF215,80 leiValoarea documentului emis în ERP
Diferență observată0,01 leiComparație între capturi, nu un rezultat de parsare automată IMAP
Comenzi din mai multe canale

Referințele rămân corelate.

O comandă marketplace are identificatorul extern și comanda WooCommerce asociată. Exemplul eMAG completează traseul facturii și documentează contextul canalului de vânzare.

Pentru eMAG, importatorul de facturi include o etapă dedicată de atașare a documentului în marketplace. Celelalte canale folosesc adaptoarele și confirmările propriilor integrări.

Administrare · exemplu de configurareComandă eMAG finalizată, cu două unități de vin și două garanții SGR, plată card online și livrare locker. Identitatea, adresa și identificatorii sunt mascați.
Comanda marketplace corelată cu fluxul ERPExemplul eMAG păstrează produsele și SGR. Asocierea cu factura este documentată separat în jurnalul importului.
Sursele comenzilor și stările din jurnalul facturilor

Jurnalul păstrează sursa comenzii și rezultatul procesării. Prezența unui canal în listă documentează asocierea, iar confirmarea atașării documentului în acel canal se verifică separat.

Administrare · exemplu de configurareFragment din jurnalul facturilor ERP cu surse emag, trendyol și woocommerce; procesarea Email este success, iar eMAG este uploaded doar pe rândul aferent. Identificatorii sunt mascați.
Surse de comenzi în jurnalul facturilorAcelași jurnal reunește facturi asociate comenzilor WooCommerce, eMAG și Trendyol.
07 / Vizibilitate comercială în WooCommerce

Vânzări pe brand.
Cu filtre și export.

Raportul custom completează administrarea comenzilor prin selecții pe brand, categorii, perioadă și status. Indicatorii și tabelul produselor oferă o vedere asupra vânzărilor filtrate.

Valorile provin din comenzile WooCommerce. Raportul nu reprezintă o reconciliere contabilă automată cu baza de date a ERP-ului.

Administrare · exemplu de configurareRaportul WooCommerce Vânzări după brand și categorii are brand Purcari, includerea brandurilor copil, perioada 1–22 octombrie 2026 și controale pentru statusuri și export Excel.
Raport WooCommerce pe brand și categoriiFiltrele raportului permit selectarea brandului, categoriilor, perioadei și statusurilor comenzilor.
Administrare · exemplu de configurareSumar pentru Purcari și brandurile copil: 26 de comenzi, 237 produse nete vândute, 9.450,84 lei fără TVA, 1.984,68 lei TVA și 11.435,52 lei cu TVA.
Sumarul raportului comercial WooCommerceExemplul de raport pentru 1–22 octombrie 2026 arată 26 de comenzi și 237 de unități nete pentru selecția Purcari.
Administrare · exemplu de configurareTabelul produselor vândute pentru selecția Purcari arată SKU-uri, numărul comenzilor, cantitățile, valorile fără TVA, TVA și totalurile cu TVA.
Produse vândute: SKU, cantități și valoriRaportarea comercială detaliază rezultatul pe produs și SKU; valorile descriu perioada selectată, nu date LIVE.

Export pentru analiză în Excel.Acțiunea de export generează un fișier CSV. Raportul ține cont de cantitățile restituite și afișează separat totalurile pentru monede diferite.

Integrare ERP custom / Întrebări practice

De la aplicații separate.
La un flux conectat.

Ce presupune integrarea unui ERP custom cu WooCommerce?

Definirea datelor și a regulilor pentru fiecare direcție: stocuri și prețuri din gestiune, clienți și comenzi către ERP, confirmări și facturi către magazin. În proiectul DAGMAR, adaptorul conectează WooCommerce cu Supplier/VFP prin API și programarea externă a aplicației.

Comenzile sunt trimise automat sau manual în ERP?

Integrarea oferă trimitere manuală după previzualizare și o opțiune Auto Sync pentru statusurile configurate în cod. Comenzile marketplace pot urma fluxul manual dedicat. Starea activă se verifică în administrarea site-ului.

Confirmarea ACK înseamnă că factura a fost emisă?

ACK confirmă etapa preluării în gestiune și poate întoarce identificatorii clientului și ai comenzii PAD. Finalizarea facturii și primirea PDF-ului au loc ulterior.

Pot fi importate facturile ERP primite prin email?

Da, circuitul documentat citește mesajele prin IMAP, verifică referința comenzii și atașamentul PDF, asociază documentul și urmărește procesarea. Importul nu extrage automat totalul contabil din PDF.

Factura poate fi trimisă clientului din WooCommerce?

Codul integrează PDF-ul cu emailul nativ „Detalii comandă” și oferă trimitere sau retrimitere administrativă. Statusul este urmărit separat de primirea facturii. În exemplul vizual al studiului, emailul apare NETRIMIS.

Se aplică aceeași integrare oricărui ERP?

Arhitectura se poate adapta la alte aplicații, însă adaptorul, schema datelor și regulile de confirmare trebuie construite pentru interfața disponibilă în fiecare ERP. Studiul de față documentează implementarea custom Supplier/VFP pentru DAGMAR.

Integrarea catalogului completează circuitul

Stocuri, prețuri și comenzi. Aceeași gestiune.

Explorează ce se întâmplă înainte de vânzare: sincronizarea stocurilor și prețurilor ERP cu produsele WooCommerce.

Conectează gestiunea, comenzile și facturile printr-o integrare ERP custom.

Solicită o integrare ERP
KEPA
CENTRU DE PREFERINȚE
CONTROLUL RĂMÂNE LA TINE

Tu alegi ce permiți.

Cookie-urile necesare susțin funcționarea site-ului. Celelalte categorii sunt opționale și pornesc numai după acordul tău. Refuzul nu limitează accesul la serviciile și conținutul de bază KEPA.

Strict necesare

Mereu active

Permit memorarea alegerii tale și funcțiile esențiale, precum securitatea, autentificarea sau procesarea unei solicitări. Nu sunt folosite de acest plugin pentru publicitate.

Google Analytics 4 ne ajută să înțelegem ce pagini sunt vizitate și cum sunt folosite. Poate prelucra identificatori online și informații despre dispozitiv, pagini și interacțiuni. Nu pornim măsurarea înainte de acord.

Cu acordul tău, măsurăm și interacțiunile cu formularul de ofertă și clickurile către magazinele partenere. Nu transmitem în aceste evenimente numele, e-mailul, telefonul sau mesajul introdus.

Google Analytics 4 · încărcat prin Google Tag Manager

Integrarea KEPA nu activează Google Ads sau remarketing. Acceptarea statisticilor nu acordă permisiune pentru publicitate.

La retragerea acordului, pagina se poate reîncărca pentru a opri scripturile deja pornite. Salvează mai întâi informațiile introduse într-un formular.