Ce primesti
La confirmarea comenzii, POST hub.fancourier.ro/v2/awb cu username/password Auth genereaza AWB-ul si returneaza URL print pentru eticheta PDF. Pentru magazine cu volume mari, bulk endpoint genereaza pana la 100 AWB-uri intr-un singur request. Salvam PDF imediat in S3/R2 pentru ca link-ul are TTL 7 zile.
Polling /tracking_awb la fiecare 30 minute pentru toate AWB-urile active, update status comanda in ERP (preluat, in tranzit, livrat, returnat). Trimitem email plus SMS optional la fiecare schimbare status (Twilio sau plugin WooCommerce). Client vede status real-time si pe pagina de cont fara sa intre pe site FAN.
Raport zilnic facturare via FTP de la FAN Courier descarcat si parsat automat. Matching pe AWB id catre comenzi paid in ERP, marcare ramburs incasat in SmartBill sau Oblio, alertare comerciant daca diferente. Elimina munca manuala de reconciliere 5-15 ore/luna pentru magazine medii.
Generare AWB retur via API cu pickup la adresa ta sau punct de lucru. Client primeste eticheta retur via email, depune coletul la orice agentie FAN. La intoarcere, sistem inregistreaza automat refund-ul in SmartBill si trigger workflow stocare retur cu fotografie verificare.
Pe pagina checkout, dupa selectarea localitatii si cantarire produs, request API FAN returneaza pretul real al expedierii in 200ms. Client vede tarif corect (nu estimari approximate), tu nu mai platesti diferenta din buzunar. Suport cantar dinamic pentru cosuri multi-produs.
Etichetele AWB sunt formatate 100x150mm pentru imprimante termice Zebra, Brother sau Honeywell. Print direct din panou admin la apasarea unui buton, fara descarcare manuala. Batch print pentru 100 comenzi cu un click. Suport WebUSB pentru print local fara backend dedicate.
Conectare directa cu SmartBill, Oblio, NextUp sau Saga: la generare AWB, factura este emisa automat cu codul AWB ca referinta, status livrare se sincronizeaza pentru rapoarte ANAF e-Factura. Pentru CRM (Pipedrive, HubSpot) update automat deal stage la livrare.
Primesti tot codul sursa al integrarii, documentatie tehnica scrisa (cum cheama functiile, ce fac, cum se modifica), README cu instructiuni deployment. Daca alegi alt furnizor de integrari peste un an, nu te legam de noi. Cod TypeScript sau PHP curat, testat unit cu Vitest sau PHPUnit.
Cum functioneaza
Ziua 1
Te conectam cu account managerul FAN pentru contract business (daca nu ai deja). Configuram in panel punctele de expediere, plafonul ramburs lunar, optiuni livrare seara, easybox compatibility. Generam credentiale API username/password si endpoint Auth cu Basic. Test conexiune POST hub.fancourier.ro/v2 din Postman.
Zilele 2-4
Hook pe event confirmare comanda care apeleaza POST /awb cu payload colet (greutate, dimensiuni, valoare, ramburs, adresa). Parseam URL print returnat si salvam PDF in S3 pentru access permanent. Buton print din admin care trimite PDF la imprimanta termica via WebUSB sau queue local. Validare adresa client prealabil pentru a evita esecuri AWB.
Zilele 5-7
Cron job la fiecare 30 minute care polling /tracking_awb pentru AWB-urile active. Update status comanda in ERP (preluat, in tranzit, livrat). Trigger workflow notificari email plus SMS catre client la fiecare schimbare. Queue Redis pentru batch 30 colete per request pentru a evita rate limit 100 req/min.
Ziua 8
Configurare cron care descarca raportul zilnic FTP de la FAN cu sumele decontate. Parser tolerant CSV care matchuieste AWB id catre comenzi paid in SmartBill. Alertare daca diferente intre raport si comenzi. Implementare endpoint retur cu pickup la sediul tau si workflow refund automat.
Zilele 9-10
Test flow complet cu comanda reala de la checkout pana la livrare confirmata. Verificare reconciliere ramburs cu raport FTP de test. Validare fallback automat catre Sameday daca FAN pica peste 30 min. Training echipa 1h cu video plus manual scris. Go-live cu monitorizare 48h activa.
Stack suportat
Plugin oficial FAN, config in 2-3 ore pe tema standard.
Custom Shipping Rate App + Cloudflare Worker middleware.
Modul comunitar mentinut, customizat pentru multi-warehouse.
Extensie comunitara plus shipping method custom.
SDK Node/TypeScript cu Route Handlers App Router.
API routes catre backend Node cu Basic Auth header.
Backend PHP cu cURL + frontend Next.js consuma API intern.
Client SDK PHP cu cURL si Auth Basic, fara framework constraint.
Preturi
300€
livrare 5-7 zile
700€
livrare 10-14 zile
1200€+
livrare 14-21 zile
Intrebari frecvente
Pentru un magazin standard cu 1 punct expediere, AWB single, tracking si etichete PDF: 300-500€ one-off, livrare 5-7 zile. Pentru e-commerce cu volume mari (peste 200 AWB/zi), bulk generation, multi-warehouse, ramburs cu reconciliere automata si retur pickup la sediu: 700-1200€, livrare 10-14 zile. Cu integrare ERP/CRM custom (SmartBill, NextUp, Saga), dashboard analytics si raport zilnic FTP procesat automat: 1200-1500€. Maintenance lunar 0-50€/luna in functie de cate AWB-uri rulezi si daca vrei monitoring activ. Setup cont FAN Courier business este gratuit, te conectam noi cu account managerul lor pentru contract.
FAN Courier: cel mai potrivit pentru livrari B2C in toata tara cu volume medii-mari, retea proprie 4500+ curieri, tarife competitive pentru 1-5kg (12-18 RON), ramburs decontat in T+2. Sameday: best pentru livrari rapide cu easybox (sub 24h Bucuresti, livrare seara), ideal cosmetice/electronice mici. Cargus: bun pentru colete mari peste 30kg si paleti, suport B2B excelent. DPD: scump in RO dar single contract pentru livrare international EU. Recomandare: FAN Courier + Sameday combinat acopera 95% din nevoile unui magazin online RO. Integram orice combinatie pe acelasi checkout cu selectie dinamica.
Pentru un magazin standard: 5-10 zile lucratoare end-to-end. Etape: ziua 1 onboarding cont FAN Courier (contract business, configurare puncte expediere in panel, generare credentiale API). Ziua 2-4 implementare tehnica (POST hub.fancourier.ro/v2 cu username/password, generare AWB la confirmare comanda, salvare URL print PDF in baza ta). Ziua 5-7 tracking automat via /tracking_awb polling la 30 min plus webhook intern catre client (email/SMS). Ziua 8 ramburs reconciliere FTP zilnica si retur cu pickup. Ziua 9-10 testare flow complet plus go-live. Primesti cod sursa documentat, dashboard tranzactii, training 1h echipa, 30 zile suport bug-uri inclus.
Integrarea completa acopera: 1) Generare AWB single sau bulk via POST hub.fancourier.ro/v2/awb cu Auth username/password si returneaza URL print pentru eticheta PDF. 2) Calculator tarif live pe checkout (cantareste + masoara colet, returneaza pret real catre client). 3) Tracking automat via /tracking_awb polling la 30 min cu update status comanda (preluat, in tranzit, livrat, returnat). 4) Notificari client automate la fiecare schimbare status (email plus SMS optional via Twilio sau plugin WooCommerce). 5) Ramburs reconciliere: raport zilnic FTP de la FAN cu sumele decontate, matched automat pe AWB id catre comenzi paid in ERP. 6) Retur cu pickup la sediu via API. 7) Etichete PDF print direct la imprimanta termica Zebra. 8) Logging audit ANAF.
Suportam orice. WooCommerce: plugin oficial FAN Courier (free, mentinut activ), config in 2-3 ore daca tema nu e exotica. Shopify: integrare via Custom Shipping Rate App plus middleware Cloudflare Worker (Shopify nu accepta FAN nativ ca shipping provider), 1-2 zile setup. PrestaShop si Magento: module comunitare existente, customizate la nevoie. Next.js custom: implementare directa SDK Node/TypeScript cu Route Handlers App Router pentru AWB plus webhook. Astro si WordPress headless: API routes catre backend Node/PHP cu Auth basic. PHP custom legacy: client SDK PHP cu cURL si Basic Auth header. Magento 2: extensie comunitara plus custom shipping method daca multi-warehouse.
Top 5 erori vazute in productie: 1) Auth invalida (username/password gresit codificate Base64 in header Basic Auth, frecvent din copiere cu spatii ascunse) — fix: trimming si test sandbox prima data. 2) AWB generat dar URL print expirat (link-ul are TTL 7 zile) — fix: salveaza PDF imediat dupa generare in S3 sau Cloudflare R2, nu doar URL-ul. 3) Tracking polling care depaseste rate limit (100 req/min) — fix: queue Redis cu batch la 30 colete per request. 4) Ramburs nepotrivit pe AWB din cauza FTP raport cu format CSV diferit pe luni — fix: parser tolerant si alert daca format se schimba. 5) Adresa client invalida care esueaza AWB silent — fix: validare prealabila cu API check_address.
Da, suport tehnic real, nu doar ticket-uri ignorate. Pachet baza: 30 zile bug-fix gratuit post-livrare, raspuns email max 24h, fix critic (AWB blocate, expediere imposibila) max 4h. Pachet mentenanta lunara 50€/luna: monitoring uptime endpoint FAN, alertare automata pe Slack/email daca rate-ul de AWB esuate creste peste 2%, update cand FAN publica versiuni noi API, audit security semestrial, suport prioritar 4h SLA. Pentru e-commerce mari peste 500 AWB/zi recomandam pachet Custom cu monitorizare 24/7, on-call si SLA contractual. Avem flow de fallback automat catre Sameday daca FAN pica peste 30 min.
FAN Courier NU e potrivita pentru: 1) Livrari urgente sub 24h in Bucuresti si orase mari — Sameday cu easybox e clar superior (livrare seara, depozit la curier 3 min). 2) Colete grele peste 30kg sau paleti — Cargus are tarife mai bune si infrastructura camion. 3) Livrari internationale EU — DPD sau GLS sunt gandite cross-border, FAN doar RO. 4) Magazine de fashion cu retur masiv si nevoie de easybox return drop-off — Sameday locker reduce cost retur cu 40-60%. 5) B2B fragil/specializat (electronice industriale) — recomandam DSV sau Schenker direct. Integram orice combinatie si alegem dinamic la checkout dupa greutate plus localitate plus urgenta.
Integrari complementare
Ghid complet integrare curier pe orice site, cu comparatie FAN vs Sameday vs Cargus vs DPD.
Easybox, livrare in aceeasi zi in Bucuresti, retur drop-off automatizat. Combinat cu FAN pentru cobertura totala.
Pentru colete grele peste 30kg si paleti. Tarife B2B competitive, ideal pentru distributie.