Odoo 19 Community: cofrestr cwmnïau a gwirio cyfeiriadau ar gyfer cwsmeriaid yn Awstria – ein modiwl cod agored partner_firmenbuch_at

Mae pawb sy’n gwneud busnes yn Awstria yn gyfarwydd â’r cwestiynau hyn: a yw enw cofrestredig a chyfeiriad fy nghwsmer newydd yn gywir? A yw’r cwmni yn dal ar y gofrestr cwmnïau, neu a yw’n cael ei ddiddymu? A yw achos ansolfedd wedi’i agor yn erbyn y cwsmer rydw i wedi bod yn cyflenwi iddo ers dwy flynedd? Mae’r atebion yng nghofrestr cwmnïau y Weinyddiaeth Gyfiawnder, ond prin yw’r rhai sy’n ei gwirio’n rheolaidd. Yn Odoo, caiff y cyswllt ei greu unwaith, ac yna mae’r wybodaeth yn mynd yn hen.

Dyna pam y datblygwyd y modiwl Firmenbuch für Partner (partner_firmenbuch_at) gennym. Mae’n cysylltu cysylltiadau Odoo â’r gofrestr cwmnïau a chofrestr cyfeiriadau swyddogol y BEV. Fe’i hysgrifennwyd ar gyfer Odoo 19 ac mae ar gael am ddim ar GitHub fel meddalwedd rydd o dan drwydded LGPL-3:

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

Y broblem: data craidd nad oes neb yn ei gynnal

Fel arfer, caiff cyswllt ei greu yn Odoo dan bwysau amser: enw, cyfeiriad bras, ac efallai rhif TAW. Mae hynny’n ddigon ar gyfer y dyfynbris cyntaf. Nid yw’n ddigon ar gyfer anfonebau y mae’n rhaid eu cyfeirio’n gywir yn ôl y gyfraith, ac yn sicr nid yw’n ddigon i sylwi bod rhywbeth wedi newid ynghylch y cwsmer. Yn ymarferol, mae pedwar bwlch i’w gweld:

• Data craidd anghyflawn. Mae rhif cofrestru’r cwmni, y llys a’r ffurf gyfreithiol bron bob amser ar goll, gan fod rhaid chwilio amdanynt â llaw.
• Gwallau ysgrifennu. Enw cwmni heb ei ffurf gyfreithiol, gwallau teipio yn enw’r stryd neu’r lle, cod post â’r digidau yn y drefn anghywir. Dim ond pan fydd y post yn dod yn ôl y bydd rhywun yn sylwi.
• Dim monitro. Os bydd llys yn agor achos ansolfedd neu gwsmer yn diddymu ei gwmni, ni fydd Odoo yn cael gwybod. Bydd y tîm gwerthu yn parhau i gyflenwi ar gredyd.
• Ffynonellau ar wahân. Mae’r gofrestr cwmnïau, y cyfrifon blynyddol a’r gofrestr cyfeiriadau mewn gwahanol leoedd. Rhaid i unrhyw un sydd am eu gwirio gopïo data â llaw rhwng ffenestri’r porwr.

Beth mae’r modiwl yn ei wneud

