Odoo 19 Community: Εμπορικό μητρώο και έλεγχος διευθύνσεων για πελάτες στην Αυστρία – το πρόσθετό μας ανοικτού κώδικα partner_firmenbuch_at

Όποιος δραστηριοποιείται επιχειρηματικά στην Αυστρία γνωρίζει αυτά τα ερωτήματα: Είναι σωστή η επωνυμία και η διεύθυνση του νέου μου πελάτη; Είναι η εταιρεία ακόμη εγγεγραμμένη στο εμπορικό μητρώο ή βρίσκεται υπό εκκαθάριση; Έχει κινηθεί διαδικασία αφερεγγυότητας για τον πελάτη που προμηθεύω εδώ και δύο χρόνια; Οι απαντήσεις βρίσκονται στο εμπορικό μητρώο (Firmenbuch) του Υπουργείου Δικαιοσύνης, αλλά ελάχιστοι το ελέγχουν τακτικά. Στο Odoo, η επαφή καταχωρίζεται μία φορά και στη συνέχεια τα στοιχεία της παλιώνουν.

Γι’ αυτό αναπτύξαμε το πρόσθετο Firmenbuch für Partner (partner_firmenbuch_at). Συνδέει τις επαφές του Odoo με το εμπορικό μητρώο και το επίσημο μητρώο διευθύνσεων του BEV. Έχει αναπτυχθεί για το Odoo 19 και διατίθεται δωρεάν στο GitHub ως ελεύθερο λογισμικό με άδεια LGPL-3:

github.com/Alex0176/odoo-partner-firmenbuch-at

Το πρόβλημα: βασικά στοιχεία που κανείς δεν ενημερώνει

Μια επαφή στο Odoo συνήθως δημιουργείται υπό πίεση χρόνου: όνομα, μια διεύθυνση στο περίπου, ίσως και ένας αριθμός ΦΠΑ. Αυτά αρκούν για την πρώτη προσφορά. Δεν αρκούν όμως για τιμολόγια στα οποία τα στοιχεία του παραλήπτη πρέπει να πληρούν τις νομικές απαιτήσεις, πόσο μάλλον για να αντιληφθείτε ότι κάτι έχει αλλάξει στον πελάτη. Στην πράξη εμφανίζονται τέσσερα κενά:

• Ελλιπή βασικά στοιχεία. Ο αριθμός εμπορικού μητρώου, το αρμόδιο δικαστήριο και η νομική μορφή λείπουν σχεδόν πάντα, επειδή η αναζήτησή τους γίνεται χειροκίνητα.
• Λανθασμένες καταχωρίσεις. Επωνυμία χωρίς τη νομική μορφή, τυπογραφικά λάθη στην οδό ή την πόλη, λάθος ταχυδρομικός κώδικας. Το πρόβλημα γίνεται αντιληπτό μόνο όταν επιστρέψει η αλληλογραφία.
• Απουσία παρακολούθησης. Αν ένα δικαστήριο κινήσει διαδικασία αφερεγγυότητας ή ένας πελάτης λύσει την εταιρεία του, το Odoo δεν ενημερώνεται. Το τμήμα πωλήσεων συνεχίζει τις παραδόσεις επί πιστώσει.
• Διάσπαρτες πηγές. Το εμπορικό μητρώο, οι ετήσιες οικονομικές καταστάσεις και το μητρώο διευθύνσεων βρίσκονται σε διαφορετικά σημεία. Όποιος θέλει να τα ελέγξει, αντιγράφει χειροκίνητα στοιχεία από το ένα παράθυρο του προγράμματος περιήγησης στο άλλο.

Τι κάνει το πρόσθετο

