Ce primesti
La fiecare comanda noua cu Cargus selectat, codul apeleaza POST /api/AwbPickup si genereaza AWB-ul automat. PDF eticheta atasat pe email confirmare + disponibil in admin. Suport multi-colet (pana la 5 colete pe AWB), greutate volumetrica calculata corect, ramburs configurabil.
Pe pagina de checkout afisam selector cu lockerele Ship & Go din apropierea clientului, filtrate dupa codul postal + program de functionare. Date din endpoint-ul /PickupLocations cache-uite zilnic. Client alege locker = AWB-ul merge automat acolo. Peste 4500 puncte active Romania.
Cron job apeleaza GET /Awbs/GetByBarCode/{awb} la fiecare 4 ore pentru comenzi in tranzit. Updateaza status (preluat, sortare, in livrare, livrat, retur). Trimitere email + SMS client la status change. Widget tracking embed pe pagina cont si pe email confirmare comanda.
Ramburs pana la 5000 RON setat dinamic pe comanda (sau forteaza plata online peste prag). Asigurare extinsa peste valoarea standard (300 RON gratuit) cu cost 0.5% din valoarea declarata. Decont ramburs automat in cont IBAN setat in Cargus, raport zilnic in admin magazin.
Generare AWB retur direct din pagina comenzii (admin sau client). Client primeste eticheta pe email, depune coletul la orice locker Ship & Go sau cere ridicare adresa. Status retur tracked separat de comanda originala. Cost retur facturat pe comanda originala automat.
Configurare 1-N puncte de expediere (warehouse, magazin fizic, dropshipping). Curier Cargus vine sa preia coletele la programare zilnica (fereastra ora). Suport reguli pe SKU: produs din depozit Bucuresti vs Cluj. Toate punctele sincronizate cu Cargus /PickupPoints API.
Pentru magazinele care vand si pe eMag Marketplace cu propriul cont Cargus: sincronizare comenzi eMag → AWB Cargus → update tracking eMag prin Marketplace API. Permite gestiunea unitara a livrarilor din toate canalele intr-un singur dashboard.
Cod livrat in repo Git al tau (GitHub/GitLab), documentatie scrisa cum functioneaza fiecare modul, README cu setup local + variables .env, video training 30 min, sesiune Q&A 1h cu echipa ta. 90 zile suport bug-uri inclus fara cost suplimentar.
Cum functioneaza
Ziua 1
Discutam fluxul tau (cate puncte expediere, ce produse, daca vrei Ship & Go, ramburs, retur). Tu ne dai credentiale API Cargus (Subscription Key + user/password pentru Bearer token). Daca nu ai cont, te ghidam sa-l deschizi la cargus.ro — durata 2-5 zile.
Zilele 2-3
Configuram apelurile POST /api/AwbPickup, GET /Awbs/GetByBarCode, GET /PickupLocations cu Bearer token auto-refresh la 22h. Testam in sandbox Cargus cu comenzi fake. Validam ca AWB-urile generate sunt corecte, ca PDF-urile se descarca, ca trackingul updateaza statusuri.
Zilele 4-5
Implementam in checkout-ul tau optiunea Cargus (cu/fara locker), selector lockere filtrate pe cod postal, calcul cost livrare dinamic pe greutate + destinatie. Daca esti pe WooCommerce: setam plugin + override-uri. Daca esti pe Next.js: API routes custom + componenta React selector.
Zilele 6-7
Setam cron job sau queue worker care apeleaza GET /Awbs/GetByBarCode pentru toate AWB-urile in tranzit. Trimitem emails (template-uri customizate cu brand-ul tau) la status change. Adaugam widget tracking in admin si in pagina cont client. Logging in Sentry pentru erori.
Ziua 8-10
Testam pe productie cu 5-10 comenzi reale (sub supraveghere). Validam AWB-urile la sediul Cargus, verificam ca livrarile chiar ajung, ca trackingul e corect, ca decontul ramburs intra. Activam pentru toate comenzile + monitoring 7 zile post-launch. Training echipa ta 1h.
Stack suportat
Recomandat
Plugin oficial + custom code pentru features avansate (Ship & Go, multi-warehouse).
Custom
App custom prin Shopify Functions + Carrier Service API. Nu exista app oficial.
Recomandat
API routes care apeleaza Cargus direct. Queue BullMQ + Redis pentru volume mari.
Custom
Modul existent dar limitat — frecvent rescriem pentru control + features moderne.
Custom
Extension custom prin Webkul SDK sau cod nativ in Magento Shipping Method.
Avansat
Webhooks din admin catre serverless functions Vercel / Netlify / Cloudflare Workers.
Recomandat
SDK Cargus official Composer sau cod direct cu Guzzle. Recomandam Laravel Queue.
Add-on
Sincronizare comenzi eMag → AWB Cargus → update tracking prin Marketplace API.
Preturi
350€
livrare 3-5 zile
800€
livrare 7-10 zile
1500€+
livrare 14-21 zile
Intrebari frecvente
Pentru implementare initiala: 350-1500€ one-off, in functie de complexitate. Plugin WooCommerce + setari standard (1 expeditor, AWB generat la finalizare comanda, tracking pe pagina cont): 350-500€. Custom Shopify / Next.js cu logica avansata (multi-warehouse, reguli pe greutate, Ship & Go selector locker pe checkout): 800-1500€. Mentenanta lunara: 0-50€/luna (gratuit primele 3 luni, apoi optional in functie de schimbarile API Cargus). Influente pe pret: numarul de puncte de expediere, daca vrei selector locker custom, daca integrezi cu eMag Marketplace, volum comenzi (peste 500/zi necesita queue cu retry).
Cargus URGENT: cea mai larga retea locker Ship & Go in Romania (peste 4500 puncte in 2025), API matur si stabil, tarife competitive pe colete mici sub 5kg. Sameday: aplicatie buna pentru destinatari, easybox dens in orase mari, dar API mai limitat la features avansate. FAN Courier: tarife agresive pentru volume mari B2B, dar API documentat slab si suport tehnic lent. DPD: international cel mai bun, dar scump pe Romania. Recomandare: Cargus pentru ecommerce SMB cu pickup locker, Sameday pentru clienti care vor easybox-uri orase, FAN pentru volume B2B mari. Frecvent integram 2-3 curieri simultan ca clientul sa aleaga.
Plugin WooCommerce standard: 3-5 zile lucratoare (zile 1-2 setup API si test cu credentialele Cargus de productie, zile 3-4 testare end-to-end cu comenzi reale, ziua 5 go-live cu monitoring). Custom Next.js sau Shopify Hydrogen: 7-14 zile (1-2 zile discovery + API contract, 3-7 zile build cu AWB + tracking + selector Ship & Go, 2-3 zile QA, 1 zi go-live). Custom enterprise cu eMag Marketplace si multi-warehouse: 3-4 saptamani. Prerequisit: trebuie sa ai deja cont Cargus URGENT activ cu credentiale API (Subscription Key + Bearer token) — obtinere la cargus.ro durata 2-5 zile lucratoare.
1) Cand clientul plaseaza comanda cu Cargus selectat, sistemul apeleaza POST urgentcargus.ro/api/AwbPickup cu Bearer token, trimite datele expeditor + destinatar + colet (greutate, volum, valoare ramburs, asigurare). 2) Cargus returneaza un AWB unic salvat pe comanda. 3) PDF eticheta AWB generat automat si trimis pe email + atasat in admin pentru printare. 4) Cron job zilnic apeleaza GET /Awbs/GetByBarCode/{awb} pentru fiecare comanda in tranzit, updateaza statusul (preluat, in tranzit, livrat, retur), trimite email/SMS client la schimbari. 5) Daca clientul a ales Ship & Go locker, in checkout afisam selector cu locatii din /PickupLocations filtrate pe codul postal.
WooCommerce: plugin oficial Cargus Romania disponibil + custom code pentru features avansate (selector Ship & Go, tracking pe pagina cont). Shopify: app custom prin Shopify Functions + carrier service API (nu exista app oficial Cargus in Shopify App Store, deci facem custom). PrestaShop: modul Cargus existent dar limitat — frecvent rescriem. Magento 2: extension custom prin Webkul sau cod nativ. Next.js custom (App Router): API routes care apeleaza direct urgentcargus.ro/api, recomandam queue cu BullMQ/Redis pentru rate limit. Astro / WordPress headless: prin webhooks din admin catre serverless functions. PHP custom (Laravel/Symfony): SDK Cargus official sau cod direct cu Guzzle.
1) Token Bearer expirat (valabil ~23h): solutie cache token cu auto-refresh la 22h. 2) Greutate sau dimensiuni invalide (Cargus refuza sub 0.1kg sau peste 31.5kg pentru standard): validare pe checkout inainte sa ajunga la API. 3) Adresa incompleta (lipsa cod postal sau strada generica): forteaza autocomplete cu API-ul de orase Cargus /Localities. 4) Rate limit depasit la volume mari (peste 60 req/min): queue cu retry exponential. 5) Ship & Go locker plin sau dezafectat: cache zilnic /PickupLocations + fallback la livrare adresa. 6) Ramburs > 5000 RON necesita aprobare manuala — flagam in admin. Toate erorile logate in Sentry cu alerta Slack.
Inclus in pretul integrarii: 90 zile suport bug-uri free (orice nu functioneaza din cauza codului nostru o reparam fara cost). Documentatie scrisa cum functioneaza, video training 30 min pentru admin, sesiune Q&A 1h cu echipa ta. Pentru schimbari minor API Cargus (frecventa 1-2 ori pe an): mentenanta lunara optionala 30-50€/luna include update si testare. Pentru cereri noi features (ex: adaugare al doilea curier, schimbare logica colet): cotam separat la 50€/ora. Backup automat al AWB-urilor generate in baza ta date — daca pica API Cargus ai istoric complet. SLA raspuns ticket: 4h zile lucratoare, 24h weekend.
1) Magazine cu sub 20 comenzi/luna: efortul integrarii (350€+) nu se justifica vs generare manuala AWB in panel Cargus 5 min/comanda. Recomandam manual. 2) Magazine B2B cu transport pe palet greu (peste 50kg): Cargus URGENT e optimizat colet ecommerce, alternative mai bune Dumitrana sau International Lazar. 3) Livrare internationala UE: DPD sau DHL au tarife mai bune si tracking unificat. 4) Magazine cu rate de retur > 30% (haine fashion): recomandam integrare paralela Sameday care are aplicatie buna pentru retur prin easybox. 5) Daca deja folosesti un OMS (Order Management System) precum Innoship sau Shipmondo: integram prin acela, nu direct cu Cargus — economisesti complexitate.
Integrari conexe
Ghid general integrare curieri (Cargus, Sameday, FAN, DPD) — alegere si arhitectura multi-curier.
Easybox-uri Sameday, integrare API pentru AWB + tracking. Recomandat clienti urbani din orase mari.
FAN Courier API pentru volume B2B mari. Tarife agresive, dar suport tehnic limitat — facem noi munca.
Cazuri reale de magazine ecommerce cu Cargus integrat.
Pricing transparent pentru toate integrarile si serviciile noastre.
Trimite-ne stack-ul tau si volumul lunar — oferta in 4h.