Repository navigation
Home
Το πρόσθετο συνδέει το κατάστημά σας με την DK Express: βγάζετε, τυπώνετε, ακυρώνετε και παρακολουθείτε τα vouchers σας μέσα από την παραγγελία του WooCommerce, χωρίς να ανοίξετε άλλη σελίδα.
Χρειάζεστε WordPress 5.8 ή νεότερο, WooCommerce και PHP 7.4 ή νεότερη. Κλειδί άδειας δεν χρειάζεται, το πρόσθετο είναι δωρεάν.
- Ανοίξτε τη σελίδα Releases και κατεβάστε το αρχείο dkexpress-for-woocommerce.zip. Όχι το «Source code»: εκείνο έχει άλλο όνομα φακέλου.
- Στο WordPress πηγαίνετε Πρόσθετα → Προσθήκη νέου → Μεταφόρτωση πρόσθετου, επιλέξτε το zip και πατήστε Εγκατάσταση.
- Ενεργοποιήστε το πρόσθετο.
Οι ρυθμίσεις βρίσκονται στο WooCommerce → DK Express.
Στην καρτέλα Λογαριασμοί βάζετε τα στοιχεία API που σας έδωσε η DK Express και πατάτε Αποθήκευση. Αν δεν τα έχετε, ζητήστε τα από την DK Express.
| Πεδίο | Τι βάζετε |
|---|---|
| Όνομα χρήστη | Το UserAlias του API |
| Κωδικός πρόσβασης | Το CredentialValue |
| API key | Το ApiKey |
| Κωδικός πελάτη | Προαιρετικό. Αφήστε το κενό εκτός αν σας το ζητήσει η DK Express (μορφή 100-0000-0000) |
| Κωδικός βασικής υπηρεσίας | Προαιρετικό. Αν μείνει κενό, η υπηρεσία επιλέγεται αυτόματα από τον ΤΚ (δείτε «Ποια υπηρεσία μπαίνει»). Αν το συμπληρώσετε, ισχύει για όλες τις αποστολές του λογαριασμού |
Αν στέλνετε με περισσότερους από έναν λογαριασμούς (π.χ. δύο αποθήκες), πατήστε (+) Προσθήκη νέου λογαριασμού. Στις Ρυθμίσεις διαλέγετε ποιος είναι ο προκαθορισμένος, και σε κάθε παραγγελία μπορείτε να διαλέξετε άλλον. Κάθε voucher θυμάται τον λογαριασμό με τον οποίο βγήκε, έτσι η εκτύπωση και η ακύρωση γίνονται πάντα από τον σωστό.
Η καρτέλα Ρυθμίσεις έχει τρεις ενότητες. Τις περισσότερες τις ρυθμίζετε μία φορά και τις ξεχνάτε.
| Ρύθμιση | Τι κάνει |
|---|---|
| Αυτόματη έκδοση | Όταν μια παραγγελία γίνει «Ολοκληρωμένη», βγαίνει voucher μόνο του, αν δεν έχει ήδη |
| Improved UX | Το νέο πλαίσιο voucher στη σελίδα της παραγγελίας. Είναι ενεργό από την αρχή. Αν το απενεργοποιήσετε, βλέπετε το κλασικό πλαίσιο |
| Προκαθορισμένος λογαριασμός DK Express | Ο λογαριασμός που προτείνεται σε κάθε νέο voucher |
| Προκαθορισμένο μέγεθος εκτύπωσης | Το χαρτί που επιλέγεται αυτόματα στην εκτύπωση (A4, 100x150, 100x170 κ.λπ.) |
| Προκαθορισμένο βάρος (kg) | Το βάρος που μπαίνει όταν τα προϊόντα δεν έχουν βάρος |
| Προκαθορισμένο βάρος ανά προϊόν (kg) | Εναλλακτικά: ένα βάρος για κάθε προϊόν (γραμμή) της παραγγελίας, όταν τα προϊόντα δεν έχουν βάρος |
| Απενεργοποίηση υπολογισμού ογκομετρικού βάρους | Χωρίς αυτή, για κάθε προϊόν με διαστάσεις υπολογίζεται μήκος × πλάτος × ύψος (cm) / 5000 και κρατιέται το μεγαλύτερο από πραγματικό και ογκομετρικό βάρος. Με αυτή μετράει μόνο το πραγματικό |
| Απενεργοποίηση έκδοσης σε συγκεκριμένους τρόπους πληρωμής / αποστολής | Η αυτόματη έκδοση παραλείπει τις παραγγελίες με αυτούς τους τρόπους (π.χ. παραλαβή από το κατάστημα). Η χειροκίνητη έκδοση δεν επηρεάζεται |
| Τρόποι αποστολής αυθημερόν (051) | Οι τρόποι αποστολής του καταστήματος που σημαίνουν παράδοση αυθημερόν στην Αττική |
| ΤΚ Αττικής εκτός δικτύου DK Express | ΤΚ της Αττικής που δεν ξευτερώνει το δίκτυο της DK Express, χωρισμένοι με κόμμα. Πιάνει και τα πρώτα ψηφία, π.χ. το 180 πιάνει 18010, 18020 κ.λπ. |
| Δοκιμαστικό περιβάλλον | Τα νέα voucher εκδίδονται στο δοκιμαστικό περιβάλλον της DK Express, με τα δοκιμαστικά στοιχεία API που σας δίνει. Κάθε voucher θυμάται πού εκδόθηκε, οπότε εκτύπωση, ακύρωση και παρακολούθηση δουλεύουν και αφού το απενεργοποιήσετε |
| Αποσφαλμάτωση | Κρατάει κάθε κλήση προς την DK Express στο WooCommerce → Κατάσταση → Αρχεία καταγραφής (dkexpress-for-woocommerce). Κωδικοί και API key δεν γράφονται ποτέ. Ανοίξτε την μόνο όταν ψάχνετε κάποιο πρόβλημα |
Το βάρος που στέλνεται είναι τουλάχιστον 1 kg και μοιράζεται εξίσου στα δέματα. Η καρτέλα Εργαλεία (εξαγωγή παραγγελιών) εμφανίζεται μόνο αν έχετε εγκατεστημένο και το Web Expert Order Tracking.
Ανοίγετε την παραγγελία και στα δεξιά βλέπετε το πλαίσιο DK Express. Τα πεδία έρχονται ήδη συμπληρωμένα και συνήθως αρκεί ένα κλικ στο Δημιουργία voucher.
- Δέματα: πόσα κουτιά στέλνετε. Το βάρος μοιράζεται εξίσου σε όλα.
- Βάρος: υπολογίζεται από τα προϊόντα. Αλλάζει αν το ζυγίσατε και βγήκε διαφορετικό.
- Αντικαταβολή: εμφανίζεται μόνο σε παραγγελίες με αντικαταβολή και έχει το σύνολο της παραγγελίας. Αν αλλάξει το ποσό (π.χ. έβγαλε ένα προϊόν), διορθώστε το εδώ.
- Σχόλια: τυπώνονται στο voucher για τον διανομέα. Έρχονται από τη σημείωση του πελάτη, αν έγραψε κάτι.
- Λογαριασμός: εμφανίζεται μόνο αν έχετε περισσότερους από έναν.
- Προπληρωμένο voucher επιστροφής: αν το τικάρετε, μαζί με το voucher βγαίνει και δεύτερο, για να σας το επιστρέψει ο πελάτης αν χρειαστεί. Το τυπώνετε από το ίδιο πλαίσιο.
Στη DK Express πηγαίνουν επίσης ο αριθμός παραγγελίας (ως αναφορά), τα στοιχεία αποστολής του πελάτη και τα τηλέφωνά του. Αποστολές γίνονται σε Ελλάδα και Κύπρο. Αν η DK Express απορρίψει την αποστολή (π.χ. λείπει διεύθυνση ή ΤΚ), βλέπετε ακριβώς το μήνυμά της και δεν δημιουργείται τίποτα.
Μια παραγγελία έχει ένα ενεργό voucher τη φορά. Αν πατηθεί ξανά «Δημιουργία» (διπλό κλικ, δύο καρτέλες), το πρόσθετο το αρνείται και δεν στέλνει δεύτερη αποστολή. Για νέο voucher, ακυρώστε πρώτα το παλιό.
Με την Αυτόματη έκδοση ενεργή, δεν χρειάζεται ούτε το κλικ: βάζετε την παραγγελία σε «Ολοκληρωμένη» και το voucher βγαίνει με τις προκαθορισμένες τιμές.
Την υπηρεσία την επιλέγει το πρόσθετο μόνο του, από τον ΤΚ του παραλήπτη και τον τρόπο αποστολής της παραγγελίας.
| Προορισμός | Υπηρεσία | Ποιος παραδίδει |
|---|---|---|
| Αττική (ΤΚ 10000–19999) | 111 Εντός πόλης | Το δίκτυο της DK Express |
| Αττική, με τρόπο αποστολής αυθημερόν | 051 Αυθημερόν | Το δίκτυο της DK Express |
| Υπόλοιπη Ελλάδα και Κύπρος | 211 Επόμενη μέρα | Η ACS, για λογαριασμό της DK Express |
| ΤΚ Αττικής που έχετε δηλώσει εκτός δικτύου | 211 | Η ACS |
Για το 051 διαλέγετε στις Ρυθμίσεις ποιοι τρόποι αποστολής του καταστήματος είναι αυθημερόν. Η υπηρεσία αυθημερόν πρέπει να είναι ενεργή και στον λογαριασμό σας στην DK Express. Αν έχετε συμπληρώσει κωδικό υπηρεσίας στον λογαριασμό, αυτός υπερισχύει και η αυτόματη επιλογή δεν γίνεται.
Μόλις βγει το voucher, το πλαίσιο δείχνει τον αριθμό του και το κουμπί Εκτύπωση voucher. Το PDF ανοίγει σε νέα καρτέλα. Αν δεν ανοίξει, ο φυλλομετρητής έκλεισε το αναδυόμενο παράθυρο και εμφανίζεται σύνδεσμος για να το ανοίξετε με το χέρι.
Μεγέθη εκτύπωσης:
- A4 και Single PDF για κανονικό εκτυπωτή (το Single βάζει ένα voucher σε κάθε σελίδα).
- 100x150 και 100x170 για θερμικούς εκτυπωτές ετικετών.
- Τα Clean είναι η ίδια εκτύπωση σε πιο λιτή μορφή, με πολύ μικρότερο αρχείο.
Για να ακυρώσετε ένα voucher πατάτε Ακύρωση voucher. Η αποστολή ακυρώνεται και στην DK Express, όχι μόνο στο κατάστημα, και ο συνεργάτης δεν έρχεται να την πάρει. Τα δέματα, το βάρος και τα σχόλια μένουν στο πλαίσιο, οπότε ένα νέο voucher θέλει δύο κλικ.
Αν η αποστολή έχει ήδη ακυρωθεί από τη σελίδα της DK Express, η ακύρωση από το κατάστημα απλώς καθαρίζει την παραγγελία. Το Επαναφορά εργασίας (μόνο τοπικά), στο μενού ⋯ του πλαισίου, καθαρίζει την παραγγελία χωρίς να ειδοποιήσει την DK Express. Χρησιμοποιήστε το μόνο αν ξέρετε ότι η αποστολή δεν ισχύει πια.
Δύο φορές τη μέρα το πρόσθετο ρωτάει την DK Express που βρίσκεται κάθε αποστολή που δεν έχει παραδοθεί ακόμα, για vouchers των τελευταίων 90 ημερών. Για να γίνεται αυτό, το WP-Cron του ιστοτόπου πρέπει να δουλεύει. Για άμεση ενημέρωση μιας παραγγελίας, πατήστε ανανέωση στο πλαίσιο voucher.
Το πλαίσιο δείχνει όλη τη διαδρομή του δέματος. Αυτά που μετράνε για το κατάστημα:
| Κωδικός DK Express | Τι σημαίνει | Τι κάνει το πρόσθετο |
|---|---|---|
| 15 | Το δέμα παραλήφθηκε από το κατάστημα | Σημειώνει την παραγγελία ως «παραλήφθηκε» |
| 24 | Βγήκε για διανομή | Το δείχνει στο πλαίσιο |
| 28 | Αποτυχία παράδοσης (π.χ. απών) | Σημειώνει την αποτυχία. Αν ακολουθήσει παράδοση, ισχύει η παράδοση |
| 29 | Παραδόθηκε | Σημειώνει την παραγγελία ως παραδομένη με την πραγματική ημερομηνία και ώρα παράδοσης και σταματάει να την ελέγχει |
Στις αντικαταβολές η DK Express βάζει ξανά κωδικό 29 όταν σας αποδίδει το ποσό. Ως ημερομηνία παράδοσης κρατιέται πάντα η πρώτη, που είναι η πραγματική παράδοση.
Ο πελάτης βλέπει στο Ο λογαριασμός μου → Παραγγελίες, στις ολοκληρωμένες παραγγελίες, ένα κουμπί Κατάσταση αποστολής. Ανοίγει την αναζήτηση voucher του dkexpresscourier.gr με τον αριθμό ήδη συμπληρωμένο.
Κάθε voucher καταγράφεται ως «εργασία» στο μενού Εργασίες του WordPress. Εκεί βλέπετε όλα τα vouchers μαζί: την παραγγελία, την κατάσταση, τον αριθμό voucher με την τελευταία κίνησή του, κουμπιά εκτύπωσης (A4, 100x150) και κουμπί ακύρωσης.
Επιλέγοντας πολλές εργασίες έχετε δύο μαζικές ενέργειες:
- Εκτύπωση εργασιών (DK Express): όλα τα vouchers σε ένα PDF, στο προκαθορισμένο μέγεθος. Οι εργασίες πρέπει να είναι από τον ίδιο λογαριασμό DK Express.
- Ακύρωση εργασιών (DK Express): ακυρώνει κάθε voucher και στην DK Express. Αν κάποιο δεν ακυρωθεί, βλέπετε ποιο και γιατί.
Αν έχετε εγκατεστημένο και το Web Expert Order Tracking, η λίστα είναι η δική του και τα vouchers της DK Express εμφανίζονται εκεί μαζί με των άλλων courier.
Το πρόσθετο ενημερώνεται όπως όλα τα πρόσθετα του WordPress. Όταν βγαίνει νέα έκδοση στο GitHub, εμφανίζεται στα Πρόσθετα μέσα σε 12 ώρες το πολύ και την εγκαθιστάτε με «Ενημέρωση τώρα», ή αυτόματα αν έχετε ενεργές τις αυτόματες ενημερώσεις. Για να τη δείτε αμέσως, πατήστε Έλεγχος για ενημερώσεις κάτω από το όνομα του πρόσθετου στη λίστα Πρόσθετα.
Οι ρυθμίσεις και τα vouchers σας δεν επηρεάζονται από την ενημέρωση. Τι άλλαξε σε κάθε έκδοση θα το βρείτε στη σελίδα Releases.
| Τι βλέπετε | Τι κάνετε |
|---|---|
| «Login Failed» ή «Unauthorized Error» | Λάθος στοιχεία API. Ελέγξτε όνομα χρήστη, κωδικό και API key στην καρτέλα Λογαριασμοί |
| Μήνυμα στη δημιουργία, π.χ. «Zip code of consignee is required» | Η DK Express δεν δέχτηκε τα στοιχεία. Διορθώστε τη διεύθυνση της παραγγελίας και ξαναδοκιμάστε |
| «Η παραγγελία έχει ήδη το voucher…» | Υπάρχει ήδη ενεργό voucher. Ακυρώστε το πρώτα αν θέλετε νέο |
| Η εκτύπωση δεν ανοίγει | Ο φυλλομετρητής έκλεισε το αναδυόμενο. Επιτρέψτε τα αναδυόμενα για το διαχειριστικό του καταστήματος |
| Η κατάσταση δεν αλλάζει | Πατήστε «ανανέωση» στο πλαίσιο. Αν εκεί ενημερώνεται αλλά μόνο του όχι, ελέγξτε ότι δουλεύει το WP-Cron |
Για οτιδήποτε άλλο: ενεργοποιήστε την Αποσφαλμάτωση, κάντε ξανά την ενέργεια και στείλτε το αρχείο dkexpress-for-woocommerce από το WooCommerce → Κατάσταση → Αρχεία καταγραφής. Κωδικοί και API key δεν υπάρχουν μέσα, υπάρχουν όμως στοιχεία πελατών (ονόματα, διευθύνσεις, τηλέφωνα). Στείλτε το μόνο σε όποιον σας υποστηρίζει. Κλείστε την Αποσφαλμάτωση όταν τελειώσετε.
Shortcodes, για σελίδες του καταστήματος:
| Shortcode | Τι δείχνει |
|---|---|
[dkexpress_track_form] |
Φόρμα αναζήτησης voucher που ανοίγει το dkexpresscourier.gr |
[dkexpress_track_status order_id="123"] |
Την τελευταία κατάσταση της αποστολής |
[dkexpress_track_checkpoints order_id="123"] |
Ολόκληρη τη διαδρομή |
Τα δύο τελευταία δέχονται και voucher_no="..." αντί για order_id.
Filters:
| 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 παρακολούθησης που βλέπει ο πελάτης |
Actions:
| 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.