Przejdź do treści

🏢 Moduł Kontrahenci

Moduł Kontrahenci umożliwia zarządzanie bazą kontrahentów z automatyczną weryfikacją VAT, wypełnianiem danych i oceną ryzyka kredytowego.

🎯 Co to jest moduł Kontrahenci?

Moduł Kontrahenci pozwala na: - Zarządzanie kontrahentami - Pełna baza kontrahentów - Automatyczną weryfikację VAT - Codzienne sprawdzanie na Białej Liście VAT - Automatyczne wypełnianie danych - Z REGON API - Ocenę ryzyka - Automatyczna ocena ryzyka kredytowego

🚀 Podstawowe funkcje

Lista kontrahentów

  1. Przejdź do Kontrahenci w menu głównym
  2. Zobaczysz listę wszystkich kontrahentów
  3. Użyj wyszukiwania na żywo (HTMX) do znajdowania kontrahentów
  4. Użyj filtrów do filtrowania (status, ryzyko, grupa)

Dodawanie kontrahenta

  1. Kliknij "Dodaj kontrahenta"
  2. Wprowadź NIP - System automatycznie:
  3. Sprawdzi NIP w REGON
  4. Pobierze dane z GUS
  5. Zweryfikuje na Białej Liście VAT
  6. Wypełni formularz
  7. Sprawdź i uzupełnij dane
  8. Wybierz klienta (jeśli kontrahent należy do klienta)
  9. Lub zaznacz "Kontrahent biura"
  10. Zapisz kontrahenta

Szczegóły kontrahenta

  1. Kliknij na nazwę kontrahenta na liście
  2. Zobaczysz szczegóły z zakładkami:
  3. Szczegóły - Podstawowe dane
  4. Kontakty - Lista kontaktów
  5. Konta bankowe - Lista kont bankowych
  6. Dokumenty - Wszystkie dokumenty
  7. Weryfikacja VAT - Status weryfikacji VAT
  8. Ocena ryzyka - Score i poziom ryzyka
  9. Timeline - Historia aktywności

📋 Najważniejsze funkcje

Automatyczne wypełnianie danych

  • REGON API - System automatycznie pobiera dane z GUS
  • Live NIP verification - Weryfikacja w czasie rzeczywistym podczas wprowadzania
  • Auto short name - Automatyczne generowanie skróconej nazwy
  • Strukturalny adres - Ulica, numer budynku, numer lokalu

Weryfikacja VAT

  • Biała Lista VAT - Automatyczna weryfikacja (API MF)
  • Status VAT - ACTIVE, REMOVED, EXEMPT, ERROR
  • Weryfikacja kont bankowych - Sprawdzanie każdego konta osobno
  • Automatyczne sprawdzanie - Codzienne weryfikacje o 6:00
  • Powiadomienia - Email gdy kontrahent zostanie usunięty z listy

Ocena ryzyka kredytowego

  • Auto-scoring - Automatyczna ocena 0-100 (5 czynników)
  • Poziomy ryzyka - LOW, MEDIUM, HIGH, CRITICAL
  • Limity kredytowe - Ustawianie limitów per kontrahent
  • Auto-block - Automatyczne blokowanie przy przekroczeniu limitu

💡 Jak używać?

Wyszukiwanie kontrahentów

  1. Użyj pola wyszukiwania na górze listy
  2. Wpisz nazwę, NIP lub miasto
  3. System automatycznie filtruje listę (HTMX, 500ms debounce)

Filtrowanie kontrahentów

  1. Kliknij "Filtry" na liście kontrahentów
  2. Wybierz status (aktywny, zarchiwizowany, zablokowany)
  3. Wybierz poziom ryzyka (LOW, MEDIUM, HIGH, CRITICAL)
  4. Wybierz grupę (jeśli używasz grup)
  5. Wybierz klienta (jeśli filtrujesz per klient)
  6. Kliknij "Zastosuj filtry"

