API trackingAWB

Autentificare

Pentru endpoint-urile de scriere trimite cheia ca Bearer token:

Authorization: Bearer YOUR_API_KEY

GET /api/v1/tracking/{uuid}, rankings și performance rămân publice (rate limit pe IP).

Tracking — creează / sincronizează

curl -X POST https://www.trackingawb.ro/api/v1/tracking \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "awb": "CV09917839610",
    "carrier": "posta",
    "merchant_reference": "WC-1042",
    "customer_email": "client@example.com"
  }'

Răspunsul include uuid, short_code, short_url, merchant_reference, status normalizat și, când sunt rezolvate, obiectele origin / destination.

merchant_reference = ID comandă din magazin (ex. WooCommerce). Folosește short_url în emailul către client.

WooCommerce

Instalează pluginul din folderul integrations/woocommerce-trackingawb (ZIP), pune cheia API din Admin → Chei API, și lasă pluginul de curier (DPD, Cargus etc.) să creeze AWB-ul. trackingAWB preia AWB-ul și pune linkul scurt în emailuri.

La checkout, pluginul poate sorta metodele de livrare după scorul local TrackingAWB (doar curierii activați în setări) și marchează „Recomandat” pe primul loc.

Documentație API: /api-documentatie

Recomandare curier (checkout)

Endpoint public (fără API key), folosit de pluginul WooCommerce:

GET /api/v1/recommend/courier?city=Cluj-Napoca&county=CJ&carriers[]=dpd&carriers[]=cargus&period=30d&delivery_type=home

Rezolvă orașul după nume (+ județ/cod auto), filtrează pe carriers[] și returnează recommended plus ranking-ul sortat după scor. Dacă orașul nu e găsit, face fallback pe județ.

Citește o expediere

GET /api/v1/tracking/{uuid}

Refresh

POST /api/v1/tracking/{uuid}/refresh
Authorization: Bearer YOUR_API_KEY

Short URL

Fiecare expediere primește un cod scurt. Link public: https://www.trackingawb.ro/t/{short_code} (redirect către pagina de tracking).

Alte endpoint-uri publice

• GET /api/v1/rankings/couriers
• GET /api/v1/recommend/courier
• GET /api/v1/performance/cities/{slug}
• GET /api/v1/performance/carriers/{slug}
• GET /api/v1/performance/routes