Startseite › Bibliothek

Ausgabendienstleister

Ausgabendienstleister ist ein flexibles System zur Verwaltung von Kontrahenten für Immobilienausgaben. Das System unterstützt 4 Arten von Dienstleistern.

Was ist ein Ausgabendienstleister?

Ein Ausgabendienstleister ist eine Zwischenentität, die auf die Quelle von Dienstleistungen oder Waren verweist. Anstelle einer direkten Bindung an offizielle Unternehmen ermöglicht das System die Auswahl aus verschiedenen Arten von Dienstleistern, einschließlich eines persönlichen Kontrahenten-Verzeichnisses.

Dienstleistertypen

1. Dienstleister

Offizielle Unternehmen mit Steuernummern im gemeinsamen Firmenverzeichnis.

Enthält vollständige Unternehmensinformationen
Verifizierte Steuernummer
Gemeinsames Verzeichnis für alle Benutzer

2. Systembenutzer

Systembenutzer, die Dienstleistungen für die Immobilie anbieten können.

Zum Beispiel ein technischer Spezialist, der die Immobilie betreut
Bereits im System registriert
Hat Profil und E-Mail

3. Eingeladener Partner

Eingeladene Personen, die sich nicht registriert haben, deren Daten aber gespeichert sind.

Enthält Name und E-Mail
Benutzer möchte sich nicht registrieren, aber Daten müssen gespeichert werden

4. Persönliches Verzeichnis

Persönliches Kontrahenten-Verzeichnis des Benutzers. Die flexibelste Option.

Nur das Feld "Name" ist erforderlich
Alle anderen Felder sind optional (Steuer, Bank, Kontakt)
Keine Steuernummer-Validierung - kann beliebige Daten eingeben
Mit Immobilie und Benutzer verknüpft

Wie zu verwenden

Erstellen einer Ausgabe mit Dienstleister

Öffnen Sie das Formular zur Ausgabenerstellung
Klicken Sie auf "Dienstleister auswählen" - ein Modal wird geöffnet
Wählen Sie den Dienstleistertyp (Firma, Benutzer, Einladung oder persönlicher Kontrahent)
Wählen Sie einen bestimmten Dienstleister aus der Liste und bestätigen Sie

Persönliches Kontrahenten-Verzeichnis

Um persönliche Kontrahenten zu verwalten, gehen Sie zum Abschnitt "Persönliches Verzeichnis" auf der Immobilienseite.

Pflichtfelder

Name - nur dieses Feld ist erforderlich

Optionale Felder

Grundinformationen: Kurzname, Rechtsform
Steuerinformationen: Steuernummer, USt-IdNr., Steuersystem
Bankverbindung: IBAN, Bankname, Bankleitzahl, SWIFT
Kontaktinformationen: E-Mail, Telefon, Webseite, Rechtliche Adresse, Tatsächliche Adresse
Rechtsinformationen: Name des Direktors, Kontaktperson, Registrierungsdatum
Sonstiges: Notizen

API Endpoints

GET /api/v1/properties/{propertyId}/expense-providers/available

Alle verfügbaren Dienstleister nach Typ abrufen

POST /api/v1/properties/{propertyId}/expense-providers/create-by-email

Erstellt ExpenseProvider mit E-Mail für Typen "user" oder "partner_invitation". Führt E-Mail-Validierung durch und sendet automatisch Einladung an Partner.

Parameter:

provider_type - Dienstleistertyp: "user" (vorhandener Benutzer) oder "partner_invitation" (Partnereinladung)
email - E-Mail des Benutzers oder Partners zur Einladung
name - Name für Partnereinladung (erforderlich für Typ partner_invitation)
locale - Einladungssprache: uk, en, ru, pl, de (Standard: uk)

Validierung:

Für Typ "user": überprüft, dass E-Mail nicht dem aktuellen Benutzer gehört und einem aktiven Benutzer im System gehört
Für Typ "partner_invitation": validiert E-Mail-Format, prüft vorhandene Einladungen
Wenn Einladung bereits mit Status "invited" existiert, wird sie aktualisiert und erneut gesendet
Alle Validierungsfehler werden mit entsprechenden Übersetzungsschlüsseln zurückgegeben (error_key)

POST /api/v1/properties/{propertyId}/expense-providers/create-or-get

ExpenseProvider für bestimmten Dienstleister erstellen oder abrufen

GET /api/v1/properties/{propertyId}/custom-contragents

Liste der persönlichen Kontrahenten für Immobilie abrufen

POST /api/v1/properties/{propertyId}/custom-contragents

Neuen persönlichen Kontrahenten erstellen

Hinweis: Detaillierte API-Dokumentation verfügbar in Swagger (/api/doc)