Odoo 19 Community: სავაჭრო რეესტრი და მისამართის შემოწმება ავსტრიელი მომხმარებლებისთვის – ჩვენი Open Source მოდული partner_firmenbuch_at

ვინც ავსტრიაში აწარმოებს ბიზნესს, იცნობს ამ კითხვებს: სწორია თუ არა ჩემი ახალი მომხმარებლის ფირმის სახელწოდება და მისამართი? ჯერ კიდევ არის თუ არა კომპანია სავაჭრო რეესტრში, თუ ლიკვიდაციის პროცესშია? გახსნილია თუ არა გაკოტრების საქმე იმ მომხმარებელზე, რომელსაც ორი წელია ვამარაგებ? პასუხები იუსტიციის სამინისტროს სავაჭრო რეესტრშია (Firmenbuch), მაგრამ ამას თითქმის არავინ ამოწმებს რეგულარულად. Odoo-ში კონტაქტი ერთხელ იქმნება და მერე ძველდება.

ამისთვის შევქმენით მოდული სავაჭრო რეესტრი პარტნიორებისთვის (partner_firmenbuch_at). ის აკავშირებს Odoo-ს კონტაქტებს სავაჭრო რეესტრთან და BEV-ის ოფიციალურ მისამართების რეესტრთან. ის დაწერილია Odoo 19-ისთვის და უფასოდ ხელმისაწვდომია GitHub-ზე, როგორც თავისუფალი პროგრამული უზრუნველყოფა LGPL-3 ლიცენზიით:

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

პრობლემა: ძირითადი მონაცემები, რომლებსაც არავინ ამოწმებს

Odoo-ში კონტაქტი უმეტესად დროის სიმცირეში იქმნება: სახელი, მიახლოებითი მისამართი, შესაძლოა UID. ეს პირველი შეთავაზებისთვის საკმარისია. ის არ ჰყოფნის ინვოისებს, რომლებიც იურიდიულად სუფთად უნდა იყოს გაგზავნილი, და მით უმეტეს არ ჰყოფნის იმის შესამჩნევად, რომ მომხმარებელთან რაღაც შეიცვალა. პრაქტიკაში ოთხი ხარვეზი ჩნდება:

• არასრული ძირითადი მონაცემები. სავაჭრო რეესტრის ნომერი, სასამართლო და სამართლებრივი ფორმა თითქმის ყოველთვის აკლია, რადგან მათი მოძიება ხელით სამუშაოა.
• არასწორი დაწერილობა. ფირმის სახელწოდება სამართლებრივი ფორმის გარეშე, შეცდომები ქუჩაში ან ქალაქში, შეცვლილი საფოსტო ინდექსი. ამას მხოლოდ მაშინ ამჩნევენ, როცა წერილი უკან ბრუნდება.
• დაკვირვების არარსებობა. თუ სასამართლო გაკოტრების საქმეს ხსნის ან მომხმარებელი თავის საზოგადოებას ლიკვიდაციას უკეთებს, Odoo-ს ამის შესახებ არაფერი ეცოდინება. გაყიდვების განყოფილება ისევ ინვოისით აგრძელებს მიწოდებას.
• გაფანტული წყაროები. სავაჭრო რეესტრი, წლიური ფინანსური ანგარიშგებები და მისამართების რეესტრი სხვადასხვა ადგილას არის. ვისაც მათი შემოწმება უნდა, ბრაუზერის ფანჯრებს შორის მონაცემებს ხელით აკოპირებს.

რას აკეთებს მოდული