1. Chwilio am gwmnïau newydd. Pan fydd rhywun yn creu cyswllt fel cwmni (gyda’r wlad wedi’i gosod i Awstria neu wedi’i gadael yn wag), bydd y modiwl yn chwilio yn y gofrestr cwmnïau o fewn ychydig funudau. Os oes un canlyniad yn unig, caiff y meysydd gwag eu llenwi: stryd, cod post, tref, gwlad, rhif cofrestru’r cwmni, llys a ffurf gyfreithiol.
2. Cynigir newidiadau pan fo gwahaniaethau; ni chaiff gwerthoedd eu trosysgrifo byth. Os yw manylion y cyswllt yn wahanol i’r gofrestr, crëir newid arfaethedig i aelod o staff ei gymeradwyo fesul maes.
3. Chwilio’r gofrestr cwmnïau o’r cyswllt. Yn y tab Firmenbuch, gellir chwilio am gwmnïau yn ôl enw, hyd yn oed pan nad oedd y chwiliad awtomatig wedi canfod un canlyniad pendant.
4. Monitro dyddiol. Bob dydd, mae’r modiwl yn holi pa gwmnïau a dogfennau sydd wedi newid yn y gofrestr ac yn gwirio’r cwsmeriaid dan sylw. Yn ogystal, caiff pob cwmni ei wirio’n llawn eto ar adegau y gellir eu ffurfweddu.
5. Lefelau rhybuddio. Caiff achosion ansolfedd ac ailstrwythuro sydd wedi’u hagor (o’r ffeithiau cyfreithiol yn y gofrestr), diddymu, dileu o’r gofrestr, ecwiti negyddol a chymhareb ecwiti isel eu canfod a’u dangos ar gofnod y cyswllt.
6. Gwirio cyfeiriadau. Caiff cyfeiriadau yn Awstria eu gwirio’n lleol yn erbyn cofrestr cyfeiriadau swyddogol y Swyddfa Ffederal Metroleg a Thirfesur (BEV).
7. Data’r gofrestr ar gofnod y cyswllt. Mae’r llys, y ffurf gyfreithiol, y cyfarwyddwyr rheoli a’r ffeithiau cyfreithiol yn y tab Firmenbuch. Maent yn adlewyrchu’r gofrestr ac yn cael eu diweddaru’n uniongyrchol.
8. Negeseuon mewnol yn unig. Mae pob neges yn mynd i’r sianel Discuss fewnol Firmenbuch ac i Chatter y cyswllt. Mae rhediad gwirio sy’n cwmpasu llawer o gwmnïau yn creu un neges gryno yn lle un i bob cwmni. Nid yw’r modiwl byth yn anfon dim at gwsmeriaid.

Cynnig newidiadau yn lle trosysgrifo

Nid data swyddogol yw’r data gorau i’ch busnes bob tro: efallai mai’r cyfeiriad danfon sydd ar gofnod y cyswllt yn fwriadol, neu efallai bod enw byr yn cael ei ddefnyddio’n arferol. Felly, nid yw’r modiwl byth yn newid gwerthoedd presennol ar ei liwt ei hun. Dim ond llenwi meysydd gwag y mae, a chreu cynnig pan fo gwahaniaethau.

O dan Cysylltiadau → Firmenbuch → Awgrymiadau Firmenbuch gwelwch y gwerth cyfredol a gwerth y gofrestr ar gyfer pob maes. Gadewch heb eu dewis y meysydd nad ydych am eu derbyn. Gyda Derbyn y dewisiadau, dim ond y meysydd sydd wedi'u marcio a ysgrifennir; gyda Gwrthod, mae'r awgrym yn dod i ben. Mae awgrym newydd yn disodli awgrymiadau agored hŷn yr un cyswllt, fel na chaiff gwerthoedd hen eu cymhwyso.

Rhybuddion: ansolfedd, diddymu, mantolen

Mae’r modiwl yn gwahaniaethu rhwng tair lefel:

• Dim pryder: Nid oes dim i’w adrodd.
• Rhybudd (melyn): Mae cofnodion dilys yn y gofrestr ynghylch ymddatod, diddymu, dirwyn i ben, dileu neu uno, mae’r cwmni wedi’i farcio fel un sydd wedi’i ddileu, neu daeth achos ansolfedd blaenorol i ben yn ystod y blynyddoedd diwethaf (tair blynedd yn ddiofyn, a gellir newid hyn). Neu mae’r cyfrifon blynyddol yn dangos ecwiti negyddol, cymhareb ecwiti o dan 8 % (y rhagosodiad, yn seiliedig ar § 23 URG, a gellir ei newid), colled flynyddol neu ostyngiad o 25 % neu fwy mewn trosiant.
• Critigol (coch): Mae achos ansolfedd, methdaliad neu ailstrwythuro wedi’i agor ac nid yw wedi dod i ben eto, neu mae cais wedi’i wrthod oherwydd nad oedd digon o asedau i dalu’r costau. Mae’r olaf yn cyfrif fel anallu i dalu dyledion.

Mae baner liw yn ymddangos ar gofnod y cyswllt, hysbysiad yn y rhestr cysylltiadau, a hidlyddion chwilio ar gyfer Rhybudd Firmenbuch a Firmenbuch critigol. Os daw statws cwsmer yn gritigol, caiff y gwerthwr cyfrifol (neu’r gweinyddwr os nad oes un) weithgaredd Firmenbuch: gwirio cwsmeriaid, a chaiff sianel Firmenbuch neges.

