Baza wiedzy Trawers ERP

KSeF. Załączniki .XML

1. Załączniki .XML w fakturze KSeF 2. Przykład wizualizacji faktury 3. Rola i zastosowanie 4. Raportowane na danych z załączników 5. Tematy powiązane

1. Załączniki .XML w fakturze KSeF

1.1 Budowa i zawartość

W KSeF słowo 'załącznik' oznacza dodatkowe, ustrukturyzowane dane w XML. Załączniki .XML, 'wbudowane' do struktury .XML, należy odróżnić od 'Załączniki [&]', tj. dodatkowe pliki (PDF, JPG, DOCX) i URL (adresy internetowe), dołączane do dokumentów i kartotek systemowych (np. faktur, zamówień, kartotek kontrahentów). Patrz szczegóły nt. Załączniki [&]: Załączniki [&]. Dokumenty powiązane Załączniki .XML, widać na fakturze jako osobne pozycje: Załącznik 1, Załącznik 2, Załącznik 3 ... Najczęściej można je spotkać na fakturach: * paliwowych (rozbicia, rabaty, CN), * telekom / media (rozbicia okresów, usług), * fakturach z bardziej szczegółowym zestawieniem niż standardowe pozycje. Przeglądanie załączników, kolejne kroki: 1. Otwarcie faktury zakupu (z KSeF). 2. F2 > Załączniki .XML Lista: * Załącznik 1 * Załącznik 2 * Załącznik 3 3. Po rozwinięciu wybranego załącznika, Trawers pokazuje zwykle dwie sekcje: * 1. Metadane * 2. Tabele Co oznaczają: Metadane Metadane informują o charakterze (rodzaju) prezentowanych danych * typ zestawienia (np. Wykaz dla pozycji paliwowych faktury), * liczba/klucz (np. 690). '690' jest identyfikatorem, do której pozycji faktury są dane. Na fakturach paliwowych (najczęściej): * pozycja faktury ma swój identyfikator, * a załącznik pokazuje rozbicie szczegółowe właśnie dla tej pozycji. Co oznaczają: Tabele Tabele to właściwa zawartość załącznika - szczegóły, których nie widać w standardowych pozycjach faktury. Np. tabela ma kolumny: * Lp * PozycjaFaktury * CenaRabat * NazwaProduktu * Ilość * JM * VAT * WBrutto * MVat * WNetto Wiersze w tabeli pokazują np. że jedna pozycja faktury (np. 690) jest rozbita na kilka pozycji szczegółowych (np. 2 wiersze z różną ceną rabatową i ilością). o------------------------------------------------------------------------------------------------------ |Lp PozycjaFaktury CenaRabat NazwaProduktu Ilosc JM VAT WBrutto WVat WNetto | |------------------------------------------------------------------------------------------------------ |1.00| 690.00| 5.88|EFECTA DIESEL CN27102011| 77.53|l/kg|23 455.88| 85.25| 370.63| |2.00| 690.00| 5.98|EFECTA DIESEL CN27102011| 60.00|l/kg|23 358.80| 67.09| 291.71| o------------------------------------------------------------------------------------------------------

1.2 Interpretacja załącznika

Przykład interpretacji: * Pozycje faktury (na głównej zakładce/pozycjach dokumentu) mówią: Kupiono paliwo X, ilość 137,53 L, wartość netto 662,34, VAT 152,34. * Załącznik mówi: Ta pozycja została policzona z dwóch składowych: - 77,53 L po cenie rabatowej 5,88 - 60,00 L po cenie rabatowej 5,98 ... i z tego wyszły końcowe wartości. Załącznik to jest uzasadnienie / uszczegółowienie kalkulacji. Cel i przydatność załączników 1. Weryfikowanie rabatów/cen (czy cena rabatowa i ilości się zgadzają z umową) 2. Weryfikowanie ilości (czy rozbicie sumuje się do ilości z pozycji faktury) 3. Weryfikowanie kwot (czy suma netto/VAT/brutto z tabeli pasuje do pozycji faktury - czasem różnice 0,01 - 0,02 wynikają z zaokrągleń) 4. Odszukanie informacji branżowych (np. CN produktu, okres rozliczeniowy, numer usługi itp. - zależnie od typu faktury) Jest wiele załączników - co to oznacza ? * faktura ma kilka pozycji, które wymagają rozbicia, * każdy załącznik dotyczy innej pozycji (np. 680, 690, 730). Kolejne kroki: * Załącznik 1 -> widać: '...: 680' -> to zestawienie do pozycji 680, * Załącznik 2 -> widać: '...: 690' -> do pozycji 690, * Załącznik 3 -> widać: '...: 730' -> do pozycji 730. Przypomnienie: To co widać w zakładce Załączniki przy KSeF, to nie są pliki PDF. To są dane z .XML faktury pokazane w formie metadanych i tabel.