1. Αυτόματη αναζήτηση νέων εταιρειών. Όταν δημιουργείται μια επαφή ως εταιρεία (με χώρα την Αυστρία ή χωρίς συμπληρωμένη χώρα), το πρόσθετο πραγματοποιεί αναζήτηση στο εμπορικό μητρώο μέσα σε λίγα λεπτά. Αν βρεθεί ακριβώς ένα αποτέλεσμα, συμπληρώνονται τα κενά πεδία: οδός, ταχυδρομικός κώδικας, πόλη, χώρα, αριθμός εμπορικού μητρώου, αρμόδιο δικαστήριο και νομική μορφή.
2. Οι αποκλίσεις οδηγούν σε προτάσεις, ποτέ σε αυτόματη αντικατάσταση. Αν τα στοιχεία της επαφής διαφέρουν από εκείνα του μητρώου, δημιουργείται μια πρόταση αλλαγής, την οποία ένας υπάλληλος εγκρίνει ξεχωριστά για κάθε πεδίο.
3. Αναζήτηση στο εμπορικό μητρώο από την επαφή. Στην καρτέλα Εμπορικό μητρώο μπορείτε να αναζητήσετε εταιρείες με βάση την επωνυμία, ακόμη κι αν η αυτόματη αναζήτηση δεν έδωσε μοναδικό αποτέλεσμα.
4. Καθημερινή παρακολούθηση. Το πρόσθετο αναζητά καθημερινά ποιες εταιρείες και ποια έγγραφα έχουν μεταβληθεί στο μητρώο και ελέγχει τους αντίστοιχους πελάτες. Επιπλέον, κάθε εταιρεία επανελέγχεται πλήρως σε διαστήματα που μπορείτε να ορίσετε.
5. Επίπεδα προειδοποίησης. Εντοπίζονται οι διαδικασίες αφερεγγυότητας και εξυγίανσης που έχουν κινηθεί (μέσα από τα νομικά γεγονότα του μητρώου), η εκκαθάριση, η διαγραφή, τα αρνητικά ίδια κεφάλαια και ο χαμηλός δείκτης ιδίων κεφαλαίων, και εμφανίζονται στην επαφή.
6. Έλεγχος διευθύνσεων. Οι αυστριακές διευθύνσεις ελέγχονται τοπικά με βάση το επίσημο μητρώο διευθύνσεων της Ομοσπονδιακής Υπηρεσίας Μετρολογίας και Τοπογραφίας (BEV).
7. Στοιχεία μητρώου στην επαφή. Το αρμόδιο δικαστήριο, η νομική μορφή, οι διαχειριστές και τα νομικά γεγονότα εμφανίζονται στην καρτέλα Εμπορικό μητρώο. Αποτυπώνουν τα στοιχεία του μητρώου και ενημερώνονται απευθείας.
8. Μηνύματα μόνο εσωτερικά. Όλα τα μηνύματα αποστέλλονται στο εσωτερικό κανάλι Εμπορικό μητρώο του Discuss και στο Chatter της επαφής. Ένας έλεγχος πολλών εταιρειών δημιουργεί ένα συγκεντρωτικό μήνυμα αντί για ένα ανά εταιρεία. Το πρόσθετο δεν στέλνει ποτέ τίποτα στους πελάτες.

Προτάσεις αντί για αντικατάσταση στοιχείων

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

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

Προειδοποιήσεις: αφερεγγυότητα, εκκαθάριση, ισολογισμός

Το πρόσθετο διακρίνει τρία επίπεδα:

• Χωρίς ενδείξεις κινδύνου: Δεν υπάρχει κάτι προς αναφορά.
• Προειδοποίηση (κίτρινο): Στο μητρώο υπάρχουν ισχύουσες καταχωρίσεις για εκκαθάριση, λύση, περάτωση εργασιών, διαγραφή ή συγχώνευση, η εταιρεία έχει επισημανθεί ως διαγραμμένη ή μια προηγούμενη διαδικασία αφερεγγυότητας έχει περατωθεί τα τελευταία χρόνια (προεπιλογή: τρία έτη, με δυνατότητα ρύθμισης). Εναλλακτικά, οι ετήσιες οικονομικές καταστάσεις εμφανίζουν αρνητικά ίδια κεφάλαια, δείκτη ιδίων κεφαλαίων κάτω από 8 % (προεπιλογή βάσει του § 23 URG, με δυνατότητα ρύθμισης), ετήσια ζημία ή μείωση κύκλου εργασιών κατά 25 % και άνω.
• Κρίσιμη κατάσταση (κόκκινο): Έχει κινηθεί διαδικασία αφερεγγυότητας, πτώχευσης ή εξυγίανσης και δεν έχει ακόμη περατωθεί, ή μια αίτηση απορρίφθηκε λόγω ανεπαρκούς περιουσίας για την κάλυψη των εξόδων της διαδικασίας. Η τελευταία περίπτωση λογίζεται ως αδυναμία πληρωμών.

Στην επαφή εμφανίζεται ένα έγχρωμο πλαίσιο ειδοποίησης, στη λίστα επαφών μια σχετική ένδειξη και στην αναζήτηση διατίθενται φίλτρα για Προειδοποίηση εμπορικού μητρώου και Κρίσιμη κατάσταση εμπορικού μητρώου. Αν ένας πελάτης περάσει σε κρίσιμη κατάσταση, ανατίθεται στον υπεύθυνο πωλητή (ή, εναλλακτικά, στον διαχειριστή) μια δραστηριότητα με τίτλο Εμπορικό μητρώο: έλεγχος πελατών και αποστέλλεται μήνυμα στο κανάλι Εμπορικό μητρώο.

Νομικά γεγονότα. Οι διαδικασίες αφερεγγυότητας δεν καταχωρίζονται στο μητρώο μέσα στο κείμενο της εταιρικής εγγραφής, αλλά ως νομικά γεγονότα με ημερομηνία, αριθμό υπόθεσης και αρμόδιο δικαστήριο. Το πρόσθετο τα διαβάζει, αντιστοιχίζει την έναρξη και την περάτωση στον ίδιο αριθμό υπόθεσης και τα εμφανίζει ως λίστα στην επαφή. Έτσι, μια διαδικασία που έχει περατωθεί παραμένει ύστερα από μερικά χρόνια απλώς ως πληροφορία, ενώ μια διαδικασία που βρίσκεται σε εξέλιξη επισημαίνεται με κόκκινο.

