API de código de barras DataMatrix para saída PDF vetorial
Renderize códigos de barras DataMatrix e GS1 DataMatrix em etiquetas e documentos PDF para fluxos de produto, saúde, varejo e armazém.
/api/v1/pdf/render Renderizar dados DataMatrix ou GS1 DataMatrix como elementos vetoriais de código de barras em PDF dentro de etiquetas de produto, etiquetas de armazém ou documentos, enquanto seu sistema controla o conteúdo de negócio codificado.
Quando usar esta API
- Você precisa de um código de barras 2D DataMatrix em um documento ou etiqueta PDF.
- Sua aplicação já conhece o identificador, lote, série ou dados de produto codificados.
- Você precisa de layouts repetidos de etiqueta DataMatrix por Template Render.
- Você quer saída vetorial de código de barras em vez de imagens raster incorporadas em um PDF.
O que ela não substitui
- Você precisa de certificação regulatória, aprovação de rotulagem de dispositivo ou certificação GS1 pelo gPdf.
- Você precisa que o gPdf gere identificadores de negócio ou consulte registros externos.
- Você precisa de gestão de parque de scanners.
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 - código de barras GS1 DataMatrix em uma etiqueta de produto.
{
"pages": [
{
"size": "label_100_100",
"elements": [
{
"type": "barcode",
"format": "gs1-datamatrix",
"content": "(01)09506000134352(10)LOT26A",
"x": 10,
"y": 14,
"width": 34,
"height": 34
},
{
"type": "text",
"x": 10,
"y": 56,
"content": "GTIN 09506000134352\nLOT LOT26A",
"style": { "font_size": 9, "font_family": "NotoSans-Regular" }
}
]
}
]
}
O que a gPdf faz
- Renderização vetorial de códigos de barras DataMatrix e GS1 DataMatrix em PDFs.
- Layout de etiqueta ou documento ao redor do código de barras.
- Vinculação a modelo para etiquetas repetidas de produto ou armazém.
- Saída binária em PDF para fluxos de impressão, arquivo ou download.
O que seu sistema controla
- Conteúdo codificado, identificadores de aplicação, séries, lotes e texto regulatório.
- Testes de scanner, validação do tamanho dos módulos, mídia da etiqueta e critérios de aceite.
- Qualquer fluxo de compliance específico do setor que consuma o código de barras.
Checklist de produção
- Verifique a sintaxe dos dados codificados antes da renderização.
- Imprima e escaneie no tamanho, DPI e material de produção.
- Teste identificadores longos e múltiplas variantes de idioma de produto.
- Mantenha certificação e revisão regulatória fora do gPdf.
- Use Template Render para famílias de etiqueta aprovadas.
Limites da promessa
- O gPdf renderiza códigos de barras DataMatrix; ele não certifica compliance regulatório.
- Seu sistema controla a semântica dos dados codificados e o aceite por scanner.
- Renderização vetorial não substitui validação física de impressão.
DataMatrix em PDF é um trabalho de renderização
Códigos de barras DataMatrix costumam carregar identificadores de produto ou logística. A fronteira importante é o dado codificado. O gPdf renderiza um código de barras vetorial a partir do valor enviado; seu sistema decide o que o valor significa e se ele atende a requisitos externos.
FAQ
- O gPdf oferece suporte a códigos de barras DataMatrix?
- Sim. O schema público lista aliases de formato de código de barras datamatrix e GS1 DataMatrix.
- O gPdf valida conteúdo regulatório?
- Não. O gPdf renderiza o código de barras. Seu sistema controla a correção dos dados codificados e a revisão regulatória.
- Etiquetas DataMatrix podem usar Template Render?
- Sim. Use Template Render quando um layout de etiqueta repetido deve aceitar apenas dados de negócio.
- Ainda preciso testar leitura por scanner?
- Sim. Sempre valide com impressoras, materiais e scanners de produção.