1.3 Krótka instrukcja - stanowiskowa

1. Otwórzyć fakturę z KSeF, wejść w zakładkę Załączniki. 2. Rozwinąć Załącznik 1/2/3... - każdy załącznik to osobny zestaw danych do konkretnej pozycji. 3. W sekcji Metadane można zobaczyć, czego dotyczy zestawienie i klucz (np. '...: 690') - zwykle wskazuje powiązaną pozycję faktury. 4. W sekcji Tabele są szczegóły (np. rabaty/ceny/ilości/kwoty) - to 'rozbicie' pozycji faktury na wiersze składowe. 5. Treść załączników można stosować do kontroli i analiz (np. czy rabaty i ilości się zgadzają); to nie są pliki PDF, tylko dane z .XML pokazane tabelarycznie.

2. Przykład wizualizacji faktury

Zapis wizualizacji faktury + treść załącznika .XML (poniżej).

2.1 KSeF - Faktura VAT (FA(3))

Faktura Nr faktury: 0491362815 Data wystawienia (P_1): 2026-02-17 Miejsce wystawienia (P_1M): Płock Data sprzedaży / dostawy (P_6): 2026-02-15 Waluta: PLN Rodzaj faktury: VAT ## Sprzedawca (Podmiot1) ORLEN S.A. NIP: 7740001454 Adres: 09-411 Płock, ul. Chemików 7 GLN: 5909000300002 ## Nabywca (Podmiot2) PRZEDSIĘBIORSTWO BUDOWLANE BUD SPÓŁKA AKCYJNA NIP: 7642234249 Adres: 89-320 Wyrzysk, 03 Marca 53 Nr klienta: 0007126640 Pozycje faktury (FaWiersz) 1. EFECTA DIESEL * UU_ID: 0491362815000680 * Indeks: S-01230-0 * PKWiU: 232015001 * JM: L * Ilość: 200.04 * Netto (P_11): 951.41 * VAT (P_11Vat): 218.82 * Stawka VAT (P_12): 23% * Akcyza: 232.05 * GTU: GTU_02 2. EFECTA DIESEL OSOBOWY * UU_ID: 0491362815000690 * Indeks: S-01230-1 * PKWiU: 232015001 * JM: L * Ilość: 137.53 * Netto (P_11): 662.34 * VAT (P_11Vat): 152.34 * Stawka VAT (P_12): 23% * Akcyza: 15953 * GTU: GTU_02 3. EFECTA 95 OSOBOWY * UU_ID: 0491362815000730 * Indeks: S-03230-1 * JM: L * Ilość: 60.95 * Netto (P_11): 287.37 * VAT (P_11Vat): 66.10 * Stawka VAT (P_12): 23% * Akcyza: 93.19 * GTU: GTU_02 ## Podsumowanie * Netto (P_13_1): 1901.12 * VAT (P_14_1): 437.26 * Brutto / Do zapłaty (P_15 / Rozliczenie/DoZaplaty): 2338.38 PLN ## Płatność Termin płatności: 2026-03-01 (14 dni, odbiorcy - od sprzedaży) Forma płatności: 6 Rachunek bankowy: PL77 1240 6760 7766 0000 0002 6430 SWIFT: PKOPPLPW Bank: Bank Pekao S.A. F/Szczecin ## Warunki transakcji Zamówienie: DZF00/03331/001/2017 Data zamówienia: 2026-02-15 Warunki dostawy: EXW PŁOCK

2.2 Załącznik .XML (FA(3))

