Integrare Business Central cu magazinul online: ghid practic

Pe scurt: ce face o integrare Business Central cu magazinul online?

O integrare Business Central cu magazinul online ține sincronizate WooCommerce (sau magazinul tău personalizat) și Microsoft Dynamics 365 Business Central: articolele, stocul și prețurile vin din ERP în magazin, comenzile și clienții noi merg înapoi în ERP, iar facturile și statusul livrării ajung în contul clientului. Nimeni nu mai reintroduce comenzi, iar site-ul nu mai vinde produse pe care depozitul nu le are.

Tehnic, integrarea folosește API-ul Business Central v2.0 (OData REST), uneori extins cu pagini API proprii. Partea grea nu e apelarea API-ului, ci decizia: ce sistem deține fiecare informație și cât de des circulă.

De ce contează conectarea ERP-ului cu magazinul?

Fără integrare, cineva exportă stocul în Excel, îl importă în WooCommerce și apoi copiază fiecare comandă într-o comandă de vânzare din Business Central. Merge la 20 de comenzi pe săptămână. La 50 de comenzi pe zi înseamnă întârzieri, stoc greșit și facturi care nu se potrivesc cu ce a plătit clientul.

Problemele apar de obicei în trei locuri:

• Vânzări peste stoc. Stocul din magazin e vechi de câteva ore, iar clientul cumpără produsul vândut dimineață în showroom.
• Prețuri diferite. Financiarul schimbă prețurile sau discounturile în Business Central, iar site-ul le afișează pe cele vechi.
• Introducere dublă. Comenzi, clienți și plăți tastate de două ori, cu greșeli la coduri de articol și la CUI.

În România mai e un motiv: factura emisă din Business Central ajunge în e-Factura prin localizarea partenerului tău. Dacă comanda intră greșit în ERP, greșeala ajunge până în SPV și se corectează doar prin storno.

Ce variante de integrare ai?

Variantă	Când e suficientă	La ce să fii atent
Conector de la terți (AppSource sau pluginuri WooCommerce)	Catalog standard, o singură firmă, prețuri simple	Mapare fixă; prețurile pe client, locațiile și variantele sunt adesea limitate
Platformă de integrare (iPaaS) sau Power Automate	Câteva fluxuri simple, volum mic	Conectorul Power Automate nu procesează notificările „collection” pentru modificări în masă
Integrare personalizată pe API v2.0	Mai multe locații, prețuri B2B, variante, magazine personalizate	Ai nevoie de o echipă care cunoaște și WooCommerce, și Business Central
Integrare personalizată plus pagini API proprii (extensie AL)	Date pe care API-ul standard nu le expune: linii din liste de preț, stoc pe locații	Extensia o publică un dezvoltator sau partener Business Central

Fii sincer cu tine: dacă ai un singur depozit, câteva sute de produse și fără prețuri pe client, un conector bun te servește bine. Integrarea personalizată se justifică atunci când regulile afacerii tale stau în Business Central și conectorul nu le vede.

Ce se sincronizează, în ce direcție și cât de des

Date	Direcție	Frecvență	În Business Central
Articole (denumire, cod, categorie, UM, EAN)	BC → magazin	La 15–60 min sau webhook pe items	items, itemCategories, unitsOfMeasure
Variante (mărime, culoare)	BC → magazin	Odată cu articolele	itemVariants
Stoc	BC → magazin	La 5–15 min, plus rezervare la comandă	Câmpul inventory din items; pe locații prin API sau query propriu
Prețuri de listă	BC → magazin	Orar sau noaptea	unitPrice din items
Prețuri și discounturi pe client (B2B)	BC → magazin	Noaptea și la modificare	Liste de preț, de obicei printr-o pagină API proprie
Clienți	Magazin → BC (noi), BC → magazin (conturi B2B)	La prima comandă / noaptea	customers
Comenzi	Magazin → BC	În maximum un minut de la plată	salesOrders și salesOrderLines
Plată și ramburs	Magazin → BC	Odată cu comanda sau la încasare	Metodă de plată pe comandă sau customerPaymentJournals
Livrări și AWB	BC → magazin	La 15–30 min	salesShipments
Facturi (status și PDF)	BC → magazin	La 15–60 min sau webhook pe salesInvoices	salesInvoices cu pdfDocument
Retururi și storno	BC → magazin	Zilnic	salesCreditMemos

Denumirile entităților și câmpurilor (de exemplu inventory, unitPrice și lastModifiedDateTime pe resursa items) sunt cele din documentația API v2.0. Două reguli fac tabelul să funcționeze. Fiecare informație are un singur proprietar. Iar integrarea salvează ID-ul din Business Central (câmpul GUID id) pe produsul, clientul și comanda din WooCommerce, ca actualizările să nu depindă de potrivirea denumirilor.

Pas cu pas: cum legi WooCommerce de Business Central

1. Autentificare corectă

Business Central online folosește OAuth 2.0 prin Microsoft Entra ID. Înregistrezi o aplicație în Entra, îi dai permisiunea pentru API-ul Business Central, apoi o adaugi în Business Central pe pagina Microsoft Entra Applications, doar cu seturile de permisiuni de care are nevoie. Cheile de acces pentru servicii web (autentificarea de bază) nu mai sunt acceptate în Business Central online, deci un plugin care îți cere utilizator și cheie e depășit.

Apelurile merg la https://api.businesscentral.dynamics.com/v2.0/{tenant}/{environment}/api/v2.0/companies({id})/.... Construiește și testează totul întâi într-un mediu sandbox.

2. Curăță datele din Business Central

Fiecare articol vândut online are nevoie de cod unic, unitate de măsură de vânzare, preț și ideal un EAN. Clienții au nevoie de grupă de înregistrare client, grupă de înregistrare TVA și cod de termen de plată. Lipsa acestor setări produce majoritatea erorilor la înregistrare.

