| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 979 |
| Technical Name |
xpt_pl_partners |
| License | LGPL-3 |
| Website | https://xpedyt.com |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 979 |
| Technical Name |
xpt_pl_partners |
| License | LGPL-3 |
| Website | https://xpedyt.com |
Weryfikacja polskich kontrahentów
GUS BIR1, CEIDG, Biała Lista MF i VIES — weryfikacja wprost z Odoo, status widoczny już na liście kontrahentów.
Uzupełniaj dane firm z oficjalnych polskich rejestrów i weryfikuj status podatnika VAT jednym kliknięciem — bez opuszczania karty kontrahenta w Odoo. Statusy Białej Listy i VIES widoczne są od razu na liście, z możliwością szybkiego filtrowania po wyniku weryfikacji.
GUS BIR1 — uzupełnianie danych z rejestru
Wpisz NIP i kliknij Pobierz z GUS. Moduł odpytuje interfejs API GUS BIR1 i automatycznie uzupełnia:
- Nazwa firmy
- Ulica, miasto i kod pocztowy
- REGON
- Numer NIP (znormalizowany z odpowiedzi GUS)
- Kraj (automatycznie ustawiany na Polskę)
- Data ostatniego sprawdzenia GUS
Obsługiwane tryby: produkcyjny i testowy (sandbox). Klucz API GUS konfiguruje się w Ustawienia → Techniczne → PL Partners.
GUS — Główny Urząd Statystyczny
NIP → nazwa, adres, REGON, kraj
CEIDG — dane jednoosobowych działalności
CEIDG — Centralna Ewidencja Działalności Gospodarczej
NIP → dane JDG: firma, adres, status, REGON
Dla kontrahentów prowadzących jednoosobową działalność gospodarczą kliknij Pobierz z CEIDG:
- Nazwa handlowa lub imię i nazwisko
- Adres działalności
- Numer REGON
- Status: Aktywny / Zawieszony / Wykreślony
- Data ostatniego sprawdzenia CEIDG
Uzupełnia dane JDG, których GUS BIR1 nie obejmuje w pełni. Wymaga tokenu API z api.biznes.gov.pl.
MF Biała Lista — weryfikacja VAT
Kliknij Sprawdź Białą Listę, aby odpytać rejestr podatników VAT Ministerstwa Finansów w czasie rzeczywistym:
- Status: Aktywny / Nieaktywny / Nie znaleziono
- Lista rachunków bankowych zarejestrowanych w MF
- Automatyczne porównanie: ostrzeżenie, gdy rachunek zapisany w Odoo nie figuruje na Białej Liście
- Data ostatniego sprawdzenia
Pomaga zachować zgodność z przepisami o MPP (split payment) — zawsze płać na rachunek z Białej Listy.
Ministerstwo Finansów — Biała Lista
Aktywny podatnik VAT + zarejestrowane rachunki bankowe
VIES UE — walidacja numerów VAT
System VIES UE
Walidacja VAT dla wszystkich 27 krajów UE
Dla kontrahentów z krajów UE kliknij Sprawdź VIES, aby zwalidować numer VAT przez oficjalne API VIES:
- Status Ważny / Nieważny dla wszystkich 27 krajów UE
- Nazwa firmy zwrócona z systemu VIES (jeśli dostępna)
- Data ostatniego sprawdzenia zapisana na kontrahencie
Przycisk VIES jest automatycznie ukrywany dla krajów spoza UE — wyświetlany tylko tam, gdzie ma zastosowanie.
Automatyczna weryfikacja — harmonogram cron
Moduł zawiera wbudowany harmonogram automatycznej weryfikacji:
- Automatyczne sprawdzanie Białej Listy i VIES dla wszystkich kontrahentów
- Cykl konfigurowalny: Wyłączony / Codziennie / Tygodniowo / Miesięcznie
- Logi chatter zapisywane tylko przy zmianie statusu — bez zaśmiecania historii
- Błędy API zapisywane jako status „Błąd" — wpis w historii tylko przy zmianie
Interwał konfiguruje się w Ustawienia → Techniczne → PL Partners.
Automatyczna weryfikacja
Biała Lista + VIES · logi chatter przy zmianie statusu
Statusy w liście i filtry wyszukiwarki
Wyniki weryfikacji widoczne są bez wchodzenia w rekord:
- Kolumny Biała Lista i VIES widoczne domyślnie w liście kontrahentów
- Kolumna CEIDG dostępna do włączenia przez ikonkę kolumn
- Statusy wyświetlane jako kolorowe odznaki (badge)
- Szybkie filtry w wyszukiwarce: Biała lista: Aktywny / Nieaktywny / Nie sprawdzono i VIES: Prawidłowy / Nieprawidłowy / Nie sprawdzono
- Każdy filtr automatycznie zawęża wyniki do firm — kontakty indywidualne są ukrywane
Status widoczny na liście
Kolorowe odznaki · filtry · tylko firmy
Wbudowana walidacja NIP
Przed każdym zapytaniem do zewnętrznego API moduł weryfikuje NIP lokalnie zgodnie z oficjalnym algorytmem sumy kontrolnej. Błędne numery są odrzucane natychmiast — bez zbędnych zapytań do API.
Konfiguracja
Przejdź do Ustawienia → Techniczne → PL Partners, aby wprowadzić klucze API dla GUS BIR1 i CEIDG, przełączyć tryb testowy GUS oraz ustawić interwał automatycznej weryfikacji. Biała Lista MF i VIES nie wymagają klucza API.
| Usługa | Klucz API | Tryb sandbox |
|---|---|---|
| GUS BIR1 | ✅ Wymagany | ✅ Dostępny |
| CEIDG | ✅ Wymagany | ❌ Niepotrzebny |
| MF Biała Lista | ❌ Nie | ❌ Niepotrzebny |
| VIES UE | ❌ Nie | ❌ Niepotrzebny |
English description below · Opis po angielsku poniżej
Polish Partner Verification
GUS BIR1, CEIDG, MF VAT Whitelist, and EU VIES — verification built into Odoo, status visible directly in the partner list.
Automatically fill in partner data from official Polish registries and instantly verify whether your counterparty is a registered, active VAT taxpayer — all without leaving the Odoo contact form. Whitelist and VIES statuses are visible directly in the partner list, with quick search filters to find verified or unverified companies in seconds.
GUS BIR1 — Auto-fill from the Official Registry
Enter a NIP number and click Fetch from GUS. The module calls the Polish Central Statistical Office (GUS) BIR1 API and automatically populates:
- Company name
- Street, city, and ZIP code
- REGON number
- VAT/NIP number (normalised from GUS response)
- Country (automatically set to Poland)
- Date of last GUS check
Both production and sandbox (test) modes are supported. Configure your GUS API key in Settings → Technical → PL Partners.
GUS Central Statistical Office
NIP → name, address, REGON, country
CEIDG — Sole Proprietor Lookup
CEIDG Business Registry
NIP → sole trader name, address, status, REGON
For partners who are sole proprietors (JDG), click Fetch from CEIDG to query the Central Business Activity Register:
- Trade name, or first and last name if no trade name
- Business address
- REGON number
- CEIDG status: Active / Suspended / Closed
- Date of last CEIDG check
Covers sole traders (JDG) that GUS BIR1 does not fully represent. Requires an API token from api.biznes.gov.pl.
MF Biała Lista — VAT Whitelist Verification
Click Check Whitelist to query the Ministry of Finance VAT taxpayer registry in real time:
- Active / Inactive / Not found status
- List of bank accounts registered with the MF
- Automatic cross-check: warns you if any bank account saved in Odoo is not on the whitelist
- Date of last whitelist check
Helps you stay compliant with Polish split-payment (MPP) regulations — always pay to a whitelisted account.
Ministry of Finance — Biała Lista
Active VAT taxpayer + registered bank accounts
EU VIES — European VAT Number Validation
EU VIES System
VAT validation for all 27 EU member states
For partners from any EU country, click Check VIES to validate the VAT number via the official EU VIES REST API:
- Valid / Invalid status for all 27 EU member states
- Registered company name returned from VIES (when available)
- Date of last VIES check stored on the partner
The VIES button is automatically hidden for non-EU countries — only shown when relevant.
Automatic Re-verification — Scheduled Cron
A built-in scheduled job keeps your partner statuses up to date automatically:
- Re-checks VAT Whitelist and VIES for all relevant partners
- Configurable interval: Disabled / Daily / Weekly / Monthly
- Chatter notes written only on status change — no noise on every run
- API errors written as "Error" status — chatter note only when status changes
Configure the interval in Settings → Technical → PL Partners → Re-check Interval.
Automatic Re-verification
Whitelist + VIES · chatter on status change only
Status in the List View & Search Filters
Verification results are visible without opening each record:
- Whitelist and VIES status columns visible by default in the partner list
- CEIDG column available via the column picker
- Statuses displayed as coloured badge widgets
- Quick search filters: Whitelist: Active / Inactive / Not checked and VIES: Valid / Invalid / Not checked
- Every filter automatically restricts results to companies — individual contacts are excluded
Status Visible in the List
Coloured badges · filters · companies only
Built-in NIP Checksum Validation
Before any external API call, the module validates the NIP locally using the official Polish checksum algorithm. Invalid NIP numbers are rejected immediately — no unnecessary API requests.
Easy Configuration
Go to Settings → Technical → PL Partners to enter your GUS BIR1 and CEIDG API keys, toggle GUS sandbox (test) mode, and set the automatic re-verification interval. The MF Whitelist and VIES require no API key — they use publicly available REST endpoints.
| Service | API Key required | Sandbox mode |
|---|---|---|
| GUS BIR1 | ✅ Yes | ✅ Available |
| CEIDG | ✅ Yes | ❌ Not needed |
| MF Biała Lista | ❌ No | ❌ Not needed |
| EU VIES | ❌ No | ❌ Not needed |
Requirements
- Odoo 19.0 Community or Enterprise
- GUS BIR1 API key — obtain at api.stat.gov.pl
- CEIDG API token — register at api.biznes.gov.pl
- Internet access for external API calls (GUS, CEIDG, MF, VIES)
Developed by Xpedyt · Licensed under LGPL-3
Please log in to comment on this module