Τεκμηρίωση

Ξεκινήστε εδώ

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

• Υπεύθυνος στόλου ή διακίνησηςΠαρακολουθεί τον στόλο, τις διαδρομές, τα συμβάντα και τις αναφορές.Διαβάστε τον οδηγό χρήσης →
• ΟδηγόςΒλέπει το όχημά του, τις διαδρομές του και τα συμβάντα του στην εφαρμογή.Διαβάστε τον οδηγό χρήσης →
• ΔιαχειριστήςΔιαχειρίζεται χρήστες, κλειδιά API, webhooks, συνδέσμους κοινοποίησης και συνδέσεις ERP.Διασύνδεση ERP →
• ΠρογραμματιστήςΜεταφέρει δεδομένα στόλου σε ERP, TMS ή αποθήκη δεδομένων.Γρήγορη εκκίνηση →

Τεκμηρίωση χρήστη

Για υπεύθυνους στόλου, διακίνησης, οδηγούς και διαχειριστές: πώς χρησιμοποιείτε τον πίνακα ελέγχου και τις εφαρμογές κινητού.

• Οδηγίες — ο οδηγός χρήσης: τι κάνει το σύστημα, είσοδος και ρόλοι, χάρτης, όλες οι σελίδες, φωτογραφίες και βίντεο, εφαρμογές, όρια, γλωσσάρι.
• Συχνές ερωτήσεις: σύντομες απαντήσεις.
• Λειτουργίες: τι είναι διαθέσιμο σήμερα και τι έρχεται.
• Σύνδεση του δικού σας εντοπιστή GPS: χρησιμοποιήστε τους εντοπιστές που ήδη έχετε με το Filodos.
• Αναλύσεις BI: πίνακες όλου του στόλου στο Excel και στο Power BI, με μία σελίδα και παράδειγμα για κάθε ροή: ημερήσιες μετρήσεις, διαδρομές, συμβάντα, επισκέψεις ζωνών και οχήματα.
• Σύνδεσμοι κοινοποίησης σε πελάτες: σύνδεσμος μόνο για ανάγνωση, με λήξη, για μία διαδρομή ή μία ημέρα οχήματος.
• Ρύθμιση κλειδιών API: κλειδιά μόνο για ανάγνωση για το ERP σας, και ανάκλησή τους.
• Ρύθμιση webhooks: ειδοποιήσεις για τέλος διαδρομής, ζώνες, κρίσιμους συναγερμούς και την ημερήσια αναφορά.
• Διασύνδεση ERP: ποια δεδομένα ρέουν και πώς συνδέεται κάθε σύστημα.
• Σύνδεση SoftOne ή Entersoft (διαχειριστές): προσθήκη σύνδεσης ERP της ENTERSOFTONE, δοκιμή εισόδου, παύση ή διαγραφή.
• Σύνδεση SAP Business One (διαχειριστές): προσθήκη σύνδεσης Service Layer, ανάγνωση πελατών ή αποθηκών, και εγγραφή δραστηριοτήτων στο SAP.
• Σύνδεση SAP S/4HANA Cloud (διαχειριστές): προσθήκη σύνδεσης OAuth2 OData, ανάγνωση επιχειρηματικών εταίρων, και εγγραφή σημειώσεων στο S/4HANA.
• Εισαγωγή σημείων από αρχείο CSV (διαχειριστές): εισαγωγή σημείων πελατών και αποθηκών από οποιοδήποτε ERP με αρχείο CSV, χωρίς στοιχεία εισόδου.
• Σημεία ERP και ζώνες (υπεύθυνοι και διαχειριστές): πελάτες και αποθήκες του ERP γίνονται ζώνες, συγχρονισμός, και θέση για σημεία χωρίς συντεταγμένες.
• Σημειώσεις επισκέψεων στο ERP (υπεύθυνοι και διαχειριστές): μία σημείωση στο ERP σε κάθε επίσκεψη οχήματος σε σημείο του ERP.

Ρόλοι

