Skip to content

feat: add versioned official domain catalogs - #79

Merged
vitormattos merged 1 commit into
mainfrom
feat/version-official-domain-tables
Oct 4, 2026
Merged

vitormattos merged 1 commit into
mainfrom
feat/version-official-domain-tables

Conversation

@vitormattos

Copy link
Copy Markdown
Member

Closes #51 if the normalized snapshots pass CI and review.

Summary

  • add offline versioned catalogs for municipalities, countries, national service codes, NBS 2.0 and IBS/CBS operation indicators
  • expose typed lookup/validation through OfficialDomainCatalog
  • pin official annex versions and source workbook provenance
  • verify snapshot cardinalities and representative codes in PHPUnit
  • explicitly keep RTC Anexo VIII correlation advisory-only because the official portal states it is not a production business-rule source

Sources

  • ANEXO_A v1.00 (20251210)
  • ANEXO_B v1.01 (20260122)
  • ANEXO_C v1.01 (20260122)

The exact XLSX filenames/versions are current on the official production documentation page. Workbook mirror blob IDs and independently generated TSV snapshots are documented in resources/domains/README.md.

No runtime network dependency is introduced.

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
@vitormattos
vitormattos merged commit 4abbfb1 into main Oct 4, 2026
11 checks passed
@vitormattos
vitormattos deleted the feat/version-official-domain-tables branch October 4, 2026 22:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Version official NFS-e domain and correlation tables

1 participant