Πλατφόρμα τρίτου για τα ψηφιακά δελτία αποστολής της ΑΑΔΕ

Ασφαλής διαβίβαση δελτίων αποστολής προς την ΑΑΔΕ

Πλήρης συμβατότητα με ΑΑΔΕ myDATA Delivery Note v2.0.2 (XSD v2.0.2)

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

Σύνδεση οργανισμούΓια διαχειριστές οργανισμών και προσωπικό της Smartnav
Είσοδος οδηγούΖητά κωδικό ενεργοποίησης ή σάρωση QR

Μία πράξη, από το κινητό στην ΑΑΔΕ

  1. Ο οδηγός σαρώνει το QR«Έναρξη μεταφοράς»
  2. Ένας κόμβος την παραλαμβάνεισε όποιο datacenter απαντά
  3. Ο κόμβος τη στέλνει στην ΑΑΔΕmyDATA Delivery Note v2.0.2
  4. Επιβεβαιώθηκε από την ΑΑΔΕμόνο με την απάντηση της ΑΑΔΕ

Τρεις χρήσεις

Τι κάνει το σύστημα

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

Για οργανισμούς

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

Για οδηγούς

Εφαρμογή στο κινητό: ο οδηγός σαρώνει το QR του δελτίου αποστολής και εκτελεί την κίνηση, με ένα μεγάλο ΠΡΑΣΙΝΟ ή ΚΟΚΚΙΝΟ «μπορείς να φύγεις;» που στηρίζεται στην επιβεβαίωση της ΑΑΔΕ.

Για συστήματα συνεργατών

REST API και βιβλιοθήκη Java για εφαρμογές Android και συστήματα ERP, με τεκμηρίωση για τον προγραμματιστή και για το AI που τη χρησιμοποιεί.

Τέσσερα βήματα

Πώς λειτουργεί

Τέσσερα βήματα από τον οργανισμό μέχρι την ΑΑΔΕ.

  1. Οργανισμός

    Η Smartnav δημιουργεί τον οργανισμό και τον διαχειριστή του. Ο διαχειριστής καταχωρεί τα διαπιστευτήρια ΑΑΔΕ του οργανισμού.

  2. Κλειδιά

    Ο διαχειριστής εκδίδει κλειδιά API: ένα ανά οδηγό, ανά συσκευή ή όσα χρειάζεται, και τα ανακαλεί όποτε θέλει.

  3. Κινητό οδηγού

    Ο οδηγός ενεργοποιεί το κινητό του με QR ή κωδικό μίας χρήσης και σαρώνει το QR του δελτίου αποστολής.

  4. ΑΑΔΕ

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

myDATA Delivery Note v2.0.2

Το διάγραμμα καταστάσεων της ΑΑΔΕ

Κάθε δελτίο αποστολής περνά από αυτές τις καταστάσεις. Οι κουκκίδες είναι εντολές που ταξιδεύουν στις μεταβάσεις — με το χρώμα του ρόλου που τις στέλνει.

