Clasificación masiva: Procesar 1,000+ SKUs con la API de TariffPro

Cuándo usar la API de clasificación masiva

La interfaz web de TariffPro es ideal para clasificaciones individuales o lotes pequeños. Pero cuando necesitas clasificar un catálogo completo de más de 1,000 SKUs, migrar datos de otro sistema, o integrar la clasificación en tu ERP o WMS, la API de TariffPro es la solución. La API procesa hasta 10,000 clasificaciones por hora con la misma precisión que la interfaz web.

Paso 1: Obtener tus credenciales de API

Desde tu panel de Camtom, navega a Configuración → API → Generar clave. Recibirás un API key y un API secret. Guarda el secret de forma segura — solo se muestra una vez. La autenticación usa Bearer tokens: envía el API key en el header Authorization: Bearer {tu-api-key} en cada solicitud.

Paso 2: Preparar los datos de entrada

Cada SKU debe incluir como mínimo la descripción del producto. Para mejor precisión, incluye también: material o composición, uso o función, dimensiones o peso, y país de origen. Formatea los datos como un arreglo JSON donde cada objeto tiene un campo id (tu referencia interna) y un campo description (texto descriptivo del producto).

Paso 3: Enviar solicitudes en lotes

La API acepta hasta 100 SKUs por solicitud. Para catálogos grandes, divide tu lista en lotes de 100 y envía cada lote secuencialmente. Respeta el rate limit de 60 solicitudes por minuto. Cada respuesta incluye la fracción arancelaria sugerida, el nivel de confianza, la descripción oficial de la TIGIE, y la tasa arancelaria correspondiente para cada SKU del lote.

Paso 4: Manejar errores y reintentos

• HTTP 429 (Rate Limit): Espera el tiempo indicado en el header Retry-After antes de reintentar.
• HTTP 400 (Bad Request): La descripción está vacía o el formato JSON es inválido. Corrige y reenvía.
• HTTP 500 (Server Error): Error temporal del servidor. Reintenta con backoff exponencial (1s, 2s, 4s, 8s).
• Confianza baja (<70%): La descripción es ambigua. Marca el SKU para revisión manual y mejora la descripción.
• Sin resultados: La descripción no coincide con ningún producto conocido. Verifica que sea un producto real y reformula.

Paso 5: Procesar los resultados

Para cada SKU, la API retorna las tres clasificaciones más probables con su nivel de confianza. Aplica la siguiente lógica: si la primera sugerencia tiene confianza mayor al 90%, acéptala automáticamente. Si está entre 70% y 90%, márcala para revisión rápida. Si es menor al 70%, envíala a revisión manual por un clasificador experto. Este flujo escalonado maximiza la eficiencia sin sacrificar precisión.

Paso 6: Integrar con tu sistema

Los resultados de la API se pueden almacenar directamente en tu ERP, WMS o base de datos interna. Incluye el ID del SKU, la fracción arancelaria aceptada, la fecha de clasificación y el nivel de confianza. Programa reclasificaciones periódicas (trimestral o cuando cambie la TIGIE) para mantener tu catálogo actualizado.

1. Limpia y enriquece las descripciones de tus SKUs antes de enviarlas a la API.
2. Usa lotes de 100 SKUs máximo por solicitud para optimizar el rendimiento.
3. Implementa reintentos con backoff exponencial para errores 429 y 500.
4. Clasifica automáticamente los SKUs con confianza alta (>90%) y revisa manualmente los de confianza baja.
5. Programa reclasificaciones periódicas para mantener tu catálogo al día con la TIGIE vigente.