📋 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).
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.:
5261040828 (Główny Urząd Statystyczny)
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 5261040828. Dla prawdziwych firm potrzebujesz klucza produkcyjnego. |
| 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.
