Embed y API

Un único script global activa tanto el aviso armonizado de garantía legal como los badges GARAN automáticos. Gratuito, sin cookies, sin seguimiento, sin dependencias externas y seguro: si nuestra API no está disponible, su tienda nunca se ve afectada.

1. Instale el script (una vez, en todo el sitio)

<script src="https://garan.ro/embed/garan.js" defer></script>

2. Enlace al aviso de garantía legal

Añada un enlace en cualquier lugar (cabecera, pie de página, página de producto, pago). Al hacer clic, el aviso armonizado oficial se abre en una ventana modal accesible, en el idioma de la página (<html lang>) o del atributo data-lang.

<a href="#garantieEu">Sus derechos de garantía legal</a> <!-- o con un idioma explícito --> <a href="#garantieEu" data-lang="ro">Drepturile tale privind garanția legală</a>

También se admite: class="garan-notice-link" en cualquier elemento, y la inserción automática en los selectores CSS que configure en su cuenta gratuita (colores, fuente, fondo, borde e icono personalizables por sitio).

3. Badge GARAN en las páginas de producto

Consulta automática: fase de pruebas. La detección automática aún está en fase de pruebas. El badge solo aparece si una garantía para ese producto exacto está registrada y verificada en la base de datos GARAN (sus garantías o las etiquetas públicas); de lo contrario, no se muestra nada. Compruébelo en una de sus páginas de producto antes de usarlo en todas partes y ayúdenos publicando sus etiquetas en el directorio público. Para un resultado predecible hoy, use el modo directo a continuación (data-years).

Coloque un elemento vacío con los datos del producto. Si existe una garantía comercial de durabilidad verificada en la base de datos GARAN, se muestra la etiqueta anidada; la etiqueta completa se abre con el primer clic, al pasar el ratón o al tocar. Si no hay una garantía válida, no se muestra nada.

<div class="garan-badge" data-brand="Bosch" data-identifier="WGG244Z0BY" data-country="RO"></div>

data-identifier: el código del producto exactamente como en la etiqueta: el código de modelo del productor (p. ej. WGG244Z0BY) o el código de barras EAN.
data-country: Código ISO (RO, DE, …). Déjelo vacío para garantías válidas en toda la UE.
data-mode: latest (predeterminado: última versión verificada) o pinned + data-version="3" para una versión fija de la etiqueta.

Modo directo: indique usted la duración

Si no desea una consulta a la base de datos, indique la duración directamente con data-years. La etiqueta anidada para esa duración se muestra de inmediato desde un SVG estático. data-brand y data-identifier son obligatorios: se imprimen en la etiqueta completa que se abre al interactuar, la cual debe identificar el producto.

<div class="garan-badge" data-years="5" data-brand="Bosch" data-identifier="WGG244Z0BY" data-url="https://shop.example.com/produs"></div> <!-- los medios años usan coma: data-years="2,5" -->

El SVG anidado tiene una URL estable (/labels/nested-5.svg, /labels/nested-2_5.svg …) y se genera una vez y luego se sirve de forma estática: perfecto para CDN.

Ver la página de demostración ↗

4. API de consulta

GET https://garan.ro/api/embed/lookup?brand=Bosch&identifier=WGG244Z0BY&identifier_type=model&country=RO Respuesta positiva: { "found": true, "status": "source_backed", "duration_years": 5, "version": 1, "nested_svg_url": "https://garan.ro/labels/….svg", "full_svg_url": "https://garan.ro/labels/….svg", "qr_url": "https://europa.eu/youreurope/commercial-guarantee-durability/index.htm", "product_url": "https://…" } Respuesta negativa: { "found": false }

Las respuestas se pueden almacenar en caché (Cache-Control) y los SVG de las etiquetas son archivos estáticos inmutables servidos sin pasar por PHP: compatibles con CDN.

Principios

✔ Gratis, sin necesidad de cuenta para el aviso y el generador
✔ Sin cookies, sin publicidad, sin seguimiento invasivo: solo contadores de consultas anónimos y agregados
✔ Etiquetas generadas exclusivamente a partir de las plantillas oficiales de la UE; solo se editan los campos permitidos
✔ La etiqueta completa siempre es accesible desde la etiqueta anidada en la primera interacción relevante