Как сохранить строку Base64 в PDF-файл
В ответе API, XML-файле счёта или исходнике письма есть длинный блок текста, который начинается с JVBERi0, а вам нужен документ внутри него. Разбираем всё — от поиска кода до открытия файла.
Автор: Metin Ersoy · Обновлено 10 ноября 2026 г.
Что такое PDF в Base64 и почему он приходит в виде текста
Base64 записывает файл одними буквами, цифрами и несколькими символами. Благодаря этому PDF можно передать внутри чисто текстовых форматов — JSON, XML, электронного письма. Код содержит точную копию документа: после декодирования вы получаете исходный файл байт в байт, и цифровые подписи в нём остаются действительными.
Чаще всего такой код встречается здесь:
- API для счетов и бухгалтерии. Сервисы электронных счетов и бухгалтерские программы нередко отдают PDF-версию счёта в поле Base64. Структурированный XML счёта (например, в формате UBL) может так же содержать внутри печатный PDF.
- Доставка. При оформлении отправления службы доставки обычно возвращают этикетку в виде PDF в Base64.
- Платежи и банки. Сервисы чеков, расчётных листков и выписок могут возвращать документ в текстовом поле.
- Электронная подпись и документооборот. Подписанный документ приходит из сервиса подписания в Base64.
- Исходный код письма. В «сыром» тексте письма PDF-вложения хранятся блоками Base64.
1. Найдите код и скопируйте его целиком
- Ответ в JSON: найдите поле с PDF — часто оно называется pdf, content, data, document, file или label. Значение начинается с JVBERi0. Скопируйте всё, что стоит между кавычками. Можно скопировать и весь ответ целиком: инструмент сам найдёт часть, которая начинается с JVBERi0.
- XML-файл: найдите элемент с PDF (например, EmbeddedDocumentBinaryObject) и скопируйте текст между открывающим и закрывающим тегами. Переносы строк не мешают.
- Исходник письма: откройте «Показать оригинал» (в Gmail) или просмотр исходного текста письма в вашей почтовой программе. PDF-вложение — это блок под строками Content-Type: application/pdf и Content-Transfer-Encoding: base64. Скопируйте всё до следующей пустой строки.
- Инструменты разработчика: на вкладке «Сеть» (Network) откройте ответ, нажмите на поле правой кнопкой мыши и выберите «Копировать значение» (Copy value). Это гораздо надёжнее, чем выделять длинную строку вручную.
Код очень длинный, и его конец легко обрезать. После копирования убедитесь, что вставленный текст заканчивается так же, как в источнике.
2. Конвертируйте код и проверьте документ
Откройте «Base64 в PDF», нажмите «Или введите / вставьте текст» и вставьте код. Сразу после декодирования появится первая страница, а под ней — число страниц, версия PDF и размер файла. Если код сохранён в файле .txt, просто выберите этот файл.
Предпросмотр помогает быстро проверить:
- Тот ли это документ? На первой странице видны номер счёта, имя клиента или данные этикетки.
- Совпадает ли число страниц с ожидаемым? Если страниц не хватает, код скопирован не полностью.
- Защищён ли файл паролем? Тогда вместо предпросмотра появится уведомление, но файл всё равно сохранится в точности как есть.
3. Сохраните PDF и откройте его
Нажмите «Скачать PDF». Файл сохранится без изменений и откроется в любой программе для просмотра PDF. Дальше всё зависит от задачи: соберите счета за месяц в один файл с помощью «Объединить PDF», уменьшите файл для отправки по почте в «Сжать PDF» или получите картинку первой страницы через «PDF в JPG».
О чём говорит начало кода
| Код начинается с | Что внутри |
|---|---|
| JVBERi0 | PDF-документ |
| data:application/pdf;base64, | PDF-документ (data URI) |
| iVBORw0KGgo | PNG-изображение |
| /9j/ | JPG-фото |
| UEsDB | ZIP, Word (.docx) или Excel (.xlsx) |
| PD94bWwg | XML-текст (например, сами данные счёта) |
Последняя строка объясняет частую путаницу с электронными счетами: некоторые сервисы присылают в Base64 не PDF, а XML счёта. После декодирования такого кода вы получите читаемый XML-текст, а не документ.
Частые ошибки
Код сохранили как текстовый файл с расширением .pdf. Внутри файла по-прежнему текст Base64, и программа сообщает, что файл повреждён. Код нужно именно декодировать.
Скопировали больше, чем значение. Если в конце кода случайно оказалась лишняя «,» или «status», код становится недействительным. Копируйте либо только значение, либо весь ответ — инструмент правильно извлечёт код из обоих вариантов.
Экранированные переносы строк. В строках JSON код может быть разбит каждые 76 символов последовательностью \n. Эти символы не относятся к PDF — инструмент удаляет их автоматически.
Не тот ответ. Если документ ещё не готов, некоторые API возвращают пустое поле или сообщение об ошибке. Если код совсем короткий — несколько сотен символов, — скорее всего, это текст ошибки, а не PDF.
Несколько слов о конфиденциальности
Base64 не защищает документ, а лишь меняет его формат. Не декодируйте счета, договоры, медицинские заключения или копии удостоверений личности на сайтах, которые загружают файл на сервер. Инструмент PDFVela декодирует код на вашем устройстве и продолжает работать, даже если после загрузки страницы пропадёт интернет.
Хотите попробовать? Это бесплатно, и файл остаётся на вашем устройстве.
Открыть «Base64 в PDF»