Cách lưu chuỗi Base64 thành tệp PDF
Phản hồi API, tệp XML hóa đơn hay mã nguồn email có một khối chữ dài bắt đầu bằng JVBERi0, và bạn cần tài liệu nằm bên trong. Hướng dẫn từ khâu tìm mã đến lúc mở được tệp.
Tác giả: Metin Ersoy · Cập nhật 10 tháng 11, 2026
PDF dạng Base64 là gì và vì sao nó đến dưới dạng chữ?
Base64 ghi lại một tệp chỉ bằng chữ cái, chữ số và vài ký hiệu. Nhờ vậy, các định dạng chỉ chứa văn bản như JSON, XML hay email có thể mang theo cả một tệp PDF. Đoạn mã giữ một bản sao chính xác của tài liệu: giải mã ra là bạn có lại đúng tệp gốc, khớp đến từng byte, kể cả chữ ký số vẫn còn hiệu lực.
Bạn thường gặp nó ở những chỗ sau:
- API hóa đơn và kế toán. Các nền tảng hóa đơn điện tử và phần mềm kế toán thường trả bản PDF của hóa đơn trong một trường Base64. Tệp XML hóa đơn có cấu trúc (như UBL) cũng có thể nhúng bản in PDF theo cách này.
- Vận chuyển. Khi bạn tạo đơn gửi hàng, hãng vận chuyển thường trả nhãn vận đơn dưới dạng PDF Base64.
- Thanh toán và ngân hàng. Dịch vụ biên lai, phiếu lương hay sao kê có thể trả tài liệu trong một trường văn bản.
- Nền tảng chữ ký điện tử và quản lý tài liệu. Tài liệu đã ký được dịch vụ ký trả về dưới dạng Base64.
- Mã nguồn email. Trong mã nguồn gốc của một email, tệp PDF đính kèm được lưu thành các khối Base64.
1. Tìm mã và sao chép toàn bộ
- Phản hồi JSON: Tìm trường chứa PDF, thường có tên pdf, content, data, document, file hoặc label. Giá trị bắt đầu bằng JVBERi0. Sao chép mọi thứ nằm giữa hai dấu ngoặc kép. Bạn cũng có thể sao chép cả phản hồi; công cụ tự tìm phần bắt đầu bằng JVBERi0.
- Tệp XML: Tìm phần tử chứa PDF (ví dụ EmbeddedDocumentBinaryObject) và sao chép phần chữ giữa thẻ mở và thẻ đóng. Có xuống dòng cũng không sao.
- Mã nguồn email: Mở "Hiển thị bản gốc" (Show original) hoặc "Xem nguồn" (View source). Tệp PDF đính kèm là khối nằm dưới các dòng Content-Type: application/pdf và Content-Transfer-Encoding: base64. Sao chép mọi thứ cho đến dòng trống kế tiếp.
- Công cụ dành cho nhà phát triển: Trong thẻ Network (Mạng) của trình duyệt, mở phản hồi, nhấp chuột phải vào trường và chọn "Copy value" (sao chép giá trị). Cách này đáng tin hơn nhiều so với bôi đen một chuỗi dài bằng tay.
Vì mã rất dài nên phần cuối rất dễ bị cắt mất. Sau khi sao chép, hãy kiểm tra xem đoạn bạn dán có kết thúc giống hệt bản gốc không.
2. Chuyển mã và kiểm tra tài liệu
Mở Base64 sang PDF, bấm "Hoặc gõ / dán văn bản" rồi dán mã vào. Ngay khi giải mã xong, trang đầu tiên hiện ra, bên dưới là số trang, phiên bản PDF và dung lượng tệp. Nếu mã được lưu trong một tệp .txt, bạn chỉ cần chọn tệp đó.
Bản xem trước giúp bạn kiểm tra nhanh:
- Có đúng tài liệu không? Số hóa đơn, tên khách hàng hay thông tin nhãn vận đơn hiện ngay trên trang đầu.
- Số trang có như bạn mong đợi không? Thiếu trang nghĩa là mã chỉ được sao chép một phần.
- Tệp có đặt mật khẩu không? Khi đó một ghi chú sẽ hiện ra thay cho bản xem trước, và tệp vẫn được lưu nguyên trạng.
3. Lưu tệp PDF và mở ra
Bấm "Tải xuống PDF". Tệp được lưu nguyên vẹn và mở được bằng mọi trình đọc PDF. Sau đó tùy bạn: gom hóa đơn cả tháng vào một tệp bằng Ghép PDF, giảm dung lượng để gửi email bằng Nén PDF, hoặc lấy ảnh của trang đầu bằng PDF sang JPG.
Phần đầu của mã cho biết điều gì
| Mã bắt đầu bằng | Tệp bên trong |
|---|---|
| JVBERi0 | Tài liệu PDF |
| data:application/pdf;base64, | Tài liệu PDF (data URI) |
| iVBORw0KGgo | Ảnh PNG |
| /9j/ | Ảnh JPG |
| UEsDB | ZIP, Word (.docx) hoặc Excel (.xlsx) |
| PD94bWwg | Văn bản XML (ví dụ chính dữ liệu hóa đơn) |
Dòng cuối giải thích một nhầm lẫn hay gặp với hóa đơn điện tử: một số dịch vụ gửi tệp XML hóa đơn dưới dạng Base64 chứ không phải PDF. Giải mã ra, bạn nhận được văn bản XML đọc được, chứ không phải một tài liệu.
Các lỗi thường gặp
Lưu mã thành tệp văn bản có đuôi .pdf. Tệp vẫn chứa chữ Base64 và trình đọc báo tệp bị hỏng. Mã cần được giải mã.
Sao chép thừa ngoài giá trị. Nếu một dấu "," hay chữ "status" lẫn vào cuối mã, mã sẽ không hợp lệ. Hãy sao chép riêng phần giá trị hoặc cả phản hồi; trường hợp nào công cụ cũng tách mã chính xác.
Ký tự xuống dòng dạng \n. Trong chuỗi JSON, mã có thể bị ngắt sau mỗi 76 ký tự bằng \n. Các ký tự này không thuộc tệp PDF; công cụ tự động loại bỏ chúng.
Nhầm phản hồi. Nếu tài liệu chưa sẵn sàng, một số API trả về trường trống hoặc thông báo lỗi. Nếu mã rất ngắn, chỉ vài trăm ký tự, nhiều khả năng đó là thông báo lỗi chứ không phải PDF.
Lưu ý về quyền riêng tư
Base64 không bảo vệ tài liệu của bạn, nó chỉ đổi cách biểu diễn. Đừng giải mã hóa đơn, hợp đồng, kết quả khám bệnh hay bản sao giấy tờ tùy thân trên những trang tải tệp lên máy chủ. Công cụ của PDFVela giải mã ngay trên thiết bị của bạn và vẫn hoạt động kể cả khi bạn ngắt mạng sau khi trang đã tải xong.
Sẵn sàng thử chưa? Hoàn toàn miễn phí và tệp của bạn vẫn ở trên thiết bị.
Mở công cụ Base64 sang PDF