Integrare Curieri în WooCommerce: Ghid Complet pentru FAN Courier, Sameday, DPD și Cargus

Integrare curieri WooCommerce înseamnă un flow complet automatizat: clientul plasează comandă, AWB-ul se generează automat, link-ul de tracking ajunge pe email, iar tu nu atingi nimic manual. În acest ghid acoperim configurarea pas cu pas pentru FAN Courier, Sameday, DPD și Cargus — de la plugin oficial la integrare API custom, cu focus pe automatizare reală.

La 10 minute per AWB și 50 de comenzi zilnice, vorbim de peste 8 ore pierdute în fiecare zi — o persoană cu normă întreagă care nu face altceva decât să copieze adrese și să dea click pe "Generează". Soluția: integrare curieri WooCommerce completă, cu AWB automat la schimbarea statusului comenzii, calcul cost transport în timp real și notificări cu tracking către client.

De ce ai nevoie de integrare curieri în WooCommerce (nu doar un plugin)

Un plugin de shipping fără configurare corectă rezolvă doar jumătate din problemă. Diferența reală stă în aceste componente:

Calcul cost transport în checkout — clientul vede prețul exact înainte de plată, bazat pe greutate, dimensiuni și zona de livrare

Generare AWB automat — când comanda trece în status "Processing", AWB-ul se creează singur prin API-ul curierului

Tracking integrat — clientul primește email cu numărul AWB și link direct către pagina de tracking

Sincronizare status — când coletul e livrat, statusul comenzii se actualizează automat în WooCommerce

Easybox/locker — clientul alege punctul de livrare direct din checkout, pe hartă

Fără aceste componente, ai doar o metodă de shipping cu preț fix — ceea ce înseamnă ori că pierzi bani (prețul e prea mic), ori că pierzi clienți (prețul e prea mare).

FAN Courier WooCommerce — plugin oficial vs. API custom

FAN Courier se integrează în WooCommerce prin plugin-ul oficial (gratuit) sau prin API REST direct — alegerea depinde de volumul de comenzi și de nivelul de automatizare dorit.

Plugin oficial FAN Courier

Plugin-ul oficial (disponibil pe WordPress.org ca Fan Courier for WooCommerce) oferă:

Generare AWB din dashboard-ul WooCommerce (buton pe pagina comenzii)

Calcul cost transport prin API-ul FAN (endpoint-ul /estimate_cost)

Suport pentru servicii standard, colectare și retur

Print AWB în format PDF direct din admin

Configurare pas cu pas:

Instalează plugin-ul din WooCommerce > Plugins > Add New

Mergi la WooCommerce > Settings > Shipping > FAN Courier

Introdu credențialele API: client_id, username, password (le primești din contul FAN Courier > Integrări API)

Configurează serviciile de livrare (Standard, Express, colectare numerar)

Setează greutatea implicită per produs și dimensiunile pachetului default

Activează calculul automat de cost în Shipping Zones

Când mergi pe API custom

Plugin-ul oficial acoperă 80% din cazuri. Ai nevoie de integrare API custom când:

Vrei AWB automat la schimbarea statusului (plugin-ul oficial necesită click manual)

Ai nevoie de logică condițională (ex: FAN pentru București, alt curier pentru restul țării)

Integrezi cu un ERP/WMS care are nevoie de date din răspunsul API

Vrei să trimiți email-ul de tracking dintr-un template personalizat

FAN Courier expune un REST API documentat, cu endpoint-uri pentru /create_awb, /tracking, /delete_awb și /print. Autentificarea se face prin header cu Authorization: Bearer {token}.

Pro: Cel mai matur ecosistem de integrare din România, documentație bună, suport tehnic dedicat pentru parteneri cu volum.

Contra: Interfața adminului din plugin ar putea fi mai intuitivă; unele opțiuni avansate necesită cod custom.

Sameday WooCommerce — easybox și livrare la adresă

Sameday se integrează în WooCommerce prin plugin-ul oficial care acoperă atât livrare la adresă, cât și selecție easybox cu hartă interactivă direct în checkout.

Plugin-ul oficial Sameday

