tpro/django-gusregon

GUS REGON Internet Database Client

django-gusregon

GUS (Główny Urząd Statystyczny) REGON Internet Database client which allows to get detailed information about company based on NIP, Regon or KRS number.

Quickstart

Install the package via pip:

pip install django-gusregon

Usage

from django import forms
from gusregon.fields import GUSCaptchaField

class MyForm(forms.Form):
    nip = forms.CharField()
    gus = GUSCaptchaField(label='Captcha')

...

form = MyForm(data=request.POST or None)
if form.is_valid():
    gus = form.cleaned_data.get('gus')
    company_details = gus.search(form.cleaned_data.get('nip'))

API

from gusregon.gus import GUS

gus = GUS()
sid = gus.login()
captcha = gus.get_captcha()
'<img src="data:image/jpg;base64,%s" alt="captcha" />' % captcha

gus = GUS(sid)
if gus.check_captcha('<captcha_code>'):
    gus.search(nip='..')

For more information, see GUS api class.