Ετήσιες οικονομικές καταστάσεις. Αν οι τελευταίες ετήσιες οικονομικές καταστάσεις είναι διαθέσιμες σε XML, το πρόσθετο διαβάζει τα ίδια κεφάλαια, το αποτέλεσμα χρήσης, το σύνολο ενεργητικού και τον κύκλο εργασιών και υπολογίζει τον δείκτη ιδίων κεφαλαίων, τη μεταβολή του κύκλου εργασιών και την κατηγορία μεγέθους σύμφωνα με το άρθρο 221 του UGB (συμπεριλαμβανομένων των πολύ μικρών εταιρειών). Οι μικρές εταιρείες δεν υποχρεούνται να δημοσιεύουν τον κύκλο εργασιών τους· σε αυτή την περίπτωση, το πρόσθετο δεν εμφανίζει σχετική τιμή. Υπολογίζει το αποτέλεσμά τους αφαιρώντας τα κέρδη προηγούμενων χρήσεων από τα κέρδη προς διάθεση και το επισημαίνει ως εκτίμηση. Οι ονομασίες των κονδυλίων που αναζητούνται μπορούν να ρυθμιστούν, επειδή η δομή του XML διαφέρει ανάλογα με το έντυπο.

Έλεγχος διευθύνσεων με το μητρώο διευθύνσεων του BEV

Το BEV διαθέτει το μητρώο διευθύνσεων ως ανοικτά δεδομένα (Διευθύνσεις σε σχεσιακούς πίνακες – δεδομένα συγκεκριμένης ημερομηνίας αναφοράς, με νέα ημερομηνία αναφοράς δύο φορές τον χρόνο και δωρεάν χρήση με αναφορά της πηγής). Το πρόσθετο κατεβάζει το απόσπασμα μέσω της επίσημης υπηρεσίας INSPIRE-ATOM, περίπου 120 MB με γύρω στα 2,5 εκατομμύρια διευθύνσεις, και το εισάγει σε δικούς του πίνακες με λιτή δομή.

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

• Έγκυρη: Η διεύθυνση υπάρχει ακριβώς έτσι στο μητρώο.
• Άγνωστος αριθμός: Η οδός και ο οικισμός συμφωνούν, αλλά ο αριθμός όχι.
• Προτεινόμενη διόρθωση: Τυπογραφικό λάθος στην οδό ή στον οικισμό, λανθασμένος ταχυδρομικός κώδικας. Η διόρθωση είναι διαθέσιμη ως πρόταση.
• Δεν βρέθηκε: Η διεύθυνση δεν υπάρχει στο μητρώο.

Αν το πεδίο του ομόσπονδου κρατιδίου είναι κενό, συμπληρώνεται απευθείας. Οι ιδιωτικές διευθύνσεις επαφών (τύπος Ιδιωτική διεύθυνση) δεν ελέγχονται. Η αναφορά πηγής © Αυστριακό μητρώο διευθύνσεων, δεδομένα με ημερομηνία αναφοράς … εμφανίζεται στις ρυθμίσεις με την τρέχουσα ημερομηνία αναφοράς. Η ενημέρωση εκτελείται εβδομαδιαία, αλλά γίνεται λήψη μόνο αν το BEV έχει δημοσιεύσει δεδομένα με νεότερη ημερομηνία αναφοράς.

Τεχνική υλοποίηση

Πρόσβαση στο μητρώο

Το Υπουργείο Δικαιοσύνης παρέχει πρόσβαση στο εμπορικό μητρώο μέσω των FBW-WebServices (HVD) στο JustizOnline, με διεπαφή SOAP. Η πρόσβαση είναι δωρεάν, αλλά απαιτεί κλειδί API, για το οποίο υποβάλλετε αίτηση με το ID Austria στην ενότητα Περαιτέρω χρήση πληροφοριών. Το κλειδί αποστέλλεται στην κεφαλίδα HTTP X-API-KEY. Το πρόσθετο χρησιμοποιεί την υπηρεσία απευθείας, χωρίς εξαγωγή δεδομένων από ιστοσελίδες.

Ο πελάτης models/firmenbuch_client.py είναι γραμμένος αποκλειστικά σε Python, χωρίς εξάρτηση από το Odoo. Υποστηρίζει τα αιτήματα SUCHEFIRMAREQUEST, AUSZUG_V2_REQUEST, SUCHEURKUNDEREQUEST, URKUNDEREQUEST, καθώς και τα VERAENDERUNGENFIRMAREQUEST και VERAENDERUNGENURKUNDEREQUEST. Έτσι μπορεί να ελεγχθεί με αποθηκευμένες απαντήσεις. Τα αιτήματα αποστέλλονται ανά 0,3 δευτερόλεπτα, ενώ τα αιτήματα μεταβολών καλύπτουν διαστήματα επτά ημερών.

