Verificar Garantia no Google Sheets via API: Script Grátis

O gargalo das planilhas: superando a consulta manual de seriais

O Google Sheets é a ferramenta padrão de triagem de estoque, auditoria ITAD e precificação de computadores e notebooks recondicionados. Técnicos colam centenas de números de série ou Service Tag na coluna A e perdem horas consultando máquina por máquina nos sites oficiais.

Neste guia, transformaremos sua planilha em uma estação automatizada de auditoria. Com nosso Google Apps Script gratuito, digitar =CHECK_WARRANTY(A2, "lenovo") preenche instantaneamente o status de garantia, data de término, dias restantes e plano de suporte nas colunas vizinhas.

Passo 1: Obtenha sua chave de API REST gratuita no CheckWarranty

O CheckWarranty oferece uma REST API veloz projetada para consultas em lote em alta escala:

1. 1. Cadastro gratuito: Crie sua conta em checkwarranty.info/dashboard. Você ganha 10 consultas gratuitas imediatamente.
2. 2. Gerar API Key: Vá até a aba API Keys no painel e copie seu token de autorização.

Passo 2: Adicione o Google Apps Script na sua planilha

Abra sua planilha, clique em Extensões > Apps Script, substitua o código pelo script abaixo e salve:

/**
 * Conector de automação CheckWarranty para Google Sheets
 * @param {string} serial Número de série ou Service Tag Dell
 * @param {string} brand Fabricante opcional: "lenovo", "dell", "hp", "apple" ou "auto"
 * @return {Array} [Status, Data de Expiração, Dias Restantes, Nível de Serviço]
 * @customfunction
 */
function CHECK_WARRANTY(serial, brand) {
  if (!serial || String(serial).trim() === "") {
    return [["", "", "", ""]];
  }

  const API_KEY = "SUA_CHECKWARRANTY_API_KEY";
  const ENDPOINT = "https://api.checkwarranty.info/api/v1/scans";

  const payload = {
    serial: String(serial).trim(),
    brand: brand ? String(brand).toLowerCase().trim() : "auto"
  };

  const options = {
    method: "post",
    contentType: "application/json",
    headers: {
      "Authorization": "Bearer " + API_KEY,
      "Idempotency-Key": "gsheet_" + Utilities.getUuid()
    },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true
  };

  try {
    const response = UrlFetchApp.fetch(ENDPOINT, options);
    const code = response.getResponseCode();
    const data = JSON.parse(response.getContentText());

    if (code === 200 || code === 201) {
      const status = data.status || "verified";
      const expiration = data.warrantyEnd ? data.warrantyEnd.split("T")[0] : "—";
      const days = data.remainingDays !== undefined ? data.remainingDays : "—";
      const tier = data.entitlementTier || data.model || "Garantia Padrão";
      return [[status, expiration, days, tier]];
    } else if (code === 404) {
      return [["Não encontrado", "—", "—", "Serial inválido"]];
    } else {
      return [["Erro " + code, "—", "—", data.message || "Falha"]];
    }
  } catch (error) {
    return [["Erro de rede", "—", "—", error.message]];
  }
}

Passo 3: Execute a auditoria em lote em tempo real

Retorne à sua planilha. Na célula B2, digite a fórmula apontando para o serial da coluna A:

=CHECK_WARRANTY(A2, "auto")

A fórmula preenche automaticamente quatro colunas: Status da garantia, Data de expiração, Dias restantes e Nível de serviço (Dell ProSupport, Lenovo Premier ou HP Care Pack). Arraste para auditar até 500 seriais.

Garantia Zero-Risk: cobrança zero em erros

No CheckWarranty, os créditos são debitados somente quando dados de hardware de fábrica (BOM) são confirmados. Seriais inválidos ou erros de digitação custam rigorosamente 0 créditos.

Automatize o fluxo do seu estoque hoje mesmo

Teste a integração do Google Sheets com seu lote de notebooks e economize horas de trabalho braçal.

Testar 10 verificações grátis e auditar seu lote agora →