---
title: "17 listopada podgląd faktury może pokazać surowy XML"
url: "https://senteri.pl/xslt-podglad-faktur-ksef/"
date: "2026-11-11"
updated: "2026-11-11"
section: "ERP"
tags: ["integracje-erp", "ksef"]
author: "Łukasz Jajor"
lang: "pl"
---

# 17 listopada podgląd faktury może pokazać surowy XML

> KSeF działa bez zmian, ale w wielu firmach podgląd faktury powstaje w przeglądarce przez XSLT. Chrome wyłącza go 17 listopada, Edge w grudniu. Jak sprawdzić, czy to dotyczy twojego obiegu.

17 listopada Chrome 158 przestaje obsługiwać XSLT, technologię, która zamienia plik XML w czytelną stronę. W połowie grudnia to samo zrobi Edge 159. KSeF działa dalej bez zmian, ale w wielu firmach podgląd faktury powstaje właśnie w przeglądarce, przez XSLT. Tam, gdzie tak jest, księgowość zobaczy po aktualizacji surowy kod XML albo pustą stronę. Ten tekst pomoże sprawdzić, czy to dotyczy twojej firmy, i co zrobić, jeśli tak.

## Co się dzieje i kiedy

XSLT to język, którym opisuje się przekształcenie XML w inny dokument, na przykład w HTML wyglądający jak faktura. Przeglądarki obsługiwały go od ponad dwudziestu lat. Google i Microsoft go wyłączają, bo [ten fragment przeglądarki opiera się na starym kodzie, który przetwarza niezaufane pliki](https://developer.chrome.com/docs/web-platform/deprecating-xslt), a na zwykłych stronach prawie nikt już z niego nie korzysta.

| Przeglądarka | XSLT przestaje działać | Furtka przejściowa działa do |
| --- | --- | --- |
| Chrome | Wersja 158, 17 listopada 2026 | Chrome 176, 17 sierpnia 2027 |
| Edge | Wersja 159, połowa grudnia 2026 (w wersjach testowych już od 157) | Edge 176, lato 2027 |
| Firefox | Planowane wyłączenie w sierpniu 2027 | — |

Znikają dokładnie dwie rzeczy: funkcja `XSLTProcessor` w JavaScripcie i instrukcja w pliku XML, która każe przeglądarce użyć arkusza XSL. Instrukcja wskazująca zwykły arkusz CSS [działa nadal](https://learn.microsoft.com/en-us/deployedge/microsoft-edge-relnote-stable-channel).

## Czego to nie dotyczy

- **Samego KSeF.** Wysyłka i pobieranie faktur, numery KSeF, UPO i kody QR działają na serwerach i nie mają nic wspólnego z XSLT w przeglądarce.
- **Faktury jako dokumentu.** Fakturą jest plik XML zgodny ze schematem FA(3). Ten plik się nie zmienia. Zmienia się tylko to, jak niektóre programy go wyświetlają.
- **XSLT na serwerze.** Jeśli podgląd lub PDF powstaje w PHP, Javie czy .NET, na przykład przez `XSLTProcessor` w PHP, `xsltproc` albo `XslCompiledTransform`, nic się nie dzieje. Przeglądarka dostaje gotowy HTML.

## Gdzie może się zepsuć

Ryzyko jest tam, gdzie przekształcenie robi przeglądarka. W obiegu faktur widzę trzy takie miejsca.

### 1. Własny obieg albo panel z podglądem faktury

Jeśli aplikacja webowa pokazuje fakturę tak, że pobiera XML i arkusz XSL, a potem przekształca je w JavaScripcie, od 17 listopada w Chrome dostanie błąd. Tak samo, jeśli serwer wysyła do przeglądarki XML z instrukcją `<?xml-stylesheet type="text/xsl" ...?>`. Najszybciej sprawdzić to w kodzie:

  szukanie XSLT po stronie przeglądarki w kodzie aplikacji bash

```
grep -rnE "XSLTProcessor|xml-stylesheet" --include=*.js --include=*.php --include=*.html --include=*.xml .
```

Trafienie w pliku .js albo .html to sygnał alarmowy. Trafienie w PHP oznacza zwykle przekształcenie na serwerze, które działa dalej, chyba że PHP tylko dokleja instrukcję xml-stylesheet do pliku wysyłanego do przeglądarki.

Drugi sposób nie wymaga zaglądania do kodu. Otwórz podgląd faktury w Chrome Beta, który już ma wersję 158. Jeśli tam działa, w stabilnym Chrome też będzie działać.

### 2. Plik XML otwierany dwuklikiem

W wielu firmach pobrany z KSeF plik XML otwiera się po prostu w przeglądarce, z arkuszem udostępnianym przez Ministerstwo Finansów albo z własnym. W Windows domyślnym programem dla plików XML często jest Edge. Działa to tylko wtedy, gdy plik zawiera instrukcję wskazującą arkusz XSL. Po aktualizacji ten sam plik pokaże drzewo znaczników zamiast faktury. Dla osoby, która robi tak od miesięcy, wygląda to jak uszkodzony plik, choć plik jest w porządku.

### 3. Programy na komputer z wbudowanym podglądem

Część programów ERP i księgowych pokazuje podgląd dokumentu w okienku z wbudowaną przeglądarką. W Windows to często WebView2, który działa na silniku Edge. Jeśli taki podgląd korzysta z XSLT, może przestać działać razem z kolejnymi wersjami Edge. Nie znalazłem jednoznacznej informacji, czy i od kiedy wyłączenie obejmuje WebView2. Dlatego sprawdziłbym to na jednym stanowisku testowym z Edge Beta, zanim zmiana trafi do wszystkich.

**Sygnał ostrzegawczy:** Chrome od kilku wersji pokazuje na stronach z XSLT ostrzeżenie o planowanym wyłączeniu. Jeśli ktoś w księgowości widział nad podglądem faktury pasek z informacją o XSLT, to właśnie ten przypadek.

## Co zrobić

### Rozwiązanie docelowe: przekształcenie na serwerze

Ten sam arkusz XSL, którego dziś używa przeglądarka, można uruchomić na serwerze i wysyłać gotowy HTML. W PHP wystarczy rozszerzenie xsl, dostępne od lat, zarówno w starszych wersjach, jak i w PHP 8:

  podgląd faktury FA(3) przekształcany na serwerze php

```
$xml = new DOMDocument();
$xml->load($plikFaktury);

$xsl = new DOMDocument();
$xsl->load('styl-faktury.xsl');  // lokalna kopia arkusza

$proc = new XSLTProcessor();
$proc->importStylesheet($xsl);

echo $proc->transformToXML($xml);
```

To XSLTProcessor z PHP, nie z przeglądarki. Działa na serwerze i nie podlega wyłączeniu.

Przy okazji warto trzymać lokalną kopię arkusza, a nie pobierać go z cudzego serwera przy każdym podglądzie. Arkusz, który dołącza pliki z innego adresu, potrafi zawieść niezależnie od tej zmiany.

### Rozwiązania przejściowe

- **Skrypt zastępczy (polyfill).** Google udostępnia [xslt-polyfill](https://developer.chrome.com/docs/web-platform/deprecating-xslt), czyli bibliotekę XSLT skompilowaną do WebAssembly. Po dołączeniu skryptu dotychczasowy kod z `XSLTProcessor` działa dalej. Jest też rozszerzenie do Chrome, które stosuje ten skrypt do plików XML otwieranych w przeglądarce. To jednak dokładnie ten sam kod, który przeglądarki usuwają ze względów bezpieczeństwa, tylko utrzymywany już przez ciebie.
- **Polityka przedsiębiorstwa.** Na komputerach zarządzanych centralnie można włączyć XSLT polityką `XSLTEnabled`, w Chrome i w Edge. To kupuje czas do sierpnia 2027, nie dłużej.
- **Origin trial.** Właściciel aplikacji webowej może zarejestrować jej adres w programie testowym i zachować XSLT dla wszystkich użytkowników tej aplikacji, również do Chrome i Edge 176.

Żadne z tych obejść nie zwalnia z przeniesienia przekształcenia na serwer. Dają tylko czas, żeby zrobić to spokojnie, a nie w dniu, w którym księgowość zadzwoni, że faktury się nie otwierają.

## Lista na ten tydzień

1. Przeszukaj kod obiegu i paneli pod kątem `XSLTProcessor` i `xml-stylesheet`.
2. Otwórz podgląd kilku faktur w Chrome Beta i Edge Beta.
3. Zapytaj księgowość, jak otwiera pobrane pliki XML. Jeśli dwuklikiem w przeglądarce, przygotuj inny sposób podglądu.
4. Sprawdź podgląd dokumentów w programach ERP na stanowisku testowym z Edge Beta.
5. Jeśli coś jest zagrożone: na teraz polityka albo skrypt zastępczy, a docelowo przekształcenie na serwerze.

To dobra zmiana w złym miejscu kalendarza, bo w listopadzie i grudniu księgowość ma najwięcej pracy. Ale samą zmianę łatwo przeprowadzić, jeśli zacznie się od sprawdzenia, a nie od telefonu z księgowości.

## Źródła

- [Chrome for Developers: Removing XSLT for a more secure browser](https://developer.chrome.com/docs/web-platform/deprecating-xslt)
- [Microsoft Edge: informacje o wersjach Stable, 156 i 157](https://learn.microsoft.com/en-us/deployedge/microsoft-edge-relnote-stable-channel)
- [Microsoft Edge: informacje o wersjach Beta, 157](https://learn.microsoft.com/en-us/deployedge/microsoft-edge-relnote-beta-channel)
- [Microsoft 365 Message Center MC1509789: Browser-native XSLT will be disabled by default](https://mc.ai-news.cz/message/MC1509789)
- [Chrome 158 Removes XSLT on Nov 17: What Breaks and How to Fix It](https://dev.to/alanwest/chrome-158-removes-xslt-on-nov-17-heres-what-breaks-and-how-to-fix-it-206c) (harmonogram Firefoksa)
- [CIRF MF, repozytorium ksef-api: wątek o podglądzie faktur i arkuszu styl.xsl](https://github.com/CIRFMF/ksef-api/issues/65)
