Odoo 19 Community: Firmenbuch i provera adresa za austrijske klijente – naš modul otvorenog koda partner_firmenbuch_at

Ko u Austriji posluje, zna ta pitanja: Da li su naziv firme i adresa mog novog klijenta ispravni? Da li je firma još upisana u Firmenbuch ili je u likvidaciji? Da li je otvoren stečajni postupak nad klijentom kome isporučujem već dve godine? Odgovori stoje u Firmenbuchu Ministarstva pravde, ali retko ko redovno proverava. U Odoou se kontakt jednom kreira i posle toga stari.

Za to smo razvili modul Firmenbuch za partnere (partner_firmenbuch_at). Povezuje Odoo kontakte sa Firmenbuchom i sa zvaničnim registrom adresa BEV-a. Napisan je za Odoo 19 i besplatno je dostupan na GitHubu kao slobodan softver pod LGPL-3 licencom:

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

Problem: matični podaci o kojima niko ne brine

Kontakt u Odoou obično nastaje pod vremenskim pritiskom: ime, okvirna adresa, možda UID. To je dovoljno za prvu ponudu. Nije dovoljno za fakture koje moraju biti pravno ispravno adresirane, a pogotovo ne da bi se primetilo da se kod klijenta nešto promenilo. U praksi se pokazuju četiri praznine:

• Nepotpuni matični podaci. Broj u Firmenbuchu, sud i pravna forma gotovo uvek nedostaju, jer je pretraživanje ručni posao.
• Pogrešno pisanje. Naziv firme bez pravne forme, greške u kucanju ulice ili mesta, zamenjen poštanski broj. To se primeti tek kada se pošta vrati.
• Nema praćenja. Ako sud otvori stečajni postupak ili klijent raspusti društvo, Odoo o tome ne zna ništa. Prodaja i dalje isporučuje na račun.
• Rasuti izvori. Firmenbuch, godišnji obračuni i registar adresa nalaze se na različitim mestima. Ko želi da ih proveri, ručno kopira podatke između prozora pregledača.

Šta modul radi

1. Nove firme se pretražuju. Ako neko kreira kontakt kao firmu (zemlja Austrija ili prazno), modul u roku od nekoliko minuta traži u Firmenbuchu. Ako postoji tačno jedan pogodak, popunjavaju se prazna polja: ulica, poštanski broj, mesto, zemlja, broj u Firmenbuchu, sud i pravna forma.
2. Odstupanja se predlažu, nikada ne prepisuju. Ako u kontaktu stoji nešto drugo nego u registru, nastaje predlog izmene koji zaposleni odobrava po polju.
3. Pretraga Firmenbucha na kontaktu. U kartici Firmenbuch pretraga pronalazi firme po nazivu, čak i kada automatski pogodak nije bio jednoznačan.
4. Dnevni nadzor. Modul svakodnevno proverava koje su se firme i isprave u registru promenile i proverava pogođene klijente. Dodatno se u podesivim razmacima svaka firma potpuno iznova proverava.
5. Nivoi upozorenja. Otvoreni postupci stečaja i sanacije (iz pravnih činjenica registra), likvidacija, brisanje, negativan sopstveni kapital i nizak udeo sopstvenog kapitala se prepoznaju i čine vidljivim na kontaktu.
6. Provera adresa. Austrijske adrese se lokalno proveravaju prema zvaničnom registru adresa Saveznog zavoda za mere i premer (BEV).
7. Podaci iz registra na kontaktu. Sud, pravna forma, poslovođe i pravne činjenice nalaze se u kartici Firmenbuch. Oni odražavaju registar i ažuriraju se direktno.
8. Obaveštenja samo interno. Sve poruke idu u interni Discuss kanal Firmenbuch i u chatter kontakta. Provera mnogih firmi stvara jednu zbirnu poruku umesto jedne po firmi. Klijentima modul nikada ništa ne šalje.

Predlozi umesto prepisivanja

Zvanični podaci nisu automatski bolji podaci za vaše poslovanje: možda je u kontaktu namerno upisana adresa isporuke, možda je uveden skraćeni naziv. Zato modul postojeće vrednosti nikada ne menja sam. Samo dopunjava prazna polja, a kod odstupanja pravi predlog.

