Como salvar um código Base64 como arquivo PDF
Uma resposta de API, o XML de uma nota fiscal ou o código-fonte de um e-mail traz um bloco enorme de texto começando com JVBERi0, e você precisa do documento que está ali dentro — veja como fazer, de encontrar o código até abrir o arquivo.
Por Metin Ersoy · Atualizado em 10 de novembro de 2026
O que é um PDF em Base64 e por que ele chega como texto?
O Base64 escreve um arquivo usando só letras, números e alguns símbolos. É isso que permite que formatos que só aceitam texto — JSON, XML, e-mail — levem um PDF dentro deles. O código guarda uma cópia exata do documento: ao decodificá-lo, você recebe o arquivo original de volta, byte por byte, com eventuais assinaturas digitais ainda válidas.
Normalmente ele aparece nestes lugares:
- APIs de emissão de notas e de contabilidade. Plataformas de nota fiscal eletrônica e sistemas contábeis costumam devolver a versão em PDF da nota num campo Base64. Um XML estruturado de nota (como o UBL) pode embutir o PDF para impressão do mesmo jeito.
- Envios e fretes. Quando você cria um envio, as transportadoras geralmente devolvem a etiqueta como PDF em Base64.
- Pagamentos e bancos. Serviços de comprovantes, holerites e extratos podem entregar o documento num campo de texto.
- Plataformas de assinatura eletrônica e de documentos. O documento assinado volta do serviço de assinatura em Base64.
- Código-fonte do e-mail. No código-fonte bruto de um e-mail, os anexos em PDF ficam guardados como blocos Base64.
1. Encontre o código e copie tudo
- Resposta JSON: procure o campo que guarda o PDF — muitas vezes ele se chama pdf, content, data, document, file ou label. O valor começa com JVBERi0. Copie tudo o que está entre as aspas. Você também pode copiar a resposta inteira; a ferramenta encontra sozinha a parte que começa com JVBERi0.
- Arquivo XML: encontre o elemento que traz o PDF (por exemplo, EmbeddedDocumentBinaryObject) e copie o texto entre a tag de abertura e a de fechamento. Quebras de linha não atrapalham.
- Código-fonte do e-mail: abra "Mostrar original" (no Gmail) ou a opção de ver o código-fonte da mensagem no seu programa de e-mail. O anexo em PDF é o bloco que vem abaixo das linhas Content-Type: application/pdf e Content-Transfer-Encoding: base64. Copie tudo até a próxima linha em branco.
- Ferramentas de desenvolvedor: na aba Network (Rede) do navegador, abra a resposta, clique com o botão direito no campo e escolha "Copiar valor". É bem mais confiável do que selecionar um texto comprido com o mouse.
Como o código é muito longo, o final dele se perde com facilidade. Depois de copiar, confira se o que você colou termina igual ao original.
2. Converta o código e confira o documento
Abra Base64 para PDF, clique em "Ou digite / cole o texto" e cole o código. Assim que ele é decodificado, a primeira página aparece, com o número de páginas, a versão do PDF e o tamanho do arquivo logo abaixo. Se o código estiver salvo num arquivo .txt, é só selecionar esse arquivo.
A pré-visualização permite uma conferência rápida:
- É o documento certo? O número da nota, o nome do cliente ou os dados da etiqueta aparecem na primeira página.
- O número de páginas é o esperado? Páginas faltando indicam que o código foi copiado só em parte.
- Ele tem senha? Nesse caso, aparece um aviso no lugar da pré-visualização, e o arquivo é salvo exatamente como está.
3. Salve o PDF e abra o arquivo
Clique em "Baixar PDF". O arquivo é salvo sem nenhuma alteração e abre em qualquer leitor de PDF. A partir daí, é com você: reúna as notas do mês num só arquivo com Juntar PDF, deixe o arquivo pequeno o bastante para mandar por e-mail com Comprimir PDF ou gere uma imagem da primeira página com PDF para JPG.
O que o começo do código revela
| O código começa com | O arquivo que está dentro |
|---|---|
| JVBERi0 | Documento PDF |
| data:application/pdf;base64, | Documento PDF (data URI) |
| iVBORw0KGgo | Imagem PNG |
| /9j/ | Foto JPG |
| UEsDB | ZIP, Word (.docx) ou Excel (.xlsx) |
| PD94bWwg | Texto XML (por exemplo, os próprios dados da nota) |
A última linha explica uma confusão comum com notas fiscais eletrônicas: alguns serviços mandam o XML da nota em Base64 em vez de um PDF. Decodificado, esse código vira um texto XML legível, e não um documento.
Erros comuns
Salvar o código como arquivo de texto com a extensão .pdf. O arquivo continua tendo o texto em Base64, e o leitor diz que ele está corrompido. O código precisa ser decodificado.
Copiar mais do que o valor. Se uma "," ou um "status" perdido for parar no fim do código, ele fica inválido. Copie só o valor ou a resposta inteira — a ferramenta extrai o código corretamente dos dois jeitos.
Quebras de linha escapadas. Em textos JSON, o código pode vir dividido a cada 76 caracteres com \n. Esses caracteres não fazem parte do PDF; a ferramenta os remove automaticamente.
A resposta errada. Se o documento ainda não estiver pronto, algumas APIs devolvem um campo vazio ou uma mensagem de erro. Se o código for muito curto — algumas centenas de caracteres —, é bem provável que seja um texto de erro, e não um PDF.
Uma observação sobre privacidade
O Base64 não protege o seu documento; ele só muda o formato. Evite decodificar notas fiscais, contratos, laudos médicos ou cópias de documentos de identidade em sites que enviam o arquivo para um servidor. A ferramenta do PDFVela decodifica o código no seu dispositivo e continua funcionando mesmo se você ficar sem internet depois que a página carregar.
Quer experimentar? É grátis e o seu arquivo fica no seu dispositivo.
Abrir Base64 para PDF