Automatize a Impressão de Etiquetas Diretamente do Google Sheets

Você já tem os dados. Eles estão em uma planilha — SKUs, nomes de produtos, códigos de barras, preços, números de lote — e ela é a única fonte de verdade que todos na equipe realmente editam.

Depois, alguém precisa exportar essas linhas para CSV, abrir um designer de etiquetas, reimportar os dados, realinhar cada campo e imprimir o lote. De novo. E de novo, toda vez que um preço muda ou um novo SKU chega.

Se você quer automatizar a impressão de etiquetas a partir do Google Sheets, o objetivo é simples: a planilha permanece onde está, e as etiquetas saem do outro lado. Sem etapa de exportação, sem reimportação, sem ida e volta de alinhamento de campos. Este artigo percorre a configuração única, o pipeline e o tratamento de falhas necessários para tornar isso confiável.

Por Que a Impressão Manual de Etiquetas a Partir do Google Sheets Desperdiça Tempo

A tarefa repetitiva tem sempre o mesmo formato:

• Exportar as linhas relevantes para CSV.
• Abrir o designer de etiquetas e carregar o arquivo como fonte de dados.
• Remapear as colunas para os campos, porque a ordem de exportação mudou de novo.
• Imprimir cada lote manualmente, um arquivo por vez.

O custo oculto não são os dez minutos por lote. É que qualquer alteração nos dados — uma atualização de produto, uma mudança de preço, um novo SKU — força uma ida e volta manual completa antes que uma única etiqueta exista. Sua planilha é dinâmica; suas etiquetas não.

Dois grupos sentem isso mais:

• Desenvolvedores que criam ferramentas internas e recebem o pedido de “só conectar a impressão” e acabam mantendo um script de exportação frágil.
• Usuários finais em estoque, expedição e varejo que se importam com uma coisa: a etiqueta na prateleira ou na caixa corresponde aos dados que acabaram de digitar.

Como a automação deveria ser: você edita uma linha, você imprime. A planilha é o front end, e o sistema de etiquetas é o renderizador.

É exatamente aí que se encaixa o Next Generation Label Printing System (LPSNG) — um add-on gerenciado que transforma o Google Sheets em um front end de impressão de etiquetas.

Configuração Única: Conectando o Google Sheets ao Seu Sistema de Etiquetas

A configuração acontece uma vez. Depois disso, imprimir é um clique.

1. Instale o add-on. Obtenha o add-on do Google Sheets na página de integrações do LPSNG e autorize-o na sua conta LPSNG. O add-on está listado entre as integrações da plataforma — junto com a interface do Excel, a barra lateral reutilizável e a API de scripts de campo.

2. Entenda o registro OAuth2. O LPSNG usa um protocolo de registro OAuth2 simplificado para conectar sistemas externos: uma única URL conecta o add-on à sua instância LPSNG. Essa URL é a mesma, seja você usando a edição em nuvem hospedada ou uma estação de impressão no seu próprio hardware. Você registra uma vez; o add-on obtém um token e o renova para você. Você nunca cola um token em uma célula.

3. Prepare a planilha. Uma linha por etiqueta. Cabeçalhos de coluna que mapeiam claramente para os campos da etiqueta:

Mantenha a linha de cabeçalho estável. Renomear barcode para bar_code depois é a forma mais comum de quebrar uma configuração que funcionava.

4. Crie o layout. Construa ou importe um layout de etiqueta no estúdio de etiquetas do LPSNG e vincule as colunas da planilha aos campos do layout para que cada linha seja renderizada como exatamente uma etiqueta. Os códigos de barras são tratados nativamente — o LPSNG suporta uma variedade de formatos de código de barras 1D e 2D, então uma coluna barcode é renderizada como um símbolo escaneável sem nenhuma ferramenta extra.

5. Escolha o destino de saída uma vez. Download em PDF, impressão direta em uma impressora configurada ou PNG para pré-visualizações. Você pode pré-visualizar um lote como PDF e depois enviar o mesmo layout para uma impressora térmica.