Επεξεργασία του αποσπάσματος

Από το απόσπασμα χρησιμοποιούνται μόνο οι εγγραφές που εξακολουθούν να ισχύουν (το χαρακτηριστικό AUFRECHT δεν είναι false). Η επωνυμία προέρχεται από τον κωδικό δεδομένων FI_DKZ02, η διεύθυνση από τον FI_DKZ03, η έδρα από τον FI_DKZ06 και η νομική μορφή από τον FI_DKZ07. Προστίθενται επίσης το δικαστήριο, η διεύθυνση ιστοτόπου, τα πρόσωπα που έχουν δικαίωμα εκπροσώπησης και τα νομικά γεγονότα. Για τον καθορισμό του επιπέδου προειδοποίησης, αναζητούνται οι ρυθμιζόμενες λέξεις-κλειδιά στα κείμενα όλων των εγγραφών που ισχύουν:

DEFAULT_CRITICAL = "Konkursverfahren, Insolvenzverfahren, Sanierungsverfahren, Konkurs eröffnet, ..."
DEFAULT_WARNING  = "Liquidation, aufgelöst, Auflösung, Abwicklung, Löschung, gelöscht, Verschmelzung, in Liqu."

Το πλεονέκτημα του ελέγχου με λέξεις-κλειδιά είναι ότι λειτουργεί ανεξάρτητα από το πεδίο στο οποίο το μητρώο καταχωρίζει ένα γεγονός. Το μειονέκτημα περιγράφεται στην ενότητα Περιορισμοί.

Παρακολούθηση

Το πρόσθετο δημιουργεί τρεις προγραμματισμένες ενέργειες:

• Αναζήτηση νέων εταιρειών (κάθε 10 λεπτά, έως 20 επαφές ανά εκτέλεση). Η αναζήτηση ενεργοποιείται επίσης αμέσως κατά τη δημιουργία.
• Παρακολούθηση εταιρειών (καθημερινά στις 04:30). Αναζητά εταιρείες και έγγραφα που έχουν αλλάξει από την τελευταία εκτέλεση (έως 30 ημέρες πίσω), ελέγχει τους πελάτες που επηρεάζονται και στη συνέχεια έως 50 πελάτες των οποίων ο τελευταίος έλεγχος είναι παλαιότερος από το καθορισμένο χρονικό όριο. Κάθε εταιρεία αποθηκεύεται σε ξεχωριστή συναλλαγή, ώστε ένα σφάλμα να μην προκαλέσει απώλεια προηγούμενων αποτελεσμάτων. Το αποτέλεσμα της εκτέλεσης δημοσιεύεται στο κανάλι ως συγκεντρωτικό μήνυμα.
• Ενημέρωση μητρώου διευθύνσεων (εβδομαδιαία στις 03:15).

Χωρίς κλειδί API, οι δύο πρώτες τερματίζονται αμέσως. Ένα άθροισμα ελέγχου ανά εταιρεία αποτρέπει την επανεπεξεργασία αποσπασμάτων που δεν έχουν αλλάξει.

Το μητρώο διευθύνσεων

Τα δεδομένα του BEV αποθηκεύονται σε τρεις πίνακες (bev.locality, bev.street, bev.address), με ευρετήριο στον ταχυδρομικό κώδικα, στον κωδικό οδού και στον αριθμό. Η εισαγωγή γίνεται μέσω COPY σε μία συναλλαγή, οπότε οι πίνακες αντικαθίστανται σε ένα βήμα. Οι αριθμοί τυποποιούνται σύμφωνα με τη γραφή του μητρώου (51-55, 12a). Μαζί με τους αριθμούς, οι πίνακες καταλαμβάνουν περίπου 400 MB στη βάση δεδομένων. Αν δεν το επιθυμείτε, απενεργοποιήστε την επιλογή Έλεγχος αριθμών· τότε αρκούν περίπου 150.000 γραμμές.

Τι μάθαμε από τη χρήση της πραγματικής υπηρεσίας

Ένα πρόσθετο που έχει ελεγχθεί μόνο με δοκιμαστικές απαντήσεις που γράψαμε εμείς δεν θεωρείται ακόμη έτοιμο. Γι’ αυτό, πριν από τη δημοσίευση, ελέγξαμε τον πελάτη με την πραγματική υπηρεσία, χρησιμοποιώντας το κλειδί της δικής μας εταιρείας. Έτσι εντοπίσαμε και διορθώσαμε αρκετές αποκλίσεις από τις αρχικές μας παραδοχές:

