API de etiqueta de armazém para fluxos de impressão WMS e ERP
Gere PDFs de etiquetas de pallet, caixa, bin, inventário e operações de armazém a partir de dados WMS ou ERP, com reimpressões determinísticas.
/api/v1/pdf/render Renderizar etiquetas de armazém a partir de dados WMS ou ERP para pallets, caixas, bins, ativos, locais e movimentações de estoque, mantendo estado de inventário, regras de separação e operações de armazém no sistema chamador.
Quando usar esta API
- Você precisa de etiquetas em PDF para pallet, caixa, bin, local, inventário ou ativo.
- Seu WMS ou ERP já controla SKU, lote, local, SSCC e dados de inventário.
- Você precisa de reimpressões determinísticas quando uma etiqueta é danificada ou uma estação tenta novamente um job.
- Você quer reutilizar layouts de etiqueta aprovados por meio de Template Render.
O que ela não substitui
- Você precisa que o gPdf gerencie inventário, aloque locais ou execute fluxos de armazém.
- Você precisa de um app de scanner, agente de estação de impressão ou sistema de roteamento de etiquetas fornecido pelo gPdf.
- Você precisa de certificação GS1 em vez de renderização de código de barras.
Qual endpoint chamar
/api/v1/pdf/render
JSON Render é o caminho padrão para este fluxo.
/api/v1/template-render
Use quando o fluxo precisar da API relacionada, de um contrato de template ou de uma consulta de capacidades.
Request mínimo
POST /api/v1/pdf/render - etiqueta de pallet com dados de código de barras SSCC.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 6,
"y": 8,
"content": "PALLET LAX-01-2026-00042",
"style": { "font_size": 12, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "012345678901234567",
"x": 6,
"y": 30,
"width": 88,
"height": 26,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 6,
"y": 70,
"content": "SKU: CASE-001\nQTY: 48\nLOCATION: A-14-02",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
O que a gPdf faz
- Etiquetas PDF para fluxos de impressão de armazém.
- Códigos de barras vetoriais, texto, caixas, tamanhos de página de etiqueta e vinculação a modelo.
- Saída determinística para fluxos de reimpressão e auditoria.
- JSON Render para layouts personalizados e Template Render para contratos de etiqueta aprovados.
O que seu sistema controla
- Estado do inventário, dados de SKU, dados de lote/série, valores SSCC e semântica de localização.
- Roteamento de impressoras, configuração de estações, validação por scanner e regras do processo de armazém.
- Seleção de modelo, retentativas e armazenamento dos PDFs renderizados ou dos dados de origem.
Checklist de produção
- Valide as dimensões da etiqueta contra a impressora e a mídia reais.
- Escaneie cada formato de código de barras usado pelo processo de armazém.
- Mantenha o estado WMS/ERP como autoridade e envie ao gPdf apenas dados finais de etiqueta.
- Use Template Render para etiquetas impressas por vários sistemas ou estações.
- Registre IDs dos documentos de origem e IDs de requisição para rastreabilidade de reimpressão.
Limites da promessa
- O gPdf renderiza PDFs de etiqueta de armazém; ele não gerencia inventário nem estado do armazém.
- O chamador controla a semântica dos dados codificados no código de barras e o aceite por scanner.
- Template Render pode estabilizar layouts de etiqueta, mas não substitui regras do WMS.
Etiquetas de armazém são registros operacionais
Etiquetas de armazém identificam pallets, caixas, bins, ativos, movimentações de inventário e locais. Elas estão ligadas ao estado operacional no seu WMS ou ERP. O gPdf deve receber os dados finais da etiqueta e renderizá-los; ele não deve decidir significado de inventário nem estado do processo de armazém.
Template Render simplifica as estações de impressão
Para etiquetas usadas em várias estações, publique o layout aprovado como
modelo. Serviços de impressão podem então enviar template_id mais dados do WMS
em vez de reconstruir coordenadas em cada chamador.
Determinismo de reimpressão
Armazéns reimprimem etiquetas. Uma etiqueta danificada, uma impressora travada ou uma nova tentativa da estação não deve criar um documento ligeiramente diferente. Mantenha os dados de origem da etiqueta vinculados ao registro do armazém e use entradas de renderização determinísticas para reimpressões.
FAQ
- O gPdf gerencia inventário de armazém?
- Não. Seu WMS ou ERP controla estado do inventário, locais, SKUs, lotes e regras de processo. O gPdf renderiza o PDF da etiqueta a partir dos dados finais.
- Etiquetas de armazém podem usar códigos de barras GS1 ou SSCC?
- Sim, o gPdf pode renderizar formatos de código de barras suportados na saída em PDF. Seu sistema controla os dados codificados e o aceite por scanner.
- Etiquetas de armazém repetidas devem usar modelos?
- Normalmente sim. Template Render dá às estações de impressão um template_id estável e um contrato de dados depois que o layout da etiqueta é aprovado.
- Como devem funcionar as reimpressões?
- Armazene os dados de origem da etiqueta ou o PDF gerado junto ao registro do armazém; depois renderize ou recupere a mesma etiqueta usando os IDs operacionais originais.