Preparación para la clasificación

La mutación customsDescriptionValidate comprueba si la información de un artículo es suficiente para asignar con confianza un código HS de 6 dígitos, antes de que se ejecute la clasificación. Devuelve un estado de preparación al que usted aplica su propia política: proceder a clasificar, advertir, pedir más detalles al comprador o comerciante, o rechazar el artículo.

Es una comprobación previa, no una clasificación: customsDescriptionValidate no clasifica el artículo y no devuelve un código HS. Úsela para detectar descripciones escasas o inutilizables desde el principio, de modo que las descripciones que finalmente envíe a Classify produzcan resultados precisos y sin suposiciones.

Sin embargo, la comprobación de preparación es solo uno de los usos posibles. Dado que los mismos datos del artículo alimentan los servicios de descripción aduanera y clasificación de Zonos, esta mutación es el punto de entrada a un flujo de trabajo más amplio de Customs Description: controlar la calidad de los datos y, a continuación, generar una descripción aduanera conforme a partir del artículo. Consulte Más que una puerta de clasificación a continuación.

Estados de preparación 

Cada validación devuelve un status. El estado es orientativo: su integración decide la consecuencia de cada valor.

Cuando el estado es INCOMPLETE, el campo missingAttributes devuelve el atributo o atributos faltantes como una frase breve (p. ej., "fiber content" o "material, construction") adecuada para redactar un mensaje dirigido al usuario. Es null para cualquier otro estado.

Validar un artículo mediante la API 

Proporcione los campos del artículo directamente; se requiere al menos un campo descriptivo. El ejemplo siguiente valida un artículo cuyo nombre y descripción lo identifican como una camiseta pero omiten el contenido de fibra necesario para clasificarlo, por lo que la mutación devuelve INCOMPLETE.

Campos de entrada

Proporcione existingItemId o los campos del artículo directamente; se requiere al menos un campo descriptivo.

Validar un artículo existente 

Si el artículo ya existe en Zonos, pase su ID como existingItemId en lugar de volver a enviar todos los campos. Los campos del artículo almacenado se usan como base para la validación, y cualquier campo que también proporcione en la misma entrada reemplaza los valores almacenados; útil para probar si una edición haría que un artículo escaso esté listo para la clasificación.

El content de la respuesta devuelve los datos del artículo que se validaron, con existingItemId resuelto, de modo que cada CustomsDescriptionValidation almacenada es autodescriptiva.

Más que una puerta de clasificación 

Dado que el estado de preparación es orientativo, la misma comprobación alimenta más de un flujo de trabajo; no se trata solo de decidir si clasificar. customsDescriptionValidate evalúa los mismos datos del artículo que consumen los servicios de clasificación y descripción aduanera de Zonos, lo que la convierte en un primer paso natural en un flujo de trabajo más amplio de Customs Description:

• Puerta de calidad de datos — Detecte información de artículos escasa o inutilizable en el punto de entrada (en un PIM, importación de catálogo o checkout) y solicite exactamente lo que falta usando missingAttributes, antes de que esos datos avancen aguas abajo.
• Generar una descripción aduanera — Una vez que un artículo esté READY, entregue los mismos datos a la mutación customsDescriptionsCreate para que Zonos genere una descripción aduanera concisa y conforme a aduanas y ICS2 a partir del artículo, solicitando opcionalmente un código HS en la misma llamada. Validar la preparación primero significa que la descripción generada se construye a partir de información completa en lugar de suposiciones.
• Clasificar con confianza — Proceda a Classify sabiendo que la descripción es lo suficientemente rica para asignar un código HS de 6 dígitos preciso sin conjeturas.

Un flujo típico de extremo a extremo es: validar la preparación → recopilar cualquier missingAttributes → generar una descripción aduanera conforme (y código HS) → clasificar o presentar.