Un código de barras que se imprime con nitidez en la impresora de oficina y se escanea bien en las pruebas internas puede fallar en la impresora térmica de un 3PL a 8.000 km, y ese modo de fallo no aparecerá en ningún entorno de test. El bug no aparece en CI, no falla en QA dentro de Adobe Acrobat y se ve impecable en un monitor 4K. Silenciosamente puede costar a equipos de cadena de suministro 0,25 USD por unidad en reetiquetado de Amazon FBA inbound, 5-10 USD por caja no conforme en Walmart y, en ocasiones, pallets completos rechazados en el muelle de recepción. El bug es que el código de barras dentro del PDF es una imagen de un código de barras, no instrucciones reales para dibujarlo. Cuando esa imagen se redimensiona a través de la cadena de impresión, las barras dejan de tener la precisión que necesita un escáner.

Este artículo tiene tres públicos. Cualquier persona puede leer la primera sección y entender qué está en juego y qué debe preguntar a su proveedor de PDF. Responsables de QA y operaciones querrán la segunda sección, sobre cómo se desploma la calificación de calidad de impresión. Ingeniería querrá la tercera, sobre qué hay realmente dentro del PDF y cómo verificar cualquier archivo en tres minutos. Cada capa termina con una conclusión clara, así que puede detenerse cuando ya tenga lo que necesita.

En una tabla

Pregunta	Si el código de barras son instrucciones de dibujo (vector)	Si el código de barras es una imagen (PNG raster)
Tamaño en el PDF	~1 KB	~50-300 KB
Sobrevive a redimensionados para cualquier impresora	Sí: la impresora redibuja desde geometría	No: cada redimensionado pierde nitidez
Calificación ISO 15416 de calidad de impresión	Se mantiene en A	Cae de A a C/D en producción
Riesgo de cargo por incumplimiento Walmart SSCC-18	Bajo	Alto
Reetiquetado Amazon FBA de 0,25 USD por unidad	Raro	Habitual con plantillas malas
Esfuerzo para cambiar	Elegir un renderizador que emita paths de PDF	Proyecto de ingeniería

Si su equipo está evaluando un servicio de generación de PDF para cualquier flujo que termina en un escaneo, la pregunta más diagnóstica es la fila sobre la que se construye esta tabla: ¿produce instrucciones de dibujo o una imagen? El resto del artículo es la versión larga de esa pregunta.

Para todos: qué ocurre realmente y cuánto cuesta

Historia 1: el pallet de Walmart que nadie podía leer

Un product manager de un proveedor aprueba una nueva plantilla de etiqueta de envío. Se ve muy bien en Adobe Acrobat. Imprime bien en la impresora de oficina. La primera carga — cincuenta pallets, doscientas cajas — sale hacia un centro de distribución de Walmart.

En el muelle de recepción, el equipo de descarga contratado escanea el SSCC-18 de cada pallet: el número de serie de 18 dígitos que identifica de forma única ese pallet físico. Tres pallets de cincuenta no se leen en el primer ni en el segundo intento. El equipo escala al responsable de recepción. El responsable abre el EDI 856 ASN, el manifiesto electrónico que el proveedor envió por adelantado con todos los SSCC que deberían estar en esa carga. El WMS puede ver que tres SSCC del manifiesto están físicamente presentes, pero son ilegibles. Eso es una discrepancia.

Lo que sigue no es dramático; es procedimental. Un EDI 824 application advice vuelve al proveedor marcando la carga. Recepción tiene que teclear manualmente los SSCC ilegibles a partir del texto legible bajo el código de barras. La carga pierde su ventana de recepción. Un chargeback de cumplimiento por “labelling violation” llega a la cuenta del proveedor: en 2026, la mayoría de grandes minoristas cobra 5-10 USD por caja no conforme, a veces por pallet. Para esta carga son 30-60 USD de coste directo: un redondeo.

El coste real viene después. Las infracciones repetidas de etiquetado mueven al proveedor a estado de revisión por compras, lo que ralentiza futuros pedidos de compra con auditorías de cumplimiento más estrictas y lo empuja a niveles de enrutamiento menos favorables. Unos pocos pallets malos por trimestre no disparan esto; un problema sistemático causado por una pila PDF mal configurada sí, porque la misma plantilla sale en cada carga.