1. ახალი ფირმები იძებნება. თუ ვინმე კონტაქტს ფირმად ქმნის (ქვეყანა ავსტრია ან ცარიელი), მოდული რამდენიმე წუთში ეძებს მას სავაჭრო რეესტრში. თუ ზუსტად ერთი დამთხვევაა, ცარიელი ველები ივსება: ქუჩა, საფოსტო ინდექსი, ქალაქი, ქვეყანა, სავაჭრო რეესტრის ნომერი, სასამართლო და სამართლებრივი ფორმა.
2. გადახრები შემოთავაზებულია და არასდროს გადაიწერება. თუ კონტაქტში რეესტრისგან განსხვავებული რამაა, იქმნება ცვლილების შეთავაზება, რომელსაც თანამშრომელი თითოეული ველისთვის ცალ-ცალკე ადასტურებს.
3. სავაჭრო რეესტრში ძებნა კონტაქტიდან. ჩანართში სავაჭრო რეესტრი ძებნა ფირმებს სახელით პოულობს, მაშინაც, თუ ავტომატური დამთხვევა ცალსახა არ იყო.
4. ყოველდღიური მონიტორინგი. მოდული ყოველდღე ამოწმებს, რომელი ფირმები და დოკუმენტები შეიცვალა რეესტრში, და ამოწმებს შესაბამის მომხმარებლებს. გარდა ამისა, რეგულირებადი ინტერვალებით თითოეული ფირმა სრულად თავიდან მოწმდება.
5. გაფრთხილების დონეები. გახსნილი გაკოტრებისა და რეორგანიზაციის საქმეები (რეესტრის სამართლებრივი ფაქტებიდან), ლიკვიდაცია, წაშლა, უარყოფითი საკუთარი კაპიტალი და საკუთარი კაპიტალის დაბალი წილი ამოიცნობა და კონტაქტზე ხილული ხდება.
6. მისამართის შემოწმება. ავსტრიული მისამართები ლოკალურად მოწმდება ფედერალური ზომებისა და გეოდეზიის სამსახურის (BEV) ოფიციალური მისამართების რეესტრის წინააღმდეგ.
7. რეესტრის მონაცემები კონტაქტზე. სასამართლო, სამართლებრივი ფორმა, დირექტორები და სამართლებრივი ფაქტები ჩანართშია სავაჭრო რეესტრი. ისინი რეესტრს ასახავს და პირდაპირ ახლდება.
8. შეტყობინებები მხოლოდ შიგნით. ყველა შეტყობინება შიდა Discuss-არხში სავაჭრო რეესტრი და კონტაქტის Chatter-ში მიდის. მრავალი ფირმის შემოწმების გაშვება ქმნის ერთ შემაჯამებელ შეტყობინებას თითო ფირმაზე ერთის ნაცვლად. მომხმარებლებს მოდული არასდროს არაფერს უგზავნის.

შეთავაზებები გადაწერის ნაცვლად

ოფიციალური მონაცემები ავტომატურად არ არის თქვენი ბიზნესისთვის უკეთესი მონაცემები: შესაძლოა კონტაქტში განზრახ მიწოდების მისამართი წერია, შესაძლოა მოკლე სახელი იყოს დანერგილი. ამიტომ მოდული არსებულ მნიშვნელობებს თავისით არასდროს ცვლის. ის მხოლოდ ცარიელ ველებს ავსებს და გადახრების შემთხვევაში ქმნის შეთავაზებას.

კონტაქტები → სავაჭრო რეესტრი → სავაჭრო რეესტრის შეთავაზებები განყოფილებაში თითოეული ველისთვის ხედავთ მიმდინარე მნიშვნელობასა და რეესტრის მნიშვნელობას. ველები, რომელთა მიღებაც არ გსურთ, არჩევის გარეშე დატოვეთ. არჩეულის მიღებით იწერება მხოლოდ მონიშნული ველები, უარყოფით შეთავაზება უქმდება. ახალი შეთავაზება ანაცვლებს იმავე კონტაქტის ძველ ღია შეთავაზებებს, რათა მოძველებული მნიშვნელობები არ გამოიყენებოდეს.

გაფრთხილებები: გაკოტრება, ლიკვიდაცია, ბალანსი

მოდული განასხვავებს სამ დონეს:

• უპრობლემო: სათქმელი არაფერია.
• გაფრთხილება (ყვითელი): რეესტრში არის მოქმედი ჩანაწერები ლიკვიდაციის, დაშლის, ლიკვიდაციური წარმოების, წაშლის ან შერწყმის შესახებ, ფირმა მონიშნულია როგორც წაშლილი, ან ადრინდელი გაკოტრების საქმე ბოლო წლებში გაუქმდა (ნაგულისხმევად სამი წელი, რეგულირებადია). ან წლიური ფინანსური ანგარიშგება აჩვენებს უარყოფით საკუთარ კაპიტალს, საკუთარი კაპიტალის წილს 8 %-ზე დაბლა (ნაგულისხმევი მნიშვნელობა § 23 URG-ის შესაბამისად, რეგულირებადია), წლიურ ზარალს ან ბრუნვის 25 % და მეტით შემცირებას.
• კრიტიკული (წითელი): გაკოტრების, კონკურსის (Konkurs) ან რეორგანიზაციის წარმოება გახსნილია და ჯერ არ გაუქმებულა, ან განაცხადი უარყოფილ იქნა ხარჯების დამფარავი ქონების არარსებობის გამო. ეს უკანასკნელი გადახდისუუნარობად ითვლება.

კონტაქტზე ჩნდება ფერადი ბანერი, კონტაქტების სიაში — შენიშვნა, ძიებაში კი არის ფილტრები სავაჭრო რეესტრის გაფრთხილებისთვის და სავაჭრო რეესტრი კრიტიკული. თუ მომხმარებელი კრიტიკული ხდება, პასუხისმგებელი გამყიდველი (ამის არარსებობისას ადმინისტრატორი) იღებს აქტივობას სავაჭრო რეესტრი: შეამოწმეთ მომხმარებლები, არხი სავაჭრო რეესტრი კი შეტყობინებას იღებს.

