Szczegóły techniczne dla osoby, która będzie odbierać wdrożenie.
Skąd biorą się dane
Punktem startu jest API REGON GUS (BIR1.2), usługa SOAP, która po NIP, REGON lub numerze KRS zwraca nazwę, adres siedziby, formę prawną, REGON i kody PKD. Klucz do API REGON wydaje GUS bezpłatnie na wniosek wysłany e-mailem. GUS jest pierwszy, bo zna wszystkie typy podmiotów i mówi, gdzie szukać dalej. Dla spółek integracja bierze z raportu numer KRS i pobiera aktualny odpis z otwartego API KRS (api-krs.ms.gov.pl): zarząd i sposób reprezentacji, kapitał zakładowy, datę wpisu. Dla jednoosobowych działalności pyta API CEIDG z hurtowni danych biznes.gov.pl, które pokazuje m.in. status działalności i datę zawieszenia. Dostęp do API CEIDG wymaga bezpłatnej rejestracji w hurtowni. API KRS i API Białej listy działają bez klucza.
Na koniec NIP idzie do wykazu podatników VAT (Biała lista, wl-api.mf.gov.pl). Stamtąd wraca status VAT i zgłoszone rachunki bankowe, co przydaje się działowi finansów przed pierwszym przelewem. Jak te dane wyglądają dla konkretnej firmy, pokazuje nasza darmowa wyszukiwarka po NIP.
Jak to wygląda w HubSpot
NIP, REGON, KRS, PKD i status VAT trafiają do właściwości firmy, które zakładam razem z grupą „Dane rejestrowe”. Integracja reaguje na utworzenie firmy lub zmianę NIP-u przez webhooki CRM API, więc handlowiec widzi dane kilka sekund po zapisaniu karty. Webhooki aplikacji nie wymagają planu z workflow. Na karcie firmy może też być przycisk „Pobierz z GUS” do ręcznego odświeżenia, a w planach z workflow osobna akcja do Twoich automatyzacji.
Właściwość NIP może wymagać unikalnych wartości. Dzięki temu HubSpot nie pozwoli założyć tej samej firmy drugi raz, co przy polskich firmach działa lepiej niż deduplikacja po domenie.
Limity i przypadki brzegowe
GUS wymaga logowania kluczem i sesji, a przy przekroczeniu limitów odrzuca zapytania, dlatego wszystko idzie przez kolejkę z ponowieniami. NIP jest sprawdzany sumą kontrolną, zanim poleci jakiekolwiek zapytanie. Osobno obsługuję firmy z kilkoma jednostkami lokalnymi, spółki cywilne (NIP spółki i NIP wspólników w CEIDG) oraz podmioty wykreślone, które GUS dalej zwraca, ale z datą zakończenia działalności.
Monitoring zmian
Uzupełnienie przy zakładaniu firmy to połowa pracy. Raz w tygodniu lub raz w miesiącu integracja przechodzi aktywnych klientów i porównuje dane z rejestrami. Gdy firma przestaje być czynnym podatnikiem VAT, wchodzi w likwidację lub zmienia adres, HubSpot dostaje nową wartość, a właściciel firmy w CRM zadanie do sprawdzenia.