• Μόνο συνοπτικές πληροφορίες. Με αυτό το κλειδί, το απόσπασμα μπορεί να ανακτηθεί μόνο με την επιλογή Συνοπτικές πληροφορίες. Η υπηρεσία απορρίπτει αιτήματα με την επιλογή Πλήρεις πληροφορίες. Στην έκδοση 1.0.0, η καθημερινή εκτέλεση εξακολουθούσε να στέλνει λανθασμένο αίτημα· η έκδοση 1.1.0 το διορθώνει. Από τα στοιχεία προσώπων, το πρόσθετο αντλεί μόνο τα ονόματα των διαχειριστών με δικαίωμα εκπροσώπησης· δεν διαβάζει εταίρους ούτε διευθύνσεις προσώπων.
• Οδός και αριθμός χωριστά. Η διεύθυνση παρέχεται σε ξεχωριστά στοιχεία STRASSE και HAUSNUMMER, όχι ως ενιαίο κείμενο. Το πρόσθετο τα συνενώνει.
• Το δικαστήριο στα στοιχεία διεκπεραίωσης της καταχώρισης. Το αρμόδιο δικαστήριο δεν αναφέρεται στην ενότητα με τα στοιχεία της εταιρείας, αλλά στο τελευταίο μπλοκ VOLLZ του αποσπάσματος.
• Διαγραμμένες εταιρείες. Μια διαγραμμένη εταιρεία αναγνωρίζεται από ένα χαρακτηριστικό (MIT_FIRMA_GELOESCHT_DURCH_VNR) και όχι από κάποιο κείμενο. Το πρόσθετο το μετατρέπει στην ένδειξη Η εταιρεία έχει διαγραφεί, η οποία ενεργοποιεί προειδοποίηση.
• Η επωνυμία δεν ταυτίζεται με τον όρο αναζήτησης. Η αναζήτηση συγκρίνει την αρχή της επωνυμίας. Το «Muster GmbH» δεν δίνει αποτέλεσμα αν στο μητρώο αναγράφεται «Muster Gesellschaft m.b.H.»· οι εταιρείες υπό εκκαθάριση έχουν το «in Liqu.» στην επωνυμία τους, ενώ στο όνομα της επαφής μερικές φορές παραμένει το &. Γι’ αυτό, το πρόσθετο επαναλαμβάνει την αναζήτηση χωρίς τη νομική μορφή και συγκρίνει τις επωνυμίες αφού αφαιρέσει τις παραλλαγές γραφής της νομικής μορφής, τους χαρακτήρες HTML και την προσθήκη «in Liqu.». Ένα μοναδικό αποτέλεσμα γίνεται δεκτό μόνο αν η επωνυμία του αρχίζει με το όνομα της επαφής.
• Μεταβολές εγγράφων χωρίς αριθμό εμπορικού μητρώου. Η λίστα των εγγράφων που έχουν αλλάξει περιέχει μόνο ένα κλειδί. Στην αρχή αυτού του κλειδιού βρίσκεται ο αριθμός εμπορικού μητρώου, χωρίς το γράμμα ελέγχου. Με βάση αυτόν, το πρόσθετο αντιστοιχίζει τις μεταβολές στους πελάτες.

Για καθένα από αυτά τα σημεία υπάρχει πλέον αυτοματοποιημένη δοκιμή με προσομοιωμένη απάντηση.

Η δοκιμή στο δικό μας πελατολόγιο

Μετά την έκδοση 1.1.0, δοκιμάσαμε το πρόσθετο στο δικό μας πελατολόγιο. Αρχικά εκτελέσαμε μόνο αναζήτηση ονομάτων χωρίς εγγραφή δεδομένων και στη συνέχεια αντιστοιχίσαμε τα αποτελέσματα που ήταν μοναδικά. Σε όλες τις αλλαγές λήφθηκαν υπόψη οι υπάρχουσες τιμές: συμπληρώθηκαν τα κενά πεδία, οι αποκλίσεις παραμένουν ως προτάσεις προς έγκριση και δεν στάλθηκε ούτε ένα email. Τα αποτελέσματα, χωρίς αναφορά σε συγκεκριμένες εταιρείες:

