Odoo 19 Community: Firmenbuch u verifika tal-indirizzi għal klijenti Awstrijaċi – il-modulu open source tagħna partner_firmenbuch_at

Min jagħmel in-negozju fl-Awstrija jaf il-mistoqsijiet: L-isem tad-ditta u l-indirizz tal-klijent il-ġdid tiegħi huma korretti? Id-ditta għadha fil-Firmenbuch, jew hija fi likwidazzjoni? Infetaħ proċediment ta' insolvenza dwar il-klijent li nforni għal sentejn? It-tweġibiet jinsabu fil-Firmenbuch tal-Ministeru tal-Ġustizzja, iżda kważi ħadd ma jiċċekkja regolarment. F'Odoo l-kuntatt jinħoloq darba, u wara jixjieħ.

Għal dan żviluppajna l-modulu Firmenbuch għas-sieħba (partner_firmenbuch_at). Jgħaqqad il-kuntatti ta' Odoo mal-Firmenbuch u mar-reġistru uffiċjali tal-indirizzi tal-BEV. Huwa miktub għal Odoo 19 u disponibbli b'xejn fuq GitHub bħala softwer ħieles taħt il-liċenzja LGPL-3:

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

Il-problema: Data prinċipali li ħadd ma jżomm aġġornata

Kuntatt f'Odoo normalment jinħoloq taħt pressjoni taż-żmien: Isem, indirizz approssimattiv, forsi UID. Dan huwa biżżejjed għall-ewwel offerta. Mhuwiex biżżejjed għal fatturi li jridu jkunu indirizzati b'mod legalment korrett, u żgur mhux biex wieħed jinduna li xi ħaġa nbidlet għand il-klijent. Fil-prattika jidhru erba' lakuni:

• Data prinċipali mhux kompluta. In-numru tal-Firmenbuch, il-qorti u l-forma legali kważi dejjem ikunu nieqsa, għax it-tfittxija hija xogħol manwali.
• Kitbiet żbaljati. Isem tad-ditta mingħajr forma legali, żbalji tat-tipografija fit-triq jew fil-post, kodiċi postali mibdul. Wieħed jinduna biss meta tirritorna l-posta.
• Ebda monitoraġġ. Jekk qorti tiftaħ proċediment ta' insolvenza jew klijent jaqta' s-soċjetà tiegħu, Odoo ma jkun jaf xejn dwar dan. Il-bejgħ ikompli jforni fuq kreditu.
• Sorsi mxerrda. Il-Firmenbuch, il-kontijiet annwali u r-reġistru tal-indirizzi jinsabu f'postijiet differenti. Min irid jivverifikahom jikkopja d-data bl-idejn bejn tieqa tal-browser u oħra.

Dak li jagħmel il-modulu

1. Ditti ġodda jiġu mfittxija. Jekk xi ħadd joħloq kuntatt bħala ditta (pajjiż Awstrija jew vojt), il-modulu jfittex fil-Firmenbuch fi żmien ftit minuti. Jekk ikun hemm eżattament riżultat wieħed, il-kampi vojta jiġu kkompletati: triq, kodiċi postali, post, pajjiż, numru tal-Firmenbuch, qorti u forma legali.
2. Id-differenzi jiġu ssuġġeriti, qatt sovrascritti. Jekk fil-kuntatt hemm xi ħaġa differenti mir-reġistru, jinħoloq suġġeriment ta' bidla li impjegat japprova għal kull qasam.
3. Tfittxija fil-Firmenbuch fuq il-kuntatt. Fit-tab Firmenbuch it-tfittxija ssib ditti bl-isem, anke jekk ir-riżultat awtomatiku ma kienx inekwivoku.
4. Sorveljanza ta' kuljum. Il-modulu jistaqsi kuljum liema ditti u dokumenti nbidlu fir-reġistru, u jivverifika l-klijenti affettwati. Barra minn hekk, f'intervalli li jistgħu jiġu rranġati, kull ditta tiġi vverifikata mill-ġdid kompletament.
5. Livelli ta' twissija. Proċedimenti ta' insolvenza u ta' risanament miftuħa (mill-fatti legali tar-reġistru), likwidazzjoni, kanċellazzjoni, ekwità negattiva u proporzjon baxx tal-ekwità jiġu rikonoxxuti u murija fuq il-kuntatt.
6. Verifika tal-indirizzi. L-indirizzi Awstrijaċi jiġu vverifikati lokalment kontra r-reġistru uffiċjali tal-indirizzi tal-Bundesamt für Eich- und Vermessungswesen (BEV).
7. Data tar-reġistru fuq il-kuntatt. Qorti, forma legali, maniġers u l-fatti legali jinsabu fit-tab Firmenbuch. Jirriflettu r-reġistru u jiġu aġġornati direttament.
8. Rapporti biss għal ġewwa. Il-messaġġi kollha jmorru fil-kanal intern ta' Discuss Firmenbuch u fil-chatter tal-kuntatt. Verifika fuq ħafna ditti toħloq messaġġ kollettiv minflok wieħed għal kull ditta. Il-modulu qatt ma jibgħat xejn lill-klijenti.