Ρόλος	Τι βλέπει και τι κάνει
Διαχειριστής (Admin)	Όλα τα δεδομένα του οργανισμού. Διαχειρίζεται χρήστες, οχήματα, κλειδιά API, webhooks, συνδέσμους κοινοποίησης και συνδέσεις ERP.
Υπεύθυνος (Manager)	Όλα τα δεδομένα του οργανισμού. Δημιουργεί και ανακαλεί συνδέσμους κοινοποίησης. Αλλάζει τη ροή εργασίας των συνδέσεων ERP. Δεν διαχειρίζεται χρήστες, κλειδιά, webhooks ή την είσοδο στο ERP.
Οδηγός (Driver)	Μόνο το συνδεδεμένο όχημα και τις δικές του διαδρομές και συμβάντα.

Κάθε λογαριασμός ανήκει σε έναν οργανισμό και δεν βλέπει ποτέ δεδομένα άλλου οργανισμού.

Τεκμηρίωση προγραμματιστών

Για όσους συνδέουν το Filodos με ERP, TMS ή αποθήκη δεδομένων. Μία σελίδα ανά λειτουργία: αίτημα, απάντηση, κωδικοί σφαλμάτων και παραδείγματα.

Βασικές έννοιες

• Επισκόπηση API: διευθύνσεις, εκδόσεις διαδρομών, διαπιστευτήρια, πεδίο οργανισμού, χρόνοι, κωδικοί σφαλμάτων.
• Ταυτοποίηση: POST /auth/login, GET /auth/me.

Ανάγνωση δεδομένων

• Στόλος: GET /devices (με έκδοση: /v1/fleet).
• Διαδρομές: GET /trips, GET /driver/trips.
• Συμβάντα: GET /events, GET /driver/events.
• Θέσεις: GET /v1/positions.
• Επισκέψεις ζωνών: GET /v1/visits.
• Αναφορές: GET /v1/reports/daily, /weekly, /history, με τον δείκτη κόστους και τις παραμέτρους του.
• Τηλεμετρία: GET /telemetry, GET /telemetry/samples.
• Αναθέσεις: GET /assignments, GET /driver/assignments.

Πρόσβαση και ειδοποιήσεις

• Διαχείριση κλειδιών API: GET, POST, DELETE /api-keys.
• Συνδέσεις ERP: /erp/connections με ροή εργασίας, δοκιμή, συγχρονισμό, σημεία, θέσεις σημείων και σημειώσεις επισκέψεων των διασυνδέσεων ENTERSOFTONE. Μόνο με είσοδο.
• Διαχείριση webhooks: GET, POST, DELETE /webhooks, POST /webhooks/{id}/test, παραδόσεις και επανάληψη.
• Γεγονότα webhooks: κατάλογος, φάκελοι παράδοσης, υπογραφές, παράδειγμα.
• Δοκιμή διασύνδεσης: δοκιμή χωρίς sandbox, ping δοκιμής, διάγνωση, λίστα ελέγχου.

Τα endpoints φωτογραφιών και βίντεο παραμένουν εσωτερικά προς το παρόν και δεν περιλαμβάνονται.

Γρήγορη εκκίνηση για προγραμματιστές

Ακολουθήστε τα βήματα για να διαβάσετε τις πρώτες διαδρομές. Για το βήμα 1 χρειάζεστε λογαριασμό διαχειριστή.

1. Συνδεθείτε στον πίνακα ελέγχου ως διαχειριστής. Ανοίξτε Organization → API keys. Δημιουργήστε κλειδί με τα δικαιώματα devices:read και trips:read.
2. Αντιγράψτε το κλειδί. Ξεκινά με filodos_ και εμφανίζεται μόνο μία φορά.
3. Διαβάστε τη λίστα του στόλου και βρείτε το id ενός οχήματος.

   curl "https://filodos.gr/filodos-dashboard/api/scoring/v1/fleet" \
     -H "Authorization: Bearer filodos_…"

4. Διαβάστε τις διαδρομές του οχήματος.

   curl "https://filodos.gr/filodos-dashboard/api/scoring/v1/trips?device_id=12" \
     -H "Authorization: Bearer filodos_…"

5. Προαιρετικά: εγγραφείτε στο trip.ended, ώστε το Filodos να σας στέλνει κάθε νέα διαδρομή χωρίς επαναλαμβανόμενα αιτήματα.
6. Πριν από τη λειτουργία, κάντε τους ελέγχους της σελίδας Δοκιμή διασύνδεσης.

