Skip to Content
Odoo Menu
  • Sign in
  • Try it free
  • Apps
    Finance
    • Accounting
    • Invoicing
    • Expenses
    • Spreadsheet (BI)
    • Documents
    • Sign
    Sales
    • CRM
    • Sales
    • POS Shop
    • POS Restaurant
    • Subscriptions
    • Rental
    Websites
    • Website Builder
    • eCommerce
    • Blog
    • Forum
    • Live Chat
    • eLearning
    Supply Chain
    • Inventory
    • Manufacturing
    • PLM
    • Purchase
    • Maintenance
    • Quality
    Human Resources
    • Employees
    • Recruitment
    • Time Off
    • Appraisals
    • Referrals
    • Fleet
    Marketing
    • Social Marketing
    • Email Marketing
    • SMS Marketing
    • Events
    • Marketing Automation
    • Surveys
    Services
    • Project
    • Timesheets
    • Field Service
    • Helpdesk
    • Planning
    • Appointments
    Productivity
    • Discuss
    • Approvals
    • IoT
    • VoIP
    • Knowledge
    • WhatsApp
    Third party apps Odoo Studio Odoo Cloud Platform
  • Industries
    Retail
    • Book Store
    • Clothing Store
    • Furniture Store
    • Grocery Store
    • Hardware Store
    • Toy Store
    Food & Hospitality
    • Bar and Pub
    • Restaurant
    • Fast Food
    • Guest House
    • Beverage Distributor
    • Hotel
    Real Estate
    • Real Estate Agency
    • Architecture Firm
    • Construction
    • Estate Management
    • Gardening
    • Property Owner Association
    Consulting
    • Accounting Firm
    • Odoo Partner
    • Marketing Agency
    • Law firm
    • Talent Acquisition
    • Audit & Certification
    Manufacturing
    • Textile
    • Metal
    • Furnitures
    • Food
    • Brewery
    • Corporate Gifts
    Health & Fitness
    • Sports Club
    • Eyewear Store
    • Fitness Center
    • Wellness Practitioners
    • Pharmacy
    • Hair Salon
    Trades
    • Handyman
    • IT Hardware & Support
    • Solar Energy Systems
    • Shoe Maker
    • Cleaning Services
    • HVAC Services
    Others
    • Nonprofit Organization
    • Environmental Agency
    • Billboard Rental
    • Photography
    • Bike Leasing
    • Software Reseller
    Browse all Industries
  • Community
    Learn
    • Tutorials
    • Documentation
    • Certifications
    • Training
    • Blog
    • Podcast
    Empower Education
    • Education Program
    • Scale Up! Business Game
    • Visit Odoo
    Get the Software
    • Download
    • Compare Editions
    • Releases
    Collaborate
    • Github
    • Forum
    • Events
    • Translations
    • Become a Partner
    • Services for Partners
    • Register your Accounting Firm
    Get Services
    • Find a Partner
    • Find an Accountant
      • Get a Tailored Demo
    • Implementation Services
    • Customer References
    • Support
    • Upgrades
    Github Youtube Twitter Linkedin Instagram Facebook Spotify
    +32 2 290 34 90
    • Get a Tailored Demo
  • Pricing
  • Help
  1. APPS
  2. Extra Tools
  3. GUS REGON Integration v 18.0
  4. Sales Conditions FAQ

GUS REGON Integration

by ERPGO https://erpgo.pl
Odoo
v 18.0 Third Party 8
Download for v 18.0 Deploy on Odoo.sh
Apps purchases are linked to your Odoo account, please sign in or sign up first.
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Contacts (contacts)
• Discuss (mail)
Lines of code 572
Technical Name odoo-pl-gus-integration
LicenseLGPL-3
Websitehttps://erpgo.pl
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Contacts (contacts)
• Discuss (mail)
Lines of code 572
Technical Name odoo-pl-gus-integration
LicenseLGPL-3
Websitehttps://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

  1. Open a partner record — Go to Contacts and create or open a company. Make sure "Is a Company" is checked.
  2. Enter the NIP — Type the Polish VAT number in the Tax ID field.
  3. Click "Fill from GUS" — You'll see this button on the partner form. Click it and the module queries the GUS database.
  4. 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

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.
Please choose a rating from 1 to 5 for this module.
Community
  • Tutorials
  • Documentation
  • Forum
Open Source
  • Download
  • Github
  • Runbot
  • Translations
Services
  • Odoo.sh Hosting
  • Support
  • Upgrade
  • Custom Developments
  • Education
  • Find an Accountant
  • Find a Partner
  • Become a Partner
About us
  • Our company
  • Brand Assets
  • Contact us
  • Jobs
  • Events
  • Podcast
  • Blog
  • Customers
  • Legal • Privacy
  • Security

Odoo is a suite of open source business apps that cover all your company needs: CRM, eCommerce, accounting, inventory, point of sale, project management, etc.

Odoo's unique value proposition is to be at the same time very easy to use and fully integrated.

Website made with