Wstęp
Dokument zwiera pytania i odpowiedzi dla często pojawiających się problemów. Będzie regularnie aktualizowany i uzupełniany o nowe pojawiające się tematy
Techniczne
Jak włączyć logowanie błędów w zakresie operacji z KSeF?
update cdn.konfig set kon_wartosc=1 where kon_numer=-168
Po jakim IP i portach jest wykonywana komunikacja w ramach funkcjonalności KSEF?
IP:
145.237.204.182 -> demo
145.237.204.187 -> produkcja
Dodatkowo należy odblokować port 443
Czy numeru KSeF będzie drukowany na dokumentach?
Dany parametr dynamiczny jest zawarty w kodzie programu, więc zapytanie o drukowanie numeru ksef będzie się pojawiać na standardowych wydrukach. Dla niestandardowych zalecam utworzenie niestandardowego parametru dynamicznego np.
@PAR ?@n-14|CDN_DrukNrKsef|CDN_DrukNrKsef: @? PAR@
Czy znacznik Awaria będzie nadawał się automatycznie w momencie niedostępności systemu KSeF?
Znacznik Awaria należy oznaczyć ręcznie. Aktualnie nie ma możliwości seryjnego zaznaczenia tego parametru.
W systemie ewidencji zgłoszeń TFS została zarejestrowana sugestia rozwojowa pod nr ID: 557649.
Modyfikacja procedury CDN.KSeF_Dane2 aby można było dodać więcej niż jeden DodatkowyOpis.
Jest możliwość dodania wielu opisów- pobierany jest opis z nagłówka i elementów, a dodatkowo z dowolnej liczby atrybutów przypisanych zarówno do nagłówka jak i do elementów, które będą miały na klasie zaznaczony parametr „KSeF”.
Merytoryczne
Jak skorygować datę sprzedaży na fakturze wysłanej do KSeF?
Zachęcamy do zapoznania się z rozdziałem “Obsługa przypadków nieznanej daty zakończenia dostawy w kontekście wysyłki KSeF.
https://pomoc.comarch.pl/xl/index.php/dokumentacja/xl154-krajowy-system-e-faktur/
Korekty inne niż zmiana ilości/ceny/stawki VAT można obsłużyć poprzez zarejestrowanie „pustej” korekty tj. korekty bez elementów i podanie w opisie dokumentu przyczyny korekty, w tym wypadku „zmiana daty sprzedaży z … na „ i wysłanie takiej korekty do KSeF.
Jak skorygować kurs waluty faktury wysłanej do KSeF?
W systemie nie ma korekty kursu waluty, zatem można wystawić korektę ilościową zwracającą wszystko i nową fakturę z poprawnym kursem, lub korektę wartościową na różnicę pomiędzy wartością błędną a poprawną.
Ewentualnie jeśli Użytkownik ma trudność z uzyskaniem właściwej wartości takiej korekty, wówczas zamiast dokonywania korekty pierwotnego dokumentu może zarejestrować i wysłać do KSeF korektę ręczną FSK lub (A)FSK, wprowadzając na nią numer faktury korygowanej/numer KSeF faktury korygowanej.
Czy można 2 razy zaimportować fakturę zakupu z KSeF do XL-a?
Nie ma możliwości zaczytania tej samej faktury z KSeF dwa razy.
Czy można importować tylko wybrane faktury zakupu do systemu?
Możliwe jest dokonanie importu wg poniższych kryteriów:
- Nowe – import dokonywany w tym trybie polega na pobraniu tych faktur, które zostały zarejestrowane od ostatniego importu tj. faktur z datą przyjęcia w KSeF równą i większą od daty dotąd pobranych faktur. Jeżeli żadna z faktur nie została dotąd pobrana, wówczas importowane są faktury z datą z bieżącego i poprzedniego miesiąca
- Za okres – importowane są faktury z datą przyjęcia w KSeF należącą do podanego przez Użytkownika okresu
- Numer KSeF – importowana jest faktura o konkretnym, podanym przez Użytkownika numerze KSeF
- Kontrahenci, po wybraniu której Użytkownik może przypisać na formatkę kontrahenta/listę kontrahentów, co oznacza, że System ma zaimportować z KSeF wyłącznie faktury wystawione przez tych Dostawców.
Co decyduje o roli dla Podmiotu 3 ?
O roli dla Podmiotu 3 decydują następujące warunki: Dla Roli 2 (Odbiorca) – adres kontrahenta docelowego jest inny niż kontrahenta głównego i do adresu kontrahenta docelowego przypisano atrybut KSeF_Podmiot3_IDWew. Dla Roli 6 (Płatnik) – adres płatnika jest inny niż adres kontrahenta głównego
W sytuacji kiedy te wszystkie warunki są spełnione, jeśli podmiot spełnia więcej niż jeden warunek, wówczas powinien zostać wysłany z rolą 1-wszą z góry. W tej sytuacji powinna zostać wysłana rola 2 (jest wcześniej w tabeli niż nr6)
W jaki sposób będzie wysyłana faktura do KSeF, która przekroczy rozmiar: Wielkość niezaszyfrowanego dokumentu faktury nie może przekroczyć 1 MB, a po zaszyfrowaniu nie może przekroczyć 2 MB?
Ograniczenie o rozmiarze faktury eksportowanej do KSeF jest określone przez Ministerstwo Finansów. Faktury niezaszyfrowane, które przekroczą rozmiar 1 MB, a po zaszyfrowaniu 2 MB nie zostaną wysłane do KSeF. Podczas wysyłki pojawi się odpowiedni komunikat o przekroczonym rozmiarze dokumentu.
Pole GLN na pieczątce, czy jest to pole obowiązkowe czy nie przy KSeF?
W KSeF pole GLN jest fakultatywne. Informacje o tym czy dana informacja jest obligatoryjna, opcjonalna czy fakultatywna Użytkownik może czerpać z broszury informacyjnej MF, dostępnej pod adresem j.n.
https://www.podatki.gov.pl/ksef/baza-wiedzy-ksef/pliki-do-pobrania-ksef/
Czy planujemy wprowadzenie wydruku UPO?
Nie ma w planach wydruku UPO.
Czy po instalacji wersji 2025.1 też wystąpi takie działanie, że token zostanie usunięty i trzeba go będzie generować na nowo?
To zależy z jakiego środowiska firma korzysta. W wersji 2025.1 dokonane zostały zmiany w sposobie zapisu i prezentacji tokena KSeF na pieczątce firmy. Token zapisywany jest jako wartość zaszyfrowana.
Podczas konwersji bazy do wersji 2025.1 wszystkie tokeny przypisane na poszczególnych pieczątkach firmy są usuwane. Użytkownicy, którzy korzystają produkcyjnie z KSeF powinni przed konwersją bazy zapisać lokalnie tokeny przypisane w niższej wersji, a następnie po wykonaniu konwersji bazy przypisać je ponownie na właściwych pieczątkach.
Użytkownicy, którzy działają z KSeF w ramach środowiska Demo, a co za tym idzie będą testować integrację w ramach KSeF 2.0 i schemty FA(3) powinni wygenerować i przypisać nowe tokeny.
Czy numer KSeF i UPO przychodzą razem. Proszę o informację jak działa mechanizm nadawania tego numeru w systemie? Jak to dokładnie wygląda? Szczególnie dla offline i awarii ?
Dokument pozytywnie zweryfikowany jest wysyłany do KSeF. Po dokonaniu takiej wysyłki status KSeF dokumentu zostaje zmieniony na Wysłano/nie odebrano UPO, a dodatkowo na dokumencie zapisany zostaje numer referencyjny sesji w ramach której został on wysłany, numer referencyjny dokumentu (wyłącznie przy wysyłce interaktywnej) oraz informacja o dacie wysłania i Operatorze, który tej wysyłki dokonał.
Natomiast po pobraniu UPO uzupełniany jest Numer dokumentu nadany przez KSeF.
Zaznaczenie parametrów Wyślij do KSeF/Poza systemem na dokumencie oznacza, że dokument został/zostanie wysłany do KSeF poza Systemem Comarch ERP XL. Na tak oznaczonym dokumencie Operator z prawem Edycja numeru KSeF na dokumentach może samodzielnie wprowadzić dane dotyczące KSeF: numer KSeF dokumentu, status KSeF, numer sesji, numer referencyjny dokumentu oraz daty wysłania/przyjęcia/odebrania UPO.
Czy możliwe jest automatycznie pobieranie UPO z KSeF?
Jest to możliwe z wykorzystaniem:
-API, funkcja XLKSeFPobierzUPO
-poprzez modelowanie procesów, akcja Pobranie UPO z KSeF
Czy do KSeF można wysłać więcej niż jeden rachunek bankowy?
W Konfiguracji Systemu na zakładce [KSeF/Eksport] udostępniono parametr, decydujący o tym, czy numer rachunku bankowego ma zostać wysłany na podstawie rejestru przypisanego do dokumentu, czy na podstawie rejestru/ów przypisanych do poszczególnych płatności dokumentu. W tym ostatnim przypadku wysyłanych rachunków bankowych może być wiele.
Czy dokumenty zakupowe pobierane oraz sprzedażowe wysyłane przechodzą przez serwery Comarch, czy bezpośrednio do serwerów MF?
Dokumenty zakupowe są pobierane, a sprzedażowe wysyłane bezpośrednio do serwerów MF
Instalacja ERP XL jest na serwerze wirtualnym do którego pracownicy logują się przez połączenie RDP. Czy certyfikaty uwierzytelniające muszą być na serwerze i czy na każdym koncie, czy też na każdym fizycznym komputerze pracownika?
W przypadku pracy przez pulpit zdalny certyfikat należy zainstalować na serwerze na którym jest XL
Czy certyfikaty KSeF będą musiały być zainstalowane na serwerze czy na stacji roboczej?
- W przypadku instalacji terminalowej dla systemu, gdy ERP XL jest zainstalowany na serwerze terminali z dostępem dla wielu użytkowników, wówczas certyfikat instalujemy :
– na każdym użytkowniku Windows logującym się przez pulpit zdalny , w magazynie osobistym ( importujemy do magazynów osobistych)
– Instalujemy certyfikat z kluczem prywatnym na całej maszynie i udzielamy dostęp do klucza prywatnego wybranym użytkownikom lub grupom użytkowników Windows- uprawnienia nadaje administrator
- W przypadku instalacji stanowiskowej, na stacjach roboczych certyfikat musi być w magazynie certyfikatów osobistych na tym stanowisku .
- Jeśli w przypadku instalacji terminalowej, użytkownik ma dostęp do XL-a ze swojej stacji roboczej (ERP XL jest zainstalowany lokalnie na stanowisku roboczym ) i użytkownik może uruchamiać ERP XL zamiennie albo logując się przez pulpit zdalny albo ze swojego stanowiska roboczego – certyfikat musi być w magazynie certyfikatów osobistych na tym stanowisku lub musi być dostęp do certyfikatu i klucza prywatnego tego certyfikatu, jeśli nie jest w osobistych, oraz równocześnie na pulpicie wg. wskazań z pkt.1
Pytanie odnośnie importu faktur z KSEF do XL-a. Co w przypadku gdy dostawca nie ma kodów EAN ?
Podczas identyfikacji towarów będziemy honorować następujące informacje przewidziane w schemacie e-faktury ustrukturyzowanej:
– GTIN
– Indeks
– P_7 (nazwa)
W ramach informacji przesłanych w polu GTIN i Indeks System będzie poszukiwał towaru po kodzie własnym, EAN-ie własnym (przypisanym do karty towaru i do jednostek pomocniczych towarów) i po kodzie u kontrahenta. W przypadku zaś informacji przesłanej w P_7 poszukiwania będą prowadzone po nazwie własnej towaru (XL-owej), nazwie u kontrahenta i kodzie u kontrahenta.
Jeżeli nie uda się takiego towaru w Systemie zidentyfikować, wówczas zachowanie Systemu będzie zależało od parametru „Dodawaj karty towarów” w Konfiguracji/KSeF/Import. Jeżeli parametr pozostanie włączony, wówczas System samodzielnie utworzy kartę towarową. Użytkownik będzie miał możliwość wskazania w Konfiguracji grupy towarowej, do której mają trafiać tak zakładane karty towaru. Może to być specjalnie stworzona grupa dla kartotek, które należy zweryfikować, a po dokonaniu takiej weryfikacji „przesunąć” do właściwej grupy.
Jeżeli ww. parametr w Konfiguracji będzie wyłączony, wówczas dla elementów wczytywanej faktury, dla których nie uda się zidentyfikować towaru dodawany będzie element z towarem A-vista, nowe karty towarowe nie będą zakładane
W jakim formacie będą faktury pobrane z ksef przez ERP XL?
Faktury pobrane z KSeF są dostępne na liście dokumentów z KSeF w XL-u i dodany jest do nich załącznik xml.
Komunikaty błędów
Co oznacza poniższy błąd podczas wysyłki do KSeF?
Problem wynika z błędnego numeru KRS w pieczątce firmy
Co oznacza błąd KSeF o kodzie 26001 przy próbie wygenerowania tokenu certyfikatem ?
Błąd KSeF 26001 oznacza, że wystąpił problem podczas autoryzacji użytkownika. Zazwyczaj jest to związane z nieprawidłowymi danymi uwierzytelniającymi. Generując token czy to dla środowiska Demo, czy to dla środowiska Produkcyjnego należy uwierzytelniać się rzeczywistym certyfikatem, natomiast należy wygenerować go oddzielnie dla każdego z ww. środowisk.
Spięcie faktury z istniejącym dokumentem handlowym działa prawidłowo. Przy próbie wystawienia nowej faktury na podstawie dokumentu z KSeF jest błąd: Wystąpił błąd:-1005. Co należy zrobić ?
Rozwiązanie: Odznaczenie parametru w Konfiguracji ‘Sprawdzaj poprawność pliku źródłowego’.
Co oznacza komunikat „Nie utworzono obiektu dla Comarch.XL.KSeF.KSeFIntegration”?
W katalogu instalacyjnym ERP XL jest folder KSeF – należy przekopiować pliki z tego katalogu do katalogu głównego (może być bez nadpisywania już istniejących).
Kiedy pojawia się komunikat 21301 Brak autoryzacji?
Ww. błąd autoryzacji pojawia się przy imporcie w okolicznościach j.n. być może u Klienta zachodzi któryś z tych przypadków:
Token, którego Klient używa został utworzony dla innego środowiska niż to, w którym Klient działa (np.,. token dla Testowego, używa Demo).
NIP użyty na pieczątce firmy centrum, do którego loguje się Operator jest inny niż NIP w tokenie.
Token, który jest używany nie ma przypisanej roli „Dostęp do faktur”.
Licencje
Czy licencje KSeF i OCR są wymienne?
Tak. W przypadku kiedy Klient będzie miał zarówno Comarch KSeF jak i Comarch OCR system najpierw będzie sprawdzał czy może zrealizować komunikację z KSeF za pomocą licencji Comarch KSeF.
W przypadku wyczerpania pakietu Comarch KSeF lub braku licencji KSeF – sprawdzi dostępność pakietu OCR.
Przed wysłaniem lub pobraniem dokumentu z KSeF komponent będzie sprawdzał, czy użytkownik ma licencję na Comarch KSeF, jakiego typu jest licencja na KSeF (tzw. “No limit” czy pakietowa), w przypadku licencji pakietowej komponent będzie porównywał ilość faktur wysłanych/odebranych do/z KSeF w systemie faktur w okresie rozliczeniowym z ilością dostępną w licencj
