Como consultar inscrição estadual em PHP?

composer require fiscalapi-br/fiscalapi-php
export FISCALAPI_API_KEY="fapi_sua_chave_aqui"

<?php
require 'vendor/autoload.php';

use FiscalApiBr\FiscalAPI;
use FiscalApiBr\Exception\InsufficientBalanceException;
use FiscalApiBr\Exception\RateLimitException;
use FiscalApiBr\Exception\BadRequestException;
use FiscalApiBr\Exception\FiscalAPIException;

$api = new FiscalAPI(); // lê FISCALAPI_API_KEY

try {
    $resp = $api->consultarIeTodos(cnpj: '12.345.678/0001-95');

    if (($resp['complete'] ?? true) === false) {
        echo "Algum estado não respondeu: lista vazia não prova que não há IE.\n";
    }
    foreach ($resp['results'] as $estado) {
        foreach ($estado['results'] as $ie) {
            echo $estado['uf'], ' ', $ie['inscricao_estadual'], ' ', $ie['situacao_ie'], PHP_EOL;
        }
    }
} catch (InsufficientBalanceException $e) {
    echo "Acabaram as consultas do mês e não há saldo de recarga (402).\n";
} catch (RateLimitException $e) {
    echo 'Limite por minuto atingido; tente em ', $e->getRetryAfter() ?? 60, " s (429).\n";
} catch (BadRequestException $e) {
    echo 'Documento ausente ou sem dígitos: ', $e->getMessage(), PHP_EOL;
} catch (FiscalAPIException $e) {
    echo 'Erro ', $e->statusCode, ': ', $e->getMessage(), ' (request_id ', $e->requestId, ")\n";
}

$api->consultarIe('MT', cnpj: '12345678000195');     // um estado; inscrições direto em $resp['results']
$api->consultarIeTodos(cpf: '123.456.789-09');       // produtor rural pelo CPF
$api->consultarIeTodos(ie: '13.234.567-6');          // descobre o estado de uma IE
$api->consultarCnpj('12345678000195');               // dados da Receita Federal em $resp['result']

<?php
require 'vendor/autoload.php';

use FiscalApiBr\FiscalAPI;
use FiscalApiBr\Exception\InsufficientBalanceException;
use FiscalApiBr\Exception\RateLimitException;
use FiscalApiBr\Exception\BadRequestException;
use FiscalApiBr\Exception\ServerException;
use FiscalApiBr\Exception\APIConnectionException;

// Segundos entre chamadas: 12 no Lite e sem plano, 3 no Starter, 1 no Pro, 0.5 no Enterprise.
const PAUSA = 3.0;
const SAIDA = 'resultado.csv';

$api = new FiscalAPI(); // já repete sozinho em 429 e 5xx, respeitando o Retry-After

// Dígitos verificadores, também do CNPJ alfanumérico. CNPJ com DV errado não
// volta erro da API: é consultado e cobrado. Melhor barrar antes.
function cnpjValido(string $cnpj): bool
{
    if (!preg_match('/^[0-9A-Z]{12}[0-9]{2}$/', $cnpj) || count(array_unique(str_split($cnpj))) === 1) {
        return false;
    }
    $v = array_map(fn ($c) => ord($c) - 48, str_split($cnpj));
    foreach ([12, 13] as $n) {
        $soma = 0;
        for ($i = 0; $i < $n; $i++) {
            $soma += $v[$i] * ((($n - 1 - $i) % 8) + 2);
        }
        $resto = $soma % 11;
        if ($v[$n] !== ($resto < 2 ? 0 : 11 - $resto)) {
            return false;
        }
    }
    return true;
}

// Retomada: pula os CNPJs que já estão no CSV de saída.
$feitos = [];
if (is_file(SAIDA)) {
    foreach (file(SAIDA, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES) as $linha) {
        $feitos[str_getcsv($linha, escape: '')[0]] = true;
    }
}

$cnpjs = array_unique(array_filter(array_map(
    fn ($l) => strtoupper(preg_replace('/[^0-9A-Za-z]/', '', $l)),
    file('cnpjs.txt', FILE_IGNORE_NEW_LINES)
)));

$saida = fopen(SAIDA, 'a');
foreach ($cnpjs as $cnpj) {
    if (isset($feitos[$cnpj])) {
        continue;
    }
    if (!cnpjValido($cnpj)) {
        fputcsv($saida, [$cnpj, '', '', 'CNPJ invalido'], escape: ''); // não chama a API
        continue;
    }
    $inicio = microtime(true);
    try {
        $resp = $api->consultarIeTodos(cnpj: $cnpj);
        $inscricoes = [];
        foreach ($resp['results'] as $estado) {
            foreach ($estado['results'] as $ie) {
                $inscricoes[] = "{$estado['uf']}: {$ie['inscricao_estadual']} ({$ie['situacao_ie']})";
            }
        }
        $completo = ($resp['complete'] ?? true) ? 'sim' : 'nao';
        fputcsv($saida, [$cnpj, implode('; ', $inscricoes), $completo, ''], escape: '');
    } catch (InsufficientBalanceException $e) {
        echo "Parei no {$cnpj}: acabaram as consultas do mês e não há saldo de recarga (402).\n";
        break;
    } catch (RateLimitException $e) {
        sleep($e->getRetryAfter() ?? 60); // fica para a próxima rodada
        continue;
    } catch (BadRequestException $e) {
        fputcsv($saida, [$cnpj, '', '', 'invalido: ' . $e->getMessage()], escape: '');
    } catch (ServerException | APIConnectionException $e) {
        echo "Falha temporária no {$cnpj}; entra de novo na próxima rodada.\n";
    }
    fflush($saida);

    $resto = PAUSA - (microtime(true) - $inicio);
    if ($resto > 0) {
        usleep((int) ($resto * 1_000_000));
    }
}
fclose($saida);