Suġġerimenti minflok sovrascrittura

Data uffiċjali mhix awtomatikament l-aħjar data għan-negozju tiegħek: Forsi fil-kuntatt hemm apposta l-indirizz tal-kunsinna, forsi ġie introdott isem qasir. Għalhekk il-modulu qatt ma jbiddel waħdu valuri eżistenti. Jikkompleta biss il-kampi vojta u, f'każ ta' differenzi, joħloq suġġeriment.

Taħt Kuntatti → Firmenbuch → Suġġerimenti tal-Firmenbuch tara għal kull qasam il-valur attwali u l-valur tar-reġistru. Il-kampi li ma tridx tapplika ħallihom mhux magħżulin. Bi Applika l-magħżulin jinkitbu biss il-kampi mmarkati, bi Irrifjuta is-suġġeriment jiskadi. Suġġeriment ġdid jieħu post suġġerimenti miftuħa eqdem tal-istess kuntatt, biex ma jiġux applikati valuri skaduti.

Twissijiet: Insolvenza, likwidazzjoni, karta tal-bilanċ

Il-modulu jiddistingwi tliet livelli:

• Bla ħsara: M'hemm xejn x'jiġi rrapportat.
• Twissija (isfar): Fir-reġistru hemm entrati validi dwar likwidazzjoni, xoljiment, għeluq, kanċellazzjoni jew fużjoni, id-ditta hija mmarkata bħala kanċellata, jew proċediment ta' insolvenza preċedenti ġie rtirat fl-aħħar snin (awtomatikament tliet snin, jista' jiġi rranġat). Jew il-kont annwali juri ekwità negattiva, proporzjon tal-ekwità taħt it-8 % (valur awtomatiku fuq il-bażi tal-§ 23 URG, jista' jiġi rranġat), telf annwali jew tnaqqis fil-fatturat ta' 25 % jew aktar.
• Kritiku (aħmar): Proċediment ta' insolvenza, ta' falliment jew ta' risanament huwa miftuħ u għadu ma ġiex irtirat, jew talba ġiet miċħuda minħabba nuqqas ta' assi biex jinqdew l-ispejjeż. Dan tal-aħħar jingħadd bħala insolvenza.

Fuq il-kuntatt jidher banner ikkulurit, fil-lista tal-kuntatti avviż, u fit-tfittxija hemm filtri għal Twissija tal-Firmenbuch u Firmenbuch kritiku. Jekk klijent isir kritiku, il-bejjiegħ responsabbli (jew, jekk ma jkunx hemm, l-amministratur) jirċievi attività Firmenbuch: Ivverifika l-klijenti, u l-kanal Firmenbuch jirċievi messaġġ.

Fatti legali. Il-proċedimenti ta' insolvenza ma jinsabux fir-reġistru fit-test tad-ditta, iżda bħala fatti legali bid-data, in-numru tal-fajl u l-qorti. Il-modulu jaqrahom, jassenja l-ftuħ u r-rtirar lill-istess numru tal-fajl u juriehom fuq il-kuntatt bħala lista. B'hekk proċediment irtirat wara xi snin jibqa' biss informazzjoni, wieħed li għadu għaddej huwa aħmar.

Kontijiet annwali. Jekk l-aħħar kont annwali jkun disponibbli bħala XML, il-modulu jaqra l-ekwità, ir-riżultat tas-sena, it-total tal-karta tal-bilanċ u l-fatturat u jikkalkula l-proporzjon tal-ekwità, il-bidla fil-fatturat u l-kategorija tad-daqs skont il-§ 221 UGB (inklużi s-soċjetajiet żgħar ħafna). Is-soċjetajiet żgħar m'għandhomx għalfejn jippubblikaw il-fatturat tagħhom, f'dak il-każ il-modulu ma juri l-ebda wieħed. Ir-riżultat tagħhom jiddeduċih mill-profitt tal-karta tal-bilanċ naqqas il-profitt riportat, u jimmarkah bħala stima. L-ismijiet tal-pożizzjonijiet li jiġu mfittxija jistgħu jiġu rranġati, għax l-XML huwa mibni b'mod differenti skont il-formola.

Verifika tal-indirizzi bir-reġistru tal-indirizzi tal-BEV

Il-BEV jipprovdi r-reġistru tal-indirizzi bħala data miftuħa (Adresse Relationale Tabellen – Stichtagsdaten, data ta' referenza ġdida darbtejn fis-sena, jista' jintuża b'xejn bl-indikazzjoni tas-sors). Il-modulu jniżżel l-estratt mis-servizz uffiċjali INSPIRE-ATOM, madwar 120 MB b'madwar 2,5 miljun indirizz, u jimportah f'tabelli tiegħu, rqaq.

Wara dan, kull indirizz ta' ditta Awstrijaka b'triq jiġi vverifikat lokalment meta jinħoloq u f'kull bidla: kodiċi postali, triq, numru tad-dar, post u stat federali. L-ebda indirizz ma jmur lil servizz. Ir-riżultat jidher bħala sinjal taħt l-indirizz:

• Validu: L-indirizz jeżisti hekk fir-reġistru.
• Numru tad-dar mhux magħruf: Triq u post huma korretti, in-numru tad-dar le.
• Korrezzjoni suġġerita: Żbalji tat-tipografija fit-triq jew fil-post, kodiċi postali ħażin. Il-korrezzjoni tkun lesta bħala suġġeriment.
• Ma nstabx: Ir-reġistru ma jafx dan l-indirizz.

Stat federali vojt jiġi kkompletat direttament. L-indirizzi privati tal-kuntatti (tip Indirizz privat) ma jiġux vverifikati. L-indikazzjoni tas-sors © Österreichisches Adressregister, Stichtagsdaten vom … tidher bid-data ta' referenza attwali fl-impostazzjonijiet. L-aġġornament jaħdem kull ġimgħa, iżda jniżżel biss jekk il-BEV ikun ippubblika data ta' referenza aktar riċenti.

Implimentazzjoni teknika

L-aċċess għar-reġistru

Il-Ministeru tal-Ġustizzja joffri l-Firmenbuch permezz tal-FBW-WebServices (HVD) fuq JustizOnline bħala interface SOAP. L-aċċess huwa b'xejn, iżda jeħtieġ API key, li wieħed jitlob b'ID Austria taħt Informationsweiterverwendung. Il-key tintbagħat fl-header HTTP X-API-KEY. Il-modulu juża s-servizz direttament, mingħajr screen-scraping.

Il-client models/firmenbuch_client.py huwa Python pur mingħajr dipendenza minn Odoo. Jaf il-mistoqsijiet SUCHEFIRMAREQUEST, AUSZUG_V2_REQUEST, SUCHEURKUNDEREQUEST, URKUNDEREQUEST kif ukoll VERAENDERUNGENFIRMAREQUEST u VERAENDERUNGENURKUNDEREQUEST. B'hekk jista' jiġi ttestjat b'tweġibiet maħżuna. It-talbiet isiru b'distanza ta' 0,3 sekondi, il-mistoqsijiet dwar bidliet f'blokki ta' seba' ijiem.

Evalwazzjoni tal-estratt

Mill-estratt jintużaw biss entrati li għadhom validi (attribut AUFRECHT mhux false). L-isem ġej mis-sinjal tad-data FI_DKZ02, l-indirizz minn FI_DKZ03, is-sede minn FI_DKZ06 u l-forma legali minn FI_DKZ07. Għal dan jiżdiedu l-qorti, l-indirizz tal-web, il-persuni awtorizzati li jirrappreżentaw u l-fatti legali. Għal livell ta' twissija t-testi tal-entrati validi kollha jiġu mfittxija għall-kliem ewlieni li jistgħu jiġu rranġati:

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

Il-vantaġġ tal-verifika bil-kliem ewlieni: Taħdem indipendentement minn liema qasam ir-reġistru juża għal proċess. L-iżvantaġġ jinsab fit-taqsima Limiti.

Sorveljanza

Il-modulu joħloq tliet azzjonijiet ippjanati:

• Fittex ditti ġodda (kull 10 minuti, sa 20 kuntatt għal kull tmexxija). Barra minn hekk jinbeda immedjatament meta jinħoloq.
• Issorvelja d-ditti (kuljum fil-04:30). Jistaqsi dwar ditti u dokumenti mibdula mill-aħħar tmexxija (l-aktar 30 jum lura), jivverifika l-klijenti affettwati u wara sa 50 klijent li l-aħħar verifika tagħhom saret aktar mill-limitu stabbilit. Kull ditta tinħażen f'transazzjoni separata, biex żball ma jitlifx riżultati preċedenti. Ir-riżultat tat-tmexxija jasal bħala messaġġ kollettiv wieħed fil-kanal.
• Aġġorna r-reġistru tal-indirizzi (kull ġimgħa fl-03:15).

Mingħajr API key l-ewwel tnejn jirritornaw immedjatament. Checksum għal kull ditta jevita li estratti bla bidla jiġu evalwati mill-ġdid.

Ir-reġistru tal-indirizzi

Id-data tal-BEV tinsab fi tliet tabelli (bev.locality, bev.street, bev.address) b'indiċi fuq il-kodiċi postali, in-numru ta' identifikazzjoni tat-triq u n-numru tad-dar. L-importazzjoni taħdem permezz ta' COPY f'transazzjoni waħda, għalhekk it-tabelli jiġu mibdula f'pass wieħed. In-numri tad-djar jiġu normalizzati fil-kitba tar-reġistru (51-55, 12a). Bin-numri tad-djar t-tabelli jokkupaw madwar 400 MB fid-database. Min ma jridx dan, jitfi Ivverifika n-numri tad-djar u jlaħħaq b'madwar 150,000 linja.

Dak li tgħallimna mis-servizz reali

Modulu ttestjat biss kontra tweġibiet tat-test miktuba minna nfusna ma jitqiesx lest. Għalhekk ivverifikajna l-client kontra s-servizz reali qabel il-pubblikazzjoni, bil-key tad-ditta tagħna stess. Hekk innutaw diversi differenzi mill-ipoteżijiet tagħna, li rranġajna:

• Biss l-informazzjoni qasira. L-estratt jista' jinġieb b'din il-key biss fil-qies ta' informazzjoni qasira. Talbiet b'informazzjoni sħiħa is-servizz jirrifjutahom. Fil-verżjoni 1.0.0 it-tmexxija ta' kuljum kienet għadha titlob dan b'mod żbaljat, il-verżjoni 1.1.0 tirranġah. Mill-persuni l-modulu jieħu biss l-ismijiet tal-maniġers awtorizzati li jirrappreżentaw; is-sidien u l-indirizzi tal-persuni ma jinqarawx.
• Triq u numru tad-dar separati. L-indirizz jiġi bħala STRASSE u HAUSNUMMER f'elementi separati, mhux bħala test wieħed. Il-modulu jgħaqqad it-tnejn.
• Qorti fl-eżekuzzjoni. Il-qorti kompetenti ma tinsabx fil-parti tad-ditta, iżda fl-aħħar blokk VOLLZ tal-estratt.
• Ditti kanċellati. Ditta kanċellata tingħaraf minn attribut (MIT_FIRMA_GELOESCHT_DURCH_VNR) u mhux minn test. Il-modulu jagħmel minn dan is-sejba Ditta kanċellata, li tqajjem twissija.
• Isem id-ditta mhuwiex il-kelma tat-tfittxija. It-tfittxija tqabbel il-bidu tal-isem. “Muster GmbH” ma ssib xejn jekk ir-reġistru jikteb “Muster Gesellschaft m.b.H.”; ditti fi likwidazzjoni għandhom “in Liqu.” fl-isem, u fl-isem tal-kuntatt kultant għad hemm &. Il-modulu għalhekk jirrepeti t-tfittxija mingħajr forma legali u jqabbel ismijiet mingħajr varjanti ta' kitba tal-forma legali, mingħajr karattri HTML u mingħajr iż-żieda “in Liqu.”. Riżultat wieħed jittieħed biss jekk ismu jibda bħal dak tal-kuntatt.
• Bidliet fid-dokumenti mingħajr numru tal-Firmenbuch. Il-lista ta' dokumenti mibdula fiha biss key. In-numru tal-Firmenbuch (mingħajr l-ittri ta' verifika) jinsab fil-bidu ta' din il-key. Il-modulu jassenja l-bidliet lill-klijenti permezz tiegħu.

Għal kull wieħed minn dawn il-punti issa hemm test awtomatizzat b'tweġiba rikostruwita.

It-test fuq il-bażi tal-klijenti tagħna stess

Wara l-verżjoni 1.1.0 ittestjajna l-modulu fuq il-bażi tal-klijenti tagħna stess. L-ewwel ħadmet biss tfittxija tal-ismijiet b'qari biss, imbagħad l-assenjazzjoni tar-riżultati inekwivoċi. Ma nbidel xejn mingħajr ma nqisu l-valuri eżistenti: il-kampi vojta ġew ikkompletati, id-differenzi huma lesti bħala suġġerimenti għall-approvazzjoni, u ma ħareġ l-ebda e-mail. Ir-riżultat, mingħajr ma nsemmu ditti individwali:

• Ġew imfittxija 438 kuntatt ta' ditti bi stat ta' klijent fl-Awstrija jew mingħajr pajjiż.
• 138 minnhom ġew assenjati b'mod inekwivoku fil-Firmenbuch. 18 oħra kellhom riżultat inekwivoku tal-isem, iżda indirizz differenti fir-reġistru (trasferiment jew ditta bl-istess isem), u għalhekk ma ntmessewx. 2 ismijiet huma ambigwi.
• Madwar 280 ma sibnihomx jew sibnihom biss bħala riżultat parzjali. Dawn huma persuni privati, intrapriżi individwali, ditti barranin, kuntatti li jsemmu biss marka jew post, u ditti li isimhom fil-kuntatt ivarja mir-reġistrazzjoni, pereżempju għax hemm forma legali differenti. Għalihom tibqa' t-Tfittxija fil-Firmenbuch manwali.
• Inħolqu 63 suġġeriment ta' bidla, il-biċċa l-kbira għal triq u numru tad-dar (kitba) u għall-pajjiż.
• 66 twissija, l-ebda livell kritiku. 36 ditta huma mmarkati fir-reġistru bħala kanċellati (9 minnhom ukoll fi likwidazzjoni), 2 kellhom proċediment ta' insolvenza li sadanittant ġie rtirat u f'42 il-kont annwali ġibed l-attenzjoni: proporzjon baxx tal-ekwità, telf jew tnaqqis fil-fatturat. Ditta kanċellata mhix awtomatikament klijent mitluf, iżda raġuni biex jiġu vverifikati l-indirizz u d-destinatarju tal-fattura.

Żewġ lezzjonijiet minn dan: Bażi tal-klijenti minn operazzjoni reali hija test ferm aħjar minn kull tweġiba rikostruwita. Hawnhekk sibna żbalji fit-tfittxija tal-ismijiet, li ġew irranġati fil-verżjoni 1.1.1 (ara hawn fuq). U r-rata tas-sejbiet tiddependi ħafna minn kemm l-ismijiet tal-kuntatti jkunu ngħataw bir-reqqa: Min jikteb l-isem tad-ditta kif iżommu r-reġistru, jinstab b'mod affidabbli.

Installazzjoni u twaqqif

Rekwiżiti: Odoo 19.0 bl-apps standard Kuntatti u Discuss, il-pakkett Python requests (preżenti f'kull installazzjoni ta' Odoo) u aċċess HTTPS ħiereġ lejn justizonline.gv.at u data.bev.gv.at. Il-modulu m'għandu l-ebda dipendenza barra mill-apps standard, għalhekk ma jiġbed ebda moduli oħra.

1. Poġġi l-folder partner_firmenbuch_at fl-addons_path, aġġorna l-lista tal-apps u installa l-modulu, fuq sistemi produttivi l-aħjar l-ewwel fuq database tat-test.
2. Il-modulu joħloq il-kanal Discuss Firmenbuch (utenti interni) u jdaħħal l-amministraturi kollha. Barra minn hekk jinħolqu t-tliet azzjonijiet ippjanati.
3. Itlob API key: JustizOnline (ID Austria), Informationsweiterverwendung, API FBW.
4. Impostazzjonijiet → Firmenbuch: daħħal il-key u Ittestja l-konnessjoni. Wara agħżel il-kanal, l-għażliet, il-kliem ewlieni u l-kodiċijiet tal-pożizzjonijiet.

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

Importanti fuq sistemi produttivi: L-ewwel tmexxija tal-aġġornament tar-reġistru tal-indirizzi tibda awtomatikament il-lejl wara l-installazzjoni fl-03:15 u tniżżel madwar 120 MB. Wara jiġu vverifikati l-kuntatti Awstrijaċi kollha; dak li jidher straordinarju jidher bħala suġġerimenti u bħala messaġġ wieħed fil-kanal. Min ma jridx dan, qabel jiddiżattiva l-azzjoni ppjanata Reġistru tal-indirizzi (BEV): aġġorna jew jitfi Ivverifika l-indirizzi Awstrijaċi fl-impostazzjonijiet.

Importazzjonijiet tal-massa: Importa bil-context keys fb_no_lookup=True u bev_no_check=True. Inkella kull ditta Awstrijaka importata tiġi rreġistrata għal mistoqsija fir-reġistru (20 kull għaxar minuti) u kull indirizz jiġi vverifikat meta jinħoloq.

Protezzjoni tad-data: Dak li l-modulu jibgħat u lil min

• Referenza għal persuni: L-ismijiet tal-maniġers huma data personali, anke jekk jidhru pubblikament fir-reġistru. Il-modulu jaħżenhom biss biex iżomm ir-relazzjoni kummerċjali. Min ma jridx dan, ineħħi l-qasam jew ma jużahx.
• Firmenbuch: Biss l-isem jew in-numru tal-Firmenbuch ta' kuntatti mmarkati bħala ditta (mingħajr ditta ta' livell ogħla, pajjiż Awstrija jew vojt) imur lil justizonline.gv.at, flimkien mal-API key. Persuni privati u persuni ta' kuntatt ta' ditta qatt ma jintbagħtu.
• Reġistru tal-indirizzi: Jitniżżel biss l-estratt pubbliku. L-indirizzi tal-klijenti ma joħorġux mis-sistema.
• L-ebda e-mail lill-klijenti: Ir-rapporti jmorru fil-kanal intern, fil-chatter u bħala attività lill-impjegati.
• Key: L-API key hija viżibbli biss għall-amministraturi.