სამართლებრივი ფაქტები. გაკოტრების საქმეები რეესტრში ფირმის ტექსტში კი არ წერია, არამედ სამართლებრივი ფაქტების სახით თარიღით, საქმის ნომრითა და სასამართლოთი. მოდული მათ კითხულობს, გახსნასა და გაუქმებას ერთსა და იმავე საქმის ნომერს მიაკუთვნებს და კონტაქტზე სიის სახით აჩვენებს. ასე გაუქმებული საქმე რამდენიმე წლის შემდეგ მხოლოდ ინფორმაციად რჩება, მიმდინარე კი წითელია.

წლიური ფინანსური ანგარიშგებები. თუ ბოლო წლიური ფინანსური ანგარიშგება XML-ის სახითაა, მოდული კითხულობს საკუთარ კაპიტალს, წლიურ შედეგს, ბალანსის ჯამსა და ბრუნვას და ითვლის საკუთარი კაპიტალის წილს, ბრუნვის ცვლილებასა და ზომის კლასს § 221 UGB-ის მიხედვით (მიკროსაზოგადოებების ჩათვლით). მცირე საზოგადოებებს ბრუნვის გამოქვეყნება არ ევალებათ, ამ შემთხვევაში მოდული ბრუნვას არ აჩვენებს. მათ შედეგს ის გამოჰყავს საბალანსო მოგებიდან მოგების გადატანის გამოკლებით და აღნიშნავს როგორც შეფასებას. პოზიციების დასახელებები, რომელთა მიხედვითაც ძებნა ხდება, რეგულირებადია, რადგან XML ფორმულარის მიხედვით სხვადასხვანაირადაა აგებული.

მისამართის შემოწმება BEV-ის მისამართების რეესტრით

BEV მისამართების რეესტრს ღია მონაცემების სახით გვთავაზობს (Adresse Relationale Tabellen – Stichtagsdaten, წელიწადში ორჯერ ახალი საანგარიშო თარიღი, უფასოდ გამოსაყენებელი წყაროს მითითებით). მოდული გადმოწერს ამონაწერს ოფიციალური INSPIRE-ATOM სერვისით, დაახლოებით 120 MB დაახლოებით 2,5 მილიონი მისამართით, და შემოაქვს მას საკუთარ, მსუბუქ ცხრილებში.

ამის შემდეგ ყოველი ავსტრიული ფირმის მისამართი ქუჩით შექმნისას და ყოველი ცვლილებისას ლოკალურად მოწმდება: საფოსტო ინდექსი, ქუჩა, სახლის ნომერი, ქალაქი და ფედერალური მიწა. არც ერთი მისამართი სერვისს არ ეგზავნება. შედეგი მისამართის ქვემოთ ნიშნის სახით წერია:

• მართებული: მისამართი რეესტრში ზუსტად ასე არსებობს.
• სახლის ნომერი უცნობია: ქუჩა და ქალაქი ემთხვევა, სახლის ნომერი — არა.
• შემოთავაზებულია შესწორება: შეცდომა ქუჩის ან ქალაქის დაწერილობაში, არასწორი საფოსტო ინდექსი. შესწორება მზადაა შეთავაზების სახით.
• ვერ მოიძებნა: რეესტრმა ეს მისამართი არ იცის.

ცარიელი ფედერალური მიწა პირდაპირ ივსება. კონტაქტების კერძო მისამართები (ტიპი კერძო მისამართი) არ მოწმდება. წყაროს მითითება © Österreichisches Adressregister, Stichtagsdaten vom … მიმდინარე საანგარიშო თარიღით პარამეტრებშია. განახლება ყოველკვირეულად ხორციელდება, მაგრამ გადმოწერს მხოლოდ მაშინ, როცა BEV-მა უფრო ახალი საანგარიშო თარიღი გამოაქვეყნა.

ტექნიკური რეალიზაცია

რეესტრზე წვდომა

იუსტიციის სამინისტრო სავაჭრო რეესტრს გვთავაზობს FBW-WebServices-ით (HVD) JustizOnline-ზე SOAP ინტერფეისის სახით. წვდომა უფასოა, მაგრამ საჭიროებს API გასაღებს, რომელსაც ითხოვენ ID Austria-თი განყოფილებაში Informationsweiterverwendung. გასაღები HTTP სათაურში X-API-KEY მიდის. მოდული სერვისს პირდაპირ იყენებს, Screen-Scraping-ის გარეშე.

კლიენტი models/firmenbuch_client.py არის წმინდა Python Odoo-ზე დამოკიდებულების გარეშე. ის იცნობს მოთხოვნებს SUCHEFIRMAREQUEST, AUSZUG_V2_REQUEST, SUCHEURKUNDEREQUEST, URKUNDEREQUEST, ასევე VERAENDERUNGENFIRMAREQUEST და VERAENDERUNGENURKUNDEREQUEST. ამიტომ მისი ტესტირება შენახული პასუხებით შეიძლება. მოთხოვნები იგზავნება 0,3 წამის ინტერვალით, ცვლილებების მოთხოვნები — შვიდდღიანი ბლოკებით.