El posmortem técnico de ese proveedor suele tardar semanas porque nadie en el equipo piensa que “el código de barras dentro del PDF” tenga una estructura interna significativa. Lo ven simplemente como el código de barras. El hallazgo — que el PDF contenía un bitmap PNG de 300 dpi, que la impresora térmica del centro de distribución tuvo que remuestrear a 203 dpi, emborronando el ancho de las barras fuera de tolerancia — suele llegar solo cuando el primer resumen de chargebacks obliga a investigar más a fondo.

Historia 2: el envío de Amazon FBA con chargeback de goteo lento

Este caso es más silencioso, más grande y más difícil de detectar.

Un vendedor Fulfilled-by-Amazon envía 50.000 unidades de un SKU a FBA inbound. Cada unidad lleva una etiqueta con un FNSKU — el identificador por SKU de Amazon — impreso como código de barras. En una plantilla mala típica, entre el 2% y el 5% de las unidades llegan con códigos de barras no escaneables al almacén FBA: las barras están demasiado emborronadas para que el escaneo inbound las lea al primer intento. Amazon no rechaza el envío. Envía las unidades afectadas a reetiquetado manual y cobra al vendedor una tarifa fija por reetiqueta. En 2026, esa tarifa es 0,25 USD por unidad.

Para un envío de 50.000 unidades con una tasa de fallo del 5%, son 625 USD de chargebacks directos. Para un vendedor que repite esto cada mes, son 7.500 USD/año de desperdicio puro, y eso solo es la línea explícita de chargeback. El coste oculto mayor: las unidades reetiquetadas tardan más en recibirse en FBA, no quedan disponibles para la Buy Box, el tráfico promocional pierde tracción y los ingresos caen justo en el peor momento del ciclo de lanzamiento.

Los vendedores suelen descubrirlo solo cuando investigan el informe FBA inbound defect & reimbursement en Amazon Seller Central. Hasta entonces, esa línea se descarta como “cosas raras de Amazon”. La causa real — un generador de códigos de barras que emite un PNG de 300 dpi en lugar de un código vectorial — está meses antes en la cadena y rara vez se conecta con el informe de chargebacks salvo por alguien que ya haya hecho esa investigación.

Historia 3: la línea de excepción en UPS / FedEx

El tercer caso no tiene un chargeback directo, y precisamente por eso es el más invisible.

Cuando un paquete llega a una instalación de clasificación de UPS o FedEx, el escáner de la cinta lee el código de seguimiento en milisegundos. Si la lectura falla — barras fuera de tolerancia, zona silenciosa recortada, grado de modulación D — el paquete no se rechaza. Se saca de la cinta principal y se envía a la línea de gestión de excepciones, donde una persona teclea el número de seguimiento desde el texto legible. El paquete vuelve a entrar en la red con un retraso de 12-24 horas.

Los transportistas no suelen cobrar esto directamente. El coste aparece en otro lugar:

suben los tickets de soporte con “ustedes dijeron que ya salió, ¿dónde está?”;
baja el NPS de envíos que realmente salieron a tiempo, pero pasaron por gestión manual;
las auditorías de cuenta del transportista acaban marcando al proveedor como riesgo de etiquetado. Las futuras recogidas se revisan más, las renovaciones de contrato se vuelven más duras y la negociación de tarifas empeora.

Un paquete malo no cuesta nada medible. Diez mil paquetes malos al mes durante un año cuestan una relación.

El hilo común en las tres historias

En todas las historias, el bug no está en los datos, el diseño, la impresora ni el escáner. Está en una decisión aguas arriba: el código de barras llegó a la impresora como una imagen, no como instrucciones de dibujo. Las imágenes no sobreviven bien al redimensionado para impresoras desconocidas. Las instrucciones de dibujo sí.

Por qué es tan común

La parte difícil no es producir un código de barras vectorial de forma aislada: las bibliotecas modernas pueden emitir SVG preciso. La parte difícil es incrustar ese código vectorial dentro de un PDF como operadores path nativos de PDF, en lugar de como imagen incrustada. Traducir paths SVG a operadores path de PDF exige que el generador PDF y el motor de códigos de barras estén diseñados juntos. El atajo — llamar a una biblioteca de códigos de barras, tomar su salida PNG e incrustar el PNG como un Image XObject — es muchísimo más fácil de conectar en un framework. Por eso muchas pilas PDF lo hacen. Desde la perspectiva del almacén, ese atajo arquitectónico es lo que llega a la impresora térmica y genera el cargo por incumplimiento.

