Embed e API

Un unico script globale abilita sia l'avviso armonizzato sulla garanzia legale sia i badge GARAN automatici. Gratuito, senza cookie, senza tracciamento, senza dipendenze esterne e sicuro: se la nostra API non è raggiungibile, il Suo negozio non ne risente mai.

1. Installi lo script (una volta, su tutto il sito)

2. Link all'avviso sulla garanzia legale

Aggiunga un link ovunque (intestazione, piè di pagina, pagina prodotto, checkout). Al clic, l'avviso armonizzato ufficiale si apre in una finestra modale accessibile, nella lingua della pagina (<html lang>) o dell'attributo data-lang.

<a href="#garantieEu">I Suoi diritti di garanzia legale</a>  <a href="#garantieEu" data-lang="ro">Drepturile tale privind garanția legală</a>

Supportato anche: class="garan-notice-link" su qualsiasi elemento e l'inserimento automatico nei selettori CSS che configura nel Suo account gratuito (colori, carattere, sfondo, bordo e icona sono personalizzabili per sito).

3. Badge GARAN nelle pagine prodotto

Ricerca automatica: fase di test. Il rilevamento automatico è ancora in fase di test. Il badge appare solo se una garanzia per quel prodotto esatto è registrata e verificata nel database GARAN (le Sue garanzie o le etichette pubbliche); altrimenti non viene mostrato nulla. Lo verifichi su una delle Sue pagine prodotto prima di usarlo ovunque, e ci aiuti pubblicando le Sue etichette nell'elenco pubblico. Per un risultato prevedibile oggi, usi la modalità diretta qui sotto (data-years).

Inserisca un elemento vuoto con i dati del prodotto. Se nel database GARAN esiste una garanzia commerciale di durabilità verificata, viene mostrata l'etichetta nidificata; l'etichetta completa si apre al primo clic, passaggio del mouse o tocco. Se non esiste una garanzia idonea, non viene mostrato nulla.

data-identifier: il codice del prodotto esattamente come sull'etichetta: il codice modello del produttore (es. WGG244Z0BY) o il codice a barre EAN.
data-country: Codice ISO (RO, DE, …). Lasci vuoto per garanzie valide in tutta l'UE.
data-mode: latest (predefinito: ultima versione verificata) oppure pinned + data-version="3" per una versione fissa dell'etichetta.

Modalità diretta: indichi Lei la durata

Se non desidera una ricerca nel database, indichi la durata direttamente con data-years. L'etichetta nidificata per quella durata viene mostrata subito da un SVG statico. data-brand e data-identifier sono obbligatori: vengono stampati sull'etichetta completa che si apre all'interazione, la quale deve identificare il prodotto.

L'SVG nidificato ha un URL stabile (/labels/nested-5.svg, /labels/nested-2_5.svg …) e viene generato una volta, poi servito in modo statico — perfetto per le CDN.

Veda la pagina demo dal vivo ↗

4. API di ricerca

GET https://garan.ro/api/embed/lookup?brand=Bosch&identifier=WGG244Z0BY&identifier_type=model&country=RO Risposta 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://…" } Risposta negativa: { "found": false }

Le risposte sono memorizzabili in cache (Cache-Control) e gli SVG delle etichette sono file statici immutabili serviti senza passare da PHP — compatibili con le CDN.

Principi

✔ Gratuito, nessun account richiesto per l'avviso e il generatore
✔ Niente cookie, niente pubblicità, nessun tracciamento invasivo — solo contatori di ricerca anonimi e aggregati
✔ Etichette generate esclusivamente dai modelli ufficiali UE; vengono modificati solo i campi consentiti
✔ L'etichetta completa è sempre raggiungibile dall'etichetta nidificata alla prima interazione pertinente