Plugin-ul Sameday Courier Shipping oferă:

Hartă interactivă în checkout pentru selectarea locker-ului easybox

Generare AWB automat sau manual din pagina comenzii

Calcul cost transport prin API (endpoint /api/client/pricing)

Suport pentru livrare la adresă, easybox și retur

Configurare:

Instalează plugin-ul și activează-l

Mergi la WooCommerce > Sameday > Settings

Introdu API Username și API Password (din contul Sameday > Integrări)

Selectează mediul: Testing pentru dezvoltare, Production pentru live

Configurează serviciile: Sameday 24h, Sameday 6h, Locker Next Day

În Shipping Zones, adaugă "Sameday" ca metodă și selectează serviciile dorite

Activează opțiunea "Show Locker Map" pentru a afișa harta în checkout

Easybox — configurare corectă

Componenta easybox necesită atenție specială. Plugin-ul injectează o hartă JavaScript în pagina de checkout unde clientul selectează locker-ul. Puncte critice:

Compatibilitate temă: Verifică că harta se afișează corect pe mobile (unele teme suprascriu stilurile)

Cache: Dacă folosești cache agresiv (LiteSpeed, WP Rocket), exclude pagina de checkout din cache

Checkout blocks: Dacă folosești noul checkout WooCommerce bazat pe blocks, verifică compatibilitatea — unele versiuni mai vechi ale plugin-ului suportă doar checkout-ul clasic

Pro: Easybox este un diferențiator real — reducere costuri livrare cu 20-30% față de livrare la adresă. Clienții îl preferă.

Contra: Harta de lockere poate încetini checkout-ul pe conexiuni slabe; necesită testare atentă pe mobile.

DPD WooCommerce — configurare și particularități

DPD România se integrează prin plugin-ul oficial care acoperă livrare standard, express și către puncte pickup — un avantaj clar pentru magazinele cu clienți din UE datorită rețelei internaționale.

Integrare DPD

Plugin-ul DPD Romania se configurează astfel:

Obține credențiale API din portalul DPD Romania (username, password, clientId)

Instalează plugin-ul și mergi la WooCommerce > Settings > Shipping > DPD

Introdu credențialele și selectează depozitul sursă

Configurează serviciile: DPD Classic, DPD Express, DPD Pickup

Setează reguli de preț: flat rate, bazat pe greutate sau gratis peste o anumită valoare

Particularități DPD

DPD Pickup — rețea de puncte de ridicare, similar cu easybox-ul Sameday; se afișează ca dropdown sau hartă în checkout

Asigurare colet — DPD permite setarea valorii declarate direct din AWB; plugin-ul preia valoarea comenzii automat

Colete multi-parcel — suportă comenzi care necesită mai multe colete, cu AWB-uri legate

Print label — generează etichete în format ZPL (pentru imprimante termice) sau PDF

Pro: Rețea internațională puternică dacă ai și clienți din UE. Pickup points în creștere.

Contra: Plugin mai puțin actualizat decât FAN sau Sameday; comunitate mai mică în România.

Cargus WooCommerce — plugin, API și costuri

Cargus (fost Urgent Cargus) oferă integrare WooCommerce prin plugin oficial și API REST, cu prețuri competitive pentru volume mari.

Plugin-ul Cargus

Plugin-ul Cargus WooCommerce oferă:

Generare AWB din pagina comenzii

Calcul cost transport în checkout

Print AWB în format PDF sau termic

Suport ramburs (cash on delivery)

Configurare:

Obține cheia API din portalul Cargus > Setări > API Key

Introdu API Key, username și password în setările plugin-ului

Configurează tipul de serviciu: Standard, Express, la punct de ridicare

Setează greutatea default și dimensiunile standard ale pachetelor

Costuri de integrare

Cargus nu percepe costuri suplimentare pentru utilizarea API-ului. Costurile reale sunt:

Plugin premium: Unele versiuni au funcționalitățile avansate (AWB automat, sync status) doar în versiunea pro (~50-100 EUR/an)

Timp configurare: 2-4 ore pentru setup de bază, 1-2 zile pentru integrare custom cu AWB automat

