Dolibarr ERP + WooCommerce: integrare personalizata pentru e-commerce romanesc

Ce este Dolibarr ERP?

Dolibarr ERP & CRM este o platforma moderna de management al afacerilor, open-source, construita in PHP. Folosita de milioane de companii la nivel mondial, ofera o suita modulara de instrumente pentru gestionarea contactelor, ofertelor, facturilor, comenzilor, stocurilor, proiectelor, HR, contabilitatii si multe altele. Spre deosebire de sistemele ERP monolitice precum SAP sau Oracle, Dolibarr permite companiilor sa activeze doar modulele de care au nevoie, facandu-l usor, scalabil si ideal pentru intreprinderile mici si medii care necesita functionalitate de nivel enterprise fara complexitatea sau costurile de licentiere.

Dolibarr suporta baze de date MySQL, MariaDB si PostgreSQL si ruleaza pe orice stack standard LAMP/WAMP/LEMP. Arhitectura modulara, comunitatea open-source activa (20+ ani de dezvoltare) si extensibilitatea prin module personalizate si hook-uri il fac o alternativa solida la solutii proprietare precum SAP Business One, Odoo sau QuickBooks Enterprise. Pentru companiile care au nevoie de personalizare profunda fara vendor lock-in, Dolibarr in 2026 ramane una dintre cele mai puternice optiuni in spatiul ERP open-source.

Dolibarr: puncte forte si limitari

Provocarea

Clientul opera un magazin WooCommerce in crestere in domeniul home & decor, dar gestiona toate operatiunile de back-office manual. Facturile erau create de mana. Stocul era tinut in foi de calcul. Datele erau introduse de doua ori, o data in WooCommerce si o data in sistemul contabil. Pe masura ce volumul de comenzi a crescut, aceasta abordare a atins un plafon.

• Lipsa unui ERP centralizat. Comenzile, facturile si stocurile existau in sisteme deconectate fara o singura sursa de adevar.
• Cerinte de conformitate romanesti. Facturile si documentele de afaceri aveau nevoie de suport pentru limba romana, formatare in RON si termeni de livrare conform legii locale.
• Izolarea datelor WooCommerce. Catalogul de produse, datele clientilor si istoricul comenzilor erau blocate in WooCommerce fara modalitate de a alimenta oferte, facturi sau gestionarea stocurilor.
• Inconsistente de preturi. Preturile cu TVA inclus (TTC) din WooCommerce erau in conflict cu conventiile de preturi fara TVA (HT) din contabilitatea ERP, cauzand erori de calcul.
• Calitatea documentelor PDF. Documentele de afaceri generate automat trebuiau sa arate profesional, sa se afiseze corect in romana si sa includa branding-ul companiei.
• Scalabilitate. Solutia trebuia sa gestioneze cataloage de produse in crestere, volume crescute de comenzi si potentiala expansiune multi-canal.

Faza 1: selectia si implementarea ERP

Dupa evaluarea Odoo, ERPNext si Dolibarr, am selectat Dolibarr pentru acest proiect. Factorii decisivi: zero costuri de licentiere sub GPL, o arhitectura modulara care permite clientului sa activeze doar functionalitatea necesara (CRM, facturare, comenzi, stocuri, oferte), un stack nativ PHP care se potriveste cu infrastructura existenta WooCommerce/WordPress si un sistem robust de hook-uri si trigger-e pentru integrari personalizate.

Am implementat Dolibarr pe infrastructura de hosting a clientului cu MariaDB, am configurat HTTPS, protectie CSRF si controale de acces corespunzatoare din prima zi. ERP-ul era functional in productie in 48 de ore de la implementarea initiala.

Faza 2: localizare romaneasca si 120+ personalizari

Dolibarr suporta limba romana din start. Dar utilizarea reala in afacerile romanesti a necesitat o munca mult mai profunda. Pe parcursul acestui proiect, am implementat peste 120 de personalizari individuale, patch-uri si corectii de bug-uri in ERP, stratul de integrare si sistemul de generare documente.

Generare documente (template-uri PDF personalizate)

• Am construit template-uri PDF personalizate pentru oferte, comenzi, facturi si documente de livrare
• Am adaugat anteturi "Valori in moneda RON" pe toate tipurile de documente
• Am implementat o functie removeDiacritics() pentru gestionarea caracterelor romanesti (ă, â, î, ș, ț) care cauzau probleme de randare in fonturile PDF
• Am centrat anteturile coloanelor de descriere si am schimbat alinierea textului de la justified la left-aligned pentru o lizibilitate mai buna
• Am adaugat URL-uri clickabile ale site-ului cu formatare corecta in anteturile si subsolurile documentelor

Personalizare logica de afaceri

• Am inlocuit optiunile implicite in engleza de disponibilitate livrare cu termeni romanesti (Imediat, 24/48h, 3-5 zile, 7-10 zile)
• Am instalat si configurat modulul subtotal pentru a suporta anteturi de sectiune si subtotaluri in oferte, comenzi si facturi
• Am instalat modulul split pentru a permite managementul liniilor prin drag-and-drop in ofertele draft
• 5 module personalizate in total: ecommerceng, subtotal, split, abricot si customopt

Faza 3: integrarea WooCommerce