Ffeithiau cyfreithiol. Nid yng nhestun y cwmni y mae achosion ansolfedd yn ymddangos yn y gofrestr, ond fel ffeithiau cyfreithiol gyda dyddiad, cyfeirnod achos a llys. Mae’r modiwl yn eu darllen, yn cysylltu agor a chau achos â’r un cyfeirnod, ac yn eu dangos fel rhestr ar gofnod y cyswllt. Felly, ar ôl ychydig flynyddoedd, gwybodaeth yn unig yw achos sydd wedi dod i ben, tra bo achos sy’n dal ar agor yn goch.

Cyfrifon blynyddol. Os yw’r cyfrifon blynyddol diweddaraf ar gael fel XML, mae’r modiwl yn darllen yr ecwiti, y canlyniad blynyddol, cyfanswm y fantolen a’r trosiant, ac yn cyfrifo’r gymhareb ecwiti, y newid mewn trosiant a’r dosbarth maint yn ôl § 221 UGB (gan gynnwys microgwmnïau). Nid oes rhaid i gwmnïau bach gyhoeddi eu trosiant; yn yr achos hwnnw, nid yw’r modiwl yn ei ddangos. Mae’n deillio eu canlyniad o elw’r fantolen llai’r elw a ddygwyd ymlaen, ac yn ei nodi fel amcangyfrif. Gellir ffurfweddu enwau’r eitemau y chwilir amdanynt, gan fod strwythur yr XML yn amrywio yn ôl y ffurflen.

Gwirio cyfeiriadau â chofrestr cyfeiriadau’r BEV

Mae’r BEV yn darparu’r gofrestr cyfeiriadau fel data agored (Adresse Relationale Tabellen – Stichtagsdaten, gyda dyddiad cyfeirio newydd ddwywaith y flwyddyn, ac mae’n rhad ac am ddim i’w ddefnyddio gan gydnabod y ffynhonnell). Mae’r modiwl yn lawrlwytho’r detholiad drwy’r gwasanaeth INSPIRE-ATOM swyddogol, tua 120 MB gyda thua 2.5 miliwn o gyfeiriadau, ac yn ei fewnforio i’w dablau cryno ei hun.

Yna, caiff pob cyfeiriad cwmni yn Awstria sy’n cynnwys stryd ei wirio yn lleol wrth ei greu a phob tro y caiff ei newid: cod post, stryd, rhif adeilad, tref a thalaith ffederal. Ni chaiff unrhyw gyfeiriad ei anfon at wasanaeth. Dangosir y canlyniad fel dangosydd o dan y cyfeiriad:

• Dilys: Mae’r cyfeiriad yn bodoli yn union fel hyn yn y gofrestr.
• Rhif adeilad anhysbys: Mae’r stryd a’r dref yn gywir, ond nid rhif yr adeilad.
• Cywiriad wedi’i gynnig: Gwall teipio yn enw’r stryd neu’r lle, neu god post anghywir. Mae’r cywiriad ar gael fel cynnig.
• Heb ei ganfod: Nid yw’r cyfeiriad hwn yn y gofrestr.

Os yw maes y dalaith ffederal yn wag, caiff ei lenwi’n uniongyrchol. Ni chaiff cyfeiriadau cysylltiadau preifat (math Cyfeiriad preifat) eu gwirio. Mae’r gydnabyddiaeth ffynhonnell © Österreichisches Adressregister, Stichtagsdaten vom … yn ymddangos yn y gosodiadau gyda’r dyddiad cyfeirio cyfredol. Mae’r diweddariad yn rhedeg bob wythnos, ond dim ond os yw’r BEV wedi cyhoeddi dyddiad cyfeirio mwy diweddar y caiff data ei lawrlwytho.

Y gweithrediad technegol

Mynediad at y gofrestr

Mae’r Weinyddiaeth Gyfiawnder yn cynnig y gofrestr cwmnïau drwy FBW-WebServices (HVD) ar JustizOnline fel rhyngwyneb SOAP. Mae mynediad am ddim, ond mae angen allwedd API, y gellir gwneud cais amdani gan ddefnyddio ID Austria o dan Informationsweiterverwendung. Anfonir yr allwedd ym mhennyn HTTP X-API-KEY. Mae’r modiwl yn defnyddio’r gwasanaeth yn uniongyrchol, heb sgrapio sgriniau.

Mae’r cleient models/firmenbuch_client.py wedi’i ysgrifennu’n gyfan gwbl yn Python heb ddibynnu ar Odoo. Mae’n cefnogi’r ymholiadau SUCHEFIRMAREQUEST, AUSZUG_V2_REQUEST, SUCHEURKUNDEREQUEST, URKUNDEREQUEST, VERAENDERUNGENFIRMAREQUEST a VERAENDERUNGENURKUNDEREQUEST. Felly, gellir ei brofi ag ymatebion sydd wedi’u cadw. Anfonir ceisiadau bob 0.3 eiliad, ac ymholiadau am newidiadau mewn cyfnodau o saith diwrnod.

