Documentación

Obtener ficha técnica a partir de productos

Suggest Edits

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:

CampoDescripción
id_channelLista de ids de los canales
id_productLista 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ámetroDescripción
id_taskid de la tarea

Respuesta:

CampoDescripción
statusEstado de la tarea, posibles valores: CREATED, PROCESSING, COMPLETED, REJECTED, ERROR
urlUrl del archivo generado, únicamente tiene valor cuando la tarea está en estado COMPLETED
{  
   "status": "PROCESSING",  
   "url": "https\://..../file.json"  
}

Updated 5 months ago