Διάγραμμα καταστάσεων του δελτίου αποστολής της ΑΑΔΕ: 8 καταστάσεις και 23 μεταβάσειςT01 · Έκδοση (εκδότης)T02 · Έκδοση χωρίς ψηφιακή παρακολούθηση (εκδότης)T03 · Έναρξη μεταφοράς (μεταφορέας)T04 · Ακύρωση πριν την έναρξη (εκδότης)T05 · Απόρριψη πριν την έναρξη (παραλήπτης)T06 · Αλλαγή οχήματος / νέα σάρωση (μεταφορέας)T07 · Δεν παραδόθηκε — NONE (μεταφορέας)T08 · Απόρριψη στον δρόμο (παραλήπτης)T09 · Παραδόθηκε όλο — FULL (μεταφορέας)T10 · Παραδόθηκε μέρος — PARTIAL + συσκευασίες (μεταφορέας)T11 · Παραδόθηκε όλο σε παραλήπτη χωρίς υποχρέωση (μεταφορέας)T12 · Παραλαβή όλων — FULL (παραλήπτης)T13 · Επιβεβαίωση επιστροφής — αντίστροφο 9.3 ή 9.2 (εκδότης)T14 · Επιβεβαίωση παραλαβής μετά την παράδοση (παραλήπτης)T15 · Απόρριψη μετά την παράδοση (παραλήπτης)T16 · Επιστροφή στην αποθήκη μετά από μερική (μεταφορέας)T17 · Κλείσιμο από τον εκδότη μετά από μερική (εκδότης)T18 · Επιστροφή στην αποθήκη μετά την απόρριψη (μεταφορέας)T19 · Κλείσιμο από τον εκδότη μετά την απόρριψη (εκδότης)T20 · Επιστροφή στην αποθήκη μετά την αποτυχία (μεταφορέας)T21 · Κλείσιμο από τον εκδότη μετά την αποτυχία (εκδότης)T22 · Αλλαγή οχήματος στην επιστροφή (μεταφορέας)T23 · Επιβεβαίωση επιστροφής (εκδότης)ΈκδοσηΚαταχωρίστηκεΑκυρώθηκεΣε μεταφοράΑποτυχημένηπαράδοσηΑπορρίφθηκεΠαραδόθηκεαπό τονμεταφορέαΣε μεταφορά(επιστροφή)Ολοκληρώθηκε
Ρόλοι:εκδότηςμεταφορέαςπαραλήπτηςΤο διάγραμμα σχεδιάζεται από το ίδιο αρχείο που χρησιμοποιεί η σελίδα «Δοκιμαστικά δελτία» της διαχείρισης.
Όλες οι μεταβάσεις του διαγράμματος
  1. T01Έκδοση (εκδότης)Έκδοση → Καταχωρίστηκε
  2. T02Έκδοση χωρίς ψηφιακή παρακολούθηση (εκδότης)Έκδοση → Ολοκληρώθηκε
  3. T03Έναρξη μεταφοράς (μεταφορέας)Καταχωρίστηκε → Σε μεταφορά
  4. T04Ακύρωση πριν την έναρξη (εκδότης)Καταχωρίστηκε → Ακυρώθηκε
  5. T05Απόρριψη πριν την έναρξη (παραλήπτης)Καταχωρίστηκε → Απορρίφθηκε
  6. T06Αλλαγή οχήματος / νέα σάρωση (μεταφορέας)Σε μεταφορά → Σε μεταφορά
  7. T07Δεν παραδόθηκε — NONE (μεταφορέας)Σε μεταφορά → Αποτυχημένη παράδοση
  8. T08Απόρριψη στον δρόμο (παραλήπτης)Σε μεταφορά → Απορρίφθηκε
  9. T09Παραδόθηκε όλο — FULL (μεταφορέας)Σε μεταφορά → Παραδόθηκε από τον μεταφορέα
  10. T10Παραδόθηκε μέρος — PARTIAL + συσκευασίες (μεταφορέας)Σε μεταφορά → Παραδόθηκε από τον μεταφορέα
  11. T11Παραδόθηκε όλο σε παραλήπτη χωρίς υποχρέωση (μεταφορέας)Σε μεταφορά → Ολοκληρώθηκε
  12. T12Παραλαβή όλων — FULL (παραλήπτης)Σε μεταφορά → Ολοκληρώθηκε
  13. T13Επιβεβαίωση επιστροφής — αντίστροφο 9.3 ή 9.2 (εκδότης)Σε μεταφορά → Ολοκληρώθηκε
  14. T14Επιβεβαίωση παραλαβής μετά την παράδοση (παραλήπτης)Παραδόθηκε από τον μεταφορέα → Ολοκληρώθηκε
  15. T15Απόρριψη μετά την παράδοση (παραλήπτης)Παραδόθηκε από τον μεταφορέα → Απορρίφθηκε
  16. T16Επιστροφή στην αποθήκη μετά από μερική (μεταφορέας)Παραδόθηκε από τον μεταφορέα → Σε μεταφορά (επιστροφή)
  17. T17Κλείσιμο από τον εκδότη μετά από μερική (εκδότης)Παραδόθηκε από τον μεταφορέα → Ολοκληρώθηκε
  18. T18Επιστροφή στην αποθήκη μετά την απόρριψη (μεταφορέας)Απορρίφθηκε → Σε μεταφορά (επιστροφή)
  19. T19Κλείσιμο από τον εκδότη μετά την απόρριψη (εκδότης)Απορρίφθηκε → Ολοκληρώθηκε
  20. T20Επιστροφή στην αποθήκη μετά την αποτυχία (μεταφορέας)Αποτυχημένη παράδοση → Σε μεταφορά (επιστροφή)
  21. T21Κλείσιμο από τον εκδότη μετά την αποτυχία (εκδότης)Αποτυχημένη παράδοση → Ολοκληρώθηκε
  22. T22Αλλαγή οχήματος στην επιστροφή (μεταφορέας)Σε μεταφορά (επιστροφή) → Σε μεταφορά (επιστροφή)
  23. T23Επιβεβαίωση επιστροφής (εκδότης)Σε μεταφορά (επιστροφή) → Ολοκληρώθηκε

Σενάρια S1–S9

Εννέα σενάρια από την καθημερινή δουλειά

Κάθε σενάριο είναι μια πραγματική διαδρομή στο διάγραμμα. Πατήστε ▶ για να δείτε τη διαδρομή βήμα προς βήμα.

S1

Έναρξη και σάρωση