Il-Firmenbuch huwa reġistru pubbliku. L-użu mill-ġdid tad-data huwa suġġett għall-kundizzjonijiet tal-Informationsweiterverwendung ta' JustizOnline.

Testijiet

Il-modulu jiġi b'18-il test awtomatizzat. Jaħdmu b'tweġibiet tar-reġistru rikostruwiti u b'estratt tal-indirizzi f'miniatura u għalhekk ma jeħtieġu la API key u lanqas netwerk:

• Normalizzazzjoni tan-numru tal-Firmenbuch
• Evalwazzjoni tal-estratt (isem, indirizz, qorti, maniġer, ditta kanċellata, entrati invalidi jiġu injorati)
• Tqabbil tal-ismijiet: varjanti ta' kitba tal-forma legali, “in Liqu.”, karattri HTML, l-ebda riżultat għal ditta barranija
• Kont annwali: ekwità, riżultat, total tal-karta tal-bilanċ
• Ditta ġdida tinstab, kampi vojta jiġu kkompletati, id-differenzi jiġu ssuġġeriti, suġġeriment jiġi applikat parzjalment
• Sorveljanza: proċediment ta' insolvenza miftuħ jistabbilixxi l-livell fuq kritiku u joħloq l-attività, proċediment irtirat jagħti twissija, persuni ta' kuntatt ma jiġux ivverifikati separatament
• Bidliet fid-dokumenti jiġu assenjati permezz tal-key
• Mingħajr API key ma jsir l-ebda mistoqsija
• Verifika tal-indirizzi kontra l-estratt f'miniatura

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

