Onboarding de comprador no marketplace B2B: CNPJ e inscrição estadual

CNPJ válido? ──não──> recusa no formulário
     │sim
     ├── Receita: ATIVA? ──não──> bloquear
     └── Estado: IE na UF?
            ├── nenhuma ─────────────────> fiscal decide (sem IE)
            ├── vedada ou bloqueada ─────> bloquear
            ├── nenhuma Habilitado ──────> bloquear até regularizar
            └── Habilitado, sem restrição > liberar como contribuinte

const BASE = "https://api.fiscalapi.com.br/api";
const CHAVE = process.env.FISCALAPI_KEY ?? "";

type Decisao =
  | { acao: "liberar"; ie: string }
  | { acao: "fiscal_decide" | "bloquear" | "pendente"; motivo: string };

interface Inscricao {
  inscricao_estadual: string;
  situacao_ie: string;
  situacao_contribuinte: string;
}

async function consultar(rota: string, params: Record<string, string>) {
  const resp = await fetch(`${BASE}/${rota}?${new URLSearchParams(params)}`, {
    headers: { "X-API-Key": CHAVE },
    signal: AbortSignal.timeout(100_000),
  });
  return { status: resp.status, corpo: resp.ok ? await resp.json() : null };
}

const norm = (s: string | undefined) => (s ?? "").trim().toLowerCase();

export async function avaliarComprador(cnpj: string, uf: string): Promise<Decisao> {
  const [rf, sefaz] = await Promise.all([
    consultar("consultar-cnpj", { cnpj }),
    consultar("consultar", { uf, cnpj }),
  ]);

  if (rf.status === 404) return { acao: "bloquear", motivo: "CNPJ não encontrado na Receita" };
  if (rf.status !== 200 || sefaz.status !== 200 || rf.corpo.source_status.status !== "success") {
    // 429: espere o Retry-After. 5xx: o órgão não respondeu. 402 e 403: veja a conta e a chave.
    return { acao: "pendente", motivo: `HTTP ${rf.status} / ${sefaz.status}` };
  }

  const situacaoRf: string = rf.corpo.result.situacao_cadastral;
  if (norm(situacaoRf) !== "ativa") return { acao: "bloquear", motivo: `CNPJ ${situacaoRf}` };

  const ies: Inscricao[] = sefaz.corpo.results;
  if (ies.length === 0) return { acao: "fiscal_decide", motivo: `Sem IE em ${uf}` };

  const restrita = ies.find((i) => /vedad|bloquead/.test(norm(i.situacao_contribuinte)));
  if (restrita) return { acao: "bloquear", motivo: restrita.situacao_contribuinte };

  const habilitadas = ies.filter((i) => norm(i.situacao_ie) === "habilitado");
  if (habilitadas.length === 0) return { acao: "bloquear", motivo: "IE não habilitada" };
  if (habilitadas.length > 1) return { acao: "fiscal_decide", motivo: "Mais de uma IE habilitada na UF" };

  return { acao: "liberar", ie: habilitadas[0].inscricao_estadual };
}