Το επίσημο, δωρεάν πρόσθετο που συνδέει το κατάστημά σας με την DK Express. Εκδίδετε, τυπώνετε, ακυρώνετε και παρακολουθείτε τα vouchers σας μέσα από την παραγγελία, χωρίς να ανοίξετε άλλη σελίδα.
Τα πεδία έρχονται συμπληρωμένα από την παραγγελία: δέματα, βάρος, αντικαταβολή, σχόλια.
Η παραγγελία γίνεται «Ολοκληρωμένη» και το voucher εκδίδεται μόνο του, με εξαιρέσεις ανά τρόπο πληρωμής ή αποστολής.
A4, Single PDF, θερμικές ετικέτες 100x150 και 100x170, και πολλά vouchers σε ένα PDF.
Οι παραγγελίες σημειώνονται παραληφθείσες ή παραδομένες με την πραγματική ώρα παράδοσης.
Αττική με το δίκτυο DK, αυθημερόν όπου το ορίζετε, Ελλάδα και Κύπρος μέσω ACS, αυτόματα από τον ΤΚ.
Προπληρωμένο voucher επιστροφής μαζί με την αποστολή, για εύκολες αλλαγές.
Για καταστήματα που στέλνουν από περισσότερες αποθήκες, με επιλογή ανά παραγγελία.
Δοκιμάστε με δοκιμαστικά στοιχεία πριν περάσετε σε κανονική λειτουργία.
Shortcodes, filters και actions, υποστήριξη HPOS και WooCommerce Fulfillments.
Κατεβάστε το zip από το GitHub και ανεβάστε το από Πρόσθετα → Προσθήκη νέου.
Στο WooCommerce → DK Express → Λογαριασμοί, με τα στοιχεία που σας δίνουμε.
Ανοίξτε μια παραγγελία και πατήστε «Δημιουργία voucher».
Χρειάζεστε WordPress 5.8 ή νεότερο, WooCommerce και PHP 7.4 ή νεότερη. Το πρόσθετο είναι δωρεάν και δεν χρειάζεται κλειδί άδειας.
Στην καρτέλα Λογαριασμοί βάζετε τα στοιχεία API που σας έδωσε η DK Express και πατάτε Αποθήκευση. Αν δεν τα έχετε, ζητήστε τα εδώ.
| Πεδίο | Τι βάζετε |
|---|---|
| Όνομα χρήστη | Το UserAlias του API |
| Κωδικός πρόσβασης | Το CredentialValue |
| API key | Το ApiKey |
| Κωδικός πελάτη | Προαιρετικό. Αφήστε το κενό, εκτός αν σας το ζητήσει η DK Express (μορφή 100-0000-0000). |
| Κωδικός βασικής υπηρεσίας | Προαιρετικό. Αν μείνει κενό, η υπηρεσία επιλέγεται αυτόματα από τον ΤΚ (δείτε Ποια υπηρεσία μπαίνει). Αν το συμπληρώσετε, ισχύει για όλες τις αποστολές του λογαριασμού. |
Αν στέλνετε με περισσότερους από έναν λογαριασμούς, για παράδειγμα από δύο αποθήκες, πατήστε (+) Προσθήκη νέου λογαριασμού. Στις Ρυθμίσεις ορίζετε τον προκαθορισμένο, και σε κάθε παραγγελία μπορείτε να διαλέξετε άλλον. Κάθε voucher θυμάται τον λογαριασμό με τον οποίο εκδόθηκε, οπότε η εκτύπωση και η ακύρωση γίνονται πάντα από τον σωστό.
Η καρτέλα Ρυθμίσεις έχει τρεις ενότητες. Τις περισσότερες τις ρυθμίζετε μία φορά.
| Ρύθμιση | Τι κάνει |
|---|---|
| Αυτόματη έκδοση | Όταν μια παραγγελία γίνει «Ολοκληρωμένη», εκδίδεται αυτόματα voucher, αν δεν έχει ήδη. |
| Improved UX | Το νέο πλαίσιο voucher στη σελίδα της παραγγελίας. Είναι ενεργό από την αρχή. Αν το απενεργοποιήσετε, βλέπετε το κλασικό πλαίσιο. |
| Προκαθορισμένος λογαριασμός | Ο λογαριασμός που προτείνεται σε κάθε νέο voucher. |
| Προκαθορισμένο μέγεθος εκτύπωσης | Το μέγεθος χαρτιού που επιλέγεται αυτόματα (A4, 100x150, 100x170 κ.λπ.). |
| Προκαθορισμένο βάρος (kg) | Το βάρος που χρησιμοποιείται όταν τα προϊόντα δεν έχουν βάρος. |
| Προκαθορισμένο βάρος ανά προϊόν (kg) | Εναλλακτικά, ένα βάρος για κάθε γραμμή της παραγγελίας, όταν τα προϊόντα δεν έχουν βάρος. |
| Απενεργοποίηση ογκομετρικού βάρους | Από προεπιλογή, για κάθε προϊόν με διαστάσεις υπολογίζεται μήκος × πλάτος × ύψος (cm) / 5000 και κρατιέται το μεγαλύτερο από πραγματικό και ογκομετρικό βάρος. Με αυτή τη ρύθμιση μετράει μόνο το πραγματικό. |
| Απενεργοποίηση σε τρόπους πληρωμής / αποστολής | Η αυτόματη έκδοση παραλείπει παραγγελίες με αυτούς τους τρόπους, π.χ. παραλαβή από το κατάστημα. Η χειροκίνητη έκδοση δεν επηρεάζεται. |
| Τρόποι αποστολής αυθημερόν (051) | Οι τρόποι αποστολής του καταστήματος που σημαίνουν παράδοση αυθημερόν στην Αττική. |
| ΤΚ Αττικής εκτός δικτύου | ΤΚ της Αττικής που δεν εξυπηρετεί το δίκτυο της DK Express, χωρισμένοι με κόμμα. Πιάνει και τα πρώτα ψηφία: το 180 πιάνει 18010, 18020 κ.λπ. |
| Δοκιμαστικό περιβάλλον | Τα νέα vouchers εκδίδονται στο δοκιμαστικό περιβάλλον, με τα δοκιμαστικά στοιχεία API που σας δίνουμε. Κάθε voucher θυμάται πού εκδόθηκε, οπότε εκτύπωση, ακύρωση και παρακολούθηση δουλεύουν και αφού το απενεργοποιήσετε. |
| Αποσφαλμάτωση | Καταγράφει κάθε κλήση προς την DK Express στο WooCommerce → Κατάσταση → Αρχεία καταγραφής (dkexpress-for-woocommerce). Κωδικοί και API key δεν καταγράφονται ποτέ. Ενεργοποιήστε την μόνο όταν ψάχνετε κάποιο πρόβλημα. |
Το βάρος που στέλνεται είναι τουλάχιστον 1 kg και μοιράζεται εξίσου στα δέματα. Η καρτέλα Εργαλεία (εξαγωγή παραγγελιών) εμφανίζεται μόνο αν έχετε εγκατεστημένο και το Web Expert Order Tracking.
Ανοίγετε την παραγγελία και στα δεξιά βλέπετε το πλαίσιο DK Express. Τα πεδία είναι ήδη συμπληρωμένα και συνήθως αρκεί ένα κλικ στο Δημιουργία voucher.
Στην DK Express στέλνονται επίσης ο αριθμός παραγγελίας ως αναφορά, τα στοιχεία αποστολής και τα τηλέφωνα του πελάτη. Αποστολές γίνονται σε Ελλάδα και Κύπρο. Αν η DK Express απορρίψει την αποστολή, για παράδειγμα επειδή λείπει διεύθυνση ή ΤΚ, βλέπετε ακριβώς το μήνυμά της και δεν δημιουργείται τίποτα.
Κάθε παραγγελία έχει ένα ενεργό voucher τη φορά. Αν πατηθεί ξανά «Δημιουργία» (διπλό κλικ, δύο καρτέλες), το πρόσθετο δεν στέλνει δεύτερη αποστολή. Για νέο voucher, ακυρώστε πρώτα το παλιό.
Το πρόσθετο επιλέγει την υπηρεσία αυτόματα, από τον ΤΚ του παραλήπτη και τον τρόπο αποστολής της παραγγελίας.
| Προορισμός | Υπηρεσία | Ποιος παραδίδει |
|---|---|---|
| Αττική (ΤΚ 10000–19999) | 111 Εντός πόλης | Το δίκτυο της DK Express |
| Αττική, με τρόπο αποστολής αυθημερόν | 051 Αυθημερόν | Το δίκτυο της DK Express |
| Υπόλοιπη Ελλάδα και Κύπρος | 211 Επόμενη μέρα | Η ACS, για λογαριασμό της DK Express |
| ΤΚ Αττικής που έχετε δηλώσει εκτός δικτύου | 211 | Η ACS |
Για το 051 ορίζετε στις Ρυθμίσεις ποιοι τρόποι αποστολής του καταστήματος είναι αυθημερόν. Η υπηρεσία αυθημερόν πρέπει να είναι ενεργή και στον λογαριασμό σας στην DK Express. Αν έχετε συμπληρώσει κωδικό υπηρεσίας στον λογαριασμό, αυτός υπερισχύει της αυτόματης επιλογής.
Μόλις εκδοθεί το voucher, το πλαίσιο δείχνει τον αριθμό του και το κουμπί Εκτύπωση voucher. Το PDF ανοίγει σε νέα καρτέλα. Αν ο browser μπλοκάρει το αναδυόμενο παράθυρο, εμφανίζεται σύνδεσμος για να το ανοίξετε.
Με το Ακύρωση voucher η αποστολή ακυρώνεται και στην DK Express, όχι μόνο στο κατάστημα, και ο διανομέας δεν έρχεται να την παραλάβει. Δέματα, βάρος και σχόλια μένουν στο πλαίσιο, οπότε ένα νέο voucher θέλει δύο κλικ.
Αν η αποστολή έχει ήδη ακυρωθεί από την πλατφόρμα της DK Express, η ακύρωση από το κατάστημα απλώς καθαρίζει την παραγγελία. Το Επαναφορά εργασίας (μόνο τοπικά), στο μενού ⋯ του πλαισίου, καθαρίζει την παραγγελία χωρίς να ειδοποιήσει την DK Express. Χρησιμοποιήστε το μόνο αν ξέρετε ότι η αποστολή δεν ισχύει πια.
Δύο φορές την ημέρα το πρόσθετο ελέγχει την πορεία κάθε αποστολής που δεν έχει παραδοθεί, για vouchers των τελευταίων 90 ημερών. Για να γίνεται αυτό πρέπει να λειτουργεί το WP-Cron του ιστότοπου. Για άμεση ενημέρωση μιας παραγγελίας, πατήστε ανανέωση στο πλαίσιο voucher.
| Κωδικός | Τι σημαίνει | Τι κάνει το πρόσθετο |
|---|---|---|
| 15 | Το δέμα παραλήφθηκε από το κατάστημα | Σημειώνει την παραγγελία ως «παραλήφθηκε» |
| 24 | Βγήκε για διανομή | Το εμφανίζει στο πλαίσιο |
| 28 | Αποτυχία παράδοσης (π.χ. απουσία) | Σημειώνει την αποτυχία. Αν ακολουθήσει παράδοση, ισχύει η παράδοση |
| 29 | Παραδόθηκε | Σημειώνει την παραγγελία ως παραδομένη με την πραγματική ημερομηνία και ώρα, και σταματά να την ελέγχει |
Στις αντικαταβολές η DK Express καταχωρεί ξανά κωδικό 29 όταν σας αποδίδει το ποσό. Ως ημερομηνία παράδοσης κρατιέται πάντα η πρώτη, που είναι η πραγματική παράδοση.
Ο πελάτης σας βλέπει στο Ο λογαριασμός μου → Παραγγελίες ένα κουμπί Κατάσταση αποστολής, που ανοίγει την αναζήτηση αποστολής με τον αριθμό ήδη συμπληρωμένο.
Κάθε voucher καταγράφεται ως «εργασία» στο μενού Εργασίες του WordPress. Εκεί βλέπετε όλα τα vouchers μαζί: παραγγελία, κατάσταση, αριθμό voucher με την τελευταία κίνηση, κουμπιά εκτύπωσης (A4, 100x150) και ακύρωσης. Επιλέγοντας πολλές εργασίες έχετε δύο μαζικές ενέργειες:
Αν έχετε εγκατεστημένο το Web Expert Order Tracking, η λίστα είναι η δική του και τα vouchers της DK Express εμφανίζονται εκεί μαζί με των άλλων courier.
Το πρόσθετο ενημερώνεται όπως όλα τα πρόσθετα του WordPress. Όταν κυκλοφορεί νέα έκδοση, εμφανίζεται στα Πρόσθετα μέσα σε 12 ώρες το πολύ και την εγκαθιστάτε με «Ενημέρωση τώρα», ή αυτόματα αν έχετε ενεργές τις αυτόματες ενημερώσεις. Για άμεσο έλεγχο, πατήστε Έλεγχος για ενημερώσεις κάτω από το όνομα του πρόσθετου.
Οι ρυθμίσεις και τα vouchers σας δεν επηρεάζονται. Τις αλλαγές κάθε έκδοσης τις βρίσκετε στη σελίδα Releases.
| Τι βλέπετε | Τι κάνετε |
|---|---|
| «Login Failed» ή «Unauthorized Error» | Λάθος στοιχεία API. Ελέγξτε όνομα χρήστη, κωδικό και API key στην καρτέλα Λογαριασμοί. |
| Μήνυμα στη δημιουργία, π.χ. «Zip code of consignee is required» | Η DK Express δεν δέχτηκε τα στοιχεία. Διορθώστε τη διεύθυνση της παραγγελίας και δοκιμάστε ξανά. |
| «Η παραγγελία έχει ήδη το voucher…» | Υπάρχει ήδη ενεργό voucher. Ακυρώστε το πρώτα αν θέλετε νέο. |
| Η εκτύπωση δεν ανοίγει | Ο browser μπλόκαρε το αναδυόμενο παράθυρο. Επιτρέψτε τα αναδυόμενα για το διαχειριστικό του καταστήματος. |
| Η κατάσταση δεν αλλάζει | Πατήστε «ανανέωση» στο πλαίσιο. Αν ενημερώνεται μόνο χειροκίνητα, ελέγξτε ότι λειτουργεί το WP-Cron. |
Για οτιδήποτε άλλο, ενεργοποιήστε την Αποσφαλμάτωση, επαναλάβετε την ενέργεια και στείλτε μας το αρχείο dkexpress-for-woocommerce από το WooCommerce → Κατάσταση → Αρχεία καταγραφής.
| Shortcode | Τι εμφανίζει |
|---|---|
[dkexpress_track_form] | Φόρμα αναζήτησης voucher που ανοίγει την αναζήτηση του dkexpresscourier.gr |
[dkexpress_track_status order_id="123"] | Την τελευταία κατάσταση της αποστολής |
[dkexpress_track_checkpoints order_id="123"] | Ολόκληρη τη διαδρομή |
Τα δύο τελευταία δέχονται και voucher_no="..." αντί για order_id.
| Filter | Ορίσματα | Για τι |
|---|---|---|
dkexpress_custom_voucher | $data, $args | Το σώμα της αποστολής πριν σταλεί στην DK Express |
dkexpress_basic_service | $service, $order, $country, $postcode | Η υπηρεσία (111 / 211 / 051) |
dkexpress_voucher_custom_comments | $comments, $order_id | Τα σχόλια του voucher |
dkexpress_custom_order_total_weight | $weight, $order | Το βάρος που υπολογίστηκε από τα προϊόντα |
dkexpress_disable_on_custom_hook | false, $order | true = χωρίς αυτόματη έκδοση για την παραγγελία |
webexpert_custom_telephone, webexpert_custom_telephone_1 | $phone, $order | Τηλέφωνο και κινητό παραλήπτη |
dkexpress_order_tracking_change_url | $url, $order | Το link παρακολούθησης που βλέπει ο πελάτης |
| Action | Ορίσματα | Πότε |
|---|---|---|
dkexpress_voucher_created | $order, $job_id | Μόλις εκδοθεί voucher |
dkexpress_voucher_order_picked | $order, $voucher_no | Η DK Express παρέλαβε το δέμα (15) |
dkexpress_voucher_order_rejected | $order, $voucher_no | Αποτυχία παράδοσης (28) |
dkexpress_voucher_order_delivered | $order, $voucher_no | Παραδόθηκε (29) |
Η παράδοση καταγράφεται και στην παραγγελία: _webexpert_order_tracking_delivered = 1 και _webexpert_order_tracking_delivered_timestamp = ημερομηνία και ώρα παράδοσης (ώρα ιστότοπου). Ο αριθμός voucher είναι στο _shipping_tracking_number. Το πρόσθετο υποστηρίζει HPOS και τα Fulfillments του WooCommerce.
Μιλήστε με την ομάδα μας για στοιχεία API, δοκιμαστικό περιβάλλον ή οποιοδήποτε πρόβλημα στην εγκατάσταση.
