API de código de barras GS1 para etiquetas PDF vetoriais
Renderize códigos de barras GS1 vetoriais em PDFs, incluindo fluxos GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 e etiquetas SSCC-18.
/api/v1/pdf/render Renderizar dados codificados GS1 em etiquetas ou documentos PDF vetoriais enquanto seu sistema de produto, armazém ou varejo continua responsável por identificadores de aplicação corretos, dígitos verificadores e aceite por scanner.
Quando usar esta API
- Você precisa que os módulos do código de barras sejam desenhados como conteúdo vetorial no PDF, não como imagens bitmap coladas.
- Seu sistema já tem os dados GS1 corretos e a interpretação legível por humanos.
- Você precisa de fluxos GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 ou SSCC-18 em etiquetas ou documentos.
- Você quer mover layouts repetidos de etiqueta com código de barras para Template Render.
O que ela não substitui
- Você precisa de certificação GS1 ou validação da semântica dos dados de produto pelo gPdf.
- Você precisa que o gPdf aloque prefixos de empresa GS1, GTINs, SSCCs ou dígitos verificadores.
- Você precisa de gestão de inventário ou dados mestres de produto.
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 - elemento de código de barras PDF no estilo GS1-128.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "barcode",
"format": "gs1-128",
"content": "(00)012345678901234567",
"x": 8,
"y": 22,
"width": 86,
"height": 24,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 8,
"y": 56,
"content": "SSCC pallet label",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
O que a gPdf faz
- Renderização vetorial de código de barras dentro da saída em PDF.
- Posicionamento de código de barras com texto, linhas, dados de produto e estruturas de etiqueta.
- Template Render para etiquetas repetidas de produto, pallet, caixa e armazém.
- Saída em PDF adequada para testes de scanner e impressão.
O que seu sistema controla
- Identificadores de aplicação GS1, prefixos de empresa, GTINs, SSCCs e dígitos verificadores.
- Dados corretos do código de barras, dados de produto, texto regulatório e testes de aceite por scanner.
- Processo de impressão, mídia da etiqueta, áreas silenciosas e QA operacional.
Checklist de produção
- Gere os dados GS1 antes da renderização e mantenha-os testáveis.
- Imprima e escaneie em impressoras e scanners de produção.
- Valide áreas silenciosas, tamanho dos módulos, texto legível e mídia da etiqueta.
- Use Template Render depois que o layout da etiqueta for aprovado.
- Documente que o gPdf renderiza códigos de barras, mas não certifica compliance GS1.
Limites da promessa
- O gPdf renderiza códigos de barras vetoriais em PDF; ele não é um órgão de certificação GS1.
- O chamador controla a semântica dos dados GS1 e os dígitos verificadores.
- O aceite por scanner deve ser validado no ambiente de produção do chamador.
Renderização de código de barras GS1 é um trabalho de PDF
O gPdf é responsável por desenhar o código de barras no PDF. Ele não é responsável por decidir se um GTIN, SSCC ou sequência de identificadores de aplicação é válida para o seu negócio. Mantenha essa lógica no seu ERP, WMS, sistema de informações de produto ou ferramenta GS1.
Use JSON Render ou Template Render
Use JSON Render quando o código posiciona diretamente a etiqueta ou o documento. Use Template Render quando o código de barras é um campo dentro de um layout de etiqueta repetido. Nos dois casos, o chamador envia os dados que devem ser codificados.
Valide com scanners reais
O sucesso do código de barras é medido pelo aceite do scanner, não por uma imagem parecer correta no monitor. Valide a saída impressa com as mesmas impressoras, scanners e mídias de etiqueta usados em produção.
FAQ
- O gPdf certifica etiquetas GS1?
- Não. O gPdf renderiza gráficos vetoriais de código de barras em PDFs. Sua equipe controla a correção dos dados GS1, os testes de scanner e qualquer fluxo de certificação.
- Códigos de barras GS1 podem ser usados com Template Render?
- Sim. Um modelo publicado pode conter campos de código de barras, e os chamadores podem enviar apenas os dados variáveis para layouts repetidos de etiqueta.
- Quem cria o SSCC ou GTIN?
- Seu sistema de produto, armazém ou ERP cria e valida os identificadores. O gPdf recebe os dados codificados e os renderiza.
- Por que usar códigos de barras vetoriais?
- Módulos vetoriais evitam artefatos de escala de raster e mantêm PDFs de etiqueta mais nítidos entre diferentes DPIs de impressora e níveis de zoom.