VIES w fakturowaniu — integracja z systemami sprzedaży

Nowoczesne fakturowanie wymaga integracji z VIES — by faktura WDT była wystawiana tylko dla aktywnych kontrahentów, z pełnym dowodem weryfikacji.

Dlaczego integrować VIES z fakturowaniem

Ręczna weryfikacja przed każdą fakturą to źródło błędów ludzkich — zapominanie, literówki, brak zapisu identyfikatora. Integracja automatyzuje to: gdy księgowa wybiera kontrahenta z bazy i klika „WDT”, system w tle wykonuje zapytanie do VIES, zwraca wynik na ekran w 1–3 sekundy i automatycznie zapisuje identyfikator konsultacji do bazy faktury. Jeśli numer jest nieaktywny — system pokazuje ostrzeżenie i blokuje wystawienie faktury z 0% VAT. To eliminuje cały gatunek błędów księgowych.

Architektura typowej integracji

Typowy przepływ: użytkownik wybiera kontrahenta → moduł fakturowy wywołuje endpoint VIES (przez SDK lub bezpośrednio SOAP/REST) → wynik zwracany w polach: valid, name, address, consultationNumber → moduł zapisuje do bazy faktury w polu vies_check (JSON z pełnym wynikiem) → moduł wystawia fakturę z 0% VAT tylko jeśli valid=true → identyfikator konsultacji wyświetla się na fakturze jako adnotacja. To 7 kroków, zaimplementowanych raz, eliminuje błędy na zawsze.

Buforowanie wyników — kluczowe dla wydajności

Nie weryfikuj tego samego numeru wielokrotnie tego samego dnia — KE rekomenduje cache 24h. Implementacja: tabela vies_cache z kluczami (countryCode, vatNumber, requestDate), wartością (status, name, address, consultationNumber). Przy zapytaniu sprawdź najpierw cache; jeśli wynik z dziś, użyj go; jeśli z wczoraj — wykonaj nowe zapytanie. Cache nigdy nie powinien przekraczać 24h — status w VIES może się zmienić w każdej chwili. Cache redukuje zapytania o 70–80% dla firm ze stałą bazą kontrahentów.

Wystawienie faktury — blokady i ostrzeżenia

Logika biznesowa: (1) numer aktywny w VIES → faktura wystawiona z 0% VAT, adnotacja „WDT — reverse charge”; (2) numer nieaktywny → blokada wystawienia z 0% VAT, oferta wystawienia z 23% VAT (kontrahent może odzyskać przez procedurę przedawnienia); (3) błąd komunikacji z VIES → ostrzeżenie, opcjonalna blokada (zależnie od polityki firmy), zalecenie ponowienia weryfikacji za 15 min. Najlepsze systemy pozwalają konfigurować politykę: rigorous (blokada przy każdym błędzie) lub permissive (ostrzeżenie, ale pozwala wystawić).

Treść faktury WDT z VIES

Standardowa faktura WDT powinna zawierać: (1) numer VAT sprzedającego z prefiksem (PL...); (2) numer VAT nabywcy z prefiksem (DE..., FR...); (3) adnotację „Wewnątrzwspólnotowa dostawa towarów — opodatkowanie u nabywcy, art. 138 dyrektywy 2006/112/WE” lub krótko „WDT — reverse charge”; (4) stawkę 0% VAT i kwotę netto = brutto; (5) opcjonalnie identyfikator konsultacji VIES jako dowód weryfikacji; (6) typowe pola faktury (numer, data, opis towaru/usługi). Punkty 1–4 są obowiązkowe — bez nich faktura jest nieprawidłowa.

Integracja z KSeF (Krajowy System e-Faktur)

Od 2026 polskie B2B fakturowanie jest obowiązkowo elektroniczne w KSeF (e-faktura PL). Faktury WDT mają nadal status faktur tradycyjnych (nie KSeF) do czasu wdrożenia ViDA, ale wymagają takiego samego raportowania w JPK_V7. Profesjonalne systemy fakturowe (Comarch, Sage, iFirma) integrują KSeF dla krajowego B2B i ręczne wystawianie z VIES dla WDT — wszystko w jednym kliku użytkownika.

Audit-ready faktury — checklista

Faktura WDT „audit-ready” zawiera: (1) wszystkie obowiązkowe pola faktury VAT; (2) dwa numery VAT z prefiksami (PL nadawca, kraj UE odbiorca); (3) adnotację WDT; (4) identyfikator konsultacji VIES; (5) datę dostawy (zwykle datę CMR); (6) referencję do umowy lub zamówienia; (7) opis towaru z kodami CN (jeśli wymagane); (8) walutę i kurs przeliczeniowy (jeśli inna niż PLN). Komplet tych pól znacznie obniża ryzyko zakwestionowania przez urząd skarbowy.

