Expedieri și curieri
Lockere și puncte de ridicare pe o hartă și într-o listă accesibilă, prețurile curierilor comparate înainte de fiecare AWB, etichetele păstrate cu expedierea și un API public pentru toate.
Curieri
Conectează Sameday, Cargus, DPD, FAN Courier și GLS în Setări → Curieri. Brivio generează AWB-uri doar cu contul tău de curier: un curier neconectat nu produce niciodată un număr fictiv. Expeditorul este mereu firma ta — adresa și telefonul locației principale sau sediul social.
Lockere și puncte de ridicare
Selectorul de puncte de ridicare arată toate easybox-urile, lockerele, magazinele partenere și oficiile curierilor cunoscute de Brivio. Lista se actualizează zilnic de la fiecare curier.
- Caută după localitate, cod poștal din 6 cifre sau stradă, ori folosește Lângă mine (browserul cere întâi permisiunea).
- Filtre: curier, plată cu cardul, deschis non-stop. Când coletul este cu ramburs, apar doar punctele care acceptă numerar; când greutatea este cunoscută, doar punctele care o pot primi.
- Lista este controlul. Este un grup de opțiuni: Tab intră în listă, săgețile trec de la un punct la altul, Space alege. Fiecare punct spune dacă acceptă ramburs — în ambele sensuri, ca „fără etichetă” să nu însemne niciodată „acceptă numerar”.
- Harta stă lângă listă pe ecrane late și în spatele butonului Arată harta pe telefon. Alegerea pe oricare dintre ele le actualizează pe amândouă. Harta vine din arhiva proprie de hărți a Brivio (date OpenStreetMap); când nu este configurată, lista funcționează singură.
Același selector apare în trei locuri:
- Finalizarea comenzii în magazinul online — după ce alege curierul, cumpărătorul poate alege Ridicare din punct în loc de livrare la adresă. Alegerea se salvează pe comandă.
- Comandă → Livrare în aplicație — punctul ales de cumpărător este preselectat; îl poți schimba sau poți trece la livrare la adresă.
- Factură → AWB pentru comenzile din marketplace — lockerul ales de cumpărător pe eMAG sau în magazinul WooCommerce este preselectat când Brivio îl cunoaște.
Înainte de fiecare AWB, Brivio verifică din nou punctul: trebuie să fie încă activ, să aparțină curierului ales, să accepte ramburs când există sumă de încasat și să poată primi greutatea coletului. Un punct care nu trece o verificare este refuzat cu motivul, iar AWB-ul nu se cumpără.
Compară prețurile înainte de AWB
Compară prețurile curierilor întreabă simultan toți curierii conectați și afișează prețul, serviciul și termenul de livrare unul lângă altul. Cel mai ieftin tarif de curier este marcat. Un preț calculat de Brivio (când un curier nu dă ofertă) este etichetat preț estimat și nu este marcat niciodată ca cel mai ieftin. Curierii care nu au răspuns apar sub comparație. Alege un rând și Generează AWB.
Etichete și urmărire
Eticheta AWB se păstrează cu expedierea, deci Descarcă eticheta funcționează și când curierul este lent sau indisponibil. Urmărire cere curierului cele mai noi evenimente și le combină cu cele trimise de el către Brivio. Anulează AWB îl anulează întâi la curier; AWB-urile curierilor care nu permit anularea prin API se anulează din contul de la curier.
Flotă proprie vs curier în timp
Trasee de livrare → Flotă vs curier (/routes/analize) adună traseele finalizate din ultimele 30 sau 90 de zile: cât au costat cu dubele proprii față de cât ar fi cerut curierii conectați pentru aceleași opriri.
- Costul marginal ia în calcul doar ce a adăugat fiecare traseu — combustibil, orele șoferului, taxe de drum și uzură pe km. Costul complet împarte pe zi și amortizarea sau leasingul și asigurările; folosește-l când decizi dacă merită să păstrezi o dubă.
- Cifrele provin din instantaneul salvat când marchezi traseul ca finalizat. Schimbările ulterioare de prețuri sau costuri nu rescriu traseele trecute, iar un traseu nefinalizat nu intră în calcul — fără trasee finalizate, pagina este goală.
- Indicatorii arată ambele totaluri, economia (cu semn), câte trasee a câștigat flota și câte curierul, economia posibilă dacă trimiți câteva opriri prin curier, CO₂ și numărul de opriri de la care flota devine mai ieftină.
- Datele estimate sunt semnalate: partea din costul flotei care nu provine din bonuri sau contracte și traseele care nu au putut fi comparate pentru că lipseau cotațiile curierilor (acestea nu intră în totaluri).
- Traseele unde curierul ar fi fost mai ieftin sunt listate începând cu cea mai mare diferență, fiecare cu link către traseu.
API public
Cu o cheie API cu scope-ul shipping:read (și shipping:write pentru generare sau anulare AWB):
| Metodă | Cale | Ce face |
|---|---|---|
| GET | /v1/shipping-points | Caută puncte: near=lat,lng, city, postal_code sau q, plus courier, cod, card, open_24_7, weight_kg |
| POST | /v1/shipments/quote | Compară toți curierii conectați; nu creează nimic |
| POST | /v1/shipments | Generează un AWB — necesită Idempotency-Key |
| GET | /v1/shipments · /v1/shipments/{id} | Listează și citește expedierile |
| GET | /v1/shipments/{id}/label | Eticheta (PDF; format=zpl pentru imprimante termice) |
| GET | /v1/shipments/{id}/tracking | Urmărire actualizată de la curier |
| POST | /v1/shipments/{id}/cancel | Anulează AWB-ul la curier |
SDK-urile TypeScript și PHP (client.shippingPoints, client.shipments; searchShippingPoints(), quoteShipment(), createShipment()…), CLI-ul (brivio shipping-points search, brivio shipments quote|create|label|track|cancel) și serverul MCP (brivio_search_shipping_points, brivio_quote_shipment, brivio_create_shipment …) oferă aceleași operații. Generarea sau anularea unui AWB prin serverul MCP cere confirmarea ta explicită.