| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Contacts (contacts)
• Discuss (mail) |
| Lines of code | 222 |
| Technical Name |
gus_partner_autocomplete |
| License | LGPL-3 |
| Website | https://www.perp.pl/gus |
| Versions | 18.0 |
📋 GUS Partner Autocomplete
Wersja: 18.0.1.0.0 | Autor: Marius Johannes Kuc | www.perp.pl/apps/autouzupelnianie
1. Instalacja modułu
Na serwerze Odoo wykonaj polecenie:
pip install gusregon
Dla Docker: docker exec -it NAZWA_KONTENERA pip install --break-system-packages gusregon
Rozpakuj plik gus_partner_autocomplete.zip do katalogu z dodatkami Odoo (np. /mnt/extra-addons/)
Przejdź do Aplikacje → Aktualizuj listę aplikacji
Wyszukaj GUS Partner Autocomplete i kliknij Aktywuj
2. Konfiguracja API GUS
Przejdź do Ustawienia → Użytkownicy i Firmy → Firmy → [Twoja firma]
W formularzu firmy przejdź do zakładki GUS API
| 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 |
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)
Otwórz: https://api.stat.gov.pl/Home/RegonApi
Załóż konto i złóż wniosek o dostęp do API REGON
GUS rozpatrzy wniosek i prześle klucz API na podany e-mail
W zakładce GUS API odznacz "Tryb testowy" i wpisz otrzymany klucz
4. Tworzenie partnera z GUS (zalecane)
Przejdź do Kontakty → Utwórz z GUS
W oknie dialogowym wpisz 10-cyfrowy numer NIP kontrahenta
System pobierze dane z GUS i automatycznie utworzy nowego partnera z wypełnionymi polami.
5. Aktualizacja istniejącego partnera
Jeśli partner już istnieje i chcesz zaktualizować jego dane z GUS:
Przejdź do Kontakty → [wybierz partnera]
Upewnij się, że w polu VAT jest wpisany numer NIP
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 |
Please log in to comment on this module