Agregar o Modificar Productos
Endpoint
Método: POST
URL: https://api.datacrush.la/ecommerce/v1/product/add
Parámetros de consulta
Parámetro |
Tipo |
Descripción |
portal_id |
integer |
Identificador único del portal. Requerido. |
api_key |
string |
Clave de autenticación de la API. Requerido. |
Cuerpo de la solicitud
La solicitud debe enviarse en formato JSON y debe contener un array de objetos de producto.
Estructura del JSON (ejemplo)
[
{
"id": 1,
"title": "Prueba 1",
"url": "http://www.domain.com/product/detail/Pendrive-Synth-8GB/1",
"description": "Pendrive 8GB",
"type": "Book",
"brand": "Apple",
"image_url": "http://www.domain.com/images/1535821480_5b8ac6a85e7fe.jpg",
"keywords": "pendrive,storage",
"variants": [
{
"id": 10,
"title": "Pendrive VARIANTE 1",
"url": "http://www.domain.com/product/detail/Pendrive-Synth-8GB/10",
"sku": "P25.002",
"price": 150,
"promotional_price": 149,
"image_url": "http://www.domain.com/images/1535821480_5b8ac6a85e7fe.jpg",
"stock": 100,
"variant": "Negro"
}
],
"categories": [1,2,3,4]
}
]
Campos del cuerpo de la solicitud
Campo |
Tipo |
Descripción |
id |
integer |
Identificador único del producto. Si el producto ya existe, se actualizará. Si no existe, se creará uno nuevo. |
title |
string |
Nombre del producto. |
url |
string |
URL de referencia del producto. Debe ser un enlace válido y accesible. |
description |
string |
Descripción del producto. |
type |
string |
Tipo de producto. |
brand |
string |
Marca del producto. |
image_url |
string |
URL de la imagen del producto. |
keywords |
string |
Palabras clave relacionadas con el producto, separadas por comas. |
variants |
array |
Lista de variantes del producto. |
categories |
array |
Lista de identificadores de categorías a las que pertenece el producto. |
Campos dentro de variants
Campo |
Tipo |
Descripción |
id |
integer |
Identificador único de la variante. |
title |
string |
Nombre de la variante. |
url |
string |
URL de referencia de la variante. Debe ser un enlace válido. |
sku |
string |
Código SKU de la variante. |
price |
float |
Precio de la variante. |
promotional_price |
float |
Precio de oferta de la variante. |
image_url |
string |
URL de la imagen de la variante. |
stock |
integer |
Cantidad de stock disponible. |
variant |
string |
Atributo que describe la variante (ejemplo: color, tamaño, material). |
Campos dentro de categories
Campo |
Tipo |
Descripción |
categories |
array |
Lista de identificadores numéricos de las categorías a las que pertenece el producto. |
Respuesta
Respuesta exitosa
{
"result": "success"
}
Respuestas de error
Los errores se devuelven en el siguiente formato:
{
"result": "fail",
"error": {
"code": 210,
"message": "Error al decodificar JSON"
},
"error_list": []
}
Código interno |
Mensaje de error |
Descripción |
210 |
"Error al decodificar JSON" |
El formato del JSON enviado es inválido. |
401 |
"No autorizado" |
Falta la clave de la API o es incorrecta. |
403 |
"Acceso denegado" |
El usuario no tiene permisos para esta operación. |
500 |
"Error interno del servidor" |
Ocurrió un error inesperado en el servidor. |
Notas
- La clave api_key es obligatoria para la autenticación.
- Si el id del producto ya existe, se actualizarán sus datos.
- Si el id no existe, se creará un nuevo producto.
- Se pueden enviar varias variantes dentro de variants.
- Se pueden asignar varias categorías a un producto mediante categories.
- Para evitar errores de código 210, asegúrate de enviar el JSON con la estructura correcta.
Comentarios
0 comentarios
El artículo está cerrado para comentarios.