Odoo 19 Community: Μητρώο επιχειρήσεων (Firmenbuch) και έλεγχος διευθύνσεων για αυστριακούς πελάτες – το άρθρωμα ανοιχτού κώδικα partner_firmenbuch_at

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

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

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

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

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

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

Τι κάνει η ενότητα

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

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

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

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

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

Το άρθρωμα διακρίνει τρία επίπεδα:

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

Στην επαφή εμφανίζεται ένα έγχρωμο banner, στη λίστα επαφών μια ένδειξη, και στην αναζήτηση υπάρχουν φίλτρα για Προειδοποίηση Firmenbuch και Firmenbuch κρίσιμο. Όταν ένας πελάτης γίνει κρίσιμος, ο αρμόδιος πωλητής (εναλλακτικά ο διαχειριστής) λαμβάνει μια δραστηριότητα Firmenbuch: έλεγχος πελατών και το κανάλι Firmenbuch λαμβάνει ένα μήνυμα.

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

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

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

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

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

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

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

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

Η πρόσβαση στο μητρώο

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

Ο client 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 γραμμές.

Τι μας δίδαξε η πραγματική υπηρεσία

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

• Μόνο η σύντομη πληροφόρηση. Το απόσπασμα μπορεί να ανακτηθεί με αυτό το κλειδί μόνο στο εύρος σύντομη πληροφόρηση. Αιτήματα με πλήρη πληροφόρηση απορρίπτονται από την υπηρεσία. Στην έκδοση 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.». Ένα μεμονωμένο αποτέλεσμα υιοθετείται μόνο αν το όνομά του αρχίζει με αυτό της επαφής.
• Αλλαγές εγγράφων χωρίς αριθμό Firmenbuch. Η λίστα των αλλαγμένων εγγράφων περιέχει μόνο ένα κλειδί. Ο αριθμός Firmenbuch (χωρίς το γράμμα ελέγχου) βρίσκεται στην αρχή αυτού του κλειδιού. Το άρθρωμα αντιστοιχίζει μέσω αυτού τις αλλαγές στους πελάτες.

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

Η δοκιμή στη δική μας βάση πελατών

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

• Αναζητήθηκαν 438 εταιρικές επαφές με ιδιότητα πελάτη στην Αυστρία ή χωρίς χώρα.
• Από αυτές 138 αντιστοιχίστηκαν μονοσήμαντα στο Firmenbuch. Άλλες 18 είχαν μονοσήμαντο αποτέλεσμα ονόματος, αλλά διαφορετική διεύθυνση στο μητρώο (μετακόμιση ή εταιρεία με ίδιο όνομα) και γι' αυτό παρέμειναν ανέγγιχτες. 2 ονόματα είναι διφορούμενα.
• Περίπου 280 δεν βρέθηκαν ή βρέθηκαν μόνο ως μερικά αποτελέσματα. Πρόκειται για ιδιώτες, ατομικές επιχειρήσεις, ξένες εταιρείες, επαφές που αναφέρουν μόνο μια μάρκα ή έναν τόπο, και εταιρείες των οποίων το όνομα στην επαφή διαφέρει από την εγγραφή, για παράδειγμα επειδή αναγράφεται άλλη νομική μορφή. Γι' αυτές παραμένει η χειροκίνητη Αναζήτηση Firmenbuch.
• Δημιουργήθηκαν 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 Firmenbuch (εσωτερικοί χρήστες) και εγγράφει όλους τους διαχειριστές. Επιπλέον δημιουργούνται οι τρεις προγραμματισμένες ενέργειες.
3. Ζητήστε κλειδί API: JustizOnline (ID Austria), Informationsweiterverwendung, API FBW.
4. Ρυθμίσεις → Firmenbuch: καταχωρίστε το κλειδί και πατήστε Δοκιμή σύνδεσης. Έπειτα επιλέξτε κανάλι, επιλογές, λέξεις-κλειδιά και κωδικούς θέσεων.

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

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

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

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

• Προσωπικά δεδομένα: Τα ονόματα των διαχειριστών είναι προσωπικά δεδομένα, ακόμη και αν είναι δημόσια στο μητρώο. Το άρθρωμα τα αποθηκεύει μόνο για τη διαχείριση της επιχειρηματικής σχέσης. Όποιος δεν το θέλει, διαγράφει το πεδίο ή δεν το χρησιμοποιεί.
• Firmenbuch: Μόνο το όνομα ή ο αριθμός Firmenbuch επαφών που έχουν σημανθεί ως εταιρεία (χωρίς μητρική εταιρεία, χώρα Αυστρία ή κενή) αποστέλλεται στο justizonline.gv.at, μαζί με το κλειδί API. Ιδιώτες και πρόσωπα επικοινωνίας μιας εταιρείας δεν αποστέλλονται ποτέ.
• Μητρώο διευθύνσεων: Κατεβαίνει μόνο το δημόσιο απόσπασμα. Οι διευθύνσεις των πελατών δεν εγκαταλείπουν το σύστημα.
• Καμία αλληλογραφία προς πελάτες: Οι ειδοποιήσεις πηγαίνουν στο εσωτερικό κανάλι, στο chatter και ως δραστηριότητα στους υπαλλήλους.
• Κλειδί: Το κλειδί API είναι ορατό μόνο στους διαχειριστές.

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

Δοκιμές

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

• Κανονικοποίηση του αριθμού Firmenbuch
• Επεξεργασία του αποσπάσματος (όνομα, διεύθυνση, δικαστήριο, διαχειριστής, διαγραμμένη εταιρεία, οι άκυρες εγγραφές αγνοούνται)
• Σύγκριση ονομάτων: παραλλαγές γραφής της νομικής μορφής, «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 παραλείπονται. Σε πολύ μικρές εταιρείες ο ισολογισμός μπορεί να έχει υποβληθεί συνοπτικά, χωρίς τους αριθμούς που διαβάζει το άρθρωμα.
• Μόνο Αυστρία. Οι ξένες εταιρείες δεν ερωτώνται. Οι ιστοσελίδες των εταιρειών δεν υπάρχουν στο μητρώο και δεν συμπληρώνονται.
• Αυτόματη αντιστοίχιση μόνο σε μονοσήμαντο αποτέλεσμα. Αν υπάρχουν πολλές εταιρείες με το ίδιο όνομα, ένα μήνυμα στο κανάλι ζητά τη χειροκίνητη Αναζήτηση Firmenbuch.
• Οι διεπαφές μπορεί να αλλάξουν. Το άρθρωμα εξαρτάται από τις υπηρεσίες του BMJ και του BEV. Αν αλλάξει το endpoint, το σχήμα ή το feed ATOM, μπορεί να χρειαστεί ενημέρωση.
• Δοκιμασμένο για Odoo 19. Αναπτύχθηκε και δοκιμάστηκε για το Odoo 19.0 Community. Για άλλες εκδόσεις δεν το έχουμε ελέγξει. Το άρθρο δεν αποτελεί νομική συμβουλή.

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

Κοστίζει η πρόσβαση στο μητρώο;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Τι γίνεται αν θέλω μόνο το Firmenbuch και όχι έλεγχο διευθύνσεων;

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

Υπό ποια άδεια διατίθεται το άρθρωμα;

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

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

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

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

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