Validación de categorías
Las categorías de producto describen qué es un artículo, normalmente como una jerarquía desde una raíz amplia hasta una hoja específica — por ejemplo, ["Footwear", "Athletic", "Running Shoes"]. Las categorías precisas mantienen su catálogo limpio y alimentan procesos posteriores como la clasificación y el cumplimiento comercial, donde un artículo mal categorizado puede producir el resultado incorrecto.
Los catálogos acumulan errores de categoría con el tiempo — por entrada manual, feeds de proveedores o migraciones entre sistemas. Zonos Category Validation comprueba si las categorías asignadas a un artículo realmente describen ese artículo y, cuando no es así, sugiere mejores categorías extraídas de las categorías que su organización ya utiliza.
Cómo funciona
Zonos Category Validation utiliza IA para determinar si la jerarquía de categorías que proporciona describe correctamente un artículo, según el name del artículo y cualquier detalle adicional que proporcione, como brand, material y description.
Para cada artículo devuelve un verdict de CORRECT o WRONG junto con una puntuación de confianza. Cuando el veredicto es WRONG, devuelve una lista ordenada de categorías sugeridas para que pueda corregir la asignación. Las sugerencias se extraen del árbol de categorías de su organización — el conjunto de rutas de categoría que utiliza su organización — y cualquier categoría que envíe se agrega a ese árbol automáticamente, de modo que un árbol bien mantenido produce mejores sugerencias con el tiempo.
Este es un endpoint por lotes — puede validar muchos artículos en una sola solicitud y los resultados se devuelven en el mismo orden que la entrada.
Veredicto y confianza
Cada resultado incluye un verdict:
CORRECT— el artículo pertenece de forma plausible a las categorías asignadas.WRONG— el artículo no pertenece a las categorías asignadas.
Cada resultado también incluye un confidenceScore entre 0.0 y 1.0 que indica la confianza del modelo en el veredicto devuelto. La puntuación refleja la certeza en el veredicto en sí, de modo que un resultado WRONG con alta confianza tiene un confidenceScore alto, igual que uno CORRECT con alta confianza. Cuando el veredicto es WRONG, la lista suggestedCategories contiene jerarquías de categoría alternativas, cada una con un valor de confidence y ordenadas de más a menos probable. Cuando el veredicto es CORRECT, suggestedCategories está vacía.
Recomendamos utilizar la puntuación de confianza para decidir qué resultados aceptar automáticamente y cuáles enviar a revisión manual.
Validar categorías
Para validar categorías, utilice la mutación categoriesValidate. Cada artículo requiere un name y la jerarquía de categories a validar. Puede incluir opcionalmente brand, material, description, amount, currencyCode, globalTradeItemNumber e imageUrl para mejorar la precisión. Envíe varios artículos en una sola solicitud para validar en lote.
mutation CategoriesValidate($input: [CategoryValidateInput!]!) { categoriesValidate(input: $input) { id name categories verdict confidenceScore suggestedCategories { category confidence } }}En el ejemplo anterior, las categorías del primer artículo se confirman como CORRECT con alta confianza y sin sugerencias. El segundo artículo se marca con confianza como WRONG, y la lista suggestedCategories propone categorías que encajan mejor, ordenadas por confianza.
Gestionar su árbol de categorías
El árbol de categorías de su organización es el conjunto de rutas de categoría que Zonos sabe que su organización utiliza. Category Validation extrae sus suggestedCategories de este árbol, por lo que mantenerlo preciso y completo mejora directamente la calidad de las sugerencias. Las categorías que envíe a categoriesValidate se agregan al árbol automáticamente, pero también puede gestionarlo directamente.
Cada categoría es una jerarquía almacenada como un array path, desde la raíz amplia hasta la hoja específica — por ejemplo, ["Footwear", "Athletic", "Running Shoes"].
Listar sus categorías
Utilice la consulta categories para recuperar el árbol de categorías de su organización. Los resultados están paginados.
query Categories { categories(first: 50) { totalCount edges { node { id path } } }}Agregar categorías
Utilice la mutación categoriesCreate para agregar una o más rutas de categoría a su árbol. Esto es útil para preparar el árbol antes de la validación, de modo que las sugerencias puedan basarse en su taxonomía completa.
mutation CategoriesCreate($input: [CategoryCreateInput!]!) { categoriesCreate(input: $input) { id path }}Actualizar o eliminar categorías
Utilice la mutación categoryUpdate para corregir el path de una categoría por su id, o la mutación categoryDelete para eliminar una categoría que ya no aplique. Podar categorías obsoletas o incorrectas mantiene las sugerencias relevantes.
mutation CategoryUpdate($input: CategoryUpdateInput!) { categoryUpdate(input: $input) { id path }}Para eliminar una categoría, pase su id a la mutación categoryDelete. Devuelve SUCCESS o FAILURE.
mutation CategoryDelete($id: ID!) { categoryDelete(id: $id)}
Category Validation
Compruebe si las categorías asignadas a un artículo encajan con el producto y obtenga mejores sugerencias de categoría cuando no sea así.