Pod Kontakti → Firmenbuch → Predlozi Firmenbucha vidite po polju trenutnu vrednost i vrednost iz registra. Polja koja ne želite da preuzmete ostavite neoznačena. Sa Primeni izabrano upisuju se samo označena polja, sa Odbij predlog propada. Novi predlog zamenjuje starije otvorene predloge istog kontakta, kako se ne bi primenile zastarele vrednosti.

Upozorenja: insolventnost, likvidacija, bilans

Modul razlikuje tri nivoa:

• Neupadljivo: Nema ničega što bi trebalo prijaviti.
• Upozorenje (žuto): U registru postoje važeći upisi o likvidaciji, raspuštanju, okončanju poslovanja, brisanju ili spajanju, firma je označena kao izbrisana, ili je raniji stečajni postupak obustavljen u poslednjim godinama (podrazumevano tri godine, podesivo). Ili godišnji obračun pokazuje negativan sopstveni kapital, udeo sopstvenog kapitala ispod 8 % (podrazumevana vrednost po uzoru na § 23 URG, podesivo), godišnji gubitak ili pad prometa od 25 % i više.
• Kritično (crveno): Stečajni ili sanacioni postupak je otvoren i još nije obustavljen, ili je zahtev odbijen zbog nedostatka imovine koja pokriva troškove. Ovo poslednje važi kao nesposobnost plaćanja.

Na kontaktu se pojavljuje obojeni baner, u listi kontakata napomena, a u pretrazi postoje filteri za Upozorenje Firmenbucha i Firmenbuch kritično. Ako klijent postane kritičan, nadležni prodavac (a ako ga nema, administrator) dobija aktivnost Firmenbuch: proveriti klijente, a kanal Firmenbuch dobija poruku.

Pravne činjenice. Stečajni postupci u registru ne stoje u tekstu firme, nego kao pravne činjenice sa datumom, poslovnim brojem i sudom. Modul ih čita, dodeljuje otvaranje i obustavu istom poslovnom broju i prikazuje ih na kontaktu kao listu. Tako obustavljeni postupak posle nekoliko godina ostaje samo informacija, a postupak u toku je crven.

Godišnji obračuni. Ako je poslednji godišnji obračun dostupan kao XML, modul čita sopstveni kapital, godišnji rezultat, bilansnu sumu i promet i izračunava udeo sopstvenog kapitala, promenu prometa i klasu veličine prema § 221 UGB (uključujući mikro društva). Mala društva ne moraju da objavljuju promet, pa tada modul ne prikazuje nijedan. Njihov rezultat izvodi iz bilansnog dobitka umanjenog za preneti dobitak i označava ga kao procenu. Nazivi pozicija po kojima se traži su podesivi, jer je XML različito građen zavisno od obrasca.

Provera adresa pomoću BEV registra adresa

BEV stavlja registar adresa na raspolaganje kao otvorene podatke (Adresse Relationale Tabellen – Stichtagsdaten, novi referentni datum dvaput godišnje, besplatno za korišćenje uz navođenje izvora). Modul preuzima izvod preko zvanične INSPIRE-ATOM usluge, oko 120 MB sa otprilike 2,5 miliona adresa, i uvozi ga u sopstvene, vitke tabele.

Zatim se svaka austrijska adresa firme sa ulicom lokalno proverava pri kreiranju i pri svakoj izmeni: poštanski broj, ulica, kućni broj, mesto i savezna država. Nijedna adresa ne odlazi nijednoj usluzi. Rezultat stoji kao oznaka ispod adrese:

• Važeće: Adresa u ovom obliku postoji u registru.
• Kućni broj nepoznat: Ulica i mesto se slažu, kućni broj ne.
• Predložena ispravka: Greška u kucanju ulice ili mesta, pogrešan poštanski broj. Ispravka stoji spremna kao predlog.
• Nije pronađeno: Registar ne poznaje ovu adresu.

