Kontrahent z samego numeru NIP
GUS Partner Autocomplete pobiera dane firmy z rejestru REGON przez oficjalne API GUS (BIR1) i zakłada gotowy kontakt w Odoo — nazwa, adres, kod pocztowy, NIP i REGON. Koniec z przepisywaniem danych z cudzej faktury.
Kup moduł — 43,01 zł → Zadaj pytanie// W SKRÓCIE
- ▸ Warianty dla Odoo 18 i Odoo 19
- ▸ Oficjalne API REGON (BIR1)
- ▸ Kreator „Utwórz z GUS" w Kontaktach
- ▸ Przycisk „Pobierz z GUS" na karcie
- ▸ Osobne pole REGON w kontakcie
- ▸ Tryb testowy bez wniosku o klucz
- ▸ Zakup jednorazowy, bez abonamentu
Moduł gus_partner_autocomplete · wersja 18.0.1.0.0 / 19.0.1.0.0 · autor Marius Johannes Kuc
Dwie ścieżki, jedno źródło danych
Nowego kontrahenta zakładasz kreatorem. Dane kontrahenta, który już jest w bazie, odświeżasz przyciskiem na jego karcie.
Nowy kontrahent — kreator
Wpisujesz sam NIP, system dociąga resztę i zapisuje gotowy kontakt. To najkrótsza droga i zalecany sposób pracy.
- ▸ Kontakty → Utwórz z GUS
- ▸ Dziesięciocyfrowy NIP w oknie dialogowym
- ▸ Przycisk „Pobierz i utwórz"
- ▸ Kontakt powstaje z wypełnionymi polami
Istniejący kontrahent — aktualizacja
Kontakt jest już w bazie, ale dane pochodzą z ręcznego wpisu albo z importu sprzed lat. Przycisk zaciąga aktualną wersję z rejestru.
- ▸ Kontakty → karta kontrahenta
- ▸ W polu VAT musi być wpisany NIP
- ▸ Przycisk „Pobierz z GUS" obok pola VAT
- ▸ Dane kontaktu zostają zaktualizowane
Co pojawia się po instalacji
Sześć elementów w standardowych ekranach Odoo. Bez osobnej aplikacji do nauczenia się i bez zmian w module Kontakty.
Kreator „Utwórz z GUS"
Okno dialogowe w menu Kontakty. Przyjmuje numer NIP, pobiera dane z rejestru i tworzy nowy kontakt bez przechodzenia przez pusty formularz.
Kontakty → Utwórz z GUSPrzycisk „Pobierz z GUS"
Dokładany obok pola VAT na karcie kontrahenta. Pokazuje się, gdy w polu VAT jest numer — służy do odświeżenia danych istniejącego kontaktu.
karta kontaktu → obok pola VATMapowanie pól
Sześć pól kontaktu wypełnianych z odpowiedników w rejestrze REGON. Ulica składana z trzech elementów: ulicy, numeru i lokalu.
tabela mapowania niżejPole REGON w kontakcie
Moduł dokłada osobne pole na numer REGON — dotąd w standardowym Odoo nie ma dla niego miejsca, więc lądował w notatce albo nigdzie.
nowe pole na karcie kontaktuTryb testowy i produkcyjny
Przełącznik w karcie firmy. Testowy działa od razu na publicznym kluczu GUS, produkcyjny wymaga własnego klucza i zwraca dane wszystkich firm.
Firmy → zakładka GUS APIKontrola NIP i duplikatów
Numer krótszy albo dłuższy niż dziesięć cyfr zostaje odrzucony. Jeśli kontrahent o takim NIP jest już w bazie, kreator o tym mówi zamiast tworzyć drugą kartę.
komunikaty kreatoraCo dokładnie ląduje w karcie kontaktu
Pełna lista pól. Nic więcej moduł nie nadpisuje — reszta karty kontrahenta zostaje taka, jak ją prowadzisz.
UCZCIWIE: dane są tak aktualne, jak rejestr REGON. Jeśli firma nie zgłosiła tam zmiany adresu, moduł pobierze wersję, która widnieje w rejestrze — wiernie, ale nieaktualnie.
Cztery kroki na serwerze
Moduł potrzebuje jednej biblioteki Pythona. Reszta to standardowa procedura wgrania dodatku do Odoo.
Biblioteka gusregon
Na serwerze Odoo instalujesz bibliotekę obsługującą API REGON.
pip install gusregonRozpakowanie modułu
Archiwum gus_partner_autocomplete.zip trafia do katalogu z dodatkami.
/mnt/extra-addons/Lista aplikacji
Odoo musi zobaczyć nowy katalog — odświeżasz listę dostępnych aplikacji.
Aplikacje → Aktualizuj listęInstalacja
Wyszukujesz GUS Partner Autocomplete na liście aplikacji i aktywujesz.
Aplikacje → AktywujInstalacja standardowa:
Instalacja w kontenerze Docker:
Po instalacji biblioteki restartuj usługę Odoo, zanim aktywujesz moduł.
Jedna zakładka w karcie firmy
Cała konfiguracja mieści się w zakładce GUS API w karcie Twojej firmy. Decydujesz tam tylko o jednym: tryb testowy czy produkcyjny.
- ▸ Ustawienia
- ▸ Użytkownicy i Firmy
- ▸ Firmy → Twoja firma
- ▸ Zakładka „GUS API"
- ▸ model res.company
- ▸ Publiczny klucz testowy GUS
- ▸ Działa od razu, bez wniosku
- ▸ Tylko kilka przykładowych NIP
- ▸ np.
5261040828 (GUS) - ▸ Do sprawdzenia działania
- ▸ Własny klucz API REGON
- ▸ Dane wszystkich firm
- ▸ Odznaczasz „Tryb testowy"
- ▸ Klucz wklejasz w to samo miejsce
- ▸ Tryb do pracy na produkcji
⚠️ Ograniczenie trybu testowego
W trybie testowym API GUS zwraca dane wyłącznie dla kilku przykładowych numerów, na przykład
Jak zdobyć klucz API REGON
Klucz wydaje GUS, na Twoje konto i Twój wniosek. To formalność po stronie urzędu — my nie pośredniczymy i nie odsprzedajemy dostępu.
Strona API GUS
Otwierasz portal API REGON prowadzony przez Główny Urząd Statystyczny.
api.stat.gov.plRejestracja
Zakładasz konto i składasz wniosek o dostęp do API REGON.
konto + wniosekRozpatrzenie wniosku
GUS rozpatruje wniosek i przesyła klucz na podany adres e-mail.
termin po stronie urzęduWpisanie w Odoo
W zakładce GUS API odznaczasz „Tryb testowy" i wklejasz otrzymany klucz.
Firmy → GUS APICo moduł robi, a czego nie robi
To pojedyncze narzędzie do jednego zadania: dane firmy z rejestru REGON w karcie kontrahenta. Wolimy powiedzieć to przed zakupem niż po.
✓ Moduł obejmuje
- Tworzenie kontaktu z samego numeru NIP
- Aktualizację danych istniejącego kontaktu z rejestru
- Sześć pól uzupełnianych automatycznie, w tym REGON
- Tryb testowy do sprawdzenia działania bez klucza
- Kontrolę długości NIP-u i ostrzeżenie o duplikacie
- Pracę na oficjalnym API REGON (BIR1), nie na scrapingu
— Moduł nie obejmuje
- Pobierania danych z KRS
- Sprawdzania statusu VAT na białej liście ani w VIES
- Danych kontaktowych: telefonów, adresów e-mail, osób
- Masowego odświeżenia całej bazy kontrahentów jednym kliknięciem
- Uzyskania klucza API — wniosek składasz w GUS samodzielnie
- Pracy bez dostępu serwera Odoo do internetu
UCZCIWIE: jeśli szukasz weryfikacji kontrahenta pod kątem podatkowym — biała lista, status VAT, rachunki bankowe — to inne narzędzie. Ten moduł oszczędza przepisywanie danych, nie zastępuje procedury sprawdzania kontrahenta.
Komunikaty i co za nimi stoi
Siedem sytuacji, które zgłaszane są najczęściej. W większości przypadków sprawa kończy się na ustawieniach firmy albo na formacie NIP-u.
„Brak klucza API GUS"
Włącz tryb testowy albo wprowadź klucz produkcyjny w zakładce GUS API w karcie firmy.
„Nieprawidłowy numer NIP"
Sprawdź, czy numer ma dokładnie dziesięć cyfr. Myślniki i spacje trzeba usunąć.
„Nie znaleziono danych"
W trybie testowym użyj numeru
„Partner z tym NIP-em już istnieje"
Kontrahent jest już w bazie. Otwórz jego kartę i użyj przycisku „Pobierz z GUS" zamiast kreatora.
Błąd połączenia
Sprawdź, czy serwer Odoo ma wyjście na internet — moduł łączy się z API GUS z serwera, nie z przeglądarki.
Nie widać przycisku „Pobierz z GUS"
Przycisk pojawia się dopiero, gdy w polu VAT jest wpisany numer. Uzupełnij NIP i zapisz kartę.
„Brak biblioteki gusregon"
Biblioteka nie została zainstalowana na serwerze albo Odoo nie zostało zrestartowane po jej instalacji. Wróć do kroku 01 instalacji.
Problem spoza tej listy
Napisz na info@nexus-digital.pl albo zadzwoń:
Jedna kwota, dwa warianty wersji
Ten sam zakres funkcjonalny, osobna pozycja w sklepie dla każdej wersji Odoo. Wybierz tę, na której stoi Twoja instancja.
ODOO 19
GUS Partner Autocomplete
Wariant dla Odoo 19 — wersja modułu 19.0.1.0.0.
- ✓ Moduł gus_partner_autocomplete dla Odoo 19
- ✓ Kreator „Utwórz z GUS" i przycisk na karcie
- ✓ Pole REGON w karcie kontrahenta
- ✓ Bez opłat cyklicznych
GUS Partner Autocomplete
Wariant dla Odoo 18 — wersja modułu 18.0.1.0.0.
- ✓ Moduł gus_partner_autocomplete dla Odoo 18
- ✓ Kreator „Utwórz z GUS" i przycisk na karcie
- ✓ Pole REGON w karcie kontrahenta
- ✓ Bez opłat cyklicznych
Wdrożenie, konfiguracja klucza API i szkolenie są wyceniane osobno — 250 zł/h (PL) lub 60 €/h (DACH). Nie są konieczne do uruchomienia modułu.
Pytania, które padają przed zakupem
Czy muszę mieć własny klucz API GUS?
Do pracy na prawdziwych kontrahentach — tak. Tryb testowy działa od razu, ale API zwraca w nim dane tylko dla kilku przykładowych numerów, na przykład
Ile trwa uzyskanie klucza?
Termin jest po stronie urzędu i nie deklarujemy go za GUS. Wniosek składasz na portalu API REGON, klucz przychodzi na podany adres e-mail. Do tego czasu możesz pracować w trybie testowym i sprawdzić, czy moduł działa w Twojej instancji.
Czy potrzebuję Odoo Enterprise?
Nie. Moduł rozszerza standardowy moduł Kontakty i pracuje na Odoo Community. Działa też w PERP Enterprise. Instalacja wymaga dostępu do katalogu z dodatkami na serwerze.
Czym różnią się warianty 18 i 19?
Zakresem niczym — różnią się wersją Odoo, pod którą są zbudowane. Kupujesz wariant zgodny z instancją. Przy migracji na kolejną wersję Odoo potrzebny jest wariant dla tej wersji.
Co się stanie z danymi, które już mam wpisane ręcznie?
Przycisk „Pobierz z GUS" aktualizuje pola kontaktu danymi z rejestru — to świadoma akcja użytkownika, nie automat w tle. Kontakty, których nie dotkniesz, zostają bez zmian.
Czy moduł sprawdza białą listę VAT?
Nie. Źródłem jest wyłącznie rejestr REGON prowadzony przez GUS. Weryfikacja statusu VAT, rachunków bankowych i VIES to osobne zagadnienie i osobne narzędzia.
Czy da się zobaczyć moduł przed zakupem?
Tak. Uruchamiamy bezpłatną instancję testową na 14 dni, na Twoich danych. Napisz na info@nexus-digital.pl z informacją, na jakiej wersji Odoo pracujesz.
Moduły, które zwykle stoją obok
Autouzupełnianie kontrahentów rzadko jest jedyną polską potrzebą w instancji Odoo.
Przestań przepisywać dane z cudzych faktur
Moduł kosztuje 43,01 zł i instaluje się w cztery kroki. Jeśli wolisz najpierw zobaczyć go na własnych danych — uruchamiamy bezpłatną instancję testową na 14 dni.
Kup w sklepie → Napisz do nasNexus Digital · Inh. Marius Johannes Kuc · Bessemerstraße 51, 12103 Berlin · VAT ID: DE
tel. PL