Innovative Open source WEB technologies for everyone

Περιγραφή και λεπτομέρειες προϊόντος / υπηρεσίας

Περιγραφή

Speedex για Magento 2

Το Speedex για Magento 2 είναι επέκταση για Magento 2 που βοηθά την ομάδα διαχείρισης παραγγελιών να οργανώνει τις αποστολές με Speedex μέσα από το Magento Admin. Αντί για χειροκίνητη μεταφορά στοιχείων σε εξωτερικά συστήματα, ο διαχειριστής μπορεί να δημιουργεί Speedex vouchers/BOL, να συνδέει το voucher με την παραγγελία, να προσθέτει tracking number στο shipment και να διαχειρίζεται τα PDF vouchers από ένα κεντρικό σημείο.

Η επέκταση είναι χρήσιμη για e-shop που αποστέλλουν καθημερινά παραγγελίες με Speedex και θέλουν να μειώσουν τον χρόνο καταχώρησης, τα λάθη στα στοιχεία παραλήπτη και την ανάγκη εναλλαγής ανάμεσα σε πολλά εργαλεία. Η ροή παραμένει μέσα στο Magento, ώστε η ομάδα να βλέπει την παραγγελία, το shipment, το tracking και το Speedex BOL στην ίδια διαχειριστική διαδικασία.

Τι κάνει στην πράξη

Μετά τη ρύθμιση των στοιχείων Speedex API, ο διαχειριστής μπορεί να ανοίξει μια παραγγελία και να χρησιμοποιήσει την ενέργεια Ship with Speedex. Το module προετοιμάζει τη φόρμα voucher με στοιχεία από την παραγγελία, όπως παραλήπτη, διεύθυνση, τηλέφωνο, ταχυδρομικό κώδικα, βάρος και αντικαταβολή όπου εφαρμόζεται. Πριν την υποβολή, ο διαχειριστής μπορεί να ελέγξει ή να προσαρμόσει τα στοιχεία.

Με την επιτυχημένη δημιουργία voucher, το module αποθηκεύει το BOL στο Magento, προσθέτει το Speedex tracking number στο shipment και δίνει πρόσβαση σε ενέργειες όπως λήψη PDF voucher, ανάκτηση PDF όταν δεν υπάρχει αποθηκευμένο αρχείο, ακύρωση ενεργού BOL και άνοιγμα της σχετικής παραγγελίας.

Κύριες δυνατότητες

  • Σύνδεση με Speedex API για δημιουργία vouchers/BOL μέσα από το Magento Admin.
  • Sandbox και production λειτουργία για ασφαλή δοκιμή πριν την παραγωγική χρήση.
  • Ενέργεια Ship with Speedex μέσα από τη σελίδα παραγγελίας.
  • Προσυμπληρωμένη φόρμα BOL με στοιχεία παραγγελίας και ρυθμίσεις αποστολής.
  • Προαιρετική δημιουργία ή επαναχρησιμοποίηση Magento shipment κατά τη δημιουργία voucher.
  • Αυτόματη προσθήκη Speedex tracking number στο shipment.
  • Κεντρικό grid διαχείρισης Speedex BOLs στο Magento Admin.
  • Προβολή Speedex BOLs και μέσα από τη σελίδα της παραγγελίας.
  • Ανάκτηση και λήψη PDF voucher.
  • Ακύρωση ενεργών BOL από το admin grid.
  • Ρυθμίσεις για αντικαταβολή, customer/paycode flags, security value, time limits, βάρος voucher και paper type PDF.
  • Tracking URL template για άνοιγμα της σελίδας παρακολούθησης με τον αριθμό αποστολής.

Οφέλη για το e-shop

  • Μειώνει τη χειροκίνητη καταχώρηση στοιχείων αποστολής.
  • Κρατάει το ιστορικό voucher/BOL συνδεδεμένο με την παραγγελία.
  • Βοηθά την ομάδα αποστολών να έχει γρήγορη πρόσβαση σε tracking και PDF vouchers.
  • Διευκολύνει τον έλεγχο ενεργών και ακυρωμένων Speedex BOLs.
  • Υποστηρίζει πιο καθαρή διαδικασία για παραγγελίες με αντικαταβολή.

