Um Google Apps Script que transforma linhas da sua planilha do Google em faturas em PDF no seu modelo, com um botão

Exemplo de resultado

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Pasta: sales/2026-10, 9 arquivos encontrados
2026-11-02 09:14:03 INFO  shop-01.csv: 1.284 linhas
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 linhas
2026-11-02 09:14:04 WARN  shop-07.csv: 3 linhas sem preço ignoradas (linhas 88, 412, 913)
2026-11-02 09:14:05 INFO  Pronto: 10.412 linhas -> report-2026-10.xlsx (abas "Vendas" e "Totais")

[columns]
date = Data, Data da venda, Dia
product = Produto, Item, Descrição
quantity = Qtd, Quantidade, Unid
price = Preço, Preço unitário

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Lê o arquivo de uma loja e dá a ele os nomes de colunas do relatório."""
    table = pd.read_excel(path) if path.suffix == ".xlsx" else pd.read_csv(path, encoding="utf-8-sig")
    renamed = {}
    for name, variants in columns.items():
        found = next((c for c in table.columns if c.strip() in variants), None)
        if found is None:
            raise ReportError(f"{path.name}: nenhuma coluna para '{name}' (procuradas: {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

Sobre este serviço

Se você registra pedidos ou horas de trabalho em uma planilha do Google, fazer cada fatura à mão significa copiar o cliente, os itens e os totais para um documento e salvar um PDF. Este Google Apps Script coloca um botão na sua planilha: ele preenche o seu próprio modelo de fatura no Documentos Google ou no Planilhas Google com os dados da linha, salva um PDF com o nome que você quiser em uma pasta do Drive e coloca o link de volta na linha. A partir do Padrão, ele lida com várias linhas de itens e numeração; o Premium pode enviar cada PDF do seu Gmail para o seu cliente. Totais, impostos e textos vêm da sua planilha e do seu modelo: o script faz as contas que você descrever e não dá orientação fiscal ou contábil, então confira as primeiras faturas. Você instala e roda na sua conta do Google.

O que está incluído

• O que você recebeUm arquivo ZIP com o código do Apps Script e um README que mostra como adicioná-lo à sua planilha e ao seu modelo; o código também aparece na página do pedido.
• O seu próprio modeloSeu layout, logo e textos no Documentos Google ou no Planilhas Google
• PDF no DriveNomeado por número, cliente e data, na pasta que você definir
• Link na linhaVocê vê quais linhas já têm fatura
• NumeraçãoA partir do Padrão, o próximo número tirado da sua planilha
• Código legívelCom comentários, fácil de mudar um campo depois

Como funciona

1. 1
   ModeloVocê envia as colunas da planilha e o seu modelo de fatura
2. 2
   CódigoEscrevemos o script e o guia de instalação
3. 3
   TesteVocê gera faturas de teste em uma cópia da planilha e confere as contas
4. 4
   AjustesVocê pede ajustes dentro do seu pacote e envia qualquer mensagem de erro

O que precisamos de você

Os nomes das colunas da sua planilha com duas ou três linhas de dados inventados, o seu modelo de fatura (um documento ou planilha do Google, ou o PDF de uma fatura que você envia hoje) com o lugar de cada valor, e como os totais são calculados: alíquota de imposto, descontos, moeda e arredondamento, conforme o seu contador orientar. Como as faturas são numeradas e nomeadas, a pasta do Drive para os PDFs e, para o Premium, o texto do e-mail para o cliente.

Vamos perguntar:

• Pelo que você cobra?
• Quais são as colunas da planilha?
• Como é a sua fatura?
• Como os totais são calculados?

Compare os pacotes

Perguntas e respostas

Não encontrou a resposta? Pergunte