1.2 KiB
Fiscal Data Foundation V1
Goal
Provide independently versioned, official fiscal datasets for the Hub without determining taxes for products.
Dataset lifecycle
Each domain runs independently: official download, raw SHA-256, versioned parser, structural validation, PENDING import, semantic/volume validation, then ACTIVE promotion. A parser failure records FAILED and failure_reason; the previous ACTIVE version remains queryable. No secondary source can promote a canonical dataset.
Every version records domain, source_url, downloaded_at, raw_sha256, parser_version, effective_from, effective_to, record_count, status, failure_reason, and raw_payload_reference when retention is allowed.
Domains
Existing NCM/Siscomex and CEST/CONFAZ remain intact. New isolated importers cover BA ST/MVA, CFOP, ICMS CST/CSOSN/origin, PIS/COFINS, TIPI/IPI, RTC, FCP, and monophase ICMS/ANP. Each has a normalized operational table only when queried by Hub consumers.
Verification
Parser tests prove fail-closed behavior and independent lifecycle behavior. The final smoke reads only ACTIVE versions and produces the dataset matrix. This mission does not classify products or propose tax fields.