Η εταιρεία εκδίδει το δελτίο και η ΑΑΔΕ το καταχωρίζει. Ο οδηγός σαρώνει το QR στο κινητό και πατά «Έναρξη μεταφοράς»· η ΑΑΔΕ γράφει το δελτίο «Σε μεταφορά». Ένα δελτίο χωρίς ψηφιακή παρακολούθηση ολοκληρώνεται ήδη με την έκδοσή του.

  • Έναρξη και σάρωση
    1. T01Έκδοση (εκδότης)Έκδοση → Καταχωρίστηκε
    2. T03Έναρξη μεταφοράς (μεταφορέας)Καταχωρίστηκε → Σε μεταφορά
  • Χωρίς ψηφιακή παρακολούθηση
    1. T02Έκδοση χωρίς ψηφιακή παρακολούθηση (εκδότης)Έκδοση → Ολοκληρώθηκε
S2

Παράδοση με επιτυχία

Ο οδηγός παραδίδει όλο το εμπόρευμα και το δηλώνει από το κινητό. Ο παραλήπτης επιβεβαιώνει την παραλαβή ή την απορρίπτει. Όταν ο παραλήπτης δεν έχει υποχρέωση επιβεβαίωσης, το δελτίο ολοκληρώνεται με την παράδοση.

  • Παράδοση με επιτυχία
    1. T01Έκδοση (εκδότης)Έκδοση → Καταχωρίστηκε
    2. T03Έναρξη μεταφοράς (μεταφορέας)Καταχωρίστηκε → Σε μεταφορά
    3. T09Παραδόθηκε όλο — FULL (μεταφορέας)Σε μεταφορά → Παραδόθηκε από τον μεταφορέα
    4. T14Επιβεβαίωση παραλαβής μετά την παράδοση (παραλήπτης)Παραδόθηκε από τον μεταφορέα → Ολοκληρώθηκε
  • Παραλήπτης χωρίς υποχρέωση
    1. T01Έκδοση (εκδότης)Έκδοση → Καταχωρίστηκε
    2. T03Έναρξη μεταφοράς (μεταφορέας)Καταχωρίστηκε → Σε μεταφορά
    3. T11Παραδόθηκε όλο σε παραλήπτη χωρίς υποχρέωση (μεταφορέας)Σε μεταφορά → Ολοκληρώθηκε
  • Απόρριψη μετά την παράδοση
    1. T01Έκδοση (εκδότης)Έκδοση → Καταχωρίστηκε
    2. T03Έναρξη μεταφοράς (μεταφορέας)Καταχωρίστηκε → Σε μεταφορά
    3. T09Παραδόθηκε όλο — FULL (μεταφορέας)Σε μεταφορά → Παραδόθηκε από τον μεταφορέα
    4. T15Απόρριψη μετά την παράδοση (παραλήπτης)Παραδόθηκε από τον μεταφορέα → Απορρίφθηκε
S3

Παράδοση χωρίς επιτυχία

Ο οδηγός δεν μπορεί να παραδώσει. Το εμπόρευμα γυρίζει στην αποθήκη και ο εκδότης επιβεβαιώνει την επιστροφή — ή ο εκδότης κλείνει απευθείας το δελτίο.

  • Δεν παραδόθηκε — επιστροφή στην αποθήκη
    1. T01Έκδοση (εκδότης)Έκδοση → Καταχωρίστηκε
    2. T03Έναρξη μεταφοράς (μεταφορέας)Καταχωρίστηκε → Σε μεταφορά
    3. T07Δεν παραδόθηκε — NONE (μεταφορέας)Σε μεταφορά → Αποτυχημένη παράδοση
    4. T20Επιστροφή στην αποθήκη μετά την αποτυχία (μεταφορέας)Αποτυχημένη παράδοση → Σε μεταφορά (επιστροφή)
    5. T22Αλλαγή οχήματος στην επιστροφή (μεταφορέας)Σε μεταφορά (επιστροφή) → Σε μεταφορά (επιστροφή)
    6. T23Επιβεβαίωση επιστροφής (εκδότης)Σε μεταφορά (επιστροφή) → Ολοκληρώθηκε
  • Δεν παραδόθηκε — κλείσιμο από τον εκδότη
    1. T01Έκδοση (εκδότης)Έκδοση → Καταχωρίστηκε
    2. T03Έναρξη μεταφοράς (μεταφορέας)Καταχωρίστηκε → Σε μεταφορά
    3. T07Δεν παραδόθηκε — NONE (μεταφορέας)Σε μεταφορά → Αποτυχημένη παράδοση
    4. T21Κλείσιμο από τον εκδότη μετά την αποτυχία (εκδότης)Αποτυχημένη παράδοση → Ολοκληρώθηκε
S4