Ρυθμίσεις και λειτουργική προσαρμογή

Το module διαθέτει ξεχωριστές ρυθμίσεις για sandbox και production στοιχεία σύνδεσης, ώστε να μπορεί να γίνει δοκιμή πριν τη χρήση σε πραγματικές αποστολές. Υπάρχουν επίσης ρυθμίσεις για αυτόματη δημιουργία shipment, επιλογή μεθόδων αντικαταβολής, default τιμές BOL, χρήση βάρους παραγγελίας ή fallback βάρους, καθώς και επιλογή μορφής PDF voucher όπως A4, A5, 10x21cm ή A6.

Σε ποιους απευθύνεται

Το Speedex για Magento 2 απευθύνεται σε Magento 2 καταστήματα που χρησιμοποιούν Speedex ως βασικό ή σημαντικό courier συνεργάτη και χρειάζονται πιο γρήγορη διαχείριση vouchers, tracking και PDF αποστολών. Είναι ιδιαίτερα χρήσιμο όταν η ομάδα διαχείρισης παραγγελιών θέλει να δουλεύει κυρίως μέσα από το Magento Admin και να περιορίσει τα εξωτερικά βήματα.

Σημειώσεις πριν την παραγωγική χρήση

Η σωστή λειτουργία προϋποθέτει ενεργά στοιχεία Speedex API, σωστές ρυθμίσεις agreement/customer ID και έλεγχο σε sandbox πριν την παραγωγική χρήση. Οι ρυθμίσεις αντικαταβολής, βάρους, time limits και paper type πρέπει να συμφωνούν με τη διαδικασία αποστολών του καταστήματος και τις οδηγίες του courier.

Εγκατάσταση και υποστήριξη

Με την αγορά του προϊόντος λαμβάνετε πρόσβαση στο composer repository μας και οδηγίες εγκατάστασης. Η εγκατάσταση και οι αρχικές ρυθμίσεις πρέπει να γίνουν σε περιβάλλον Magento 2 που καλύπτει τις απαιτήσεις της επέκτασης και διαθέτει τα απαραίτητα στοιχεία σύνδεσης με Speedex.

Επιπλέον πληροφορίες

Compatibility

, ,

PHP Version

PHP 8.1+

Latest Version

1.0.8

USER GUIDE – IOWEB Speedex

Overview

Ioweb_Speedex connects Magento 2 with Speedex so store admins can create, store, track, download, and cancel Speedex shipment vouchers/BOLs from Magento Admin.

Admin Areas

  • Main settings: Stores -> Configuration -> IOWEB TECHNOLOGIES -> Ioweb_speedex
  • Carrier/tracking settings: Stores -> Configuration -> Sales -> Delivery Methods -> Speedex
  • BOL grid: Sales -> Speedex BOL Management
  • Order action: Sales -> Orders -> View Order -> Ship with Speedex
  • Order BOL grid: Sales -> Orders -> View Order -> Speedex BOLs

Recommended Setup

  1. Enable the module.
  2. Select Sandbox mode for testing or Production mode for live use.
  3. Fill the Speedex credentials for the selected mode.
  4. Configure order settings and BOL defaults.
  5. Configure the Speedex carrier title, method name, and tracking URL template.
  6. Save configuration and clear Magento cache.
  7. Create a test BOL from a test order.
  8. Verify voucher creation, tracking number assignment, PDF retrieval, PDF download, and cancellation behavior.

Main Configuration – General

  • Enable: turns the Speedex integration on or off.
  • Mode: selects which credential set is used: sandbox or production.
  • Production fields: API URL, username, password, customer ID, and agreement ID.
  • Sandbox fields: API URL, username, password, customer ID, and agreement ID.

Only the credential fields for the selected mode are used during API calls. Start with sandbox mode, create a test session/BOL, and switch to production only after the workflow is verified.

Order Settings

  • Auto Ship Orders: allows the module to create or reuse a Magento shipment when a Speedex voucher is created.
  • Cash On Delivery Methods: payment methods treated as COD for Speedex voucher data.

