WooCommerce Integration

Ενσωματώστε το CourierHub με το WooCommerce store σας

📋 Γενικά

Η ενσωμάτωση WooCommerce του CourierHub σας επιτρέπει να αυτοματοποιήσετε τη δημιουργία voucher και να παρακολουθείτε τις αποστολές σας σε πραγματικό χρόνο.

✅ Προαπαιτούμενα

✓ Ενεργός λογαριασμός CourierHub
✓ WooCommerce store με τα τελευταία updates
✓ Πρόσβαση στο WooCommerce admin panel
✓ Βασικές γνώσεις API

🔧 Βήμα 1: Αποκτήστε το Webhook URL

Πηγαίνετε στο dashboard του CourierHub και βρείτε το webhook URL που δημιουργήθηκε για το store σας:

Συνδεθείτε στο CourierHub Admin
Πηγαίνετε στο "Ρυθμίσεις" → "Ενσωματώσεις"
Αναζητήστε την ενότητα WooCommerce
Αντιγράψτε το Webhook URL

WEBHOOK URL FORMAT:

https://api.courierhub.gr/webhooks/woocommerce/[your-api-key]

⚙️ Βήμα 2: Ρύθμιση WooCommerce Webhooks

Γρήγορη πρόσβαση: Πεδία φόρμας (παράδειγμα)

Στο WooCommerce admin panel, προσθέστε το webhook URL:

Στο WooCommerce Admin:

Πηγαίνετε στο WooCommerce → Ρυθμίσεις → API
Κάντε κλικ στην καρτέλα Webhooks
Κάντε κλικ στο κουμπί Προσθήκη Webhook
Συμπληρώστε τα παρακάτω:
- Όνομα: CourierHub Orders
- Webhook URL: (επικολλήστε το URL από το Βήμα 1)
- Topic: Ταξινόμηση ανά συμβάν
- Ενεργό: Ναι
Κάντε κλικ Αποθήκευση Webhook

Πεδία φόρμας (παράδειγμα)

Όνομα	CourierHub Orders
Κατάσταση	Ενεργοποιημένο
Θέμα / Topic	Η Παραγγελία Δημιουργήθηκε (orders/create) ή Η Παραγγελία Ενημερώθηκε (orders/updated) — επιλέξτε τα events που αντιστοιχούν σε δημιουργία/επικαιροποίηση
URL Παράδοσης	https://api.courierhub.gr/webhooks/woocommerce/[your-api-key]
Μυστικός Κωδικός	Το αφήνετε κενό - θα δημιουργήσει το woocommerce δικό του κωδικό
Έκδοση API	Χρησιμοποιήστε την τελευταία σταθερή έκδοση του WooCommerce API

Συμβουλή: Αν το WooCommerce εμφανίζει επιλογές με ελληνικά labels (π.χ. "Η Παραγγελία Δημιουργήθηκε"), αντιστοιχίστε τα στα events orders/create και orders/updated αντίστοιχα.

📡 Βήμα 3: Επιλέξτε τα Γεγονότα

Επιλέξτε τα γεγονότα που θέλετε να παρακολουθείτε:

Συνιστώμενα Γεγονότα

order.created
order.updated

Σημαντική Σημείωση

Αποδεχόμαστε μόνο τα webhooks: order.created και order.updated. Άλλα γεγονότα δεν θα επεξεργαστούν από το CourierHub.

🧪 Βήμα 4: Δοκιμή

Δοκιμάστε την ενσωμάτωση:

📌 Σημαντικό:

Πηγαίνετε στο WooCommerce admin, επιλέξτε ένα webhook και κάντε κλικ "Δοκιμή" για να δοκιμάσετε τη σύνδεση.

🔁 Εναλλακτική Σύνδεση (API Polling & Χειροκίνητο)

Αν αντιμετωπίζετε προβλήματα με τα webhooks, υπάρχει εναλλακτική μέθοδος όπου το CourierHub τραβάει παραγγελίες μέσω API σε τακτά διαστήματα. Οι διαθέσιμες συχνότητες polling είναι:

1 λεπτό
5 λεπτά
15 λεπτά
30 λεπτά
60 λεπτά (1 ώρα)
2 ώρες
4 ώρες
8 ώρες

Υπάρχει επίσης κουμπί για χειροκίνητο συγχρονισμό στο dashboard, για άμεση άντληση παραγγελιών όποτε χρειαστείτε επανεξέταση ή επαναφορά μετά από μία αποτυχία webhook.

Σημείωση: Η μέθοδος polling χρησιμοποιεί API credentials και μπορεί να έχει μικρή καθυστέρηση σε σύγκριση με webhooks.

📚 Δεδομένα Γεγονότων

Το CourierHub αναμένει τα παρακάτω δεδομένα από κάθε παραγγελία:

{
  "order_id": "12345",
  "customer_email": "customer@example.com",
  "customer_name": "Ονοματεπώνυμο",
  "shipping_address": {
    "first_name": "Όνομα",
    "last_name": "Επώνυμο",
    "address_1": "Διεύθυνση",
    "city": "Πόλη",
    "postal_code": "15125",
    "country": "GR"
  },
  "items": [
    {
      "product_id": "789",
      "name": "Προϊόν",
      "quantity": 1,
      "price": 10.00
    }
  ],
  "total": 10.00,
  "status": "processing"
}

🔍 Αντιμετώπιση Προβλημάτων

❌ Τα webhooks δεν στέλνονται

Ελέγξτε ότι το webhook URL είναι σωστό
Βεβαιωθείτε ότι το webhook είναι ενεργό
Ελέγξτε τα Woocommerce logs: wp-content/uploads/wc-logs/

❌ Τα voucher δεν δημιουργούνται

Ελέγξτε ότι η παραγγελία περιέχει τη διεύθυνση αποστολής
Βεβαιωθείτε ότι έχετε χρηματικό υπόλοιπο στο CourierHub

❌ Σφάλμα αυθεντικοποίησης

Ανα-δημιουργήστε το API key στο CourierHub
Ενημερώστε το webhook URL με το νέο κλειδί
Δοκιμάστε ξανά τη σύνδεση

💡 Καλές Πρακτικές

→ Παρακολούθηση Webhooks: Ελέγξτε τακτικά τα logs του WooCommerce για αποτυχίες
→ Δοκιμάστε Πρώτα: Χρησιμοποιήστε ένα staging environment πριν το production
→ Ασφάλεια: Κρατήστε το API key σας ασφαλές και μυστικό
→ Updates: Κρατήστε το WooCommerce ενημερωμένo

📞 Χρειάζεστε Βοήθεια;

Μπορείτε να μας καλέσετε στο 2122135221 ή να μας στείλετε mail στο info@jksoftware.gr