• Αναζητήθηκαν 438 εταιρικές επαφές με ιδιότητα πελάτη, με χώρα την Αυστρία ή χωρίς δηλωμένη χώρα.
• 138 από αυτές αντιστοιχίστηκαν με βεβαιότητα στο εμπορικό μητρώο. Άλλες 18 είχαν μοναδικό αποτέλεσμα βάσει ονόματος, αλλά διαφορετική διεύθυνση στο μητρώο (μετακόμιση ή ομώνυμη εταιρεία), οπότε παρέμειναν ανέπαφες. Για 2 ονόματα υπάρχουν περισσότερες από μία πιθανές αντιστοιχίσεις.
• Περίπου 280 δεν βρέθηκαν ή έδωσαν μόνο μερική αντιστοιχία. Πρόκειται για ιδιώτες, ατομικές επιχειρήσεις, εταιρείες του εξωτερικού, επαφές που αναφέρουν μόνο μια μάρκα ή έναν τόπο, καθώς και εταιρείες των οποίων το όνομα στην επαφή διαφέρει από την καταχώριση, για παράδειγμα επειδή αναγράφεται άλλη νομική μορφή. Για αυτές παραμένει διαθέσιμη η μη αυτόματη Αναζήτηση στο εμπορικό μητρώο.
• Δημιουργήθηκαν 63 προτάσεις αλλαγών, κυρίως για την οδό και τον αριθμό (τρόπος γραφής), καθώς και για τη χώρα.
• 66 προειδοποιήσεις, καμία κρίσιμη ένδειξη. 36 εταιρείες εμφανίζονται στο μητρώο ως διαγραμμένες (9 από αυτές και υπό εκκαθάριση), 2 είχαν διαδικασία αφερεγγυότητας που έχει πλέον περατωθεί και σε 42 επισημάνθηκαν στοιχεία των ετήσιων οικονομικών καταστάσεων: χαμηλός δείκτης ιδίων κεφαλαίων, ζημία ή μείωση του κύκλου εργασιών. Μια διαγραμμένη εταιρεία δεν σημαίνει αυτόματα χαμένο πελάτη, αλλά αποτελεί λόγο να ελεγχθούν η διεύθυνση και ο παραλήπτης του τιμολογίου.

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

Εγκατάσταση και ρύθμιση

Προϋποθέσεις: Odoo 19.0 με τις βασικές εφαρμογές Επαφές και Discuss, το πακέτο Python requests (υπάρχει σε κάθε εγκατάσταση Odoo) και εξερχόμενη πρόσβαση HTTPS στα justizonline.gv.at και data.bev.gv.at. Το πρόσθετο δεν έχει εξαρτήσεις πέρα από τις βασικές εφαρμογές, επομένως δεν απαιτεί την εγκατάσταση άλλων προσθέτων.

1. Τοποθετήστε τον φάκελο partner_firmenbuch_at στο addons_path, ενημερώστε τη λίστα εφαρμογών και εγκαταστήστε το πρόσθετο. Σε συστήματα παραγωγής, συνιστάται να προηγηθεί εγκατάσταση σε δοκιμαστική βάση δεδομένων.
2. Το πρόσθετο δημιουργεί το κανάλι Εμπορικό μητρώο στο Discuss (για εσωτερικούς χρήστες) και προσθέτει όλους τους διαχειριστές. Δημιουργούνται επίσης οι τρεις προγραμματισμένες ενέργειες.
3. Υποβάλετε αίτηση για κλειδί API: JustizOnline (ID Austria), Περαιτέρω χρήση πληροφοριών, API FBW.
4. Ρυθμίσεις → Εμπορικό μητρώο: καταχωρίστε το κλειδί και επιλέξτε Δοκιμή σύνδεσης. Στη συνέχεια, επιλέξτε κανάλι, επιλογές, λέξεις-κλειδιά και κωδικούς κονδυλίων.

odoo-bin -c /etc/odoo/odoo.conf -d <datenbank> -i partner_firmenbuch_at --stop-after-init

Σημαντικό για συστήματα παραγωγής: Η πρώτη ενημέρωση του μητρώου διευθύνσεων ξεκινά αυτόματα την πρώτη νύχτα μετά την εγκατάσταση, στις 03:15, και κατεβάζει περίπου 120 MB. Στη συνέχεια ελέγχονται όλες οι αυστριακές επαφές· τυχόν αποκλίσεις εμφανίζονται ως προτάσεις και σε ένα μήνυμα στο κανάλι. Αν δεν το επιθυμείτε, απενεργοποιήστε εκ των προτέρων την προγραμματισμένη ενέργεια Μητρώο διευθύνσεων (BEV): ενημέρωση ή την επιλογή Έλεγχος αυστριακών διευθύνσεων στις ρυθμίσεις.

Μαζικές εισαγωγές: Κάντε την εισαγωγή με τα κλειδιά περιβάλλοντος fb_no_lookup=True και bev_no_check=True. Διαφορετικά, κάθε αυστριακή εταιρεία που εισάγεται θα προστίθεται στην ουρά αναζήτησης στο μητρώο (20 ανά δέκα λεπτά) και κάθε διεύθυνση θα ελέγχεται κατά τη δημιουργία της.

Προστασία δεδομένων: τι στέλνει το πρόσθετο και σε ποιον