Μερική παράδοση

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

  • Μερική παράδοση — επιστροφή στην αποθήκη
    1. T01Έκδοση (εκδότης)Έκδοση → Καταχωρίστηκε
    2. T03Έναρξη μεταφοράς (μεταφορέας)Καταχωρίστηκε → Σε μεταφορά
    3. T10Παραδόθηκε μέρος — PARTIAL + συσκευασίες (μεταφορέας)Σε μεταφορά → Παραδόθηκε από τον μεταφορέα
    4. T16Επιστροφή στην αποθήκη μετά από μερική (μεταφορέας)Παραδόθηκε από τον μεταφορέα → Σε μεταφορά (επιστροφή)
    5. T23Επιβεβαίωση επιστροφής (εκδότης)Σε μεταφορά (επιστροφή) → Ολοκληρώθηκε
  • Μερική παράδοση — κλείσιμο από τον εκδότη
    1. T01Έκδοση (εκδότης)Έκδοση → Καταχωρίστηκε
    2. T03Έναρξη μεταφοράς (μεταφορέας)Καταχωρίστηκε → Σε μεταφορά
    3. T10Παραδόθηκε μέρος — PARTIAL + συσκευασίες (μεταφορέας)Σε μεταφορά → Παραδόθηκε από τον μεταφορέα
    4. T17Κλείσιμο από τον εκδότη μετά από μερική (εκδότης)Παραδόθηκε από τον μεταφορέα → Ολοκληρώθηκε
S5

Παραλαβή σαν κατάστημα

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

  • Παραλαβή σαν κατάστημα
    1. T01Έκδοση (εκδότης)Έκδοση → Καταχωρίστηκε
    2. T03Έναρξη μεταφοράς (μεταφορέας)Καταχωρίστηκε → Σε μεταφορά
    3. T12Παραλαβή όλων — FULL (παραλήπτης)Σε μεταφορά → Ολοκληρώθηκε
  • Απόρριψη πριν την έναρξη
    1. T01Έκδοση (εκδότης)Έκδοση → Καταχωρίστηκε
    2. T05Απόρριψη πριν την έναρξη (παραλήπτης)Καταχωρίστηκε → Απορρίφθηκε
  • Απόρριψη στον δρόμο — επιστροφή στην αποθήκη
    1. T01Έκδοση (εκδότης)Έκδοση → Καταχωρίστηκε
    2. T03Έναρξη μεταφοράς (μεταφορέας)Καταχωρίστηκε → Σε μεταφορά
    3. T08Απόρριψη στον δρόμο (παραλήπτης)Σε μεταφορά → Απορρίφθηκε
    4. T18Επιστροφή στην αποθήκη μετά την απόρριψη (μεταφορέας)Απορρίφθηκε → Σε μεταφορά (επιστροφή)
    5. T23Επιβεβαίωση επιστροφής (εκδότης)Σε μεταφορά (επιστροφή) → Ολοκληρώθηκε
  • Απόρριψη στον δρόμο — κλείσιμο από τον εκδότη
    1. T01Έκδοση (εκδότης)Έκδοση → Καταχωρίστηκε
    2. T03Έναρξη μεταφοράς (μεταφορέας)Καταχωρίστηκε → Σε μεταφορά
    3. T08Απόρριψη στον δρόμο (παραλήπτης)Σε μεταφορά → Απορρίφθηκε
    4. T19Κλείσιμο από τον εκδότη μετά την απόρριψη (εκδότης)Απορρίφθηκε → Ολοκληρώθηκε
S6

Λάστιχο / αλλαγή οχήματος και νέα σάρωση

Το όχημα σταματά στον δρόμο. Ο οδηγός περνά το εμπόρευμα σε άλλο όχημα, αλλάζει την πινακίδα στην εφαρμογή και σαρώνει ξανά· το δελτίο μένει «Σε μεταφορά».

  • Άλλαξα όχημα
    1. T01Έκδοση (εκδότης)Έκδοση → Καταχωρίστηκε
    2. T03Έναρξη μεταφοράς (μεταφορέας)Καταχωρίστηκε → Σε μεταφορά
    3. T06Αλλαγή οχήματος / νέα σάρωση (μεταφορέας)Σε μεταφορά → Σε μεταφορά
S7

Παράδοση σε άλλον οδηγό στον δρόμο

Άλλος οδηγός, της ίδιας ή άλλης εταιρείας, σαρώνει το ίδιο QR και συνεχίζει τη μεταφορά· το δελτίο μένει «Σε μεταφορά».

  • Παράδοση σε άλλον οδηγό (άλλη εταιρεία)
    1. T01Έκδοση (εκδότης)Έκδοση → Καταχωρίστηκε
    2. T03Έναρξη μεταφοράς (μεταφορέας)Καταχωρίστηκε → Σε μεταφορά
    3. T06Αλλαγή οχήματος / νέα σάρωση (μεταφορέας)Σε μεταφορά → Σε μεταφορά
  • Παράδοση σε άλλον οδηγό (ίδια εταιρεία)
    1. T01Έκδοση (εκδότης)Έκδοση → Καταχωρίστηκε
    2. T03Έναρξη μεταφοράς (μεταφορέας)Καταχωρίστηκε → Σε μεταφορά
    3. T06Αλλαγή οχήματος / νέα σάρωση (μεταφορέας)Σε μεταφορά → Σε μεταφορά
S8

Ακύρωση

Ο εκδότης ακυρώνει το δελτίο — μόνο πριν ξεκινήσει η μεταφορά.