Esa es la conclusión para lectores no técnicos. Si deja de leer aquí, ya tiene suficiente para hacer la pregunta correcta a cualquier proveedor de PDF y pedir a ingeniería que ejecute la verificación de tres minutos al final del artículo.

Para QA y operaciones: cómo cae realmente la calificación

Los estándares que su escáner de almacén ya usa

Dos estándares ISO definen qué significa “buen código de barras” en un muelle de recepción:

ISO/IEC 15416: para códigos lineales 1D (Code 128, GS1-128, ITF-14, EAN, UPC).
ISO/IEC 15415: para códigos matriciales 2D (QR, DataMatrix, PDF417, Aztec).

Un verificador de laboratorio mide siete parámetros en el símbolo impreso y reporta una calificación global de A (4.0) a F (0.0). La escala ANSI es lo mismo con letras distintas. Los manuales de proveedores de Walmart, Amazon, Target, Costco y los principales transportistas hacen referencia a estos estándares y normalmente exigen grado C o mejor. Por debajo de C se trata como fuera de especificación; por debajo de D se activa la maquinaria de chargebacks descrita arriba.

Los siete parámetros y cómo los daña un código de barras raster:

Parámetro	Qué comprueba el verificador	Por qué lo daña un PNG raster
Decodabilidad	¿El ancho de las barras está dentro de tolerancia?	El remuestreo desplaza anchos fuera de especificación; suele ser el primer parámetro que cae
Contraste de borde	¿Las transiciones barra/espacio son nítidas?	El antialiasing durante el redimensionado crea píxeles grises de transición
Modulación	¿El contraste claro/oscuro es uniforme en todo el símbolo?	El dithering del driver de impresión convierte barras sólidas en patrones de puntos
Defectos	¿Hay motas o vacíos espurios?	Los artefactos de remuestreo se convierten en puntos reales de tinta en la etiqueta
Reflectancia mínima	¿Las barras son suficientemente oscuras?	El remuestreo puede dejar vacíos internos en barras estrechas
Contraste del símbolo	¿El contraste global barra/fondo es suficiente?	La compresión PDF con pérdida aplana el contraste
Zona silenciosa	¿El margen blanco requerido alrededor del símbolo está presente?	Las herramientas de recorte automático lo invaden

Un código de barras vectorial mantiene cada parámetro cerca de A porque no hay una rejilla de píxeles origen que remuestrear. Un código raster suele perder medio grado por parámetro; acumule cinco o seis pérdidas y la media termina en C o D. Los datos son idénticos. La codificación es idéntica. El código se ve idéntico en pantalla. Solo difiere el símbolo impreso, y el verificador — igual que el escáner del almacén — mide el símbolo impreso, no lo que QA ve en Acrobat.

Por qué las impresoras agravan el daño

Un PNG raster incrustado en un PDF atraviesa seis etapas de remuestreo entre “hacer clic en Imprimir” y “la etiqueta sale de la impresora”. Cada una cuesta aproximadamente medio grado.

El visor rasteriza para pantalla. Acrobat o el lector PDF interpola el PNG origen sobre la rejilla de píxeles del monitor. Se ve bien; eso engaña a QA.
El driver de impresión rasteriza para papel. El driver elige interpolación bilineal o bicúbica para encajar los píxeles origen en la rejilla de la impresora. El contraste de borde cae.
Conversión de color. Las cadenas que pasan por CMYK o escala de grises aplican otro remuestreo, a menudo combinado con dithering de semitono. La modulación cae.
“Ajustar al área imprimible”. Muchos drivers escalan la página por defecto al 99% para evitar recorte en el borde. La decodabilidad se desplaza una fracción de grado.
Aplanado PDF/A. La conversión a PDF de archivo a menudo rerasteriza cualquier región con transparencia. Se pierde otro medio grado.
Emborronado del cabezal térmico. La cinta y los soportes térmicos directos se emborronan 2-4 mil (milésimas de pulgada) con calor. Los renderizadores vectoriales pueden compensar; las fuentes raster no.

