5. Krajowy System e-Faktur (KSeF) – dodawanie kodów QR i parametrów pod KSeF na własnych formatkach dokumentów księgowych
Ostatnia aktualizacja: 8.05.2026 11:33
Dotyczy rozwiązania: Integracja z księgowością
Kliknij tutaj, aby zgłosić sugestie lub uwagi do tego artykułu
Instrukcja video: BRAK
Opracowane na podstawie wersji KWHotel: 0.47.215.27
📌 Połączenie KWHotel z KSeF wymaga dostępu do modułu “Integracja z księgowością”. Jeżeli go nie posiadasz, skontaktuj się z naszym działem handlowym.
SPIS TREŚCI (kliknij na nazwie, aby szybko przejść do tego fragmentu artykułu)
Dodawanie kodów QR na fakturze
Nowe parametry do formatek dokumentów
Dodatkowe formatki i parametry pod domyślne pliki
1. Dodawanie kodów QR na fakturze
Aby dodać pole z kodem QR, przejdź do panelu po lewej stronie i wybierz kolejno: Barcode > Two-dimensional > QR Code.
Po dodaniu kodu QR przejdź do jego Properties i ustaw parametr AutoSize na true. Dzięki temu rozmiar kodu będzie automatycznie dopasowywany do długości adresu URL. Zbyt mały, ustawiony ręcznie kod może być trudny lub niemożliwy do odczytania.
Dostępne parametry, które możesz wykorzystać w kodzie QR lub jako tekst:
eInvoiceUrl – adres URL do e-faktury
einvoiceId – numer KSeF wysłanej e-faktury; w przypadku faktury offline wyświetlany jest tekst Offline
eInvoiceVerificationUrl – adres URL do weryfikacji e-faktury (dla faktur offline)
eInvoiceVerificationDescription – tekst „Certyfikat”
Aby ustawić adres URL dla kodu QR, kliknij go dwukrotnie i w polu Text wklej odpowiedni parametr, np. [eInvoiceUrl] lub [eInvoiceVerificationUrl].
Jeżeli dany parametr URL w konkretnej fakturze będzie pusty, kod QR nie zostanie wyświetlony.
Parametry [einvoiceId] oraz [eInvoiceVerificationDescription] możesz umieścić pod odpowiednim kodem QR jako zwykłe pole tekstowe. Jeśli nie są one widoczne na liście dostępnych parametrów, możesz wpisać je ręcznie w miejscu, w którym mają się pojawić.
2. Nowe parametry do formatek dokumentów
1. Klient
Numer BDO:
customer_bdo_number
Jednostka wewnętrzna:
customer_internal_unit_id,
customer_internal_unit_name,
customer_internal_unit_address,
customer_internal_unit_country
Podmiot nadrzędny (JST):
customer_parent_company_tax_id, customer_parent_company_name, customer_parent_company_address, customer_parent_company_country, customer_parent_company_email, customer_parent_company_phone, customer_parent_company_bdo_number
2. Hotel/Firma
Numer BDO:
company_bdo_number
Jednostka wewnętrzna:
hotel_internal_unit_id,
hotel_internal_unit_name,
hotel_internal_unit_phone,
hotel_internal_unit_email,
hotel_internal_unit_street,
hotel_internal_unit_post_code,
hotel_internal_unit_city,
hotel_internal_unit_country
Podmiot nadrzędny (JST):
company_parent_company_tax_id,
company_parent_company_bdo_number,
company_parent_company_name,
company_parent_company_address (ulica + kod + miasto + kraj w jednym tekście), company_parent_company_phone,
company_parent_company_email
3. Dodatkowe formatki i parametry pod domyślne pliki
AdvanceInvoice4.frx, Faktura4.frx, Korekta4.frx
Zawierają sekcję z dodatkowymi podmiotami (jednostki wewnętrzne, jednostki podrzędne JST) oraz wystawca i nabywca są ustawiane odpowiednio w zależności od tego, czy mają podmiot nadrzędny (czy są jednostkami podrzędnymi JST).
Nowe formatki znajdziesz w folderze KWHotel > Doc > pl.
Dodatkowe (używane na dodatkowych domyślnych formatkach):
seller_block – dane podmiotu nadrzędnego (JST), jeśli występuje, w przeciwnym wypadku dane firmy (z licencji)
buyer_block – dane podmiotu nadrzędnego klienta (JST), jeśli występuje, w przeciwnym wypadku dane klienta
tabela DataSet_AdditionalParties
Zawiera dane wszystkich podmiotów dodatkowych:
Jednostka wewnętrzna wystawcy,
Jednostka wewnętrzna nabywcy,
Dane wystawcy jeśli w seller_block jest podmiot nadrzędny,
Dane odbiorcy jeśli w buyer_block jest podmiot nadrzędny.
Tabela ta ma następujące pola:
Role (np. odbiorca, wystawca),
Name (nazwa podmiotu),
Address,
Identifier (nip/identyfikator),
BdoNumber,
Phone,
Email