The Ship with Speedex button is available only when the module is enabled, auto-shipping is enabled, and the order does not already have an active Speedex BOL. If the order already has a shipment, the module reuses the first existing shipment. If no shipment exists and the order can be shipped, the module creates one.

BOL Settings

  • Cust Flag: Speedex customer flag value.
  • Paycode Flag: charge type for the consignment.
  • Pod Amount Description: COD amount type used when COD applies.
  • Security Value: insurance/security amount.
  • Time Limit: delivery time window: no limit, 10:00-13:00, 13:00-16:00, or 16:00-19:00.
  • Use Order Weight: controls whether Magento order weight is used.
  • Voucher Weight: fallback weight when order weight is not used.
  • Voucher PDF Paper Type: PDF format: A4, A5, 10x21cm, or A6.

Carrier and Tracking Settings

  • Enabled: enables the Speedex carrier configuration.
  • Title: carrier title shown in Magento tracking contexts.
  • Method Name: method label.
  • Tracking URL Template: tracking link template. Use %s where the tracking number should be inserted.

The module provides tracking support, but it does not return checkout shipping rates. Use these settings for shipment tracking labels and tracking URLs.

Order Page – Ship with Speedex

The order button opens the BOL creation form for the order. It appears when Speedex is enabled, auto-shipping is enabled, and the order has no active Speedex BOL.

BOL Creation Form

The form is prefilled from the order and Speedex configuration. Admins can review or adjust values before submitting.

  • Order Increment ID: Magento order number, read-only.
  • Package Count: number of packages; default is 1.
  • Customer Flag: defaulted from configuration.
  • Branch Bank Code: optional operational field when required.
  • Customer Reference 1: optional reference text.
  • Recipient Address, Recipient Country, Recipient Name, Recipient Phone, Recipient Zip Code: recipient data from the order.
  • Security Value: defaulted from configuration.
  • Voucher Weight: order weight or configured fallback weight.

Required fields include package count, customer flag, recipient address, country, name, phone, postcode, security value, and voucher weight. Voucher weight must be greater than zero.

After submission, Magento creates or reuses a shipment, sends voucher data to Speedex, saves returned BOL records, retrieves PDF data when available, adds tracking numbers to the shipment, and sends the shipment notification.

Order Speedex BOLs Grid

The order view includes a Speedex BOL grid filtered to the current order. It shows voucher code, recipient details, COD amount, voucher weight, status, order increment ID, dates, PDF action, and row actions.

Speedex BOL Management Grid

The global BOL grid is available under Sales -> Speedex BOL Management. It lets admins review all BOL records, filter/search records, retrieve PDFs, download PDFs, cancel active BOLs, and open the related Magento order.

BOL Actions

  • Cancel BOL: sends a cancellation request to Speedex and removes the related tracking number from the Magento shipment when possible.
  • Get BOL PDF: requests and saves the voucher PDF when it is not already stored.
  • Download BOL PDF: downloads the saved voucher PDF.
  • View Order: opens the related Magento order.

BOL Record Edit Form

The edit form displays stored BOL data such as customer flag, comments/reference fields, package count, paycode flag, COD amount, recipient details, Saturday delivery flag, security value, sender/customer IDs, time limit, voucher code, voucher weight, PDF file, extra JSON data, order ID, and order increment ID.

Use this form mainly for reviewing saved voucher data. Editing a local Magento record does not necessarily change an already-created Speedex voucher.

CLI Diagnostics

  • bin/magento ioweb:speedex:create-session: checks whether Magento can create a Speedex API session.
  • bin/magento ioweb:speedex:show-credentials: helps confirm which configured values Magento is reading. Use carefully and avoid exposing sensitive values.

Operational Checklist

  • Test with sandbox credentials before switching to production.
  • Confirm production credentials with Speedex.
  • Create a test BOL and confirm shipment/tracking behavior.
  • Confirm PDF retrieval and download.
  • Confirm cancellation behavior on test vouchers.
  • Confirm COD payment method mapping.
  • Confirm voucher paper type with the team printing vouchers.
  • Clear Magento cache after configuration changes.

