Sfaturi practice pentru integrarea curierilor și generarea automată de AWB
Un flux bine configurat pentru curieri reduce pașii repetați dintre confirmarea comenzii și predarea coletului. Dacă vrei să înțelegi cum integrezi curierii și generezi AWB automat în magazinul online, punctul de plecare nu este simpla afișare a unei metode de livrare în checkout, ci conectarea coerentă a comenzii, a datelor logistice și a sistemului curierului.
Automatizarea poate prelua informațiile deja existente în comandă, le poate valida, apoi poate trimite cererea de expediție către serviciul ales. La final, magazinul poate păstra numărul AWB, eticheta de transport și, în funcție de integrare, evenimentele de tracking. Astfel, operatorul lucrează cu un proces controlat, nu cu copiere manuală de date între mai multe interfețe.
Ce presupune, de fapt, generarea automată a unui AWB
AWB-ul este documentul sau eticheta asociată unei expediții. Numărul înscris pe acesta este folosit pentru identificarea coletului și pentru urmărirea parcursului său. Un număr de tracking poate fi comunicat clientului, însă generarea lui nu trebuie confundată cu simpla selectare a opțiunii de livrare la finalizarea comenzii.
Într-un flux automatizat, o comandă devine eligibilă pentru expediere la un moment stabilit de magazin. Sistemul verifică datele, creează expediția prin API, primește răspunsul curierului și salvează rezultatul în comandă. Răspunsul poate include numărul AWB, un identificator al expediției, eticheta disponibilă pentru descărcare sau tipărire și, dacă apar probleme, un mesaj de eroare.
Automatizarea nu trebuie neapărat să fie lipsită de intervenție umană. Pentru anumite operațiuni, varianta potrivită poate fi una semi-automată: operatorul verifică comanda și confirmă explicit crearea AWB-ului. Această abordare este utilă atunci când stocul, plata, greutatea finală sau disponibilitatea produselor trebuie validate înainte de predare.
Integrare directă cu un curier sau prin agregator
Alegerea arhitecturii influențează modul în care administrezi livrările pe termen lung. În linii mari, ai două opțiuni: conectare directă la API-ul fiecărui curier sau conectare la un agregator care reunește mai multe servicii de livrare într-o singură interfață.
Opțiunea A: integrarea directă prin API-ul curierului
Integrarea directă poate avea sens când magazinul lucrează predominant cu un singur curier sau când are nevoie de opțiuni specifice oferite de acel serviciu. Configurarea urmărește cerințele API-ului respectiv: autentificare, valori acceptate pentru localități și servicii, date despre colet, ramburs, retur sau punct de livrare, acolo unde acestea sunt disponibile contractual.
Avantajul este controlul mai apropiat asupra regulilor și opțiunilor curierului. În schimb, când sunt utilizați mai mulți curieri, fiecare conexiune poate avea propriile credențiale, reguli de validare, actualizări și situații de eroare care trebuie gestionate separat.
Opțiunea B: un agregator de livrări
Un agregator poate fi potrivit dacă magazinul expediază prin mai multe servicii și are nevoie de administrare centralizată. În locul unor implementări distincte pentru fiecare API, magazinul transmite comenzile către un singur punct de integrare, în măsura în care serviciile dorite sunt disponibile prin acel agregator.
Totuși, înainte de alegere, verifică funcțiile necesare în fluxul real: ramburs, livrare la adresă, locker sau punct de ridicare, etichete, retururi, tracking, anulări și mecanismul de actualizare a statusurilor. O interfață unificată nu înseamnă automat că toate opțiunile fiecărui curier sunt gestionate în același mod.
Informațiile care trebuie validate înainte de creare
Un AWB automat depinde de calitatea datelor din comandă. Dacă un câmp obligatoriu lipsește sau are un format neacceptat, cererea poate fi respinsă. Denumirile câmpurilor și valorile admise diferă între API-uri, așadar documentația serviciului de curierat rămâne reperul tehnic pentru implementare.
- Datele expeditorului: denumire, adresă, persoană de contact, telefon și identificatorii solicitați de curier.
- Datele destinatarului: nume, telefon, adresă, localitate, județ și cod poștal când este necesar.
- Datele coletului: greutate, număr de colete, conținut și, dacă sunt cerute, dimensiuni sau valoare declarată.
- Datele comerciale: referința comenzii, valoarea rambursului, moneda și regula de plată a transportului.
- Opțiunile logistice: livrare la adresă, locker, punct de ridicare, retur, notificări sau alte servicii suportate.
Validarea trebuie să se facă înainte de apelul API. De exemplu, o comandă plătită online nu ar trebui transmisă cu ramburs, iar o comandă anulată sau deja expediată nu trebuie să declanșeze încă o creare de AWB. Aceste reguli simple reduc corecțiile manuale și riscul de documente duplicate.
Un flux tehnic sigur, de la comandă la etichetă
Momentul declanșării este una dintre cele mai importante decizii. Pentru unele magazine, AWB-ul poate fi creat după confirmarea comenzii. Pentru altele, triggerul poate fi validarea plății, schimbarea într-un status operațional sau o acțiune manuală din administrare. Generarea pentru orice comandă nouă, fără verificări, poate produce expediții inutile.
- Comanda ajunge într-un status eligibil pentru pregătire.
- Sistemul verifică destinatărul, adresa, telefonul, greutatea, plata și metoda de livrare.
- Este verificată existența unui AWB anterior pentru aceeași comandă.
- Integrarea trimite cererea către serviciul selectat, folosind autentificarea configurată.
- Răspunsul primit este salvat în comandă: AWB, identificatorul expediției, eticheta și eventualele erori.
- Operatorul poate descărca sau tipări eticheta, iar comanda trece în statusul intern potrivit.
Verificarea AWB-ului existent este esențială pentru controlul duplicatelor. La reîncercare după un timeout sau un răspuns neclar, integrarea ar trebui să poată determina dacă expediția a fost totuși creată. Logurile cu cereri, răspunsuri și erori ajută echipa să investigheze situațiile fără a pierde contextul operațional.
Configurarea metodelor de livrare în CS-Cart
În CS-Cart, metoda afișată clientului în checkout trebuie corelată cu serviciul care va crea expediția. Configurarea poate include zonele de livrare, disponibilitatea metodei pentru anumite adrese și asocierea cu integrarea API corespunzătoare. Opțiunile precum rambursul, livrarea la adresă sau la punct de ridicare trebuie tratate conform posibilităților serviciului ales.
La fel de importantă este maparea statusurilor. Stabilește clar ce status al comenzii permite generarea AWB-ului și ce status se aplică după ce expediția este creată cu succes. Pentru magazinele cu mai multe roluri operaționale, permisiunile trebuie să delimiteze cine vede datele expediției, cine poate genera documente și cine poate relua un proces eșuat.
Pentru detalii despre opțiunile disponibile pentru platformă, poți analiza pagina dedicată integrărilor de curieri și AWB pentru CS-Cart. Înainte de activarea în producție, este recomandată testarea pe comenzi de test sau într-un mediu controlat, inclusiv pentru scenarii cu ramburs, plata online, locker, retur, anulare și mai multe colete.
Eticheta, notificarea și actualizarea statusului
Numărul AWB și eticheta de transport nu sunt același lucru. Numărul identifică expediția, în timp ce eticheta este documentul utilizat pentru pregătirea fizică a coletului. Înainte de tipărire, operatorul ar trebui să poată verifica informațiile afișate: expeditor, destinatar, serviciu selectat, colet și ramburs, dacă este cazul.
Notificarea clientului cu AWB-ul sau un link de tracking ar trebui trimisă după confirmarea reală a creării expediției. În plus, accesul la etichete și datele de livrare trebuie limitat în zona de administrare, deoarece documentele conțin date personale.
Statusul comenzii din magazin și statusul transportului sunt informații diferite. Curierul poate raporta evenimente precum preluare, tranzit, livrare nereușită, livrare sau retur, iar integrarea le poate mapa la statusuri interne. Actualizarea poate veni prin webhook, interogare periodică a API-ului sau intervenție manuală. Este util să eviți suprascrierea unui status final cu un eveniment mai vechi primit ulterior.
Erori frecvente care merită prevenite
- Adresă incompletă, localitate neacceptată, telefon invalid sau cod poștal lipsă.
- Greutate lipsă sau zero, unități de măsură greșite ori număr incorect de colete.
- Ramburs adăugat unei comenzi deja plătite sau monedă neacceptată.
- Credențiale expirate, acces API insuficient, indisponibilitate temporară sau timeout.
- Reîncercarea necontrolată a unei cereri și crearea mai multor AWB-uri pentru aceeași expediție.
- Lipsa unei evidențe clare a erorilor și a pașilor necesari pentru corectare.
O listă de validări vizibile pentru operator și un istoric al încercărilor fac diferența între un flux care doar trimite date și unul care poate fi administrat în condiții reale de lucru.
Ce soluție se potrivește magazinului tău
Decizia nu ține doar de numărul de comenzi. Analizează câți curieri folosești, cine generează expediția, ce opțiuni trebuie păstrate în checkout, cum gestionezi retururile și dacă ai nevoie de actualizare automată a trackingului. Pentru un marketplace, este necesar să stabilești dinainte dacă AWB-ul este emis de administrator, de fiecare vânzător sau de o operațiune centralizată.
Verifică și compatibilitatea soluției cu versiunea de CS-Cart, statusurile actuale, checkout-ul și procesul intern de fulfilment. Pagina Curieri & AWB poate fi un punct de plecare pentru evaluarea unei integrări adaptate platformei. Automatizarea utilă este cea care păstrează controlul asupra excepțiilor, nu cea care trimite automat orice comandă spre expediere.
Întrebări frecvente
Ce este un AWB și cu ce diferă de numărul de tracking?
AWB-ul este documentul sau eticheta asociată expediției. Numărul de tracking este identificatorul folosit pentru urmărirea coletului și este, de regulă, înscris pe AWB.
Când ar trebui generat automat AWB-ul?
Momentul potrivit depinde de fluxul magazinului. Poate fi după confirmarea comenzii, validarea plății sau trecerea într-un status operațional, cu condiția ca datele de expediere să fie verificate.
Ce date sunt necesare pentru crearea unui AWB?
Sunt necesare datele expeditorului și destinatarului, adresa, telefonul, informații despre colet, referința comenzii, rambursul dacă există și opțiunea de livrare. Cerințele exacte diferă între API-uri.
Este mai potrivită integrarea directă sau un agregator de livrări?
Integrarea directă poate avea sens pentru un curier principal și opțiuni specifice. Un agregator poate fi util când lucrezi cu mai mulți curieri, dar trebuie verificat suportul pentru serviciile și fluxurile de care ai nevoie.
Cauți Curieri & AWB potrivite pentru nevoile tale?