Dadansoddi’r detholiad

Dim ond cofnodion sy’n dal yn ddilys a ddefnyddir o’r detholiad (priodoledd AUFRECHT heb fod yn false). Daw’r enw o’r dynodwr data FI_DKZ02, y cyfeiriad o FI_DKZ03, y swyddfa gofrestredig o FI_DKZ06 a’r ffurf gyfreithiol o FI_DKZ07. Ychwanegir y llys, cyfeiriad y wefan, y bobl sydd ag awdurdod i gynrychioli’r cwmni a’r ffeithiau cyfreithiol. I bennu’r lefel rhybuddio, chwilir testun pob cofnod dilys am yr allweddeiriau ffurfweddadwy:

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

Mantais gwirio allweddeiriau yw ei fod yn gweithio ni waeth ym mha faes y mae’r gofrestr yn cofnodi digwyddiad. Esbonnir yr anfantais yn yr adran Cyfyngiadau.

Monitro

Mae’r modiwl yn creu tri gweithred wedi’u hamserlennu:

• Chwilio am gwmnïau newydd (bob 10 munud, hyd at 20 cyswllt ym mhob rhediad). Hefyd, caiff y broses ei sbarduno ar unwaith wrth greu cofnod.
• Monitro cwmnïau (bob dydd am 04:30). Mae’n holi am gwmnïau a dogfennau sydd wedi newid ers y rhediad diwethaf (hyd at 30 diwrnod yn ôl), yn gwirio’r cwsmeriaid dan sylw, ac yna hyd at 50 o gwsmeriaid nad ydynt wedi’u gwirio o fewn y cyfnod a bennwyd. Caiff pob cwmni ei gadw mewn trafodiad ar wahân, fel na fydd gwall yn colli canlyniadau blaenorol. Anfonir canlyniad y rhediad fel un neges gryno i’r sianel.
• Diweddaru’r gofrestr cyfeiriadau (bob wythnos am 03:15).

Heb allwedd API, mae’r ddau weithred cyntaf yn dod i ben ar unwaith. Mae swm gwirio ar gyfer pob cwmni yn atal dadansoddi detholiadau sydd heb newid eto.

Y gofrestr cyfeiriadau

Mae data’r BEV mewn tri thabl (bev.locality, bev.street, bev.address) gyda mynegai ar y cod post, y dynodwr stryd a rhif yr adeilad. Mae’r mewnforio’n defnyddio COPY mewn un trafodiad, felly caiff y tablau eu disodli mewn un cam. Caiff rhifau adeiladau eu safoni i ffurf y gofrestr (51-55, 12a). Gyda rhifau adeiladau, mae’r tablau’n cymryd tua 400 MB yn y gronfa ddata. Os nad ydych am hynny, gallwch ddiffodd Gwirio rhifau adeiladau a defnyddio tua 150,000 o resi yn unig.

Yr hyn a ddysgon ni o’r gwasanaeth go iawn

Nid yw modiwl sydd ond wedi’i brofi yn erbyn ymatebion prawf a ysgrifennwyd gennym ni ein hunain yn barod eto. Felly, cyn ei gyhoeddi, fe wnaethom brofi’r cleient yn erbyn y gwasanaeth go iawn, gan ddefnyddio allwedd ein cwmni ein hunain. Datgelodd hyn sawl gwahaniaeth rhwng ein tybiaethau a’r realiti, a chawsant eu cywiro:

• Gwybodaeth gryno yn unig. Dim ond y darn o’r gofrestr sy’n cynnwys gwybodaeth gryno y gellir ei gael gyda’r allwedd hon. Mae’r gwasanaeth yn gwrthod ceisiadau am wybodaeth lawn. Yn fersiwn 1.0.0, roedd y rhediad dyddiol yn dal i ofyn am yr wybodaeth anghywir; mae fersiwn 1.1.0 yn cywiro hynny. O’r manylion am bobl, dim ond enwau’r rheolwyr gyfarwyddwyr sydd ag awdurdod i gynrychioli’r cwmni y mae’r modiwl yn eu mewnforio; nid yw’n darllen manylion cyfranddalwyr na chyfeiriadau unigolion.
• Y stryd a rhif y tŷ ar wahân. Daw’r cyfeiriad fel STRASSE a HAUSNUMMER mewn elfennau ar wahân, yn hytrach nag fel un darn o destun. Mae’r modiwl yn cyfuno’r ddau.
• Y llys yn yr adran weithredu. Nid yw’r llys cyfrifol wedi’i nodi yn adran y cwmni, ond ym mloc VOLLZ olaf y darn o’r gofrestr.
• Cwmnïau sydd wedi’u dileu. Priodoledd (MIT_FIRMA_GELOESCHT_DURCH_VNR) sy’n dangos bod cwmni wedi’i ddileu, yn hytrach na thestun. Mae’r modiwl yn dehongli hyn fel Cwmni wedi’i ddileu, sy’n sbarduno rhybudd.
• Nid enw’r cwmni yw’r term chwilio. Mae’r chwiliad yn cymharu dechrau’r enw. Nid yw “Muster GmbH” yn dod o hyd i ddim os yw’r gofrestr yn defnyddio “Muster Gesellschaft m.b.H.”; mae “in Liqu.” yn rhan o enw cwmnïau sy’n cael eu diddymu, ac weithiau mae & yn dal i ymddangos yn enw’r cyswllt. Felly mae’r modiwl yn ailadrodd y chwiliad heb y ffurf gyfreithiol ac yn cymharu enwau heb amrywiadau sillafu’r ffurf gyfreithiol, heb nodau HTML a heb yr ychwanegiad “in Liqu.”. Dim ond os yw enw canlyniad unigol yn dechrau ag enw’r cyswllt y caiff ei dderbyn.
• Newidiadau i ddogfennau heb rif cofrestru cwmni. Dim ond allwedd sydd yn y rhestr o ddogfennau sydd wedi newid. Mae rhif cofrestru’r cwmni (heb y llythyren wirio) ar ddechrau’r allwedd hon. Mae’r modiwl yn defnyddio hwn i gysylltu’r newidiadau â’r cwsmeriaid.

Bellach mae prawf awtomataidd ag ymateb efelychiadol ar gyfer pob un o’r pwyntiau hyn.

Profi ar ein cronfa gwsmeriaid ein hunain

Ar ôl fersiwn 1.1.0, gwnaethom brofi’r modiwl ar ein cronfa gwsmeriaid ein hunain. Yn gyntaf, dim ond chwiliad enwau darllen yn unig a redwyd, ac yna cysylltwyd y canlyniadau diamwys. Rhoddwyd ystyriaeth i’r gwerthoedd presennol wrth wneud pob newid: llenwyd meysydd gwag, mae gwahaniaethau’n aros fel awgrymiadau i’w cymeradwyo, ac ni anfonwyd yr un e-bost. Dyma’r canlyniad, heb enwi unrhyw gwmnïau unigol:

• Chwiliwyd am 438 o gysylltiadau cwmni â statws cwsmer yn Awstria neu heb wlad wedi’i nodi.
• Cafodd 138 ohonynt eu paru'n ddiamwys yn y Firmenbuch. Roedd gan 18 arall ganlyniad enw diamwys, ond cyfeiriad gwahanol yn y gofrestr (symud neu gwmni o'r un enw), ac felly cawsant eu gadael heb eu cyffwrdd. Mae 2 enw yn amwys.
• Ni ddaethom o hyd i tua 280, neu dim ond cyfatebiaeth rannol a gafwyd. Unigolion preifat, unig fasnachwyr, cwmnïau tramor, cysylltiadau sy’n nodi brand neu le yn unig, a chwmnïau y mae eu henw yn y cyswllt yn wahanol i’r cofnod cofrestredig yw’r rhain, er enghraifft am fod ffurf gyfreithiol wahanol wedi’i nodi. Mae’r Chwiliad cofrestr cwmnïau â llaw ar gael ar eu cyfer.
• Crëwyd 63 o awgrymiadau newid, yn bennaf ar gyfer y stryd a rhif y tŷ (y ffordd yr oeddent wedi’u hysgrifennu) a’r wlad.
• 66 o rybuddion, dim un ar lefel gritigol. Mae 36 o gwmnïau wedi’u marcio fel rhai sydd wedi’u dileu yn y gofrestr (mae 9 ohonynt hefyd yn cael eu diddymu), roedd gan 2 achos ansolfedd sydd bellach wedi’i derfynu, ac roedd cyfrifon blynyddol 42 yn haeddu sylw: cymhareb ecwiti isel, colled neu ostyngiad mewn trosiant. Nid yw cwmni sydd wedi’i ddileu o reidrwydd yn gwsmer sydd wedi’i golli, ond mae’n rheswm dros wirio’r cyfeiriad a derbynnydd yr anfoneb.

