API de etiquetas de pallet para flujos de almacén y 3PL
Genere PDF de etiquetas de pallet para flujos de almacén, 3PL, retail y logística con SSCC, GS1-128, bloques de texto y plantillas seguras para reimpresión.
/api/v1/pdf/render Renderizar PDF de etiquetas de pallet desde datos WMS, ERP o 3PL para que los equipos de almacén puedan identificar pallets, escanear códigos SSCC o GS1 y reimprimir la misma etiqueta durante recepción, expedición o movimientos de inventario.
Cuándo usar esta API
- Su WMS ya tiene el ID de pallet, datos SKU o GTIN, cantidad, lote y destino.
- Necesita una etiqueta PDF con SSCC, GS1-128 u otros formatos de código de barras soportados.
- Quiere reimpresiones deterministas desde los mismos datos fuente.
- Necesita que el diseño se convierta en un contrato estable de Template Render.
Qué no sustituye
- Necesita que gPdf gestione inventario, palletización o tareas de almacén.
- Necesita certificación GS1 en lugar de renderizado de códigos de barras en PDF.
- Necesita salida directa en comandos de impresora.
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 - etiqueta de pallet con código de barras SSCC.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 5,
"y": 7,
"content": "PALLET 12 / DOCK B",
"style": { "font_size": 13, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "000123456789012345",
"x": 5,
"y": 28,
"width": 92,
"height": 30,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 5,
"y": 78,
"content": "GTIN 09506000134352\nQTY 48 CASES\nLOT L-2026-05",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Qué gestiona gPdf
- Páginas PDF con tamaño de etiqueta, texto, cajas y elementos de código de barras.
- SSCC, GS1-128, Code 128, QR y otros formatos de código de barras soportados en salida PDF.
- Vinculación con plantillas para diseños aprobados de etiquetas de pallet.
- Salida determinista para reimpresiones y evidencia de auditoría.
Qué controla su sistema
- Identidad del pallet, datos de producto, datos de lote, cantidad, enrutamiento y reglas de almacén.
- Corrección de los datos del código de barras, dígitos de control, pruebas de escáner y validación del material de etiquetas.
- Enrutamiento de estaciones de impresión, autorización de reimpresión y estado de inventario.
Checklist de producción
- Valide los datos SSCC o GS1 antes de renderizar.
- Escanee etiquetas con escáneres de producción en estaciones de recepción y expedición.
- Pruebe datos densos, nombres de producto largos y necesidades de varios idiomas de almacén.
- Registre `template_id`, ID de pallet fuente e ID de solicitud para reimpresiones.
- Mantenga las transiciones de estado de almacén fuera de la API de renderizado.
Límites de la promesa
- gPdf renderiza PDF de etiquetas de pallet; no gestiona pallets ni inventario de almacén.
- gPdf no es un organismo de certificación GS1.
- La aceptación por escáner y la corrección del proceso de almacén siguen siendo su responsabilidad.
Las etiquetas de pallet conectan datos WMS con la salida impresa
El flujo de etiquetas de pallet empieza en su WMS o ERP. Ese sistema decide qué pallet, producto, cantidad, lote y ruta deben aparecer en la etiqueta. gPdf convierte esos datos en un PDF que las estaciones de impresión del almacén pueden emitir y reimprimir.
Use la página más específica de SSCC cuando la intención de búsqueda sea concretamente SSCC-18 o etiquetado logístico GS1. Use esta página para el flujo más amplio de etiquetas de pallet.
FAQ
- ¿gPdf puede generar etiquetas de pallet SSCC?
- gPdf puede renderizar elementos de código de barras SSCC en la salida PDF. Su sistema conserva la responsabilidad sobre el valor SSCC y la semántica GS1.
- ¿gPdf gestiona inventario de pallets?
- No. Los sistemas WMS o ERP controlan el estado de inventario. gPdf renderiza el PDF de la etiqueta.
- ¿Las etiquetas de pallet pueden usar Template Render?
- Sí. Template Render suele ser la ruta de producción después de aprobar el diseño de la etiqueta de pallet.
- ¿gPdf certifica etiquetas GS1?
- No. gPdf renderiza códigos de barras vectoriales en PDF. La certificación, las pruebas de escaneo y la aceptación siguen siendo su responsabilidad.