Documentación interna: qué es el Clasificador, cómo funciona el circuito con los despachantes y qué hace cada parte. El modelo propone; el humano decide.
01Qué es
A partir de fotos y/o la descripción de un producto, sugiere su posición arancelaria (NCM) y calcula el costo de importarlo a la Argentina.
Combina visión (leer la foto y extraer atributos), búsqueda sobre el nomenclador oficial y un re-rank del modelo para elegir la hoja correcta. Los aranceles (DIE, IVA, ganancias, IIBB), las intervenciones (ANMAT, INAL, etc.) y el antidumping salen de las fuentes reales (ARCA / PCRAM / CNCE), no del modelo.
El valor no es solo la sugerencia: es el bucle. Cada corrección del despachante se convierte en regla y ejemplo para las próximas clasificaciones.
02Dos tipos de usuario
La misma herramienta, dos públicos que no se cruzan.
Despachantes B2BOX
Los nuestros. Hacen el circuito completo (admin → bandeja → admin) sobre las importaciones de B2BOX. Son los únicos que clasifican trabajo de B2BOX.
Usuarios externos (SaaS)
Otros importadores a los que les damos la herramienta. Clasifican sus propios productos. No ven la bandeja de B2BOX ni clasifican nada de B2BOX.
03El circuito
El paso del despachante es humano a propósito: una propuesta del modelo no es un resultado hasta que una persona la mira.
04Cómo clasifica
De la foto (o el texto) a un NCM con su costo, en pasos verificables.
- Caché exacto — si el SKU/EAN ya tiene un NCM validado por un humano, se reusa. Costo cero.
- Visión → atributos — el modelo declara material, función, uso, medidas. Cada dato lleva su fuente (foto, PDF, formulario).
- Retrieval híbrido — BM25 (léxico) + embeddings Voyage (semántico) sobre el nomenclador, fusionados.
- Re-rank — el modelo elige la hoja entre los candidatos, aplicando RGI y las reglas aprendidas.
- Chequeo de cortes — en código se verifica que la hoja no contradiga un dato numérico (peso, pantalla, FOB).
- Enriquecido real — DIE, alícuotas PCRAM, intervenciones y antidumping desde la fuente, más el costo.
05El bucle humano
Lo que hace que el sistema mejore: el despachante revisa, corrige y enseña.
Confirmar o corregir
Cada clasificación se persiste con su rastro completo. El despachante confirma la #1 (nos da la razón) o la corrige. La distinción sostiene la métrica clave: tasa de corrección = corregidas / revisadas.
La regla enseña el patrón
Al corregir, el despachante escribe el criterio ("las botellas de aluminio para bebidas van a 7612.90, no a 8309"). Esa regla se le inyecta al modelo como restricción dura la próxima vez que clasifique algo del mismo capítulo.
06Features
Lo que hace la herramienta día a día. Marcadas Nuevo las de la última iteración.
Campanita Nuevo
El tab Bandeja muestra, desde cualquier pantalla, cuántos pendientes hay sin ver. Abrir uno lo apaga.
Similar previo Nuevo
Al pasar un producto, si ya clasificaste uno parecido (embeddings) lo ofrece como opción con un click.
Miniatura en bandeja Nuevo
La foto de B2BOX se guarda como thumbnail al clasificar, así se reconoce el producto en el historial.
Fotos reales del PDF Nuevo
Packing list en PDF: la foto de cada renglón se recorta de verdad (poppler + visión), no solo se describe.
Mismo producto
Copiar el NCM de otro producto ya clasificado del mismo envío, sin gastar una llamada al modelo.
Pregunta dirigida
Cuando un corte depende de un dato que falta (peso, FOB), pregunta una sola cosa en vez de adivinar.
Verificaciones
Intervenciones (ANMAT, INAL, SENASA…) y antidumping (CNCE) sobre el NCM elegido, desde la fuente.
Costos al centavo
Gasto real de Anthropic por clasificación y total. Panel solo para admin.
Editor de prompts
Editar los prompts de visión y re-rank desde la UI; persisten en Supabase. Gateado a dev.
07Lote / packing list
Un envío entero: una clasificación por producto, con su foto y su avance visible.
Se sube un Excel (fotos ancladas a las celdas) o un PDF. En ambos casos se reconstruye la tabla y se clasifica de a uno — no los 30 en un request: así cada resultado llega apenas está, el usuario ve el avance y puede frenar sin perder lo ya pagado.
Excel
Las fotos vienen ancladas a las celdas: se extraen y se muestran directo.
La página se renderiza, el modelo ubica la caja de cada foto, se recorta con pdftoppm y se
liga al renglón por SKU/descripción. Un filtro de calidad descarta los recortes vacíos.
08Roles y acceso
Login con Supabase, separado del admin. El costeo y las pantallas de dev están gateados.
| Rol | Puede |
|---|---|
| todos (logueados) | Clasificar, ver la bandeja, revisar y corregir. |
| dev | Lo anterior + costeo (modo completo del clasificador). |
| head_of_dev · admin | Todo + las pantallas de gestión: Prompts, Inspector, Costos y esta Ayuda. |
09Endpoints principales
Todos bajo sesión. El circuito con el admin entra por un endpoint externo con API key.
| Método | Ruta | Qué hace |
|---|---|---|
| POST | /api/clasificar | Clasifica un producto → NCM + aranceles + costo. |
| POST | /api/clasificar/responder | Responde una pregunta dirigida y fija la hoja sin re-clasificar. |
| GET | /api/bandeja | Lista de solicitudes del despachante. |
| GET | /api/bandeja/pendientes | Conteo + referencias de pendientes (la campanita). |
| GET | /api/bandeja/:ref | Detalle + aranceles + similares previos. |
| POST | /api/bandeja/:ref/clasificar | Corre el modelo sobre lo que mandó el admin. |
| POST | /api/bandeja/:ref/resolver | Confirma o descarta; recién acá el admin recibe el NCM. |
| POST | /api/lote/analizar | Planilla/PDF → tabla de productos (con fotos). No llama al modelo. |
| GET | /api/metricas | Tasa de corrección y otros indicadores del bucle. |
10Deploy
Coolify con Nixpacks (autodetect Node).
nixpacks.tomlagregapoppler_utilsal build (fotos del PDF). Sin él, cada renglón queda con su descripción de texto — no rompe.- Los datos del nomenclador y las alícuotas son generados, no versionados: se reconstruyen con los scripts de ingesta.
- La base de
clasificaciones(historial de correcciones) es la única irreemplazable: sobrevive a re-ingestas.