Dysgwyd dau beth o hyn: mae cronfa gwsmeriaid o fusnes go iawn yn brawf llawer gwell nag unrhyw ymateb efelychiadol. Daethom o hyd i wallau yn y chwiliad enwau sydd wedi’u cywiro yn fersiwn 1.1.1 (gweler uchod). Ac mae cyfradd y cyfatebiaethau’n dibynnu’n fawr ar ba mor ofalus y mae’r cysylltiadau wedi’u henwi: gellir dod o hyd i gwmnïau’n ddibynadwy pan fo’u henwau wedi’u hysgrifennu fel y maent yn y gofrestr.

Gosod a ffurfweddu

Gofynion: Odoo 19.0 gyda’r apiau safonol Cysylltiadau a Discuss, y pecyn Python requests (sydd ym mhob gosodiad Odoo) a mynediad HTTPS allan at justizonline.gv.at a data.bev.gv.at. Nid oes gan y modiwl unrhyw ddibyniaethau y tu hwnt i’r apiau safonol, felly nid yw’n gosod unrhyw fodiwlau ychwanegol.

1. Rhowch y ffolder partner_firmenbuch_at yn addons_path, diweddarwch y rhestr apiau a gosodwch y modiwl. Ar systemau cynhyrchu, mae’n well gwneud hyn ar gronfa ddata brawf yn gyntaf.
2. Mae’r modiwl yn creu’r sianel Discuss Cofrestr cwmnïau (defnyddwyr mewnol) ac yn ychwanegu pob gweinyddwr ati. Mae hefyd yn creu’r tair gweithred a drefnwyd.
3. Gwnewch gais am allwedd API: JustizOnline (ID Austria), Informationsweiterverwendung, API FBW.
4. Gosodiadau → Cofrestr cwmnïau: nodwch yr allwedd a dewiswch Profi’r cysylltiad. Yna dewiswch y sianel, yr opsiynau, yr allweddeiriau a’r codau eitemau.

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

Pwysig ar systemau cynhyrchu: Mae diweddariad cyntaf y gofrestr cyfeiriadau’n dechrau’n awtomatig am 03:15 y noson ar ôl gosod y modiwl ac yn lawrlwytho tua 120 MB. Yna caiff pob cyswllt yn Awstria ei wirio; mae unrhyw anghysondebau’n ymddangos fel awgrymiadau ac fel neges yn y sianel. Os nad ydych am i hyn ddigwydd, analluogwch y weithred a drefnwyd Cofrestr cyfeiriadau (BEV): diweddaru ymlaen llaw neu diffoddwch Gwirio cyfeiriadau Awstria yn y gosodiadau.

Mewnforio swmp: Mewnforiwch gyda’r allweddi cyd-destun fb_no_lookup=True a bev_no_check=True. Fel arall, byddai pob cwmni o Awstria a fewnforir yn cael ei roi ar restr i ymholi amdano yn y gofrestr (20 bob deng munud), a byddai pob cyfeiriad yn cael ei wirio wrth ei greu.

Diogelu data: beth mae’r modiwl yn ei anfon ac at bwy

• Data personol: Mae enwau’r rheolwyr gyfarwyddwyr yn ddata personol, hyd yn oed os ydynt ar gael i’r cyhoedd yn y gofrestr. Dim ond er mwyn cynnal y berthynas fusnes y mae’r modiwl yn eu storio. Os nad ydych am wneud hynny, dilëwch y maes neu peidiwch â’i ddefnyddio.
• Cofrestr cwmnïau: Dim ond enw neu rif cofrestru cwmni cysylltiadau sydd wedi’u marcio fel cwmni (heb riant-gwmni, a’r wlad yn Awstria neu’n wag) a anfonir at justizonline.gv.at, ynghyd â’r allwedd API. Nid yw manylion unigolion preifat na phersonau cyswllt cwmni byth yn cael eu hanfon.
• Cofrestr cyfeiriadau: Dim ond y darn cyhoeddus o’r gofrestr sy’n cael ei lawrlwytho. Nid yw cyfeiriadau cwsmeriaid yn gadael y system.
• Dim e-byst at gwsmeriaid: Mae hysbysiadau’n mynd i’r sianel fewnol, i’r Chatter ac at staff fel gweithgaredd.
• Allwedd: Dim ond gweinyddwyr sy’n gallu gweld yr allwedd API.