Prazna savezna država se dopunjava direktno. Privatne adrese kontakata (tip Privatna adresa) se ne proveravaju. Navod izvora © Österreichisches Adressregister, Stichtagsdaten vom … stoji sa aktuelnim referentnim datumom u podešavanjima. Ažuriranje se odvija nedeljno, ali preuzima samo ako je BEV objavio noviji referentni datum.

Tehnička realizacija

Pristup registru

Ministarstvo pravde nudi Firmenbuch preko FBW-WebServices (HVD) na JustizOnline kao SOAP interfejs. Pristup je besplatan, ali traži API ključ koji se uz ID Austria traži pod Informationsweiterverwendung. Ključ se šalje u HTTP zaglavlju X-API-KEY. Modul koristi uslugu direktno, bez screen-scrapinga.

Klijent models/firmenbuch_client.py je čist Python bez zavisnosti od Odooa. Poznaje upite SUCHEFIRMAREQUEST, AUSZUG_V2_REQUEST, SUCHEURKUNDEREQUEST, URKUNDEREQUEST kao i VERAENDERUNGENFIRMAREQUEST i VERAENDERUNGENURKUNDEREQUEST. Time se može testirati sa sačuvanim odgovorima. Upiti se šalju u razmaku od 0,3 sekunde, upiti o izmenama u blokovima od sedam dana.

Obrada izvoda

Iz izvoda se koriste samo upisi koji su još važeći (atribut AUFRECHT nije false). Naziv potiče iz oznake podatka FI_DKZ02, adresa iz FI_DKZ03, sedište iz FI_DKZ06, a pravna forma iz FI_DKZ07. Tome se dodaju sud, veb adresa, lica ovlašćena za zastupanje i pravne činjenice. Za nivo upozorenja se tekstovi svih važećih upisa pretražuju po podesivim ključnim rečima:

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

Prednost provere po ključnim rečima: funkcioniše nezavisno od toga u kom polju registar vodi neki događaj. Mana stoji u odeljku Ograničenja.

Nadzor

Modul kreira tri planirane akcije:

• Pretraga novih firmi (svakih 10 minuta, do 20 kontakata po izvršavanju). Pored toga se odmah pokreće pri kreiranju.
• Nadzor firmi (dnevno u 04:30). Traži izmenjene firme i isprave od poslednjeg izvršavanja (najviše 30 dana unazad), proverava pogođene klijente, a zatim do 50 klijenata čija je poslednja provera starija od podešenog roka. Svaka firma se čuva u sopstvenoj transakciji, kako greška ne bi uništila ranije rezultate. Rezultat izvršavanja stiže kao jedna zbirna poruka u kanal.
• Ažuriranje registra adresa (nedeljno u 03:15).

Bez API ključa se prve dve odmah vraćaju. Kontrolni zbir po firmi sprečava da se nepromenjeni izvodi ponovo obrađuju.

Registar adresa

BEV podaci se nalaze u tri tabele (bev.locality, bev.street, bev.address) sa indeksom na poštanski broj, šifru ulice i kućni broj. Uvoz se odvija preko COPY u jednoj transakciji, tabele se dakle zamenjuju u jednom koraku. Kućni brojevi se normalizuju u pisanju registra (51-55, 12a). Sa kućnim brojevima tabele zauzimaju oko 400 MB u bazi podataka. Ko to ne želi, isključuje Proveri kućne brojeve i snalazi se sa oko 150.000 redova.

Čemu nas je naučila prava usluga

Modul koji je proveren samo prema sopstveno napisanim testnim odgovorima još se ne smatra gotovim. Zato smo klijenta pre objavljivanja proverili prema pravoj usluzi, sa ključem naše sopstvene firme. Pritom je uočeno nekoliko odstupanja od naših pretpostavki, koja smo otklonili:

