API de etiquetas de almacén para flujos de impresión WMS y ERP
Genere PDF de etiquetas para pallets, cajas, ubicaciones, inventario y operaciones de almacén desde datos WMS o ERP, con reimpresiones deterministas.
/api/v1/pdf/render Renderizar etiquetas de almacén desde datos WMS o ERP para pallets, cajas, ubicaciones, activos y movimientos de inventario, manteniendo el estado de inventario, las reglas de picking y las operaciones de almacén dentro del sistema que llama.
Cuándo usar esta API
- Necesita etiquetas PDF para pallets, cajas, ubicaciones, inventario o activos.
- Su WMS o ERP ya controla SKU, lote, ubicación, SSCC y datos de inventario.
- Necesita reimpresiones deterministas cuando una etiqueta se daña o una estación reintenta un trabajo.
- Quiere reutilizar diseños de etiqueta aprobados mediante Template Render.
Qué no sustituye
- Necesita que gPdf gestione inventario, asigne ubicaciones o ejecute flujos de almacén.
- Necesita que gPdf proporcione una app de escáner, agente de estación de impresión o sistema de enrutamiento de etiquetas.
- Necesita certificación GS1 en lugar de renderizado de códigos de barras.
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 datos 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" }
}
]
}
]
}
Qué gestiona gPdf
- Etiquetas PDF para flujos de impresión de almacén.
- Códigos de barras vectoriales, texto, cajas, tamaños de página para etiquetas y vinculación con plantillas.
- Salida determinista para flujos de reimpresión y auditoría.
- JSON Render para diseños personalizados y Template Render para contratos de etiqueta aprobados.
Qué controla su sistema
- Estado de inventario, datos de SKU, lote/serie, valores SSCC y semántica de ubicación.
- Enrutamiento de impresoras, configuración de estaciones, validación con escáneres y reglas de proceso de almacén.
- Selección de plantillas, reintentos y almacenamiento de PDF renderizados o datos fuente.
Checklist de producción
- Valide las dimensiones de la etiqueta contra la impresora y el material de etiquetas reales.
- Escanee todos los formatos de código de barras usados por el proceso de almacén.
- Mantenga el estado del WMS/ERP como fuente autorizada y envíe a gPdf solo datos finales de etiqueta.
- Use Template Render para etiquetas que imprimen varios sistemas o estaciones.
- Registre IDs de documentos fuente e IDs de solicitud para trazabilidad de reimpresión.
Límites de la promesa
- gPdf renderiza PDF de etiquetas de almacén; no gestiona inventario ni estado de almacén.
- El sistema que llama conserva la semántica de los datos del código de barras y la aceptación por escáner.
- Template Render puede estabilizar diseños de etiqueta, pero no sustituye las reglas del WMS.
Las etiquetas de almacén son registros operativos
Las etiquetas de almacén identifican pallets, cajas, ubicaciones, activos, movimientos de inventario y localizaciones. Están vinculadas al estado operativo de su WMS o ERP. gPdf debe recibir los datos finales de la etiqueta y renderizarlos; no debe decidir el significado del inventario ni el estado del proceso de almacén.
Template Render simplifica las estaciones de impresión
Para etiquetas usadas en varias estaciones, publique el diseño aprobado como
plantilla. Los servicios de impresión pueden enviar template_id más datos del
WMS en lugar de reconstruir coordenadas en cada cliente.
Determinismo en reimpresiones
Los almacenes reimprimen etiquetas. Una etiqueta dañada, una impresora atascada o un reintento de estación no deberían crear un documento ligeramente distinto. Mantenga los datos fuente de la etiqueta vinculados al registro de almacén y use entradas de renderizado deterministas para las reimpresiones.
FAQ
- ¿gPdf gestiona inventario de almacén?
- No. Su WMS o ERP controla estado de inventario, ubicaciones, SKU, lotes y reglas de proceso. gPdf renderiza el PDF de la etiqueta desde datos finales.
- ¿Las etiquetas de almacén pueden usar códigos GS1 o SSCC?
- Sí, gPdf puede renderizar formatos de código de barras soportados en la salida PDF. Su sistema conserva la responsabilidad sobre los datos del código de barras y la aceptación por escáner.
- ¿Las etiquetas de almacén repetidas deberían usar plantillas?
- Normalmente sí. Template Render ofrece a las estaciones de impresión un `template_id` y un contrato de datos estable después de aprobar el diseño de la etiqueta.
- ¿Cómo deberían funcionar las reimpresiones?
- Guarde los datos fuente de la etiqueta o el PDF generado con el registro de almacén, y después renderice o recupere la misma etiqueta usando los IDs operativos originales.