ამონაწერის დამუშავება

ამონაწერიდან გამოიყენება მხოლოდ ჩანაწერები, რომლებიც ჯერ კიდევ მოქმედია (ატრიბუტი AUFRECHT არ არის false). სახელი მოდის მონაცემთა ნიშნიდან FI_DKZ02, მისამართი — FI_DKZ03-დან, ადგილსამყოფელი — FI_DKZ06-დან და სამართლებრივი ფორმა — FI_DKZ07-დან. ამას ემატება სასამართლო, ვებმისამართი, წარმომადგენლობის უფლებამოსილი პირები და სამართლებრივი ფაქტები. გაფრთხილების დონისთვის ყველა მოქმედი ჩანაწერის ტექსტები ირჩევა რეგულირებადი საკვანძო სიტყვებით:

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

საკვანძო სიტყვებით შემოწმების უპირატესობა: ის მუშაობს იმისგან დამოუკიდებლად, რომელ ველში აფიქსირებს რეესტრი მოვლენას. ნაკლი აღწერილია განყოფილებაში შეზღუდვები.

მონიტორინგი

მოდული ქმნის სამ დაგეგმილ მოქმედებას:

• ახალი ფირმების მოძიება (ყოველ 10 წუთში, გაშვებაზე 20 კონტაქტამდე). გარდა ამისა, ის დაუყოვნებლივ ეშვება შექმნისას.
• ფირმების მონიტორინგი (ყოველდღე 04:30). ამოწმებს ბოლო გაშვების შემდეგ შეცვლილ ფირმებსა და დოკუმენტებს (მაქსიმუმ 30 დღით უკან), ამოწმებს შესაბამის მომხმარებლებს და მის შემდეგ 50-მდე მომხმარებელს, რომელთა ბოლო შემოწმებიდან დაწესებულ ვადაზე მეტი გავიდა. თითოეული ფირმა ცალკე ტრანზაქციაში ინახება, რათა შეცდომამ ადრინდელი შედეგები არ დაკარგოს. გაშვების შედეგი არხში ერთი შემაჯამებელი შეტყობინების სახით მიდის.
• მისამართების რეესტრის განახლება (ყოველკვირეულად 03:15).

API გასაღების გარეშე პირველი ორი დაუყოვნებლივ ბრუნდება. თითოეული ფირმის საკონტროლო ჯამი ხელს უშლის უცვლელი ამონაწერების განმეორებით დამუშავებას.

მისამართების რეესტრი

BEV-ის მონაცემები სამ ცხრილშია (bev.locality, bev.street, bev.address) ინდექსით საფოსტო ინდექსზე, ქუჩის კოდსა და სახლის ნომერზე. იმპორტი COPY-ით ერთ ტრანზაქციაში მიმდინარეობს, ანუ ცხრილები ერთ ნაბიჯში იცვლება. სახლის ნომრები ნორმალიზდება რეესტრის დაწერილობით (51-55, 12a). სახლის ნომრებით ცხრილები მონაცემთა ბაზაში დაახლოებით 400 MB-ს იკავებს. ვისაც ეს არ სურს, თიშავს სახლის ნომრების შემოწმებას და 150 000-მდე სტრიქონით კმაყოფილდება.

რა გვასწავლა რეალურმა სერვისმა

მოდული, რომელიც მხოლოდ საკუთარი ხელით დაწერილი სატესტო პასუხებით არის შემოწმებული, ჯერ დასრულებულად არ ითვლება. ამიტომ კლიენტი გამოქვეყნებამდე შევამოწმეთ რეალურ სერვისთან, ჩვენი საკუთარი ფირმის გასაღებით. ამასთან შევამჩნიეთ ჩვენი ვარაუდებიდან რამდენიმე გადახრა, რომლებიც გავასწორეთ:

• მხოლოდ მოკლე ინფორმაცია. ამონაწერის მიღება ამ გასაღებით მხოლოდ მოკლე ინფორმაციის მოცულობით შეიძლება. მოთხოვნებს სრული ინფორმაციით სერვისი უარყოფს. ვერსია 1.0.0-ში ყოველდღიური გაშვება ამას ჯერ კიდევ არასწორად ითხოვდა, ვერსია 1.1.0 ამას ასწორებს. პირებიდან მოდული იღებს მხოლოდ წარმომადგენლობის უფლებამოსილი დირექტორების სახელებს; პარტნიორები და პირების მისამართები არ იკითხება.
• ქუჩა და სახლის ნომერი ცალ-ცალკე. მისამართი მოდის როგორც STRASSE და HAUSNUMMER ცალკეულ ელემენტებში და არა როგორც ერთი ტექსტი. მოდული ორივეს აერთიანებს.
• სასამართლო აღსრულების ბლოკში. კომპეტენტური სასამართლო ფირმის ნაწილში კი არ წერია, არამედ ამონაწერის ბოლო VOLLZ-ბლოკში.
• წაშლილი ფირმები. წაშლილ ფირმას ატრიბუტით ცნობენ (MIT_FIRMA_GELOESCHT_DURCH_VNR) და არა ტექსტით. მოდული აქედან აკეთებს დასკვნას ფირმა წაშლილია, რომელიც გაფრთხილებას იწვევს.
• ფირმის სახელი ძებნის სიტყვა არ არის. ძებნა ადარებს სახელის დასაწყისს. „Muster GmbH“ ვერაფერს პოულობს, თუ რეესტრში წერია „Muster Gesellschaft m.b.H.“; ლიკვიდაციაში მყოფ ფირმებს სახელში აქვთ „in Liqu.“, ხოლო კონტაქტის სახელში ზოგჯერ ისევ & წერია. ამიტომ მოდული ძებნას სამართლებრივი ფორმის გარეშე იმეორებს და ადარებს სახელებს სამართლებრივი ფორმის დაწერილობის ვარიანტების, HTML-სიმბოლოებისა და დანართ „in Liqu.“-ს გარეშე. ერთადერთი დამთხვევა მიიღება მხოლოდ იმ შემთხვევაში, თუ მისი სახელი კონტაქტის სახელით იწყება.
• დოკუმენტის ცვლილებები სავაჭრო რეესტრის ნომრის გარეშე. შეცვლილი დოკუმენტების სია მხოლოდ გასაღებს შეიცავს. სავაჭრო რეესტრის ნომერი (საკონტროლო ასოს გარეშე) ამ გასაღების დასაწყისშია. მოდული ცვლილებებს მის მიხედვით მომხმარებლებს მიაკუთვნებს.

ამ პუნქტებიდან თითოეულისთვის ახლა არსებობს ავტომატიზებული ტესტი ხელახლა აგებული პასუხით.

ტესტი საკუთარ მომხმარებელთა ბაზაზე

ვერსია 1.1.0-ის შემდეგ მოდული საკუთარ მომხმარებელთა ბაზაზე გავსინჯეთ. ჯერ მხოლოდ წაკითხვადი სახელით ძებნა გაეშვა, შემდეგ — ცალსახა დამთხვევების მიკუთვნება. ამასთან არსებული მნიშვნელობების გათვალისწინების გარეშე არაფერი შეცვლილა: ცარიელი ველები შეივსო, გადახრები დასადასტურებლად შეთავაზებების სახით ელოდება და არც ერთი ელფოსტა არ გასულა. შედეგი, ცალკეული ფირმების დასახელების გარეშე:

• 438 კორპორატიული კონტაქტი მომხმარებლის სტატუსით ავსტრიაში ან ქვეყნის გარეშე მოიძებნა.
• 138 მათგან ცალსახად მიეკუთვნა სავაჭრო რეესტრს. კიდევ 18-ს ჰქონდა ცალსახა დამთხვევა სახელით, მაგრამ რეესტრში სხვა მისამართი (გადასვლა ან ერთსახელიანი ფირმა), ამიტომ ისინი ხელშეუხებელი დარჩა. 2 სახელი ორაზროვანია.
• დაახლოებით 280 ვერ ვიპოვეთ ან მხოლოდ ნაწილობრივი დამთხვევით ვიპოვეთ. ესენი არიან ფიზიკური პირები, ინდივიდუალური მეწარმეები, უცხოური ფირმები, კონტაქტები, რომლებიც მხოლოდ ბრენდს ან ადგილს ასახელებენ, და ფირმები, რომელთა სახელი კონტაქტში რეგისტრაციისგან განსხვავდება, მაგალითად იმიტომ, რომ იქ სხვა სამართლებრივი ფორმაა მითითებული. მათთვის ხელით სავაჭრო რეესტრში ძებნა რჩება.
• 63 ცვლილების შეთავაზება შეიქმნა, ძირითადად ქუჩისა და სახლის ნომრისთვის (დაწერილობა) და ქვეყნისთვის.
• 66 გაფრთხილება, კრიტიკული დონე არ არის. 36 ფირმა რეესტრში მონიშნულია როგორც წაშლილი (მათგან 9 ასევე ლიკვიდაციაში), 2-ს ჰქონდა გაკოტრების საქმე, რომელიც უკვე გაუქმებულია, და 42-ში წლიურმა ფინანსურმა ანგარიშგებამ მიიპყრო ყურადღება: საკუთარი კაპიტალის დაბალი წილი, ზარალი ან ბრუნვის შემცირება. წაშლილი ფირმა ავტომატურად დაკარგული მომხმარებელი არ არის, მაგრამ მიზეზია, რომ მისამართი და ინვოისის მიმღები შემოწმდეს.