• Samo kratka informacija. Izvod se sa ovim ključem može preuzeti samo u obimu Kratka informacija. Upite sa Punom informacijom usluga odbija. U verziji 1.0.0 je dnevno izvršavanje to još pogrešno tražilo, verzija 1.1.0 to otklanja. Iz lica modul preuzima samo imena poslovođa ovlašćenih za zastupanje; članovi društva i adrese lica se ne čitaju.
• Ulica i kućni broj odvojeno. Adresa stiže kao STRASSE i HAUSNUMMER u odvojenim elementima, a ne kao jedan tekst. Modul ih sastavlja.
• Sud u sprovođenju. Nadležni sud ne stoji u delu o firmi, nego u poslednjem VOLLZ bloku izvoda.
• Izbrisane firme. Izbrisana firma se prepoznaje po atributu (MIT_FIRMA_GELOESCHT_DURCH_VNR), a ne po tekstu. Modul od toga pravi nalaz Firma izbrisana, koji pokreće upozorenje.
• Naziv firme nije ključna reč. Pretraga poredi početak naziva. „Muster GmbH“ ne pronalazi ništa ako registar piše „Muster Gesellschaft m.b.H.“; firme u likvidaciji nose „in Liqu.“ u nazivu, a u nazivu kontakta ponekad još stoji &. Modul zato ponavlja pretragu bez pravne forme i poredi nazive bez varijanti pisanja pravne forme, bez HTML znakova i bez dodatka „in Liqu.“. Pojedinačni pogodak se preuzima samo ako njegov naziv počinje nazivom kontakta.
• Izmene isprava bez broja u Firmenbuchu. Lista izmenjenih isprava sadrži samo jedan ključ. Broj u Firmenbuchu (bez kontrolnog slova) stoji na početku tog ključa. Modul preko njega dodeljuje izmene klijentima.

Za svaku od ovih tačaka sada postoji automatizovan test sa ponovo sastavljenim odgovorom.

Test na sopstvenoj bazi klijenata

Posle verzije 1.1.0 isprobali smo modul na našoj sopstvenoj bazi klijenata. Prvo je išla samo pretraga naziva sa čitanjem, zatim dodela jednoznačnih pogodaka. Pritom ništa nije promenjeno bez obzira na postojeće vrednosti: prazna polja su dopunjena, odstupanja stoje kao predlozi spremni za odobrenje, i nijedan jedini e-mail nije otišao. Rezultat, bez navođenja pojedinačnih firmi:

• 438 poslovnih kontakata sa statusom klijenta u Austriji ili bez zemlje je pretraženo.
• 138 od toga je jednoznačno dodeljeno u Firmenbuchu. Daljih 18 imalo je jednoznačan pogodak po nazivu, ali drugu adresu u registru (selidba ili firma istog naziva), pa su zato ostali netaknuti. 2 naziva su višeznačna.
• Oko 280 nismo pronašli ili samo kao delimičan pogodak. To su fizička lica, samostalni preduzetnici, strane firme, kontakti koji navode samo marku ili mesto, i firme čiji se naziv u kontaktu razlikuje od upisa, na primer zato što tamo stoji druga pravna forma. Za njih ostaje ručna Pretraga Firmenbucha.
• 63 predloga izmene nastalo je, uglavnom za ulicu i kućni broj (pisanje) i zemlju.
• 66 upozorenja, nijedan kritičan nivo. 36 firmi je u registru označeno kao izbrisano (9 od njih i u likvidaciji), 2 su imale u međuvremenu obustavljen stečajni postupak, a kod 42 je upao u oči godišnji obračun: nizak udeo sopstvenog kapitala, gubitak ili pad prometa. Izbrisana firma nije automatski izgubljen klijent, ali je povod da se provere adresa i primalac fakture.

Dve pouke iz toga: Baza klijenata iz stvarnog poslovanja daleko je bolji test od svakog ponovo sastavljenog odgovora. Pritom smo pronašli greške u pretrazi naziva, koje su otklonjene u verziji 1.1.1 (vidi gore). A stopa pogodaka jako zavisi od toga koliko su pažljivo imenovani kontakti: ko naziv firme piše onako kako ga vodi registar, biće pouzdano pronađen.

Instalacija i podešavanje

Preduslovi: Odoo 19.0 sa standardnim aplikacijama Kontakti i Discuss, Python paket requests (prisutan u svakoj Odoo instalaciji) i odlazni HTTPS pristup ka justizonline.gv.at i data.bev.gv.at. Modul nema nikakve zavisnosti izvan standardnih aplikacija, dakle ne povlači nikakve dodatne module.