It-traduzzjoni Ġermaniża tinsab f'i18n/de.po.

Limiti u avviż legali

• Riżultat huwa indikazzjoni, mhux informazzjoni legali. L-istatus jiġi derivat minn kliem ewlieni f'entrati validi tar-reġistru. Ivverifika r-reġistru int stess qabel ma tiddeċiedi dwar kreditu jew kundizzjonijiet ta' kunsinna.
• Ir-rikonoxximent tal-insolvenza ittestjat biss b'każijiet rikostruwiti. Il-modulu jagħraf il-proċedimenti minn kliem fit-test ħieles tal-fatti legali (ftuħ, rtirar, pjan ta' risanament ikkonfermat, minħabba nuqqas ta' assi). Il-format tagħhom irrikostruwejna minn estratt reali tar-reġistru, iżda każ reali ta' insolvenza ma kellniex f'idejna waqt l-iżvilupp. Formulazzjoni mhux tas-soltu tista' għalhekk titħalla barra. Il-modulu ma jieħux post il-fajl uffiċjali tal-edikti.
• Kontijiet annwali biss bħala XML. Sottomissjonijiet PDF puri jinqabżu. F'soċjetajiet żgħar ħafna l-karta tal-bilanċ tista' tkun ġiet sottomessa mqassra, mingħajr in-numri li l-modulu jaqra.
• Biss l-Awstrija. Ditti barranin ma jiġux mistoqsija. Il-websites tad-ditti ma jinsabux fir-reġistru u ma jiġux ikkompletati.
• Assenjazzjoni awtomatika biss b'riżultat inekwivoku. Jekk ikun hemm diversi ditti bl-istess isem, messaġġ fil-kanal jitlob it-Tfittxija fil-Firmenbuch manwali.
• L-interfaces jistgħu jinbidlu. Il-modulu jiddependi mis-servizzi tal-BMJ u tal-BEV. Jekk jinbidlu l-endpoint, l-iskema jew l-ATOM feed, jista' jkun meħtieġ aġġornament.
• Ittestjat għal Odoo 19. Żviluppat u ttestjat għal Odoo 19.0 Community. Għal verżjonijiet oħra ma ivverifikajnihx. L-artikolu mhuwiex konsulenza legali.

