Campos de entrada
Si bien solo se requiere una descripción para generar una clasificación, cuanto más detalles del producto proporcione, más precisa será su clasificación. A continuación se presenta 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.
Descripciones de los campos de entrada
Campo | Descripción |
---|---|
Nombre (requerido) | El nombre del producto |
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 usar un enlace a la URL de la imagen real y no a la URL de la página del producto |
Categorías (opcional) | Subcategorías generales del producto, por ejemplo, Ropa y Accesorios, Suministros para Mascotas, Productos de Oficina o Ropa de Bebé, Camas para Mascotas, Adhesivos y Cinta |
Material (opcional) | De qué está hecho el producto, por ejemplo, plástico, madera, acero |
País de origen (opcional) | La abreviatura de dos letras (código ISO) para el 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. Dependiendo de su preferencia y del origen de su código HS proporcionado, Classify puede validar el código HS y verificar su coherencia con los detalles de la descripción del artículo. Aprenda más. |
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, por ejemplo, AU, no Australia. Incluir este campo permitirá que Classify devuelva un código HS específico de país de 8+ dígitos en lugar del código universal de 6 dígitos. Aprenda más sobre las diferencias entre códigos HS universales y específicos de país. |
ID del producto (opcional) | Su ID de producto o cualquier número que se pueda usar para identificar de manera única cada producto. Si no se proporciona un ID de producto, Classify asignará IDs de producto comenzando desde 1 |
Nota: Si está subiendo su CSV de solicitud masiva en Dashboard, el país de destino no será parte de la plantilla, sino que 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 a través de API, siga los pasos y la mutación a continuación.
El ejemplo a continuación muestra una solicitud universal (de 6 dígitos). Para solicitar clasificaciones a países específicos, agregue los 'códigos ISO' de los países en la solicitud de Classify como se ve en el ejemplo a continuación. Para solicitar un código HS universal, deje el país de envío como null
en la solicitud de Classify.
La entrada acepta una lista, por lo que puede solicitar muchas o una sola clasificación a la vez.
MUTACIÓN
GraphQL
mutation {
classificationsCalculate(
input: [
{
categories: "women's clothing"
imageUrl: "https://zonos.com/images/cozygloves.webp"
name: "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
configuration: { shipToCountries: KR }
}
]
) {
id
name
categories
imageUrl
hsCode {
code
description {
full
}
}
}
}
RESPUESTA
JSON
{
"data": {
"classificationsCalculate": [
{
"id": "classification_313d8d9d-e330-4d79-9922-cb7a1ff317e2",
"name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter",
"categories": ["women's clothing"],
"imageUrl": null,
"hsCode": {
"code": "6116.99.0000",
"description": {
"full": "Articles of apparel and clothing accessories, knitted or crocheted: Gloves, mittens and mitts, knitted or crocheted: Other : Of other textile materials"
}
}
}
]
}
}
Posibles respuestas de la API
Cuando Classify recibe una solicitud de clasificación, intenta hacer coincidir los datos del artículo de entrada incluidos en la solicitud con una coincidencia en la base de datos de Classify's basada en el puntaje de confianza más alto. Según lo que se encuentre, Classify devolverá una de las siguientes respuestas:
- Cuando se devuelve
hsCode
con un código HS de 6 a 8+ dígitos, dependiendo de si se incluyó o no un país de envío en la solicitud, su solicitud de clasificación fue exitosa. - Cuando se devuelve
{"errors": [ { "message": "No adequate response"}]}
, eso significa que Classify no pudo encontrar una clasificación debido a información de entrada insuficiente.
Clasificación de artículos
Aprenda cómo solicitar una clasificación en Dashboard y a través de API.
A continuación, encontrará ejemplos que ilustran cómo solicitar clasificaciones universales y específicas de cada país a través de Dashboard o mediante API. Para aquellos que buscan detalles técnicos más completos y documentación extensa, visite nuestro Zonos GraphQL API reference developer site. Este recurso integral ofrece información detallada sobre los puntos finales de la API, mutaciones de GraphQL y extensa información técnica.