API de códigos de barras GS1 para etiquetas PDF vectoriales
Renderice códigos de barras GS1 vectoriales en PDF, incluidos flujos con GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 y etiquetas SSCC-18.
/api/v1/pdf/render Renderizar datos GS1 de código de barras como etiquetas o documentos PDF vectoriales, mientras su sistema de producto, almacén o retail conserva la responsabilidad sobre identificadores de aplicación correctos, dígitos de control y aceptación por escáner.
Cuándo usar esta API
- Necesita módulos de código de barras dibujados como contenido PDF vectorial, no imágenes de mapa de bits pegadas.
- Su sistema ya tiene los datos GS1 correctos y la interpretación legible por humanos.
- Necesita flujos GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 o SSCC-18 en etiquetas o documentos.
- Quiere mover diseños repetidos de etiquetas con códigos de barras a Template Render.
Qué no sustituye
- Necesita certificación GS1 o validación de semántica de datos de producto por parte de gPdf.
- Necesita que gPdf asigne prefijos de empresa GS1, GTIN, SSCC o dígitos de control.
- Necesita gestión de inventario o datos maestros de producto.
Qué endpoint llamar
/api/v1/pdf/render
JSON Render es la ruta predeterminada para este flujo.
/api/v1/template-render
Úsalo cuando el flujo necesite la ruta API relacionada, un contrato de plantilla o una consulta de capacidades.
Solicitud mínima
POST /api/v1/pdf/render - elemento de código de barras PDF 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" }
}
]
}
]
}
Qué gestiona gPdf
- Renderizado vectorial de códigos de barras dentro de la salida PDF.
- Ubicación del código de barras junto con texto, líneas, datos de producto y estructuras de etiqueta.
- Template Render para etiquetas repetidas de producto, pallet, caja y almacén.
- Salida PDF apta para pruebas de escáner e impresión.
Qué controla su sistema
- Identificadores de aplicación GS1, prefijos de empresa, GTIN, SSCC y dígitos de control.
- Datos correctos del código de barras, datos de producto, texto regulatorio y pruebas de aceptación por escáner.
- Proceso de impresión, material de etiquetas, zonas silenciosas y QA operativo.
Checklist de producción
- Genere los datos GS1 aguas arriba y manténgalos comprobables.
- Imprima y escanee con impresoras y escáneres de producción.
- Valide zonas silenciosas, tamaño de módulo, texto legible por humanos y material de etiquetas.
- Use Template Render cuando el diseño de la etiqueta esté aprobado.
- Documente que gPdf renderiza códigos de barras, pero no certifica cumplimiento GS1.
Límites de la promesa
- gPdf renderiza códigos de barras PDF vectoriales; no es un organismo de certificación GS1.
- El sistema que llama controla la semántica de datos GS1 y los dígitos de control.
- La aceptación por escáner debe validarse en el entorno de producción del cliente.
Renderizar códigos de barras GS1 es un trabajo de renderizado PDF
gPdf se encarga de dibujar el código de barras dentro del PDF. No se encarga de decidir si un GTIN, SSCC o una secuencia de identificadores de aplicación es válida para su negocio. Mantenga esa lógica en su ERP, WMS, sistema de información de producto o herramientas GS1.
Use JSON Render o Template Render
Use JSON Render cuando el código disponga directamente la etiqueta o el documento. Use Template Render cuando el código de barras sea un campo dentro de un diseño repetido de etiqueta. En ambos casos, quien llama envía los datos que deben codificarse.
Valide con escáneres reales
El éxito de un código de barras se mide por aceptación del escáner, no por si una imagen se ve correcta en un monitor. Valide la salida impresa con las mismas impresoras, escáneres y material de etiquetas que usará en producción.
FAQ
- ¿gPdf certifica etiquetas GS1?
- No. gPdf renderiza gráficos vectoriales de código de barras en PDF. Su equipo controla la corrección de los datos GS1, las pruebas de escáner y cualquier flujo de certificación.
- ¿Los códigos GS1 pueden usarse con Template Render?
- Sí. Una plantilla publicada puede contener campos de código de barras, y los clientes pueden enviar solo los datos variables para diseños repetidos de etiqueta.
- ¿Quién crea el SSCC o el GTIN?
- Su sistema de producto, almacén o ERP crea y valida los identificadores. gPdf recibe los datos que deben codificarse y los renderiza.
- ¿Por qué usar códigos de barras vectoriales?
- Los módulos vectoriales evitan artefactos de escalado raster y mantienen los PDF de etiquetas más nítidos entre distintos DPI de impresora y niveles de zoom.