Integracja z Deweloperskim Funduszem Gwarancyjnym (DFG) Jak wygenerować plik wsadowy dla DFG?

Integracja systemu voxCRM z portalem Deweloperskiego Funduszu Gwarancyjnego (DFG) umożliwia wygenerowanie plików wsadowych, które następnie importuje się na portalu DFG. W systemie dostępne są trzy warianty pliku wsadowego — każdy odpowiada innej sytuacji w obsłudze umów deweloperskich. Poniżej opisano, czego dotyczy każdy z wariantów oraz jakie dane należy uzupełnić, aby plik wygenerował się poprawnie.

💡 Który wariant wybrać: wariant Nowe umowy służy do pierwszego zgłoszenia umowy, Korekta — do poprawienia danych już zgłoszonej umowy (np. numeru rachunku), a Zmiana — do zgłoszenia zmiany umowy dokonanej aneksem lub cesją.
Wariant pliku wsadowego Kiedy stosować Kluczowy dodatkowy warunek
Nowe umowy DFG Zgłoszenie nowej umowy deweloperskiej (umowa zobowiązująca). Komplet danych inwestycji, lokalu i harmonogramu płatności.
Korekta umowy DFG Poprawa danych już zgłoszonej umowy — np. zmiana przypisanego numeru rachunku. Uzupełniony numer rachunku bankowego lokalu.
Zmiana umowy DFG Zgłoszenie zmiany umowy dokonanej aneksem lub cesją. Dodany aneks lub cesja z datą podpisania (skan dokumentu, opcjonalnie powód).

Spis treści

  1. Wymagania wspólne dla wszystkich wariantów
  2. Wariant 1 — Plik wsadowy „Nowe umowy DFG”
  3. Wariant 2 — Plik wsadowy „Korekta umowy DFG”
  4. Wariant 3 — Plik wsadowy „Zmiana umowy DFG”
  5. Generowanie pliku wsadowego
  6. Rejestracja i logowanie do portalu DFG
  7. Kontakt

1. Wymagania wspólne dla wszystkich wariantów

Niezależnie od wybranego wariantu, aby umowa została uwzględniona w pliku wsadowym, muszą być spełnione następujące warunki:

  • umowa posiada status Podpisana,
  • typ umowy to umowa deweloperska,
  • integracja z portalem DFG jest aktywna dla dewelopera.
⚠ Uwaga: Umowy, które nie spełniają powyższych warunków, są pomijane przy generowaniu pliku — nie pojawia się przy tym komunikat o błędzie. W zależności od konfiguracji danej instancji w zestawieniu mogą być uwzględniane także umowy rezerwacyjne — w razie potrzeby prosimy o kontakt z zespołem wsparcia.

2. Wariant 1 — Plik wsadowy „Nowe umowy DFG”

Plik wsadowy „Nowe umowy DFG” umożliwia wprowadzenie nowych danych na portalu Deweloperskiego Funduszu Gwarancyjnego (DFG). Poniżej przedstawiono szczegółową instrukcję krok po kroku.

Kroki przygotowawcze

Aby wygenerować plik wsadowy, należy:

  1. Uzupełnić obowiązkowe pola w systemie voxCRM.
  2. Wygenerować plik wsadowy „Nowe umowy DFG”.

Plik w formacie ZIP będzie gotowy do zaimportowania na portalu DFG.

Obowiązkowe pola do uzupełnienia w voxCRM

1. Pola w widoku edycji inwestycji – zakładka „Inwestycja”

W celu uzupełnienia wymaganych danych należy:

  • Przejść do listy inwestycji w systemie voxCRM.

  • Wybrać opcję Edytuj przy wybranej inwestycji.

  • Uzupełnić w zakładce Inwestycja (która otwiera się domyślnie) następujące pola:
    • Data przeniesienia własności (transferOwnershipDate),

    • Numer rachunku dla umów deweloperskich (mrpAccountNumber),

    • Numer księgi wieczystej (landingRegisterNumber).

2. Pola w widoku edycji inwestycji – zakładka „Adres”

W zakładce Adres należy wpisać:

  • Województwo (Province),
  • Miejscowość (City),
  • Powiat,
  • Gmina (Commune),
  • Ulica (Street),
  • Numer budynku (buildingNumber) – jeżeli pole to zostanie wypełnione w edycji lokalu, system pobierze numer z danych lokalu. W przeciwnym razie wykorzystany zostanie numer z edycji inwestycji,
  • Kod pocztowy (zipCode).

3. Pola w widoku edycji lokalu

Aby wprowadzić dane dla konkretnego lokalu, należy:

  • Otworzyć widok danego lokalu w systemie voxCRM.
  • Wybrać opcję Edytuj.

  • Wypełnić pole:
    • Numer konta bankowego 1 (subAccountNumber).

Uwaga: Jeżeli istnieje potrzeba hurtowego wprowadzenia numerów kont bankowych, należy przygotować plik zawierający numery lokali oraz przypisane do nich rachunki powiernicze i przesłać go na adres: kontakt@voxcommerce.pl.

4. Pola w widoku umowy deweloperskiej

W sekcji Harmonogram płatności należy uzupełnić:

  • Kwotę transzy (Amount),
  • Termin płatności (paymentDate).

⚠ Uwaga: Plik wsadowy uwzględnia wyłącznie umowy, które posiadają status Podpisana.

3. Wariant 2 — Plik wsadowy „Korekta umowy DFG”

