Base64 para Excel (XLSX)

Como decodificar Base64 para um arquivo Excel

1. Cole o Base64 em Base64 ou data URI. Um prefixo como data:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet;base64, pode ficar. Para uma exportação longa salva como texto, use Abrir arquivo .txt.
2. Acima da tabela, uma linha indica a aba: “Primeira planilha: “Invoices” (3 na pasta de trabalho)”. A tabela tem as letras das colunas no topo e os números de linha da própria planilha na lateral, então a linha 17 é a linha 17 no Excel, mesmo que as linhas anteriores estejam vazias.
3. Abaixo da tabela, a lista de entradas mostra todas as partes da pasta de trabalho, com Ver e Salvar.
4. Clique em Baixar arquivo para salvar o .xlsx.

Ler a planilha não exige Excel nem nenhum suplemento. A página descompacta a pasta de trabalho e faz o parse do XML no seu navegador, e a Content Security Policy dela só permite as requisições de rede do contador de visitas da Cloudflare, então os dados ficam no seu dispositivo.

Como a prévia mostra os valores das células

A tabela mostra o que está armazenado em cada célula, sem os formatos de número do Excel. Em geral é isso que você quer ao conferir uma exportação, mas alguns tipos de célula aparecem diferente do Excel:

Para transformar um número de série em data, some essa quantidade de dias a 30 de dezembro de 1899: datetime(1899, 12, 30) + timedelta(days=45672) dá 15 de janeiro de 2025. Pastas de trabalho que usam o sistema de datas 1904, uma configuração de versões antigas do Excel para Mac, contam a partir de 1º de janeiro de 1904.

Os resultados das fórmulas só aparecem se o programa que gravou o arquivo os armazenou. Excel e LibreOffice armazenam; algumas bibliotecas gravam fórmulas sem resultados, e essas células aparecem vazias.

A prévia tem limites: ela lê a primeira aba na ordem da pasta de trabalho (a aba mais à esquerda, mesmo que esteja oculta ou que outra aba estivesse ativa), até 200 linhas e 30 colunas (de A a AD). Quando há mais, aparece o aviso “Mostrando até 200 linhas × 30 colunas.”. Gráficos, imagens, comentários e formatação não são exibidos.

XLSX, XLS, CSV ou outra coisa

Duas variantes baseadas em ZIP pedem atenção. Uma pasta de trabalho com macros contém xl/vbaProject.bin; a prévia funciona normalmente, mas o Excel se recusa a abri-la com a extensão .xlsx, então digite xlsm antes de baixar. Uma pasta de trabalho binária (.xlsb) guarda as abas em arquivos .bin em vez de XML: a ferramenta ainda a chama de XLSX e lista as entradas, mas não mostra tabela, e ela precisa ser salva como xlsb.

Um CSV enviado no lugar de uma pasta de trabalho gera o aviso “Isto parece ser CSV, não XLSX.” com um botão Baixar como .csv. O Excel abre os dois.

De onde vêm as planilhas em Base64

APIs de relatórios e de contabilidade devolvem as exportações geradas como campo Base64 em JSON. Plataformas de automação e low-code muitas vezes passam arquivos entre etapas como strings Base64, e o e-mail leva anexos de planilha como partes MIME em Base64. Para o caminho inverso, de uma pasta de trabalho para uma string, use Excel para Base64.

Ler uma pasta de trabalho em Base64 com Python

Com o pacote openpyxl, a pasta de trabalho pode ser lida direto dos bytes decodificados:

import base64, io
from openpyxl import load_workbook

with open("export.b64") as f:
    raw = base64.b64decode(f.read())

wb = load_workbook(io.BytesIO(raw), data_only=True)
ws = wb.worksheets[0]
for row in ws.iter_rows(values_only=True):
    print(row)

O data_only=True devolve os resultados salvos das fórmulas em vez das fórmulas, os mesmos valores que a prévia mostra. Diferente da prévia, o openpyxl aplica os formatos de número às datas, então a célula acima volta como datetime(2025, 1, 15, 0, 0). Há mais opções de decodificação em Base64 em Python.

Perguntas frequentes