Jak zapisać kod Base64 jako plik PDF
W odpowiedzi API, w pliku XML faktury albo w źródle e-maila jest długi blok tekstu zaczynający się od JVBERi0, a Ty potrzebujesz dokumentu, który się w nim kryje – od znalezienia kodu po otwarcie pliku.
Autor: Metin Ersoy · Zaktualizowano 10 listopada 2026
Czym jest PDF w Base64 i dlaczego przychodzi jako tekst?
Base64 zapisuje plik wyłącznie za pomocą liter, cyfr i kilku symboli. Dzięki temu formaty tekstowe – JSON, XML, e-mail – mogą przenosić w sobie plik PDF. Kod zawiera dokładną kopię dokumentu: po zdekodowaniu dostajesz oryginalny plik bajt w bajt, a ewentualne podpisy cyfrowe pozostają ważne.
Najczęściej spotkasz go w takich miejscach:
- API do fakturowania i księgowości. Platformy e-fakturowe i programy księgowe często zwracają wersję PDF faktury jako pole w Base64. Ustrukturyzowane faktury XML (np. w formacie UBL) mogą w ten sam sposób zawierać PDF do druku.
- Wysyłka. Przy tworzeniu przesyłki firmy kurierskie zwykle zwracają etykietę jako PDF w Base64.
- Płatności i bankowość. Usługi wystawiające potwierdzenia, paski wynagrodzeń czy wyciągi mogą oddawać dokument w polu tekstowym.
- Platformy do e-podpisu i dokumentów. Podpisany dokument wraca z serwisu do podpisywania jako Base64.
- Źródło e-maila. W surowym źródle wiadomości załączniki PDF są zapisane jako bloki Base64.
1. Znajdź kod i skopiuj go w całości
- Odpowiedź JSON: znajdź pole z plikiem PDF – często nazywa się pdf, content, data, document, file albo label. Wartość zaczyna się od JVBERi0. Skopiuj wszystko między cudzysłowami. Możesz też skopiować całą odpowiedź – narzędzie samo znajdzie fragment zaczynający się od JVBERi0.
- Plik XML: znajdź element z plikiem PDF (np. EmbeddedDocumentBinaryObject) i skopiuj tekst między znacznikiem otwierającym a zamykającym. Podziały wierszy nie przeszkadzają.
- Źródło e-maila: otwórz „Pokaż oryginał” (w Gmailu) albo widok źródła wiadomości w swoim programie pocztowym. Załącznik PDF to blok pod wierszami Content-Type: application/pdf i Content-Transfer-Encoding: base64. Skopiuj wszystko aż do najbliższego pustego wiersza.
- Narzędzia deweloperskie: na karcie Network (Sieć) w przeglądarce otwórz odpowiedź, kliknij pole prawym przyciskiem myszy i wybierz „Copy value” (kopiuj wartość). To dużo pewniejsze niż ręczne zaznaczanie długiego ciągu.
Kod jest bardzo długi, więc łatwo uciąć jego koniec. Po skopiowaniu sprawdź, czy wklejony tekst kończy się tak samo jak w źródle.
2. Zamień kod i sprawdź dokument
Otwórz Base64 na PDF, kliknij „Lub wpisz / wklej tekst” i wklej kod. Gdy tylko zostanie zdekodowany, pojawi się pierwsza strona, a pod nią liczba stron, wersja PDF i rozmiar pliku. Jeśli kod masz zapisany w pliku .txt, po prostu wybierz ten plik.
Podgląd pozwala szybko sprawdzić:
- Czy to właściwy dokument? Na pierwszej stronie widać numer faktury, nazwę klienta albo dane z etykiety.
- Czy liczba stron się zgadza? Brakujące strony oznaczają, że kod został skopiowany tylko częściowo.
- Czy plik jest zabezpieczony hasłem? Wtedy zamiast podglądu pojawi się komunikat, a plik i tak zostanie zapisany dokładnie w takiej postaci.
3. Zapisz plik PDF i otwórz go
Kliknij „Pobierz PDF”. Plik zostanie zapisany bez zmian i otworzy się w każdym czytniku PDF. Dalej wszystko zależy od Ciebie: zbierz faktury z całego miesiąca w jeden plik narzędziem Połącz PDF, zmniejsz go do wysłania e-mailem narzędziem Kompresuj PDF albo zrób obraz pierwszej strony narzędziem PDF na JPG.
Co mówi początek kodu
| Kod zaczyna się od | Plik w środku |
|---|---|
| JVBERi0 | dokument PDF |
| data:application/pdf;base64, | dokument PDF (data URI) |
| iVBORw0KGgo | obraz PNG |
| /9j/ | zdjęcie JPG |
| UEsDB | ZIP, Word (.docx) lub Excel (.xlsx) |
| PD94bWwg | tekst XML (np. same dane faktury) |
Ostatni wiersz wyjaśnia częste nieporozumienie przy e-fakturach: niektóre systemy zamiast pliku PDF przesyłają w Base64 sam plik XML faktury. Po zdekodowaniu dostajesz wtedy czytelny tekst XML, a nie dokument.
Typowe błędy
Zapisanie kodu jako pliku tekstowego z rozszerzeniem .pdf. Plik nadal zawiera tekst Base64, a czytnik zgłasza, że jest uszkodzony. Kod trzeba zdekodować.
Skopiowanie czegoś więcej niż sama wartość. Jeśli na końcu kodu znajdzie się przypadkowy przecinek albo słowo „status”, kod przestanie być poprawny. Skopiuj albo samą wartość, albo całą odpowiedź – w obu przypadkach narzędzie poprawnie wyodrębni kod.
Podziały wierszy zapisane jako \n. W ciągach JSON kod bywa dzielony co 76 znaków sekwencją \n. Te znaki nie należą do pliku PDF – narzędzie usuwa je automatycznie.
Niewłaściwa odpowiedź. Jeśli dokument nie jest jeszcze gotowy, niektóre API zwracają puste pole albo komunikat o błędzie. Jeśli kod jest bardzo krótki – kilkaset znaków – to najpewniej treść błędu, a nie PDF.
Słowo o prywatności
Base64 nie chroni dokumentu, zmienia tylko jego zapis. Nie dekoduj faktur, umów, wyników badań ani kopii dowodów w serwisach, które przesyłają plik na serwer. Narzędzie PDFVela dekoduje kod na Twoim urządzeniu i działa nawet wtedy, gdy po wczytaniu strony stracisz połączenie z internetem.
Chcesz spróbować? To nic nie kosztuje, a plik zostaje na Twoim urządzeniu.
Otwórz narzędzie Base64 na PDF