taric-opendata

Automated mirrors of customs tariff data from multiple jurisdictions, published as GitHub Release assets for machine-readable HTTP access without portal navigation.

Countries

The Status badge shows each source's last daily run. Each source runs on its own schedule (staggered through the 22:00–23:45 UTC window; be runs last, after minfin's nightly publish), so its badge reflects a real run. Sync All is a manual convenience to run everything at once. EUR-Lex full text is manual-only; atar runs weekly (Mondays) as it is a heavy scrape; both are excluded from the daily window.

Code	Jurisdiction	Source	Format	Release Tag
`be`	Belgium	minfin TARBEL	ZIP/XML	`be-YYYY-MM`
`nl`	Netherlands	Belastingdienst DTV	ZIP/XML	`nl-YYYY-MM`
`gb`	United Kingdom	data.api.trade.gov.uk	CSV	`gb-YYYY-MM`
`no`	Norway	data.toll.no	XML/JSON	`no-YYYY-MM`
`eu`	European Union	CIRCABC (DG TAXUD)	ZIP/XML	`eu-YYYY-MM`
`se`	Sweden	Tullverket Tulltaxan	ZIP/XML	`se-YYYY-MM`
`ch`	Switzerland	BAZG datahub	ZIP/XML	`ch-YYYY-MM`
`pl`	Poland	ISZTAR4	ZIP	`pl-YYYY`
`fr`	France	RITA (Douane FR)	ZIP/XML	`fr-YYYY-MM`
`us`	United States	USITC HTS	JSON/CSV	`us-YYYY`
`ebti`	EU (BTI)	DDS2 EBTI	ZIP/CSV	`ebti-YYYY`
`eurlex`	EU (legislation)	CELLAR SPARQL	CSV (+ZIP)	`eurlex-YYYY-MM`
`atar`	UK (rulings)	GOV.UK ATaR	CSV	`atar-YYYY-MM`
`tr`	Türkiye	Ticaret Bakanlığı (TGTC)	XLS→CSV	`tr-YYYY`

Data Contents

Belgium (`be`)

EU TARIC + Belgian national measures (BTW, RBT, accijnzen). Scraped directly from the minfin TARBEL JSF portal (see scripts/sync-be.ps1). - export-{date}-{date}.zip — full monthly extraction (~1^st of month) - export-{date}_{date}-{date}.zip — daily delta - XML-Document.zip — XML schema documentation - listed_currencies.xlsx — currency rates

Netherlands (`nl`)

EU TARIC + Dutch national measures (BTW, accijns). Sourced from the Belastingdienst DTV bulk download manifest. Arctic Group Tariff XML format. - Full download (complete dataset) - Incremental download (daily changes)

United Kingdom (`gb`)

UK Global Tariff (post-Brexit). Three CSV tables per version from the UK Department for Business and Trade: - commodities-{version}.csv — goods nomenclature and descriptions - measures-on-declarable-commodities-{version}.csv — duties and restrictions per commodity - measures-as-defined-{version}.csv — measures as defined in the tariff hierarchy

Norway (`no`)

Norwegian customs tariff structure and quotas (CC BY 4.0). From Tolletaten CKAN portal. - customstariffstructure.xml / .json — commodity numbers, descriptions, duty rates - tollkvote.xml / .json — customs quotas

European Union (`eu`)

Official EU TARIC dataset published on CIRCABC by DG TAXUD. Authoritative source for all EU-27 member state tariffs. - Full snapshot ZIP/XML containing measures, nomenclature, geographical areas, and reference tables

Sweden (`se`)

Swedish customs tariff (Tulltaxan) published by Tullverket (Swedish Customs Authority). - Full tariff ZIP in Arctic Group Tariff XML format

Switzerland (`ch`)

Swiss customs tariff published by BAZG (Bundesamt für Zoll und Grenzsicherheit). - Full tariff ZIP from the BAZG open data hub

Poland (`pl`)

Polish customs tariff from ISZTAR4 (Informacyjny System Zintegrowanej Taryfy Celnej). Annual release. - isztar4-base.zip — full base startup file (~7 GB)

France (`fr`)

