Ustawienia - N24 KSeF Helper
Ustawienia rozszerzenia N24 KSeF Helper są dostępne na dedykowanej stronie KSeF Helper - Ustawienia. Stronę można otworzyć wyszukując KSeF Helper - Ustawienia w wyszukiwarce Business Central lub klikając link Otwórz kartę ustawień KSeF Helper na stronie Ustawienia KSeF (ITI NSeI Setup) z rozszerzenia Polish Localization.
Informacja
Sekcja Kolejki zleceń pozostaje na stronie Ustawienia KSeF (ITI NSeI Setup).
Ogólne
W tej sekcji konfiguruje się ogólne ustawienia rozszerzenia.
| Pole | Opis |
|---|---|
| Własny adres e-mail kontaktu | Określa źródło adresu e-mail kontaktu wystawcy w fakturze KSeF. Domyślnie adres pobierany jest z Ustawień ustawowego raportowania. Można zmienić na pobieranie z Danych firmy. |
Stopka
W tej sekcji konfiguruje się teksty stopek, które będą automatycznie dołączane do faktur KSeF.
| Pole | Opis |
|---|---|
| Tekst stopki KSeF 1 | Pierwszy wiersz tekstu stopki (do 2048 znaków) |
| Tekst stopki KSeF 2 | Drugi wiersz tekstu stopki (do 2048 znaków) |
| Tekst stopki KSeF 3 | Trzeci wiersz tekstu stopki (do 2048 znaków) |
Puste pola są pomijane – do stopki faktury trafiają tylko wypełnione teksty. Stopki są dołączane do wszystkich faktur KSeF: sprzedażowych, korygujących sprzedaży, serwisowych i korygujących serwisowych.
Konfiguracja poczty
W tej sekcji konfiguruje się automatyczne dołączanie plików do e-maili z fakturami.
| Pole | Opis |
|---|---|
| Dołącz PDF do e-maila | Włącza automatyczne generowanie i dołączanie wizualizacji PDF faktury KSeF do wiadomości e-mail |
| Dołącz XML do e-maila | Włącza automatyczne dołączanie pliku XML faktury KSeF do wiadomości e-mail |
Obie opcje mogą być włączone niezależnie od siebie.
Eksport komentarzy
W tej sekcji konfiguruje się automatyczny eksport wierszy komentarzy z dokumentów sprzedaży i serwisowych do sekcji DodatkowyOpis w fakturze KSeF.
| Pole | Opis |
|---|---|
| Eksportuj wiersze komentarzy | Włącza eksport wierszy typu „Komentarz" z faktur sprzedaży, korygujących, serwisowych i korekt serwisowych do KSeF |
| Kierunek komentarzy | Określa, czy komentarze poniżej czy powyżej wiersza pozycji są przypisywane do tego wiersza |
| Etykieta komentarza | Opcjonalna własna etykieta używana w sekcji DodatkowyOpis dla komentarzy. Jeśli puste, używana jest domyślna wartość „Komentarz" |
| Format komentarza | Określa format treści eksportowanego komentarza. „Opis" – eksportuje tylko pole Opis. „Opis + Opis 2" – łączy pola Opis i Opis 2 (rozdzielone spacją) |
| Pomiń wiersze komentarzy z nr wydania | Włącza automatyczne oznaczanie wierszy tekstowych wstawianych przez funkcję „Pobierz wiersze wysyłki" jako Pomiń w KSeF. Dzięki temu wiersze z numerami wydań nie trafiają do faktury KSeF. |
Szczegółowy opis działania modułu znajdziesz w sekcji Eksport komentarzy oraz Pomijanie wierszy w KSeF.
Copilot
W tej sekcji konfiguruje się połączenie z usługą Azure OpenAI dla funkcji Copilot, która umożliwia tworzenie mapowań pól KSeF za pomocą opisów w języku naturalnym.
| Pole | Opis |
|---|---|
| Azure OpenAI Endpoint | Adres URL punktu końcowego zasobu Azure OpenAI, np. https://myresource.openai.azure.com/ |
| Azure OpenAI Deployment | Nazwa wdrożenia modelu Azure OpenAI, np. gpt-4o |
| Azure OpenAI API Key | Klucz API do zasobu Azure OpenAI |
Po skonfigurowaniu połączenia upewnij się, że funkcja KSeF Field Mapping jest aktywna na stronie Copilot i funkcje AI (Copilot & AI Capabilities) w Business Central.
Szczegółowy opis modułu znajdziesz w sekcji Copilot – Mapowanie pól KSeF.
Mapowanie pól KSeF
Konfiguracja mapowań pól jest dostępna na osobnej stronie KSeF Helper - Mapowanie pól KSeF. Można ją otworzyć wyszukując bezpośrednio w wyszukiwarce Business Central.
Szczegółowy opis konfiguracji mapowań znajdziesz w sekcji Mapowanie pól KSeF – Ustawienia.
Eksport / Import ustawień
Rozszerzenie umożliwia przenoszenie konfiguracji między środowiskami (np. z Sandbox na Produkcję) za pomocą plików JSON.
Funkcje eksportu i importu są dostępne w grupie akcji Eksport / Import na odpowiednich stronach.
Eksport / Import głównych ustawień
Dostępne na stronie KSeF Helper - Ustawienia:
| Akcja | Opis |
|---|---|
| Eksportuj ustawienia | Eksportuje ustawienia główne (stopka, poczta, komentarze, Copilot) do pliku KSeFHelper_MainSetup.json |
| Importuj ustawienia | Importuje ustawienia główne z wcześniej wyeksportowanego pliku JSON. Nadpisuje bieżące ustawienia po potwierdzeniu. |
| Synchronizuj do innych firm | Kopiuje ustawienia główne do wybranych firm w tym samym środowisku |
Eksport / Import mapowań pól
Dostępne na stronie KSeF Helper - Mapowanie pól KSeF:
| Akcja | Opis |
|---|---|
| Eksportuj mapowania | Eksportuje wszystkie mapowania pól KSeF (wraz z krokami) do pliku KSeFHelper_FieldMappings.json |
| Importuj mapowania | Importuje mapowania z pliku JSON. Importowane mapowania są dodawane do istniejących – dotychczasowe konfiguracje nie są usuwane. |
| Synchronizuj mapowania | Kopiuje mapowania pól do wybranych firm w tym samym środowisku |
Typowy scenariusz przenoszenia ustawień
- Skonfiguruj ustawienia i mapowania pól na środowisku Sandbox.
- Na stronie KSeF Helper - Ustawienia wybierz Eksportuj ustawienia — zapisz plik JSON.
- Na stronie KSeF Helper - Mapowanie pól KSeF wybierz Eksportuj mapowania — zapisz plik JSON.
- Przejdź do środowiska Produkcyjnego (lub dowolnego innego).
- Otwórz stronę KSeF Helper - Ustawienia i wybierz Importuj ustawienia — wskaż zapisany plik.
- Otwórz stronę KSeF Helper - Mapowanie pól KSeF i wybierz Importuj mapowania — wskaż zapisany plik.
Informacja
Klucz API Azure OpenAI (Copilot) nie jest eksportowany ze względów bezpieczeństwa. Po imporcie ustawień na nowym środowisku należy ręcznie uzupełnić pole Azure OpenAI API Key.
Podpowiedź
Aby skopiować ustawienia do innej firmy w tym samym środowisku, użyj akcji Synchronizuj do innych firm / Synchronizuj mapowania zamiast eksportu i importu plików.
Kolejki zleceń
W tej sekcji można szybko tworzyć i zarządzać wpisami kolejek zleceń odpowiedzialnych za automatyczne przetwarzanie dokumentów KSeF. Kliknięcie nazwy kolejki tworzy nowy wpis z domyślnymi ustawieniami lub otwiera istniejący.
| Kolejka | Jednostka kodu | Opis |
|---|---|---|
| Wyślij do KSeF (sesja interaktywna) | ITI Send Document to NSeI | Wysyłka dokumentów do KSeF |
| Przetwarzaj sesję (sesje interaktywne) | ITI Process NSeI Sessions | Przetwarzanie sesji KSeF |
| Przetwarzaj UPO KSeF | ITI Process NSeI ORC | Pobieranie UPO |
| Aktualizuj księgi KSeF | ITI NSeI Ledgers Update | Aktualizacja księgi KSeF |
Nowo utworzone wpisy mają status Wstrzymane – przed aktywacją sprawdź harmonogram i zmień status na Gotowe.
Szczegółowy opis modułu znajdziesz w sekcji Kolejki zleceń KSeF.