| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Contacts (contacts)
• Discuss (mail) |
| Technical Name |
odoo-pl-gus-integration |
| License | OPL-1 |
| Website | https://erpgo.pl |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Contacts (contacts)
• Discuss (mail) |
| Technical Name |
odoo-pl-gus-integration |
| License | OPL-1 |
| 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.
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module