Mistoqsijiet frekwenti

L-aċċess għar-reġistru jiswa xi ħaġa?

Skont l-għarfien tagħna le: L-FBW-WebServices għall-Informationsweiterverwendung huma b'xejn, iżda jeħtieġu API key, li titolbu permezz ta' JustizOnline. Huma deċiżivi l-kundizzjonijiet attwali tal-Ministeru tal-Ġustizzja.

Id-data eżistenti tal-kuntatti tiġi sovrascritta?

Le. Il-modulu jikteb biss f'kampi vojta. Valuri differenti jinħolqu bħala suġġeriment li impjegat japprova għal kull qasam.

Il-klijenti tiegħi jinduraw bil-verifika?

Le. Ir-rapporti kollha jmorru fil-kanal intern, fil-chatter tal-kuntatt u bħala attività lill-impjegati. Il-modulu ma jibgħat l-ebda e-mail lill-klijenti.

Jinħażnu maniġers jew sidien?

L-ismijiet tal-maniġers awtorizzati li jirrappreżentaw iva (qasam Maniġer fit-tab Firmenbuch), is-sidien u l-indirizzi tal-persuni le. Ittratta l-ismijiet bħala data personali.

Kemm mill-klijenti tagħna ssib il-modulu?

Dan jiddependi mill-bażi tal-klijenti. Għalina kienu 138 minn 438 kuntatt ta' ditti (madwar terz). Il-bqija huma persuni privati, intrapriżi individwali, ditti barranin u kuntatti li isimhom ma jaqbilx mal-isem tad-ditta. In-numri jinsabu fit-taqsima It-test fuq il-bażi tal-klijenti tagħna stess.

