Customs Tariff NZ

Use the read-only Python CLI to search the current official CusMod tariff data archive. Every result reports the archive's own update timestamp, retrieval time, source URL and interpretation caveats.

Commands

# Search active classifications by words or a tariff-code prefix
python3 scripts/cli.py search "roasted coffee" --json
python3 scripts/cli.py search 0901 --as-of 2026-09-02 --limit 20 --json

# Look up one 10-digit tariff item and join its active rates and levies
python3 scripts/cli.py lookup 09.01.21.00.00 --json

# Inspect levy-formula coefficients by exact code, or explicitly use prefix mode
python3 scripts/cli.py formula 2 --json
python3 scripts/cli.py formula 2 --prefix --limit 20 --json

Human-readable output is the default. Add --json to every data command for stable machine-readable output. --limit accepts 1–100, --as-of accepts YYYY-MM-DD, and every live request has a 10-second timeout.

Interpretation guardrails

• Treat classifications, rate formula codes, factors, levy codes and levy coefficients as source records—not a landed-cost quotation.
• Do not calculate or present definitive duty, levy, GST, freight, insurance, concession, preference or valuation outcomes from these fields alone.
• A classification can depend on composition, use, origin and legal notes. Confirm material decisions with New Zealand Customs or a qualified customs broker.
• The archive is intended for specialised broker software, is updated every 24 hours, and includes historical rows; commands filter rows against --as-of.
• formula exposes raw levy-formula coefficients. It does not turn them into payable amounts or infer units.
• The tariff archive does not include the separate concession archive and does not establish eligibility for preferential rates.

Resources

• scripts/cli.py — canonical command entrypoint
• scripts/customs_tariff.py — bounded archive fetcher and parser
• scripts/test_contract.py — deterministic repository contract audit
• scripts/smoke_test.py — synthetic parser assertions and bounded live probe
• tests/fixtures/tariff-synthetic.tar.gz — deterministic CC0 synthetic archive fixture
• references/source-notes.md — provenance, schema, formula context and source limitations