Logo en el código QR

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

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

Abra 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. Haga clic en Seleccionar logotipo y elija 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. Marque la casilla de confirmación y haga 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. Haga clic en Reemplazar logotipo; no es necesaria ninguna confirmación.
3. Para eliminarlo, haga clic en Eliminar logotipo, marque la casilla de advertencia (eliminarlo también cambia el patrón) y confirme 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

qr.svg y qr.png incrustan los píxeles reales del logotipo de forma centrada, escalados a una proporción fija del área del código. Ambos elevan la corrección de errores a H para que el código siga siendo escaneable. qr.pdf y qr.eps no se ven afectados por el logotipo: nunca lo incrustan y conservan el patrón que tendrían sin él.

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, qr.svg/qr.png 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 desea que el logotipo aparezca en el material impreso, vuelva a imprimir utilizando el archivo qr.svg o qr.png actual; nunca mezcle 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.
• qr.pdf y qr.eps nunca contienen un logotipo. Para plantillas de impresión que deban mostrar el logotipo, descargue qr.svg o qr.png.
• Antes de realizar una tirada de impresión completa, realice siempre un escaneo de prueba en el material real, especialmente después de un cambio de patrón.

Relacionado

• Formatos de descarga
• Archivos y hojas de datos