Files

T

gti d21a9d1140 Add 'fiscal/' from commit '102ba84500dbd9655a0471288c3e278652593ca9'

git-subtree-dir: fiscal
git-subtree-mainline: d95165fc8f
git-subtree-split: 102ba84500

2026-09-29 14:43:23 -03:00

1.2 KiB

Raw Permalink Blame History

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.

1.2 KiB Raw Permalink Blame History