API de etiquetas SSCC para PDF logísticos GS1
Renderice etiquetas con código de barras SSCC-18 en PDF para flujos de logística, pallets, cajas y almacén, mientras su sistema controla la corrección de los datos GS1.
/api/v1/pdf/render Renderizar etiquetas con código de barras SSCC-18 como salida PDF vectorial para pallets, cajas o unidades logísticas después de que su sistema haya asignado el serial shipping container code y verificado su semántica GS1.
Cuándo usar esta API
- Su sistema ya controla el valor SSCC y cualquier identificador de aplicación relacionado.
- Necesita una etiqueta PDF con un código de barras SSCC escaneable y texto legible por humanos.
- Necesita diseños repetidos de etiquetas SSCC para estaciones de impresión de almacén o 3PL.
- Quiere conectar etiquetas SSCC con flujos más amplios de etiquetas de pallet o almacén.
Qué no sustituye
- Necesita emisión de prefijos GS1, creación de dígitos de control o certificación de cumplimiento por parte de gPdf.
- Necesita gestión de inventario o estado de envío.
- Necesita compra de etiquetas de transportista o cálculo de tarifas.
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 - código de barras de etiqueta SSCC-18.
{
"pages": [
{
"size": "label_100_150",
"elements": [
{
"type": "text",
"x": 6,
"y": 8,
"content": "SSCC",
"style": { "font_size": 12, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "000123456789012345",
"x": 6,
"y": 28,
"width": 86,
"height": 30,
"barcode_text": { "enabled": true, "position": "bottom" }
}
]
}
]
}
Qué gestiona gPdf
- Renderizado vectorial de códigos de barras SSCC dentro de páginas PDF.
- Diseño de etiqueta con texto, cajas, texto del código de barras y vinculación opcional con plantillas.
- Salida PDF para impresión, almacenamiento o reimpresión de almacén.
- Envoltorio de errores compartido cuando una solicitud falla la validación.
Qué controla su sistema
- Prefijo de empresa GS1, dígito de extensión, referencia serial, dígito de control y datos codificados.
- Reglas de proceso de almacén, aceptación por escáner y validación del material de etiquetas.
- Cualquier flujo EDI, ASN, transportista o socio comercial que consuma el SSCC.
Checklist de producción
- Valide el valor SSCC y el dígito de control antes de llamar a gPdf.
- Escanee la salida con escáneres y material de etiquetas de producción.
- Documente qué eventos de almacén crean y reimprimen etiquetas SSCC.
- Use Template Render para diseños aprobados de etiquetas SSCC.
- Mantenga las comprobaciones de cumplimiento con socios comerciales fuera de la llamada de renderizado.
Límites de la promesa
- gPdf renderiza el código de barras SSCC como PDF; no emite ni certifica valores SSCC.
- El cumplimiento GS1 y de socios comerciales sigue siendo su responsabilidad.
- Las etiquetas SSCC no implican creación de envíos de transportista.
Las etiquetas SSCC son un flujo de código de barras específico
Las etiquetas SSCC son más específicas que las etiquetas generales de pallet. El dato central es el serial shipping container code. gPdf renderiza el código en un PDF; su sistema controla la asignación del código, las reglas GS1 y los requisitos de socios comerciales.
FAQ
- ¿gPdf puede crear un número SSCC?
- No. Su sistema crea y valida el valor SSCC. gPdf lo renderiza como código de barras en un PDF.
- ¿Qué formato de código de barras debo usar?
- Use un alias SSCC soportado, como sscc-18, al renderizar un elemento de código de barras SSCC.
- ¿Puede ser una plantilla?
- Sí. La mayoría de las etiquetas SSCC deberían pasar a Template Render después de aprobar el diseño y el mapeo de campos.
- ¿Esto certifica cumplimiento GS1?
- No. gPdf renderiza salida vectorial de código de barras. El cumplimiento y la aceptación por escáner son responsabilidades separadas.