/Faktura/Zalacznik ZKlucz: 'Wykaz dla pozycji paliwowych faktury' Występują 3 bloki: ZWartosc = 680, 690, 730 (powiązane z pozycjami faktury przez końcówkę UU_ID: ...0680/...0690/...0730). Kolumny tabel (TNaglowek) Lp | PozycjaFaktury | CenaRabat | NazwaProduktu | Ilosc | JM | VAT | WBrutto | WVat | WNetto Blok ZWartosc = 680 | Lp | PozycjaFaktury | CenaRabat | NazwaProduktu | Ilosc | JM | VAT | WBrutto | WVat | WNetto | | -: | -------------: | --------: | ------------------------ | -----: | ---- | --- | --------: | -------: | -------: | | 1 | 680 | 5.8500 | EFECTA DIESEL CN27102011 | 200.04 | l/kg | 23 | 1170.2300 | 218.8200 | 951.4100 | Suma bloku 680: Netto 951.41 / VAT 218.82 / Brutto 1170.23 Blok ZWartosc = 690 | Lp | PozycjaFaktury | CenaRabat | NazwaProduktu | Ilosc | JM | VAT | WBrutto | WVat | WNetto | | -: | -------------: | --------: | ------------------------ | ----: | ---- | --- | -------: | ------: | -------: | | 1 | 690 | 5.8800 | EFECTA DIESEL CN27102011 | 77.53 | l/kg | 23 | 455.8800 | 85.2500 | 370.6300 | | 2 | 690 | 5.9800 | EFECTA DIESEL CN27102011 | 60.00 | l/kg | 23 | 358.8000 | 67.0900 | 291.7100 | Suma bloku 690: Netto 662.34 / VAT 152.34 / Brutto 814.68 Blok ZWartosc = 730 | Lp | PozycjaFaktury | CenaRabat | NazwaProduktu | Ilosc | JM | VAT | WBrutto | WVat | WNetto | | -: | -------------: | --------: | -------------------- | ----: | ---- | --- | -------: | ------: | -------: | | 1 | 730 | 5.6800 | EFECTA 95 CN27101245 | 5.01 | l/kg | 23 | 28.4600 | 5.3200 | 23.1400 | | 2 | 730 | 5.8100 | EFECTA 95 CN27101245 | 55.94 | l/kg | 23 | 325.0100 | 60.7700 | 264.2400 | Suma bloku 730: Netto 287.38 / VAT 66.09 / Brutto 353.47 (Uwaga: możliwa różnica zaokrągleń vs `FaWiersz`: 287.37 / 66.10)

2.3 Załącznik .XML (fragment faktury KSeF)

<Zalacznik xmlns:n0='http://crd.gov.pl/wzor/2025/06/25/13775/'> <BlokDanych> ... </BlokDanych> <BlokDanych> <MetaDane> <ZKlucz>Wykaz dla pozycji paliwowych faktury</ZKlucz> <ZWartosc>690</ZWartosc> </MetaDane> <Tabela> <TNaglowek> <Kol Typ='int'> <NKom>Lp</NKom> </Kol> <Kol Typ='int'> <NKom>PozycjaFaktury</NKom> </Kol> <Kol Typ='dec'> <NKom>CenaRabat</NKom> </Kol> <Kol Typ='txt'> <NKom>NazwaProduktu</NKom> </Kol> <Kol Typ='dec'> <NKom>Ilosc</NKom> </Kol> <Kol Typ='txt'> <NKom>JM</NKom> </Kol> <Kol Typ='txt'> <NKom>VAT</NKom> </Kol> <Kol Typ='dec'> <NKom>WBrutto</NKom> </Kol> <Kol Typ='dec'> <NKom>WVat</NKom> </Kol> <Kol Typ='dec'> <NKom>WNetto</NKom> </Kol> </TNaglowek> <Wiersz> <WKom>1</WKom> <WKom>690</WKom> <WKom>5.8800</WKom> <WKom>EFECTA DIESEL CN27102011</WKom> <WKom>77.53</WKom> <WKom>l/kg</WKom> <WKom>23</WKom> <WKom>455.8800</WKom> <WKom>85.2500</WKom> <WKom>370.6300</WKom> </Wiersz> <Wiersz> <WKom>2</WKom> <WKom>690</WKom> <WKom>5.9800</WKom> <WKom>EFECTA DIESEL CN27102011</WKom> <WKom>60.00</WKom> <WKom>l/kg</WKom> <WKom>23</WKom> <WKom>358.8000</WKom> <WKom>67.0900</WKom> <WKom>291.7100</WKom> </Wiersz> </Tabela> </BlokDanych>

2.4 Załącznik .XML (fragment faktury KSeF)

<Zalacznik> <BlokDanych> <MetaDane> <ZKlucz>Miejsce poboru energii</ZKlucz> <ZWartosc>ul. Polna 1, 00-001 Warszawa</ZWartosc> </MetaDane> <MetaDane> <ZKlucz>Kod PPE</ZKlucz> <ZWartosc>999999999999999999</ZWartosc> </MetaDane> <MetaDane> <ZKlucz>Nr kontrahenta (odbiorcy)</ZKlucz> <ZWartosc>99999999</ZWartosc> </MetaDane> <MetaDane> <ZKlucz>Za okres od</ZKlucz> <ZWartosc>2026-01-01</ZWartosc> </MetaDane> <MetaDane> <ZKlucz>Energia zużyta w roku 2025</ZKlucz> <ZWartosc>999 kWh</ZWartosc> </MetaDane> </BlokDanych> </Zalacznik>

