Incorporação e API

Um único script global ativa tanto o aviso harmonizado sobre a garantia legal como os badges GARAN automáticos. Gratuito, sem cookies, sem rastreamento, sem dependências externas e seguro: se a nossa API estiver inacessível, a sua loja nunca é afetada.

1. Instale o script (uma vez, em todo o site)

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

2. Link para o aviso de garantia legal

Adicione um link em qualquer lugar (cabeçalho, rodapé, página de produto, checkout). Ao clicar, o aviso harmonizado oficial abre numa janela modal acessível, no idioma da página (<html lang>) ou do atributo data-lang.

<a href="#garantieEu">Os seus direitos de garantia legal</a> <!-- ou com um idioma explícito --> <a href="#garantieEu" data-lang="ro">Drepturile tale privind garanția legală</a>

Também suportado: class="garan-notice-link" em qualquer elemento e inserção automática nos seletores CSS configurados na sua conta gratuita (cores, tipo de letra, fundo, contorno e ícone personalizáveis por site).

3. Badge GARAN nas páginas de produto

Pesquisa automática: fase de testes. A deteção automática ainda está em testes. O badge só aparece se uma garantia para esse produto exato estiver registada e verificada na base de dados GARAN (as suas garantias ou as etiquetas públicas); caso contrário, nada é mostrado. Verifique-o numa das suas páginas de produto antes de o usar em todo o lado, e ajude publicando as suas etiquetas no diretório público. Para um resultado previsível hoje, use o modo direto abaixo (data-years).

Coloque um elemento vazio com os dados do produto. Se existir na base de dados GARAN uma garantia comercial de durabilidade verificada, é apresentada a etiqueta aninhada; a etiqueta completa abre ao primeiro clique, passagem do rato ou toque. Se não houver garantia elegível, nada é apresentado.

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

data-identifier: o código do produto exatamente como na etiqueta: o código do modelo do produtor (ex.: WGG244Z0BY) ou o código de barras EAN.
data-country: Código ISO (RO, DE, …). Deixe vazio para garantias válidas em toda a UE.
data-mode: latest (predefinição: última versão verificada) ou pinned + data-version="3" para uma versão fixa da etiqueta.

Modo direto: indique a duração

Se não quiser uma pesquisa na base de dados, indique a duração diretamente com data-years. A etiqueta aninhada para essa duração é mostrada de imediato a partir de um SVG estático. data-brand e data-identifier são obrigatórios: são impressos na etiqueta completa que abre na interação, que deve identificar o produto.

<div class="garan-badge" data-years="5" data-brand="Bosch" data-identifier="WGG244Z0BY" data-url="https://shop.example.com/produs"></div> <!-- meios anos usam vírgula: data-years="2,5" -->

O SVG aninhado tem um URL estável (/labels/nested-5.svg, /labels/nested-2_5.svg …), é gerado uma vez e depois servido de forma estática — perfeito para CDN.

Ver a página de demonstração ↗

4. API de pesquisa

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

As respostas podem ser colocadas em cache (Cache-Control) e os SVG das etiquetas são ficheiros estáticos imutáveis servidos sem PHP — compatível com CDN.

Princípios

✔ Gratuito, sem conta necessária para o aviso e o gerador
✔ Sem cookies, sem anúncios, sem rastreamento agressivo — apenas contadores de pesquisa anónimos e agregados
✔ Etiquetas geradas exclusivamente a partir dos modelos oficiais da UE; apenas os campos permitidos são editados
✔ A etiqueta completa está sempre acessível a partir da etiqueta aninhada na primeira interação relevante