221110
+ ElementTree drops comments during parsing, so we extract them from the raw string.
+ """
+ comment_map = {}
+ for match in re.finditer(r'\s*([^<]+)', xml_str):
+ comment_map[match.group(2)] = match.group(1)
+ return comment_map
+
+
+def parse_si_detail(xml_str):
+ """Parse the SI (Strukturierter Registerinhalt) XJustiz XML into a dict.
+
+ The SI document is an XJustiz XML file containing structured register content:
+ company name, address, legal form, capital, directors, prokura holders, etc.
+ """
+ root = ET.fromstring(xml_str)
+ comment_map = _build_comment_map(xml_str)
+ detail = {}
+
+ # Build a role-number-to-person/org mapping from beteiligung entries
+ roles = {} # rollennummer -> {role_code, role_label, person_data}
+ for beteiligung in root.findall('.//tns:beteiligung', NS):
+ rolle_elems = beteiligung.findall('tns:rolle', NS)
+ beteiligter = beteiligung.find('tns:beteiligter', NS)
+ if beteiligter is None:
+ continue
+
+ for rolle in rolle_elems:
+ rollennummer = _text(rolle, 'tns:rollennummer')
+ role_code_elem = rolle.find('tns:rollenbezeichnung', NS)
+ role_code = _text(role_code_elem, 'code') if role_code_elem is not None else None
+ role_label = ROLE_CODES.get(role_code, comment_map.get(role_code, role_code))
+
+ person_data = _parse_beteiligter(beteiligter, comment_map)
+ if rollennummer:
+ roles[rollennummer] = {
+ 'role_code': role_code,
+ 'role_label': role_label,
+ **person_data
+ }
+
+ # Company info from the Rechtsträger (role code 287)
+ for rnum, rdata in roles.items():
+ if rdata.get('role_code') == '287':
+ detail['name'] = rdata.get('name')
+ detail['legal_form'] = rdata.get('legal_form')
+ detail['legal_form_code'] = rdata.get('legal_form_code')
+ detail['seat'] = rdata.get('seat')
+ if rdata.get('address'):
+ detail['address'] = rdata['address']
+ break
+
+ # basisdatenRegister
+ basisdaten = root.find('.//tns:basisdatenRegister', NS)
+ if basisdaten is not None:
+ # Satzungsdatum
+ satzung = basisdaten.find('.//tns:aktuellesSatzungsdatum', NS)
+ if satzung is not None and satzung.text:
+ detail['articles_of_association_date'] = satzung.text
+
+ # Gegenstand (business purpose)
+ gegenstand = basisdaten.find('.//tns:gegenstand', NS)
+ if gegenstand is not None and gegenstand.text:
+ detail['business_purpose'] = gegenstand.text.strip()
+
+ # Vertretungsregelung (representation rules)
+ allg_vertretung = basisdaten.find('.//tns:allgemeineVertretungsregelung', NS)
+ if allg_vertretung is not None:
+ vb = allg_vertretung.find('.//tns:vertretungsbefugnis', NS)
+ if vb is not None:
+ vb_code = _text(vb, 'code')
+ if vb_code and vb_code in comment_map:
+ detail['representation_rules'] = comment_map[vb_code]
+
+ # Representatives with their specific rules
+ for vb_elem in basisdaten.findall('.//tns:vertretungsberechtigte', NS):
+ ref = _text(vb_elem, 'tns:ref.rollennummer')
+ if ref and ref in roles:
+ rep = roles[ref]
+ besondere = vb_elem.find('tns:besondereVertretungsregelung', NS)
+ if besondere is not None:
+ freitext = besondere.find('.//tns:vertretungsbefugnisFreitext', NS)
+ if freitext is not None and freitext.text:
+ rep['representation'] = freitext.text.strip().rstrip(';')
+ else:
+ vb_code_elem = besondere.find('.//tns:vertretungsbefugnis', NS)
+ if vb_code_elem is not None:
+ code_val = _text(vb_code_elem, 'code')
+ if code_val and code_val in comment_map:
+ rep['representation'] = comment_map[code_val]
+
+ befreiung = besondere.find('.//tns:befreiungVon181BGB', NS)
+ if befreiung is not None:
+ rep['exempt_181_bgb'] = True
+
+ # Collect managing directors and prokura holders
+ directors = []
+ prokura = []
+ for rnum, rdata in roles.items():
+ if rdata.get('role_code') == '086': # Geschäftsführer
+ directors.append(rdata)
+ elif rdata.get('role_code') == '087': # Vorstand
+ directors.append(rdata)
+ elif rdata.get('role_code') == '285': # Prokurist
+ prokura.append(rdata)
+
+ if directors:
+ detail['directors'] = directors
+ if prokura:
+ detail['prokura'] = prokura
+
+ # Capital (Stammkapital / Grundkapital)
+ stammkapital = root.find('.//tns:stammkapital', NS)
+ if stammkapital is None:
+ stammkapital = root.find('.//tns:grundkapital', NS)
+ if stammkapital is not None:
+ zahl = _text(stammkapital, 'tns:zahl')
+ waehrung_elem = stammkapital.find('.//tns:waehrung', NS)
+ waehrung_code = _text(waehrung_elem, 'code') if waehrung_elem is not None else None
+ if zahl:
+ detail['capital'] = {
+ 'amount': zahl,
+ 'currency': waehrung_code or 'EUR'
+ }
+
+ # Register info
+ aktenzeichen = root.find('.//tns:aktenzeichen.strukturiert', NS)
+ if aktenzeichen is not None:
+ register = aktenzeichen.find('tns:register', NS)
+ nummer = _text(aktenzeichen, 'tns:laufendeNummer')
+ if register is not None and nummer:
+ reg_code = _text(register, 'code')
+ detail['register_type'] = reg_code
+ detail['register_number'] = nummer
+
+ # Auszug metadata
+ auszug = root.find('.//tns:auszug', NS)
+ if auszug is not None:
+ detail['retrieval_date'] = _text(auszug, 'tns:abrufdatum')
+ detail['last_entry_date'] = _text(auszug, 'tns:letzteEintragung')
+ detail['num_entries'] = _text(auszug, 'tns:anzahlEintragungen')
+
+ # Eintragungstexte (register entry texts)
+ entries = []
+ for et_elem in root.findall('.//tns:eintragungstext', NS):
+ entry = {}
+ entry['column'] = _text(et_elem, 'tns:spalte')
+ entry['position'] = _text(et_elem, 'tns:position')
+ entry['number'] = _text(et_elem, 'tns:laufendeNummer')
+ entry['text'] = _text(et_elem, 'tns:text')
+ art_elem = et_elem.find('tns:eintragungsart', NS)
+ if art_elem is not None:
+ art_code = _text(art_elem, 'code')
+ if art_code and art_code in comment_map:
+ entry['type'] = comment_map[art_code]
+ entries.append(entry)
+ if entries:
+ detail['register_entries'] = entries
+
+ return detail
+
+
+def _text(parent, path):
+ """Extract text from an XML element, or None."""
+ if parent is None:
+ return None
+ elem = parent.find(path, NS)
+ if elem is not None and elem.text:
+ return elem.text.strip()
+ return None
+
+
+def _parse_beteiligter(beteiligter, comment_map):
+ """Parse a beteiligter element into a person/org dict."""
+ data = {}
+
+ # Natural person
+ person = beteiligter.find('.//tns:natuerlichePerson', NS)
+ if person is not None:
+ vorname = _text(person, './/tns:vorname')
+ nachname = _text(person, './/tns:nachname')
+ if vorname and nachname:
+ data['name'] = '%s %s' % (vorname, nachname)
+ elif nachname:
+ data['name'] = nachname
+
+ geburtsdatum = _text(person, './/tns:geburtsdatum')
+ if geburtsdatum:
+ data['date_of_birth'] = geburtsdatum
+
+ anschrift = person.find('tns:anschrift', NS)
+ if anschrift is not None:
+ data['city'] = _text(anschrift, 'tns:ort')
+
+ return data
+
+ # Organisation
+ org = beteiligter.find('.//tns:organisation', NS)
+ if org is not None:
+ data['name'] = _text(org, './/tns:bezeichnung.aktuell')
+
+ rechtsform = org.find('.//tns:rechtsform', NS)
+ if rechtsform is not None:
+ rf_code = _text(rechtsform, 'code')
+ if rf_code:
+ data['legal_form'] = comment_map.get(rf_code, rf_code)
+ data['legal_form_code'] = rf_code
+
+ sitz = org.find('tns:sitz', NS)
+ if sitz is not None:
+ data['seat'] = _text(sitz, 'tns:ort')
+
+ anschrift = org.find('tns:anschrift', NS)
+ if anschrift is not None:
+ addr = {}
+ street = _text(anschrift, 'tns:strasse')
+ hausnummer = _text(anschrift, 'tns:hausnummer')
+ if street:
+ addr['street'] = street + (' ' + hausnummer if hausnummer else '')
+ plz = _text(anschrift, 'tns:postleitzahl')
+ if plz:
+ addr['postal_code'] = plz
+ ort = _text(anschrift, 'tns:ort')
+ if ort:
+ addr['city'] = ort
+ if addr:
+ data['address'] = addr
+
+ return data
def parse_result(result):
@@ -106,7 +411,7 @@ def parse_result(result):
cells.append(cell.text.strip())
d = {}
d['court'] = cells[1]
-
+
# Extract register number: HRB, HRA, VR, GnR followed by numbers (e.g. HRB 12345, VR 6789)
# Also capture suffix letter if present (e.g. HRB 12345 B), but avoid matching start of words (e.g. " Formerly")
reg_match = re.search(r'(HRA|HRB|GnR|VR|PR)\s*\d+(\s+[A-Z])?(?!\w)', d['court'])
@@ -147,10 +452,65 @@ def pr_company_info(c):
for name, loc in c.get('history'):
print(name, loc)
+def pr_company_detail(detail):
+ """Print the SI detail fields in human-readable format."""
+ if not detail:
+ print(' (no detail data available)')
+ return
+
+ print()
+ print('--- Detail (SI) ---')
+ for key in ('name', 'legal_form', 'seat', 'business_purpose',
+ 'articles_of_association_date', 'representation_rules'):
+ if key in detail:
+ label = key.replace('_', ' ').title()
+ print('%s: %s' % (label, detail[key]))
+
+ if 'address' in detail:
+ addr = detail['address']
+ parts = []
+ if 'street' in addr:
+ parts.append(addr['street'])
+ if 'postal_code' in addr and 'city' in addr:
+ parts.append('%s %s' % (addr['postal_code'], addr['city']))
+ elif 'city' in addr:
+ parts.append(addr['city'])
+ print('Address: %s' % ', '.join(parts))
+
+ if 'capital' in detail:
+ cap = detail['capital']
+ print('Capital: %s %s' % (cap['amount'], cap['currency']))
+
+ if 'directors' in detail:
+ print('Directors:')
+ for d in detail['directors']:
+ extra = ''
+ if d.get('representation'):
+ extra = ' (%s)' % d['representation']
+ print(' %s%s' % (d.get('name', '?'), extra))
+
+ if 'prokura' in detail:
+ print('Prokura:')
+ for p in detail['prokura']:
+ extra = ''
+ if p.get('representation'):
+ extra = ' (%s)' % p['representation']
+ print(' %s%s' % (p.get('name', '?'), extra))
+
+ if 'register_entries' in detail:
+ print('Register Entries:')
+ for entry in detail['register_entries']:
+ etype = entry.get('type', '')
+ text = entry.get('text', '')
+ print(' [%s] %s' % (etype, text))
+
+ print('Last Entry: %s' % detail.get('last_entry_date', '-'))
+ print('Retrieval Date: %s' % detail.get('retrieval_date', '-'))
+
def get_companies_in_searchresults(html):
soup = BeautifulSoup(html, 'html.parser')
grid = soup.find('table', role='grid')
-
+
results = []
for result in grid.find_all('tr'):
a = result.get('data-ri')
@@ -195,6 +555,12 @@ def parse_args():
help="Return response as JSON",
action="store_true"
)
+ parser.add_argument(
+ "-det",
+ "--detail",
+ help="Fetch SI (structured register content) detail for the first search result",
+ action="store_true"
+ )
args = parser.parse_args()
@@ -214,8 +580,17 @@ def parse_args():
h.open_startpage()
companies = h.search_company()
if companies is not None:
+ detail = None
+ if args.detail and len(companies) > 0:
+ detail = h.fetch_company_detail(result_index=0)
+
if args.json:
- print(json.dumps(companies))
+ output = companies
+ if detail:
+ output[0]['detail'] = detail
+ print(json.dumps(output))
else:
for c in companies:
pr_company_info(c)
+ if detail:
+ pr_company_detail(detail)
diff --git a/test_handelsregister.py b/test_handelsregister.py
index fa1951a..9b6a717 100644
--- a/test_handelsregister.py
+++ b/test_handelsregister.py
@@ -1,12 +1,12 @@
import pytest
-from handelsregister import get_companies_in_searchresults,HandelsRegister
+from handelsregister import get_companies_in_searchresults,HandelsRegister,parse_si_detail
import argparse
def test_parse_search_result():
html = '%s' % """
| |||||||||||||||||||||||||||||||||||||
U1308002U1308HRB287221110003000086017285017002009221110003000066011002EUR