Obtener ficha técnica a partir de productos
Este endpoint crea una tarea para generar un archivo con los campos de ficha técnica de los productos y canales solicitados. Devuelve el ID de la tarea (task_id), que se puede utilizar para consultar el estado de la tarea. Una vez que la tarea esté completa, se enviará un webhook con el topic products-datasheet, incluyendo el ID de la tarea para acceder al informe generado.
El archivo da la siguiente información:
- Indica los campos que ya están completados para cada producto.
- Indica los campos de ficha técnica obligatorios y opcionales para cada producto y por canal.
- Para cada producto, indica a qué canales aplica cada campo.
- En el caso de que el campo requiera algún valor válido, indica el listado de valores del campo aceptados por el marketplace.
A partir de esta información, puedes deducir los campos que faltan completar para cada producto (lo obligatorio menos lo que ya tienes completado).
¡Límite!Se puede generar una vez al día.
Endpoint:
POST https://api.tp.yuju.io/products-datasheet
Body:
Campo | Descripción |
---|---|
id_channel | Lista de ids de los canales |
id_product | Lista de ids de los productos |
Ejemplo:
Solicitar reporte de los campos de ficha técnica de los canales de Mercado Libre y Linio, para los productos con id 987654 y 987655.
{
"id_channel": [13, 15],
"id_product": [987654, 987655],
}
Respuestas:
Respuesta correcta:
{
"status": "CREATED",
"message": "La tarea se encuentra siendo procesada",
"id_task": "fac23de",
"details": {}
}
{
"status": "REJECTED",
"message": "Ya hay una tarea en progreso",
"id_task": null,
"details": {
"current_id_task": "fac23de"
}
}
Ejemplo del contenido de un archivo generado:
[
{
"id_product": 11492753,
"sku_simple": "CE103HUA42",
"sku": "CE103HUA42",
"name": "Huawei P20 Lite 32gb Negro Liberado",
"datasheet": [
{
"name": "type",
"value": null,
"format": "text",
"channel": {
"7": {
"required": false,
"options": []
}
}
},
{
"name": "model",
"value": null,
"format": "text",
"channel": {
"7": {
"required": false,
"options": []
},
"13": {
"required": false,
"options": []
},
"1302": {
"required": false,
"options": []
}
}
},
{
"name": "video_game_platform",
"value": null,
"format": "text",
"channel": {
"13": {
"required": false,
"options": []
}
}
},
......
]
}
]
Consultar el estado de una tarea
Endpoint
GET https://api.tp.yuju.io/products-datasheet/{id_task}
Parámetro | Descripción |
---|---|
id_task | id de la tarea |
Respuesta:
Campo | Descripción |
---|---|
status | Estado de la tarea, posibles valores: CREATED, PROCESSING, COMPLETED, REJECTED, ERROR |
url | Url del archivo generado, únicamente tiene valor cuando la tarea está en estado COMPLETED |
{
"status": "PROCESSING",
"url": "https\://..../file.json"
}
Updated about 1 month ago