Μετά την «Έναρξη μεταφοράς» η ΑΑΔΕ δεν δέχεται ακύρωση (σφάλμα 801): ο οδηγός πατά «Δεν παραδόθηκε» και «Επιστροφή στην αποθήκη», και ο εκδότης «Επιβεβαίωση επιστροφής».

  • Ακύρωση πριν την έναρξη
    1. T01Έκδοση (εκδότης)Έκδοση → Καταχωρίστηκε
    2. T04Ακύρωση πριν την έναρξη (εκδότης)Καταχωρίστηκε → Ακυρώθηκε
S9

Δελτίο επιστροφής εταιρείας–πελάτη

Το εμπόρευμα γυρίζει από τον πελάτη στην εταιρεία: με δελτίο επιστροφής του πελάτη, με αντίστροφο δελτίο ή με δελτίο 9.2 χωρίς παραλήπτη, όπου ο εκδότης επιβεβαιώνει την επιστροφή.

  • Δελτίο επιστροφής πελάτη (σκοπός 5)
    1. T01Έκδοση (εκδότης)Έκδοση → Καταχωρίστηκε
    2. T03Έναρξη μεταφοράς (μεταφορέας)Καταχωρίστηκε → Σε μεταφορά
    3. T09Παραδόθηκε όλο — FULL (μεταφορέας)Σε μεταφορά → Παραδόθηκε από τον μεταφορέα
  • Αντίστροφο δελτίο
    1. T01Έκδοση (εκδότης)Έκδοση → Καταχωρίστηκε
    2. T03Έναρξη μεταφοράς (μεταφορέας)Καταχωρίστηκε → Σε μεταφορά
    3. T13Επιβεβαίωση επιστροφής — αντίστροφο 9.3 ή 9.2 (εκδότης)Σε μεταφορά → Ολοκληρώθηκε
  • Δελτίο 9.2 (χωρίς παραλήπτη)
    1. T01Έκδοση (εκδότης)Έκδοση → Καταχωρίστηκε
    2. T03Έναρξη μεταφοράς (μεταφορέας)Καταχωρίστηκε → Σε μεταφορά
    3. T13Επιβεβαίωση επιστροφής — αντίστροφο 9.3 ή 9.2 (εκδότης)Σε μεταφορά → Ολοκληρώθηκε

Διαδρομή του σεναρίου στο διάγραμμα

Διαδρομή του σεναρίου στο διάγραμμαT01 · Έκδοση (εκδότης)T02 · Έκδοση χωρίς ψηφιακή παρακολούθηση (εκδότης)T03 · Έναρξη μεταφοράς (μεταφορέας)T04 · Ακύρωση πριν την έναρξη (εκδότης)T05 · Απόρριψη πριν την έναρξη (παραλήπτης)T06 · Αλλαγή οχήματος / νέα σάρωση (μεταφορέας)T07 · Δεν παραδόθηκε — NONE (μεταφορέας)T08 · Απόρριψη στον δρόμο (παραλήπτης)T09 · Παραδόθηκε όλο — FULL (μεταφορέας)T10 · Παραδόθηκε μέρος — PARTIAL + συσκευασίες (μεταφορέας)T11 · Παραδόθηκε όλο σε παραλήπτη χωρίς υποχρέωση (μεταφορέας)T12 · Παραλαβή όλων — FULL (παραλήπτης)T13 · Επιβεβαίωση επιστροφής — αντίστροφο 9.3 ή 9.2 (εκδότης)T14 · Επιβεβαίωση παραλαβής μετά την παράδοση (παραλήπτης)T15 · Απόρριψη μετά την παράδοση (παραλήπτης)T16 · Επιστροφή στην αποθήκη μετά από μερική (μεταφορέας)T17 · Κλείσιμο από τον εκδότη μετά από μερική (εκδότης)T18 · Επιστροφή στην αποθήκη μετά την απόρριψη (μεταφορέας)T19 · Κλείσιμο από τον εκδότη μετά την απόρριψη (εκδότης)T20 · Επιστροφή στην αποθήκη μετά την αποτυχία (μεταφορέας)T21 · Κλείσιμο από τον εκδότη μετά την αποτυχία (εκδότης)T22 · Αλλαγή οχήματος στην επιστροφή (μεταφορέας)T23 · Επιβεβαίωση επιστροφής (εκδότης)ΈκδοσηΚαταχωρίστηκεΑκυρώθηκεΣε μεταφοράΑποτυχημένηπαράδοσηΑπορρίφθηκεΠαραδόθηκεαπό τονμεταφορέαΣε μεταφορά(επιστροφή)Ολοκληρώθηκε

Διαλέξτε ένα σενάριο και πατήστε ▶ Αναπαραγωγή.

Ρόλοι:εκδότηςμεταφορέαςπαραλήπτης

Τοπολογία

Ένα δίκτυο κόμβων — όχι ένας διακομιστής