ორი გაკვეთილი აქედან: რეალური საქმიანობიდან მომხმარებელთა ბაზა გაცილებით უკეთესი ტესტია, ვიდრე ნებისმიერი ხელახლა აგებული პასუხი. ამასთან ჩვენ სახელით ძებნაში შეცდომები ვიპოვეთ, რომლებიც ვერსია 1.1.1-ში გასწორდა (იხ. ზემოთ). და დამთხვევის მაჩვენებელი დიდად არის დამოკიდებული იმაზე, რამდენად ზედმიწევნით არის კონტაქტები დასახელებული: ვინც ფირმის სახელწოდებას ისე წერს, როგორც რეესტრშია, საიმედოდ მოიძებნება.

ინსტალაცია და გამართვა

წინაპირობები: Odoo 19.0 სტანდარტული აპლიკაციებით კონტაქტები და Discuss, Python-პაკეტი requests (არსებობს ყველა Odoo ინსტალაციაში) და გამავალი HTTPS წვდომა justizonline.gv.at-სა და data.bev.gv.at-ზე. მოდულს არ აქვს დამოკიდებულებები სტანდარტული აპლიკაციების გარეთ, ანუ ის სხვა მოდულებს არ ითრევს.

1. მოათავსეთ საქაღალდე partner_firmenbuch_at addons_path-ში, განაახლეთ აპლიკაციების სია და დააინსტალირეთ მოდული, სამუშაო სისტემებზე უმჯობესია ჯერ ტესტურ მონაცემთა ბაზაზე.
2. მოდული ქმნის Discuss-არხს სავაჭრო რეესტრი (შიდა მომხმარებლებისთვის) და ყველა ადმინისტრატორს აფიქსირებს. გარდა ამისა, იქმნება სამი დაგეგმილი მოქმედება.
3. API გასაღების მოთხოვნა: JustizOnline (ID Austria), Informationsweiterverwendung, API FBW.
4. პარამეტრები → სავაჭრო რეესტრი: შეიყვანეთ გასაღები და შეამოწმეთ კავშირი. ამის შემდეგ აირჩიეთ არხი, პარამეტრები, საკვანძო სიტყვები და პოზიციების კოდები.

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

მნიშვნელოვანია სამუშაო სისტემებზე: მისამართების რეესტრის განახლების პირველი გაშვება ავტომატურად იწყება ინსტალაციის შემდგომ ღამეს 03:15-ზე და ჩამოტვირთავს დაახლოებით 120 MB-ს. ამის შემდეგ მოწმდება ყველა ავსტრიული კონტაქტი; ანომალიები ჩნდება შეთავაზებების სახით და როგორც ერთი შეტყობინება არხში. ვისაც ეს არ სურს, წინასწარ გამორთოს დაგეგმილი მოქმედება მისამართების რეესტრი (BEV): განახლება ან პარამეტრებში გამორთოს ავსტრიული მისამართების შემოწმება.

მასობრივი იმპორტი: იმპორტი გააკეთეთ კონტექსტის გასაღებებით fb_no_lookup=True და bev_no_check=True. წინააღმდეგ შემთხვევაში ყოველი იმპორტირებული ავსტრიული ფირმა რეესტრში მოთხოვნისთვის ჩაიწერებოდა (ათ წუთში 20) და ყოველი მისამართი შექმნისას შემოწმდებოდა.

მონაცემთა დაცვა: რას უგზავნის მოდული და ვის

• პერსონალური მონაცემები: დირექტორების სახელები პერსონალური მონაცემებია, თუნდაც რეესტრში საჯაროდ იყოს მითითებული. მოდული მათ ინახავს მხოლოდ სასაქონლო ურთიერთობის მოსავლელად. ვისაც ეს არ სურს, შლის ველს ან არ იყენებს მას.
• სავაჭრო რეესტრი: API გასაღებთან ერთად მხოლოდ იმ კონტაქტების სახელი ან სავაჭრო რეესტრის ნომერი, რომლებიც მონიშნულია როგორც ფირმა (მშობელი ფირმის გარეშე, ქვეყანა ავსტრია ან ცარიელი), იგზავნება justizonline.gv.at-ზე. ფიზიკური პირები და ფირმის საკონტაქტო პირები არასდროს იგზავნება.
• მისამართების რეესტრი: გადმოიწერება მხოლოდ საჯარო ამონაწერი. მომხმარებლის მისამართები სისტემას არ ტოვებს.
• მომხმარებლებისთვის წერილები არ იგზავნება: შეტყობინებები შიდა არხში, Chatter-ში და თანამშრომლებისთვის აქტივობის სახით მიდის.
• გასაღები: API გასაღები ჩანს მხოლოდ ადმინისტრატორებისთვის.

