COURIERAPP CONNECT · WooCommerce 0.4.30 · OpenAPI 0.6.10

Οι αποστολές του e-shop σου, σε ένα σημείο.

Σύνδεσε WooCommerce, Shopify ή custom κατάστημα για τιμές, ετικέτες, tracking και ενημερώσεις πελατών.

Συνδρομή και υπόλοιπα

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

Στο dashboard του καταστήματος βλέπεις το ενεργό πακέτο, τις ετικέτες της περιόδου, τα email, τα διαθέσιμα SMS και τα πακέτα που περιμένουν ενεργοποίηση. Το GET /v1/subscription επιστρέφει το πακέτο και τα όρια χωρίς στοιχεία κάρτας.

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

WooCommerce 0.4.30

Λήψη τελευταίας έκδοσης · 0.4.30

Από WordPress → Πρόσθετα → Προσθήκη νέου → Μεταφόρτωση, επίλεξε το ZIP. Αν υπάρχει ήδη το CourierAPP Connect, χρησιμοποίησε την επιλογή αντικατάστασης του υπάρχοντος πρόσθετου.
Στο WooCommerce → CourierAPP Connect πάτησε «Σύνδεση με CourierAPP». Έλεγξε το domain και τον κωδικό αντιστοίχισης, συνδέσου και διάλεξε δοκιμαστική ή πραγματική λειτουργία. Επέστρεψε στο WooCommerce και ολοκλήρωσε τη σύνδεση. Δεν χρειάζεται αντιγραφή API key.
Συμπλήρωσε συσκευασία, πραγματικές διαστάσεις, βάρος, στοιχεία αποστολέα και ζώνες αποστολής.
Έλεγξε τις τιμές και τις ρυθμίσεις πριν ενεργοποιήσεις το δημόσιο checkout. Οι υπάρχουσες μέθοδοι αποστολής διατηρούνται.

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

Shopify

Η δημόσια διάθεση της εφαρμογής και ο τρόπος χρέωσης για το Shopify παραμένουν υπό έγκριση. Στη δοκιμαστική εγκατάσταση υπάρχει πίνακας μεταφορέων με την κατάσταση της σύνδεσης του καταστήματος και πρόσβαση στην κεντρική διαχείριση λογαριασμών. Η τεχνική δοκιμαστική εγκατάσταση δεν αποτελεί δημόσια καταχώρηση στο App Store.

Για ελεγχόμενη εγκατάσταση σε επιλέξιμο κατάστημα, επικοινώνησε μαζί μας. Για δυναμικές τιμές απαιτείται Carrier Calculated Shipping. Στο Basic υποστηρίζονται εγκεκριμένοι σταθεροί τιμοκατάλογοι ανά courier, χώρα και βάρος, με markup και ξεχωριστό προφίλ ελεγμένων προϊόντων. Ογκώδη και άγνωστα προϊόντα χρειάζονται έλεγχο. Ρύθμιση τιμοκαταλόγων από τον έμπορο · Λήψη εργαλείων τιμοκαταλόγων Basic. Η πληρωμή ελέγχεται μέσω Shopify API· δοκιμαστική παραγγελία δεν αγοράζει πραγματικά μεταφορικά.

Χρεώσεις Shopify

Οι νέοι πελάτες από το Shopify πληρώνουν συνδρομή, σύνδεση και SMS μέσα από το Shopify Billing. Οι προϋπάρχοντες ανεξάρτητοι συνδρομητές διατηρούν το Stripe μετά την επαλήθευση της προέλευσης της συνδρομής. Δεν δημιουργείται δεύτερη παράλληλη συνδρομή.

Η ενεργοποίηση γίνεται μετά από έλεγχο στο Shopify API, όχι μόνο επειδή επέστρεψες από τη σελίδα έγκρισης. Ακύρωση ή πάγωμα διακόπτει τα αντίστοιχα δικαιώματα. Τα SMS μπορεί να παραμείνουν σε αναμονή τροφοδότησης παρόχου. Η δημόσια διάθεση και οι πραγματικές χρεώσεις Shopify αναμένουν την ολοκλήρωση του App Review. Η τρέχουσα δοκιμή χρησιμοποιεί αποκλειστικά test charges χωρίς πραγματικά χρήματα.

Σύνδεση καταστήματος

Λογαριασμός και συνδέσεις

Κάθε αίτημα αντιστοίχισης λήγει σε 10 λεπτά και χρησιμοποιείται μία φορά. Το κλειδί του καταστήματος αποθηκεύεται κρυπτογραφημένο και ανακαλείται από τον λογαριασμό σου. Το δοκιμαστικό και το πραγματικό περιβάλλον είναι χωριστά.