Pentru clienții persoane juridice, verifică CUI-ul la ANAF înainte să creezi clientul în ERP. Pentru persoane fizice, decide dacă folosești un client generic „Web PF” sau câte un client pentru fiecare cumpărător; contabilul tău are de obicei o preferință clară.

3. Fluxul comenzii

Stabilește când trimiți comanda (după plată sau imediat, pentru ramburs și ordin de plată), pe ce client o pui și cum apar transportul și voucherele. Transportul e de obicei o linie de cont general sau de resursă; reducerile stau pe linia produsului, nu ca articol cu valoare negativă, altfel factura din e-Factura arată ciudat.

4. Respectă limitele API

Microsoft documentează limitele pentru Business Central online. Pe utilizator, limita e de 6.000 de cereri OData într-o fereastră glisantă de 5 minute, 5 cereri simultane, maximum 20.000 de entități pe pagină și 100 de operații într-un $batch. Peste limită primești 429 Too Many Requests, iar la cozi lungi 503. Folosește $batch, sincronizări incrementale cu $filter=lastModifiedDateTime gt ... și reîncercări cu pauză. Detaliile sunt în documentația Microsoft despre limite.

5. Webhook-uri, dar nu doar webhook-uri

Abonamentele webhook se creează cu POST la /api/v2.0/subscriptions, cer un handshake cu validationToken și expiră după trei zile dacă nu le reînnoiești cu PATCH. Dacă se modifică peste 1.000 de înregistrări în 30 de secunde, primești o singură notificare de tip collection. Lista entităților acceptate e în documentația webhook; stocul pe locații nu e în ea, așa că păstrează un job programat pentru stoc.

6. Erorile pe care le vei vedea

• The field No. of table Sales Line contains a value (...) that cannot be found in the related table (Item). Codul de articol de pe site nu există sau e blocat în Business Central.
• 429 Too Many Requests la sincronizarea completă a catalogului. Grupează cererile și încetinește.
• 412 Precondition Failed când actualizezi o înregistrare fără @odata.etag curent în antetul If-Match. Recitește și reîncearcă.
• 401 Unauthorized după ce expiră secretul aplicației din Entra. Notează-ți data de expirare.
• Erori de înregistrare pentru clienți noi fără grupă de înregistrare sau setare TVA. Repară șablonul de client, nu fiecare comandă.

Fiecare apel eșuat trebuie să apară pe comanda din WooCommerce, cu buton de retrimitere.

Checklist înainte de lansare

• Aplicația Entra înregistrată, permisiuni minime, data de expirare a secretului notată
• Toate testele făcute în sandbox
• Proprietar stabilit pentru fiecare câmp (articole, prețuri, stoc, clienți, comenzi)
• ID-ul Business Central salvat pe produse, clienți și comenzi
• Coduri, unități și prețuri complete pentru toate articolele online
• Șablon de client PF și PJ cu grupe de înregistrare și termen de plată
• CUI verificat la ANAF pentru clienții persoane juridice
• Transportul și reducerile mapate împreună cu contabilul
• Sincronizare incrementală pe lastModifiedDateTime, plus verificare completă noaptea
• Reîncercări cu pauză la 429 și 503
• Reînnoirea webhook-urilor programată înainte de cele trei zile
• Statusul livrării și factura vizibile în contul clientului
• Test de încărcare cu sincronizare completă înainte de Black Friday

Pentru partea de livrare, ghidul nostru despre generare AWB automat în WooCommerce arată cum circulă datele între magazin, curier și ERP.

Cât costă o integrare cu Business Central?

Ce include	Durată tipică	Cost estimat
Configurarea unui conector de la terți	1–2 săptămâni	Licența conectorului plus 1.000–3.000 € configurare
Sincronizare personalizată, în principal într-o direcție: articole, stoc și prețuri din BC, comenzi spre BC	4–8 săptămâni	5.000–12.000 € (aprox. 26.500–63.500 lei)1
Sincronizare bidirecțională completă: locații, prețuri B2B, facturi, livrări, retururi	2–4 luni	12.000–30.000 €+

Sunt estimări din proiecte tipice, nu listă de prețuri; timpul partenerului Business Central pentru pagini API proprii se adaugă. La Raao, integrarea ERP face parte din pachetul Enterprise sau se adaugă ca modul unui magazin existent, iar proiectele mari pornesc cu un workshop de analiză plătit, din care rezultă specificația și o ofertă fixă. Totul începe cu o discuție gratuită de 30 de minute, pe care o poți programa aici. Construim și aplicații CRM și operaționale peste Business Central; vezi pagina de software personalizat și hub-ul CRM și ERP făcut pentru un grup de retail.

Cum am făcut asta pentru magazinul partenerului Miele

Pentru magazinul partenerului Miele, Business Central e centrul operațiunii, nu doar destinația unui export:

• Integrare bidirecțională cu Business Central pentru produse, stoc pe locații, comenzi, facturi și livrări.
• Comenzile, facturile și reducerile de fidelitate trec prin Business Central, așa că magazinul și financiarul văd aceleași cifre.
• Estimări de livrare pentru produsele fără stoc prin Tradeplace, combinate cu stocul de pe mai multe locații.
• O singură platformă pentru vânzări online, în magazin și B2B, inclusiv un magazin B2B Miele Professional cu cereri de ofertă.

Rezultatul care contează pentru client: stoc și date de livrare corecte pentru fiecare cumpărător, iar comenzile și facturile ajung în ERP fără reintroducere manuală. Același principiu îl folosim la Kuiba, unde comenzile ajung automat în Business Central prin stratul CRM al clientului.