Artykuly
A1. KSeF Opis ogólny. Konfiguracja
A2. KSeF Wymagania technologiczne
A3. KSeF Certyfikaty
A4. KSeF Faktury zakupu. Pobieranie
A5. KSeF Faktury sprzedaży. Wysyłanie. Pobieranie
A6. KSeF. Moduły w Trawers ERP
Poniżej masz alfabetyczny słownik pojęć zebranych z Artykułów 1-6
(KSeF + Trawers ERP) oraz na końcu zidentyfikowane niespójności
(z propozycją ujednolicenia).
---
Słownik pojęć KSeF i Trawers ERP (A-Z)AacquisitionDate - metadane faktury KSeF: data otrzymania (praktycznie: data nadania numeru KSeF).
acquisitionDate - pole metadanych faktury KSeF oznaczające datę otrzymania (w praktyce: datę nadania numeru KSeF).
W Trawersie domyślnie przyjmowane jako data otrzymania w ZO (A4).
Automatyczne wiązanie faktur (ZO_PWF00) - funkcja łącząca faktury pobrane z KSeF
z już wprowadzonymi ręcznie fakturami zakupu ZO wg:
NIP + numer faktury dostawcy (invoiceNumber) + opcjonalnie kwota brutto (grossAmount).
Może od razu zapisać powiązanie (A4).
W ZO Trawers domyślnie przyjmuje ją jako Otrzymanej.
AD (moduł administracyjny) - moduł Trawers ERP, gdzie ustawia się środowisko KSeF,
certyfikaty, skrzynki, harmonogramy Autorun, uprawnienia, monitoring.
AD_PKS05 / AD_PKS06 - funkcje Autorun do pobierania z KSeF odpowiednio do ZO i do NA.
AD_TAW01 - tabela awarii KSeF (rodzaj i okres awarii).
AD_TBX00 - tabela skrzynek KSeF.
AD_TCE01 - tabela certyfikatów KSeF w Trawersie.
AD_TLK01 / AD_TLK02 - raport/aktualizacja limitów API KSeF.
AD_TPA20 - parametr Środowisko KSeF (T/D/P/N).
AD_TPK20 - parametry KSeF: stawki PTU/VAT i numery.
AD_TPK21 - parametry KSeF: klasyfikacja / DodatkowyOpis.
AD_TPK22 - parametry KSeF: harmonogramy + włączanie wysyłki do KSeF.
AdminKSeF - osoba odpowiedzialna za operacyjny nadzór nad integracją (monitoring, analiza problemów,
kontrola kolejek, porównywanie z portalem MF).
Anonimizacja danych - zalecenie dla testów w środowiskach test/demo (nie wysyłać danych realnych).
API KSeF - interfejs MF do wysyłania/pobierania faktur, statusów, metadanych, limitów.
API KSeF - interfejs Ministerstwa Finansów do komunikacji system-system
(wysyłka/pobieranie e-Faktur, metadane, statusy, limity wywołań).
Autorun (KSeF) - automatyczne, cykliczne zadania w Trawers ERP do pobierania faktur
z KSeF do modułów NA/ZO (wg harmonogramu).
Aplikacja Podatnika KSeF - portal MF używany m.in. do generowania certyfikatów KSeF,
osobno dla środowisk test/demo/produkcyjnego (A1, A3).
Awarie KSeF (AD_TAW01) - tabela, w której zapisuje się rodzaj i okres awarii KSeF.
Podczas awarii program nie wysyła faktury do KSeF, tylko tworzy XML + skrót SHA
i odkłada dokument do folderu Do wysłania z kodem awarii (A5).
Awaria całkowita [4] - rodzaj awarii w AD_TAW01; wpływa na sposób oznaczeń i wydania dokumentu (A5).
BBatch (SB) - sesja wysyłki paczki faktur (zbiorcza wysyłka).
BFK (oznaczenie JPK) - oznaczenie, gdy firma nie wysyła do KSeF (przed obowiązkiem) oraz wariant używany
przy awarii całkowitej (zależnie od konfiguracji/okoliczności).
BrakID - identyfikator, gdy kontrahent nie ma NIP (w Podmiot2/Podmiot3).
CCentrum Certyfikacji MF - wystawca certyfikatów KSeF.
Certyfikat KSeF - narzędzie kryptograficzne (klucz publiczny/prywatny),
potwierdza tożsamość (NIP albo PESEL) i umożliwia automatyczną komunikację z KSeF.
Certyfikat KSeF - plik używany do technicznego uwierzytelnienia/komunikacji z KSeF;
wgenerowany w Aplikacji Podatnika, wgrywany do Trawers ERP (AD_TCE01).
Typy:
[U] Uwierzytelnienie - do logowania/połączenia,
[P] Podpis linku - do podpisywania linku (kontekst techniczny integracji).
Certyfikat właścicielski (w praktyce) - w A3: gdy certyfikat wygenerowano
po uwierzytelnieniu pieczęcią NIP, to zawiera NIP i po zalogowaniu daje
'pełne uprawnienia właścicielskie' (A3).
Certyfikat Uwierzytelnienie [U] - certyfikat do logowania/połączenia z KSeF.
Certyfikat Podpis linku [P] - certyfikat do podpisywania linku weryfikacyjnego (kodu QR).
CN - kod celny. Klasyfikacja towarowa możliwa do umieszczenia na fakturze ustrukturyzowanej.
CRWDE - repozytorium wzorów; Trawers potrafi zrobić HTML wg wzoru e-Faktury z CRWDE.
DDane firmy / Podmiot gospodarczy - dane sprzedawcy (Podmiot1) lub - w JST/GV - dane z płatnika PTU/VAT.
Dane sprzedawcy na fakturze KSeF (zwykle Podmiot1). W szczególnych przypadkach (JST/grupa VAT)
mogą być brane z danych płatnika PTU/VAT.
Dane kontrahentów - dane nabywcy (Podmiot2) lub - w JST/GV - z PłatnikPTU.
Dekretacja - księgowe ujęcie pozycji (w ZO użytkownik uzupełnia ręcznie; nie wynika wprost z KSeF).
Demo / Przedprodukcyjne - środowisko KSeF zgodne funkcjonalnie z produkcją, bez skutków prawnych.
DI (oznaczenie JPK) - status dokument inny do czasu nadania numeru KSeF.
Do wysłania (folder) - folder skrzynki KSeF na faktury przygotowane
do wysyłki / oczekujące / odrzucone / utworzone w awarii.
DodatkowyOpis - sekcja klucz-wartość (dla faktury i/lub pozycji); źródła: faktura, KIM,
uzgodnione klucze (GS1/EDI).
Duplikat faktury (440) - odrzucenie gdy: NIP sprzedawcy + P_2 + rodzaj faktury są identyczne.
Dopisywanie certyfikatów w Trawers ERP (AD_TCE01) - wgrywanie do tabeli certyfikatów plików
*.crt i *.key, numeru seryjnego oraz hasła klucza prywatnego, ze wskazaniem środowiska
i kontekstu (A1, A3). Potem przypisanie operatorów do certyfikatu (F3).
Data otrzymania (ZO) - w kontekście faktury z KSeF: domyślnie przyjmowana jako acquisitionDate
z metadanych (A4). Uwaga: wpływa na wybór okresu/miesiąca PTU.
Dekretacja (w ZO) - element księgowy uzupełniany przez użytkownika przy dopisywaniu pozycji;
nie jest automatycznie mapowany z KSeF (A4).
Dostawa rozłączna - scenariusz, gdzie pozycje zakupu łączy się z wcześniejszą dostawą;
wtedy ilość/indeks/magazyn biorą się z dostawy, a cena/wartość z faktury KSeF (A4).
EEDI / GS1 - standardy (klucze DodatkowyOpis oznaczone [GS1], identyfikatory GTIN/GLN/ILN).
W artykule wskazano, że część kluczy ma oznaczenie [GS1] i jest zgodna z wytycznymi GS1.
EORI - numer celny (może być w danych podmiotów).
FFA(3) / FA (3) - struktura e-Faktury; zalecana pisownia FA(3), ale w kodzie bywa używane FA (3) (ze spacją).
Faktura ustrukturyzowana - faktura w XML wg schemy MF (FA(2)/FA(3)), przesyłana przez KSeF, dostaje numer KSeF.
Faktura kosztowa - uproszczona rejestracja w ZO: pozycje sumaryczne wg stawek PTU/VAT.
Faktura zaliczkowa - w KSeF bez pozycji; w ZO rejestracja przez pozycje wg stawek PTU.
FNumerNA (numer obcy) C 64 - numer faktury 'od wystawcy' używany w NA (np. samofakturowanie / faktury
z innych programów).
Folder (w skrzynce KSeF) - Pobrane / Zapisane / Wysłane / Do wysłania itd.
Faktura kosztowa - faktura zakupu (usługi/energia itp.) bez wpływu na stany magazynowe;
w scenariuszu uproszczonym rejestruje się ją w ZO jako pozycje sumaryczne wg stawek PTU/VAT,
bez odtwarzania pozycji usługowych (A4).
Faktura zaliczkowa (KSeF) - w A4: w KSeF nie ma pozycji; rejestracja w ZO odbywa się
przez dopisanie pozycji wg stawek PTU (koszty) po utworzeniu nagłówka (A4).
Faktura zakupu KSeF - faktura ustrukturyzowana, w której firma (kontekst certyfikatu:
NIP/IDWew) występuje jako Podmiot2 (nabywca) lub Podmiot3 (A4).
FK / FA / FZ / FL (rodzaje dokumentów sprzedaży w Trawers) - mapowane na rodzaje faktur KSeF:
FA -> VAT lub ROZ (gdy są pozycje [R] zaliczka-rozliczenie)
FK -> KOR oraz KOR_ROZ (korekta rozliczającej)
FZ -> ZAL
FL -> KOR_ZAL (A5)
GGLN/ILN - identyfikator lokalizacji (adres, miejsce dostawy/wysyłki).
glibc / xmlsec / openssl / GTK3 / WebKit - minimalne biblioteki dla Trawers-X (KSeF) w wersjach ds.
grossAmount / netAmount / vatAmount - metadane kwotowe faktury KSeF wykorzystywane w panelach do porównań.
GTIN (EAN/KID) - identyfikator towaru; może być mapowany z KIM lub z faktury.
GUI - wersja graficzna programu Trawers; obsługa KSeF jest w TUI (Linux i Windows) oraz w GUI Linux.
w GUI Windows obsługa KSeF jest pośrednia (wywoływanie funkcji KSeF przez SOA tr5w.exe TUI).
H Harmonogram pobierania/wysyłania (KSeF) - parametry cyklicznych zadań autorun:
jak często pobierać faktury dla Podmiotów (NA/ZO) i jak często wysyłać faktury NA/ZO (AD_TPK22).
Harbour (libharbour / harbour-32-dll) - biblioteka runtime do wersji ds.
Head / KSeF Head (nagłówki KSeF) - zbiór nagłówków faktur KSeF (zarówno w NA, jak i ZO).
Przy pobieraniu Trawers sprawdza, czy faktura o danym skrócie SHA już istnieje;
jeśli tak - pomija, jeśli nie - dopisuje (A5).
IIDWew (InternalId) - identyfikator wewnętrzny; może być używany jako kontekst logowania oraz
* jako identyfikator w Podmiot3.
* jako możliwy identyfikator w Podmiot3,
* jako kontekst logowania do KSeF w Trawersie (jeśli w karcie firmy wypełniono IDWew).
Uwaga: jeśli logowanie jest w kontekście IDWew, pobierane są tylko faktury,
w których my występujemy jako Podmiot3 (bo Podmiot1/Podmiot2 nie mogą zawierać IDWew).
Identyfikator KSeF / Numer KSeF - 36-znakowy numer przydzielany przez KSeF. Moment nadania = moment otrzymania faktury.
invoiceNumber - metadane: numer faktury nadany przez wystawcę (numer obcy).
InvoicingMode (Online/Offline) - tryb nadany przez KSeF; praktycznie offline często rozpoznawalny po różnicy dat
w numerze KSeF vs data wystawienia.
Identyfikator unikalny faktury w KSeF Head - w A5: głównym identyfikatorem
w KSeF Head jest skrót SHA XML faktury (A5).
InvoicingMode / Offline - praktyczna identyfikacja trybu Offline po różnicy: data wystawienia vs data przesłania do KSeF
widoczna w numerze KSeF (A4, A5).
JJm KSeF (mapowanie jednostek) - pole w tabeli jednostek miar na zamienniki symboli z KSeF, aby dopasować P_8A do Jm w KIM.
JPK_V7 - raport JPK; trafia do niego numer KSeF lub oznaczenia DI/OFF/BFK.
JPK_V7, KSeF (dane dodatkowe dokumentu) - w artykule wskazane jako miejsce,
gdzie uzupełnia się pola wpływające na Podmiot3 (np. Faktor, Płatnik, Nabywcy dodatkowi).
JST (Jednostka Samorządu Terytorialnego) - przypadek szczególny:
centralizacja VAT i inne zasady wypełniania danych Podmiot1/Podmiot2/Podmiot3;
dodatkowo przewidziano schemat numeracji faktury uwzględniający jednostkę podrzędną.
KKB/KC - moduły płatności i przelewów; planowane wspieranie importu/generowania przelewów z numerem KSeF.
KIM - kartoteka indeksów: EAN/GTIN, kraj pochodzenia, opakowania, GTU, podstawa zwolnienia itd.
Kod QR - graficzny nośnik kodu weryfikującego/linku; na wydrukach może prowadzić do weryfikacji faktury i/lub wystawcy.
Kod weryfikujący - wspólna idea: QR lub link kierujący do faktury/jej weryfikacji
Kod statusu przetwarzania (KSeF) - statusy 100/150/200/410/430/440/450/ niezależne od kodów serwera HTTP.
Kontekst logowania - w Trawersie NIP lub IDWew (z karty firmy), wpływa na zakres pobierania.
KGO - koszt KGO (opłata/element kosztowy) możliwy do przeniesienia w DodatkowyOpis pozycji
(wg karty KIM).
KodUE / NrVatUE - zestaw identyfikatorów dla sprzedaży do UE (wariant identyfikacji nabywcy
zamiast NIP PL).
Kontekst uwierzytelnienia / logowania do KSeF - w Trawersie: NIP lub IDWew (z karty firmy).
Kontekst wpływa na zakres pobieranych faktur.
KSeF (Krajowy System e-Faktur) - państwowa platforma do wystawiania, przesyłania, otrzymywania
i przechowywania faktur ustrukturyzowanych.
Kreator faktury zakupu z KSeF - zestaw kroków w panelu KSeF (F6/F7/F8/Z/P),
umożliwiający półautomatyczne tworzenie faktury zakupu ZO na podstawie faktury KSeF:
powiąż kontrahenta -> utwórz nagłówek -> dopisz pozycje -> dopisz PTU -> przenieś do Zapisane (A4).
LLimity wysyłki - np. produkcja: 10/s, 30/min, 180/h dla Online (SO); do sprawdzenia w AD_TLK01/02.
Linux (Trawers-X) - wymaga bibliotek i wersji ds; obsługuje KSeF w TUI i GUI.
MMemo (opis faktury KSeF) - dziennik zdarzeń/WorkFlow: komentarze + automatyczne wpisy;
sygnatura sterowana parametrem 0307.
Metadane faktury - dane opisowe/techniczne obok XML (m.in. acquisitionDate, netAmount, grossAmount, invoiceNumber).
mingw32_ds - środowisko Windows do wersji KSeF (ds); współistnieje z mingw32.
NNA (sprzedaż) - moduł sprzedaży: wysyłka, pobieranie sprzedaży (np. samofakturowanie), panel NA_PKS00.
NA_DWK01 - wysyłka zbiorcza paczki faktur do KSeF.
NIP - podstawowy identyfikator PL; kluczowy dla Podmiot1/Podmiot2 i często kontekstu logowania.
Numer obcy / Nasz numer - w panelach rozróżnienie: numer obcy (od wystawcy) vs nasz numer (w Trawersie).
Numer referencyjny sesji - roboczy identyfikator sesji wysyłki (SO/SB).
Numer referencyjny faktury - roboczy identyfikator faktury w sesji, używany do statusów i UPO.
Numer KSeF - 36-znakowy numer identyfikacyjny przypisany fakturze w KSeF;
moment jego nadania jest momentem otrzymania faktury przez nabywcę (acquisitionDate);
po nadaniu numeru, faktury nie można anulować/usunąć.
Numer faktury (kolejny numer) - numer nadawany w ramach serii zgodnie z ustawą;
w Trawersie może być wspierany szablonem (szczególnie dla JST) i parametrem wypełniania numeru obcego.
OOFF (oznaczenie JPK) - oznaczenie faktury wystawionej w trybie awarii.
Offline24 - tryb wystawiania pozwalający zarejestrować w KSeF z opóźnieniem
do końca następnego dnia roboczego.
Offline24 (tryb wysyłki w Trawers) - tryb wysyłania wybrany w Trawersie (AD_TPK22).
KSeF ostatecznie i tak weryfikuje i nadaje tryb (Online/Offline) wg dat.
Online (SO) - sesja interaktywna wysyłki pojedynczych faktur (limity).
Online (tryb wysyłki w Trawers) - tryb wysyłania wybrany w Trawersie (AD_TPK22).
Okresowa (usługa) - usługa ciągła/okresowa: zamiast konkretnej daty - okres świadczenia;
w KIM pole Okresowa T/N (uslOkres).
Operator (uprawnienia do KSeF) - użytkownik Trawersa; dostęp do skrzynek i certyfikatów
jest sterowany uprawnieniami.
Okres obliczeniowy - wybierany przy tworzeniu nagłówka ZO; można go ustalać wg różnych dat:
bieżąca, wystawienia (P_1), dostawy/zapłaty (P_6), otrzymania/nadania numeru KSeF,
albo inny okres. Wpływa na księgowanie i miesiąc PTU (A4).
Oznacz jako przeczytane - operacja panelu KSeF na fakturze (A4).
PP_1, P_2, P_6, P_8A, P_8B... - pola struktur FA(3), używane do mapowania dat, numerów,
ilości, miary, cen itd.
P_10 Opust - w NAKSeF niewypełniane; ceny P_9A/P_9B zawierają cenę po opuście.
Panel KSeF (NA_PKS00 / ZO_PKS00) - ekrany obsługi faktur KSeF: pobieranie/wysyłka, metadane/status,
wydruki, przenoszenia, wiązanie z NA/ZO.
PESEL (tożsamość w KSeF) - certyfikaty z PZ/podpisu kwal. niosą PESEL;
uprawnienia zależą od nadania w KSeF.
Pieczęć NIP - logowanie do KSeF z pieczęci; certyfikat niesie NIP.
Podmiot1/Podmiot2/Podmiot3 - uczestnicy transakcji w KSeF (sprzedawca/nabywca/dodatkowi).
Powiązanie z fakturą NA/ZO - zapisuje w nagłówku NA/ZO: numer KSeF, SHA, XML; w NA dodatkowo
numer obcy (FNumerNA C 64) gdy dotyczy.
Podmiot1 - sprzedawca (obowiązkowy na fakturze KSeF). Standardowo dane z karty firmy,
a dla JST/GV - z danych płatnika PTU/VAT.
Podmiot2 - nabywca (obowiązkowy). Standardowo dane z karty odbiorcy, a dla JST/GV - z płatnika PTU/VAT.
Podmiot3 - dodatkowy uczestnik transakcji (może wystąpić wielokrotnie),
z określoną rolą (np. Faktor, Odbiorca wewnętrzny, Dodatkowy nabywca, Wystawca faktury,
Dokonujący płatności, role JST/GV, Pracownik).
Powiadomienia o fakturach KSeF - mechanizm informowania operatora o nowych fakturach
w skrzynce (w artykule parametr operatora 1136).
Produkcja (środowisko KSeF) - środowisko realne, skutki prawne; wymaga uwierzytelnienia
rzeczywistymi danymi.
PTU/VAT (stawki) - stawki podatku wymagane do mapowania w konfiguracji KSeF w Trawersie (AD_TPK20);
w razie braków uzupełnia się je w słowniku stawek (AD_TPT10).
RRegex (wyszukiwanie) - tryb wyszukiwania faktur KSeF po fragmentach/nazwach/numerach
z użyciem wyrażeń regularnych.
Rozliczenie (sekcja KSeF) - m.in. kaucje za opakowania; wpływa na DoZapłaty/DoRozliczenia.
SSamofakturowanie - nabywca wystawia fakturę w imieniu sprzedawcy; Trawers potrafi pobrać i powiązać w NA;
nie obsługuje samofakturowania po stronie zakupów.
Skrót SHA - hash XML faktury ustrukturyzowanej; identyfikator w KSeF Head, używany w QR
i do rozróżniania czy faktura już pobrana.
Skrzynki KSeF - logiczne miejsca obiegu/przechowywania faktur (NA0000/ZO0000 + własne),
z folderami i uprawnieniami.
Status podatnika (StatusInfoPodatnika) - status firmy (np. likwidacja, restrukturyzacja, upadłość itd.),
mapowany w danych firmy.
TTestowe / Demo / Produkcyjne - środowiska KSeF (T/D/P), różnią się skutkami prawnymi
i sposobem uwierzytelnienia.
Trawers 'ds' - wersje programu z obsługą KSeF i nowymi wymaganiami technologicznymi.
trinout - katalog wymiany/plików, wskazany jako miejsce składowania *.crt/*.key dla operatora.
Tryb pobierania (3 formy) - bezpośrednio (API), via XML import, manualnie (PDF/wydruk + numer KSeF).
* Forma 1 Bezpośrednia (machine-machine): Trawers pobiera XML + metadane przez API, wymaga certyfikatu.
* Forma 2 Plik XML: użytkownik pobiera XML z portalu KSeF i importuje do Trawersa.
* Forma 3 Wydruk/PDF: ręczne wprowadzanie danych + przypisanie numeru KSeF do dokumentu w Trawersie.
Tryb Offline (wniosek z dat) - jeśli data wystawienia faktury (3) różni się od daty przesłania do KSeF
widocznej w numerze KSeF, to oznacza wystawienie w trybie Offline (A4).
UUPO - urzędowe poświadczenie odbioru; do pobrania na podstawie statusu/identyfikatorów.
Uprawnienia KSeF vs Uprawnienia Trawersa - KSeF nadaje się na tożsamość (NIP/PESEL),
a Trawers dodatkowo ogranicza role/operatorów do funkcji/certyfikatów/skrzynki.
Uwierzytelnienie - proces potwierdzania tożsamości w KSeF; w integracji realizowane certyfikatem
(dla demo/produkcji realne dane, dla test uproszczone).
Upust (mapowanie do ZO) - A4: w KSeF upust bywa wartościowy, a w ZO procentowy;
dlatego pole 'Upust' jest pomijane, a 'Cena z upustem' przyjmuje się równą cenie (A4).
WWalidacja XSD - weryfikacja XML faktury ustrukturyzowanej przed wysyłką.
Weryfikacja faktury/wystawcy - realizowana przez QR/link: sprawdzenie faktury w KSeF
i/lub weryfikacja wystawcy po certyfikacie.
Windows (Trawers-W) - wymaga mingw32_ds dla KSeF; wersja ds w TUI, GUI bez KSeF w starym mingw32.
WSTO_EE / OSS/IOSS - procedury szczególne; w dokumentacji jest uwaga, że Trawers
nie ujmuje sprzedaży OSS/IOSS oraz marży.
Wysyłać faktury do KSeF? (AD_TPK22) - parametr globalny uruchamiający automatyczne oznaczanie
nowo wystawianych faktur sprzedaży jako 'Wysłać do KSeF [T]' (A1, A5).
Wysłać do KSeF [T/N] (pole w nagłówku faktury NA) - flaga na fakturze sprzedaży,
czy ma być wysłana; ustawiana automatycznie po włączeniu wysyłki, ale może być ręcznie
zmieniana przez uprawnionego operatora (A5).
Wysyłka zbiorcza (NA_DWK01) - funkcja wysyłania paczek zbiorczych dla wybranych
rodzajów dokumentów i zakresu faktur (A5).
Xx86-64-v2 - minimalna architektura procesora wymagana do uruchomienia oprogramowania.
ZZałączniki XML (KSeF) - załączniki w fakturze: słownik/tekst/tabele w limitach;
w Trawersie do przeglądania/eksportu.
Zapisane / Wysłane / Pobrane - foldery skrzynek KSeF; Pobrane po opracowaniu Zapisane;
Wysłane po nadaniu numeru KSeF.
Niespójności i rekomendacje ujednolicenia
1. ZO AutoRun: Podmiot1 jako nabywca
* W artykułach ogólnych zakup = my jako Podmiot2/Podmiot3, a w jednym miejscu pojawia się Podmiot1 (Nabywca).
Rekomendacja: ujednolicić na: *ZO pobiera, gdy jesteśmy Podmiot2 (Nabywca) lub Podmiot3*.
2. Role Podmiot3: nieobsługiwane vs pobierane
* W opisie generowania sprzedaży: Trawers nie obsługuje roli [0] i [11], ale w pobieraniu role te mogą się pojawić
i są klasyfikowane jako NA/ZO.
Rekomendacja: dopisać rozróżnienie: *nieobsługiwane = niegenerowane przez Trawers w NAKSeF; pobierane = mogą wystąpić w fakturach zewnętrznych i są obsługiwane w odbiorze*.
3. FA(3) vs FA (3)
* Jednocześnie zalecana pisownia FA(3) i wymóg techniczny w kodzie FA (3).
Rekomendacja: w dokumentacji użytkowej wszędzie FA(3), a w notach dla programistów dopisek o stringu/technicznej nazwie.
4. ILN vs GLN
* Oba terminy używane zamiennie.
Rekomendacja: przyjąć GLN jako główny, a ILN jako alias historyczny.
5. BFK jako oznaczenie w dwóch scenariuszach
* BFK: brak wysyłki (przed obowiązkiem) oraz awaria całkowita.
Rekomendacja: w słowniku dodać: *BFK = brak numeru KSeF z powodu (a) polityki wysyłki lub (b) awarii całkowitej; rozróżnić po polu awarii i konfiguracji wysyłki*.
6. Numer obcy / P_2 / FNumerNA / Numer KSeF
* Pojęcia bywają mylone.
Rekomendacja: zawsze stosować cztery rozłączne nazwy:
* Numer KSeF (Identyfikator KSeF)
* Numer faktury (P_2) / numer wystawcy
* Nasz numer w Trawersie
* Numer obcy (FNumerNA) - gdy dotyczy NA
## 3) Uprawnienia na certyfikat
Błędne założenie: nadaję prawa certyfikatowi.
Poprawnie: prawa w KSeF są na tożsamość (NIP/PESEL), certyfikat tylko ją przenosi. Dodatkowo Trawers może ograniczyć funkcje rolami/operatorami.
Co robić: rozdzielić w instrukcji: *uprawnienia w KSeF* vs *uprawnienia w Trawersie*.
---
Jeśli chcesz, mogę też (na podstawie tego słownika) przygotować
wersję do publikacji: krótsze definicje + odsyłacze Artykuł X / moduł / funkcja
oraz osobny rozdział Najczęstsze pomyłki pojęciowe (numer KSeF vs P_2, role Podmiot3, Offline/Offline24, DI/OFF/BFK).
*******************************
Pewnie - poniżej masz wersję do publikacji:
krótsze definicje + odsyłacze (Artykuł / moduł / funkcja) oraz osobny rozdział
Najczęstsze pomyłki pojęciowe.
Oparłem się wyłącznie na treści 6 artykułów.
---
KSeF w Trawers ERP - słownik pojęć (wersja do publikacji)Jak czytać odsyłacze
* A1...A6 - numer artykułu (1-6) z Twojego pakietu
* Moduł - NA/ZO/ZA/JP/AD/KG/...
* Funkcja/Tabela - symbol typu `[AD_TPK22]`, `[ZO_PKS00]` itd.
---
AacquisitionDate - data otrzymania faktury (w metadanych KSeF; praktycznie: data nadania numeru KSeF),
domyślna Otrzymanej w ZO.
Odsyłacze: A4 (nagłówek ZO, metadane).
AD (Administracja) - moduł ustawień KSeF: środowisko, certyfikaty, skrzynki, harmonogramy, uprawnienia, limity.
Odsyłacze: A1 (menu KSeF w AD), A6 (moduły).
AdminKSeF - osoba operacyjnie odpowiedzialna za działanie integracji (monitoring, kolejki, porównanie statusów, diagnoza).
Odsyłacze: A1.
Aplikacja Podatnika KSeF - portal MF do obsługi KSeF, m.in. generowania certyfikatów (osobno dla test/demo/produkcyjnego).
Odsyłacze: A1, A3.
Autorun - automatyczna komunikacja w tle (pobieranie/wysyłka) realizowana harmonogramem i często operatorem wirtualnym.
Odsyłacze: A1 (harmonogram), A3 (model auto/ręczny), A4/A5 (odświeżanie/pobieranie), A6.
Awaria KSeF (tabela awarii) - zapis rodzaju i okresu awarii; podczas awarii program tworzy XML+SHA i odkłada do Do wysłania.
Odsyłacze: A5, tabela [AD_TAW01].
---
BBatch (SB) - sesja wysyłki zbiorczej paczki faktur.
Odsyłacze: A5.
BFK / DI / OFF - oznaczenia dla JPK, gdy brak numeru KSeF (zależnie od scenariusza: brak wysyłki, awaria itp.).
Odsyłacze: A5.
BrakID - oznaczenie braku identyfikatora podatkowego (gdy brak NIP).
Odsyłacze: A1 (priorytety identyfikatorów), A5 (Podmiot2/3).
---
CCertyfikat KSeF - narzędzie kryptograficzne do uwierzytelnienia; niesie tożsamość (NIP/PESEL).
Odsyłacze: A1 (konfiguracja), A3 (tożsamość i uprawnienia), A6.
Certyfikat [U] Uwierzytelnienie - certyfikat do logowania/połączenia z KSeF.
Odsyłacze: A1, A3, tabela [AD_TCE01].
Certyfikat [P] Podpis linku - certyfikat do podpisywania linku weryfikacyjnego (np. dla kodów QR).
Odsyłacze: A1, A3, A5.
CRWDE - repozytorium wzorów dokumentów; Trawers może wygenerować HTML wizualizacji wg wzoru CRWDE.
Odsyłacze: A4.
---
DDodatkowyOpis - sekcja klucz-wartość dla faktury/pozycji (np. GTIN, NumerWZ <WZ>, VIN, wagi, ID towaru u nabywcy).
Odsyłacze: A1 (klucze), A4 (wykorzystanie w ZO), A5 (konfiguracja [AD_TPK21]).
Do wysłania / Wysłane / Pobrane / Zapisane - foldery porządkujące faktury w skrzynce KSeF.
Odsyłacze: A1 (foldery), A4 (ZO panel), A5 (NA panel), A6.
Duplikat faktury (440) - odrzucenie w KSeF gdy powtarza się (NIP sprzedawcy + P_2 + rodzaj).
Odsyłacze: A5.
---
EEDI / GS1 - standardy wymiany i identyfikacji (np. klucze GS1 w DodatkowyOpis).
Odsyłacze: A1, A6.
EORI - numer identyfikacyjny w obrocie celnym (może być w danych podmiotów).
Odsyłacze: A1.
---
FFA(3) - schemat logiczny faktury ustrukturyzowanej (XML). Zalecane FA(3) w tekstach; FA (3) bywa wymogiem technicznym w kodzie/nazewnictwie.
Odsyłacze: A1 (FA(3)), A5 (walidacja, broszura), A6 (nota o pisowni).
Faktura ustrukturyzowana - faktura w XML wg schemy MF, przesłana do KSeF i identyfikowana numerem KSeF.
Odsyłacze: A1, A6.
FNumerNA (Numer obcy) - numer faktury od wystawcy widoczny w NA (np. samofakturowanie, faktury z innych programów).
Odsyłacze: A1 (JST i numer obcy), A5 (samofakturowanie, wiązanie).
---
GGLN / ILN - identyfikator lokalizacji (adres/miejsce dostawy); w dokumentacji występuje wymiennie.
Odsyłacze: A1, A4, A6.
GTIN (EAN/KID) - identyfikator towaru; źródło mapowania: KIM lub dane z faktury.
Odsyłacze: A1 (ustawienia), A4 (mapowanie w zakupach), A6.
GUI / TUI - tryby interfejsu; KSeF obecnie wspierany głównie w TUI (szczególnie w wersjach ds).
Odsyłacze: A2.
---
HHarmonogram KSeF - ustawienia cyklicznego pobierania/wysyłki (Autorun).
Odsyłacze: A1, tabela [AD_TPK22].
---
IIDWew (InternalId) - identyfikator wewnętrzny; może być kontekstem logowania i identyfikatorem Podmiot3.
Odsyłacze: A1, A3, A6.
Identyfikator KSeF / Numer KSeF - numer nadany przez KSeF; moment nadania = moment otrzymania; nie da się anulować/usunąć faktury po nadaniu.
Odsyłacze: A1, A5, A6.
invoiceNumber - metadane: numer faktury nadany przez wystawcę (numer obcy).
Odsyłacze: A4, A5.
---
JJPK a KSeF - do JPK trafia numer KSeF (jeśli nadany) albo oznaczenie DI/OFF/BFK.
Odsyłacze: A5, A6 (moduł JP).
Jm KSeF - zamienniki jednostek miary z KSeF, mapowane do jednostek w KIM.
Odsyłacze: A4.
---
KKontekst logowania - NIP lub IDWew z karty firmy; wpływa na to, które faktury są nasze przy pobieraniu.
Odsyłacze: A1, A3, A5.
Kod QR - graficzny nośnik kodu weryfikującego/linku; służy do weryfikacji faktury i/lub wystawcy.
Odsyłacze: A5, A6.
Kod weryfikujący - QR lub link kierujący do weryfikacji/identyfikacji faktury; stosowany także przy przekazaniu w sposób uzgodniony.
Odsyłacze: A6.
KSeF Head - zbiór nagłówków faktur KSeF w Trawersie; identyfikatorem unikalnym jest skrót SHA.
Odsyłacze: A5.
---
LLimity API - ograniczenia wywołań/wysyłki; można pobrać i zaktualizować w funkcjach limitów.
Odsyłacze: A1, A5, [AD_TLK01], [AD_TLK02].
---
MMemo (opis faktury KSeF) - dziennik zdarzeń/WorkFlow: komentarze + automatyczne wpisy (powiązania, przeniesienia).
Odsyłacze: A4, A6.
Metadane - informacje opisowe/techniczne faktury obok XML (kwoty, daty, numery, SHA).
Odsyłacze: A4, A5.
---
NNA (Sprzedaż) - moduł sprzedaży: generowanie i wysyłka do KSeF, pobieranie sprzedaży (np. samofakturowanie), panel NA.
Odsyłacze: A1, A5, A6.
NA_PKS00 - Panel KSeF w NA.
Odsyłacze: A5.
NIP / PESEL (tożsamość) - uprawnienia w KSeF nadaje się na tożsamość; certyfikat przenosi NIP (pieczęć) albo PESEL (PZ/podpis).
Odsyłacze: A3, A6.
---
OOFF / Offline24 / Offline
* Offline24 - tryb wystawiania pozwalający wysłać do końca następnego dnia roboczego (ustawienie i procesy w Trawersie).
* Offline - tryb nadawany/rozpoznawany w KSeF (m.in. po datach).
Odsyłacze: A1 (Offline24), A4 (wniosek z dat), A5 (awarie, tryby), A6.
Online (SO) - sesja pojedynczych wysyłek, ograniczona limitami.
Odsyłacze: A5.
---
PPanel KSeF (ZO_PKS00 / NA_PKS00) - główny ekran obsługi: pobieranie/wysyłka, statusy, metadane, wizualizacje, przenoszenia, wiązanie z NA/ZO.
Odsyłacze: A4, A5.
Podmiot1 / Podmiot2 / Podmiot3 - uczestnicy transakcji w fakturze KSeF: sprzedawca / nabywca / podmioty dodatkowe z rolami.
Odsyłacze: A1, A5, A6.
Powiązanie faktury NA/ZO z fakturą KSeF - zapis numeru KSeF, SHA i XML w nagłówku NA/ZO; kluczowe dla JPK i spójności danych.
Odsyłacze: A4, A5.
Przekazanie faktury w sposób uzgodniony - przekazanie nabywcy faktury w formie innej niż XML (np. EDI), przy zachowaniu kodu weryfikującego.
Odsyłacze: A6, A5 (wydanie faktury poza KSeF).
---
RRozliczenie (sekcja) - element faktury KSeF obejmujący dodatkowe obciążenia/odliczenia (np. kaucje).
Odsyłacze: A5.
---
SSamofakturowanie - nabywca wystawia fakturę w imieniu sprzedawcy; Trawers może pobrać i powiązać w NA; nie obsługuje samofakturowania po stronie zakupu.
Odsyłacze: A5.
Skrzynki KSeF - kontenery obiegu (odbiór/wysyłka/przechowywanie), z folderami i uprawnieniami; standardowo NA0000/ZO0000.
Odsyłacze: A1, A4, A5, A6.
Skrót SHA - hash XML faktury; identyfikator unikalny w KSeF Head; używany w kodach QR i do deduplikacji pobierania.
Odsyłacze: A4, A5.
Statusy faktury (KSeF) - zestaw kodów przetwarzania (100/150/200/430/440/) plus warstwa HTTP.
Odsyłacze: A5.
---
TTrawers ds - wydania Trawers z obsługą KSeF i wyższymi wymaganiami (biblioteki/środowisko).
Odsyłacze: A2.
Tryby pobierania - 3 ścieżki: bezpośrednio API, import XML, manualnie (PDF/wydruk + numer KSeF).
Odsyłacze: A1, A5.
trinout - katalog roboczy, do którego odkłada się pliki certyfikatu/klucza (`*.crt`, `*.key`).
Odsyłacze: A3.
---
UUPO - urzędowe poświadczenie odbioru (pobierane wg statusu/sesji).
Odsyłacze: A5.
Uprawnienia (KSeF vs Trawers) - KSeF: na tożsamość (NIP/PESEL); Trawers: dodatkowo na role/operatorów/funkcje/certyfikaty/skrzynki.
Odsyłacze: A3, A6.
---
WWalidacja XSD - kontrola zgodności XML z FA(3) przed wysyłką (raport błędów pomaga znaleźć brakujące elementy).
Odsyłacze: A5.
Wydanie faktury nabywcy - zależnie od scenariusza: wydruk/wizualizacja z QR, przekazanie poza KSeF (uzgodnione), potwierdzenie transakcji gdy brak numeru KSeF.
Odsyłacze: A5, A6.
Wysyłać do KSeF? - globalny przełącznik rozpoczęcia wysyłki (wpływa na automatyczne oznaczanie faktur).
Odsyłacze: A1, A5, [AD_TPK22].
---
ZZałączniki XML - dodatkowe dane do faktury (słownik/tekst/tabele) z limitami; możliwy eksport do CSV/XLS.
Odsyłacze: A4.
ZO (Zakupy) - moduł zakupów: pobieranie z KSeF, kreator rejestracji, wiązanie, autorun.
Odsyłacze: A1, A4, A6.
ZO_PKS00 - Panel KSeF w ZO.
Odsyłacze: A4.
---
Najczęstsze pomyłki pojęciowe
## 1) Numer KSeF vs numer faktury (P_2) vs nasz numer
* Numer KSeF: identyfikator systemowy KSeF (inny numer niż fakturowy).
* P_2: kolejny numer faktury (numer faktury od wystawcy).
* Nasz numer: numer dokumentu w Trawersie (np. FA0001/05/26).
Co robić w opisach/szkoleniach: zawsze używać pełnych nazw jak wyżej, nie skrótów numer.
## 2) Offline vs Offline24
* Offline24: tryb/proces po stronie wystawcy (Trawers) i przepisów (opóźniona rejestracja).
* Offline: wynik/tryb widoczny w KSeF (i często wnioskowany z dat).
Co robić: dopisać w materiałach wdrożeniowych, że ustawienie w Trawersie # etykieta w KSeF.
## 3) Uprawnienia na certyfikat
Błędne założenie: nadaję prawa certyfikatowi.
Poprawnie: prawa w KSeF są na tożsamość (NIP/PESEL), certyfikat tylko ją przenosi. Dodatkowo Trawers może ograniczyć funkcje rolami/operatorami.
Co robić: rozdzielić w instrukcji: *uprawnienia w KSeF* vs *uprawnienia w Trawersie*.
## 4) Role Podmiot3: nieobsługiwane a występują
W dokumentacji:
* pewne role Podmiot3 mogą wystąpić w pobranych fakturach (logika pobierania je klasyfikuje),
* ale mogą nie być generowane przez Trawers w NA > KSeF.
Co robić: dopisać przy rolach dwie kolumny: Generowanie przez Trawers i Obsługa w pobieraniu.
## 5) ILN i GLN
To często ten sam sens (GS1), ale dokumentacja miesza nazwy.
Co robić: przyjąć GLN jako standard, a ILN jako alias.
## 6) DI / OFF / BFK w JPK
Łatwo pomylić, że DI/OFF/BFK to status w KSeF. To są etykiety na potrzeby raportowania, gdy nie ma numeru KSeF.
Co robić: w instrukcji JPK dodać krótką tabelę: kiedy numer KSeF, kiedy DI/OFF/BFK.
---
Dodatkowy zestaw: mini-FAQ do wdrożenia (1 strona)
Jeśli chcesz, mogę też z tego zrobić jedną stronę (FAQ dla serwisu i użytkowników), np.:
* Dlaczego nie mam GUI w wersji ds?
* Czemu mam DI, skoro wysłałem fakturę?
* Czemu mam numer obcy inny niż mój numer?
* Jak rozpoznać offline z numeru KSeF?
Powiedz tylko, czy wersję publikacyjną wolisz jako:
* krótka (1-2 strony), czy
* pełna (z tabelami i przykładami ekranów/ścieżek).
**************
Poniżej krótka, 1-2 strony wersja publikacyjna: **mini-słownik + mini-FAQ +
najważniejsze rozróżnienia**.
---
KSeF w Trawers ERP - krótki słownik pojęć
## 1) Dokumenty i identyfikatory
Faktura ustrukturyzowana - e-Faktura w XML wg schemy MF (FA(2)/FA(3)), przesyłana przez KSeF.
FA(3) - schemat logiczny XML; w tekstach zalecane FA(3) (technicznie czasem spotkasz FA (3)).
Numer KSeF (Identyfikator KSeF) - numer nadany przez KSeF; moment nadania = moment otrzymania faktury; po nadaniu faktury nie da się anulować/usunąć.
P_2 (numer faktury) - kolejny numer faktury (numer wystawcy). To nie jest numer KSeF.
Nasz numer - numer dokumentu w Trawersie (np. FA0001/).
Skrót SHA - hash XML faktury; unikalny identyfikator w zbiorze nagłówków (KSeF Head) i podstawa m.in. do QR/deduplikacji pobrań.
## 2) Podmioty na fakturze KSeF
Podmiot1 - sprzedawca.
Podmiot2 - nabywca.
Podmiot3 - dodatkowe podmioty (role: np. Faktor, Dodatkowy nabywca, Płatnik, role JST/GV itd.).
IDWew (InternalId) - identyfikator wewnętrzny (np. oddziału); może być kontekstem logowania i identyfikatorem w Podmiot3.
## 3) Środowiska
TEST / DEMO / PROD - środowiska KSeF (różnią się skutkami prawnymi i sposobem uwierzytelnienia).
W testach: kopia robocza + anonimizacja danych.
## 4) Certyfikaty i uprawnienia
Certyfikat KSeF - kryptograficzny 'klucz' dostępu do KSeF;
niesie tożsamość: NIP (pieczęć) lub PESEL (Profil Zaufany / podpis kwalifikowany).
Uprawnienia w KSeF - nadaje się na tożsamość (NIP/PESEL), nie na certyfikat.
Uprawnienia w Trawersie - niezależna warstwa: role/operatorzy, dostęp do funkcji, skrzynek i certyfikatów.
## 5) Skrzynki, foldery, panele
Skrzynki KSeF - kontenery obiegu faktur (np. NA0000/ZO0000 + własne).
Foldery - Pobrane / Zapisane / Do wysłania / Wysłane.
Panel KSeF (NA/ZO) - miejsce do pobierania/wysyłki, metadanych/statusów, wizualizacji/wydruku, przenoszeń, wiązania z NA/ZO.
## 6) Wysyłka, pobieranie, tryby
Wysłać do KSeF [T/N] - flaga w nagłówku faktury NA.
Wysyłać faktury do KSeF? [AD_TPK22] - globalne uruchomienie wysyłki (dopiero wtedy nowe faktury są automatycznie oznaczane).
Autorun - automatyczny tryb w tle (harmonogram).
Offline24 - tryb wystawiania pozwalający zarejestrować w KSeF z opóźnieniem do końca następnego dnia roboczego.
Offline (w KSeF) - tryb widoczny/wnioskowany po stronie KSeF (np. po datach).
## 7) Metadane i JPK
Metadane - dane obok XML (np. acquisitionDate, invoiceNumber, netAmount/vatAmount/grossAmount).
acquisitionDate - data nadania numeru KSeF; w ZO domyślna Otrzymanej.
JPK - jeśli numer KSeF jest nadany zapisuje się numer KSeF; jeśli nie zapisuje się oznaczenie DI/OFF/BFK (zależnie od scenariusza).
---
# Najczęstsze pomyłki pojęciowe
1. Numer KSeF # P_2 # nasz numer
Numer KSeF identyfikuje fakturę w KSeF. P_2 to numer faktury wystawcy. Nasz numer to numer w Trawersie.
2. Offline # Offline24
Offline24 to proces/tryb wystawiania. Offline to etykieta/tryb po stronie KSeF.
3. Uprawnienia na certyfikat
W KSeF uprawnienia są na NIP/PESEL. Certyfikat tylko niesie tożsamość.
4. Role Podmiot3 nieobsługiwane
Część ról może nie być generowana przez Trawers w wysyłce, ale może wystąpić w fakturach pobranych (i wtedy jest obsługiwana w odbiorze).
---
Mini-FAQ wdrożeniowe (serwis / użytkownik)Dlaczego faktury nie wysyłają się, mimo że mam certyfikat?
Najczęściej nie włączono globalnie wysyłki: AD_TPK22 Wysyłać faktury do KSeF? [T] lub faktura nie ma Wysłać do KSeF [T] i nie jest zatwierdzona.
Dlaczego w JPK mam DI/OFF/BFK zamiast numeru KSeF?
Bo numer KSeF nie został jeszcze nadany (faktura w kolejce/odrzucona/awaria).
Czemu mam fakturę w Do wysłania, ale widzę, że była wysyłana?
Wysyłka ma etap odpytywania statusu; przerwanie lub błąd zostawia fakturę w Do wysłania do dokończenia.
Jak bezpiecznie testować?
Na kopii roboczej lub DEMO/TEST + anonimizacja danych.
Czemu na Windows nie mam GUI w wersji ds?
W środowisku `mingw32_ds` przewidziano TUI dla KSeF; GUI pozostaje w starym środowisku bez KSeF.
---
Jeśli chcesz, mogę to jeszcze skondensować do jednej strony (bez rozdziału metadanych i bez FAQ technicznego), ale ta wersja zwykle dobrze się sprawdza jako wkładka do dokumentacji wdrożeniowej.
**************