API για custom καταστήματα

Το API key χρησιμοποιείται μόνο στον server σου, ποτέ σε δημόσιο JavaScript. Τα ca_test_… λειτουργούν στο sandbox και τα ca_live_… στο live.

Live: https://swdjgtbhifglgnnmwthf.supabase.co/functions/v1/merchant-api
Test: https://swdjgtbhifglgnnmwthf.supabase.co/functions/v1/merchant-api-sandbox

GET /v1/capabilities — περιβάλλον και διαθέσιμες δυνατότητες.
GET /v1/subscription — συνδρομή και όρια.
POST /v1/quotes — προσφορές με ΦΠΑ σε cents EUR.
GET /v1/quotes/{id}/validate — επανέλεγχος πριν από την πληρωμή.
POST /v1/shipments — δημιουργία με σταθερό Idempotency-Key.
GET /v1/shipments/{id}/label — PDF της δικής σου αποστολής.
GET /v1/shipments/{id}/tracking — εξέλιξη αποστολής.
GET /v1/events?after=0 — συμβάντα του καταστήματος.

Πλήρης προδιαγραφή OpenAPI 0.6.10

Οι προσφορές λήγουν σε 15 λεπτά. Διατήρησε σταθερό κλειδί ανά παραγγελία/δέμα και το αρχικό αίτημα. Σε αβέβαιο αποτέλεσμα μην δημιουργείς δεύτερη αποστολή. Το όριο είναι 60 αιτήματα ανά λεπτό ανά κατάστημα· σε HTTP 429 περίμενε πριν από την επανάληψη.

Αντικαταβολή Courier Center

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

WooCommerce: ενεργοποίησε την επιλογή αντικαταβολής Courier Center στη μέθοδο αποστολής και τον τρόπο πληρωμής COD. Shopify: δήλωσε στις ρυθμίσεις το ακριβές όνομα του τρόπου αντικαταβολής. Η δημόσια διάθεση Shopify εξακολουθεί να απαιτεί έγκριση.

Custom API: χρησιμοποίησε το πλήρες ανεξόφλητο σύνολο της παραγγελίας σε cents, με το ίδιο σταθερό Idempotency-Key. Η νέα ετικέτα δεν εξοφλεί την παραγγελία. Αλλαγή ποσού μετά την έκδοση απαιτεί έλεγχο, όχι δεύτερη αυτόματη ετικέτα.

{"status":"pending","method":"cod","currency":"EUR","amount_cents":1234,"reference":"order-123"}

Στο WooCommerce η φυσική παράδοση εμφανίζεται ως «Παραδόθηκε — αναμονή αντικαταβολής». Η απόδοση χρημάτων επιβεβαιώνεται χωριστά από την Courier Center προς τον έμπορο.

Μεταφορικά και εταιρείες courier

Με υπηρεσίες CourierAPP, τα μεταφορικά αφαιρούνται από το επαγγελματικό wallet. Με δικό σου συμβόλαιο χρησιμοποιούνται ο επαληθευμένος λογαριασμός και οι συμφωνημένες τιμές σου, ενώ η ετικέτα μετρά στη συνδρομή. Δεν αφαιρούμε χρήματα από τον πάροχο πληρωμών του e-shop σου.

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

Η Courier Center διαθέτει ροή σύνδεσης και καταχώρισης προσωπικού τιμοκαταλόγου. Η SPEEDEX υποστηρίζει δοκιμαστική σύνδεση, ετικέτα PDF και ακύρωση με συνθετικά στοιχεία. Η πραγματική αποστολή αναμένει παραγωγικούς κωδικούς. Η ετικέτα SPEEDEX δεν δημιουργεί εντολή παραλαβής. Η ACS υποστηρίζει δοκιμαστική έκδοση PDF και ακύρωση χωρίς εντολή παραλαβής. Η Γενική Ταχυδρομική αναμένει δοκιμαστική πρόσβαση και δεν είναι ακόμη διαθέσιμη για αποστολές.

Email και καταστάσεις παραγγελίας

Στο dashboard επιλέγεις τα στάδια ενημέρωσης, επεξεργάζεσαι θέματα και κείμενα email και ορίζεις την αντιστοίχιση καταστάσεων. Οι ρυθμίσεις εφαρμόζονται σε νέες αποστολές· δεν επαναποστέλλονται παλιά μηνύματα. Το WooCommerce προστατεύει τις χειροκίνητες και οικονομικές καταστάσεις. Για custom κατάστημα χρειάζεται αντίστοιχος adapter.

