Changeset 3400064
- Timestamp:
- 11/20/2025 10:12:38 PM (4 months ago)
- File:
-
- 1 edited
-
nip-finder/trunk/README.txt (modified) (1 diff)
Legend:
- Unmodified
- Added
- Removed
-
nip-finder/trunk/README.txt
r3306633 r3400064 2 2 Contributors: asmtechpl 3 3 Donate link: https://code-press.pl/ 4 Tags: e-commerce, woocommerce, shop, ecommerce, nip, gus4 Tags: woocommerce, nip, gus, b2b, faktura 5 5 Requires at least: 6.2 6 6 Tested up to: 6.8 7 7 Stable tag: 1.3.6 8 Requires PHP: 7.4 9 WC requires at least: 5.0 10 WC tested up to: 9.4 8 11 License: GPLv2 or later 9 12 License URI: http://www.gnu.org/licenses/gpl-2.0.html 10 13 11 Wtyczka automatycznie pobiera dane firmowe z GUS po numerze NIP podczas zakupu, przyspieszając proces składania zamówień dla firm. 14 Automatyczne dane firmowe z GUS do WooCommerce. Szybsze zamówienia B2B, zero błędów w fakturach! 12 15 13 16 == Description == 14 17 15 # Opis Wtyczki 16 17 **Wtyczka Automatycznego Pobierania Danych Firmowych z GUS** 18 19 W dzisiejszym szybkim tempie zakupów online, szczególnie w sektorze B2B, kluczowe jest skrócenie czasu realizacji zamówienia oraz minimalizacja ryzyka błędów przy wprowadzaniu danych. Nasza wtyczka została stworzona z myślą o firmach, które chcą usprawnić proces składania zamówień, automatyzując pobieranie niezbędnych informacji z Głównego Urzędu Statystycznego (GUS) na podstawie numeru NIP. 20 21 ## Jak to działa? 22 23 Podczas procesu składania zamówienia w Twoim sklepie internetowym, klient będący przedstawicielem firmy wpisuje numer NIP. Wtyczka automatycznie łączy się z bazą danych GUS, pobierając szczegółowe dane firmowe, takie jak: 24 25 - **Nazwa firmy** 26 - **Adres siedziby** 27 - **Status podatkowy** 28 - **Numer REGON** 29 - **I inne istotne informacje** 30 31 Dzięki temu dane te zostają uzupełnione w formularzu zakupowym bez konieczności ręcznego wprowadzania przez klienta. Efektem jest przyspieszenie procesu realizacji zamówień, zmniejszenie liczby błędów oraz poprawa doświadczenia użytkownika. 32 33 Korzyści dla Twojego sklepu 34 35 - **Oszczędność czasu:** Automatyczne pobieranie danych firmowych eliminuje potrzebę ręcznego wpisywania informacji, co znacząco skraca czas finalizacji zamówienia. 36 - **Dokładność danych:** Integracja z bazą GUS zapewnia, że pobrane informacje są aktualne i precyzyjne, co zmniejsza ryzyko błędów i pomyłek. 37 - **Lepsze doświadczenie klienta:** Uproszczony proces zamawiania sprawia, że zakupy stają się bardziej intuicyjne i przyjazne, co może prowadzić do wzrostu satysfakcji i lojalności klientów. 38 - **Wsparcie dla firm:** Wtyczka jest idealnym rozwiązaniem dla firm, które często dokonują zakupów hurtowych lub mają rozbudowane systemy zakupowe, umożliwiając im szybkie i bezproblemowe składanie zamówień. 39 40 Wtyczka automatycznie pobiera dane firmowe z GUS na podstawie numeru NIP, co pozwala na błyskawiczne uzupełnienie formularzy zamówień i usprawnienie procesu zakupowego. Dzięki intuicyjnej konfiguracji, elastyczności oraz wysokiemu poziomowi bezpieczeństwa, stanowi idealne narzędzie dla firm pragnących zwiększyć efektywność swoich procesów zakupowych i zminimalizować ryzyko błędów. 41 18 # Automatyczne dane firmowe z GUS dla WooCommerce 19 20 **Koniec z ręcznym przepisywaniem danych firmowych!** 21 22 Twoi klienci biznesowi tracą czas na wypełnianie formularzy? Nip Finder automatycznie pobiera aktualne dane z oficjalnego rejestru GUS - wystarczy wpisać NIP, a nazwa firmy, adres, REGON i status podatkowy uzupełniają się natychmiast. 23 24 ## ⚡ Dlaczego Nip Finder? 25 26 **Szybciej = Więcej sprzedaży** 27 Klienci finalizują zamówienia 3x szybciej. Mniej porzuconych koszyków, więcej konwersji. 28 29 **Zero błędów na fakturach** 30 Dane prosto z bazy GUS - zawsze aktualne, zawsze poprawne. Koniec z reklamacjami przez błędne dane. 31 32 **Lepsze doświadczenie zakupowe** 33 Prosty proces = zadowoleni klienci = więcej powtarzających się zamówień. 34 35 **Gotowe w 5 minut** 36 Instalujesz, wpisujesz klucz API i już działa. Bez kodowania, bez komplikacji. 37 38 ## 🎯 Jak to działa? 39 40 1. Klient wpisuje NIP w formularzu zamówienia 41 2. Wtyczka sprawdza dane w rejestrze GUS 42 3. Formularz wypełnia się automatycznie: 43 * Pełna nazwa firmy 44 * Dokładny adres siedziby 45 * Numer REGON 46 * Status VAT (czynny/zwolniony) 47 4. Klient zatwierdza i kończy zamówienie 48 49 Wszystko w ułamku sekundy, bez przeładowywania strony! 50 51 ## 💼 Idealne dla: 52 53 * **Sklepów B2B i hurtowni** - Twoi klienci docenią szybkość obsługi 54 * **Sprzedaży na fakturę** - Dane zawsze zgodne z rejestrem 55 * **Każdego sklepu WooCommerce** obsługującego firmy 56 57 ## ✨ Kluczowe funkcje 58 59 * ✓ Automatyczne pobieranie danych z bazy GUS 60 * ✓ Weryfikacja numeru NIP w czasie rzeczywistym 61 * ✓ Wsparcie dla wszystkich polskich firm (CEIDG i KRS) 62 * ✓ Możliwość ręcznej edycji pobranych danych 63 * ✓ Intuicyjny panel konfiguracji 64 * ✓ Zgodność z RODO 65 * ✓ Regularne aktualizacje 66 * ✓ Wsparcie techniczne po polsku 67 68 ## 🚀 Instalacja w 3 krokach 69 70 1. **Zainstaluj** wtyczkę jak każdą inną wtyczkę WordPress 71 2. **Aktywuj** i przejdź do ustawień Nip Finder 72 3. **Skonfiguruj** klucz API i gotowe! 73 74 Szczegółowa instrukcja dostępna w zakładce Installation. 75 76 ## 🔒 Bezpieczeństwo i prywatność 77 78 Wtyczka łączy się wyłącznie z oficjalnym API rejestru GUS przez bezpieczne połączenie HTTPS. Przesyłany jest tylko numer NIP - żadne inne dane osobowe. 79 80 **Używane API:** `https://api.gapc.pl` 81 **Przesyłane dane:** Tylko numer NIP wprowadzony przez użytkownika 82 **Więcej informacji:** 83 * [Regulamin usługi](https://nip-finder.pl/regulamin/) 84 * [Polityka prywatności](https://nip-finder.pl/polityka-prywatnosci/) 85 86 ## 💡 Pytania? Problemy? 87 88 Sprawdź sekcję FAQ poniżej lub skontaktuj się z nami przez formularz wsparcia. Odpowiadamy szybko i po polsku! 89 90 --- 91 92 **Oszczędzaj czas swoim klientom. Zwiększ konwersję. Wyeliminuj błędy.** 93 **Zainstaluj Nip Finder już dziś - to nic nie kosztuje!** 42 94 43 95 == Installation == 44 96 45 46 Instalacja oraz konfiguracja wtyczki jest prosta i intuicyjna: 47 48 1. **Instalacja:** Wystarczy pobrać wtyczkę z repozytorium, zainstalować ją w systemie CMS oraz aktywować. 49 2. **Konfiguracja:** W panelu administracyjnym znajdziesz dedykowaną sekcję, w której możesz ustawić parametry połączenia z bazą GUS, klucze API oraz inne opcje personalizacji. 50 3. **Personalizacja Formularza:** Dzięki elastycznemu kreatorowi formularzy możesz dostosować układ pól na stronie zamówienia, tak aby odpowiadały indywidualnym potrzebom Twojego biznesu. 97 ## Instalacja 98 99 **Metoda 1: Z panelu WordPress (zalecana)** 100 101 1. Przejdź do: WordPress Admin → Wtyczki → Dodaj nową 102 2. Wyszukaj "Nip Finder" 103 3. Kliknij "Instaluj teraz", a następnie "Aktywuj" 104 4. Gotowe! 105 106 **Metoda 2: Ręczna instalacja** 107 108 1. Pobierz wtyczkę z WordPress.org 109 2. Wgraj folder do katalogu `/wp-content/plugins/` 110 3. Aktywuj wtyczkę w panelu WordPress 111 4. Przejdź do konfiguracji 112 113 ## Konfiguracja 114 115 1. Po aktywacji przejdź do: **WooCommerce → Ustawienia → Nip Finder** 116 2. Wprowadź swój **klucz API** (otrzymasz go po rejestracji na nip-finder.pl) 117 3. Dostosuj ustawienia do swoich potrzeb: 118 * Wybierz, które pola mają się automatycznie wypełniać 119 * Ustaw komunikaty dla użytkowników 120 * Zdecyduj, czy dane mogą być edytowane ręcznie 121 4. Zapisz zmiany i przetestuj w koszyku! 122 123 **Pierwsze uruchomienie?** Wszystko działa od razu po wprowadzeniu klucza API! 51 124 52 125 == Frequently Asked Questions == 53 126 54 = Czy wtyczka obsługuje numery NIP zagranicznych firm? = 55 Nie, wtyczka jest przeznaczona do pobierania danych z polskiej bazy GUS i obsługuje wyłącznie numery NIP polskich przedsiębiorstw. 56 57 = Jak często aktualizowane są dane w bazie GUS? = 58 GUS aktualizuje swoje dane regularnie, jednak częstotliwość aktualizacji może różnić się w zależności od rodzaju informacji. Wtyczka pobiera dane w czasie rzeczywistym, więc zawsze otrzymujesz najświeższe dostępne informacje. 59 60 = Czy mogę ręcznie edytować dane pobrane z GUS? = 61 Tak, po automatycznym pobraniu danych z GUS masz możliwość ich ręcznej edycji przed finalizacją zamówienia. 62 63 = Czy wtyczka jest płatna? = 64 Podstawowa wersja wtyczki jest dostępna za darmo. Istnieje jednak możliwość zakupu wersji premium z dodatkowymi funkcjonalnościami. Szczegóły znajdziesz na stronie wtyczki. 65 66 = Jak skontaktować się z pomocą techniczną w przypadku problemów? = 67 W przypadku pytań lub problemów związanych z działaniem wtyczki, prosimy o kontakt poprzez formularz wsparcia dostępny na naszej stronie internetowej lub bezpośrednio z poziomu panelu administracyjnego WordPressa w sekcji ustawień wtyczki. 127 = Czy wtyczka jest darmowa? = 128 129 Tak! Podstawowa wersja jest całkowicie darmowa i oferuje pełną funkcjonalność. Planujemy wersję premium z dodatkowymi funkcjami, ale standardowe pobieranie danych z GUS pozostanie bezpłatne. 130 131 = Czy potrzebuję klucza API? = 132 133 Tak, aby korzystać z usługi, potrzebujesz klucza API. Rejestracja na nip-finder.pl jest prosta i zajmuje 2 minuty. 134 135 = Czy wtyczka obsługuje zagraniczne firmy? = 136 137 Nie, wtyczka działa wyłącznie z polskim rejestrem GUS i obsługuje tylko polskie numery NIP. Dla firm zagranicznych formularz pozostaje standardowy. 138 139 = Jak często aktualizowane są dane z GUS? = 140 141 Wtyczka pobiera dane w czasie rzeczywistym bezpośrednio z aktualnej bazy GUS. Zawsze otrzymujesz najświeższe dostępne informacje. 142 143 = Czy mogę edytować automatycznie pobrane dane? = 144 145 Tak! Po automatycznym uzupełnieniu klient (lub administrator) może ręcznie poprawić dowolne pole przed finalizacją zamówienia. 146 147 = Czy wtyczka działa z moim motywem? = 148 149 Tak, Nip Finder integruje się standardowo z WooCommerce, więc działa z każdym motywem zgodnym z WooCommerce. 150 151 = Co jeśli firma nie znajduje się w bazie GUS? = 152 153 W takim przypadku wtyczka wyświetli odpowiedni komunikat, a klient będzie musiał wypełnić formularz ręcznie. 154 155 = Czy wtyczka spowalnia stronę? = 156 157 Nie! Zapytania do API są asynchroniczne i nie blokują ładowania strony. Użytkownik nie zauważy żadnego spowolnienia. 158 159 = Jak skontaktować się z pomocą techniczną? = 160 161 Możesz: 162 * Użyć formularza wsparcia na nip-finder.pl 163 * Napisać na forum WordPress.org 164 * Skontaktować się przez panel administracyjny wtyczki 165 166 Odpowiadamy zazwyczaj w ciągu 24 godzin (dni robocze). 167 168 = Czy dane są bezpieczne? = 169 170 Tak! Wtyczka przesyła tylko numer NIP do oficjalnego API. Nie przechowujemy żadnych danych osobowych. Wszystko zgodne z RODO. 68 171 69 172 == Screenshots == 70 173 174 1. Panel konfiguracji wtyczki - prosty i intuicyjny 175 2. Automatyczne wypełnianie danych po wpisaniu NIP 176 3. Formularz zamówienia z aktywną wtyczką 71 177 72 178 == Changelog == 73 179 180 = 1.3.6 = 181 * Aktualna stabilna wersja 182 * Pełna kompatybilność z WordPress 6.8 183 * Optymalizacja wydajności 184 185 = Planowane funkcje = 186 * Wsparcie dla różnych formatów NIP 187 * Zaawansowana walidacja danych 188 * Integracja z dodatkowymi bramkami płatności 189 190 == Upgrade Notice == 191 192 = 1.3.6 = 193 Zalecana aktualizacja - pełna zgodność z najnowszą wersją WordPress i WooCommerce. 74 194 75 195 == Usługi zewnętrzne == 76 196 77 Ta wtyczka łączy się z zewnętrznym API, aby pobierać dane firmowe z GUS na podstawie numeru NIP podanego przez użytkownika podczas składania zamówienia. 78 79 - **Opis usługi:** Wtyczka automatycznie pobiera aktualne dane firmowe, takie jak nazwa firmy, adres siedziby, status podatkowy, numer REGON oraz inne istotne informacje, dzięki integracji z serwisem GUS. 80 - **Przesyłane dane:** Podczas procesu składania zamówienia wysyłany jest numer NIP użytkownika do API dostępnego pod adresem `https://api.gapc.pl`. W przypadku braku zgody lub dostępności danych, stosowany jest wcześniej zdefiniowany numer domyślny. 81 - **Warunki korzystania:** Korzystając z tej wtyczki, akceptujesz przesyłanie wskazanych danych do serwisu zewnętrznego. Aby zapoznać się z regulaminami usługi, odwiedź [Regulamin usługi](https://nip-finder.pl/regulamin/) oraz [Politykę prywatności](https://nip-finder.pl/polityka-prywatnosci/). 82 *Uwaga:* Informacja o korzystaniu z usług zewnętrznych została podana, aby zapewnić pełną przejrzystość procesu oraz zgodność z obowiązującymi przepisami o ochronie danych osobowych. 83 197 **Ważna informacja o prywatności i usługach zewnętrznych:** 198 199 Ta wtyczka komunikuje się z zewnętrznym API w celu pobrania danych firmowych z rejestru GUS. 200 201 **Szczegóły integracji:** 202 203 * **Adres API:** `https://api.gapc.pl` 204 * **Kiedy następuje połączenie:** Tylko gdy użytkownik wpisze numer NIP i kliknie przycisk wyszukiwania 205 * **Jakie dane są wysyłane:** Wyłącznie numer NIP wprowadzony przez użytkownika 206 * **Jakie dane są odbierane:** Publiczne dane firmowe z rejestru GUS (nazwa, adres, REGON, status VAT) 207 * **Przechowywanie danych:** Wtyczka nie przechowuje pobranych danych na serwerze 208 209 **Dokumenty prawne:** 210 211 * [Regulamin usługi API](https://nip-finder.pl/regulamin/) 212 * [Polityka prywatności](https://nip-finder.pl/polityka-prywatnosci/) 213 214 Korzystając z tej wtyczki, akceptujesz przesyłanie numeru NIP do wskazanej usługi zewnętrznej w celu weryfikacji i pobrania danych firmowych. Wszystkie operacje są zgodne z RODO i polskim prawem o ochronie danych osobowych.
Note: See TracChangeset
for help on using the changeset viewer.