Integracja z Comarch Optima — krok po kroku

Comarch Optima to najpopularniejszy program księgowy w Polsce dla MŚP. Integracja z ViesVAT dostępna jest jako oficjalny dodatek w Comarch ERP Marketplace. Instalacja. Krok 1: w panelu administratora Comarch wybierz „Dodatki” → „ViesVAT Integration”, kliknij „Zainstaluj”. Krok 2: po instalacji pojawi się nowe okno konfiguracji — wprowadź klucz API ViesVAT (uzyskasz po rejestracji na viesvat.com). Krok 3: skonfiguruj zachowanie: czy weryfikować automatycznie przy wystawianiu każdej faktury WDT (zalecane), czy ręcznie na żądanie. Krok 4: skonfiguruj pola: w którym polu faktury zapisać identyfikator konsultacji (zalecane: pole „uwagi” lub osobne pole jeśli stworzysz). Użycie. Przy wystawianiu faktury WDT (typ dokumentu „FA — Faktura sprzedaży WDT”) system automatycznie woła ViesVAT, w 1–3 sekundy zwraca wynik. Aktywny — faktura wystawiana normalnie z identyfikatorem konsultacji w polu uwag. Nieaktywny — pop-up z ostrzeżeniem, blokada wystawienia z 0% VAT, sugestia alternatyw (23% VAT lub anulowanie). Awaria VIES — pop-up z opcją „Ponów za 15 min” lub „Wystaw mimo niedostępności” (zarejestrowane jako fakt prób). Cena dodatku w Comarch ERP Marketplace: zwykle ok. 30 PLN/mies + Twój plan ViesVAT (49 EUR/m Pro).

Integracja z iFirma — natywna i prosta

iFirma ma natywne wsparcie VIES — nie potrzebujesz osobnej integracji ze ViesVAT. Przy wystawianiu faktury WDT iFirma automatycznie sprawdza numer w VIES (przez KE bezpośrednio), wyświetla wynik w UI, zapisuje identyfikator. Plusy: zero konfiguracji, działa od razu, w cenie planu iFirma (od 25 PLN/m). Minusy: korzysta z oficjalnego VIES KE bez retry strategy — przy awariach MS_UNAVAILABLE musisz czekać; brak archiwum historycznego widocznego dla klienta (iFirma ma to wewnętrznie, ale nie udostępnia jako raport); brak integracji z innymi systemami (jeśli klient eksportuje dane do innego programu, weryfikacje nie idą razem). Dla większości małych firm iFirma natywne wystarczy. Dla firm potrzebujących zaawansowanych funkcji (raporty, multi-system, masowa weryfikacja) — równolegle z iFirma używaj ViesVAT Plan Pro. iFirma weryfikuje przy fakturowaniu, ViesVAT udostępnia archiwum, raporty i batch — komplementarne, nie konkurujące. Jeśli iFirma będzie w przyszłości otwierać API dla integratorów (planowane na 2026–2027), ViesVAT będzie pierwszym partnerem integracyjnym.

Integracja z Sage Symfonia — przez API

Sage Symfonia, popularna w średnich i dużych polskich firmach, nie ma natywnej integracji z VIES — wymaga niestandardowego rozwiązania. Trzy ścieżki. Ścieżka 1: pluginy zewnętrzne. Dostępne na rynku pluginy (np. od integratorów Sage Premium Partners) za 200–500 PLN miesięcznie. Plusy: szybkie wdrożenie, wsparcie integratora. Minusy: koszt, zależność od dostawcy. Ścieżka 2: customowa integracja ze ViesVAT API. Twój wewnętrzny IT lub konsultant Sage buduje moduł, który wywołuje ViesVAT przed wystawieniem faktury WDT. Czas: 5–10 dni roboczych. Koszt: 5000–10000 PLN jednorazowo + 49–199 EUR/m za plan ViesVAT. Plusy: pełna kontrola, customizacja. Minusy: koszt początkowy. Ścieżka 3: zewnętrzny middleware. Narzędzia jak Zapier, Make.com (dawniej Integromat) mogą połączyć Sage (przez API jeśli udostępnione) z ViesVAT — bez kodu, w wizualnym edytorze. Plusy: brak kodu. Minusy: niezbyt szybkie, ograniczenia w obsłudze błędów. Dla większości firm z Sage zalecamy ścieżkę 2 — customowa integracja zwraca się w 6–12 miesiącach przez oszczędność czasu i jakość weryfikacji.