Πακέτα SMS και ενεργοποίηση

Τα πακέτα SMS πιστώνονται στο κατάστημα που επιλέγεις κατά την αγορά. Αν εκκρεμεί τροφοδότηση του παρόχου, εμφανίζεται «Αναμονή ενεργοποίησης». Το αγορασμένο υπόλοιπο παραμένει καταχωρημένο, αλλά τα SMS αποστέλλονται μόνο όταν είναι διαθέσιμο για χρήση.

Κεφαλαία GSM-7, μέχρι 160 μονάδες ανά μήνυμα. Πριν από την αποστολή ελέγχονται κόστος προορισμού, υπόλοιπο και όρια. Προορισμοί πάνω από το υποστηριζόμενο κόστος και πολυμερή μηνύματα δεν αποστέλλονται. Δεν γίνεται αυτόματη αγορά πακέτων. Τα email λειτουργούν ανεξάρτητα.

SMS API: /functions/v1/merchant-sms. GET /v1/status απαιτεί shipments:read. Τα POST /v1/settings, /v1/preview, /v1/sync απαιτούν και shipments:write. Τα ποσά είναι σε micro-EUR. Η προεπισκόπηση δεν στέλνει SMS και το sandbox χρησιμοποιεί προσομοίωση.

Ακυρώσεις

Το POST /v1/shipments/{id}/cancellation καταχωρίζει αίτημα με σταθερό Idempotency-Key. Το HTTP 202 δεν σημαίνει ακύρωση φορτωτικής ή επιστροφή χρημάτων. Η πραγματική επιστροφή απαιτεί επιβεβαίωση μεταφορέα και εγκεκριμένη πολιτική χρεώσεων. Η επιστροφή στον πελάτη του e-shop γίνεται χωριστά από το κατάστημα.

Ενιαία παρακολούθηση & εκτύπωση

Το tracking_url από την αποστολή ή το GET /v1/shipments/{id}/tracking ανοίγει το track.courierapp.gr. Είναι προσωπικός σύνδεσμος 90 ημερών· μην τον δημοσιεύεις ή τον καταγράφεις σε analytics. Τα στάδια εμφανίζονται από τα συμβάντα της courier, όχι από ζωντανό GPS. Εμφανίζεται μόνο επιβεβαιωμένη ενημέρωση courier.

WooCommerce: Παραγγελίες → CourierAPP — Εκτύπωση ετικετών. Shopify: Orders, labels & tracking. Έως 10 υπάρχουσες ετικέτες σε ένα PDF, αρχικό μέγεθος ή Α4, χωρίς νέα αποστολή ή κατανάλωση ετικέτας. Custom: ανάκτηση κάθε προστατευμένου PDF με GET /v1/shipments/{id}/label από τον server σου και συνένωση για εκτύπωση. Ποτέ API key στο browser.

Αυτόματη συσκευασία και ασφαλής τιμή checkout

WooCommerce: ρυθμίσεις μεθόδου CourierAPP → «Αυτόματη συσκευασία, markup και βαθμίδες». Δήλωσε διαθέσιμα κουτιά με εσωτερικές/εξωτερικές διαστάσεις, απόβαρο, όριο μικτού βάρους και κόστος υλικών. Τα προϊόντα χρειάζονται πραγματικό βάρος και διαστάσεις. Στην καρτέλα Αποστολή μπορείς να ορίσεις όρθιο προσανατολισμό ή απαγόρευση στοίβαξης.

Shopify: οι ίδιες ρυθμίσεις βρίσκονται στη σύνδεση καταστήματος. Ο κατάλογος Variant ID / βάρους / διαστάσεων συμπληρώνει τις διαστάσεις που λείπουν από το callback. Χωρίς γνωστή έκπτωση δεν ενεργοποιείται δωρεάν μεταφορικό βάσει αξίας· οι παραγγελίες με πολλαπλές γραμμές μεταφορικών κρατούνται για έλεγχο πριν από αγορά ετικέτας. Δεν ζητούνται νέα δικαιώματα προϊόντων.

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

Κάθε courier έχει ανεξάρτητο markup και έως 20 βαθμίδες δωρεάν μεταφορικών για Ελλάδα / ΕΕ / εκτός ΕΕ. Αξία, βάρος και μέγιστο κόστος εφαρμόζονται μαζί ανά βαθμίδα. Το κόστος περιλαμβάνει μεταφορά και υλικά. Το δωρεάν checkout δεν μηδενίζει το κόστος του καταστήματος. DHL/FedEx χρησιμοποιούν την τιμή CourierAPP προς το κατάστημα, ποτέ το εσωτερικό μας κόστος αγοράς. Οι περιορισμοί διαθέσιμων διαδρομών και πραγματικών λογαριασμών παραμένουν.

