Enseñar a una plataforma de cumplimiento a leer aranceles
Un producto de cumplimiento normativo para comercio exterior: clasifica un producto y consulta los aranceles, la normativa y el coste de importación total para cualquier ruta comercial, basado en fuentes oficiales.
- Rol
- Ingeniero de producto
- Periodo
- feb 2026 a sept 2026
- Estado
- En desarrollo
- Stack
- NestJS, AWS Lambda, Step Functions, DynamoDB, React
- Problema
- Las normas sobre aranceles y mercancías peligrosas llegan como APIs, hojas de cálculo y PDF que cambian según el país.
- Qué hice
- Construí adaptadores de aranceles para seis países detrás de una sola API, y convertí la lista de mercancías peligrosas de la ONU en registros estructurados.
- Resultado
- 2,835 registros de mercancías peligrosas y 139 instrucciones de embalaje que el producto puede consultar y citar.
El sistema
Cada país publica sus datos arancelarios y normativos de una forma distinta: unos mediante APIs, otros como hojas de cálculo, y otros como PDF por secciones o escaneados y portales gubernamentales. Las respuestas de cumplimiento son tan buenas como esos datos, así que la ingesta tiene que ser exacta y trazable hasta su fuente.
Ingeniero de producto en un equipo de dos personas en 2026. Construí adaptadores de aranceles por país y el parser de mercancías peligrosas sobre un pipeline de ingesta serverless que diseñó mi compañero, y la calculadora de coste de importación y el flujo de inteligencia de materiales en la app web.
- jurisdicciones
- 10
- registros de mercancías peligrosas procesados
- 2,835
De las fuentes oficiales a las respuestas en la app. Pasa el cursor o toca un nodo.
Un PDF que se convirtió en base de datos
La lista de mercancías peligrosas de la ONU se publica como una tabla en PDF de once columnas, llena de abreviaturas, leyendas y referencias a disposiciones especiales e instrucciones de embalaje. Escribí el parser que la convierte en registros consultables: se expanden las leyendas y los catálogos, las disposiciones especiales y las instrucciones de embalaje pasan a una tabla complementaria, y casos límite como las notas de embalaje de la clase 7 y la clase 9 se conservan intactos.
El resultado son 2,835 registros estructurados y 139 instrucciones de embalaje, guardados como hechos y no como texto copiado, para que la app pueda responder preguntas en lugar de citar un PDF.
Único autor del módulo, con unas 1,150 líneas de tests.
Diez países, una misma forma
Construí los adaptadores de aranceles de India, Nueva Zelanda y Pakistán y las consultas de códigos de exportación de Australia, Canadá y EE. UU. India combina capítulos de política comercial con consultas de aranceles separadas; las partidas de Nueva Zelanda salen de PDF divididos por secciones; cada uno necesitó su propio parsing, pero todos exponen los mismos endpoints de carga, vista previa y exportación.
Por encima, una jerarquía HS normalizada (secciones, capítulos, partidas y sus hermanas) se comparte entre los datos de Australia, China, Japón, Canadá, EE. UU. y Nueva Zelanda, para que el producto pueda comparar elementos equivalentes a lo largo de una ruta comercial.
De los datos a las respuestas
En la app web construí la calculadora de coste de importación y un flujo de inteligencia de materiales en tres pasos: subir una especificación de requisitos, extraer los requisitos, compararlos con referencias y después evaluar el cumplimiento de un material, con progreso y resultados en cada paso.
Decisiones que defiendo
Guardar hechos derivados, no el texto del documento
Los registros estructurados se pueden consultar, comparar y citar; un párrafo pegado de un PDF solo se puede leer.
Una misma forma de API para cada fuente
Carga, vista previa y exportación funcionan igual para todos los países, así que añadir una jurisdicción es escribir un parser, no una integración nueva.