Logo en el código QR

Un código puede llevar un logotipo opcional en su centro: tu propia marca en lugar de un simple patrón de QR. El logotipo se incrusta como píxeles reales en las cuatro descargas: SVG, PNG, PDF y EPS.

Nota

Un logotipo eleva la corrección de errores del código al nivel H para que el patrón siga siendo escaneable incluso con la imagen parcialmente cubierta. Lo que esto significa para los códigos ya impresos se detalla más adelante en la sección Impresión.

En el Dashboard

Abre la página de detalles de un código. Junto a la vista previa del QR y los botones de descarga se encuentra la tarjeta Logo en el código QR.

1. Haz clic en Seleccionar logotipo y elige un archivo PNG, JPEG o WebP (máximo 1 MB; los formatos más grandes o diferentes, incluido SVG, se rechazarán antes de la subida).
2. Aparecerá una vista previa del archivo seleccionado junto con un aviso:
   • Aún no hay ningún logotipo – añadirlo cambiará el patrón de puntos del código. Marca la casilla de confirmación y haz clic en Subir logotipo.
   • Ya hay un logotipo configurado – al reemplazarlo solo se cambia la imagen del centro, el patrón sigue siendo el mismo. Haz clic en Reemplazar logotipo; no es necesaria ninguna confirmación.
3. Para eliminarlo, haz clic en Eliminar logotipo, marca la casilla de advertencia (eliminarlo también cambia el patrón) y confirma la eliminación por segunda vez.

Precaución

Solo un rol de escritura puede subir, reemplazar o eliminar un logotipo. El rol viewer ve el estado actual y, una vez configurado un logotipo, el aviso sobre los formatos de impresión, pero no puede realizar ninguna de las tres acciones.

Vía API

Subir o reemplazar un logotipo

POST /v1/codes/{id}/logo – Solicitud multipart, campo file.

cURL

curl -X POST https://qr3.app/v1/codes/qr_a1b2c3d4/logo \
  -H "Authorization: Bearer qr3_sk_..." \
  -F "[email protected]"

Respuesta (HTTP 201): el código actualizado, con el campo logo_file_id asignado.

El archivo se valida mediante sus Magic Bytes, no por su extensión o Content-Type. Se normaliza a un PNG transparente de 512 × 512 px (manteniendo la relación de aspecto). Si ya existe un logotipo, se reemplaza; solo puede haber un logotipo por código.

Eliminar logotipo

DELETE /v1/codes/{id}/logo – sin cuerpo.

curl -X DELETE https://qr3.app/v1/codes/qr_a1b2c3d4/logo \
  -H "Authorization: Bearer qr3_sk_..."

Respuesta (HTTP 200): el código actualizado, con logo_file_id restablecido a null. Es idempotente: una llamada sin un logotipo existente seguirá devolviendo 200 y no cambiará nada.

Errores

Estado	Cuándo
403	El rol de la clave API es viewer
404	No se encontró el código en el espacio de trabajo
413	El archivo supera 1 MB
422	Falta el campo file o es un formato distinto de PNG/JPEG/WebP (incluido SVG)

Qué cambia en el código

Los cuatro formatos – qr.svg, qr.png, qr.pdf y qr.eps – incrustan los píxeles reales del logotipo de forma centrada, escalados a una proporción fija del área del código. Los cuatro elevan la corrección de errores a H para que el código siga siendo escaneable.

Consejo

Añadir un logotipo donde antes no había ninguno, o eliminarlo por completo, cambia el patrón de puntos del código (corrección de errores M ↔ H). Por el contrario, reemplazar un logotipo existente por otra imagen no lo cambia: la corrección de errores sigue siendo H, solo cambian los píxeles incrustados y la matriz permanece idéntica.

Caché

Con un logotipo configurado, los cuatro formatos – qr.svg, qr.png, qr.pdf y qr.eps – se entregan con Cache-Control: public, max-age=300 (5 minutos) en lugar del habitual public, max-age=86400, immutable (24 horas). Por lo tanto, una URL de imagen incrustada en otro lugar – en una página, en un correo electrónico, en un documento – reflejará el cambio de logotipo en un plazo de hasta 5 minutos. Una copia que se haya almacenado en caché antes de que el código tuviera un logotipo puede tardar hasta 24 horas completas, ya que se almacenó en caché con el tiempo de vida más largo e inmutable.

Impresión

• Un código que ya ha sido impreso sigue funcionando, independientemente de si se añade, reemplaza o elimina un logotipo; el destino codificado nunca depende del logotipo.
• Añadir o eliminar un logotipo cambia el patrón de puntos. Si el propio logotipo debe aparecer en el material impreso, vuelve a imprimir con uno de los cuatro formatos actuales (qr.svg, qr.png, qr.pdf o qr.eps); nunca mezcles archivos de impresión antiguos y nuevos.
• Reemplazar un logotipo no cambia el patrón; volver a imprimir es entonces solo una cuestión de la nueva imagen deseada, no de la escaneabilidad.
• Los cuatro formatos contienen ahora el logotipo por igual; el programa de maquetación es el único que decide qué formato es el adecuado para tu propia plantilla de impresión (vectorial para PDF/EPS, ráster para PNG, SVG para ambos).
• Antes de realizar una tirada de impresión completa, realiza siempre un escaneo de prueba en el material real, especialmente después de un cambio de patrón, y nunca mezcles archivos de diferentes estados.

Relacionado

• Formatos de descarga
• Archivos y hojas de datos