Partner-, Adress- und Bankkontodaten über die API
Was ein externes Programm mit Partnern, dem Adressstamm und Bankkonten tun kann: suchen, auflisten, abfragen, mit Dublettenprüfung anlegen und löschen.
Über die API kann ein externes Programm Partner suchen und auflisten, alle Daten eines Partners abfragen, einen neuen Partner anlegen sowie den Adressstamm, den Bankkontostamm und die mit Partnern verknüpften Bankkonten verwalten. Es sieht immer nur Unternehmen im Inhaltsbereich des Schlüsselinhabers.
Typischer Ablauf: neuen Kunden anlegen
- Prüfen Sie per Steuernummer, ob der Partner bereits existiert (Partnersuche). Mindestens ein Suchkriterium ist Pflicht.
- Gibt es keinen Treffer, legen Sie den Partner mit Name, Steuernummer und bei Bedarf Unternehmensgruppe und Kontonummer an.
- Meldet die Antwort, dass die ersten 8 Ziffern der Steuernummer bereits existieren, legen Sie ihn nicht erneut an: Die Antwort nennt die ID des vorhandenen Partners.
- War die Kontonummer ungültig, wird der Partner dennoch angelegt und die Antwort enthält einen Hinweis; korrigieren Sie die Nummer und fügen Sie sie gesondert den Bankkonten des Partners hinzu.
- Fragen Sie das vollständige Datenblatt des Partners ab: Stammdaten, Steuerzahlerstatus, Adressen mit KSH-Ortsverweis und Bankkonten.
Regeln
| Bereich | Worauf achten |
|---|---|
| Partnerliste | höchstens 100 Zeilen auf einmal; Filter nach Steuernummer-Präfix, Namensteil und Status, sortierbar |
| Partner löschen | nur ein Partner ohne Verweise ist löschbar; seine Adress- und Kontoverknüpfungen werden mitgelöscht, gemeinsame Stammdaten bleiben |
| Adressstamm | Postleitzahl und Ort Pflicht; bei identischer Adresse wird die vorhandene zurückgegeben; eine mit Unternehmen verknüpfte Adresse ist nicht löschbar |
| Bankkontostamm | das System bringt die Nummer in die einheitliche 24-stellige Form; eine ungültige Nummer wird nicht gespeichert; bei identischer Nummer wird die vorhandene zurückgegeben; eine mit Unternehmen verknüpfte Nummer ist nicht löschbar |
| Bankkonten eines Partners | der Partner kann auch per Steuernummer angegeben werden; Löschen entfernt nur die Verknüpfung, das Konto bleibt im Stamm |
Beispiel
Der Webshop der Muster GmbH sucht mit der Steuernummer der Beispiel AG, findet nichts und legt den Partner mit seiner Kontonummer an. Das System bringt die Nummer in die einheitliche Form, legt das Konto im Stamm ab und verknüpft es mit dem Partner; die Antwort liefert die IDs von Partner und Bankkonto.