| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Contacts (contacts)
• Discuss (mail) |
| Lines of code | 572 |
| Technical Name |
odoo-pl-gus-integration |
| License | LGPL-3 |
| Website | https://erpgo.pl |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Contacts (contacts)
• Discuss (mail) |
| Lines of code | 572 |
| Technical Name |
odoo-pl-gus-integration |
| License | LGPL-3 |
| Website | https://erpgo.pl |
🇵🇱 GUS REGON Integration
Pull Polish company data from the official REGON database
Stop typing company data from KRS printouts
If you run a business in Poland, you know the drill—manually typing company names, addresses, and NIP numbers from registration documents. We built this module to connect directly to the official GUS (Główny Urząd Statystyczny) database via their BIR API so you can fetch all that information automatically.
Enter a NIP number, click a button, and we pull everything—company details, addresses, contact info, and even PKD activity codes as tags. Data comes straight from the government registry, so you know it's current.
What we built for you
🔍 Search by NIP
Type in a Polish VAT number and pull the complete company record. Faster than opening stat.gov.pl in another browser tab.
📋 Full company profiles
Gets the company name, legal address, contact details, legal form, and registration info—everything GUS has on file.
🏷️ PKD code tagging
Imports up to 5 PKD business activity codes and creates tags automatically. Makes it easy to filter partners by industry later.
🔄 Real-time sync
Connects directly to the live GUS database. If a company updates their address with the government, you can re-fetch and update your records.
What gets imported
- Company name (official registered name)
- REGON number (9 or 14 digits)
- NIP/VAT number
- Full address (street, postal code, city, voivodeship)
- Contact info (phone, email, website if available)
- Legal form (sp. z o.o., jednoosobowa działalność, etc.)
- PKD codes with descriptions (main + up to 4 additional)
- Registration date
Setup
You'll need a GUS API key first. It's free but requires registration:
🔑 1. Get an API key
Go to the BIR 1 User Panel at stat.gov.pl and register with your email. Request a key for the BIR 2019 service.
⚙️ 2. Add it to Odoo
In Odoo, go to Settings → General Settings → GUS Integration section. Paste your User Key into the field.
✓ 3. Test connection
Click "Validate Connection" to make sure everything works. If it connects, you're done with setup.
How it works
- Open a partner record — Go to Contacts and create or open a company. Make sure "Is a Company" is checked.
- Enter the NIP — Type the Polish VAT number in the Tax ID field.
- Click "Fill from GUS" — You'll see this button on the partner form. Click it and the module queries the GUS database.
- Data fills in — Company name, address, REGON, contact details all populate automatically. PKD codes show up as tags.
PKD codes and tags
The module handles Polish Classification of Activities (PKD) codes like this:
- Main PKD code is stored on the partner with its full description
- Up to 5 total codes get imported (main + 4 secondary activities)
- Each code creates a tag in format "PKD: 6201Z - Software Development"
- Tags get reused across partners—no duplicates
- You can filter contacts by PKD tag using standard tag filters
For example, an IT consulting company might get tagged with "PKD: 6210B - IT Consulting" and "PKD: 6201Z - Software Development". Makes it easy to find all companies in a specific industry.
Why we think you'll love this
⏱️ Saves time
One click instead of copy-pasting from KRS printouts or stat.gov.pl searches. Probably saves 2-3 minutes per new partner.
✓ Fewer mistakes
Data comes from the official source. No more wrong postal codes or outdated addresses because someone misread a document.
📅 Stay current
When a partner moves or changes their legal name, you can update your records to match what's in the government database.
🏢 Industry tagging
PKD codes import as tags automatically, so you can segment customers by business type without manual categorization.
Technical requirements
- Version: 18.0.1.4.0
- License: LGPL-3
- Depends on: base, contacts
- Python packages: zeep (SOAP client), stdnum (NIP validation)
- API: GUS BIR 1.1 (UslugaBIRzewnPubl-ver11)
- Credentials: Free API key from stat.gov.pl required
- Network: Needs internet to reach wyszukiwarkaregon.stat.gov.pl
Support
Built by ERPGO
erpgo.pl •
sales@erpgo.pl
Questions about setup, need help getting your API key, or want custom features? Get in touch.
Please log in to comment on this module