Campos de entrada
Aunque solo se requiere una descripción para generar una clasificación, cuantos más detalles del producto proporcione, más precisa será su clasificación. Alternativamente, puede proporcionar simplemente una URL de producto y Classify extraerá automáticamente todos los detalles relevantes del artículo. A continuación se ofrece una explicación completa de cada campo de entrada aceptado por Classify. Al comprender estos campos de entrada, puede maximizar su uso y generar clasificaciones altamente precisas.
Descripción de los campos de entrada
| Campo↕ | Descripción↕ |
|---|---|
| Nombre (obligatorio) | El nombre del producto |
| URL del producto (opcional) | Pegue una URL de producto y Classify obtendrá automáticamente la página y extraerá los detalles relevantes del artículo (nombre, descripción, categorías, etc.) para la clasificación. Disponible en Dashboard haciendo clic en el icono + o agregándola directamente en el campo de texto principal. Para integraciones de API, contacte a su representante de Zonos. Aunque es ideal para demostraciones y pruebas, las implementaciones de producción logran un rendimiento y una eficiencia de costos óptimos al pasar los datos del artículo directamente desde los sistemas backend. |
| Descripción (opcional) | Una descripción detallada y extensa del producto |
| URL de imagen (opcional) | Enlace a una imagen del producto. Nota: Asegúrese de utilizar un enlace a la URL real de la imagen y no a la URL de la página del producto |
| Categorías (opcional) | Subcategorías generales del producto, p. ej., Clothing & Accessories, Pet Supplies, Office Products o Baby Clothes, Pet Beds, Adhesives & Tape |
| Material (opcional) | De qué está hecho el producto, p. ej., plastic, wood, steel |
| País de origen (opcional) | La abreviatura de dos letras (código ISO) del país de fabricación o producción del producto |
| Código HS proporcionado (opcional) | Incluya un código HS existente en su solicitud de clasificación para guiar su solicitud. Según su preferencia y el origen de su código HS proporcionado, Classify puede validar el código HS y comprobar su coherencia con los detalles de descripción del artículo. Más información. |
| País de destino (opcional) | Identifica a qué país se clasificará el producto. El país de destino debe mostrarse con la abreviatura de dos letras (código ISO) de cada país y no con el nombre real del país, p. ej., AU, no Australia. Incluir este campo permite que Classify devuelva un código HS específico por país de 8+ dígitos en lugar del código universal de 6 dígitos. Obtenga más información sobre las diferencias entre códigos HS universales y específicos por país. |
| ID de producto (opcional) | Su ID de producto o cualquier número que pueda utilizarse para identificar de forma única cada producto. Si no se proporciona un ID de producto, Classify asignará IDs de producto comenzando por 1 |
Nota: Si carga su CSV de solicitud masiva en Dashboard, el país de destino no formará parte de la plantilla; en su lugar, seleccionará sus países de destino después de cargar su CSV de solicitud masiva.
Solicitar una clasificación
Para solicitar una clasificación en Dashboard o mediante la API, siga los pasos y la mutación que se indican a continuación.
El ejemplo siguiente muestra una solicitud universal (6 dígitos). Para solicitar clasificaciones para países específicos, agregue los códigos ISO de los países en la solicitud de Classify como se muestra en el ejemplo siguiente. Para solicitar un código HS universal, deje el país de destino como null en la solicitud de Classify.
La entrada acepta una lista, por lo que puede solicitar muchas clasificaciones o una sola a la vez.
Nota: Para generar pistas de auditoría mediante la API, incluya el campo
auditTrailen su consulta. Contacte a su representante de Zonos para acceso y detalles de implementación.
mutation ClassifyItems($input: [ClassificationCalculateInput!]!) { classificationsCalculate(input: $input) { id name categories imageUrl hsCode { code description { full } } }}Posibles respuestas de la API
Cuando Classify recibe una solicitud de clasificación, intenta hacer coincidir los datos del artículo incluidos en la solicitud con una coincidencia en la base de datos de Classify según la puntuación de confianza más alta. Según lo que encuentre, Classify devolverá una de las siguientes respuestas:
- Cuando se devuelve
hsCodecon un código HS de 6 a 8+ dígitos, según si se incluyó o no un país de destino en la solicitud, su solicitud de clasificación fue exitosa. - Cuando se devuelve
{"errors": [ { "message": "No adequate response"}]}, significa que Classify no pudo encontrar una clasificación debido a información de entrada insuficiente.
Clasificar artículos
Aprenda a solicitar una clasificación en Dashboard y mediante la API.
A continuación encontrará ejemplos que ilustran cómo solicitar clasificaciones universales y específicas por país a través de Dashboard o mediante la API. Para quienes buscan detalles técnicos más completos y documentación extensa, visite nuestro sitio de referencia para desarrolladores de la API GraphQL de Zonos. Este recurso completo ofrece información detallada sobre endpoints de API, mutaciones GraphQL y documentación técnica extensa.