IDWew - identyfikator wewnętrzny dla oddziałów i jednostek: jak działa w KSeF od 1.02.2026

Po co IDWew w praktyce - scenariusze z biurem rachunkowym i siecią sklepów

AITekst opracowany z wykorzystaniem sztucznej inteligencji. Zasady i ograniczenia

Zastosowanie identyfikatora wewnętrznego KSeF jest niezbędne w strukturach wielooddziałowych, gdzie występuje potrzeba separacji danych finansowych. Rozważmy sytuację spółki z ograniczoną odpowiedzialnością posiadającej NIP 111-11-11-111, która zarządza trzema salonami sprzedaży w różnych miastach, obsługiwanymi przez jedną księgową. W standardowym modelu bez IDWew faktury za wszystkie salony trafiają do jednego, wspólnego repozytorium systemowego, co generuje ryzyko błędów przy dekretacji i zmusza pracowników do ręcznego filtrowania dokumentów. Rozwiązaniem jest wygenerowanie trzech osobnych IDWew (np. 1111111111-00001, 1111111111-00002, 1111111111-00003) i nadanie uprawnień z flagą ograniczającą dostęp wyłącznie do faktur oznaczonych danym identyfikatorem. W efekcie osoba odpowiedzialna za konkretny punkt sprzedaży widzi w Aplikacji Podatnika KSeF tylko swoje dokumenty.

W relacjach z podmiotami zewnętrznymi, takimi jak biuro rachunkowe, IDWew pozwala na bezpieczny outsourcing procesów księgowych. Podatnik nadaje biuru uprawnienie pośrednie, zawężone do konkretnego identyfikatora wewnętrznego, co gwarantuje, że pracownicy biura nie otrzymają dostępu do faktur pozostałych jednostek organizacyjnych podatnika. Należy jednak pamiętać o ograniczeniach prawnych w zakresie dalszej delegacji kompetencji. Zgodnie z wytycznymi Ministerstwa Finansów, biuro nie posiada uprawnień do dalszego nadawania uprawnień (subdelegacji) w imieniu podatnika, co zapewnia kontrolę nad hierarchią dostępu w systemie.

Szczególnym przypadkiem zastosowania są Jednostki Samorządu Terytorialnego (JST), gdzie gmina występuje jako podatnik zbiorczy, a podległe jej szkoły podstawowe działają jako jednostki wewnętrzne bez własnego NIP-u. Bez wdrożenia IDWew każda faktura zakupowa dla szkoły trafiałaby wyłącznie na konto główne gminy, stając się niewidoczną dla administracji placówki oświatowej. Zastosowanie IDWew pozwala szkole na posiadanie własnego „koszyka” faktur oraz umożliwia wystawianie faktur sprzedażowych w imieniu gminy z precyzyjnym oznaczeniem miejsca powstania przychodu. Zgodnie z art. 15 ustawy o VAT, podatnikiem pozostaje jednak spółka lub JST jako całość, a IDWew pełni jedynie funkcję techniczną i organizacyjną.

Jak wygenerować IDWew krok po kroku - ekran po ekranie

Proces generowania identyfikatorów odbywa się wyłącznie w środowisku produkcyjnym lub testowym Ministerstwa Finansów i wymaga wcześniejszego uwierzytelnienia. Należy zalogować się do KSeF pieczęcią kwalifikowaną lub podpisem zaufanym, a następnie przejść do menu „Jednostki wewnętrzne” i wybrać przycisk „Dodaj identyfikator”. Generator IDWew nie jest dostępny przez publiczne API bez certyfikatu, co stanowi zabezpieczenie przed nieautoryzowanym tworzeniem struktur organizacyjnych podmiotu przez osoby trzecie.

W formularzu tworzenia jednostki należy uzupełnić pole „Nazwa jednostki” (np. „Sklep Warszawa Śródmieście”), opcjonalny własny symbol oraz datę ważności identyfikatora. Data ważności może pozostać nieokreślona, co oznacza, że IDWew będzie aktywny bezterminowo, aż do momentu jego ręcznego unieważnienia przez administratora. System automatycznie weryfikuje poprawność wprowadzanych danych i uniemożliwia duplikowanie nazw w obrębie jednego NIP-u.

Kluczowym elementem technicznym jest algorytm sumy kontrolnej. System sam oblicza cyfrę kontrolną na podstawie NIP-u podatnika oraz nadanego przez użytkownika 4-cyfrowego numeru wewnętrznego. Łącznie identyfikator składa się z 15 znaków (10 cyfr NIP + 4 cyfry jednostki + 1 cyfra kontrolna). Próba ręcznej modyfikacji którejkolwiek cyfry w systemach zewnętrznych spowoduje, że KSeF odrzuci identyfikator jako niepoprawny strukturalnie podczas walidacji pliku XML.

Po zatwierdzeniu zmian KSeF zwraca pełny ciąg znaków, na przykład 5250007069-30009. Wygenerowany identyfikator należy niezwłocznie skopiować i wprowadzić do odpowiedniego pola „IDWew” w systemie ERP lub oprogramowaniu finansowo-księgowym. Prawidłowe mapowanie w systemie źródłowym gwarantuje, że przy wystawianiu faktury dane automatycznie trafią do sekcji Podmiot3 w strukturze logicznej FA(3), co jest warunkiem poprawnej segregacji dokumentów w systemie centralnym.

Gdzie fizycznie wpisać IDWew w fakturze XML - struktura FA(3) w 15 sekund

Prawidłowe umiejscowienie identyfikatora w strukturze pliku .xml jest kluczowe dla jego rozpoznania przez algorytmy Krajowego Systemu e-Faktur. IDWew musi zostać wpisany w ściśle określonym węźle schematu FA(3). Poniżej przedstawiono fragment poprawnej struktury XML dla identyfikatora wewnętrznego:

<Podmiot3>

<DaneIdentyfikacyjne>

<IDWew>1111111111-00004</IDWew>

</DaneIdentyfikacyjne>

</Podmiot3>

Poza samym identyfikatorem, krytyczne znaczenie ma pole „Rola”, które definiuje charakter podmiotu trzeciego w transakcji. Jeśli IDWew odnosi się do odbiorcy wewnętrznego, należy wpisać wartość „2” (Odbiorca). W przypadku procedury samofakturowania, gdzie jednostka wystawia dokument w imieniu innego podmiotu nie będąc bezpośrednią stroną transakcji, stosuje się rolę „5” (Wystawca). Błędne przypisanie roli lub jej brak spowoduje, że faktura nie zostanie przypisana do właściwego „koszyka” i trafi do ogólnego zasobu dokumentów, co utrudni jej identyfikację przez jednostkę docelową.

Dla użytkowników korzystających z bezpłatnych narzędzi Ministerstwa Finansów, pole to jest dostępne w formularzu webowym. Identyfikator wewnętrzny jest domyślnie ukryty pod linkiem „Dodaj podmiot trzeci”, a następnie znajduje się w zakładce „Dane identyfikacyjne”. Należy pamiętać, że brak uzupełnienia sekcji Podmiot3 skutkuje tym, iż faktura będzie widoczna wyłącznie na poziomie głównego konta podatnika (NIP), co w dużych organizacjach może prowadzić do paraliżu procesów weryfikacji płatności.