Pular para o conteúdo principal

Buscar categorías por término

GET 
/categories/search

Busca categorías que coincidan con un término de búsqueda en sus códigos o descripciones.

Características:

  • Búsqueda case insensitive en títulos y etiquetas
  • Coincidencia parcial (no requiere término completo)
  • Límite de 20 resultados para partidas y 20 para subpartidas
  • Resultados ordenados alfabéticamente por código
  • Normalización automática de títulos y etiquetas

Algoritmo de búsqueda:

  1. Busca coincidencias en:
    • Códigos de categoría (4 o 6 dígitos)
    • Texto descriptivo (labels)
  2. Aplica filtros:
    • Mínimo 2 caracteres en término de búsqueda
    • Máximo 40 resultados totales (20 partidas + 20 subpartidas)
  3. Procesamiento:
    • Elimina prefijos como "heading", "subheading"
    • Combina y limpia etiquetas (remueve "-", ":", espacios extras)
    • Ordena resultados alfabéticamente

Request​

Responses​

Resultados de búsqueda normalizados y ordenados. Estructura: - title: Código de categoría normalizado (sin prefijos) - label: Descripción legible (sin caracteres especiales) Ejemplo completo: json [ { "title": "0101", "label": "Caballos asnos mulas y burdéganos vivos", "metadata": { "type": "heading", "originalTitle": "heading 0101", "originalLabels": ["Caballos", "asnos", "mulas", "burdéganos", "vivos"] } }, { "title": "010121", "label": "Reproductores de raza pura", "metadata": { "type": "subheading", "originalTitle": "subheading 010121", "originalLabels": ["Reproductores", "de", "raza", "pura"] } } ] Casos de uso: 1. Búsqueda interactiva en interfaces de usuario 2. Autocompletado de categorías 3. Integración con sistemas de clasificación de mercancías