Τρεις ή περισσότεροι κόμβοι σε διαφορετικά datacenter, σε διαφορετικές πόλεις ή χώρες. Το κινητό του οδηγού μιλά με τους κόμβους και οι κόμβοι μιλούν με την ΑΑΔΕ· ο διακομιστής διαχείρισης δίνει στους κόμβους τις ρυθμίσεις και τα κλειδιά.

Τοπολογία: το κινητό του οδηγού στέλνει στους κόμβους, οι κόμβοι στέλνουν στην ΑΑΔΕ, ο διακομιστής διαχείρισης ρυθμίζει τους κόμβουςΔιακομιστής διαχείρισηςρυθμίσεις · κλειδιάΚινητό οδηγούΚόμβος 1datacenter ΑΚόμβος 2datacenter ΒΚόμβος 3datacenter ΓΑΑΔΕ myDATA
  • Από προεπιλογή κάθε οργανισμός εξυπηρετείται από όλους τους κόμβους· ένας νέος κόμβος παίρνει μόνος του όλους τους οργανισμούς.
  • Κάθε κινητό μοιράζει τις νέες πράξεις του στους κόμβους με μια τυχαία σειρά της ημέρας· έναν κόμβο που δεν απαντά τον αφήνει στην άκρη για 15 λεπτά.
  • Μετά την ενεργοποίηση το κινητό δεν χρειάζεται τον διακομιστή διαχείρισης για καμία πράξη.

Υψηλή διαθεσιμότητα

Συνεχίζει να δουλεύει όταν κάτι σταματά

Τέσσερις καταστάσεις που συμβαίνουν στην πράξη — και τι κάνει το σύστημα σε καθεμία.

Κινούμενη εικόνα: τι γίνεται όταν σταματά ένας κόμβος, όταν αποσυνδέεται ο διακομιστής διαχείρισης, όταν η ΑΑΔΕ είναι φορτωμένη και όταν χάνεται μια απάντησηΔιακομιστής διαχείρισηςρυθμίσεις · κλειδιάΚινητό οδηγούΚόμβος 1datacenter ΑΚόμβος 2datacenter ΒΚόμβος 3datacenter ΓΑΑΔΕ myDATA
  1. Το κινητό στέλνει τις νέες πράξεις στον επόμενο κόμβο της σειράς του και παρακάμπτει τον κόμβο που δεν απαντά. Μια πράξη που είχε ήδη παραλάβει εκείνος ο κόμβος δεν μετακινείται σιωπηλά: φαίνεται ως μη επιβεβαιωμένη και ο οδηγός αποφασίζει αν θα τη στείλει ξανά.

  2. Οι οδηγοί συνεχίζουν κανονικά: μετά την ενεργοποίηση όλες οι πράξεις, οι αναγνώσεις και οι λίστες πηγαίνουν στους κόμβους. Ο διακομιστής διαχείρισης χρειάζεται για την ενεργοποίηση του κινητού — μία φορά.

  3. Όταν η ΑΑΔΕ απαντά ότι είναι φορτωμένη (429), η πράξη δεν έχει καταχωριστεί. Ο κόμβος ξαναστέλνει μόνος του την ίδια πράξη μετά τον χρόνο αναμονής που ορίζει η ΑΑΔΕ, μέχρι να απαντήσει· ο οδηγός βλέπει αμέσως «Η ΑΑΔΕ είναι φορτωμένη — ξαναστέλνεται αυτόματα».

  4. Αν χαθεί η απάντηση ενός αιτήματος, το κινητό ξαναρωτά τον ίδιο κόμβο για την ίδια πράξη — ποτέ άλλον. Ένα δεύτερο πάτημα της αποστολής διαβάζει την ίδια πράξη· δεν δημιουργεί δεύτερη.

Γιατί «σχεδόν 100%»

Για τον οδηγό η υπηρεσία είναι διαθέσιμη σχεδόν 100% του χρόνου, γιατί:

  • οι κόμβοι είναι πολλοί και ανεξάρτητοι, σε διαφορετικά datacenter — για να σταματήσει η υπηρεσία πρέπει να σταματήσουν όλοι μαζί·
  • το κινητό περνά μόνο του στον επόμενο κόμβο, χωρίς να χρειαστεί κανείς να κάνει κάτι·
  • ο διακομιστής διαχείρισης δεν βρίσκεται στον δρόμο της πράξης·
  • όταν η ΑΑΔΕ είναι φορτωμένη, η πράξη δεν χάνεται: ο κόμβος την ξαναστέλνει.

Γιατί «σχεδόν» και όχι ένας αριθμός: η ίδια η ΑΑΔΕ, η σύνδεση του κινητού στο δίκτυο και μια πράξη που περιμένει τον κόμβο που την παρέλαβε δεν εξαρτώνται μόνο από εμάς. Δεν δίνουμε ποσοστό που δεν έχει μετρηθεί.

Ασφάλεια · ταχύτητα · έλεγχος

Ασφάλεια