Κρατήστε το κλειδί μυστικό. Αποθηκεύστε το μόνο στον διακομιστή σας — ποτέ σε ιστοσελίδα, εφαρμογή κινητού ή αποθετήριο κώδικα. Αν διαρρεύσει, ανακαλέστε το και δημιουργήστε νέο.

Χάρτης endpoints

Όλες οι διαδρομές ξεκινούν από τη βάση https://filodos.gr/filodos-dashboard/api/scoring. Για νέες διασυνδέσεις χρησιμοποιήστε τις διαδρομές /v1/, που δεν αλλάζουν.

Δικαιώματα κλειδιών

Κάθε κλειδί API έχει ένα ή περισσότερα δικαιώματα (scopes). Κάθε δικαίωμα ανοίγει μία ομάδα αναγνώσεων. Κλήση εκτός δικαιωμάτων απαντά 403. Ένα κλειδί δεν μπορεί ποτέ να γράψει.

Δικαίωμα	Ανοίγει
devices:read	Τη λίστα του στόλου.
trips:read	Διαδρομές ανά όχημα και ανά οδηγό.
events:read	Συμβάντα οδήγησης, συμβάντα ζωνών και επισκέψεις ζωνών.
positions:read	Αποθηκευμένες θέσεις GPS ενός οχήματος.
reports:read	Ημερήσιες, εβδομαδιαίες συνόψεις και ιστορικό, με τον δείκτη κόστους.
telemetry:read	Συνόψεις τηλεμετρίας «μαύρου κουτιού» και τα δείγματα ανά δευτερόλεπτο.
drivers:read	Λίστες και συνόψεις οδηγών και ιστορικό αναθέσεων.
scores:read	Αποθηκευμένες εγγραφές βαθμολογίας οχημάτων.
analytics:read	Πίνακες BI όλου του στόλου: ημερήσιες μετρήσεις, διαδρομές, συμβάντα, επισκέψεις ζωνών και οχήματα.

Δώστε σε κάθε διασύνδεση μόνο τα δικαιώματα που χρησιμοποιεί. Η καταγραφή χιλιομέτρων χρειάζεται devices:read και trips:read. Η επιβεβαίωση παραδόσεων χρειάζεται επιπλέον events:read.

Γεγονότα webhooks

Ένα webhook στέλνει υπογεγραμμένο POST στη διεύθυνση HTTPS σας όταν συμβεί ένα γεγονός — αντί για συχνά αιτήματα ελέγχου.

Γεγονός	Το Filodos το στέλνει όταν
trip.ended	Ένα όχημα ολοκληρώνει μια διαδρομή.
geofence.enter	Ένα όχημα μπαίνει σε ζώνη.
geofence.exit	Ένα όχημα βγαίνει από ζώνη.
alarm.critical	Η συσκευή αναφέρει SOS, σύγκρουση ή ανατροπή.
report.daily	Στέλνονται τα νυχτερινά e-mail της ημερήσιας αναφοράς.
webhook.test	Ένας διαχειριστής στέλνει ping δοκιμής. Δεν γίνεται εγγραφή σε αυτό.

Κάθε παράδοση φέρει τις κεφαλίδες X-Filodos-Signature και X-Filodos-Delivery. Ελέγξτε την υπογραφή πριν χρησιμοποιήσετε τα δεδομένα. Αν ο διακομιστής σας δεν απαντήσει ή απαντήσει 429 ή 5xx, το Filodos ξαναδοκιμάζει μετά από 1 λεπτό, 5 λεπτά, 30 λεπτά, 2 ώρες και 12 ώρες. Ένας διαχειριστής μπορεί να ξαναστείλει κάθε αποθηκευμένη παράδοση.

Συμβάσεις

Ισχύουν για όλα τα endpoints. Λεπτομέρειες στην επισκόπηση API.

Μορφή

Αιτήματα και απαντήσεις σε JSON. Οι λίστες ταξινομούνται από το νεότερο, εκτός αν η σελίδα λέει κάτι άλλο.

Διαπιστευτήρια

Token εισόδου ή κλειδί API στην κεφαλίδα Authorization: Bearer. Για διασυνδέσεις διακομιστή με διακομιστή χρησιμοποιήστε κλειδί.

Πεδίο οργανισμού

Κάθε ανάγνωση δείχνει μόνο δεδομένα του οργανισμού του διαπιστευτηρίου. Αναγνωριστικό άλλου οργανισμού απαντά 404.

Χρόνοι