Troubleshooting

  • Button missing: check module enablement, auto-shipping, active BOL status, and admin permissions.
  • Voucher creation fails: check mode, API URL, credentials, customer ID, agreement ID, order address data, field lengths, and voucher weight.
  • Shipment cannot be created: check order status and shippable items.
  • COD values are wrong: check selected Cash On Delivery payment methods.
  • PDF missing: use Get BOL PDF and verify Speedex returned a PDF.
  • Tracking link is wrong: check that the tracking URL template contains %s.
  • Cancellation fails: check whether the voucher is already shipped or already cancelled in Speedex.

Changelog

[1.0.8] – 2026-05-27

  • Fixed Speedex logger compatibility with the shared IOWEB logging service.
  • Improved public documentation for configuration, BOL workflow, PDF retrieval, tracking, and troubleshooting.

[1.0.7] – 2026-05-27

  • Improved Speedex logger compatibility with the shared IOWEB logging service.

[1.0.6] – 2026-03-01

  • Maintenance release with no storefront or admin workflow changes.

[1.0.5] – 2026-02-28

  • Initial release of the Speedex integration for Magento 2.
  • Added sandbox and production API configuration.
  • Added Speedex BOL creation from Magento orders.
  • Added Speedex BOL management grid.
  • Added BOL cancellation, PDF retrieval, and PDF download actions.
  • Added Speedex tracking number support for Magento shipments.
  • Added optional automatic shipment creation during voucher creation.
  • Added configurable COD payment method mapping.
  • Added configurable voucher PDF paper type.

Συχνές ερωτήσεις πριν την αγορά

Τι καλύπτουν οι υπηρεσίες αποστολών και tracking για Magento 2;

Καλύπτουν παραμετροποίηση μεθόδων αποστολής, σύνδεση με courier, tracking παραγγελιών, ενημερώσεις πελατών και αυτοματισμούς γύρω από την αποστολή.

Μπορείτε να συνδέσετε Magento 2 με courier;

Ναι, μπορούμε να εξετάσουμε διαθέσιμο module ή API courier και να ορίσουμε τις ροές για αποστολές, tracking, vouchers ή ενημερώσεις κατάστασης.

Υποστηρίζετε κανόνες μεταφορικών;

Μπορούμε να βοηθήσουμε με κανόνες βάσει περιοχής, βάρους, αξίας παραγγελίας, τρόπου πληρωμής ή ειδικών εμπορικών αναγκών.

Τι χρειάζεται για tracking παραγγελιών;

Χρειάζεται να ξέρουμε ποια courier χρησιμοποιείτε, ποιο API ή module είναι διαθέσιμο και πώς θέλετε να ενημερώνεται ο πελάτης και το διαχειριστικό.

Γίνονται δοκιμές πριν ενεργοποιηθεί η λειτουργία;

Ναι, όπου υπάρχει δυνατότητα γίνονται δοκιμές με test παραγγελίες και staging πριν η λειτουργία εφαρμοστεί στο live κατάστημα.

Close Popup

Χρησιμοποιούμε cookies για να σας προσφέρουμε την καλύτερη εμπειρία πλοήγησης. Πατώντας αποδοχή, δηλώνετε ότι αποδέχεστε την χρήση των cookies σύμφωνα με την πολιτική απορρήτου.

Close Popup
Privacy Settings saved!
Ρυθμίσεις απορρήτου

Όταν επισκέπτεστε έναν ιστότοπο, αυτός μπορεί να αποθηκεύσει ή να ανακτήσει πληροφορίες από τον περιηγητή σας, κυρίως στη μορφή των cookies. Εδώ μπορείτε να επιλέξετε τις ρυθμίσεις cookies.

Αυτά τα cookies είναι απαραίτητα για τη λειτουργία του ιστότοπου και δεν μπορούν να απενεργοποιηθούν.

Wordpress
Αυτά τα cookies είναι απαραίτητα για τη λειτουργία του ιστότοπου και δεν μπορούν να απενεργοποιηθούν.
  • wordpress_test_cookie
  • wordpress_logged_in_
  • wordpress_sec

Απόρριψη Όλων
Save
Αποδοχή Όλων
Open Privacy settings
×