Δελτία αποστολής ΑΑΔΕ

1. Πάρτε διαπιστευτήρια myDATA για τη μεταφορική σας εταιρεία (όνομα χρήστη και κλειδί συνδρομής). Το ΑΦΜ μένει δεμένο στα διαπιστευτήρια στην ΑΑΔΕ, οπότε δεν το πληκτρολογείτε σε κάθε κλήση.
2. Συνδεθείτε ως διαχειριστής. Αποθηκεύστε τα διαπιστευτήρια και το ΑΦΜ του μεταφορέα στη σύνδεση ΑΑΔΕ. Ξεκινήστε με το περιβάλλον δοκιμών.
3. Το κλειδί συνδρομής αποθηκεύεται κρυπτογραφημένο και δεν εμφανίζεται ξανά. Μόνο ο οργανισμός σας διαβάζει τη δική του σύνδεση.

Το τιμολόγιο μένει στο ERP σας. Το Filodos μετακινεί μόνο εμπορεύματα και δεν εκδίδει παραστατικά.

1. Ο υπεύθυνος δρομολογίων επικολλά το URL του QR ενός δελτίου αποστολής, ή ο οδηγός σαρώνει τον κωδικό κατά την παραλαβή.
2. Το Filodos διαβάζει την κατάσταση του δελτίου από την ΑΑΔΕ και φτιάχνει εργασία παράδοσης από αυτό.
3. Ένα δελτίο που έχει ήδη τελειώσει (ολοκληρώθηκε, απορρίφθηκε, ακυρώθηκε ή απέτυχε) απορρίπτεται με την αιτία και δεν αποθηκεύεται τίποτα.

Διαβάστε τη ζωντανή κατάσταση οποιουδήποτε έργου από την ΑΑΔΕ ανά πάσα στιγμή. Το Filodos κρατά την κατάσταση που είδε τελευταία.

1. Κατά την παραλαβή, ξεκινήστε τη διακίνηση: στείλτε την πινακίδα του οχήματος και τη θέση του στην ΑΑΔΕ. Η μεταφόρτωση επαναλαμβάνει την έναρξη με τη νέα πινακίδα.
2. Κατά την παράδοση, κλείστε τη διακίνηση: FULL για πλήρη παράδοση, PARTIAL για μερική παράδοση από τον μεταφορέα, NONE για αποτυχημένη παράδοση. Τα FULL και NONE κλείνουν το δελτίο. Το PARTIAL το κρατά ανοιχτό για το δρομολόγιο επιστροφής.
3. Όταν η ΑΑΔΕ αρνηθεί μια κλήση, η αιτία γράφεται στην εργασία και στη σύνδεση. Διορθώστε την αιτία και επαναλάβετε την ενέργεια.

• GET /aade/connections και POST /aade/connections — συνδέσεις μεταφορέα (ανάγνωση διαχειριστές και υπεύθυνοι, εγγραφή διαχειριστές).
• GET /aade/deliveries και POST /aade/deliveries — εργασίες παράδοσης. Η δημιουργία παίρνει {connection_id, qr_url}.
• POST /aade/deliveries/{id}/start — έναρξη διακίνησης με {vehicle_plate, transport_type, trailer_plate, latitude, longitude}.
• POST /aade/deliveries/{id}/complete — αποτέλεσμα με {outcome} (FULL, PARTIAL ή NONE).
• GET /aade/deliveries/{id}/status — ζωντανή κατάσταση από την ΑΑΔΕ, αποθηκεύεται στην εργασία.

Ένα κακό URL QR ή μια άρνηση της ΑΑΔΕ απαντά 422 με την αιτία. Η παράδοση άλλου οργανισμού απαντά 404.