Acumule los costes y un código de barras que salió del renderizador con grado A llega al escáner con grado C-D. Esa es la aritmética operativa. Los operadores path vectoriales saltan por completo las etapas 2-4, porque no hay rejilla de píxeles origen que remuestrear: el rasterizador de la propia impresora calcula las barras a su DPI nativo desde una especificación matemática.

Si lidera QA y deja de leer aquí, la acción es alquilar un verificador ISO 15416 durante una semana (1.000-2.000 USD/semana; proveedores como Cognex, Keyence o REA VeriCube). Tome cincuenta etiquetas de producción de su flujo retail de mayor volumen. Si la calificación media está por debajo de B, tiene un problema de códigos de barras raster.

Para ingeniería: qué hay realmente dentro del PDF

Dos formas de poner un código de barras en una página

PDF define exactamente dos tipos de objeto visible:

Un path: una lista de operadores de dibujo (re rectángulo, f rellenar, m/l mover/línea, S trazo) en coordenadas de punto flotante. El rasterizador de la impresora evalúa estos operadores a la resolución nativa del dispositivo.
Un Image XObject: un bitmap incrustado con ancho/alto en píxeles, codificado como PNG, JPEG o stream crudo. El renderizador debe mapear la rejilla de píxeles origen a la rejilla de píxeles del dispositivo, lo que siempre requiere remuestreo.

Un Code 128 vectorial con 60 barras produce alrededor de 60 pares re/f en el flujo de contenido: menos de 1 KB en total. Las coordenadas flotantes son precisas hasta 0,001 mm. Un Code 128 raster produce un único operador Do /Im0 que apunta a un PNG incrustado, normalmente de 270 KB a 300 dpi.

% Vector — what the renderer should produce
0 0 0.40 22 re f       % bar 1: 0.40mm wide, 22mm tall
0.99 0 0.40 22 re f    % bar 2 ...
1.97 0 0.40 22 re f    % ~60 lines like this, ~1 KB total

% Raster — what most stacks actually produce
348 0 0 84 0 0 cm      % scale a 348×84 pixel image to 92mm × 22mm
/Im0 Do                % insert the embedded PNG (~270 KB)

Vector conserva la especificación original hasta llegar a la impresora. Raster congela las barras al DPI de origen y obliga a cada impresora posterior a adivinar.

Verificar cualquier PDF en 3 minutos

Tres comprobaciones, sin herramientas especiales más allá de poppler-utils y qpdf, gratuitas en Linux, Mac y WSL:

1. Haga zoom al 800%. Los códigos de barras vectoriales siguen nítidos a cualquier zoom. Los raster se pixelan de forma evidente: puede contar los píxeles de origen. Es la comprobación informal más rápida.

2. Liste las imágenes incrustadas:

$ pdfimages -list shipping-label.pdf
page  num  type    width  height color comp bpc enc      object  x-ppi  size
─────────────────────────────────────────────────────────────────────────────
   1    0  image     348      84  gray    1   1 ccitt     8 0     300   270K

Si aparece una fila que coincide con la proporción de su código de barras — por ejemplo, 348 × 84 para un código 1D ancho o un cuadrado para un 2D — el código de barras es una imagen raster. Los códigos vectoriales no aparecen en esta salida.

3. Inspeccione el flujo de contenido:

$ qpdf --qdf shipping-label.pdf - | grep -A2 -B2 ' re$'

Un Code 128 vectorial con 60 barras produce un bloque denso de operadores re/f. Si ve un único operador Do /Im0 y no hay rectángulos cercanos donde debería estar el código de barras, es una imagen raster.

Un verificador profesional (Cognex, Keyence, REA VeriCube) cuesta más de 5.000 USD y produce el informe formal ISO 15416. La mayoría de equipos no llega ahí hasta que un chargeback ya disparó la investigación; las tres comprobaciones anteriores le dicen gratis de qué lado del problema está.

Qué hace gPdf

El renderizado de códigos de barras de gPdf viene de xBarcode, un producto hermano construido por el mismo equipo. xBarcode es un motor de códigos de barras en Rust — completamente desarrollado por nosotros, no un envoltorio de una biblioteca de terceros — al que el renderizador de gPdf llama directamente. Para simbologías matriciales y lineales — Code 128, GS1-128, QR, Data Matrix, PDF417, Aztec, ITF, EAN, UPC y la mayoría de los más de 30 formatos soportados — xBarcode calcula el patrón de barras o celdas y gPdf lo emite dentro del flujo de contenido del PDF como operadores rectangulares re/f con coordenadas flotantes. Sin PNG intermedio, sin DPI de origen, sin superficie raster.