ISO-8601 με απόκλιση UTC. Οι παράμετροι ημέρας και εβδομάδας χρησιμοποιούν τοπικές ημερομηνίες στόλου (Europe/Athens).

Σφάλματα

400 λάθος παράμετροι, 401 άκυρο διαπιστευτήριο, 403 χωρίς άδεια ή δικαίωμα, 404 άγνωστο αναγνωριστικό, 422 άκυρη είσοδος, 429 πάρα πολλά αιτήματα, 502/503 αποτυχία εξωτερικής υπηρεσίας.

Σταθερότητα

Οι διαδρομές /v1/ δεν αλλάζουν. Οι διαδρομές χωρίς έκδοση μπορεί να αλλάξουν.

Πρόσφατες αλλαγές

• 1.0.64: ο πίνακας ελέγχου και οι εφαρμογές iOS και Android είναι στα ελληνικά και στα αγγλικά. Δείτε Είσοδος και ρόλοι — Γλώσσα.
• 1.0.26: εισαγωγή σημείων από αρχείο CSV για οποιοδήποτε ERP, και κουμπί Εξαγωγή CSV στις σελίδες Διαδρομές, Συμβάντα, Οδηγοί και στην ημερήσια αναφορά. Δείτε Εισαγωγή σημείων από αρχείο CSV.
• 1.0.23: η διασύνδεση SAP S/4HANA Cloud μέσω του OData API με OAuth2. Επιχειρηματικοί εταίροι γίνονται ζώνες, και κάθε επίσκεψη μπορεί να δημιουργήσει σημείωση στο S/4HANA. Δείτε Σύνδεση SAP S/4HANA Cloud.
• 1.0.20: η διασύνδεση SAP Business One μέσω του Service Layer. Πελάτες ή αποθήκες γίνονται ζώνες, και κάθε επίσκεψη μπορεί να δημιουργήσει δραστηριότητα στο SAP. Δείτε Σύνδεση SAP Business One.
• 1.0.12 – 1.0.15: διασυνδέσεις ERP της ENTERSOFTONE για SoftOne και Entersoft. Τα σημεία του ERP γίνονται ζώνες, και κάθε επίσκεψη μπορεί να γράψει σημείωση πίσω στο ERP. Η σελίδα Organization → ERP μοιράζει την εργασία: οι διαχειριστές έχουν τη σύνδεση, οι υπεύθυνοι αλλάζουν τη ροή εργασίας. Δείτε Σύνδεση SoftOne ή Entersoft και Συνδέσεις ERP.
• 1.0.11: η τεκμηρίωση των αναλύσεων BI στα ελληνικά. Δείτε Αναλύσεις BI.
• 1.0.9 – 1.0.10: τέσσερις νέες ροές BI για όλο τον στόλο: διαδρομές, συμβάντα, επισκέψεις ζωνών και οχήματα. Η ημερήσια ροή έχει πλέον ονόματα οχημάτων και οδηγών. Ένα ερώτημα Excel διαβάζει όλες τις ροές.
• 1.0.8: σύνδεση των δικών σας εντοπιστών GPS. Το Filodos συνδέει τους εντοπιστές που ήδη έχετε με τον πίνακα ελέγχου. Δείτε Σύνδεση του δικού σας εντοπιστή GPS.
• 1.0.2 – 1.0.3: σύνδεσμοι κοινοποίησης σε πελάτες. Ένας υπεύθυνος ή διαχειριστής στέλνει στον πελάτη σύνδεσμο μόνο για ανάγνωση σε μία διαδρομή ή μία ημέρα οχήματος. Ο σύνδεσμος λήγει σε 1 έως 30 ημέρες και ο πελάτης δεν χρειάζεται λογαριασμό. Δείτε Σύνδεσμοι κοινοποίησης.
• 1.0.1: ο δείκτης κόστους (ρελαντί, απότομα συμβάντα, νυχτερινή οδήγηση) στις ημερήσιες και εβδομαδιαίες αναφορές, με προαιρετικές παραμέτρους τιμών. Δείτε Αναφορές.
• 1.0.0: το πλήρες API ανάγνωσης /v1/, με θέσεις, επισκέψεις ζωνών και αναφορές.
• 0.2.104: επαναλήψεις webhooks, λίστα παραδόσεων και επανάληψη αποστολής.