Mentenanță: Actualizări plugin la fiecare update WooCommerce major (de obicei 2-3 pe an)

Pro: Prețuri competitive pentru volume mari; API stabil și bine documentat.

Contra: Rețea de puncte pickup mai mică decât Sameday sau DPD.

Calcul automat cost transport — greutate, volum și zonă

Calculul corect al costului de transport în checkout determină direct rata de conversie: un preț prea mic îți mănâncă marja, un preț prea mare alungă clientul.

Cum funcționează calculul

Fiecare curier expune un endpoint de estimare preț care primește:

Greutate reală — suma greutăților produselor din coș (câmp _weight în WooCommerce)

Greutate volumetrică — calculată din dimensiuni: (L x l x h) / 6000 (în cm/kg)

Zona de livrare — determinată din codul poștal al destinatarului

Tip serviciu — standard, express, locker

Valoare ramburs — dacă plata e la livrare

Curierul returnează prețul calculat, pe care plugin-ul îl afișează în checkout.

Configurare corectă

Completează greutatea și dimensiunile la fiecare produs — fără aceste date, calculul e imposibil. Fă un audit și completează câmpurile Weight (kg), Length (cm), Width (cm), Height (cm)

Setează greutatea pachetului — adaugă 100-300g pentru ambalaj în setările plugin-ului

Configurează Shipping Zones — în WooCommerce > Settings > Shipping > Shipping Zones, creează zone pentru București, județe și, opțional, internațional

Testează cu adrese reale — plasează comenzi test către diferite zone și compară prețul din checkout cu cel din portalul curierului

Preț fix vs. preț calculat

Pentru magazine cu produse de dimensiuni similare (ex: haine, cosmetice), un preț fix per zonă poate fi mai simplu și la fel de eficient:

București: 15 RON

Restul țării: 20 RON

Gratis peste 200 RON

Pentru magazine cu produse variate (ex: mobilă + accesorii), prețul calculat în timp real este obligatoriu.

AWB automat în WooCommerce — generare la schimbare status

Generarea automată de AWB elimină cel mai mare bottleneck din procesarea comenzilor: în loc să deschizi fiecare comandă și să dai click pe "Generează AWB", sistemul face totul singur.

Cum implementezi AWB automat

Metoda standard: un hook WordPress care se declanșează la schimbarea statusului comenzii:

add_action('woocommerce_order_status_processing', 'generate_awb_automatically');

function generate_awb_automatically($order_id) {
$order = wc_get_order($order_id);
// Apel API curier pentru generare AWB
$awb_number = ''; // răspunsul API-ului curierului
// Salvare număr AWB în order meta (HPOS-compatible)
$order->update_meta_data('_awb_number', $awb_number);
$order->save();
}

Majoritatea plugin-urilor premium oferă această opțiune nativ — o activezi din setări fără cod custom.

Flow-ul complet automat

Clientul plasează comanda și plătește online

Statusul trece automat în Processing

Hook-ul se declanșează și apelează API-ul curierului

AWB-ul se generează și numărul se salvează în comandă

Email-ul de "Comandă în curs de livrare" se trimite cu link tracking

Când coletul e livrat, un cron job verifică statusul și marchează comanda ca Completed

Configurarea AWB automat cu API-uri de curier poate fi complexă — mai ales când gestionezi mai mulți curieri simultan. La Creative Side, integrăm curieri în WooCommerce cu generare automată AWB și tracking pentru zeci de magazine. Dacă preferi să te concentrezi pe vânzări, nu pe configurări tehnice, solicită o estimare.

Erori frecvente la AWB automat

Adresă incompletă — API-ul curierului returnează eroare dacă lipsește județul sau codul poștal. Soluție: fă câmpurile obligatorii în checkout

Greutate lipsă — produsele fără greutate completată blochează generarea. Soluție: setează greutate default în plugin (ex: 0.5 kg)

Limită API — unii curieri au rate limiting. Nu genera mai mult de 1 AWB/secundă. Soluție: adaugă un delay de 2 secunde între apeluri batch