Dos consecuencias importantes:

El motor es verificable públicamente. xBarcode también funciona como herramienta gratuita independiente en xbarcode.ai. Cualquier persona puede pegar datos, descargar SVG / PNG / EPS e inspeccionar la salida de paths antes de creer cualquier afirmación sobre lo que produce gPdf. Esa salida vectorial es lo que llega a sus PDF de gPdf. Es la prueba de credibilidad que muchas afirmaciones de “emitimos códigos de barras vectoriales” no superan.
El rendimiento se puede medir. xBarcode genera un código 1D estándar en ~4 µs en un solo núcleo (v1.5.4); las pruebas de rendimiento publicadas lo sitúan 6× más rápido que fast_qr y 30× más rápido que rxing. De extremo a extremo a través del entorno de ejecución de Cloudflare Workers de gPdf, eso se traduce en ~30 ms p50 a escala mundial.

Más allá de la salida vectorial, xBarcode gestiona la capa GS1 que la mayoría de bibliotecas de terceros omite: un registro de más de 750 identificadores de aplicación (AI) con modos de validación estricto / flexible, inserción automática del separador FNC1 y comprobaciones de longitud y conjunto de caracteres por AI. Su cadena (01)09504000059101(17)260315 se valida contra la especificación antes de codificar, no después de un cargo por incumplimiento.

PDF/A-1b a 4 son compatibles por construcción; no hace falta una pasada de aplanado. El determinismo es exacto: el mismo DocumentRequest produce flujos de contenido idénticos byte a byte entre isolates y versiones.

Cuándo un raster puede seguir siendo aceptable

Dos casos reales:

Documentos solo internos que no necesitan escanearse de forma fiable. Raster no importa, aunque tampoco ahorra nada porque vector también es gratuito.
Un logotipo fotográfico con el código de barras bloqueado dentro del arte por razones de marketing. La fiabilidad de escaneo se convierte en deuda técnica consciente, no en un descuido.

Para todo lo demás — etiquetas de envío, etiquetas FNSKU, recibos de nómina, códigos de barras de líneas de factura, PDF de cupones, códigos QR de entradas, etiquetas retail de artículos comerciales y serialización farmacéutica — vector es la única opción que no envía una apuesta sobre la cadena de impresión aguas abajo.

Conclusión

Cuando elige una pila PDF para cualquier flujo que termina en un escaneo, la pregunta no es “¿soporta QR / Code 128 / GS1-128?”. La pregunta es:

Cuando pido un código de barras, ¿el resultado son instrucciones de dibujo o una imagen incrustada?

Si la respuesta es imagen, su tasa de fallos de escaneo tiene un suelo que ninguna calibración de dimensión X, cuidado con sustitución de fuentes o mantenimiento de impresora puede bajar. Los chargebacks de Walmart, los cargos de 0,25 USD de Amazon, los retrasos de excepciones en transportistas: no son problemas del proveedor ni del almacén. Son una propiedad de los bytes que salen de su renderizador.

La acción más barata hoy es ejecutar pdfimages -list contra sus últimos 100 PDF de etiquetas salientes. Cuente las filas que vuelven con un objeto de imagen con forma de código de barras. Trate ese número como el tamaño de una auditoría de cumplimiento no anunciada que espera ocurrir.

Ver también

xBarcode: el motor por separado — el renderizado de códigos de barras de gPdf está impulsado por xBarcode, un motor hermano en Rust que funciona como herramienta gratuita independiente. Pegue datos, descargue el SVG e inspeccione el path. Mismo motor, misma salida que se escribe en sus PDF de gPdf.
Códigos de barras GS1-128 con precisión de 0,1 mm en JSON — la historia de la dimensión X que viene después de eliminar el modo de fallo raster.
Archivos PDF de etiquetas de envío a escala de transportista — forma concreta de solicitud para una etiqueta térmica 4×6 con un Code 128 de seguimiento de transportista.
Referencia completa de códigos de barras — todas las simbologías soportadas, campos de tamaño y el bloque barcode_text para la línea legible por humanos.