@fiscalspec/core

Motor de validação do FiscalSpec. Interpreta rulesets fiscais versionados (regras como dados, nunca código) contra XML de NF-e/NFC-e e emite resultados com proveniência completa (ruleId, código provável de rejeição, versão da NT, vigência, fonte oficial).

Para o CLI pronto, ver fiscalspec.

API

import { loadRuleset, evaluateXml, buildReport, ENGINE_VERSION } from "@fiscalspec/core";

const ruleset = await loadRuleset(caminhoDoCorpus, { id: "[email protected]" });
const fileReport = evaluateXml(ruleset, xmlString, "nota.xml");
const report = buildReport(ruleset, [fileReport]);

• loadRuleset(dir, { id }) — carrega e congela o ruleset; falha com ProvenanceError se alguma regra vier sem proveniência (nenhum resultado existe sem evidência).
• evaluateXml(ruleset, xml, label) — avalia um XML; cada regra sai com status violated · passed · not-applicable · cannot-decide · not-implemented.
• buildReport(ruleset, fileReports) — relatório agregado determinístico (sem timestamp: duas execuções produzem bytes idênticos).

Requer Node.js 24 LTS.

Licença

Source-available — ver LICENSE.md.