Tracking integrat — notificări email cu link tracking

Tracking-ul integrat în WooCommerce trimite automat numărul AWB și link-ul de urmărire în email-ul de status update, fără ca clientul să fie nevoit să întrebe.

Implementare tracking în email-uri

Cele mai bune plugin-uri de curieri adaugă automat numărul AWB și link-ul de tracking în email-ul WooCommerce de status update. Dacă plugin-ul tău nu face asta, adaugi manual:

add_action('woocommerce_email_order_details', 'add_tracking_to_email', 20, 4);

function add_tracking_to_email($order, $sent_to_admin, $plain_text, $email) {
if ($email->id !== 'customer_completed_order') return;

$awb = $order->get_meta('_awb_number');
if ($awb) {
$tracking_url = 'https://www.fancourier.ro/awb-tracking/?awb=' . $awb;
echo '<h2>Tracking colet</h2>';
echo '<p>Numărul AWB: <strong>' . esc_html($awb) . '</strong></p>';
echo '<p><a href="' . esc_url($tracking_url) . '">Urmărește coletul</a></p>';
}
}

Link-uri tracking per curier

Fiecare curier are o pagină de tracking publică:

FAN Courier: https://www.fancourier.ro/awb-tracking/?awb={AWB}

Sameday: https://sameday.ro/#/awb/{AWB}

DPD: https://tracking.dpd.ro/?shipmentNumber={AWB}

Cargus: https://app.urgentcargus.ro/Private/Tracking.aspx?id={AWB}

În implementarea multi-curier, stochezi și numele curierului în order meta, apoi construiești link-ul corect dinamic.

Pagina My Account cu tracking

Pe lângă email, adaugă o secțiune de tracking în pagina "Contul meu" > "Comenzi". Clientul vede statusul ultimei comenzi și poate accesa link-ul de tracking oricând, fără să caute în email.

Multi-curier — cum gestionezi mai mulți curieri pe același magazin

Majoritatea magazinelor online din România folosesc 2-3 curieri simultan — FAN Courier pentru volum mare, Sameday pentru easybox, DPD pentru livrări internaționale. Iată cele trei strategii principale de gestionare.

Strategii multi-curier

1. Curier selectat de client în checkout:

Clientul alege între FAN, Sameday și DPD. Fiecare apare ca metodă de shipping separată, cu preț calculat în timp real. Este cea mai comună abordare.

2. Curier selectat automat pe bază de reguli:

Comandă sub 5 kg și locație urbană → Sameday easybox (cost minim)

Comandă peste 5 kg → FAN Courier standard

Destinație internațională → DPD

Implementezi cu un plugin de shipping rules sau cu cod custom pe hook-ul woocommerce_package_rates

3. Curier selectat manual de operator:

Pentru magazine cu volum mic (sub 20 comenzi/zi), operatorul alege curierul din admin. Nu e ideal, dar e simplu.

Gestionare tehnică

Când ai mai multe plugin-uri de curier active simultan:

Conflicte JavaScript — mai ales pe pagina de checkout, harta easybox și selectorul DPD Pickup pot intra în conflict. Testează fiecare combinație

Shipping Zones — configurează zonele corect ca să nu apară toți curierii în toate zonele

Order meta — standardizează key-urile: _shipping_courier (fan/sameday/dpd/cargus), _awb_number, _tracking_url

Performanță — fiecare plugin face apeluri API în checkout pentru calcul preț. Cu 3 curieri, ai 3 apeluri externe. Implementează cache pe rezultate (transient de 1 oră per cod poștal + greutate)

Această integrare multi-curier se leagă direct de automatizarea facturării cu SmartBill — odată ce AWB-ul e generat automat, factura se emite în același flow, fără intervenție manuală. Dacă ești în faza de creare magazin online WooCommerce, planifică integrarea curierilor de la început — este mult mai simplu decât să o adaugi ulterior.

Ce plugin unifică mai mulți curieri

Există și plugin-uri "umbrelă" care integrează mai mulți curieri într-o singură interfață:

Flavor (fost BookuriOnline Shipping) — suportă FAN, Sameday, Cargus, DPD dintr-un singur plugin