Plik wsadowy „Korekta umowy DFG” służy do przekazania na portal DFG poprawionych danych umowy, która została już wcześniej zgłoszona — najczęściej w sytuacji zmiany przypisanego do lokalu numeru rachunku bankowego (rachunku powierniczego).

Kiedy stosować ten wariant

Wariant korekta stosuje się wówczas, gdy dane umowy zostały już zarejestrowane na portalu DFG, a następnie wymagały poprawienia — typowo dotyczy to zmiany numeru rachunku przypisanego do lokalu.

Co należy przygotować

Aby umowa została uwzględniona w pliku wsadowym korekta, należy:

  1. Spełnić wymagania wspólne (status Podpisana, typ umowy deweloperskiej, aktywna integracja DFG).
  2. Uzupełnić w widoku edycji lokalu pole Numer konta bankowego 1 poprawnym numerem rachunku.

 

⚠ Uwaga: Jeżeli numer rachunku bankowego lokalu nie zostanie uzupełniony, umowa zostanie pominięta przy generowaniu pliku korekty. Numer rachunku należy wprowadzić w formacie obowiązującym dla rachunków bankowych (poprawny numer IBAN).

Sposób wprowadzenia numeru rachunku jest analogiczny jak w wariancie „Nowe umowy” — opisano go w punkcie Pola w widoku edycji lokalu.

4. Wariant 3 — Plik wsadowy „Zmiana umowy DFG”

Plik wsadowy „Zmiana umowy DFG” służy do zgłoszenia na portalu DFG zmiany umowy dokonanej aneksem lub cesją. Aby zmiana mogła zostać uwzględniona, do umowy musi być dołączony odpowiedni dokument (aneks lub cesja) wraz z datą jego podpisania.

Kiedy stosować ten wariant

Wariant zmiana stosuje się, gdy warunki umowy uległy zmianie na podstawie aneksu lub gdy nastąpiła cesja umowy na inny podmiot.

Co należy przygotować

Aby umowa została uwzględniona w pliku wsadowym zmiana, należy:

  1. Spełnić wymagania wspólne (status Podpisana, typ umowy deweloperskiej, aktywna integracja DFG).
  2. Otworzyć widok umowy deweloperskiej i dodać dokument zmiany.

Podczas dodawania dokumentu należy uzupełnić następujące pola:

Pole Opis Wymagane
Typ Rodzaj dokumentu zmiany: Aneks lub Cesja. Tak
Data podpisania Data podpisania aneksu lub cesji. To na jej podstawie ustalana jest data zmiany przekazywana do DFG. Tak
Plik Skan podpisanego aneksu lub cesji. Tak
Nr dokumentu Numer dokumentu zmiany. Opcjonalne
Powód Powód zmiany umowy. Pole wykorzystywane jest przy eksporcie pliku wsadowego zmiany umów DFG (maks. 100 znaków). Opcjonalne

 

⚠ Uwaga: Jeżeli do umowy nie dodano aneksu ani cesji albo dokument nie ma uzupełnionej Daty podpisania, umowa zostanie pominięta przy generowaniu pliku zmiany. Jeżeli do jednej umowy dodano więcej niż jeden dokument zmiany, uwzględniany jest ostatnio dodany aneks.

5. Generowanie pliku wsadowego

Procedura generowania jest taka sama dla wszystkich trzech wariantów — różnica polega wyłącznie na wybranej opcji z listy. Aby wygenerować plik wsadowy, należy:

  1. Przejść do widoku Umowy.
  2. Zaznaczyć wybrane umowy, które mają zostać uwzględnione w pliku wsadowym.
  3. W sekcji Wykonaj dla zaznaczonych wybrać odpowiedni wariant:
    • Plik wsadowy nowe umowy DFG,
    • Plik wsadowy korekta umowy DFG,
    • Plik wsadowy zmiana umowy DFG.
  4. Wybrać opcję Wykonaj.

Po wykonaniu operacji system wygeneruje plik ZIP, który można zaimportować na portalu DFG.

💡 Wskazówka: Jeżeli wygenerowany plik nie zawiera spodziewanej umowy, najczęstszą przyczyną jest niespełnienie warunku dla danego wariantu — np. brak statusu Podpisana, nieuzupełniony numer rachunku (korekta) lub brak aneksu/cesji z datą podpisania (zmiana).

6. Rejestracja i logowanie do portalu DFG

Aby rozpocząć korzystanie z portalu DFG, należy zarejestrować administratora konta.

Otrzymanie danych dostępowych

Bank, który prowadzi rachunki powiernicze, przekaże dane dostępowe w formie listu powitalnego. Dokument zawiera:

  • Token rejestracyjny,
  • Numer ewidencyjny dewelopera,
  • Instrukcję rejestracyjną.
⚠ Uwaga: List powitalny jest niezbędny do przeprowadzenia rejestracji.

Logowanie do portalu

Po otrzymaniu danych należy:

  1. Otworzyć stronę główną portalu DFG.
  2. Wybrać opcję Deweloper, znajdującą się w górnym menu strony.

Po zalogowaniu należy:

  1. Wybrać tryb zasilenia — Nowe Dane.
  2. Wybrać sposób wprowadzenia danych — Z pliku.

Kontakt

W razie pytań lub problemów prosimy o kontakt z działem wsparcia technicznego:

Oceń ten wpis:

Tagi

Podobne wpisy