Steuernummernprüfung – Systembeschreibung
Endpunkte der Steuerbehörden- und VIES-Prüfung, das Prüfprotokoll, der kontextabhängige Prüfcache, die Sammelprüfung und der Bankkontoimport.
Das Partnermodul führt Prüfungen bei der Steuerbehörde (queryTaxpayer XML) und in VIES durch, protokolliert das Ergebnis als Auditzeile und schreibt es in die Gültigkeit des Partners. Zusatzendpunkte übernehmen Adressen und Bankkonten aus Rechnungen.
Datenmodell
Die Tabellennamen tragen in der Datenbank das eigene Präfix der Installation.
| Tabelle | Rolle |
|---|---|
company_validation | Prüfprotokoll (z. B. check_type = nav_taxpayer) |
company, company_address, address | Gültigkeit, Adressen |
invoice_ctrl | Rechnungssteuerdaten (Quelle für Adressen und Bankkonten) |
bankaccount, company_bankaccount | Bankkonten |
Endpunkte
querytaxpayer: Abfrage bei der Steuerbehörde mit 8-stelliger Steuernummer (Modellnav/xml); Zugangsdaten aus der Steuerbehördenzeile des Unternehmens mit fester ID 10; liefert Name, Kurzname, vollständige Steuernummer, Gruppen-MwSt.-ID, Adressen, Gültigkeit; bei Unternehmen im Bereich wird die Gültigkeit gespeichert (updateValidity) und eine Auditzeile geschrieben.queryvies: VIES-Prüfung per cURL; Fehler bei Nichterreichbarkeit.taxpayercompare: feldweiser Vergleich (Name, Kurzname, Steuernummer, Sitz) mit der URL vontaxpayerupdate;taxpayerupdate(edit): überschreibt die gewählten Felder, optional Einfügen des Sitzes.validate: Steuernummer und optional VIES mit Kontext (manual/cron/pre_invoice/pre_contract/pre_bank); außerhalb des manuellen Kontexts dient eine frühere gültige Prüfung als Cache; Audit, Gültigkeit, Adressabgleich (syncCompanyAddresses).revalidatestale:info=1→ stabile Liste ungeprüfter / ungültiger Partner (findStaleCompanies); POSTids[]→ ein Stapel (revalidateIds,manual); die Bibliothek beschränkt auf den Bereich.importinvoicebanks:info=1→ Zahl der zu verarbeitenden Zeilen; sonst Stapel mitstart/limit(Standard 200) überimportInvoiceBankaccounts()für Lieferanten im Bereich.syncinvoice:syncFromInvoiceCtrl()fügt Adressen hinzu und verknüpft normalisierte, deduplizierte Bankkonten (saveBankaccountForCompany); Zusammenfassung.
Berechtigungen
- Funktionsrechte:
taxpayer,revalidate,import_banks,sync_invoice; Bereich:validate, das Schreiben der Gültigkeit undsyncinvoicemitcompanyInScope. - Voraussetzung: technischer Benutzer der Steuerbehörde; ausgehendes HTTP für VIES.
Bekannte Einschränkungen
- Der Rumpf der Sammelaktualisierung (Endpunkt
taxpayer) ist auskommentiert; er meldet stets Erfolg mit dem Suffix „- teszt“. taxpayercompareundtaxpayerupdateprüfen den Bereich nicht.- Die Zugangsdaten stammen von einer festen ID.