Integrare GLS România cu AWB automat și ParcelShop direct în checkout
Conectăm magazinul tău la API REST GLS România (POST api.gls-romania.com/parcel/v1) cu Bearer token, webhook status events, ParcelShop picker, FlexDeliveryService time window, COD, retur și etichete PDF/ZPL/EPL. De la 400€, livrare în 2-3 săptămâni.
Integrare GLS funcțională end-to-end, nu doar plugin instalat
Generare AWB automat la confirmare comandă
La trecerea comenzii în status „Processing” sau „Confirmed”, magazinul tău face POST către api.gls-romania.com/parcel/v1 cu Bearer token și primește AWB instant. Adresa expeditor, dimensiuni colet, conținut și COD se preiau automat din comandă. Retry logic și queue pentru cazurile de peak când GLS răspunde 503.
ParcelShop picker integrat în checkout
Cumpărătorul vede pe checkout o listă cu cele mai apropiate 500+ ParcelShop după codul poștal sau localitatea introdusă. Date sincronizate zilnic cu API GLS locații (program, adresă, GPS). Salvăm ID-ul ParcelShop în comandă și-l trimitem la generare AWB. UI compatibil cu WooCommerce, Shopify, Next.js sau custom.
FlexDeliveryService cu time window 1h
Pentru livrare la domiciliu, oferim cumpărătorului în checkout selecție interval orar de 1h (10:00-11:00, 14:00-15:00 etc) în zilele disponibile. Parametrii sunt trimiși corect către endpoint-ul GLS și AWB primește flag FlexDelivery. Reduce procentul de „adresant absent” cu 30-50% pe segment B2C.
Webhook status events configurabil
Setăm endpoint propriu în magazinul tău care primește events Picked up, In transit, Out for delivery, Delivered, Returned, Cancelled. Validare semnătură, idempotency cu cache pe event ID, retry exponential dacă pică temporar. Statusul comenzii se actualizează în timp real, clientul vede tracking accurate.
Cash on Delivery (ramburs) sincronizat
Configurăm COD cu sumă per AWB trimisă către GLS, sincronizare la încasare (când GLS confirmă banii primiți de curier și transferați către contul tău), reconciliere automată cu statusul plătit în magazin. Suport pentru sume parțiale și split COD multi-colet la aceeași comandă.
Retur prin ParcelShop fără AWB nou
Cumpărătorul poate genera retur direct din contul lui cu drop-off la orice ParcelShop, fără să aștepte curierul la domiciliu. Configurăm flow RMA cu coduri retur trimise pe email/SMS, sync cu sistemul tău (rebursare automată la primire colet), reducere semnificativă a costului operațional retur.
Etichete PDF, ZPL, EPL pentru imprimare
Generăm etichete în 3 formate: PDF (4x6 inch sau A4 pentru imprimante standard), ZPL pentru imprimante termice Zebra (GK420, ZD420 — cele mai folosite în warehouse RO), EPL pentru imprimante Eltron mai vechi. Prelucrare batch pentru zile cu volum mare (export ZPL multi-AWB).
Dashboard tracking + raport ANAF
Dashboard în admin cu toate AWB generate, status curent, istoric events, sume COD încasate, costuri totale lunare per curier. Export CSV pentru reconciliere contabilă și import în SmartBill sau Saga. Toate datele păstrate pentru audit ANAF (e-Factura încărcat ușor cu date AWB pentru reduceri TVA livrare).
Cum funcționează
De la kickoff la primul AWB real în 2-3 săptămâni
Zilele 1-2
Discovery + acces sandbox GLS
Sesiune 30-45 min unde mapăm fluxul actual (manual? alt curier? checkout? COD?), volumul lunar de expedieri, stack-ul tău (WooCommerce / Shopify / Next.js / custom). Cerem împreună acces sandbox GLS România și Bearer token de test. Confirmăm scope și timeline scris.
Zilele 3-5
Setup API + generare primul AWB test
Configurăm cont expeditor, adrese, default-uri (greutate, dimensiuni). Implementăm POST către api.gls-romania.com/parcel/v1 cu Bearer token și retry logic. Generăm primul AWB în sandbox pentru o adresă internă și validăm toate câmpurile (cod bare, etichetă, status).
Zilele 6-10
ParcelShop picker + FlexDelivery
Integrăm UI ParcelShop în checkout cu listare puncte după cod poștal, hartă opțională (Leaflet), salvare ID în comandă. Adăugăm selecție FlexDeliveryService time window pentru livrare la domiciliu. Testăm cu date reale din 3-5 județe diferite.
Zilele 11-14
Webhook status + COD + retur
Implementăm endpoint webhook pentru status events GLS cu validare semnătură și idempotency. Configurăm COD cu reconciliere automată la încasare. Setăm flow retur prin ParcelShop. Generăm etichete PDF / ZPL / EPL.
Zilele 15-18
Testare end-to-end + go-live
Switch la credentials production, generare AWB real pentru o adresă internă, urmărire status până la livrare reală. Migrăm pluginul tău anterior sau procesul manual către noul flow. Training echipa operațiuni (1-2h) pentru imprimare etichete, ParcelShop picker, gestiune retur.
Zilele 19-21
Suport go-live + documentație
Monitorizare activă webhook în primele 7 zile, fix-uri rapide la edge cases descoperite în trafic real. Livrăm documentație scrisă cu credentials, endpoint-uri, payload examples, diagrama webhook events. 30 zile suport bug-uri inclus.
Stack suportat
Integrăm GLS pe orice stack folosit în România
Recomandat
WooCommerce
Plugin oficial GLS România sau extensie custom pe API REST. Recomandat pentru 70% din magazinele RO. Configurare adrese expeditor, ParcelShop picker în checkout, AWB automat la „Processing”.
Suportat
Shopify
Carrier Service API (necesită plan Advanced) sau middleware Make / n8n care creează AWB la confirmare. Pluginul oficial GLS nu există în App Store, deci integrare custom.
Recomandat
PrestaShop
Modul oficial GLS România disponibil, integrare standard în admin. ParcelShop picker, FlexDelivery, AWB batch toate suportate out-of-the-box.
Suportat
Magento 2
Extension oficial GLS sau implementare custom pe REST API cu shipping method dedicat. Suport pentru multi-store și multi-warehouse cu adrese expeditor diferite.
Recomandat
Next.js custom
Integrare server-side cu route handler POST către api.gls-romania.com/parcel/v1, webhook în API route, ParcelShop picker React component, generare PDF cu react-pdf sau pdfkit.
Suportat
Astro
Endpoint-uri SSR proprii pentru AWB generation și webhook handler. ParcelShop picker ca island React sau Svelte. Generare etichete server-side.
Suportat
WordPress headless
Backend PHP cu plugin GLS standard + expunere endpoint-uri REST custom către frontend Next.js / Nuxt. ParcelShop picker în frontend, AWB generation în backend.
Suportat
PHP custom / Laravel
Client HTTP Guzzle pe API REST cu Bearer token, librărie PDF Dompdf sau TCPDF pentru etichete, Laravel queue pentru retry AWB, Eloquent models pentru tracking.
Stack: plugin standard WooCommerce e ieftin, custom Next.js / Laravel e mai scump (mai mult cod de scris)
ParcelShop picker simplu (listă) vs cu hartă interactivă Leaflet (UI mai complex)
Multi-warehouse cu mai multe adrese expeditor și logica de selecție automată
Multi-courier rate-shopping (GLS + DPD + Sameday în paralel cu alegere automată)
Integrare cu SmartBill, NETOPIA, ANAF e-Factura pentru fluxuri end-to-end
Mentenanță lunară opțională (0-50€/lună pentru monitoring webhook + update-uri API)
Întrebări frecvente
Ce ne întreabă magazinele înainte să integreze GLS
Cât costă real o integrare GLS România și ce taxe trag pe AWB?
Integrarea de la noi: 400-1200€ one-off pentru WooCommerce / PrestaShop standard (plugin oficial GLS + configurare credentials + testare AWB sandbox), 800-1500€ pentru Next.js sau PHP custom direct pe API REST cu Bearer token, 1500-2500€ pentru flow complex cu ParcelShop picker, FlexDeliveryService time window și retur automat prin ParcelShop. GLS România nu cere fee inițial pentru contul de expeditor, dar trebuie volum minim contractual (~30-50 expedieri/lună la unele tarife). Tariful pe AWB pleacă de la 10-12 RON pentru colete sub 2kg către ParcelShop și 14-18 RON pentru livrare la domiciliu, plus suplimente pentru COD (1-2% sau minim 3 RON), retur la expeditor și gabarit mare. Fără mentenanță obligatorie după go-live.
GLS vs DPD vs Sameday vs FAN Courier — care e cel mai potrivit pentru magazinul meu?
GLS România: punctul forte este rețeaua ParcelShop (500+ puncte ridicare, ieftină, foarte folosită de cumpărători RO), FlexDeliveryService cu time window 1h, AWB API REST clar documentat, retur prin ParcelShop fără call back. DPD România: livrare door-to-door bună, Pickup Stations DPD în creștere, API SOAP mai vechi, comisioane similare. Sameday: cea mai mare rețea easybox (3000+), API REST modern, perfect pentru livrare automat în lockere 24/7, ușor mai scump. FAN Courier: cea mai mare flotă RO door-to-door, fără rețea proprie de lockere, integrare prin AWB online. Recomandare: GLS dacă vrei mix ParcelShop + door-to-door cu cost minim, Sameday dacă cumpărătorii tăi preferă lockere 24/7, sau toate trei în paralel (multi-courier rate-shopping) pentru e-commerce cu volum mare.
Cât durează integrarea GLS de la kickoff până la primul AWB real?
Pentru WooCommerce sau PrestaShop cu plugin oficial GLS România: 3-5 zile lucrătoare (instalare plugin, configurare credentials Bearer token, setare adrese expeditor, testare în sandbox cu generare AWB test, switch în producție, testare end-to-end cu AWB real pentru o adresă internă). Pentru Next.js sau PHP custom direct pe POST api.gls-romania.com/parcel/v1: 7-14 zile (server endpoint pentru generare AWB la confirmarea comenzii, handler webhook pentru status updates, ParcelShop picker UI cu API locații, generare etichetă PDF/ZPL pentru imprimare, dashboard admin tracking). Plus 3-7 zile la GLS pentru aprobare cont expeditor și emitere Bearer token (depinde de documentele firmei și volumul estimat). Total realist: 2-3 săptămâni calendaristice.
Ce face exact „integrarea” voastră — nu pot să-l pun singur din WooCommerce?
Tehnic, da, poți instala un plugin de curierat din repo WooCommerce și completa câmpuri. Practic, ce facem noi în plus: 1) Configurăm corect Bearer token pentru endpoint-ul POST api.gls-romania.com/parcel/v1 și separăm clar sandbox vs production (oameni se păcălesc des aici și generează AWB test cu trafic real). 2) Implementăm webhook configurabil pentru status events (Picked up, In transit, Out for delivery, Delivered, Returned) cu validare și retry idempotent. 3) Integrăm ParcelShop picker cu API listare puncte ridicare după județ și cod poștal. 4) Implementăm FlexDeliveryService cu selecție interval orar 1h în checkout (cere parametri suplimentari la POST). 5) Generăm etichete PDF, ZPL pentru Zebra și EPL pentru Eltron, plus prelucrare batch pentru zile cu volum mare. 6) Configurăm COD cu sume per AWB și sincronizare în sistem la încasare. 7) Setăm retur prin ParcelShop fără AWB nou (RMA flow). 8) Testare end-to-end cu 5+ scenarii reale.
Ce stack-uri suportați pentru integrare GLS — am Shopify sau Magento?
WooCommerce: plugin oficial GLS România sau extensie custom pe API REST, configurat și testat de noi. Shopify: nu există app oficial GLS România în Shopify App Store, deci integrare prin Carrier Service API (necesită plan Shopify Advanced) sau prin middleware extern (Make / n8n) care creează AWB la confirmare comandă. PrestaShop: modul oficial GLS disponibil, integrare standard cu logica AWB direct în admin. Magento 2: extension oficial GLS sau implementare custom pe REST API. Next.js / React custom: integrare server-side cu POST api.gls-romania.com/parcel/v1, webhook handler în route handler sau API route, UI ParcelShop picker cu fetch la API locații, generare PDF cu pdfkit sau react-pdf. Astro: la fel ca Next.js, endpoint-uri SSR proprii. WordPress headless: backend PHP cu plugin GLS + REST API către frontend. PHP custom / Laravel / Symfony: client HTTP Guzzle pe API REST cu Bearer token, librărie PDF Dompdf sau TCPDF pentru etichete.
Care sunt erorile comune la integrare GLS și cum le evităm?
Top 7 capcane văzute la clienți care veneau de la alte agenții: 1) Bearer token de sandbox lăsat în producție — generezi AWB test care nu intră niciodată la GLS, comenzile rămân blocate. 2) Webhook status events nu validează signature și nu e idempotent — primești update Delivered de două ori și marchezi comanda incasată dublu. 3) Lipsă retry / queue pe POST AWB — dacă GLS răspunde 503 la peak, comanda rămâne fără AWB și operatorul descoperă a doua zi. 4) ParcelShop ID hardcodat sau cache vechi — clientul alege un punct care s-a închis între timp și coletul nu poate fi livrat. 5) FlexDeliveryService time window setat greșit (UTC vs local) — clientul așteaptă 14:00-15:00 dar curierul vine 17:00-18:00. 6) Eticheta ZPL generată cu encoding greșit pe imprimante Zebra GK420 — caractere românești corupte, AWB respins la centrul GLS. 7) Status mapping greșit între GLS și WooCommerce — comenzi rămân „Processing” după ce au fost deja livrate. Toate acestea le acoperim default în integrarea noastră.
Ce suport tehnic primesc după go-live? Cine se ocupă dacă GLS schimbă API-ul?
Inclus în orice tarif: 30 zile suport bug-uri post-livrare (fix-uri gratuite pentru orice problemă cauzată de integrarea noastră), documentație scrisă cu Bearer token, endpoint-uri, exemple payload AWB și diagrama webhook status events. Opțional, pachet mentenanță 30-80€/lună care include: monitoring webhook status (alertă dacă GLS trimite events și serverul tău nu răspunde 200 în 30 secunde), update-uri când GLS lansează versiuni noi API REST (rare, 1-2 ori pe an), sincronizare automată ParcelShop locații la deschideri / închideri, intervenții urgente sub 4h în timp lucrător. Schimbări majore API (ex: migrare de la v1 la v2) care necesită refacere mare: facturate ca proiect mic (200-500€). Documentația permite oricărui dev PHP/Node să intervină — nu te legăm doar de noi.
Când NU e potrivit GLS România și să aleg alt curier?
Câteva scenarii unde recomandăm alternative: 1) Cumpărătorii tăi preferă lockere 24/7 cu acces non-stop fără program magazin — Sameday easybox e mai potrivit cu 3000+ locații. 2) Vinzi colete grele (>30 kg) sau gabarit mare (paleti, mobilă) — Cargus sau FAN Courier au tarife mai bune pe segment. 3) Vinzi internațional EU cu volum constant — GLS European Parcel are tarife OK dar DHL Parcel sau DPD International pot fi mai ieftine pe rute specifice. 4) Ai magazin foarte mic (<20 expedieri/lună) — soluții agregator tip Innoship sau eAwb îți dau acces la 5-7 curieri fără contracte separate, ești mai flexibil. 5) Livrezi produse cu temperatură controlată (alimente proaspete, farmacie) — ai nevoie de curier specializat tip Fresh sau curierat propriu refrigerat. GLS rămâne cea mai bună alegere pentru e-commerce RO standard cu mix ParcelShop + door-to-door și volum 100-5000 colete/lună.
Trimite-ne stack-ul tău (WooCommerce / Shopify / Next.js / custom) și volumul lunar de expedieri. Primești ofertă scrisă cu timeline și preț în 4 ore. Plus check tehnic gratuit dacă ai deja altă integrare cu probleme.