Custom: POST /v1/quotes με cart.items και checkout_policy.version=1 από τον server σου. Εμφάνισε checkout.customer_shipping_cents μία φορά και κράτησε το quote_id και τα επιστρεφόμενα packages. Το total_cents είναι το κόστος μεταφοράς του καταστήματος. Ποτέ API key στον browser.

10 δωρεάν ετικέτες και email με την εμφάνισή σου

Το Free δίνει 10 ετικέτες ανά ημερολογιακό μήνα UTC, συνολικά σε όλα τα καταστήματα του ίδιου επαληθευμένου λογαριασμού. Χρειάζονται δικοί σου ελεγμένοι λογαριασμοί courier και τιμοκατάλογος. Χωρίς μεταφορά υπολοίπου ή αυτόματη χρέωση υπέρβασης. Οι επανεκτυπώσεις δεν μετρούν ξανά. Μεταφορικά και SMS χρεώνονται χωριστά.

Στον πίνακα καταστήματος αλλάζεις χρώμα, σύνδεσμο λογότυπου του website σου, υποσέλιδο, κείμενα ανά στάδιο και προαιρετική προσφορά με τίτλο, περιγραφή, κουμπί και στοιχεία επιχείρησης. Η προεπισκόπηση έχει συνθετικά στοιχεία και δεν στέλνει email. Ο αποστολέας και οι απαντήσεις παραμένουν info@courierapp.gr, με εμφανή υποστήριξη CourierAPP.

Οι προσφορές είναι αρχικά απενεργοποιημένες. Προβάλλονται μόνο με καταγεγραμμένη ρητή συγκατάθεση email και περιλαμβάνουν διαγραφή. Χωρίς συγκατάθεση αποστέλλεται μόνο η αναγκαία ενημέρωση αποστολής. Τα SMS παραμένουν κειμενικά και δεν αποκτούν αυτόματα διαφημιστικό περιεχόμενο.

WooCommerce: ενεργοποίησε προαιρετικά το ξετικαρισμένο πεδίο προσφορών από WooCommerce → CourierAPP Connect. Λειτουργεί σε Classic και Blocks. Custom / Shopify: καταχώρισε ανεξάρτητα επαληθευμένη συγκατάθεση από τον server με POST /stores/self/marketing-consent στο merchant-integrations. Η αγορά από μόνη της δεν αποτελεί συγκατάθεση. Το σταθερό reference προστατεύει από διπλή καταχώριση και επαναφορά παλιάς συγκατάθεσης μετά από διαγραφή.

Προϊόντα έτοιμα για σωστά μεταφορικά

Στα πληρωμένα πακέτα προετοιμάζονται προτάσεις για κενά βάρους και διαστάσεων, πρώτα από υποστηριζόμενες επίσημες πηγές και μετά από εκτίμηση AI όταν επαρκούν τα στοιχεία. Τα γνωστά πεδία διατηρούνται. Κάθε μεμονωμένη ή μαζική αποθήκευση απαιτεί έγκριση του εμπόρου· οι εκτιμήσεις διακρίνονται από τις μετρήσεις.

Μηνιαία όρια μοναδικών προϊόντων ανά κατάστημα: 100 / 300 / 600 / 1.200 / 2.400, ανά πληρωμένο πακέτο. Η ουρά συνεχίζει σε επόμενες παρτίδες και δεν επανελέγχει αμετάβλητα ολοκληρωμένα προϊόντα. Ισχύουν επιπλέον όρια κλήσεων και κόστους. Το AI δεν καλείται μέσα στο checkout.

Προϊόντα & AI · Οδηγίες API και όρια. Το Shopify χρησιμοποιεί εγκεκριμένο κατάλογο Variant ID στο CourierAPP χωρίς αλλαγή εγγενών προϊόντων ή πρόσθετα OAuth δικαιώματα.

Προϊόντα έτοιμα για σωστά μεταφορικά

Αυτόματο setup για WooCommerce, Shopify και custom

Αξιοποίηση υπάρχοντων πεδίων προϊόντων, εγκεκριμένων προτάσεων και κουτιών. Καμία επινόηση τιμοκαταλόγου ή αυτόματη αποθήκευση εκτίμησης. Η ουρά AI των πληρωμένων πακέτων συνεχίζει με τα όρια του καταστήματος.

Δοκίμασε τον οδηγό με 2.000 συνθετικά προϊόντα και όλες τις χώρες