Brazil NCM / TIPI Lookup

Lookup NCM codes — the Mercosur nomenclature (Nomenclatura Comum do Mercosul) used in Brazil — and optional public Portal Único NCM attributes from official downloadable JSON. Fast structured reference for trade, customs classification and product tax workflows. No Siscomex Client secrets and no importer login — public open data only.

TIPI (Tabela de Incidência do IPI) is published separately by Receita Federal (PDF/XLSX). This Actor focuses on the official Classif NCM table plus Portal Único public atributo-ncm attributes linked to each code.

Store: brazil-ncm-tipi-lookup

---

What it does

1. Downloads the public NCM nomenclature JSON from Portal Único / Classif.
2. Optionally downloads the public NCM attributes ZIP and attaches tipAttributes[] per code.
3. Filters by NCM code list and/or Portuguese description keyword; caps with maxItems.

Official public sources

• NCM table: https://portalunico.siscomex.gov.br/classif/api/publico/nomenclatura/download/json?perfil=PUBLICO
• NCM attributes ZIP: https://portalunico.siscomex.gov.br/cadatributos/api/atributo-ncm/download/json?perfil=PUBLICO

Who it's for

• Trade / customs teams classifying products for Brazil import/export
• ERP and tax engines that need NCM descriptions as JSON
• Marketplaces and catalog enrichment for Mercosur HS-style codes
• Agents that need NCM TIPI-adjacent reference without Siscomex credentials

Input summary

Field	Required	Description
ncmCodes	no	List of NCM codes (dots optional), e.g. 0901.11.10
keyword	no	Case-insensitive substring on Portuguese description
includeAttributes	no	Attach Portal Único tipAttributes[] (default true)
maxItems	no	Hard Dataset cap (default 50)

Provide codes and/or a keyword; empty inputs return a capped slice of the table.

Output fields

One Dataset row per NCM:

ncm, descriptionPt, descriptionEn (null when not in source), chapter, tipAttributes (array), sourceUrl, asOf, dataInicio, dataFim, ato, scrapedAt.

Pricing

Pay-per-event is already configured (Actor start + NCM rows). Attribute ZIP enrichment adds network/CPU; keep maxItems as the spend cap. See the Store pricing panel for current prices.

Quick start (Apify Console)

1. Open brazil-ncm-tipi-lookup → Start.
2. Enter ncmCodes and/or a keyword (e.g. café).
3. Toggle includeAttributes as needed; set maxItems.
4. Run → export Dataset JSON/CSV.

{
  "ncmCodes": ["0901.11.10", "8471.30.12"],
  "keyword": "café",
  "includeAttributes": true,
  "maxItems": 50
}

Related Actors

• Brazil PNCP Public Tenders Monitor
• Brazil PNCP Awarded Contracts
• Brazil CEIS/CNEP Sanctions Delta
• Brazil TCU Acórdãos Keyword Monitor

Legal / data source

Official Portal Único Siscomex public Classif / Cadastro de Atributos downloads (perfil=PUBLICO). No Client ID/Secret, no DU-E/Duimp credentials. Do not scrape private Siscomex services with this Actor. Respect fair-use download frequency.

---

Português (resumo)

Consulta a tabela NCM oficial do Classif/Portal Único e, opcionalmente, atributos públicos por NCM. Não usa Client ID/Secret Siscomex. Ideal para classificação aduaneira e enriquecimento de catálogo. Pay-per-event na Store.