Strona główna › Biblioteka

Dostawcy wydatków

Dostawcy wydatków to elastyczny system zarządzania kontrahentami dla wydatków nieruchomości. System obsługuje 4 typy dostawców.

Czym jest dostawca wydatków?

Dostawca wydatków to pośrednia jednostka, która wskazuje na źródło usług lub towarów. Zamiast bezpośredniego powiązania z oficjalnymi firmami, system umożliwia wybór z różnych typów dostawców, w tym osobistego katalogu kontrahentów.

Typy dostawców

1. Dostawca usług

Oficjalne firmy z numerami podatkowymi w wspólnym katalogu firm.

Zawiera pełne informacje o firmie
Zweryfikowany numer podatkowy
Wspólny katalog dla wszystkich użytkowników

2. Użytkownik systemu

Użytkownicy systemu, którzy mogą świadczyć usługi dla nieruchomości.

Na przykład specjalista techniczny obsługujący nieruchomość
Już zarejestrowany w systemie
Ma profil i email

3. Zaproszony partner

Zaproszone osoby, które się nie zarejestrowały, ale ich dane są zapisane.

Zawiera nazwisko i email
Użytkownik nie chce się rejestrować, ale dane trzeba zapisać

4. Osobisty katalog

Osobisty katalog kontrahentów użytkownika. Najbardziej elastyczna opcja.

Wymagane jest tylko pole "Nazwa"
Wszystkie inne pola są opcjonalne (podatkowe, bankowe, kontaktowe)
Bez weryfikacji numeru podatkowego - można wprowadzić dowolne dane
Powiązany z nieruchomością i użytkownikiem

Jak używać

Tworzenie wydatku z dostawcą

Otwórz formularz tworzenia wydatku
Kliknij "Wybierz dostawcę" - otworzy się okno modalne
Wybierz typ dostawcy (firma, użytkownik, zaproszenie lub osobisty kontrahent)
Wybierz konkretnego dostawcę z listy i potwierdź

Osobisty katalog kontrahentów

Aby zarządzać osobistymi kontrahentami, przejdź do sekcji "Osobisty katalog" na stronie nieruchomości.

Wymagane pola

Nazwa - tylko to pole jest wymagane

Opcjonalne pola

Podstawowe informacje: Skrócona nazwa, Forma prawna
Informacje podatkowe: NIP, Numer VAT, System podatkowy
Dane bankowe: IBAN, Nazwa banku, Kod banku, SWIFT
Informacje kontaktowe: Email, Telefon, Strona internetowa, Adres prawny, Adres faktyczny
Informacje prawne: Imię i nazwisko dyrektora, Osoba kontaktowa, Data rejestracji
Inne: Notatki

API Endpoints

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

Pobierz wszystkich dostępnych dostawców pogrupowanych według typu

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

Tworzy ExpenseProvider za pomocą adresu e-mail dla typów "user" lub "partner_invitation". Przeprowadza walidację adresu e-mail i automatycznie wysyła zaproszenie do partnera.

Parametry:

provider_type - Typ dostawcy: "user" (istniejący użytkownik) lub "partner_invitation" (zaproszenie partnera)
email - Adres e-mail użytkownika lub partnera do zaproszenia
name - Imię do zaproszenia partnera (wymagane dla typu partner_invitation)
locale - Język zaproszenia: uk, en, ru, pl, de (domyślnie: uk)

Walidacja:

Dla typu "user": sprawdza, czy adres e-mail nie należy do bieżącego użytkownika i należy do aktywnego użytkownika w systemie
Dla typu "partner_invitation": sprawdza format adresu e-mail, sprawdza istniejące zaproszenia
Jeśli zaproszenie już istnieje ze statusem "invited", zostaje zaktualizowane i ponownie wysłane
Wszystkie błędy walidacji są zwracane z odpowiednimi kluczami tłumaczeń (error_key)

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

Utwórz lub pobierz ExpenseProvider dla konkretnego dostawcy

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

Pobierz listę osobistych kontrahentów dla nieruchomości

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

Utwórz nowego osobistego kontrahenta

Uwaga: Szczegółowa dokumentacja API dostępna w Swagger (/api/doc)