Οι παρακάτω δηλώσεις αντιστοιχούν σε ελέγχους που υπάρχουν στο προϊόν και ελέγχονται με επαναλήψιμες δοκιμές.

  • Κρυπτογραφημένη σύνδεση HTTPS παντού· στην παραγωγή οι απαντήσεις δηλώνουν HSTS.
  • Υποχρεωτική ταυτοποίηση δύο παραγόντων (2FA) για τους λογαριασμούς διαχείρισης, με κωδικούς ανάκτησης· δεν υπάρχει προεπιλεγμένος κωδικός.
  • Οι συνεδρίες λήγουν έπειτα από 30 λεπτά αδράνειας και το πολύ 12 ώρες· για μυστικά και κρίσιμες ενέργειες ζητείται νέα επαλήθευση.
  • Όρια ρυθμού στη σύνδεση της διαχείρισης και στα κλειδιά διαχειριστή περιορίζουν τις επαναλαμβανόμενες δοκιμές.
  • Κάθε κλειδί API περιορίζεται από τον οργανισμό, τα δικαιώματα και το περιβάλλον του και ανακαλείται αμέσως.
  • Τα διαπιστευτήρια ΑΑΔΕ και τα μυστικά δεν γράφονται ποτέ σε διευθύνσεις URL ή αρχεία καταγραφής· αποθηκεύονται κρυπτογραφημένα και μετά την καταχώριση δεν επιστρέφονται από κανένα API.
  • Οι ενέργειες διαχείρισης καταγράφονται σε αρχείο ελέγχου που μόνο προστίθεται· οι διορθώσεις γίνονται με συνδεδεμένες εγγραφές, όχι με αλλαγή.
  • Η σύνδεση προς την ΑΑΔΕ επαληθεύει πάντα το πιστοποιητικό TLS χωρίς δυνατότητα παράκαμψης και δεν ακολουθεί αυτόματες ανακατευθύνσεις.
  • Τα αρχεία πρόσβασης δεν περιέχουν query strings, κλειδιά, cookies ή περιεχόμενο αιτημάτων και διατηρούνται 14 ημέρες.
  • Το κινητό του οδηγού ενεργοποιείται με κωδικό μίας χρήσης που λήγει σε 15 λεπτά έως 4 ώρες· το κλειδί ενός χαμένου κινητού ανακαλείται ξεχωριστά.
  • Έχει εκτελεστεί ενεργός έλεγχος ασφαλείας σε περιβάλλον staging, με σενάρια όπως πρόσβαση μεταξύ οργανισμών, injection, κλιμάκωση δικαιωμάτων και έκθεση μυστικών.

Ταχύτητα χωρίς αναμονή

Ο οδηγός παίρνει απάντηση αμέσως και βλέπει ζωντανά την απάντηση της ΑΑΔΕ· όταν η ΑΑΔΕ αργεί, ο κόμβος συνεχίζει την αποστολή στο παρασκήνιο. Δεν δημοσιεύουμε χρόνους που δεν έχουν μετρηθεί σε παραγωγή.

Αρχείο ελέγχου

Κάθε ενέργεια διαχείρισης γράφεται με το ποιος, τι, πότε και το αποτέλεσμα, με τα μυστικά κρυμμένα. Οι εγγραφές μόνο προστίθενται· μια διόρθωση είναι νέα, συνδεδεμένη εγγραφή. Κάθε αποστολή στην ΑΑΔΕ κρατά το αίτημα και την απάντηση της ΑΑΔΕ.

Τι μας ξεχωρίζει

Μετρά μόνο η απάντηση της ΑΑΔΕ

Μια πράξη φαίνεται επιβεβαιωμένη μόνο όταν την επιβεβαιώσει η ίδια η ΑΑΔΕ. Κάθε ενέργεια του οδηγού φτάνει στην ΑΑΔΕ και η απάντησή της αποφασίζει.

Όλο το διάγραμμα δοκιμασμένο

Και οι 23 μεταβάσεις του διαγράμματος της ΑΑΔΕ, μαζί με τα σενάρια S1–S9, εκτελέστηκαν με πραγματικές κλήσεις στο περιβάλλον δοκιμών της ΑΑΔΕ.

Εφαρμογή οδηγού χωρίς store

Ανοίγει στον browser του κινητού και ενεργοποιείται με QR, με πληκτρολόγηση κωδικού ή με σύνδεσμο στο email. Η πινακίδα του οχήματος φαίνεται σε κάθε οθόνη και η «Μαζική αποστολή» στέλνει πολλά δελτία μαζί.

Ίδιοι κανόνες για κάθε σύστημα

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

Δοκιμαστικά δελτία

Η σελίδα «Δοκιμαστικά δελτία» της διαχείρισης εκδίδει δελτία στο περιβάλλον δοκιμών της ΑΑΔΕ, δείχνει το διάγραμμα και τα σενάρια, με ό,τι στάλθηκε και την απάντηση της ΑΑΔΕ.

Ιστορικό, στατιστικά, εξαγωγές