3. Załączniki .XML. Rola i zastosowanie

Rachunkowość A. Kontrola merytoryczna i audyt kosztów Załącznik może uszczegóławiać zapisy w pozycji, np. paliwo: rozbicie na partie, rabaty, CN, ilości. To pozwala: * wykrywać błędy dostawcy (np. rabat, ilość, stawka), * dokumentować zasadność kwoty kosztu (przy kontrolach wewn., audycie, UOKiK/US w zakresie rzetelności dokumentacji), * szybciej wyjaśniać reklamacje. Można zrobić test zgodności sum: Suma WNetto / Suma WVat / Suma WBrutto z załącznika vs wartości pozycji faktury. B. Lepsza dekretacja kosztów W załączniku mogą być rozbicia, które odpowiadają obiektom kosztów (np. usługi telekom per numer, media per punkt poboru, paliwo per karta/partia). To można: * rozksięgować koszt jednej pozycji faktury na kilka MPK/zleceń, * przypisać koszt do odpowiedniego miejsca powstawania kosztów bez ręcznego dzielenia. Np. załącznik 'paliwowy' może zawierać: numer karty, rejestracja, kierowca. C. Okresy świadczeń W telekomunikacji/medich załączniki mogą zawierać okresy rozliczeniowe. To daje podstawę do: * Rozliczenia okresów (koszt dotyczy kilku miesięcy), * kontrolowania, czy faktura obejmuje właściwy okres. D. Weryfikacja stawek podatkowych/akcyzy/klasyfikacji W niektórych branżach dodatkowe dane (np. CN/PKWiU, parametry) pomagają: * wykryć ryzyko błędnej klasyfikacji, * uzasadnić zastosowanie stawek/akcyzy, * lepiej przygotować dane do raportowania (np. analizy kosztów akcyzy w paliwie - jeśli akcyza jest ujęta w danych). Analizy finansowe i controlling A. Analiza cen i rabatów Załącznik często niesie ceny/rabaty per 'składowa' pozycji. To umożliwia: * analizę efektywnej ceny zakupu w czasie, * porównanie rabatów między dostawcami / stacjami / okresami, * wykrywanie odchyleń (anomalie cenowe). B. Analiza zużycia i koszty jednostkowe Gdy załącznik zawiera ilości i jednostki: * koszt / litr, koszt / kWh, koszt / numer telefonu, itd. To daje możliwość budżetowania i prognozowania. C. Przypisanie kosztów do obiektów Załączniki mogą zawierać identyfikatory typu: punkt poboru, numer usługi, karta paliwowa, lokalizacja: * Można budować raporty uwzględniając powiązania z obiektami. D. Jakość danych i automatyzacja Dane ustrukturyzowane: * są gotowe do umieszczenia w raportach * mogą automatycznie zasilać hurtownię danych / BI.

4. Raportowane na danych z załączników

Po wybraniu elementu załącznika można go przeglądać. Załącznik 1 Załącznik 2 -----o Załącznik 3 | v Załącznik 2 1. Metadane Wykaz dla pozycji paliwowych faktury: 690 2. Tabele Zawartość (treść) załącznika Dane wyświetlane są tabelarycznie. Załączniki można wydrukować (F4), zapisać do CSV/XLS (F10) i wyświetlić w Excelu. Przykład: o------------------------------------------------------------------------------------------------------ |Lp PozycjaFaktury CenaRabat NazwaProduktu Ilosc JM VAT WBrutto WVat WNetto | |------------------------------------------------------------------------------------------------------ |1.00| 690.00| 5.88|EFECTA DIESEL CN27102011| 77.53|l/kg|23 455.88| 85.25| 370.63| |2.00| 690.00| 5.98|EFECTA DIESEL CN27102011| 60.00|l/kg|23 358.80| 67.09| 291.71| o------------------------------------------------------------------------------------------------------ Patrz szczegóły: Zestawienia tabelaryczne. Opis ogólny Zgromadzone dane mogą być hurtownią danych dla generatorów raportów i analiz BI. Generatory raportów. Analizy BI

5. Tematy powiązane

Tabelaryczne. Opis ogólny Generatory raportów. Analizy BI KSeF Opis ogólny. Konfiguracja Załączniki [&]. Dokumenty powiązane Słowa kluczowe #TrawersERP-Architektura #TrawersERP-ProcesyGospodarcze #Admin-WymianaDanych #PTU/VAT-KSeF