Mae’r gofrestr cwmnïau’n gofrestr gyhoeddus. Mae ailddefnyddio’r data yn ddarostyngedig i amodau ailddefnyddio gwybodaeth JustizOnline.

Profion

Mae’r modiwl yn cynnwys 18 o brofion awtomataidd. Maent yn defnyddio ymatebion efelychiadol o’r gofrestr a sampl fach o’r gofrestr cyfeiriadau, felly nid oes angen allwedd API na chysylltiad rhwydwaith arnynt:

• Normaleiddio rhif cofrestru’r cwmni
• Dehongli’r darn o’r gofrestr (enw, cyfeiriad, llys, rheolwyr gyfarwyddwyr, cwmni wedi’i ddileu; anwybyddir cofnodion annilys)
• Cymharu enwau: amrywiadau sillafu’r ffurf gyfreithiol, “in Liqu.”, nodau HTML, dim cyfatebiaeth â chwmni arall
• Cyfrifon blynyddol: ecwiti, elw neu golled, cyfanswm y fantolen
• Dod o hyd i gwmni newydd, llenwi meysydd gwag, cynnig newidiadau lle ceir gwahaniaethau, cymhwyso rhan o awgrym
• Monitro: mae achos ansolfedd sydd wedi’i agor yn gosod y lefel yn gritigol ac yn creu’r gweithgaredd, mae achos sydd wedi’i derfynu’n creu rhybudd, ac ni chaiff personau cyswllt eu gwirio ar wahân
• Cysylltu newidiadau i ddogfennau drwy’r allwedd
• Ni wneir unrhyw ymholiadau heb allwedd API
• Gwirio cyfeiriadau yn erbyn y sampl fach o’r gofrestr

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

Mae’r cyfieithiad Almaeneg yn i18n/de.po.

Cyfyngiadau a nodyn cyfreithiol

• Arwydd yw cyfatebiaeth, nid cyngor cyfreithiol. Pennir y statws ar sail allweddeiriau mewn cofnodion dilys yn y gofrestr. Gwiriwch y gofrestr eich hun cyn penderfynu ar gredyd neu delerau cyflenwi.
• Dim ond gydag achosion efelychiadol y profwyd adnabod ansolfedd. Mae’r modiwl yn adnabod achosion drwy eiriau yn nhestun rhydd y ffeithiau cyfreithiol (agor, terfynu, cynllun adfer wedi’i gadarnhau, diffyg asedau). Gwnaethom efelychu eu fformat ar sail darn go iawn o’r gofrestr, ond nid oedd gennym achos ansolfedd go iawn wrth ddatblygu. Felly gall geiriad anarferol gael ei fethu. Nid yw’r modiwl yn disodli’r gronfa swyddogol o hysbysiadau cyfreithiol.
• Cyfrifon blynyddol ar ffurf XML yn unig. Caiff cyflwyniadau sydd ar ffurf PDF yn unig eu hepgor. Gall cwmnïau bach iawn gyflwyno mantolen gryno heb y ffigurau y mae’r modiwl yn eu darllen.
• Awstria yn unig. Ni wneir ymholiadau am gwmnïau tramor. Nid yw gwefannau cwmnïau yn y gofrestr ac ni chânt eu hychwanegu.
• Cysylltu’n awtomatig dim ond pan fo un gyfatebiaeth ddiamwys. Os oes sawl cwmni o’r un enw, mae neges yn y sianel yn gofyn am ddefnyddio’r Chwiliad cofrestr cwmnïau â llaw.
• Gall rhyngwynebau newid. Mae’r modiwl yn dibynnu ar wasanaethau BMJ a BEV. Os bydd y diweddbwynt, y sgema neu’r ffrwd ATOM yn newid, gall fod angen diweddariad.
• Wedi’i brofi ar gyfer Odoo 19. Wedi’i ddatblygu a’i brofi ar gyfer Odoo 19.0 Community. Nid ydym wedi’i brofi ar gyfer fersiynau eraill. Nid cyngor cyfreithiol yw’r erthygl hon.

Cwestiynau cyffredin

A oes tâl am fynediad i’r gofrestr?

Hyd y gwyddom, nac oes: mae’r FBW-WebServices ar gyfer ailddefnyddio gwybodaeth yn rhad ac am ddim, ond mae angen allwedd API y gwnewch gais amdani drwy JustizOnline. Amodau cyfredol y Weinyddiaeth Gyfiawnder sy’n gymwys.

