Automatize a Impressão de Etiquetas de Código de Barras com a API LPSNG
Se a sua equipe ainda exporta dados de pedidos, abre um modelo de etiqueta, cola SKUs e clica em Imprimir uma vez por pacote, o gargalo não é a impressora. É a etapa manual intermediária entre os seus dados e a etiqueta. A API de Web Service LPSNG elimina essa etapa: você envia trabalhos de impressão programaticamente, renderiza etiquetas individuais como PDF ou PNG para visualização e envia trabalhos diretamente para impressoras térmicas ou padrão.
Este guia cobre as partes práticas: configuração única de OAuth2, um pipeline automatizado básico, tratamento de falhas e as práticas que mantêm um sistema de automação de etiquetas confiável à medida que o volume cresce.
Configuração Única: Conectando Sua Aplicação ao LPSNG
Antes de enviar uma única etiqueta, você precisa conectar sua aplicação ao LPSNG. O LPSNG usa um protocolo de registro OAuth2 simplificado para sistemas externos. Em vez de um longo processo manual de aplicativo de desenvolvedor, a conexão é configurada com uma única URL de registro.
O fluxo funciona assim:
- Inicie o registro OAuth2 entre sua aplicação e o LPSNG.
- Aprove a conexão.
- Armazene as credenciais retornadas no seu ambiente de integração.
- Use essas credenciais para solicitar tokens de portador para chamadas de API.
O mesmo modelo de registro por URL única é usado para sistemas externos, como estações base ESL, então, uma vez que sua equipe o tenha configurado uma vez, o padrão é repetível em outras integrações.
Para onde você aponta a API depende da sua implantação. A edição em nuvem multi-inquilino hospedada e a edição embarcada expõem a interface de web service. Se você precisa de um caminho de linha de comando offline ou de alto volume, o LPSNG Player é um mecanismo de impressão autônomo que recebe entrada de pacotes e dados e produz saída em PDF, PNG, JSON, impressão ou ESL.
Para não desenvolvedores ou processos baseados em planilhas, o Complemento do Google Sheets e a Interface Excel são rotas úteis sem código. Se você está automatizando a partir de uma planilha em vez de código, consulte Como Imprimir Etiquetas do Google Sheets com LPSNG antes de criar um cliente de API personalizado.
Mantenha suas credenciais de integração fora do controle de versão:
# .env — armazene no seu gerenciador de segredos ou no armazenamento de segredos de CI/CD
LPSNG_BASE_URL=https://<sua-instancia-lpsng>
LPSNG_CLIENT_ID=<do-registro-oauth2>
LPSNG_CLIENT_SECRET=<do-registro-oauth2>
Construindo o Pipeline Automatizado: Dos Dados à Etiqueta Impressa
O loop central é simples: seu sistema de pedidos, inventário ou expedição tem registros. Você empacota esses registros em uma carga de trabalho e a envia para a API de Web Service LPSNG. O LPSNG renderiza as etiquetas usando os modelos que você projetou, e o resultado é um trabalho de impressão em uma impressora configurada ou um arquivo renderizado.
Isso oferece três padrões úteis:
- Imprimir diretamente: envie o trabalho e deixe o LPSNG enviá-lo para a impressora de destino.
- Renderizar para aprovação: gere uma única etiqueta como PDF ou PNG para visualização, anexo de e-mail ou arquivamento.
- Imprimir e arquivar: combine ambos os caminhos para que a etiqueta física seja impressa e uma prova em PNG/PDF seja armazenada no seu sistema.
Uma integração mínima em Python pode ter esta aparência. Os caminhos de endpoint e os campos de carga são intencionalmente conceituais aqui — use o guia da API de Web Service para os formatos exatos de solicitação.
import os
import requests
LPSNG_BASE_URL = os.environ["LPSNG_BASE_URL"]
def get_token():
# Troque as credenciais de registro OAuth2 por um token de portador.
# Consulte o guia OAuth2 para os campos exatos de solicitação e resposta.
...
def render_label_preview(template_id: str, record: dict, output_format: str = "png"):
token = get_token()
response = requests.post(
f"{LPSNG_BASE_URL}/<endpoint-de-renderizacao>", # caminho exato no guia da API de Web Service
headers={"Authorization": f"Bearer {token}"},
json={
"template_id": template_id,
"data": record,
"format": output_format,
},
timeout=30,
)
response.raise_for_status()
return response.content
def submit_print_job(template_id: str, records: list[dict]):
token = get_token()
response = requests.post(
f"{LPSNG_BASE_URL}/<endpoint-de-trabalhos>",
headers={"Authorization": f"Bearer {token}"},
json={
"template_id": template_id,
"records": records,
},
timeout=30,
)
response.raise_for_status()
return response.json()
Sua carga de trabalho deve conter apenas os dados variáveis que seu modelo de etiqueta precisa. Mantenha o modelo responsável pelo layout, formatação de código de barras e conteúdo estático.
Para conteúdo dinâmico de etiquetas, o LPSNG inclui uma API de Script de Campo em Python. Você pode anexar blocos de script Python a campos de etiqueta para que eles possam acessar e modificar valores de campo antes da impressão. Isso é útil para formatação, limpeza de dados de entrada ou aplicação de lógica condicional diretamente dentro da etiqueta, em vez de construir toda essa lógica na sua aplicação.
# Script de campo conceitual anexado a um campo de código de barras ou texto.
if record.get("country_code") == "DE":
value = value.strip().upper()
A mesma mentalidade de automação se estende além das etiquetas de papel. Para etiquetas eletrônicas de prateleira, o LPSNG fornece uma interface de arquivo JSON neutra em relação ao fornecedor chamada ESLSEND e uma API de Vinculação ESL. Se o seu projeto inclui etiquetas de preço digitais, consulte O Que São Etiquetas Eletrônicas de Prateleira e Como Elas Funcionam? para o contexto mais amplo.
Monitoramento e Tratamento de Falhas
Um pipeline de automação confiável não trata um trabalho enviado como um trabalho impresso. Depois de enviar uma solicitação de impressão, acompanhe o trabalho até que ele alcance um estado terminal.
A interface web do LPSNG inclui uma fila de trabalhos, que oferece aos operadores um ponto de supervisão manual. Essa fila é útil para identificar trabalhos com falha, verificar por que uma etiqueta não foi impressa e reimprimir sem reenviar os dados originais.
No seu código de integração, crie uma pequena consulta de status:
import time
def wait_until_terminal(job_reference: str, timeout: int = 120):
deadline = time.time() + timeout
while time.time() < deadline:
state = get_job_state(job_reference) # da API ou da fila de trabalhos
if state in ("printed", "completed", "failed"):
return state
time.sleep(2)
raise TimeoutError(
f"O trabalho {job_reference} não alcançou um estado terminal em {timeout}s"
)
Para novas tentativas, seja conservador após tempos limite de rede. Um tempo limite não informa se o trabalho foi aceito. Antes de reenviar, consulte a fila de trabalhos para sua tentativa anterior. Se você puder anexar uma referência de trabalho gerada pelo cliente, mantenha-a estável entre as tentativas para que um envio duplicado seja detectável.
Em produção, registre pelo menos estes campos:
- referência do trabalho ou ID retornado pela API
- ID do modelo
- identificadores de registro, como número do pedido ou SKU
- impressora ou rota de saída
- status HTTP e corpo do erro
Em seguida, alerte sobre trabalhos com falha em vez de apenas sobre erros no nível do serviço. Uma etiqueta que falha silenciosamente é pior do que um serviço que relata uma exceção.
Melhores Práticas para Automação de Etiquetas
- Projete modelos em torno de espaços reservados para dados variáveis. Quanto mais você mantiver layout, tipo de código de barras e marca estática no modelo, menos código de aplicação você precisará alterar posteriormente.
- Use a API de Script de Campo em Python para transformações no nível da etiqueta. Formatar um código de barras, aparar entrada ou alterar texto condicionalmente pertence ao script da etiqueta quando é específico da etiqueta.
- Use a Interface Excel para tabelas de consulta e validação de dados. Se sua aplicação já depende de planilhas para dados de produtos, mapeamento ou validação, o LPSNG pode usar arquivos Excel como arquivos de dados e arquivos de consulta.
- Considere a Edição Embarcada para ambientes locais ou de baixa latência. Ela fornece o LPSNG completo em um computador de placa única, como um Raspberry Pi, o que é útil quando as etiquetas devem ser impressas mesmo se a conectividade com a nuvem for interrompida.
- Observe a Solução White Label para construções OEM ou de revenda. Se a impressão de etiquetas estiver incorporada em um produto maior, a edição white label foi projetada para fabricantes de impressoras, fabricantes de papel e integradores de sistemas.
Dentro do estúdio de etiquetas do Next Generation Label Printing System, modelos reutilizáveis são a chave para a manutenibilidade a longo prazo. Uma boa regra prática: se duas etiquetas diferem apenas nos dados, elas devem ser um único modelo.
Perguntas Frequentes
Qual método de autenticação a API LPSNG usa?
O LPSNG usa OAuth2 com um protocolo de registro simplificado. Você registra sua aplicação por meio de uma única URL e recebe credenciais para autenticar chamadas de API.
Posso renderizar visualizações de etiquetas sem imprimir?
Sim, a API de Web Service pode renderizar etiquetas individuais como arquivos PDF ou PNG. Esses arquivos podem ser usados para visualizações, anexos de e-mail ou arquivamento.
A API suporta todos os formatos de código de barras?
O LPSNG suporta uma ampla variedade de formatos de código de barras 1D e 2D. Consulte a documentação de Formatos de Código de Barras para a lista completa.
Existe uma opção offline ou local para automação?
Sim, o LPSNG Player é um mecanismo de impressão de linha de comando autônomo que pode ser executado localmente, e a Edição Embarcada fornece uma instalação completa do LPSNG em um computador de placa única, como um Raspberry Pi.
Conclusão: Comece a Automatizar Hoje
A impressão de etiquetas orientada por API elimina a cópia, colagem e cliques manuais que causam expedição lenta e remessas com etiquetas erradas. Com a API de Web Service LPSNG, os mesmos dados que impulsionam seu sistema de pedidos ou inventário podem produzir etiquetas impressas, visualizações em PDF e atualizações de etiquetas eletrônicas de prateleira sem uma pessoa no meio.
Comece pequeno: escolha um tipo de etiqueta, conecte uma aplicação e execute-a em paralelo com seu processo existente até confiar na saída. O Next Generation Label Printing System gerenciado oferece a edição em nuvem e o player autônomo para avaliar o fluxo de trabalho sem construir uma sala de impressão inteira primeiro.
Para detalhes de implementação, comece com a documentação da API de Web Service e o guia OAuth2.
Posts relacionados
- O Que São Etiquetas Eletrônicas de Prateleira e Como Elas Funcionam?
- Como Imprimir Etiquetas do Google Sheets com LPSNG
- Preços do LPSNG: Qual Edição Atende às Suas Necessidades?