1. Folder partner_firmenbuch_at staviti u addons_path, osvežiti listu aplikacija i instalirati modul, na produktivnim sistemima najbolje prvo na testnoj bazi.
2. Modul kreira Discuss kanal Firmenbuch (interni korisnici) i upisuje sve administratore. Pored toga nastaju tri planirane akcije.
3. Zatražiti API ključ: JustizOnline (ID Austria), Informationsweiterverwendung, API FBW.
4. Podešavanja → Firmenbuch: uneti ključ i Testirati vezu. Zatim izabrati kanal, opcije, ključne reči i šifre pozicija.

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

Važno na produktivnim sistemima: Prvo izvršavanje ažuriranja registra adresa startuje automatski u noći posle instalacije u 03:15 i preuzima oko 120 MB. Zatim se proveravaju svi austrijski kontakti; neobičnosti se pojavljuju kao predlozi i kao jedna poruka u kanalu. Ko to ne želi, unapred deaktivira planiranu akciju Registar adresa (BEV): ažuriranje ili isključuje Proveri austrijske adrese u podešavanjima.

Masovni uvozi: Uvozite sa ključevima konteksta fb_no_lookup=True i bev_no_check=True. Inače bi svaka uvezena austrijska firma bila zabeležena za upit registru (20 na svakih deset minuta), a svaka adresa bi se proveravala pri kreiranju.

Zaštita podataka: šta modul šalje kome

• Lični podaci: Imena poslovođa su lični podaci, čak i kada javno stoje u registru. Modul ih čuva samo radi održavanja poslovnog odnosa. Ko to ne želi, briše polje ili ga ne koristi.
• Firmenbuch: Samo naziv ili broj u Firmenbuchu kontakata koji su označeni kao firma (bez nadređene firme, zemlja Austrija ili prazno) odlazi na justizonline.gv.at, zajedno sa API ključem. Fizička lica i kontakt osobe firme se nikada ne šalju.
• Registar adresa: Preuzima se samo javni izvod. Adrese klijenata ne napuštaju sistem.
• Nema mejlova klijentima: Poruke idu internom kanalu, u chatter i kao aktivnost zaposlenima.
• Ključ: API ključ je vidljiv samo administratorima.

Firmenbuch je javni registar. Ponovna upotreba podataka podleže uslovima ponovne upotrebe informacija na JustizOnline.

Testovi

Modul dolazi sa 18 automatizovanih testova. Rade sa ponovo sastavljenim odgovorima registra i minijaturnim izvodom adresa, pa zato ne trebaju ni API ključ ni mrežu:

• Normalizacija broja u Firmenbuchu
• Obrada izvoda (naziv, adresa, sud, poslovođa, izbrisana firma, nevažeći upisi se ignorišu)
• Poređenje naziva: varijante pisanja pravne forme, „in Liqu.“, HTML znakovi, nema pogotka kod tuđe firme
• Godišnji obračun: sopstveni kapital, rezultat, bilansna suma
• Nova firma se pronalazi, prazna polja se dopunjavaju, odstupanja se predlažu, predlog se delimično primenjuje
• Nadzor: otvoren stečajni postupak postavlja nivo na kritično i stvara aktivnost, obustavljen postupak daje upozorenje, kontakt osobe se ne proveravaju posebno
• Izmene isprava se dodeljuju preko ključa
• Bez API ključa se ništa ne upituje
• Provera adresa prema minijaturnom izvodu

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

Nemački prevod nalazi se u i18n/de.po.

Ograničenja i pravna napomena

