Como validar a inscrição estadual no cadastro de clientes

import { validarIE } from "validador-ie";

export function checarIE(ie, uf) {
  if (/^\s*isento\s*$/i.test(ie)) {
    return { ok: true, isento: true }; // sem número: o fiscal decide o indIEDest
  }
  const r = validarIE(ie, uf);
  if (!r.valida) {
    return { ok: false, erro: `IE inválida para ${uf}: ${r.motivo}` };
  }
  return { ok: true, ie: r.formatada, zerosCompletados: r.zerosCompletados };
}

import os
import time

import requests

API = "https://api.fiscalapi.com.br/api/consultar"
CHAVE = os.environ["FISCALAPI_KEY"]  # nunca no código-fonte


def so_digitos(texto: str) -> str:
    return "".join(c for c in texto or "" if c.isdigit()).lstrip("0")


def conferir_ie(uf: str, cnpj: str, ie: str, tentativas: int = 3) -> tuple[str, dict | None]:
    for tentativa in range(tentativas):
        resp = requests.get(
            API,
            headers={"X-API-Key": CHAVE},
            params={"uf": uf, "cnpj": cnpj},
            timeout=95,
        )
        if resp.status_code == 429:  # limite por minuto do plano
            time.sleep(int(resp.headers.get("Retry-After", "60")))
            continue
        if resp.status_code in (502, 503, 504):  # o estado não respondeu
            time.sleep(30 * (tentativa + 1))
            continue
        resp.raise_for_status()  # 400, 402, 403: repetir não resolve
        dados = resp.json()
        for inscricao in dados["results"]:
            if so_digitos(inscricao["inscricao_estadual"]) == so_digitos(ie):
                # situacao_ie: "Habilitado" ou "Não habilitado" (maiúsculas variam)
                ativa = inscricao["situacao_ie"].strip().casefold() == "habilitado"
                return ("ok" if ativa else "alerta", {**inscricao, "request_id": dados["request_id"]})
        return ("alerta", None)  # IE não encontrada para este CNPJ na UF
    return ("pendente", None)  # tente de novo mais tarde

use Illuminate\Support\Facades\Http;

$resp = Http::withHeaders(['X-API-Key' => config('services.fiscalapi.key')])
    ->timeout(95)
    ->get('https://api.fiscalapi.com.br/api/consultar', ['uf' => $uf, 'cnpj' => $cnpj]);

if ($resp->status() === 429) {
    // devolva para a fila: espere $resp->header('Retry-After') segundos
} elseif ($resp->successful()) {
    $digitos = fn ($s) => ltrim(preg_replace('/\D/', '', $s ?? ''), '0');
    $achada = collect($resp->json('results'))
        ->first(fn ($i) => $digitos($i['inscricao_estadual']) === $digitos($ie));
    $situacao = $achada['situacao_ie'] ?? 'NAO_ENCONTRADA';
    // "Habilitado" ou "Não habilitado" (maiúsculas variam)
    $ativa = mb_strtolower(trim($situacao)) === 'habilitado';
}