20 lines
1.2 KiB
Markdown
20 lines
1.2 KiB
Markdown
# 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.
|