სავაჭრო რეესტრი საჯარო რეესტრია. მონაცემების ხელახალი გამოყენება JustizOnline-ის Informationsweiterverwendung-ის პირობებს ექვემდებარება.

ტესტები

მოდულს თან მოჰყვება 18 ავტომატიზებული ტესტი. ისინი მუშაობენ ხელახლა აგებული რეესტრის პასუხებითა და მისამართების მინიატურული ამონაწერით და ამიტომ არც API გასაღებს საჭიროებენ და არც ქსელს:

• სავაჭრო რეესტრის ნომრის ნორმალიზება
• ამონაწერის დამუშავება (სახელი, მისამართი, სასამართლო, დირექტორები, წაშლილი ფირმა, არამართებული ჩანაწერები იგნორირდება)
• სახელების შედარება: სამართლებრივი ფორმის დაწერილობის ვარიანტები, „in Liqu.“, HTML-სიმბოლოები, უცხო ფირმის შემთხვევაში დამთხვევის არარსებობა
• წლიური ფინანსური ანგარიშგება: საკუთარი კაპიტალი, შედეგი, ბალანსის ჯამი
• ახალი ფირმა მოიძებნება, ცარიელი ველები ივსება, გადახრები შეთავაზდება, შეთავაზება ნაწილობრივ გამოიყენება
• მონიტორინგი: გახსნილი გაკოტრების საქმე დონეს ადგენს კრიტიკულზე და ქმნის აქტივობას, გაუქმებული საქმე იძლევა გაფრთხილებას, საკონტაქტო პირები ცალკე არ მოწმდება
• დოკუმენტის ცვლილებები გასაღების მიხედვით მიეკუთვნება
• API გასაღების გარეშე არაფერი მოითხოვება
• მისამართის შემოწმება მინიატურული ამონაწერის წინააღმდეგ

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

გერმანული თარგმანი მდებარეობს i18n/de.po-ში.

შეზღუდვები და იურიდიული შენიშვნა

• დამთხვევა მითითებაა და არა იურიდიული ცნობა. სტატუსი გამოიყვანება საკვანძო სიტყვებიდან რეესტრის მოქმედ ჩანაწერებში. სანამ კრედიტზე ან მიწოდების პირობებზე გადაწყვეტილებას მიიღებთ, თვითონ შეამოწმეთ რეესტრი.
• გაკოტრების ამოცნობა გამოცდილია მხოლოდ ხელახლა აგებულ შემთხვევებზე. მოდული წარმოებებს ცნობს სამართლებრივი ფაქტების თავისუფალი ტექსტის სიტყვებით (გახსნა, გაუქმება, დადასტურებული რეორგანიზაციის გეგმა, ქონების არარსებობის გამო). მათი ფორმატი ჩვენ რეალური რეესტრის ამონაწერიდან ხელახლა ავაგეთ, მაგრამ შემუშავებისას რეალური გაკოტრების შემთხვევა ხელთ არ გვქონდა. ამიტომ უჩვეულო ფორმულირება შეიძლება გამოგვრჩეს. ოფიციალურ Ediktsdatei-ს მოდული არ ცვლის.
• წლიური ფინანსური ანგარიშგებები მხოლოდ XML-ის სახით. წმინდა PDF-ის წარდგენები გამოიტოვება. ძალიან მცირე საზოგადოებებში ბალანსი შეიძლება შემოკლებულად იყოს წარდგენილი, იმ ციფრების გარეშე, რომლებსაც მოდული კითხულობს.
• მხოლოდ ავსტრია. უცხოური ფირმები არ მოწმდება. ფირმების ვებსაიტები რეესტრში არ წერია და არ ემატება.
• ავტომატური მიკუთვნება მხოლოდ ცალსახა დამთხვევისას. თუ ერთი და იმავე სახელის მქონე რამდენიმე ფირმა არსებობს, არხში შეტყობინება ხელით სავაჭრო რეესტრში ძებნას ითხოვს.
• ინტერფეისები შეიძლება შეიცვალოს. მოდული BMJ-ისა და BEV-ის სერვისებზეა დამოკიდებული. თუ endpoint, სქემა ან ATOM-feed შეიცვალა, შესაძლოა განახლება გახდეს საჭირო.
• გატესტილია Odoo 19-ისთვის. შემუშავებული და გატესტილია Odoo 19.0 Community-ისთვის. სხვა ვერსიებისთვის ჩვენ ის არ გამოგვიცდია. ეს სტატია იურიდიული კონსულტაცია არ არის.

ხშირი კითხვები

ღირს თუ არა რეესტრზე წვდომა რამე?

ჩვენი ინფორმაციით — არა: FBW-WebServices Informationsweiterverwendung-ისთვის უფასოა, მაგრამ საჭიროებს API გასაღებს, რომელსაც JustizOnline-ით ითხოვთ. გადამწყვეტია იუსტიციის სამინისტროს მოქმედი პირობები.