Ιστορικό πράξεων, στατιστικά και εξαγωγές για κάθε οργανισμό — μόνο για τα δικά του δεδομένα.

FAQ

Συχνές ερωτήσεις

Σύντομες απαντήσεις· η καθεμία στηρίζεται σε κανόνα του προϊόντος.

Με ποια έκδοση της ΑΑΔΕ είναι συμβατό;

Με το myDATA Delivery Note v2.0.2 και τα επίσημα XSD v2.0.2. Οι 23 μεταβάσεις του διαγράμματος και τα σενάρια S1–S9 εκτελέστηκαν στο περιβάλλον δοκιμών της ΑΑΔΕ.

Πότε θεωρείται καταχωρισμένη μια πράξη;

Μόνο όταν το επιβεβαιώσει η ίδια η ΑΑΔΕ. Μέχρι τότε η πράξη φαίνεται ως μη επιβεβαιωμένη· η απάντηση της ΑΑΔΕ φαίνεται στον οδηγό όπως είναι.

Χρειάζεται ο οδηγός να εγκαταστήσει εφαρμογή;

Όχι από κάποιο store. Πατά «Είσοδος οδηγού» σε αυτή τη σελίδα, από τον browser του κινητού, και ενεργοποιεί το κινητό με QR, με κωδικό ή με σύνδεσμο στο email. Ο κωδικός είναι μίας χρήσης και ισχύει από 15 λεπτά έως 4 ώρες, όπως τον ορίσει ο οργανισμός.

Τι γίνεται αν σταματήσει ένας κόμβος;

Οι νέες πράξεις πηγαίνουν στον επόμενο κόμβο και ο κόμβος που δεν απαντά παρακάμπτεται για 15 λεπτά. Μια πράξη που είχε παραλάβει εκείνος ο κόμβος δεν στέλνεται κρυφά σε άλλον· φαίνεται ως μη επιβεβαιωμένη και ο οδηγός μπορεί να τη στείλει ξανά.

Τι γίνεται αν δεν απαντά ο διακομιστής διαχείρισης;

Οι οδηγοί συνεχίζουν: μετά την ενεργοποίηση δουλεύουν μόνο με τους κόμβους. Τον διακομιστή διαχείρισης τον χρειάζονται για την ενεργοποίηση και για τη διαχείριση του οργανισμού.

Τι γίνεται όταν η ΑΑΔΕ είναι φορτωμένη;

Η πράξη δεν έχει καταχωριστεί και ο κόμβος την ξαναστέλνει μόνος του μετά τον χρόνο αναμονής της ΑΑΔΕ. Ο οδηγός βλέπει «Η ΑΑΔΕ είναι φορτωμένη — ξαναστέλνεται αυτόματα» και μετά την απάντηση της ΑΑΔΕ.

Αν ο οδηγός πατήσει δύο φορές, στέλνεται διπλή πράξη;

Όχι κατά λάθος: όσο στέλνεται μια πράξη, ένα δεύτερο πάτημα διαβάζει την ίδια πράξη. Μια νέα ενέργεια του οδηγού είναι νέα αποστολή και αποφασίζει η ΑΑΔΕ.

Ακυρώνεται ένα δελτίο αφού ξεκινήσει η μεταφορά;

Όχι — η ΑΑΔΕ επιτρέπει ακύρωση μόνο από τον εκδότη και μόνο πριν την έναρξη. Μετά, ο οδηγός πατά «Δεν παραδόθηκε» και «Επιστροφή στην αποθήκη», και ο εκδότης «Επιβεβαίωση επιστροφής».

Μπορώ να συνδέσω το ERP ή τη δική μου εφαρμογή;

Ναι, με το REST API και τη βιβλιοθήκη Java για Android και ERP. Η τεκμηρίωση γράφεται για τον προγραμματιστή και για το AI που τη χρησιμοποιεί.

Πού φυλάσσονται οι κωδικοί ΑΑΔΕ του οργανισμού;

Κρυπτογραφημένοι στον διακομιστή. Μετά την καταχώριση κανένα API δεν τους επιστρέφει — ούτε στο προσωπικό της Smartnav· μπορούν μόνο να αντικατασταθούν με νέους.

Μπορώ να δοκιμάσω χωρίς πραγματικά δελτία;

Ναι. Η σελίδα «Δοκιμαστικά δελτία» εκδίδει δελτία στο περιβάλλον δοκιμών της ΑΑΔΕ και τρέχει τα σενάρια, με ό,τι στάλθηκε και την απάντηση της ΑΑΔΕ.

Smartnav

Επικοινωνία

Για πληροφορίες, προσφορά ή υποστήριξη επικοινωνήστε μαζί μας.

Ελλάδα

Eleutheriou Venizelou Str. 10Metamorfosi – 14452 AtticaΤηλέφωνο: +30 211 1825900

Κύπρος

Lemesos Avenue 2, Cronos Complex2220 LeukosiaΤηλέφωνο: +357 22 100108