Se você ainda está escolhendo uma plataforma, o Guia de Compra de Software de Design de Etiquetas para Integradores de Sistemas aborda os critérios de avaliação com mais profundidade.

O Pipeline Automatizado: Da Edição na Planilha à Etiqueta Impressa

Uma vez que o mapeamento existe, há duas formas de disparar a saída.

Sob demanda. Abra a barra lateral do add-on, selecione a linha ou o intervalo desejado e imprima. Este é o caminho do dia a dia para uma reimpressão única ou um preço corrigido.

Em lote com um filtro. Execute em todas as linhas que correspondem a um filtro — por exemplo, tudo marcado como status = pending em uma coluna auxiliar. O add-on envia a seleção para o serviço web do LPSNG, que renderiza cada linha usando seu layout salvo e enfileira os trabalhos.

Lógica em nível de campo antes da impressão

Planilhas reais são bagunçadas. Datas chegam como timestamps, dígitos verificadores estão faltando e metade dos seus nomes de produtos precisa de um sufixo de tamanho. Em vez de limpar tudo na planilha, anexe um bloco de script Python ao próprio campo da etiqueta. Os scripts de campo são executados antes da impressão e podem ler e modificar o valor recebido:

# Illustrative field script attached to the "price" label field.
# The shape is the same for every field: take the incoming value,
# return the string that should end up on the label.
def prepare(value):
    amount = float(value)
    return f"{amount:,.2f} EUR"

O mesmo mecanismo lida com formatação de datas, concatenação de duas colunas em um bloco de endereço ou cálculo de um dígito verificador a partir de um número de artigo bruto. Observe que esta é uma lógica de campo — ela altera o que é impresso, nunca o que é armazenado na planilha.

A forma difícil, para contexto

Você poderia pular o add-on. A API do serviço web aceita trabalhos com tokens OAuth2 e payloads JSON brutos — é a mesma chamada que o add-on faz. Mas então você é responsável pela renovação do token, pela lógica de retentativa, pelo mapeamento de colunas e por toda mudança que quebre seu próprio script. Se você quer especificamente esse nível de controle, o passo a passo do serviço web aborda o modelo de requisição/resposta.

A forma gerenciada é a mais curta: edite a planilha, clique em imprimir, colete as etiquetas. O add-on realiza a chamada ao serviço web para você.

Monitorando Trabalhos e Tratando Falhas

Impressão é I/O, e I/O falha. O que importa é que você consiga ver quais linhas falharam e reexecutar apenas essas.

• Use a fila de trabalhos. Os trabalhos de impressão enviados aparecem na fila de trabalhos do LPSNG com seu status, então você pode rastrear um trabalho de volta até as linhas da planilha que o produziram.
• Conheça os suspeitos de sempre. A maioria das falhas é uma de três coisas: um campo obrigatório está vazio em uma linha, a impressora de destino está offline ou um campo do layout não mapeia mais para uma coluna da planilha (geralmente após renomear uma coluna).

Projete a planilha para que as retentativas sejam baratas. Adicione uma coluna de status ou derive-a com uma fórmula:

=IF(OR(B2="",C2=""),"BLOCKED","READY")

Agora uma falha parcial é um filtro, não uma reimpressão do lote inteiro: corrija a linha, defina-a de volta como READY e imprima apenas as linhas READY.

Para volumes maiores ou execuções não assistidas, o LPSNG Player — o motor de impressão autônomo de linha de comando — recebe um pacote mais um arquivo de dados e emite PDF, PNG, JSON ou trabalhos de impressão direta. A invocação tem sempre o mesmo formato: aponte para um pacote, aponte para os dados, diga o que emitir.

# Package in, data in, files out. Check the Player documentation
# for the exact flag names in your release.
lpsng-player \
  --package ./labels/retail-shelf.lpsng \
  --data ./exports/price-update.csv \
  --out ./out/labels.pdf

