# Como embutir uma calculadora de quilometragem em qualquer site

> Uma única tag <script>, quatro variantes (completa, taxa, viagem única e frota) e três idiomas.

**Autor:** Camila Ribeiro — Editora de Operações de Campo  
**Publicado:** 2026-05-02  
**Atualizado:** 2026-05-02  
**URL:** https://quilometragem.com.br/blog/embed-mileage-calculator-anywhere

**TL;DR:** Uma única tag <script>, quatro variantes (completa, taxa, viagem única e frota) e três idiomas.

- Nem todo time precisa de uma plataforma completa de despesas.
- Os atributos controlam idioma (pt, es, en), país padrão (br, mx, co, us, uk, ca`) e variante.
- - full: dois campos de endereço, seletor de país e taxa, botão calcular.
- Se seu site é uma SPA (Next.js, Nuxt, Astro com transições), use o helper exposto globalmente: `` window.QuilometragemEmbed.mount(divElement); `` A função aceita qualquer host criado dinamicamente.
- Para documentação interna, basta colar uma URL do Quilometragem em qualquer ferramenta compatível com oEmbed.

## Por que um widget embutível

Nem todo time precisa de uma plataforma completa de despesas.[^irs-2025] Blogs de RH, sites de ERP, portais de motoristas e páginas de marketing frequentemente só querem oferecer ao visitante uma calculadora rápida de quilometragem. O widget do Quilometragem entrega isso em uma tag de script, sem dependências, sem bundlers e sem chave de API exigida do parceiro.

## Como adicionar

Cole no HTML:

```
<script src="https://quilometragem.com/embed/calculator.js" defer></script>
<div data-quilometragem-calculator data-locale="pt" data-country="br" data-variant="full"></div>
```

O script monta o widget em todos os elementos com o atributo `data-quilometragem-calculator` quando o DOM estiver pronto. Os atributos controlam idioma (`pt`, `es`, `en`), país padrão (`br`, `mx`, `co`, `us`, `uk`, `ca`) e variante.

## As quatro variantes

- **full**: dois campos de endereço, seletor de país e taxa, botão calcular. Devolve distância e valor de reembolso.
- **rate**: apenas a taxa oficial vigente, útil para sidebar de blog ou página de FAQ.
- **trip**: estimador de viagem única — usuário insere distância, vê o valor em tempo real.
- **fleet**: resumo mensal — multiplica veículos × km médio × taxa.

## SPAs e mounts dinâmicos

Se seu site é uma SPA (Next.js, Nuxt, Astro com transições), use o helper exposto globalmente:

```
window.QuilometragemEmbed.mount(divElement);
```

A função aceita qualquer host criado dinamicamente. Útil dentro de routers que recriam o DOM em cada navegação.

## oEmbed para Notion, Slack e Confluence

Para documentação interna, basta colar uma URL do Quilometragem em qualquer ferramenta compatível com oEmbed. Nosso endpoint `/oembed` devolve o iframe pronto. O widget herda automaticamente o idioma e o país detectado a partir da URL original.

## E o backlink?

Cada variante renderiza um discreto "Powered by Quilometragem" com `utm_source=embed`, o que ajuda parceiros e nós ao mesmo tempo: você ganha uma calculadora robusta, nós ganhamos um link de retorno mensurável.

## Fontes

- [IRS — Standard Mileage Rates for 2025](https://www.irs.gov/tax-professionals/standard-mileage-rates) — Internal Revenue Service (2026-04-28)