Saltar al contenido principal

Search HS codes by term

GET 
/company/categories/find

Busca coincidencias en códigos y descripciones de partidas (6 dígitos) y subpartidas (8-10 dígitos) del Sistema Armonizado. Permite búsqueda libre sin necesidad de conocer la jerarquía completa.

Objetivo​

Facilitar la búsqueda rápida de códigos HS cuando se conoce el nombre del producto o parcialmente el código, sin navegar la estructura jerárquica completa.

Casos de uso​

  • Búsqueda por producto: Encontrar el código HS para "atún", "maquinaria", "textiles"
  • Validación de códigos: Verificar si un código existe y obtener su descripción
  • Autocompletado: Sugerir códigos mientras el usuario escribe el nombre de un producto
  • Clasificación rápida: Encontrar categorías sin explorar toda la jerarquía
  • Integración con inventario: Clasificar productos existentes en un catálogo

Características de la búsqueda​

  • Case-insensitive: No distingue mayúsculas/minúsculas
  • Coincidencia parcial: Busca en títulos (códigos) y descripciones (labels)
  • Límite de 40 resultados: 20 partidas + 20 subpartidas
  • Ordenación alfabética: Resultados ordenados por código
  • Múltiples orígenes: Busca en colecciones de partidas y subpartidas

Flujo de búsqueda​

flowchart TD
  A[Recibir término] --> B{término válido?}
  B -->|No| C[404 USER_NOT_FOUND]
  B -->|Sí| D[Buscar en partidas - máx 20]
  D --> E[Buscar en subpartidas - máx 20]
  E --> F[Combinar resultados]
  F --> G[Ordenar alfabéticamente]
  G --> H[Retornar array]

Notas importantes​

  • Requiere autenticación con token JWT de empresa
  • El término puede venir de query param, path param o body (se extrae de todos)
  • El término se limpia de comillas simples antes de buscar
  • Mínimo 1 carácter requerido (se elimina espacios)
  • No retorna resultados si no hay coincidencias (array vacío, no 404)

Request​

Responses​

Códigos HS coincidentes con la búsqueda

Response Headers