Skip to Content

GUS REGON Integration

by
Odoo
v 18.0 Third Party 2
Download for v 18.0 Deploy on Odoo.sh
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Contacts (contacts)
• Discuss (mail)
Lines of code 566
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 566
Technical Name odoo-pl-gus-integration
LicenseLGPL-3
Websitehttps://erpgo.pl

🇵🇱 GUS REGON Integration

Seamless integration with Polish Central Statistical Office database for automatic company data import

Transform Your Polish Business Data Management

The GUS REGON Integration module provides seamless integration with the official Polish Central Statistical Office (GUS) REGON database through the BIR 2019 API. Instantly fetch and validate complete company information directly into your Odoo partner records with a single click.

💡 Perfect For:

Polish businesses using Odoo who need to maintain accurate, up-to-date company information in compliance with Polish regulations and want to eliminate manual data entry errors.

Key Features

🔄 Automatic Data Import

Fetch complete company information from the official Polish business registry with a single click. No more manual data entry!

✅ NIP Validation

Real-time validation and verification of Polish VAT numbers (NIP) ensuring data accuracy and compliance.

🏢 Complete Company Data

Automatically retrieve company name, addresses, contact information, legal form, and registration details.

🏷️ PKD Code Mapping

Automatically map business activity codes (PKD) to partner tags. Main PKD code plus up to 4 additional codes imported and tagged.

⚡ Real-time Sync

Direct connection to GUS BIR 2019 API ensures you always have the latest official data from the Polish registry.

🔒 Secure & Reliable

SSL certificate verification, encrypted API key storage, and proper session management ensure secure operations.

What Gets Imported

  • Company Name - Official registered business name
  • Full Address - Street, postal code, city, and region
  • Contact Information - Phone, email, and website (if available)
  • REGON Number - 9 or 14-digit statistical identification number
  • NIP/VAT Number - Polish tax identification number
  • Legal Form - Type of business entity (LLC, individual entrepreneur, etc.)
  • PKD Codes - Business activity classification codes with descriptions
  • Registration Date - Official company registration date

How It Works

  1. Configure Once
    Enter your GUS API key in Settings → GUS Integration. Obtain a free API key from stat.gov.pl. Validate the connection to ensure everything is set up correctly.
  2. Enter NIP Number
    When creating or editing a partner (contact), simply enter the Polish VAT number (NIP) in the Tax ID field.
  3. Click Fill from GUS
    Click the "Fill from GUS" button on the partner form. The system validates the NIP and connects to the official GUS database.
  4. Data Imported Instantly
    All available company information is automatically filled in, including name, address, contact details, and PKD activity codes as tags.

PKD Business Activity Codes

The module intelligently handles Polish Classification of Activities (PKD) codes:

  • Main PKD Code stored on partner record with full description
  • Up to 5 PKD codes imported (main + 4 additional activities)
  • Automatic Tag Creation in format "PKD: [code] - [description]"
  • Smart Tag Reuse to avoid duplicates across partners
  • Easy Filtering by business activity using standard tag filters

Example PKD Tags:

PKD: 6210B - IT Consulting PKD: 6201Z - Software Development PKD: 6202Z - IT Support Services

Configuration Guide

Prerequisites

Required API Access:

  • Free GUS API User Key from stat.gov.pl
  • Internet connection for API access
  • BIR 1.1 API endpoint access (production or test)

Obtaining Your API Key

  1. Visit the BIR 1 User Panel at stat.gov.pl
  2. Register for a free account with your email address
  3. Request an API key for the BIR 2019 service
  4. Copy your User Key for Odoo configuration

Odoo Configuration

  1. Go to Settings → GUS Integration
  2. Enter your GUS User Key (required)
  3. Configure WSDL URL (defaults to production BIR 1.1)
  4. Set SSL Verification (enabled by default, recommended)
  5. Click Validate Connection to test API access
  6. Save the configuration

🔧 Advanced Options:

Custom API Endpoints:

  • Production (default): https://wyszukiwarkaregon.stat.gov.pl/wsBIR/wsdl/UslugaBIRzewnPubl-ver11-prod.wsdl
  • Test Environment: https://wyszukiwarkaregontest.stat.gov.pl/wsBIR/wsdl/UslugaBIRzewnPubl-ver11-test.wsdl

SSL Certificate Verification: Keep enabled for production (recommended). Disable only if you trust the endpoint and encounter certificate issues.

Security & Compliance

  • SSL Certificate Verification enabled by default for secure API communication
  • Encrypted API Key Storage using Odoo's password field protection
  • Proper Session Management with automatic login/logout and cleanup
  • Comprehensive Error Handling with specific exception types
  • Detailed Logging without exposing sensitive credentials
  • Official GUS Integration using BIR 1.1 API standards

Technical Specifications

Module Details:

  • Version: 18.0.1.3.0
  • License: LGPL-3
  • Category: Tools
  • Dependencies: base, contacts
  • Python Dependencies: zeep (SOAP client), stdnum (NIP validation)
  • API Standard: GUS BIR 1.1 (UslugaBIRzewnPubl-ver11)
  • Supported Odoo Versions: 18.0

Benefits for Your Business

⏱️ Save Time

Eliminate manual data entry. Import complete company information in seconds instead of minutes.

🎯 Improve Accuracy

Ensure data accuracy by fetching information directly from the official Polish government registry.

📋 Stay Compliant

Maintain up-to-date company information in compliance with Polish business regulations.

🚀 Boost Productivity

Free your team from tedious data entry tasks and focus on more valuable work.

🔍 Better Insights

Utilize PKD tags to segment and analyze partners by business activity.

💪 Reliable Integration

Built with enterprise-grade error handling and security best practices.

Ready to Streamline Your Polish Business Data?

Install GUS REGON Integration today and start importing accurate company data with a single click!

Support & Contact

Developed by ERPGO

We specialize in Odoo implementations and customizations for Polish businesses.

Website: erpgo.pl
Support: contact@erpgo.pl

Need help with installation, configuration, or custom features? Contact our expert team for professional Odoo support.

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.