Integracja z SAP Business One i Microsoft Dynamics

Dla firm średnich i dużych korzystających z międzynarodowych ERP integracja VIES wygląda nieco inaczej niż dla rozwiązań polskich. SAP Business One: standardowo nie ma wbudowanej integracji VIES — wymaga rozszerzenia. Najpopularniejsze rozwiązanie: B1 Usability Package (B1UP) jako platforma + custom workflow wywołujący ViesVAT API. Czas implementacji: 10–20 dni roboczych. Koszt: 15000–40000 PLN dla średniego SAP B1. Microsoft Dynamics 365 Business Central: ma marketplace AppSource z gotowymi rozszerzeniami VIES. Aktualnie 3–4 dostawcy oferują gotowe extensions. Cena: 30–150 EUR/m za rozszerzenie + plan ViesVAT (lub innego dostawcy API). Microsoft Dynamics 365 Finance and Operations (Enterprise): rozszerzenia od konsultantów Microsoft Premier — projekt customowy. Czas: 1–3 miesiące, koszt: 100k+ PLN. Dla firm z międzynarodowym ERP zalecamy konsultację ze ViesVAT — mamy doświadczenie z integracjami SAP B1 (ok. 30 wdrożeń), Dynamics 365 BC (ok. 50 wdrożeń) i Dynamics 365 F&O (ok. 5 wdrożeń). Plan Business zawiera bezpłatną konsultację techniczną z naszym deweloperem (do 8 godzin) — często wystarcza, by Twój zespół IT lub partner Microsoft mógł wykonać integrację samodzielnie.

Integracja z KSeF — Polski system e-faktur 2026

Krajowy System e-Faktur (KSeF) staje się obowiązkowy dla większości polskich firm B2B od 2026. KSeF dotyczy faktur krajowych (PL-PL); faktury WDT pozostają poza KSeF (w transakcjach UE dziś nadal tradycyjne faktury, do wdrożenia ViDA ~2028). Ale integracja VIES + KSeF ma sens w jednym kontekście: gdy polski kontrahent UE ma też polski oddział z polskim NIP. Wtedy fakturowanie wewnątrzgrupowe wymaga obu — KSeF dla polskiej części, VIES dla zagranicznej. ViesVAT udostępnia integrację z KSeF poprzez middleware: nasze API może być wywołane jako pre-flight check przed wysłaniem faktury do KSeF (dla weryfikacji NIP kontrahenta) lub jako post-flight verification (po wystawieniu faktury w KSeF, jeśli faktura zawiera kontrahentów UE w pole NABYWCA). Aktualne integracje KSeF z popularnymi ERP (Comarch, iFirma, Sage, Wapro) mogą wykorzystywać nasze API jako warstwę weryfikacji. Dokumentacja: /poradniki/vies-a-jpk-vat/ ma osobny rozdział o integracji KSeF — z przykładami kodu w PHP i Pythonie.

Workflow wystawiania faktur WDT — best practices

Optymalny workflow wystawiania faktury WDT w nowoczesnym programie księgowym. Krok 1: księgowa wybiera kontrahenta z bazy lub wpisuje nowego (z numerem VAT). System automatycznie waliduje format numeru lokalnie (sprawdzenie cyfry kontrolnej, format kraju). Niepoprawny format — czerwone ostrzeżenie, blokada dalszych kroków. Krok 2: system woła API VIES (ViesVAT lub równoważne). W oczekiwaniu na odpowiedź (1–3s) wyświetla spinner. Krok 3: wynik VIES wyświetla się w sekcji „Weryfikacja VAT”: status (zielony aktywny, czerwony nieaktywny, żółty awaria), nazwa i adres (jeśli VIES udostępnił), identyfikator konsultacji. Krok 4: jeśli aktywny i dane się zgadzają z umową — księgowa kontynuuje wystawienie faktury. System automatycznie wpisuje identyfikator konsultacji w polu „uwagi” lub specjalnym polu „VIES Check ID”. Krok 5: jeśli nieaktywny — system wyświetla modal z opcjami: „Wystaw z 23% VAT (polski podatek)”, „Anuluj i skontaktuj się z klientem”, „Zapisz jako szkic do późniejszego ustalenia”. Domyślnie blokada wystawienia z 0% VAT. Krok 6: jeśli awaria VIES — system pyta: „VIES chwilowo niedostępny. Ponów za 15 min” lub „Wystaw mimo niedostępności (dokumentuj próby)”. Krok 7: po zatwierdzeniu, faktura jest wystawiona, identyfikator konsultacji + faktura archiwizowane razem.

