Ce primesti
La confirmare comanda facem POST la API-ul curierului ales cu datele clientului, greutatea coletului si valoarea rambursului. In 2-5 secunde avem numarul AWB si URL-ul etichetei PDF. Angajatii tai nu mai tasteaza nicio data manual — tiparesc eticheta si ambaleaza coletul.
Simultan cu AWB-ul, cream factura in SmartBill cu toate produsele, TVA-ul corect, datele firmei clientului (pentru B2B cu CUI). SmartBill transmite automat in SPV ANAF pentru e-Factura B2B (obligatorie din 2024) si B2C (2025). Clientul primeste PDF-ul imediat pe email.
Configurabil: trimite automat prin Sameday pentru Bucuresti si orase mari, FAN Courier pentru zone rurale sau greutati mari. Sau ofera clientului alegerea in checkout. Economisesti 10-20% din costul de transport cu routing pe tarife negociate.
Polling status AWB la fiecare 30-60 minute. La fiecare schimbare de stare (preluat, in tranzit, in livrare, livrat) trimitem email sau SMS automat clientului. Reducere drastica a apelurilor de tip 'unde e coletul meu' catre suportul tau.
Comenzi venite pe OLX, WhatsApp, telefon sau email? Angajatul introduce rapid datele in formularul intern (accesibil pe telefon) si sistemul genereaza AWB + factura identic ca pentru comenzile de pe site. Zero comenzi pierdute din surse externe.
Pagina /retur pe site: clientul introduce numarul comenzii, sistemul creeaza AWB retur automat. Ramburs cash-on-delivery: reconciliere zilnica cu sumele incasate de curier, report automat in SmartBill. Reduce costurile de suport cu 50-70%.
Sentry sau echivalent prinde toate erorile: token expirat la curier, SmartBill indisponibil, format adresa invalid. Alerta Slack/email in sub 5 minute. Retry automat de 3 ori cu exponential backoff. Zero comenzi pierdute la downtime partial al API-urilor.
Livram tot codul in repo-ul tau (Git) cu documentatie completa. Daca disparem noi sau angajezi alt dev, totul e clar in 1 ora de citit. Fara dependente de servicii externe nepublice sau platforme care pot disparea.
Fluxul de date
Clientul finalizeaza checkout-ul pe WooCommerce sau Shopify (sau angajatul completeaza formularul intern pentru comanda externa). Sistemul primeste evenimentul order/created prin hook sau webhook.
Motorul de routing decide curieral (Sameday sau FAN Courier) in functie de regulile tale: cod postal, greutate, ora, serviciu ales de client. Validam greutatea coletelor, adresa de livrare si valorile rambursului.
Trimitem cererea catre API Sameday (POST /api/awb cu X-AUTH-TOKEN) sau API FAN Courier. In 2-5 secunde primim awbNumber + URL eticheta PDF/ZPL. Salvam in comanda. Angajatul poate tipari imediat.
In paralel cu AWB-ul, cream factura in SmartBill prin API cu toate liniile de produse, TVA-ul calculat, seria de factura configurata. Daca clientul are CUI, SmartBill transmite automat in SPV ANAF (e-Factura) si returneaza ID-ul de inregistrare.
Clientul primeste email cu: confirmarea comenzii, PDF-ul facturii atasat, numarul AWB si link de tracking la curier. Daca e easybox Sameday, include codul QR sau locatia lockerului ales.
Cron job la fiecare 30-60 minute verifica statusul AWB-urilor active. La fiecare schimbare (preluat, in tranzit, livrat, returnat) trimite notificare automata clientului si actualizeaza statusul comenzii in magazin.
Preturi
400-700€
livrare 5-10 zile
600-1000€
livrare 7-14 zile
1200-2000€
livrare 15-25 zile
2500€+
livrare 25-40 zile
Intrebari frecvente
La confirmare comanda pe site (sau automat la plata online), sistemul face doua lucruri simultan: 1) Genereaza AWB la curier (Sameday sau FAN Courier) prin API cu toate datele clientului, greutatea coletului si valoarea rambursului daca e cash-on-delivery — returneaza numarul AWB si URL eticheta PDF. 2) Creeaza factura in SmartBill cu toate produsele, TVA-ul corect, datele clientului si trimite PDF-ul prin email direct clientului. Angajatul tau nu mai tasteaza nimic manual: vede comanda, apasa "Confirma" (sau e automat), si in 10 secunde are AWB gata de tiparit si factura trimisa. Zero greseala umana pe date, zero timp pierdut.
WooCommerce (WordPress): plugin-uri oficiale pentru Sameday Romania si FAN Courier disponibile, SmartBill are plugin nativ WooCommerce — setup mai rapid (3-7 zile), mai ieftin (plugin-uri gratuite sau 50-150€/an), mai stabil la update-uri ANAF pentru ca plugin-urile sunt facut de romani. Shopify: nu exista app oficiala Sameday in App Store Romania, pentru FAN Courier similar — construim middleware n8n sau server dedicat care asculta webhook Shopify order/created si genereaza AWB; SmartBill for Shopify exista ca app terta (15-25€/luna). Setup 7-14 zile, mai scump cu 200-400€, dar functioneaza la fel de bine odata implementat. Pe ambele platforme, rezultatul final e identic: AWB + factura automata la comanda.
Da — acesta e unul din scenariile preferate. Construim un motor de routing: regula simpla ar fi cod postal din zona A (ex: Bucuresti + Ilfov) → Sameday; restul tarii → FAN Courier. Sau mai complex: greutate sub 2kg → Sameday easybox (customer alege locker in checkout); peste 2kg sau localitati rurale → FAN Courier la adresa. Sau: clientul alege curieral preferat in checkout si sistemul ruteza automat. Costul unui routing dual-curier e cu 30-50% mai mare decat o singura integrare, dar recuperezi prin tarife mai bune negociate cu doi curieri si rată mai mare de livrare la prima incercare.
SmartBill are modul e-Factura integrat care trimite facturile in Spatiul Privat Virtual ANAF (SPV) automat dupa generare. In integrarea noastra, la creare factura in SmartBill marcam daca e tranzactie B2B (client cu CUI) — in acest caz SmartBill trimite automat in SPV si returneaza ID-ul de inregistrare ANAF. Factura electronica B2B a fost obligatorie de la 1 ianuarie 2024; B2C devine obligatorie in 2025. Integrarea noastra e actualizata la regulile ANAF actuale. SmartBill gestioneaza schema XML UBL 2.1 ceruta de ANAF, semnatura digitala si confirmarile — tu nu trebuie sa stii nimic despre asta.
Mergem pe orice stack: 1) WooCommerce: plugin-uri native Sameday + FAN + SmartBill — cel mai rapid si ieftin, 3-7 zile. 2) Shopify: middleware n8n sau server Node.js cu webhooks Shopify + API Sameday + API SmartBill — 7-14 zile. 3) PrestaShop: module comunitar Sameday + modul SmartBill — 5-8 zile. 4) Magento 2: extensii partiale + completari custom — 10-15 zile. 5) Next.js, Astro, PHP custom: scriem clientii API de la zero in TypeScript sau PHP, fara dependente de plugin-uri — 10-15 zile, dar cel mai mult control pe logica. 6) n8n self-hosted: workflow vizual care conecteaza webhook comanda → API curier → API SmartBill, ideal pentru magazine cu volum mic (sub 50 comenzi/zi) care vor costuri minime de mentenanta.
Curier singur (Sameday sau FAN): 400-700€ implementare, 5-10 zile. Curier + SmartBill e-Factura pe WooCommerce: 600-1000€, 7-14 zile. Curier + SmartBill pe Shopify (necesita middleware): 900-1400€, 10-18 zile. Curier dual (Sameday + FAN) + SmartBill pe orice platforma: 1200-2000€, 15-25 zile. Stack custom PHP/Next.js: +30% fata de WooCommerce echivalent. Nu exista fee lunar de la noi — platesti SmartBill direct (plan Facturare Platinum ~30-60€/luna in functie de volum) si curierii direct (tarif per colet). Optional: mentenanta lunara 80-150€ pentru update-uri API si interventii rapide.
Acesta e exact cazul unui formular intern pe care il recomandam: o interfata simpla (accesibila de pe telefon) unde angajatul introduce rapid datele clientului, produsele si adresa de livrare. La submit, sistemul genereaza AWB la curier ales + factura SmartBill exact ca pentru o comanda de pe site. Clientul primeste acelasi email de confirmare cu factura si tracking. Formularul se poate integra cu un CRM simplu (n8n + Notion sau Airtable) pentru evidenta comenzilor externe. Costul unui astfel de formular intern: 400-700€ suplimentar fata de integrarea de baza, livrat in 5-8 zile.
Construim sistemul cu rezilienta din start. Daca Sameday API returneaza eroare (downtime, rate limit, token expirat): 1) Reincercam automat de 3 ori cu exponential backoff (1s, 5s, 30s). 2) Daca toate incercarile esueaza, comanda e marcata 'AWB pending' si trimitem alerta pe Slack/email in mai putin de 5 minute. 3) Angajatul genereaza AWB manual din panel.sameday.ro pentru acea comanda, fara a pierde vanzarea. Similar pentru SmartBill: daca factura nu se poate genera, comanda e salvata si reincercam la urmatorul interval. Zero pierderi de comenzi — degradare gratiosa, nu crash. Toate erorile loggate in Sentry sau echivalent cu context complet.
Pentru curier: credentiale API (X-AUTH-TOKEN Sameday sau user/parola FAN Courier API), lista pickup-point-uri contractate, greutatea medie a coletelor, daca folosesti ramburs si valoarea asigurarii. Pentru SmartBill: username si token API SmartBill (din setarile contului tau SmartBill), CIF-ul firmei, seria de factura dorita, cota TVA implicita (19% sau alta), seria AWB de folosit pe factira daca doresti. Nimic altceva. Nu avem nevoie de accese la hosting, baza de date sau alte sisteme sensibile — totul se face prin API-uri cu credentiale limitate.
Integrari conexe
Ghid complet integrare Sameday API: AWB automat, easybox lockers in checkout, tracking real-time, retur self-service. Cu detalii tehnice endpoint-uri.
Conectare FAN Courier API pe WooCommerce sau Shopify: AWB automat, ramburs, tracking, etichete bulk. Plugin-uri romanesti si integrare custom.
SmartBill API pentru facturare automata: factura la comanda, e-Factura ANAF SPV, proforma, chitanta, nota de credit. Plan Platinum obligatoriu.
Trimitere facturi in Spatiul Privat Virtual ANAF — obligatorie B2B din 2024, B2C din 2025. Prin SmartBill sau direct via API ANAF.
Hub complet integrari curieri Romania: Sameday, FAN, Cargus, DPD, GLS — costuri, acoperire, API maturitate si recomandare dupa volumul tau.
Comparatie detaliata platforme e-commerce cu focus pe integrari curieri si e-Factura — care platforma integreaza mai usor ecosistemul romanesc.