Como consultar inscrição estadual no Google Sheets?

// FiscalAPI: consulta de inscrição estadual pelo menu, gravando valores.
const ABA = 'Documentos';
const PRIMEIRA_LINHA = 2; // linha 1 é o cabeçalho
// Pausa entre chamadas, pelo limite por minuto do plano:
// 12000 no Lite e sem plano, 3000 no Starter, 1000 no Pro, 500 no Enterprise.
const PAUSA_MS = 3000;
// Para bem antes do limite de 6 min por execução: uma consulta já cobrada
// precisa ter tempo de ser gravada.
const TEMPO_MAX_MS = 3 * 60 * 1000;
const CACHE_SEGUNDOS = 21600; // 6 horas, o máximo do CacheService

function onOpen() {
  SpreadsheetApp.getUi()
    .createMenu('FiscalAPI')
    .addItem('Consultar IE das linhas pendentes', 'consultarPendentes')
    .addToUi();
}

function consultarPendentes() {
  const ui = SpreadsheetApp.getUi();
  const chave = PropertiesService.getScriptProperties().getProperty('FISCALAPI_KEY');
  if (!chave) {
    ui.alert('Cadastre FISCALAPI_KEY em Configurações do projeto > Propriedades do script.');
    return;
  }
  const aba = SpreadsheetApp.getActive().getSheetByName(ABA);
  const ultima = aba.getLastRow();
  if (ultima < PRIMEIRA_LINHA) return;

  const linhas = aba.getRange(PRIMEIRA_LINHA, 1, ultima - PRIMEIRA_LINHA + 1, 2).getValues();
  const cache = CacheService.getDocumentCache();
  const inicio = Date.now();
  let feitas = 0;

  for (let i = 0; i < linhas.length; i++) {
    // Mantém as letras: desde julho de 2026 o CNPJ pode ser alfanumérico.
    const cnpj = String(linhas[i][0]).replace(/[^0-9A-Za-z]/g, '').toUpperCase();
    const status = linhas[i][1];
    if (!cnpj || status) continue; // linha vazia ou já consultada

    if (Date.now() - inicio > TEMPO_MAX_MS) {
      ui.alert('Parei por tempo depois de ' + feitas + ' linhas. Clique no menu de novo para continuar.');
      return;
    }

    const linha = PRIMEIRA_LINHA + i;
    if (!cnpjValido(cnpj)) {
      // CNPJ com dígito errado seria consultado e cobrado: não chama a API.
      aba.getRange(linha, 2, 1, 4).setValues([['CNPJ inválido (não consultado)', '', '', new Date()]]);
      continue;
    }

    const guardado = cache.get(cnpj);
    if (guardado !== null) {
      gravar(aba, linha, 200, guardado); // mesmo CNPJ consultado há pouco: não chama a API
      continue;
    }

    const resposta = chamarApi(chave, cnpj, inicio);
    gravar(aba, linha, resposta.codigo, resposta.texto);
    SpreadsheetApp.flush();
    if (resposta.codigo === 402) {
      ui.alert('Acabaram as consultas do mês e não há saldo de recarga. Parei aqui.');
      return;
    }
    if (resposta.codigo === 403) {
      ui.alert('A chave foi recusada (inválida ou revogada). Confira FISCALAPI_KEY.');
      return;
    }
    if (resposta.codigo === 200) {
      try {
        cache.put(cnpj, resposta.texto, CACHE_SEGUNDOS);
      } catch (e) {} // resposta grande demais para o cache: só não guarda
    }
    feitas++;
    Utilities.sleep(PAUSA_MS);
  }
  ui.alert('Pronto: ' + feitas + ' consulta(s) feita(s).');
}

function chamarApi(chave, cnpj, inicio) {
  const url = 'https://api.fiscalapi.com.br/api/consultar-ie-todos?cnpj=' + encodeURIComponent(cnpj);
  for (let tentativa = 1; ; tentativa++) {
    let r;
    try {
      r = UrlFetchApp.fetch(url, {
        method: 'get',
        headers: { 'X-API-Key': chave },
        muteHttpExceptions: true, // devolve 4xx/5xx em vez de interromper o script
      });
    } catch (e) {
      return { codigo: 0, texto: '' }; // falha de rede ou tempo esgotado
    }
    const codigo = r.getResponseCode();
    if (codigo !== 429) return { codigo: codigo, texto: r.getContentText() };
    // Passou do limite por minuto: espera o Retry-After, no máximo 2 vezes e só se der tempo.
    const espera = segundosDeEspera(r) * 1000;
    if (tentativa > 2 || Date.now() - inicio + espera > TEMPO_MAX_MS) {
      return { codigo: 429, texto: '' };
    }
    Utilities.sleep(espera);
  }
}

function segundosDeEspera(resposta) {
  const headers = resposta.getHeaders();
  for (const nome in headers) {
    if (nome.toLowerCase() === 'retry-after') return Math.min(Number(headers[nome]) || 60, 60);
  }
  return 60;
}

// Dígitos verificadores, também do CNPJ alfanumérico.
function cnpjValido(cnpj) {
  if (!/^[0-9A-Z]{12}[0-9]{2}$/.test(cnpj) || /^(.)\1+$/.test(cnpj)) return false;
  const v = cnpj.split('').map(function (c) { return c.charCodeAt(0) - 48; });
  for (const n of [12, 13]) {
    let soma = 0;
    for (let i = 0; i < n; i++) soma += v[i] * (((n - 1 - i) % 8) + 2);
    const resto = soma % 11;
    if (v[n] !== (resto < 2 ? 0 : 11 - resto)) return false;
  }
  return true;
}

function gravar(aba, linha, codigo, texto) {
  let status;
  let inscricoes = '';
  let completo = '';
  if (codigo === 200) {
    const json = JSON.parse(texto);
    const lista = [];
    json.results.forEach(function (estado) {
      estado.results.forEach(function (ie) {
        lista.push(estado.uf + ': ' + ie.inscricao_estadual + ' (' + ie.situacao_ie + ')');
      });
    });
    status = 'OK';
    inscricoes = lista.length ? lista.join('; ') : 'nenhuma IE encontrada';
    completo = json.complete ? 'sim' : 'não: algum estado não respondeu';
  } else {
    let mensagem = '';
    try {
      const erro = JSON.parse(texto);
      mensagem = erro.message || erro.detail || '';
    } catch (e) {}
    status = (codigo === 0 ? 'Falha de conexão' : 'Erro ' + codigo) + (mensagem ? ': ' + mensagem : '');
  }
  aba.getRange(linha, 2, 1, 4).setValues([[status, inscricoes, completo, new Date()]]);
}