Fique de olho nas notas de versão e no blog do LPSNG para mudanças no add-on e no serviço web que afetam o comportamento de envio de trabalhos — é onde as perguntas sobre comportamento alterado são respondidas primeiro.

Boas Práticas para uma Impressão de Etiquetas Confiável Orientada por Planilha

• Trate a planilha como um banco de dados. Cabeçalhos estáveis, um registro por linha, sem células mescladas dentro do intervalo de dados. Células mescladas são a causa número um de “por que a linha 47 está imprimindo a coisa errada”.
• Valide antes de imprimir. Capture códigos de barras vazios ou valores malformados com fórmulas da planilha ou um script de campo Python, em vez de descobri-los em uma etiqueta física.
• Versione seus layouts. Uma mudança de design não deve quebrar silenciosamente um mapeamento de planilha existente. Mantenha o vínculo explícito e teste o layout com uma amostra de linhas reais.
• Separe teste de produção. Uma segunda planilha, ou uma coluna de filtro, mantém os experimentos longe da impressora.
• Use papéis em equipes multiusuário. Os recursos empresariais do LPSNG — multiusuário, multirregião, multidispositivo — permitem controlar quem edita layouts versus quem apenas imprime, o que elimina completamente a classe de falha por edição acidental.

FAQ

Preciso escrever código para automatizar a impressão de etiquetas a partir do Google Sheets?

Não. O add-on do Google Sheets do Next Generation Label Printing System cuida da conexão e do envio de trabalhos para você. Você instala o add-on, autoriza-o uma vez pelo fluxo de registro OAuth2, mapeia as colunas da planilha para os campos da etiqueta e imprime. Escrever sua própria integração com a API do serviço web é possível, mas não obrigatório.

Posso imprimir em uma impressora térmica, ou apenas em PDF?

O LPSNG pode renderizar etiquetas como PDF ou PNG e também pode enviar trabalhos para impressão direta em uma impressora configurada. O add-on permite escolher o destino de saída, então você pode pré-visualizar como PDF e depois imprimir na sua impressora térmica a partir do mesmo layout.

O que acontece se minha planilha tiver centenas de linhas?

O add-on envia o lote para o serviço web do LPSNG, que renderiza cada linha como uma etiqueta e enfileira os trabalhos. Você pode monitorar o progresso na fila de trabalhos. Para execuções não assistidas ou de volume muito alto, o motor de linha de comando LPSNG Player foi projetado para processar entradas de pacote mais dados e gerar PDF, PNG, JSON ou impressões diretas.

Isso funciona com a edição embarcada em um Raspberry Pi?

Sim. A edição embarcada executa o LPSNG completo em um computador de placa única, como um Raspberry Pi, e o mesmo registro OAuth2 e interface de serviço web são usados para conectar o add-on do Google Sheets. Isso é útil para estações de impressão que precisam operar independentemente da edição em nuvem.

Conclusão

A planilha já é seu banco de dados de produtos, lista de preços e manifesto de expedição. Transformá-la em uma impressora de etiquetas é uma conexão única: instale o add-on, autorize uma vez, mapeie colunas para campos, escolha um destino de saída. Depois disso, automatizar a impressão de etiquetas a partir do Google Sheets é um clique — não uma exportação, uma importação e um realinhamento.

Próximo passo: instale o add-on do Google Sheets na página de integrações, construa um layout no estúdio de etiquetas e imprima seu primeiro lote orientado por planilha a partir de uma planilha de teste com cinco linhas.

Posts relacionados

• Guia de Compra de Software de Design de Etiquetas para Integradores de Sistemas
• Como Imprimir Etiquetas a Partir de uma API de Serviço Web: Um Passo a Passo para Desenvolvedores
• Alternativa ao Zebra Designer: Softwares de Impressão de Etiquetas para Comparar