გადაიწერება თუ არა არსებული კონტაქტის მონაცემები?

არა. მოდული წერს მხოლოდ ცარიელ ველებში. განსხვავებული მნიშვნელობები იქმნება როგორც შეთავაზება, რომელსაც თანამშრომელი თითოეული ველისთვის ადასტურებს.

იგებენ თუ არა ჩემი მომხმარებლები შემოწმების შესახებ რამეს?

არა. ყველა შეტყობინება მიდის შიდა არხში, კონტაქტის Chatter-ში და თანამშრომლებისთვის აქტივობის სახით. მოდული მომხმარებლებს ელფოსტას არ უგზავნის.

ინახება თუ არა დირექტორები ან პარტნიორები?

წარმომადგენლობის უფლებამოსილი დირექტორების სახელები — დიახ (ველი დირექტორი ჩანართში სავაჭრო რეესტრი), პარტნიორები და პირების მისამართები — არა. სახელები განიხილეთ როგორც პერსონალური მონაცემები.

ჩვენი მომხმარებლებიდან რამდენს პოულობს მოდული?

ეს დამოკიდებულია მომხმარებელთა ბაზაზე. ჩვენთან ეს იყო 438 კორპორატიული კონტაქტიდან 138 (დაახლოებით ერთი მესამედი). დანარჩენი არიან ფიზიკური პირები, ინდივიდუალური მეწარმეები, უცხოური ფირმები და კონტაქტები, რომელთა სახელი ფირმის სახელწოდებას არ შეესაბამება. ციფრები განყოფილებაშია ტესტი საკუთარ მომხმარებელთა ბაზაზე.

შემიძლია თუ არა მომხმარებლის პოვნა სავაჭრო რეესტრის ნომრის გარეშე?

დიახ. ჩანართს სავაჭრო რეესტრი აქვს ღილაკი სავაჭრო რეესტრში ძებნა სახელით ძიებით. მოდული ავტომატურად ჩაწერს მხოლოდ მაშინ, როცა ზუსტად ერთი ფირმა ემთხვევა. წინააღმდეგ შემთხვევაში დამთხვევას თვითონ ირჩევთ.

რა ხდება გერმანიასა და შვეიცარიაში მყოფ ფირმებთან?

ისინი არ მოწმდება. მოდული ათვალიერებს მხოლოდ კონტაქტებს, რომელთა ქვეყანაა ავსტრია ან ქვეყნის გარეშე.

რამდენ მეხსიერებას საჭიროებს მისამართის შემოწმება?

სახლის ნომრებით დაახლოებით 400 MB მონაცემთა ბაზაში და იმპორტისას დაახლოებით 120 MB დროებით დისკის სივრცე. სახლის ნომრების შემოწმების გარეშე საკმარისია დაახლოებით 150 000 სტრიქონი.

რა მოხდება, თუ მხოლოდ სავაჭრო რეესტრი მინდა და მისამართის შემოწმება არ მინდა?

პარამეტრებში გამორთეთ ავსტრიული მისამართების შემოწმება და გამორთეთ მისამართების რეესტრის დაგეგმილი მოქმედება. მაშინ არაფერი ჩამოიტვირთება.

რა ლიცენზიით ვრცელდება მოდული?

LGPL-3-ით. შეგიძლიათ გამოიყენოთ, მოარგოთ და გადასცეთ. შეცდომებს და გაუმჯობესების წინადადებებს issue-ის სახით GitHub-რეპოზიტორიაში სიამოვნებით ველოდებით.

მხარდაჭერა Biricon IT Services-ისგან

ჩვენ ვემსახურებით Odoo-ს ინსტალაციებს მცირე და საშუალო საწარმოებისთვის: დანერგვიდან მორგებებისა და მიგრაციების გავლით მუდმივ ექსპლუატაციამდე. თუ გსურთ მომხმარებლების ძირითადი მონაცემები Odoo-ში სუფთად შეინარჩუნოთ, კრედიტუნარიანობის რისკები უფრო ადრე ამოიცნოთ ან ამის მსგავსი მოდული შეამოწმოთ და უსაფრთხოდ თქვენს სამუშაო ინსტანციაში შეიყვანოთ, სიამოვნებით დაგეხმარებით. სხვა საკუთარ დამუშავებებს ჩვენს ბლოგში იპოვით, მაგალითად პროდუქტების კომპლექტები შეთავაზებაში სექციის სახით და Web RBL, შავი სია თავდასხმის ტრაფიკისთვის.

დაგვიკავშირდით ახლავე

მდგომარეობა: 2026 წლის 3 ნოემბერი. მოდულის ვერსია 19.0.1.1.1. ილუსტრაციებში მაგალითის მონაცემები თავისუფლადაა შერჩეული და რეალური ფირმები არ არის.