• Προσωπικά δεδομένα: Τα ονόματα των διαχειριστών είναι προσωπικά δεδομένα, ακόμη κι αν είναι δημόσια στο μητρώο. Το πρόσθετο τα αποθηκεύει αποκλειστικά για τη διαχείριση της επαγγελματικής σχέσης. Αν δεν το επιθυμείτε, διαγράψτε το περιεχόμενο του πεδίου ή μην το χρησιμοποιείτε.
• Εμπορικό μητρώο: Στο justizonline.gv.at αποστέλλεται μόνο η επωνυμία ή ο αριθμός εμπορικού μητρώου των επαφών που έχουν επισημανθεί ως εταιρείες (χωρίς μητρική εταιρεία, με χώρα την Αυστρία ή χωρίς δηλωμένη χώρα), μαζί με το κλειδί API. Δεν αποστέλλονται ποτέ στοιχεία ιδιωτών ή προσώπων επικοινωνίας μιας εταιρείας.
• Μητρώο διευθύνσεων: Γίνεται μόνο λήψη του δημόσιου αποσπάσματος. Οι διευθύνσεις πελατών δεν εξέρχονται από το σύστημα.
• Χωρίς email προς πελάτες: Οι ειδοποιήσεις αποστέλλονται στο εσωτερικό κανάλι, στο Chatter και ως δραστηριότητες στους εργαζομένους.
• Κλειδί: Το κλειδί API είναι ορατό μόνο στους διαχειριστές.

Το εμπορικό μητρώο είναι δημόσιο μητρώο. Η περαιτέρω χρήση των δεδομένων υπόκειται στους όρους περαιτέρω χρήσης πληροφοριών του JustizOnline.

Δοκιμές

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

• Τυποποίηση του αριθμού εμπορικού μητρώου
• Επεξεργασία του αποσπάσματος (επωνυμία, διεύθυνση, δικαστήριο, διαχειριστές, διαγραμμένη εταιρεία· οι μη ισχύουσες εγγραφές αγνοούνται)
• Σύγκριση επωνυμιών: παραλλαγές γραφής της νομικής μορφής, «in Liqu.», χαρακτήρες HTML, αποφυγή αντιστοίχισης με άσχετη εταιρεία
• Ετήσιες οικονομικές καταστάσεις: ίδια κεφάλαια, αποτέλεσμα χρήσης, σύνολο ενεργητικού
• Εντοπισμός νέας εταιρείας, συμπλήρωση κενών πεδίων, προτάσεις για αποκλίσεις, μερική εφαρμογή πρότασης
• Παρακολούθηση: η έναρξη διαδικασίας αφερεγγυότητας ορίζει το επίπεδο ως κρίσιμο και δημιουργεί τη δραστηριότητα, μια περατωθείσα διαδικασία προκαλεί προειδοποίηση, τα πρόσωπα επικοινωνίας δεν ελέγχονται ξεχωριστά
• Αντιστοίχιση μεταβολών εγγράφων μέσω του κλειδιού
• Χωρίς κλειδί API δεν εκτελείται κανένα αίτημα
• Έλεγχος διευθύνσεων με βάση το μικρό δείγμα αποσπάσματος

odoo-bin -d <testdatenbank> -i partner_firmenbuch_at \
         --test-enable --test-tags=/partner_firmenbuch_at --stop-after-init

Η γερμανική μετάφραση βρίσκεται στο i18n/de.po.

Περιορισμοί και νομική επισήμανση

• Ένα αποτέλεσμα αποτελεί ένδειξη, όχι νομική γνωμάτευση. Η κατάσταση προκύπτει από λέξεις-κλειδιά σε ισχύουσες εγγραφές του μητρώου. Ελέγξτε το μητρώο οι ίδιοι πριν αποφασίσετε για πίστωση ή όρους παράδοσης.
• Η ανίχνευση αφερεγγυότητας έχει ελεγχθεί μόνο με προσομοιωμένες περιπτώσεις. Το πρόσθετο αναγνωρίζει διαδικασίες από λέξεις στο ελεύθερο κείμενο των νομικών γεγονότων (έναρξη, περάτωση, επικυρωμένο σχέδιο εξυγίανσης, έλλειψη περιουσιακών στοιχείων). Αναπαραγάγαμε τη μορφή τους με βάση ένα πραγματικό απόσπασμα μητρώου, αλλά κατά την ανάπτυξη δεν είχαμε στη διάθεσή μας πραγματική περίπτωση αφερεγγυότητας. Επομένως, μια ασυνήθιστη διατύπωση μπορεί να περάσει απαρατήρητη. Το πρόσθετο δεν υποκαθιστά την επίσημη βάση δικαστικών δημοσιεύσεων Ediktsdatei.
• Ετήσιες οικονομικές καταστάσεις μόνο σε XML. Οι υποβολές που περιλαμβάνουν αποκλειστικά PDF παραλείπονται. Στις πολύ μικρές εταιρείες, ο ισολογισμός ενδέχεται να έχει υποβληθεί σε συνοπτική μορφή, χωρίς τα αριθμητικά στοιχεία που διαβάζει το πρόσθετο.
• Μόνο για την Αυστρία. Δεν γίνονται αναζητήσεις για εταιρείες του εξωτερικού. Οι ιστότοποι των εταιρειών δεν περιλαμβάνονται στο μητρώο και δεν συμπληρώνονται.
• Αυτόματη αντιστοίχιση μόνο όταν το αποτέλεσμα είναι μοναδικό. Αν υπάρχουν περισσότερες εταιρείες με την ίδια επωνυμία, ένα μήνυμα στο κανάλι ζητά να γίνει μη αυτόματη Αναζήτηση στο εμπορικό μητρώο.
• Οι διεπαφές ενδέχεται να αλλάξουν. Το πρόσθετο εξαρτάται από τις υπηρεσίες των BMJ και BEV. Αν αλλάξει το τελικό σημείο, το σχήμα ή η ροή ATOM, ενδέχεται να χρειαστεί ενημέρωση.
• Δοκιμασμένο για το Odoo 19. Αναπτύχθηκε και δοκιμάστηκε για το Odoo 19.0 Community. Δεν το έχουμε ελέγξει σε άλλες εκδόσεις. Το άρθρο δεν αποτελεί νομική συμβουλή.

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