Aceasta a fost faza cea mai complexa si critica. Am implementat si configurat modulul eCommerceng (v4.1.69) pentru a crea o punte de sincronizare bidirectionala intre WooCommerce si Dolibarr.

Ce se sincronizeaza

• Produse - catalog, preturi, descrieri, variante, atribute, categorii
• Clienti - inregistrari terti, contacte, adrese
• Comenzi - comenzile WooCommerce creeaza automat comenzi Dolibarr
• Facturi - generate automat din comenzile sincronizate
• Niveluri de stoc - sincronizare inventar in timp real (directie configurabila)

Infrastructura tehnica

• Conexiune API autentificata OAuth1 la WooCommerce REST API
• Receptor webhook pentru procesarea evenimentelor in timp real (comanda plasata, produs actualizat, stoc modificat)
• 4 cron job-uri automate la fiecare 15 minute pentru procesarea webhook-urilor, monitorizarea starii si sincronizarea stocurilor
• 14 tabele personalizate de baza de date care mapeaza entitatile Dolibarr la ID-urile remote WooCommerce
• Mapare rate TVA si clase de taxa intre platforme
• Mapare gateway-uri de plata pentru fluxurile de stare a comenzilor

Faza 4: corectii critice de bug-uri si patch-uri de calcul pret

In timpul testarii integrarii, am descoperit si rezolvat mai multe bug-uri de pret care ar fi cauzat discrepante financiare. Nu erau probleme de configurare. Erau bug-uri in logica de calcul care necesitau patch-uri in clasele de baza.

Bug-ul de stocare pret unitar

Cand un produs cu discount era adaugat la o oferta, comanda sau factura, comportamentul implicit al Dolibarr stoca pretul unitar calculat (post-discount) in campul subprice. Dar procentajul de discount era stocat separat. Aceasta insemna ca "pretul unitar" afisat pe documente aparea mai mic decat cel intentionat, facand sa para ca afacerea percepe mai putin decat rata reala.

Solutia: Am patch-uit metodele addline() si updateline() in trei clase de baza (oferte, comenzi, facturi) pentru a stoca pretul unitar original inainte de discount, asigurand ca documentele afiseaza pretul corect cu discountul afisat separat.

Bug-ul de dubla taxare

WooCommerce foloseste preturi cu TVA inclus (TTC), dar motorul de documente al Dolibarr astepta preturi fara TVA (HT) ca baza. Cand produsele se sincronizau din WooCommerce, pretul TTC era tratat ca HT, iar TVA era aplicat din nou, umfland totalurile.

Solutia: Am implementat o corectie in stratul de sincronizare care forteaza price_base_type = 'HT' dupa importul produsului, asigurand ca pretul net este folosit ca baza de calcul.

Bug-ul de rotunjire a totalului comenzii

Aritmetica in virgula mobila cauza devieri ale totalurilor comenzilor fata de suma liniilor individuale cu fractiuni de ban. Suficient de mici pentru a fi invizibile pe linii individuale dar vizibile pe total. Pentru o afacere care genereaza facturi in RON, chiar si discrepante de 0,01 RON sunt inacceptabile.

Solutia: Am adaugat o verificare de consistenta care recalculeaza totalurile liniilor direct din subprice * qty cand nu este aplicat niciun discount, ocolind calculul intermediar care introducea erori de rotunjire.

Stiva tehnologica

Concluzii tehnice cheie

• Open-source nu inseamna zero efort. Dolibarr este puternic si gratuit, dar implementarea in productie pentru o piata specifica necesita personalizare profunda PHP, testare atenta si intelegerea atat a mecanismelor interne ale ERP-ului cat si a cerintelor locale de afaceri.
• Integrarea WooCommerce-ERP este o problema rezolvata, cu anumite conditii. Modulul eCommerceng ofera o sincronizare bidirectionala excelenta, dar diferentele de model fiscal intre platforme (TTC vs. HT) necesita corectii personalizate pe care niciun plugin gata facut nu le acopera.
• Calculele de pret sunt aparent simple dar complex de implementat. Cand doua sisteme aplica fiecare propria rotunjire, discounting si logica fiscala, discrepantele de sub-ban se acumuleaza. Fiecare cale de calcul trebuie auditata end-to-end.
• Generarea PDF pentru scripturi non-latine necesita atentie. Diacriticele romanesti au stricat randarea PDF in mai multe template-uri. A fost necesara o abordare sistematica (functie utilitara globala plus integrare per-template).
• Webhook-urile depasesc polling-ul pentru sincronizare in timp real. Arhitectura bazata pe webhook-uri proceseaza evenimentele WooCommerce in quasi-timp-real, mentinand datele de inventar si comenzi actuale fara a suprasolicita API-ul niciunei platforme.

Pentru cine este aceasta solutie?

Aceasta arhitectura este ideala pentru afaceri e-commerce care ruleaza WooCommerce si au nevoie de capabilitati ERP de back-office fara costuri de abonament SaaS. Companii din Romania sau Europa de Est care necesita facturare conforma legii locale, suport pentru moneda RON si documente in limba romana. Afaceri in crestere care au depasit stadiul foilor de calcul si proceselor manuale dar nu sunt pregatite pentru SAP sau Oracle. Si retaileri multi-canal care au nevoie de o singura sursa de adevar pentru inventar, clienti si documente financiare pe canale online si offline.