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_channels | Lista de ids de los canales |
id_products | 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_channels": [13, 15],
"id_products": [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 8 months ago