• Pogodak je napomena, a ne pravna informacija. Status se izvodi iz ključnih reči u važećim upisima registra. Sami proverite registar pre nego što odlučite o kreditu ili uslovima isporuke.
• Prepoznavanje stečaja proveravano samo na sastavljenim slučajevima. Modul prepoznaje postupke po rečima u slobodnom tekstu pravnih činjenica (otvaranje, obustava, potvrđen plan sanacije, zbog nedostatka imovine). Njihov format smo ponovo sastavili prema pravom izvodu iz registra, ali pravi slučaj stečaja pri razvoju nismo imali pri ruci. Neobična formulacija zato može biti previđena. Zvaničnu Ediktsdatei modul ne zamenjuje.
• Godišnji obračuni samo kao XML. Čisti PDF podnesci se preskaču. Kod veoma malih društava bilans može biti podnet skraćeno, bez brojeva koje modul čita.
• Samo Austrija. Strane firme se ne upituju. Veb sajtovi firmi ne stoje u registru i ne dopunjavaju se.
• Automatska dodela samo kod jednoznačnog pogotka. Ako postoji više firmi sa istim nazivom, poruka u kanalu traži ručnu Pretragu Firmenbucha.
• Interfejsi se mogu menjati. Modul zavisi od usluga BMJ i BEV. Ako se promene krajnja tačka, šema ili ATOM feed, može biti potrebno ažuriranje.
• Testirano za Odoo 19. Razvijeno i testirano za Odoo 19.0 Community. Za druge verzije ga nismo proveravali. Članak nije pravni savet.

Česta pitanja

Da li pristup registru nešto košta?

Prema našem stanju ne: FBW-WebServices za ponovnu upotrebu informacija su besplatni, ali traže API ključ koji tražite preko JustizOnline. Merodavni su aktuelni uslovi Ministarstva pravde.

Da li se postojeći podaci kontakata prepisuju?

Ne. Modul upisuje samo u prazna polja. Odstupajuće vrednosti se kreiraju kao predlog koji zaposleni odobrava po polju.

Da li moji klijenti išta primećuju od provere?

Ne. Sve poruke idu internom kanalu, chatteru kontakta i kao aktivnost zaposlenima. Modul ne šalje e-mailove klijentima.

Da li se čuvaju poslovođe ili članovi društva?

Imena poslovođa ovlašćenih za zastupanje da (polje Poslovođa u kartici Firmenbuch), članovi društva i adrese lica ne. Imena tretirajte kao lične podatke.

Koliko naših klijenata modul pronalazi?

To zavisi od baze klijenata. Kod nas je bilo 138 od 438 poslovnih kontakata (oko trećina). Ostatak su fizička lica, samostalni preduzetnici, strane firme i kontakti čiji naziv ne odgovara nazivu firme. Brojke stoje u odeljku Test na sopstvenoj bazi klijenata.

Mogu li da pronađem klijenta bez broja u Firmenbuchu?

Da. Kartica Firmenbuch ima dugme Pretraga Firmenbucha sa pretragom po nazivu. Modul automatski upisuje samo ako odgovara tačno jedna firma. Inače sami birate pogodak.

Šta je sa firmama u Nemačkoj ili Švajcarskoj?

One se ne upituju. Modul posmatra samo kontakte sa zemljom Austrija ili bez zemlje.

Koliko memorije treba provera adresa?

Sa kućnim brojevima oko 400 MB u bazi podataka i pri uvozu oko 120 MB privremenog prostora na disku. Bez provere kućnih brojeva dovoljno je oko 150.000 redova.

Šta ako želim samo Firmenbuch, a ne i proveru adresa?

Isključite Proveri austrijske adrese u podešavanjima i deaktivirajte planiranu akciju za registar adresa. Tada se ništa ne preuzima.

Pod kojom licencom je modul?

Pod LGPL-3. Smete da ga koristite, prilagođavate i prosleđujete. Greške i predloge za poboljšanje možete prijaviti kao Issue u GitHub repozitorijumu .

Podrška kompanije Biricon IT Services

Brinemo o Odoo instalacijama za mala i srednja preduzeća: od uvođenja, preko prilagođavanja i migracija, do tekućeg rada. Ako želite da matične podatke klijenata u Odoou održavate urednim, ranije prepoznajete rizike kreditne sposobnosti ili da proverite modul poput ovog i bezbedno ga unesete u svoju produktivnu instancu, rado ćemo vas podržati. Druge sopstvene razvoje pronaći ćete u našem blogu, na primer Setovi proizvoda u ponudi kao odeljak i Web RBL, lista blokiranja za napadački saobraćaj.

Obratite nam se

Stanje na dan: 3. novembar 2026. Verzija modula 19.0.1.1.1. Primeri podataka na slikama su slobodno odabrani i nisu prave firme.