Faktury elektroniczne EN 16931 — standard ViDA

Pakiet ViDA wprowadza obowiązek wystawiania faktur wewnątrzunijnych w standardzie EN 16931 — europejski standard e-faktur (od 2028 dla większości krajów, w niektórych wcześniej). EN 16931 to standard semantyczny — definiuje, jakie informacje muszą być w fakturze (90 pól obowiązkowych). Formaty techniczne: UBL 2.1 XML, CII (Cross-Industry Invoice) XML, Factur-X (hybryda PDF + XML). Krajowe systemy implementują różne formaty: Polska KSeF — własny XSD FA(2) ze schematem zgodnym z EN 16931, Włochy FatturaPA — UBL-podobny, Francja Chorus Pro — UBL 2.1, Niemcy XRechnung — UBL 2.1 lub CII, Holandia PEPPOL — UBL 2.1. Implikacje dla integracji VIES. Pierwsze: każda e-faktura WDT będzie musiała zawierać identyfikator konsultacji VIES jako element XML (pole zdefiniowane w EN 16931 jako AdditionalDocumentReference). Drugie: pre-flight weryfikacja VIES będzie zintegrowana z systemem e-fakturowania — automatyczne sprawdzenie przed wystawieniem. Trzecie: numery VAT w fakturach EN 16931 mają standard format z prefiksem kraju (ISO 3166-1 alpha-2 + numer). ViesVAT przygotowuje się do tego standardu — w 2027 udostępnimy walidatory pełnych e-faktur EN 16931, nie tylko numerów VAT.

OSS i IOSS — VIES dla e-commerce B2C

VIES nie obsługuje transakcji B2C (do konsumentów). Dla tych transakcji UE wprowadziła oddzielne procedury. OSS (One Stop Shop, od 2021): polska firma sprzedająca konsumentom z innych krajów UE rejestruje się w jednym kraju (zwykle Polska) i tam deklaruje VAT należny do wszystkich krajów. Eliminuje konieczność rejestracji VAT w każdym kraju klientów. IOSS (Import One Stop Shop, od 2021): podobnie dla importów z krajów trzecich (np. Chiny, USA) do konsumentów UE. Próg 150 EUR — niższe przesyłki przez IOSS, wyższe standardową procedurą celną. Te systemy mają osobne portale (OSS-PL pod podatki.gov.pl), nie są zintegrowane z VIES. Dla firm e-commerce z mieszanym B2B/B2C: VIES dla weryfikacji firm-klientów, OSS/IOSS dla konsumentów. Większość platform e-commerce (Shopify, WooCommerce, Magento) ma wbudowaną logikę rozpoznawania B2B vs B2C na podstawie podanego numeru VAT — jeśli klient podaje VAT i jest weryfikowalny w VIES = B2B z 0% VAT (reverse charge); jeśli nie = B2C z lokalnym VAT kraju klienta (przez OSS).

Multi-currency i kursy NBP w fakturach WDT

Faktury WDT mogą być wystawiane w PLN lub w walutach obcych (najczęściej EUR, czasem USD, GBP, CHF). Polskie przepisy wymagają przeliczenia na PLN dla celów księgowych i podatkowych. Kurs przeliczeniowy. Zasada główna: kurs średni NBP z dnia poprzedzającego dzień powstania obowiązku podatkowego (zwykle = dzień dostawy lub dzień wystawienia faktury, w zależności od warunków Incoterms). Wyjątek: dla transakcji w EUR przedsiębiorca może wybrać alternatywnie kurs ECB (Europejskiego Banku Centralnego) z dnia poprzedzającego (od 2020). Wybór tego kursu jest deklaratywny i obowiązuje przez cały rok podatkowy. Praktyczna implementacja w programach księgowych. Comarch Optima: automatyczne pobieranie kursu NBP przez API NBP (api.nbp.pl) lub ręczne wpisanie. iFirma: automatyczne kursy NBP, dziennie aktualizowane. fakturownia.pl: kurs NBP z dnia poprzedzającego automatycznie. Sage Symfonia: ręcznie lub przez dodatek. Wapro: ręcznie. ViesVAT API może być rozszerzony o helper getNbpRate(currency, date) — zwraca kurs NBP z dnia, przydatne dla integracji własnych. To dodatek bezpłatny dla wszystkich planów. Faktura w walucie obcej musi zawierać kurs przeliczeniowy i wartość w PLN — to wymóg ustawowy art. 31a ustawy o VAT.

Najczęściej zadawane pytania

Powiązane