A fydd manylion cyswllt presennol yn cael eu trosysgrifo?

Na fyddant. Dim ond meysydd gwag y mae’r modiwl yn eu llenwi. Caiff gwerthoedd gwahanol eu cynnig fel awgrym i aelod o staff ei gymeradwyo ar gyfer pob maes.

A fydd fy nghwsmeriaid yn gwybod am y gwiriad?

Na fyddant. Mae pob hysbysiad yn mynd i’r sianel fewnol, i Chatter y cyswllt ac at staff fel gweithgaredd. Nid yw’r modiwl yn anfon e-byst at gwsmeriaid.

A gaiff manylion rheolwyr gyfarwyddwyr neu gyfranddalwyr eu storio?

Caiff enwau’r rheolwyr gyfarwyddwyr sydd ag awdurdod i gynrychioli’r cwmni eu storio (y maes Rheolwyr gyfarwyddwyr yn y tab Cofrestr cwmnïau), ond ni chaiff manylion cyfranddalwyr na chyfeiriadau unigolion eu storio. Dylech drin yr enwau fel data personol.

Faint o’n cwsmeriaid y bydd y modiwl yn dod o hyd iddynt?

Mae hynny’n dibynnu ar y gronfa gwsmeriaid. Yn ein hachos ni, 138 o 438 o gysylltiadau cwmni oedd y ffigur (tua thraean). Unigolion preifat, unig fasnachwyr, cwmnïau tramor a chysylltiadau nad yw eu henwau’n cyfateb i enw cofrestredig y cwmni yw’r gweddill. Mae’r ffigurau yn yr adran Profi ar ein cronfa gwsmeriaid ein hunain.

A allaf ddod o hyd i gwsmer heb rif cofrestru cwmni?

Gallwch. Mae botwm Chwiliad cofrestr cwmnïau yn y tab Cofrestr cwmnïau sy’n chwilio yn ôl enw. Dim ond pan fo un cwmni’n union yn cyfateb y mae’r modiwl yn llenwi’r manylion yn awtomatig. Fel arall, byddwch yn dewis y canlyniad eich hun.

Beth am gwmnïau yn yr Almaen neu’r Swistir?

Ni wneir ymholiadau amdanynt. Dim ond cysylltiadau â’r wlad wedi’i gosod yn Awstria neu heb wlad wedi’i nodi y mae’r modiwl yn eu hystyried.

Faint o le storio sydd ei angen ar y gwiriad cyfeiriadau?

Gyda rhifau tai, tua 400 MB yn y gronfa ddata a thua 120 MB o le dros dro ar y ddisg wrth fewnforio. Heb wirio rhifau tai, mae tua 150,000 o resi’n ddigon.

Beth os mai dim ond y gofrestr cwmnïau sydd arnaf ei heisiau, heb wirio cyfeiriadau?

Diffoddwch Gwirio cyfeiriadau Awstria yn y gosodiadau ac analluogwch y weithred a drefnwyd ar gyfer y gofrestr cyfeiriadau. Yna ni chaiff dim ei lawrlwytho.

O dan ba drwydded mae’r modiwl?

O dan LGPL-3. Cewch ei ddefnyddio, ei addasu a’i ddosbarthu. Mae croeso i chi roi gwybod am wallau a chynnig gwelliannau fel mater yn y storfa GitHub .

Cymorth gan Biricon IT Services

Rydym yn gofalu am osodiadau Odoo ar gyfer busnesau bach a chanolig: o’r cyflwyno cychwynnol, drwy addasiadau a mudo, i’r gwaith rhedeg o ddydd i ddydd. Os ydych am gadw prif ddata cwsmeriaid yn Odoo yn gywir, adnabod risgiau credyd yn gynharach neu asesu modiwl fel hwn a’i gyflwyno’n ddiogel i’ch system gynhyrchu, byddwn yn falch o’ch helpu. Fe welwch ragor o’n datblygiadau mewnol ar ein blog, er enghraifft Setiau cynhyrchion fel adran mewn dyfynbris a Web RBL, y rhestr rwystro ar gyfer traffig ymosodol.

Cysylltwch nawr

Yn gyfredol ar: 3 Tachwedd 2026. Fersiwn y modiwl 19.0.1.1.1. Mae’r data enghreifftiol yn y lluniau wedi’u dyfeisio ac nid ydynt yn cynrychioli cwmnïau go iawn.