Integrare curier site eCommerce — toti curierii din Romania, un singur cod
AWB automat, tracking live, retur si ramburs pentru Sameday, FAN Courier, Cargus, DPD si GLS. Compatibil cu WooCommerce, Shopify, PrestaShop, Next.js custom. Te ajutam sa alegi curierii potriviti si livram integrarea in 2-10 zile.
Tot fluxul de curierat automat, de la confirmare comanda la decont ramburs
Generare AWB automata la comanda
La trecerea pe status 'processing' sau la plata confirmata (NETOPIA, Stripe, ramburs), AWB-ul se genereaza automat in API-ul curierului. Eticheta PDF gata de printat apare in admin in maxim 3 secunde. Functioneaza si in bulk pentru zile cu volum mare.
Tracking live in cont client
Numarul AWB se trimite automat clientului pe email si optional SMS. In contul lui de pe site vede statusul live (in tranzit, in sucursala, in livrare, livrata). Webhook-uri curier sincronizeaza statusul comenzii in WooCommerce/Shopify fara polling manual.
Retur cu un click pentru client
Client logat genereaza singur AWB retur din contul lui in 30 secunde. Plata returului poate fi suportata de magazin sau client (configurabil). Notificare automata cand returul ajunge in depozit. Compatibil OUG 34 pentru retur in 14 zile fara motiv.
Ramburs reconciliat automat
Sumele incasate prin ramburs (cash on delivery) se inregistreaza pe fiecare comanda. La sfarsit de luna integram deconturile XML/CSV ale curierului cu comenzile, semnalam diferentele. Conectare optionala cu SmartBill pentru facturare automata si ANAF e-Factura.
Calcul cost livrare la cos
Pretul curier afisat clientului in cosul de cumparaturi e calculat in timp real prin API curier in functie de cod postal destinatie, greutate, dimensiuni si ramburs activ. Optional: multi-curier cu alegere automata a celui mai ieftin pentru combinatia respectiva.
Notificari si webhook-uri
Comerciantul primeste alerta cand AWB esueaza, cand un retur ajunge sau cand un AWB e blocat in sucursala peste 48h. Webhook-uri configurabile catre Slack, Discord, email sau orice URL custom. Logging complet pentru audit si troubleshooting.
Validare adresa la checkout
Autocomplete cu adresele reale Romania si validare cod postal vs judet vs localitate. Reduce AWB-urile respinse pentru 'adresa invalida' cu 80%. Daca clientul tasteaza greu, fallback la geocoding curier inainte de generarea AWB-ului.
Documentatie completa + cod sursa
Predam documentatie scrisa (markdown) cu toate endpoint-urile, environment variables, secrete API, schema baza de date pentru log-uri. Codul ramane in repo-ul tau, fara dependinte SaaS hidden. Orice developer poate prelua si continua fara sa ne contacteze.
Cum functioneaza
De la 'vreau integrare' la AWB-uri pe productie in maxim 14 zile
Ziua 1
Audit comenzi + alegere curieri
Vedem unde livrezi cel mai mult (Bucuresti, orase mari, rural, UE), greutati medii, volum lunar. Recomandam combinatia de 1-3 curieri optima — frecvent Sameday + FAN sau Sameday + DPD pentru UE. Daca ai deja contracte negociate, le folosim.
Zilele 2-3
Conturi API + sandbox testing
Cerem la curier credentialele API (la Sameday e self-service in cont, la FAN/Cargus iti dau dupa contract). Configuram sandbox-ul pentru testare fara comenzi reale. Documentam toate secretele in vault (.env + 1Password Teams optional).
Zilele 4-7
Integrare in stack-ul tau
WooCommerce: instalare si configurare plugin oficial sau plugin custom daca scope complex. Shopify: app marketplace sau custom Shopify app cu Functions. Next.js / custom: API routes TypeScript tipate, wrapper SDK propriu, error handling cu retry, logging in baza de date.
Zilele 8-9
Testare end-to-end cu comenzi reale mici
Facem 5-10 comenzi de test cu valoare mica catre adrese reale (frecvent biroul nostru) pentru a valida fluxul complet: AWB, tracking, retur, ramburs. Verificam timpul de preluare, comportamentul la edge cases (sucursala inchisa, ramburs respins).
Zilele 10-12
Go-live + monitoring + training
Activare pe productie cu feature flag (puteam dezactiva integrarea in 30 secunde daca apare ceva). Sesiune training 1h cu echipa ta. Configurare alerte Slack/email pentru AWB-uri esuate. Monitoring activ in primele 7 zile post-launch.
Zilele 13-14
Predare cod + documentatie + suport
Push final in repo-ul tau, predare documentatie scrisa (markdown), credentiale API in vault-ul vostru, runbook pentru troubleshooting comun. 90 zile suport gratuit pentru bug-uri integrare. Optional contract mentenanta lunara pentru update-uri curier.
Stack suportat
Integram pe orice stack folosit pentru eCommerce in Romania
WooCommerce
Plugin-uri oficiale Sameday, FAN, Cargus, DPD, GLS sau plugin custom. Timeline tipic 2-5 zile. Compatibil cu HPOS si WooCommerce Blocks checkout.
Shopify
App-uri marketplace (Innoship, Pluria, Shipro) sau custom Shopify App cu Carrier Service API + Functions. Suport Shopify Plus complet.
PrestaShop
Module oficiale pentru toti 5 curieri pe PrestaShop 1.7 si 8. Cerinte PHP 8.1+, MySQL 8. Timeline 3-5 zile.
Magento 2
Conector Adobe Commerce sau custom module. Pentru proiecte enterprise cu multi-store si multi-source inventory. Timeline 10-14 zile.
Next.js custom
Recomandat pentru stack modern. API routes TypeScript tipate, server actions, integrare directa cu API curier. Performant si flexibil.
Astro / Eleventy
Frontend static cu backend headless (Supabase, Strapi, custom Node). Integrare curier in API layer separat. Timeline 7-10 zile.
WordPress headless
WooCommerce ca backend cu frontend Next.js/Astro. Integrare via WooCommerce REST API + endpoint-uri custom pentru curier. Timeline 7-10 zile.
PHP custom
Laravel, Symfony, plain PHP cu Composer. Construim SDK PHP tipat catre API curier, integrabil in orice arhitectura. Timeline 10-14 zile.
Complexitatea logicii de smart routing (basic vs reguli per produs / categorie)
Volum lunar comenzi (sub 100 vs 500+ vs 5000+ necesita optimizari)
Integrare cu SmartBill / NextUp / Saga pentru facturare automata
Multi-warehouse cu split AWB pe fiecare depozit
Localizare interfata in 2+ limbi (RO + EN tipic)
Custom webhook-uri / dashboard de monitorizare
Migrare istoric AWB-uri din sistem vechi
Cui se potriveste
Magazine online cu 50+ comenzi/luna si crestere constanta
E-commerce care livreaza in toata Romania, nu doar in Bucuresti
Firme cu contracte negociate curier care vor sa folosesc tarife proprii
Site-uri custom Next.js sau headless WooCommerce care nu au plugin out-of-the-box
Magazine cu ramburs (cash on delivery) si nevoie de reconciliere automata
Marketplace-uri proprii cu split AWB pe vanzator / depozit
Cui NU se potriveste
Magazine sub 30 comenzi/luna — efortul nu se amortizeaza, foloseste app curier direct
Cei care vand exclusiv pe eMAG Marketplace / Vivre — ei fac livrarea
Dropship din China cu curieri setati de furnizor
Magazine care testeaza un curier nou la 2-3 luni — recomandam SaaS middleware
Site-uri demo / portfolio fara volum real de comenzi inca
Intrebari frecvente
Ce ne intreaba magazinele inainte sa aleaga integrare curier
Cât costă real integrarea unui curier pe site-ul meu? În EUR sau RON, fără surprize?
Depinde de stack si scope. WooCommerce sau Shopify cu un singur curier (Sameday, FAN, Cargus, DPD sau GLS) folosind plugin oficial sau marketplace app: 300-500€ one-off, plus 0-25€/luna mentenanta. Multi-curier (2-3 furnizori cu logica de alegere automata in functie de pret/judet/greutate): 600-1000€ one-off. Custom Next.js sau PHP custom cu integrare API directa: 800-1500€ one-off in functie de cate operatiuni vrei (AWB, tracking, retur, ramburs, anulare). Lunar tipic: 0-50€ daca folosesti plugin-uri oficiale (curierul nu percepe taxa API), 30-80€ daca folosesti SaaS middleware tip Innoship sau Pluria.
Sameday vs FAN Courier vs Cargus vs DPD vs GLS — cu care sa incep?
Sameday: cel mai bun API REST modern, easybox bine acoperit, ideal pentru fashion si small parcels (sub 5kg), preturi competitive Bucuresti si orase mari. FAN Courier: cea mai mare retea fizica nationala, perfect pentru oras mic / rural, API SOAP mai vechi dar stabil, ramburs si retur excelent procesate. Cargus: middle of the road, integrare decenta, livrare next-day garantata in 80% din tara, bine pentru B2B. DPD: ideal pentru livrare internationala UE si shippers premium, API REST modern, tracking detaliat. GLS: stabil pentru livrari medii-mari, retea EU integrata, suport bun in clusterele industriale. Recomandare standard: incepi cu Sameday (orase mari) + FAN (rural), adaugi DPD daca livrezi UE.
Cat dureaza implementarea efectiv? De la 'da' la AWB-uri automate pe comenzi reale?
WooCommerce cu plugin oficial curier (instalare, configurare, testare end-to-end): 2-3 zile lucratoare. Shopify cu app marketplace (Innoship, Pluria, Shipro): 1-2 zile, app-urile sunt deja conectate. PrestaShop cu modul oficial: 3-5 zile (sunt mai picky la versiuni PHP). Next.js custom cu API direct: 7-10 zile (creez wrapper TypeScript tipat, error handling, retry logic, logging). Multi-curier cu logica smart routing (alege automat curierul mai ieftin pentru zona X greutatea Y): 10-14 zile. Total timeline include si testarea cu 5-10 comenzi reale in sandbox inainte de live.
Ce face exact integrarea? Pot s-o folosesc fara stress operational dupa livrare?
Integrarea acopera ciclul complet: 1) AWB automat la confirmare comanda (sau la trecerea pe status 'processing'), nu mai introduci manual nimic. 2) Etichete PDF gata de printat in interfata admin. 3) Tracking automat: numarul AWB se trimite la client pe email/SMS, status update se sincronizeaza in comanda (in tranzit, livrata, refuzata). 4) Retur: generare AWB retur cu un click cand clientul cere. 5) Ramburs (cash on delivery): suma platita de client se inregistreaza automat in comanda + reconciliere cu deconturile lunare ale curierului. 6) Anulare AWB daca clientul renunta inainte de preluare. Dupa livrare functioneaza autonom — interventie umana doar la cazuri exceptionale (AWB blocat, sucursala inchisa).
Ce platforme suportati? Pot integra pe orice site sau doar WooCommerce?
Suportam orice stack cu API web disponibil. Verificate complet: WooCommerce (plugin-uri oficiale Sameday, FAN, Cargus, DPD, GLS sau custom), Shopify (app marketplace plus custom apps cu Shopify Functions pentru carrier service), PrestaShop (module oficiale pentru toti 5 curieri), Magento 2 (Adobe Commerce, conector EE), Next.js custom (API routes care apeleaza direct API-ul curierului, recomandat solutia noastra), Astro / Eleventy / Hugo headless cu backend separat (Supabase, Strapi), WordPress headless cu WooCommerce REST API, PHP custom (Laravel, Symfony, plain PHP cu Composer). Single-source-of-truth: codul integrarii curierului ramane in serverul tau, nu depindem de SaaS third-party care poate ridica preturile.
Ce erori comune apar in productie si cine le rezolva?
Cele mai frecvente: 1) AWB respins pentru ca adresa nu poate fi geocodata (cod postal lipsa sau scris gresit) — solutie: validare adresa client la checkout cu autocomplete Google Places sau API curier. 2) Greutate sau dimensiuni gresite — dadea preturi gresite si curierul refuza preluarea; solutie: catalog produse cu greutate reala obligatorie, calcul automat la cos. 3) Token API expirat (FAN si Cargus folosesc tokenuri care expira la 24h) — solutie: refresh automat cu cache Redis. 4) Sucursala destinatie inchisa duminica — AWB se accepta dar statusul ramane 'in asteptare'. 5) Ramburs nedecontat la timp — implementam reconciliere automata cu deconturile XML/CSV ale curierului. 90 zile suport gratuit dupa livrare pentru bug-uri integrare.
Daca curierul schimba API-ul, cine plateste reintegrarea? Sunt blocat in costuri ulterioare?
Curierii fac schimbari minor frecvent (cam 1-2/an per curier) si schimbari majore rar (1 la 2-3 ani). Acoperire schimbari: 1) Minor (campuri noi, endpoint-uri noi opcionale): inclus in 90 zile suport gratuit, dupa care 30-50€ interventie. 2) Major (versiune API noua obligatorie, ex Sameday v1 -> v2): cost 200-500€ refactor + 1-2 zile downtime planificat. Te avertizam cu 30 zile inainte pentru ca curierii anunta tranzitia in avans. Alternativa: pachet anual mentenanta 30-50€/luna care include orice update curier + monitoring AWB-uri esuate + raport lunar. Nu te legam de noi — predam codul si documentatia, orice dev poate continua.
Cand NU e potrivita integrarea custom cu curierii? Cand sa folosesc altceva?
Cand NU recomandam custom: 1) Sub 30 comenzi/luna — efortul integrarii nu se amortizeaza, folosesti aplicatia curierului direct sau Innoship/Pluria pe abonament SaaS de 15-30€/luna. 2) Cand vrei sa schimbi curierul la 3 luni 'sa testezi alt furnizor' — fa-o prin SaaS middleware tip Innoship care are toti curierii sub o singura interfata, nu plateste 5 integrari custom. 3) Cand iti vinzi exclusiv pe marketplace-uri (eMAG Marketplace, Vivre, Fashion Days) — ei fac livrarea, nu mai integrezi nimic. 4) Cand doar dropship-uiesti din China si curierii sunt setati de furnizor. In schimb pentru 50+ comenzi/luna cu volum cu crestere si vrei control real al fluxului si costului, integrarea custom se amortizeaza in 6-12 luni.
Integrari per curier
Vrei doar un curier? Vezi ghidul dedicat fiecaruia