Nista' nsib klijent mingħajr numru tal-Firmenbuch?

Iva. It-tab Firmenbuch għandu l-buttuna Tfittxija fil-Firmenbuch b'tfittxija bl-isem. Il-modulu jidħol awtomatikament biss jekk tkun taqbel ditta waħda biss. Inkella int tagħżel ir-riżultat int stess.

X'inhu l-każ b'ditti fil-Ġermanja jew fl-Iżvizzera?

Ma jiġux mistoqsija. Il-modulu jħares biss lejn kuntatti bil-pajjiż Awstrija jew mingħajr pajjiż.

Kemm teħtieġ spazju l-verifika tal-indirizzi?

Bin-numri tad-djar madwar 400 MB fid-database u waqt l-importazzjoni madwar 120 MB spazju temporanju fuq id-disk. Mingħajr verifika tan-numri tad-djar jibqgħu biżżejjed madwar 150,000 linja.

X'jiġri jekk irrid biss il-Firmenbuch u mhux verifika tal-indirizzi?

Itfi Ivverifika l-indirizzi Awstrijaċi fl-impostazzjonijiet u iddiżattiva l-azzjoni ppjanata għar-reġistru tal-indirizzi. Allura ma jitniżżel xejn.

Taħt liema liċenzja huwa l-modulu?

Taħt l-LGPL-3. Tistgħu tużawh, tadattawh u tqassmuh. Żbalji u suġġerimenti għal titjib huma milqugħa bħala issue fuq repożitorju GitHub .

Appoġġ minn Biricon IT Services

Aħna nieħdu ħsieb installazzjonijiet Odoo għal impriżi żgħar u medji: mill-introduzzjoni, permezz ta' adattamenti u migrazzjonijiet, sat-tħaddim kontinwu. Jekk tixtiequ iżżommu d-data prinċipali tal-klijenti nadifa f'Odoo, tagħrfu r-riskji tal-kreditu aktar kmieni jew tivverifikaw modulu bħal dan u ġġibuh b'mod sigur fl-istanza produttiva tagħkom, aħna lesti nassistukom. Żviluppi oħra tagħna stess issibuhom fil-blog tagħna, pereżempju Settijiet tal-prodotti fl-offerta bħala sezzjoni u Web RBL, il-lista ta' ċaħda għat-traffiku ta' attakk.

Ikkuntattjana issa

Data: 3 ta' Novembru 2026. Verżjoni tal-modulu 19.0.1.1.1. Id-data tal-eżempju fl-illustrazzjonijiet hija magħżula liberament u mhix ditti reali.