📋 GUS Partner Autocomplete
Wersja: 18.0.1.0.0 | Autor: Marius Johannes Kuc | www.odoo.com.pl/autouzupelnianie
Opis modułu: Automatyczne pobieranie danych kontrahentów z bazy GUS (Główny Urząd Statystyczny) na podstawie numeru NIP. Moduł wykorzystuje oficjalne API REGON (BIR1).
Pro EXTREME
Pro ULTIMATE
Midi BUSINESS
Mini FREE
1. Instalacja modułu
1. Zainstaluj wymaganą bibliotekę Python
Na serwerze Odoo wykonaj polecenie:
pip install gusregon
Dla Docker: docker exec -it NAZWA_KONTENERA pip install --break-system-packages gusregon
2. Rozpakuj archiwum
Rozpakuj plik gus_partner_autocomplete.zip do katalogu z dodatkami Odoo (np. /mnt/extra-addons/)
3 Aktualizuj listę aplikacji
Przejdź do Aplikacje → Aktualizuj listę aplikacji
4 Zainstaluj moduł
Wyszukaj GUS Partner Autocomplete i kliknij Aktywuj
2. Konfiguracja API GUS
1. Otwórz ustawienia firmy
Przejdź do Ustawienia → Użytkownicy i Firmy → Firmy → [Twoja firma]
2. Znajdź zakładkę GUS API
W formularzu firmy przejdź do zakładki GUS API
3. Wybierz tryb pracy
| Tryb | Opis | Wymagania |
| Testowy | Używa publicznego klucza testowego GUS. Działa tylko z kilkoma testowymi NIP-ami! | Brak - działa od razu |
| Produkcyjny | Używa oficjalnego API z aktualnymi danymi dla wszystkich firm. | Własny klucz API |
⚠️ Tryb testowy - ograniczenia:
W trybie testowym API GUS zwraca dane tylko dla kilku przykładowych NIP-ów, np.:
Aby pobierać dane prawdziwych firm, musisz uzyskać własny klucz API i wyłączyć tryb testowy.
3. Uzyskanie klucza API (tryb produkcyjny)
1. Wejdź na stronę GUS
Otwórz: https://api.stat.gov.pl/Home/RegonApi
2. Zarejestruj się
Załóż konto i złóż wniosek o dostęp do API REGON
3. Poczekaj na akceptację
GUS rozpatrzy wniosek i prześle klucz API na podany e-mail
4. Wprowadź klucz w Odoo
W zakładce GUS API odznacz "Tryb testowy" i wpisz otrzymany klucz
4. Tworzenie partnera z GUS (zalecane)
💡 Najszybsza metoda: Wpisz tylko NIP - system automatycznie utworzy partnera z wszystkimi danymi!
1. Otwórz kreator
Przejdź do Kontakty → Utwórz z GUS
2. Wpisz NIP
W oknie dialogowym wpisz 10-cyfrowy numer NIP kontrahenta
3. Kliknij "Pobierz i utwórz"
System pobierze dane z GUS i automatycznie utworzy nowego partnera z wypełnionymi polami.
✅ Gotowe! Partner został utworzony z pełnymi danymi z GUS - nazwa, adres, REGON, VAT.
5. Aktualizacja istniejącego partnera
Jeśli partner już istnieje i chcesz zaktualizować jego dane z GUS:
1. Otwórz formularz partnera
Przejdź do Kontakty → [wybierz partnera]
2. Sprawdź pole VAT
Upewnij się, że w polu VAT jest wpisany numer NIP
3. Kliknij "Pobierz z GUS"
Przycisk znajduje się obok pola VAT. Dane partnera zostaną zaktualizowane.
6. Pobierane dane
| Pole w Odoo | Źródło GUS | Opis |
| Nazwa | Nazwa | Pełna nazwa firmy z rejestru |
| Ulica | Ulica + Nr + Lokal | Pełny adres ulicy |
| Miasto | Miejscowosc | Nazwa miejscowości |
| Kod pocztowy | KodPocztowy | Kod pocztowy |
| VAT | Nip | NIP z przedrostkiem PL |
| REGON | Regon | Numer REGON (nowe pole) |
7. Rozwiązywanie problemów
| Problem | Rozwiązanie |
| Błąd: "Brak klucza API GUS" | Włącz tryb testowy lub wprowadź klucz produkcyjny w ustawieniach firmy |
| Błąd: "Nieprawidłowy numer NIP" | Sprawdź czy NIP ma dokładnie 10 cyfr |
| Błąd: "Nie znaleziono danych" | W trybie testowym użyj NIP |
| Błąd: "Partner z tym NIP-em już istnieje" | Partner o takim NIP jest już w systemie. Użyj przycisku "Pobierz z GUS" na jego formularzu. |
| Błąd połączenia | Sprawdź połączenie internetowe serwera Odoo |
| Przycisk "Pobierz z GUS" nie widoczny | Najpierw wprowadź NIP w polu VAT |
| Błąd: "Brak biblioteki gusregon" | Zainstaluj bibliotekę: pip install gusregon |
📧 Wsparcie techniczne: W razie problemów skontaktuj się z autorem modułu.