Weryfikacja VAT

  1. Przejdź do szczegółów kontrahenta
  2. W sekcji "Weryfikacja VAT" zobaczysz:
  3. Status na Białej Liście VAT
  4. Zweryfikowane konta bankowe
  5. Datę ostatniej weryfikacji
  6. Kliknij "Zweryfikuj teraz" dla ręcznej weryfikacji
  7. System automatycznie sprawdzi codziennie o 6:00

Ocena ryzyka

  1. System automatycznie oblicza score (0-100) na podstawie:
  2. 40% - Historia płatności
  3. 30% - Zaległe kwoty
  4. 15% - Status VAT
  5. 10% - Długość współpracy
  6. 5% - Wielkość firmy
  7. Poziom ryzyka jest automatycznie przypisywany:
  8. LOW (0-40) - Zielony
  9. MEDIUM (41-60) - Żółty
  10. HIGH (61-80) - Pomarańczowy
  11. CRITICAL (81-100) - Czerwony
  12. Ustaw limit kredytowy dla kontrahenta
  13. System automatycznie zablokuje przy przekroczeniu

🔧 Zaawansowane funkcje

Grupy kontrahentów

  1. Przejdź do Kontrahenci → Grupy
  2. Kliknij "Dodaj grupę"
  3. Wprowadź dane:
  4. Nazwa grupy (np. "VIP", "Export", "B2B")
  5. Kolor - Kolor grupy (dla UI)
  6. Ikona - Ikona grupy
  7. Zapisz grupę
  8. Przypisz kontrahentów do grupy

Kontakty

Każdy kontrahent może mieć wiele kontaktów:

  1. Przejdź do szczegółów kontrahenta → Kontakty
  2. Kliknij "Dodaj kontakt"
  3. Wprowadź dane:
  4. Imię i nazwisko
  5. Email
  6. Telefon
  7. Rola (Główny, finansowy, techniczny)
  8. Stanowisko
  9. Dział
  10. Zapisz kontakt

Konta bankowe

  1. Przejdź do szczegółów kontrahenta → Konta bankowe
  2. Kliknij "Dodaj konto"
  3. Wprowadź dane:
  4. Numer konta (IBAN)
  5. Nazwa banku - System automatycznie wypełni z Master Data
  6. SWIFT/BIC - System automatycznie wypełni
  7. System automatycznie zweryfikuje konto na Białej Liście VAT
  8. Zapisz konto

Dokumenty

  1. Przejdź do szczegółów kontrahenta → Dokumenty
  2. Kliknij "Dodaj dokument"
  3. Przeciągnij plik lub kliknij "Wybierz plik"
  4. Wybierz typ dokumentu (Umowa, certyfikat, pełnomocnictwo)
  5. Ustaw datę ważności (jeśli dotyczy)
  6. Zapisz dokument
  7. System automatycznie wyśle powiadomienie 30 dni przed wygaśnięciem

🆘 Rozwiązywanie problemów

Problem: Dane z REGON są nieprawidłowe

Rozwiązanie: - Możesz edytować dane po pobraniu z REGON - System pozwala na korekty danych - Zawsze sprawdzaj dane przed zapisaniem

Problem: Kontrahent został usunięty z Białej Listy VAT

Rozwiązanie: - System automatycznie wyśle powiadomienie emailem - Sprawdź sekcję "Weryfikacja VAT" w szczegółach kontrahenta - Sprawdź powód usunięcia - Skontaktuj się z kontrahentem

Problem: Score ryzyka jest zbyt wysoki

Rozwiązanie: - Sprawdź historię płatności kontrahenta - Sprawdź zaległe kwoty - Sprawdź status VAT - Rozważ zwiększenie limitu kredytowego (jeśli uzasadnione)

📚 Więcej informacji

Ostatnia aktualizacja: 2025-11-29
Wersja dokumentacji: 1.0