Ensinando uma plataforma de compliance a ler tabelas tarifárias
Um produto de compliance de comércio exterior: classifique um produto e veja as tarifas, as regulamentações e o custo de importação para qualquer rota comercial, com base em fontes oficiais.
- Função
- Engenheiro de produto
- Período
- fev. de 2026 a set. de 2026
- Status
- Em desenvolvimento
- Stack
- NestJS, AWS Lambda, Step Functions, DynamoDB, React
- Problema
- As regras de tarifas e de produtos perigosos chegam como APIs, planilhas e PDFs que mudam de país para país.
- O que eu fiz
- Construí adaptadores tarifários para seis países por trás de uma única API e transformei a lista de produtos perigosos da ONU em registros estruturados.
- Resultado
- 2.835 registros de produtos perigosos e 139 instruções de embalagem que o produto pode consultar e citar.
O sistema
Cada país publica seus dados tarifários e regulatórios de um jeito: alguns por APIs, outros como planilhas, outros ainda como PDFs divididos em seções ou escaneados e portais do governo. As respostas de compliance são tão boas quanto esses dados, então a ingestão precisa ser exata e rastreável até a fonte.
Engenheiro de produto em um time de duas pessoas em 2026. Construí adaptadores tarifários por país e o parser de produtos perigosos sobre um pipeline de ingestão serverless desenhado pelo meu colega, além da calculadora de custo de importação e do fluxo de inteligência de materiais no app web.
- jurisdições
- 10
- registros de produtos perigosos processados
- 2,835
Das fontes oficiais às respostas no app. Passe o mouse ou toque em um nó.
Um PDF que virou banco de dados
A lista de produtos perigosos da ONU é publicada como uma tabela em PDF de onze colunas, cheia de abreviações, legendas e referências a disposições especiais e instruções de embalagem. Escrevi o parser que a transforma em registros consultáveis: legendas e catálogos são expandidos, disposições especiais e instruções de embalagem viram uma tabela complementar, e casos extremos como as notas de embalagem das classes 7 e 9 chegam intactos.
O resultado são 2.835 registros estruturados e 139 instruções de embalagem, armazenados como fatos e não como texto copiado, então o app consegue responder perguntas em vez de citar um PDF.
Único autor do módulo, com cerca de 1.150 linhas de testes.
Dez países, um só formato
Construí os adaptadores tarifários da Índia, da Nova Zelândia e do Paquistão e as consultas de códigos de exportação da Austrália, do Canadá e dos EUA. A Índia combina capítulos de política comercial com consultas de tarifas separadas; as posições da Nova Zelândia saem de PDFs divididos em seções; cada um precisou do próprio parsing, mas todos expõem os mesmos endpoints de seed, preview e export.
Por cima, uma hierarquia SH normalizada (seções, capítulos, posições e seus irmãos) é compartilhada entre os dados da Austrália, China, Japão, Canadá, EUA e Nova Zelândia, para que o produto compare coisas equivalentes ao longo de uma rota comercial.
Dos dados às respostas
No app web construí a calculadora de custo de importação e um fluxo de inteligência de materiais em três etapas: enviar uma especificação de requisitos, extrair os requisitos, compará-los com referências e então avaliar a conformidade de um material, com progresso e resultados em cada etapa.
Decisões que valem a pena defender
Armazenar fatos derivados, não o texto do documento
Registros estruturados podem ser consultados, comparados e citados; um parágrafo colado de um PDF só pode ser lido.
Um formato de API para todas as fontes
Seed, preview e export funcionam igual para todos os países, então adicionar uma jurisdição é escrever um parser, não uma nova integração.