ForgeIT Invoice Portal
Ένα σημείο έκδοσης για όλα μας τα προϊόντα
Κεντρική πύλη τιμολόγησης: κάθε προϊόν μας στέλνει ένα αίτημα σε JSON, και η πύλη αριθμεί, υπολογίζει, φτιάχνει το XML, μιλά με το myDATA και γυρίζει πίσω υπογεγραμμένη απάντηση. Ένας μηχανισμός έκδοσης αντί για έναν σε κάθε προϊόν.
Το πρόβλημα
Επτά προϊόντα, επτά φορές το ίδιο δύσκολο κομμάτι
Κάθε προϊόν που πουλά κάτι πρέπει κάποια στιγμή να εκδώσει παραστατικό: αρίθμηση που δεν ανακυκλώνεται ποτέ, ακέραια λεπτά αντί για δεκαδικούς που δεν κλείνουν, XML που περνά πραγματικό XSD, και μια απάντηση από την ΑΑΔΕ που μπορεί και να μην έρθει. Γραμμένο επτά φορές, γίνεται επτά ευκαιρίες να διαφωνήσουν τα σύνολα — και επτά σημεία που πρέπει να ξαναδιαβάσεις κάθε φορά που αλλάζει κάτι στον νόμο.
Τι φτιάξαμε
Ένας εκδότης, και μια ουρά ανάμεσα σε όλους
Το Invoice Portal είναι το μοναδικό σημείο που μιλά με την ΑΑΔΕ. Τα υπόλοιπα προϊόντα κρατούν τις εμπορικές τους εγγραφές και στέλνουν ένα αίτημα με bearer token· η πύλη το αποθηκεύει, απαντά 202 και συνεχίζει σε ουρά. Το ManagoStores ήδη έπαψε να εκδίδει μόνο του και περνά από εδώ. Η επικοινωνία είναι machine-to-machine από άκρη σε άκρη — κανείς δεν αντιγράφει νούμερα από τη μια οθόνη στην άλλη.
Μέσα στο προϊόν
Τι υπάρχει πραγματικά μέσα
Ένα αίτημα, ένα παραστατικό
Το αναγνωριστικό που στέλνει ο ιστότοπος είναι μόνιμο: ίδιο id με ίδια δεδομένα σημαίνει το ίδιο παραστατικό, ίδιο id με άλλα δεδομένα απορρίπτεται. Μια κλήση που ξαναστάλθηκε δεν εκδίδει δεύτερο τιμολόγιο.
Ακέραιοι, ποτέ δεκαδικοί
Ποσά σε λεπτά, ποσότητες σε δεκάκις χιλιοστά, ποσοστά σε basis points, και στρογγυλοποίηση γραμμένη ρητά. Τα σύνολα ξαναϋπολογίζονται στον server πριν δεσμευτεί αριθμός· ό,τι έστειλε ο πελάτης δεν είναι ποτέ η αυθεντία.
Αριθμός που δεν γυρίζει πίσω
Η δέσμευση σειράς είναι μονόδρομη. Αποτυχία μετά τη δέσμευση ξαναπροσπαθεί με το ίδιο κλειδί αντί να πάρει καινούριο νούμερο, κανένας αριθμός δεν ανακυκλώνεται, και οριστικοποιημένο παραστατικό δεν επεξεργάζεται και δεν διαγράφεται από καμία διαδρομή.
XML πάνω σε πραγματικά XSD
Τα επίσημα σχήματα της ΑΑΔΕ είναι καρφωμένα στο repo με checksum ανά αρχείο. Ο έλεγχος τρέχει χωρίς DTD και με όριο χρόνου, και οι 21 τύποι παραστατικών 1.1 ως 11.5 έχουν αυτοματοποιημένες δοκιμές από πάνω τους.
Το «άγνωστο» δεν ξαναστέλνεται
Timeout ή απάντηση που δεν εμπιστευόμαστε δεν παράγει ποτέ δεύτερη υποβολή. Πρώτα ξαναδιαβάζεται η αρχειοθετημένη, κρυπτογραφημένη και hash-verified απάντηση· αν δεν αρκεί, γίνεται μόνο αναζήτηση. Ένα διπλό παραστατικό είναι χειρότερο από μια καθυστέρηση.
Υπογεγραμμένο callback
Η απάντηση γυρίζει στον ιστότοπο με HMAC-SHA256 πάνω σε χρονοσήμανση και σώμα, σε προορισμό που το αίτημα δεν μπορεί να αλλάξει. Ιδιωτικές διευθύνσεις, ανακατευθύνσεις και credentials μέσα σε query string απορρίπτονται πριν φύγει το πακέτο.
Κλειδιά με δύο δικαιώματα
Ένα κλειδί ιστοτόπου μπορεί να δημιουργεί και να διαβάζει αιτήματα, τίποτε άλλο, και είναι δεμένο σε συγκεκριμένο εκδότη και σειρά. Το πραγματικό κλειδί υπάρχει κρυπτογραφημένο μόνο ώσπου να σταλεί, και μόνο επαληθευμένος εσωτερικός διαχειριστής μπορεί να το εκδώσει.
Απομόνωση, όχι φίλτρο
Ο διαχωρισμός των εκδοτών επιβάλλεται στα δικαιώματα, στα queries, στους ελέγχους και στα constraints της βάσης — ποτέ στην οθόνη. Ξεχωριστό πάνελ υποστήριξης βλέπει μόνο ό,τι του έχει δοθεί ρητά, και μόνο για όσο ισχύει.
Φάκελος ασφάλειας
Μητρώα κινδύνων, τεκμήρια, περιστατικά, αλλαγές, backups και έλεγχοι πρόσβασης ζουν μέσα στο προϊόν και όχι σε ένα αρχείο Word. Είναι δουλεμένα ώστε να ταιριάζουν με ISO/IEC 27001 — που δεν είναι το ίδιο πράγμα με πιστοποίηση, και δεν το λέμε ποτέ έτσι.
Αποφάσεις-υπογραφή
Οι επιλογές που θα υπερασπιστούμε
Για ποιους είναι
Πρώτα τα δικά μας προϊόντα και οι δικές μας εκδόσεις. Η αρχιτεκτονική είναι φτιαγμένη για περισσότερους εκδότες, αλλά η έκδοση για τρίτους δεν ανοίγει πριν υπάρξουν οι άδειες που την επιτρέπουν.
-
Το ManagoStores έπαψε να εκδίδει δικά του τιμολόγια και στέλνει εδώ — και το ίδιο θα κάνει κάθε επόμενο προϊόν μας. Ένα κομμάτι που πρέπει να είναι σωστό, γραμμένο μία φορά.
-
Δεν είμαστε πιστοποιημένος πάροχος ηλεκτρονικής τιμολόγησης και δεν το γράφουμε πουθενά αλλιώς. Η έκδοση για τρίτους είναι σκόπιμα κλειστή στον κώδικα μέχρι να υπάρξουν οι άδειες, και το ίδιο το προϊόν αρνείται να την ανοίξει.
-
Ένα οριστικοποιημένο παραστατικό δεν σβήνεται ποτέ. Διορθώνεται με ακύρωση ή πιστωτικό, που είναι και ο μόνος τρόπος να παραμείνει το βιβλίο βιβλίο.
-
Σε αβέβαιο αποτέλεσμα το σύστημα προτιμά να περιμένει έναν άνθρωπο παρά να ξαναστείλει. Η επανάληψη είναι φθηνή· το διπλό παραστατικό δεν είναι.
Φτιαγμένο με
Η τεχνολογία από κάτω
Κι άλλα έργα μας
Όλα τα έργαManagoStores
Η σουίτα αποθήκης που ξέρει σε ποιο ράφι βρίσκεται
Μαθολόγιο
Ο χώρος εργασίας του εκπαιδευτικού — από το πλάνο του μαθήματος ως την πρόοδο του μαθητή
Ακινηταράς
Το λειτουργικό σύστημα ενός ακινήτου — από το συμβόλαιο ως τον λογαριασμό του υδραυλικού
FisikoTherapyHUB
Το hub της φυσικοθεραπείας — φτιαγμένο για να λύσει τα χέρια του φυσικοθεραπευτή αλλά και για του ασθενή
Radiopoli
Το ψηφιακό σπίτι του ελληνικού ραδιοφώνου — και το γραφείο απ' όπου το τρέχουν οι σταθμοί
Scoutaras
Το LinkedIn του ποδοσφαίρου και του μπάσκετ
We Forge your Internet.
Έχετε κάτι που θέλει σφυρηλάτηση;
Πείτε μας τι προσπαθείτε να φτιάξετε. Απαντάμε σε κάθε σοβαρό μήνυμα μέσα σε 24 ώρες — συνήθως με ερωτήσεις, μερικές φορές με ένα πρόχειρο πλάνο συνημμένο.
Χωρίς sales funnel, χωρίς chatbot. Το email φτάνει στο γραφείο ενός προγραμματιστή.