WP Desk Flexible Shipping — reguli avansate de preț, compatibil cu plugin-uri individuale de curier

Avantajul: o singură interfață de management AWB. Dezavantajul: dependency pe un plugin terț care trebuie să țină pasul cu API-urile tuturor curierilor.

Cum alegi curierul potrivit pentru magazinul tău

Alegerea depinde de profilul magazinului tău — nu există "cel mai bun curier", ci combinația potrivită:

Criteriu	FAN Courier	Sameday	DPD	Cargus
Acoperire națională	Excelentă	Foarte bună	Bună	Foarte bună
Easybox/lockere	Nu	Da (3.000+)	Da (pickup)	Limitat
Livrare internațională	Limitat	Nu	Excelentă	Limitat
Plugin WooCommerce	Matur	Matur	Mediu	Mediu
AWB automat (plugin)	Manual/custom	Da	Manual/custom	Manual/custom
Preț mediu colet (standard)	15-22 RON	14-20 RON	16-24 RON	14-21 RON

Pentru un magazin care vinde preponderent în România, combinația FAN Courier + Sameday easybox acoperă cel mai bine nevoile: FAN pentru livrare la adresă (volum, fiabilitate) și Sameday pentru lockere (cost redus, preferință clienți). Dacă ai și clienți din UE, adaugă DPD ca a treia opțiune.

Dacă vrei să înțelegi cum aceste integrări afectează performanța și conversiile magazinului tău WooCommerce, costul transportului și experiența de tracking sunt doi factori cu impact direct. Iar pentru o imagine de ansamblu asupra dezvoltării WordPress și WooCommerce, integrarea curierilor este una dintre piesele critice din puzzle-ul unui magazin funcțional.

FAQ — Integrare curieri WooCommerce

Cât durează o integrare curieri în WooCommerce?

Pentru un singur curier cu plugin oficial, configurarea de bază durează 2-4 ore. O integrare completă cu AWB automat, tracking în email-uri și calcul cost în timp real necesită 1-3 zile. Integrarea multi-curier cu reguli automate de selecție adaugă încă 2-3 zile de dezvoltare și testare.

Pot folosi mai mulți curieri simultan în WooCommerce?

Da. Instalezi plugin-ul fiecărui curier și configurezi Shipping Zones separate sau metode de shipping paralele. Clientul alege curierul în checkout. Alternativ, folosești un plugin umbrelă (Flavor, WP Desk) sau reguli automate care selectează curierul pe bază de greutate, zonă sau valoare comandă.

Ce fac dacă plugin-ul curierului nu suportă AWB automat?

Ai două opțiuni: (1) folosești un plugin premium care include această funcționalitate, sau (2) dezvolți un hook custom pe woocommerce_order_status_processing care apelează API-ul curierului și generează AWB-ul automat. A doua variantă necesită cunoștințe PHP și acces la documentația API a curierului.

Cum afișez opțiunea easybox în checkout-ul WooCommerce?

Plugin-ul oficial Sameday include o hartă interactivă care se injectează automat în checkout când clientul selectează serviciul de livrare la locker. Asigură-te că: (1) nu ai cache pe pagina de checkout, (2) tema nu suprascrie stilurile hărții, (3) folosești checkout-ul clasic WooCommerce sau verifici compatibilitatea cu checkout blocks.

Cât costă integrarea curierilor pentru un magazin WooCommerce?

Costul depinde de complexitate. Plugin oficial gratuit + configurare proprie: 0 RON (doar timp). Plugin premium cu AWB automat: 200-500 RON/an. Integrare profesională custom cu AWB automat, tracking, multi-curier și reguli automate: 2.000-5.000 RON, one-time. Mentenanță anuală: 500-1.000 RON pentru actualizări și compatibilitate cu noile versiuni WooCommerce.

---

Ai nevoie de integrare curieri profesională? Configurăm FAN Courier, Sameday, DPD sau Cargus cu AWB automat și tracking integrat — de la setup plugin la integrare API custom. Solicită o estimare și îți spunem exact ce presupune pentru magazinul tău.