Biała lista VAT
w Medusie
Weryfikacja polskiego NIP w białej liście Ministerstwa Finansów, numerów VAT UE w VIES oraz REGON-u i formy prawnej w rejestrze GUS – tam, gdzie prowadzisz sklep. Status VAT, konta bankowe do podzielonej płatności, lista kontrahentów z ponownymi sprawdzeniami, historia kontroli i podgląd formularza rejestracji.
Co dokładnie
robi ta integracja
-
Format decyduje o rejestrze
10-cyfrowy polski NIP idzie na białą listę (i do GUS, gdy jest klucz), numer wyglądający na VAT UE – do VIES. Błędne numery odpowiadają bez wywołania sieci.
-
Kontrahenci w jednym wierszu
Jeden wiersz na numer z najnowszą połączoną odpowiedzią, odświeżany ponownym sprawdzeniem. NIP łączy się z klientem, gdy sprawdzenie dotyczyło jego firmy.
-
Konta do podzielonej płatności
Konta bankowe z rejestru trzymamy per kontrahent, więc faktura może nieść konto, które potwierdza biała lista.
-
Historia jako ślad audytu
Każde sprawdzenie per rejestr zostaje w historii i nigdy się nie zmienia – kontrola ma do czego wrócić.
-
Formularz rejestracji sam się wypełnia
Publiczny, limitowany podgląd pobiera kartę firmy z NIP przed rejestracją, więc formularz sam wpisuje nazwę firmy.
-
Status firmy klienta
Zalogowany klient widzi i odświeża status własnego NIP przez API sklepu – weryfikacja kontrahenta dzieje się po jego stronie.
Jak pilnuje
Twoich danych
-
Świeżość z limitem
Odpowiedź jest ważna przez staleHours (domyślnie doba), panel oznacza nieświeżych kontrahentów, a ponowne sprawdzenie pyta rejestr na nowo.
-
Tryb demo nie wychodzi na zewnątrz
Sprawdzenia odpowiadają symulowanymi danymi rejestrów, z flagą demo. Włącza się tylko przez demo: true, nigdy przez brak klucza.
-
Podgląd limitowany
Publiczny podgląd rejestracji ma limit na adres, więc nie staje się darmowym punktem sprawdzania NIP-ów dla całego internetu.
Instalacja
w trzech krokach
Pełna lista opcji, zdarzeń i tras API jest w README paczki na GitHubie.
Wklej do Claude Code, Cursora albo innego asystenta AI w swoim projekcie Medusy: zainstaluje i skonfiguruje integrację, z zapisami wyłączonymi.
- 1 Zainstaluj paczkę z npm.
npm install @koda-plus/medusa-plugin-vat-whitelist - 2 Dopisz wtyczkę do medusa-config.ts.
plugins: [ { resolve: "@koda-plus/medusa-plugin-vat-whitelist", options: { // Everything is optional. staleHours: 24, // gusApiKey: process.env.GUS_API_KEY, // BIR 1.1, dla rejestru GUS // demo: process.env.WHITELIST_DEMO === "true", }, }, ] - 3 Uruchom migracje i otwórz integrację w panelu Medusy.
npx medusa db:migrate
Pracuje u naszych klientów
Zobacz realizacje
Pozostałe
integracje
- Allegro Oferty, zamówienia, stany i przesyłki
- BaseLinker Karty, stany, ceny i zamówienia w obie strony
- Subiekt nexo Zamówienia jako ZK, WZ i faktury z KSeF
- Fakturownia Faktury, korekty i KSeF dokładnie raz
- InPost Paczkomaty, kurier i pobranie na API ShipX
- OLX Ogłoszenia zgodne ze stanem sklepu
- Stripe Obrót, opłaty, spory i zdrowie konta
- Negocjacje Cena docelowa, kontroferta, akceptacja
- Kredyt kupiecki Limity, terminy i salda klientów
- Lojalność Punkty, drabinka nagród i historia
- Opakowania Sztuka, karton, paleta, minimum i krok
- Zgodność UE GPSR, RODO i Omnibus w jednym panelu
- E-maile Gotowe szablony po polsku i angielsku
- Zadania Zadania przy zamówieniach, produktach i klientach
Opowiedz nam o swoim projekcie,
resztę dopasujemy pod Ciebie
15 minut rozmowy wystarczy, abyśmy wiedzieli, czy pasujemy do Twojego projektu.
Zaczynamy od Twoich potrzeb, nie od gotowego rozwiązania.