Dokumentacja

Aplikację instalujesz bezpośrednio ze Shopify App Store:

1. Zaloguj się do panelu administracyjnego Shopify
2. Przejdź do Apps → App Store
3. Wyszukaj "KSeF Faktury"
4. Kliknij Zainstaluj
5. Zaakceptuj uprawnienia aplikacji

Po instalacji zostaniesz automatycznie przekierowany do kreatora konfiguracji.

Dane firmy

W pierwszym kroku podajesz dane swojej firmy:

• NIP — weryfikujemy poprawność i pobieramy dane z GUS
• Nazwa firmy — wypełni się automatycznie po weryfikacji NIP
• Adres — uzupełnij jeśli różni się od danych GUS
• Email — adres do kontaktu i powiadomień

Token KSeF to autoryzacja do wysyłania faktur w Twoim imieniu.

Jak wygenerować token?

1. Zaloguj się do ksef.mf.gov.pl
2. Wybierz Ustawienia → Generuj token
3. Typ tokenu: Zewnętrzny system
4. Uprawnienia: Wystawianie faktur
5. Skopiuj wygenerowany token
6. Wklej token w naszej aplikacji

Ważność tokenu

Tokeny KSeF ważne są do 31 grudnia 2026. Po tej dacie MF wprowadzi autoryzację certyfikatami — poinformujemy Cię o zmianach z wyprzedzeniem.

Rozszerzenie checkout pozwala klientom podać NIP podczas składania zamówienia.

Shopify Plus

Rozszerzenie integruje się bezpośrednio w formularzu checkout:

• Pole NIP pojawia się automatycznie
• Walidacja NIP w czasie rzeczywistym
• Autouzupełnianie danych firmy z GUS
• Blokada zamówienia przy błędnym NIP (opcjonalne)

Shopify Basic / Standard

Widget w koszyku zbiera dane do faktury:

• Klient może podać NIP przed checkout
• Jeśli pominie — wysyłamy email z linkiem do formularza
• Dane zapisywane jako metafield zamówienia

Aktywacja rozszerzenia

1. Przejdź do Ustawienia → Checkout w Shopify
2. Znajdź sekcję Post-purchase extensions
3. Włącz KSeF Faktury

Automatyczne generowanie

Faktura generuje się automatycznie gdy:

• Zamówienie ma podany NIP (przez checkout lub metafield)
• Zamówienie jest opłacone
• Adres rozliczeniowy jest w Polsce

Status faktury

Wysyłka do KSeF

Możesz wysyłać faktury pojedynczo lub zbiorczo:

• Pojedynczo: Kliknij ikonę wysyłki przy fakturze
• Zbiorczo: Zaznacz faktury i kliknij "Wyślij zaznaczone"

PDF faktury

Po wysłaniu do KSeF generujemy PDF z:

• Numerem KSeF
• Kodem QR do weryfikacji
• Polskim formatowaniem (stawki VAT, kwoty)

Korekty generowane są automatycznie przy zwrotach w Shopify.

Kiedy powstaje korekta?

• Zwrot całego zamówienia → korekta zerująca
• Zwrot części produktów → korekta częściowa
• Zmiana ceny (rabat potransakcyjny) → korekta wartościowa

Powiązanie z fakturą pierwotną

Korekta automatycznie zawiera numer KSeF faktury pierwotnej. Jest to wymagane przez przepisy i umożliwia prawidłowe rozliczenie VAT.

Weryfikujemy kontrahentów na Białej Liście podatników VAT prowadzonej przez MF.

Co sprawdzamy?

• Czy firma jest czynnym podatnikiem VAT
• Czy numer konta bankowego jest zarejestrowany
• Status podmiotu (aktywny/wykreślony)

Gdzie widoczny jest status?

• W checkout (Shopify Plus) — informacja przy NIP
• Na liście faktur — ikona statusu
• W szczegółach faktury — pełna informacja

Faktura nie została wygenerowana

• Sprawdź czy zamówienie ma podany NIP
• Sprawdź czy adres rozliczeniowy jest w Polsce
• Sprawdź czy zamówienie jest opłacone

Błąd wysyłki do KSeF

• Token wygasł — wygeneruj nowy token w portalu KSeF
• Błąd walidacji XML — sprawdź dane na fakturze
• KSeF niedostępny — spróbuj ponownie za kilka minut

Kontakt z supportem

Jeśli problem się powtarza, napisz do nas: kontakt@ksef-shopify.pl

W wiadomości podaj:

• Nazwę sklepu Shopify
• Numer zamówienia (jeśli dotyczy)
• Opis problemu i komunikat błędu