EU TARIC + French national measures (TVA, droits d'accise) via RITA (Référentiel Intégré Tarifaire Automatisé) published by Direction Générale des Douanes et Droits Indirects. - Full tariff ZIP/XML export

United States (`us`)

Harmonized Tariff Schedule of the United States published by USITC. Updated per revision (~10 revisions per year). Annual release tag. - hts-us.json — full HTS in structured JSON (chapters 01–99) - hts-us.csv — same data as flat CSV - hts-version.json — version/revision marker

EU legislation (`eurlex`)

EU secondary legislation sourced from the Publications Office CELLAR repository via its public SPARQL endpoint (the sanctioned machine interface — eur-lex.europa.eu's HTML frontend is WAF-protected). Scope is all of CELEX sector 3 — regulations, directives and decisions (~233k acts). This covers every regulation a TARIC measure can reference (a GeneratingRegulationId always maps to a sector-3 CELEX), so consumers join locally on CELEX without any per-code lookup against CELLAR. Split into a daily metadata sync and a manual full-text sync. - eurlex-manifest.csv — one row per act (~233k, ~85 MB): CELEX, title, Official Journal id, document/entry-into-force/end-of-validity dates, in-force flag, resource type, ELI, and legal-act directory codes. Deep-link to EUR-Lex via https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:{CELEX}. Enumeration is partitioned by CELEX year to keep each SPARQL query small. - eurlex-version.txt — change-detection sentinel (work count + max document date). - cnen-en.html — the consolidated CN Explanatory Notes (CNEN), English (CELEX 02019XC0329(02), latest consolidation resolved via CELLAR). Published by the daily metadata sync with its own cnen-version.txt sentinel, so it refreshes independently of the manifest. Notes are keyed by CN chapter/heading/subheading. - cn-notes.csv — the binding CN legal Section/Chapter notes from Annex I to Regulation 2658/87 (latest consolidation 01987R2658-YYYYMMDD resolved via CELLAR, HTML parsed). Columns: Kind (section/chapter), Code, SectionRoman, Title, NoteText. Own cn-notes-version.txt sentinel (consolidation date). Consumed by TaricHive's EurLexImporter. - eurlex-text-{lang}.zip — manual only (Sync EUR-Lex legislation (full text) workflow). Per-CELEX HTML full text, one language per zip. Use the limit/a filtered manifest — running full text over all ~233k acts is impractical (tens of GB). Older acts with no HTML manifestation (PDF/scan only) are skipped.

UK Advance Tariff Rulings (`atar`)

The GB analogue of EU BTIs, scraped from the GOV.UK Search for Advance Tariff Rulings service (Open Government Licence). Unlike the GB tariff (gb, a CSV API) there is no bulk/API feed, so the ruling pages are scraped: paginated enumeration of the search results (/search?page=N, 25 rulings/page) then a per-ruling parse of each /ruling/{id} page. Runs weekly (heavy scrape); change detection on the total ruling count makes an unchanged run a fast no-op. - atar.csv — one row per ruling: reference, commodity code, start/expiry dates, goods description, keywords, and grounds for classification. - atar-version.txt — change-detection sentinel (total ruling count).

Türkiye (`tr`)

The Turkish Customs Tariff (TGTC — İstatistik Pozisyonlarına Bölünmüş Türk Gümrük Tarife Cetveli), published annually by the Ministry of Trade as a zip of per-chapter legacy .xls files. The sync resolves the latest zip from ggm.ticaret.gov.tr, extracts the nomenclature chapters and the section/chapter notes, and parses both with Python + xlrd (parse-tgtc.py, parse-tgtc-notes.py). - tr-nomenclature.csv — one row per code: CnCode (12-digit GTİP, digits only), DescriptionTR (Turkish), Unit, BaseDutyRate (the base "474" MFN rate), IndentLevel. GTİP digits 1-8 = HS6 + EU CN, so consumers can borrow EU CN descriptions (EN/NL/FR/DE) for the aligned levels. - tr-notes.csv — the binding Section (BÖLÜM) and Chapter (FASIL) legal notes: Kind (section/chapter), Code (section roman or 2-digit chapter), SectionRoman, Title, NoteText (Turkish; wrapped lines re-joined, note items split by newline). Section→chapter linkage uses the fixed HS mapping. - tr-measures.csv — the applied duty rates from the Import Regime Decree annex lists (Karar 3350, "rejim YYYY.zip", lists I–VII; parsed with parse-regime.py): one row per GTİP × country-group column. Columns: Code (12-digit, zero-padded — the xlsx drops leading zeros), Group (column label, e.g. AB, BK, GÜR, DÜ), Rate (as published: number, T1/T2 composition markers, M, …), List. The zip URL is resolved from ggm.ticaret.gov.tr with a pinned per-year fallback for CI; own tr-regime-version.txt sentinel. - tr-version.txt — change-detection sentinel (the resolved TGTC zip URL).

Usage

# Download current month's Belgium release
gh release download "be-$(date +%Y-%m)" --repo rousseauxy/taric-opendata --dir ./be

# Download current month's EU TARIC
gh release download "eu-$(date +%Y-%m)" --repo rousseauxy/taric-opendata --dir ./eu

# Download current UK tariff CSVs
gh release download "gb-$(date +%Y-%m)" --repo rousseauxy/taric-opendata --pattern "commodities-*.csv" --dir ./gb

# Download US HTS (current year)
gh release download "us-$(date +%Y)" --repo rousseauxy/taric-opendata --dir ./us

Relationship to tarbel-opendata

Belgian data (be) is scraped directly from the minfin TARBEL portal by scripts/sync-be.ps1, which carries the same JSF scraping logic as the standalone tarbel-opendata repo. taric-opendata no longer mirrors tarbel-opendata's releases — both run the same scraper independently. tarbel-opendata remains as a Belgium-only mirror; this repo publishes be alongside all other jurisdictions under the unified {country}-YYYY-MM release scheme.

tarbel-opendata — Belgian minfin data source
TaricHive — multi-country tariff database that consumes these releases (SQL Server + .NET API)

taric-opendata

Countries

Data Contents

Belgium (be)

Netherlands (nl)

United Kingdom (gb)

Norway (no)

European Union (eu)

Sweden (se)

Switzerland (ch)

Poland (pl)

France (fr)

United States (us)

EU legislation (eurlex)

UK Advance Tariff Rulings (atar)

Türkiye (tr)