API και ενσωμάτωση
API για ERP και e-shop: οι παραγγελίες μπαίνουν μόνες τους στο TMS
Αν οι παραγγελίες σου γεννιούνται ήδη σε ERP ή e-shop, δεν υπάρχει λόγος να τις ξαναπληκτρολογείς ή να τις ανεβάζεις με Excel. Το HaulX TMS έχει API όπου ένα σύστημα στέλνει παραγγελίες και διαβάζει πίσω την πορεία τους, μέχρι το αποδεικτικό παράδοσης.
Με μια ματιά
Δημιουργία παραγγελιών ένα προς ένα ή σε δέσμες έως 100, με ασφαλή επανάληψη: η ίδια αναφορά δεν δημιουργεί διπλή παραγγελία.
Ανάγνωση κατάστασης παραγγελιών, δρομολογίων και αποδεικτικών παράδοσης (POD, CMR, δελτίο, φωτογραφία).
Κλειδί API ανά εταιρεία, με δικαίωμα ανάγνωσης ή και εγγραφής, που το δημιουργεί ο υπεύθυνος από τις ρυθμίσεις.
Ανοιχτή τεκμηρίωση στο πρότυπο OpenAPI, με δοκιμή κλήσεων από τη σελίδα.
Πότε έχει νόημα API αντί για Excel
Η εισαγωγή από Excel (CSV) είναι ο γρηγορότερος δρόμος όταν κάποιος ετοιμάζει το αρχείο της ημέρας. Όταν όμως οι παραγγελίες έρχονται συνεχώς από σύστημα, το αρχείο γίνεται ένα επιπλέον βήμα που κάποιος πρέπει να θυμάται.
Με το API, η παραγγελία φτάνει στο TMS τη στιγμή που δημιουργείται στο ERP. Το γραφείο τη βρίσκει έτοιμη για προγραμματισμό και ο προγραμματιστής σου δεν χρειάζεται να αλλάξει κάτι στη ροή του γραφείου.
Τι μπορείς να κάνεις μέσω API
- Να δημιουργήσεις παραγγελία με παραλήπτη, διεύθυνση και παραδοτέα είδη, παραλαβή από διεύθυνση ή από αποθήκη/Hub της εταιρείας σου, και προαιρετικά ποσό αντικαταβολής.
- Να στείλεις έως 100 παραγγελίες ανά κλήση, όπου κάθε μία κρίνεται μόνη της: η μία με πρόβλημα δεν ακυρώνει τις υπόλοιπες.
- Να ζητήσεις λίστα παραγγελιών με φίλτρο «άλλαξαν από» και να συγχρονίζεις το σύστημά σου περιοδικά.
- Να δεις δρομολόγια και στάσεις με εκτιμώμενες ώρες άφιξης.
- Να κατεβάσεις το αποδεικτικό παράδοσης και τα συνοδευτικά έγγραφα μιας παραγγελίας.
- Να διαγράψεις παραγγελία, όσο δεν έχει μπει σε δρομολόγιο.
Πώς ξεκινάς
- 1
Ο υπεύθυνος ή ο διαχειριστής ανοίγει στις ρυθμίσεις τη σελίδα «Σύνδεση API» και δημιουργεί κλειδί. Το κλειδί εμφανίζεται μία φορά, γι' αυτό το αποθηκεύεις στο σύστημά σου.
- 2
Ο προγραμματιστής σου διαβάζει την τεκμηρίωση και κάνει μια δοκιμαστική κλήση.
- 3
Το σύστημά σου στέλνει παραγγελίες με τη δική σου αναφορά. Αν ξαναστείλει την ίδια, επιστρέφεται η υπάρχουσα και δεν δημιουργείται δεύτερη.
- 4
Διαβάζεις περιοδικά τις αλλαγές για να ενημερώνεις το ERP ή το e-shop σου με την κατάσταση παράδοσης.
Τι δεν κάνει σήμερα
Το API είναι ένα καθαρό σημείο σύνδεσης και όχι έτοιμος σύνδεσμος για συγκεκριμένο ERP ή πλατφόρμα e-shop: η σύνδεση γράφεται από εσένα ή τον προγραμματιστή σου. Δεν στέλνει ειδοποιήσεις προς το σύστημά σου (webhooks), οπότε ο συγχρονισμός γίνεται με περιοδική ανάγνωση. Οι αλλαγές σε υπάρχουσα παραγγελία γίνονται από το γραφείο μέσα στο TMS και δεν περιλαμβάνονται τα στοιχεία οδηγού ή η θέση του οχήματος.
Συχνές ερωτήσεις
Όχι. Υπάρχει API που ο προγραμματιστής σου συνδέει με το σύστημα που χρησιμοποιείς, με δημόσια τεκμηρίωση όπου μπορεί να δοκιμάσει τις κλήσεις.
Ο υπεύθυνος ή ο διαχειριστής της εταιρείας από τις ρυθμίσεις. Το κλειδί εμφανίζεται μία φορά και μπορεί να ανακληθεί οποιαδήποτε στιγμή, οπότε σταματά να λειτουργεί αμέσως.
Αν η αναφορά υπάρχει ήδη, το API επιστρέφει την υπάρχουσα παραγγελία και δεν δημιουργεί δεύτερη. Έτσι μια επανάληψη κλήσης είναι ασφαλής.
Όχι ακόμη. Το σύστημά σου διαβάζει τις αλλαγές με φίλτρο «από πότε», για παράδειγμα κάθε λίγα λεπτά.
Ναι, 300 κλήσεις το λεπτό ανά κλειδί και έως 100 παραγγελίες ανά δέσμη. Αν το ξεπεράσεις, το API επιστρέφει σχετικό σφάλμα με χρόνο αναμονής.
Δες ακόμα
Δοκίμασε το HaulX TMS με τις δικές σου παραγγελίες
14 ημέρες δοκιμή, χωρίς εγκατάσταση. Αν θες βοήθεια στο ξεκίνημα, μίλησε μαζί μας.