Έχει κόστος η πρόσβαση στο μητρώο;

Από όσο γνωρίζουμε, όχι: τα FBW-WebServices για περαιτέρω χρήση πληροφοριών είναι δωρεάν, αλλά απαιτούν κλειδί API, για το οποίο υποβάλλετε αίτηση μέσω του JustizOnline. Ισχύουν οι εκάστοτε τρέχοντες όροι του Υπουργείου Δικαιοσύνης.

Αντικαθίστανται τα υπάρχοντα στοιχεία επαφών;

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

Αντιλαμβάνονται οι πελάτες μου τον έλεγχο;

Όχι. Όλες οι ειδοποιήσεις αποστέλλονται στο εσωτερικό κανάλι, στο Chatter της επαφής και ως δραστηριότητες στους εργαζομένους. Το πρόσθετο δεν στέλνει email σε πελάτες.

Αποθηκεύονται στοιχεία διαχειριστών ή εταίρων;

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

Πόσους από τους πελάτες μας βρίσκει το πρόσθετο;

Αυτό εξαρτάται από το πελατολόγιο. Στη δική μας περίπτωση ήταν 138 από τις 438 εταιρικές επαφές (περίπου το ένα τρίτο). Οι υπόλοιπες είναι ιδιώτες, ατομικές επιχειρήσεις, εταιρείες του εξωτερικού και επαφές των οποίων το όνομα δεν συμφωνεί με την επίσημη επωνυμία. Οι αριθμοί παρατίθενται στην ενότητα Η δοκιμή στο δικό μας πελατολόγιο.

Μπορώ να βρω έναν πελάτη χωρίς αριθμό εμπορικού μητρώου;

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

Τι ισχύει για εταιρείες στη Γερμανία ή στην Ελβετία;

Δεν γίνονται αναζητήσεις για αυτές. Το πρόσθετο εξετάζει μόνο επαφές με χώρα την Αυστρία ή χωρίς δηλωμένη χώρα.

Πόσο χώρο αποθήκευσης χρειάζεται ο έλεγχος διευθύνσεων;

Με τους αριθμούς, περίπου 400 MB στη βάση δεδομένων και, κατά την εισαγωγή, περίπου 120 MB προσωρινού χώρου στον δίσκο. Χωρίς έλεγχο αριθμών, αρκούν περίπου 150.000 γραμμές.

Τι γίνεται αν θέλω μόνο το εμπορικό μητρώο, χωρίς έλεγχο διευθύνσεων;

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

Με ποια άδεια διατίθεται το πρόσθετο;

Με την LGPL-3. Μπορείτε να το χρησιμοποιείτε, να το προσαρμόζετε και να το αναδιανέμετε. Οι αναφορές σφαλμάτων και οι προτάσεις βελτίωσης με τη μορφή Issue στο αποθετήριο στο GitHub είναι ευπρόσδεκτες.

Υποστήριξη από την Biricon IT Services

Υποστηρίζουμε εγκαταστάσεις Odoo για μικρές και μεσαίες επιχειρήσεις: από την αρχική υλοποίηση, τις προσαρμογές και τις μεταφορές δεδομένων έως την καθημερινή λειτουργία. Αν θέλετε να διατηρείτε σωστά τα βασικά στοιχεία πελατών στο Odoo, να εντοπίζετε νωρίτερα πιστωτικούς κινδύνους ή να αξιολογήσετε ένα πρόσθετο σαν αυτό και να το εντάξετε με ασφάλεια στο περιβάλλον παραγωγής σας, θα χαρούμε να σας βοηθήσουμε. Περισσότερες δικές μας υλοποιήσεις θα βρείτε στο ιστολόγιό μας, για παράδειγμα Σετ προϊόντων ως ενότητα στην προσφορά και Web RBL, η λίστα αποκλεισμού κακόβουλης κίνησης.

Επικοινωνήστε μαζί μας τώρα

Τελευταία ενημέρωση: 3 Νοεμβρίου 2026. Έκδοση πρόσθετου 19.0.1.1.1. Τα δεδομένα των παραδειγμάτων στις εικόνες είναι επινοημένα και δεν αφορούν πραγματικές εταιρείες.