Rejeições SEFAZ no SUOT Fiscal SDK: diagnóstico e ação

use SUOT\Fiscal\Handler\AutorizacaoHandler;
use SUOT\Fiscal\Command\AutorizarNFeCommand;
use SUOT\Fiscal\Exception\InfrastructureException;

$command = new AutorizarNFeCommand(/* ... */);

try {
    $result = $handler->handle($command);

    if ($result->isSuccess()) {
        // Documento autorizado — persista chave, protocolo e XML
        $chave     = $result->chave();
        $protocolo = $result->protocolo();
        $xml       = $result->xmlAutorizado();

        logger()->info('NF-e autorizada', compact('chave', 'protocolo'));

    } elseif ($result->isRejected()) {
        $cStat  = $result->status();
        $motivo = $result->motivo();

        // Sempre registre cStat e xMotivo
        logger()->warning('NF-e rejeitada pela SEFAZ', [
            'cStat'   => $cStat,
            'xMotivo' => $motivo,
            'chave'   => $command->chave(),
        ]);

        // Roteie pelo código de rejeição
        match ($cStat) {
            204 => $this->handleDuplicidade($result),
            539 => $this->notificarCnpjInvalido($command),
            225 => $this->notificarSchemaInvalido($result),
            default => $this->encaminharParaRevisaoManual($cStat, $motivo),
        };
    }

} catch (InfrastructureException $e) {
    // Falha de infraestrutura — tratar separadamente
    logger()->error('Falha técnica ao autorizar NF-e', ['error' => $e->getMessage()]);
}

// Command original com CNPJ incorreto (cStat 539)
$commandOriginal = new AutorizarNFeCommand(
    emitenteCnpj: '00.000.000/0000-00',  // inválido
    destinatarioCpf: '123.456.789-09',
    valorTotal: 1500.00,
    itens: $itens,
    // ...
);

$result = $handler->handle($commandOriginal);

if ($result->isRejected() && $result->status() === 539) {
    // Reconstrua o Command com o CNPJ corrigido
    $commandCorrigido = new AutorizarNFeCommand(
        emitenteCnpj: '12.345.678/0001-95',  // corrigido
        destinatarioCpf: '123.456.789-09',
        valorTotal: 1500.00,
        itens: $itens,
        // ...
    );

    $resultCorrigido = $handler->handle($commandCorrigido);
}