#
/products
POST
v1
Crear o modificar un producto.
{
"code": "N30123",
"title": "Zapatillas deportivas urbanas para hombre – modelo AirFlow",
"description": "Estas zapatillas combinan estilo y comodidad para el uso diario. Diseñadas con materiales transpirables, suela de goma antideslizante y plantilla ergonómica, son ideales tanto para caminar por la ciudad como para entrenar en interiores. El modelo AirFlow ofrece un ajuste perfecto y un diseño moderno que se adapta a cualquier look casual. Disponibles en varias tallas y colores.",
"price": {
"amount": "49.95",
"currency": "EUR"
},
"attributes": [
{"title": "Material", "value": "Cuero"},
{"title": "Color", "value": "negro con detalles en gris"},
{"title": "Tallas disponibles", "value": "39, 40, 41, 42, 43, 44"},
{"title": "Suela", "value": "goma antideslizante"},
{"title": "Peso", "value": "850g (par, talla 42)"},
{"title": "Uso recomendado", "value": "Uso diario y entrenamiento ligero"}
],
"brand": {
"code": "OW142302",
"name": "Nike"
},
"category": {
"code": "MC418292",
"title": "Zapatillas deportivas",
"description": "Calzado diseñado para ofrecer comodidad, soporte y rendimiento en actividades físicas o deportivas. Estas zapatillas también se adaptan al uso urbano y diario gracias a sus diseños modernos y materiales versátiles. Incluyen características como suelas antideslizantes, tejidos transpirables y estilos que combinan funcionalidad con moda."
},
"imageUrl": "https://m.media-amazon.com/images/I/61cELGQXXhL._AC_UL320_.jpg",
"metadata": {
"videoUrl": "https://m.media-amazon.com/videos/C/dk14lkKlsnw._AC_UL1080_.mp4",
"currentDiscountRate": "50%",
"isNew": true,
"isFeatured": false
}
}
- code
- Código de producto, por ejemplo
N39291
255 - isActive
- Indica si el producto está habilitado para ser utilizado por los servicios de Biteral, como recomendaciones, búsqueda o análisis. Si no se incluye este campo al enviar o actualizar el producto, se asume automáticamente que el producto está activo
true
. Poner isActive afalse
permite mantener el producto en el sistema sin que participe en ningún procesamiento o resultado de los servicios. - title
- Título del producto. 10000
- description
- Descripción del producto. 60000
- price
El precio del producto. Un objeto JSON donde amount es el precio del producto, y currency es la moneda en la que se expresa el precio, según el estándar ISO 4217. Por ejemplo:
{ "amount": "49.95", "currency": "EUR" }
- attributes
Los atributos del producto. Un array de objetos JSON donde title 255 es el título del atributo y value 60000 es su valor. Por ejemplo:
[ {"title": "Material", "value": "Cuero"}, {"title": "Color", "value": "negro con detalles en gris"}, {"title": "Tallas disponibles", "value": "39, 40, 41, 42, 43, 44"}, {"title": "Suela", "value": "goma antideslizante"}, {"title": "Peso", "value": "850g (par, talla 42)"}, {"title": "Uso recomendado", "value": "Uso diario y entrenamiento ligero"}, ]
- brand
La marca del producto. Un objeto JSON donde code 255 es el código de la marca y name 255 su nombre. Por ejemplo:
{ "code": "OW142398", "name": "Nike" }
- category
La categoría del producto. Un objeto JSON donde code 255 es el código de la categoría, title 255 el título y description 60000 su descripción. Por ejemplo:
{ "code": "MC418298", "title": "Zapatillas deportivas", "description": "Calzado diseñado para ofrecer comodidad, soporte y rendimiento en actividades físicas o deportivas. Estas zapatillas también se adaptan al uso urbano y diario gracias a sus diseños modernos y materiales versátiles. Incluyen características como suelas antideslizantes, tejidos transpirables y estilos que combinan funcionalidad con moda." }
- imageUrl
- La URL de la imagen del producto, preferiblemente una imagen de aproximadamente 600 píxeles de ancho. Por ejemplo:
https://m.media-amazon.com/images/I/61cELGQXXhL._AC_UL320_.jpg
- metadata
Datos adicionales que te resulten útiles cuando recibas el producto como resultado de las herramientas de Biteral. Un objeto JSON 60000 . Por ejemplo:
{ "videoUrl": "https://m.media-amazon.com/videos/C/dk14lkKlsnw._AC_UL1080_.mp4", "currentDiscountRate": "50%", "isNew": true, "isFeatured": false }
#
Actualizar un producto
Para actualizar los datos sobre un producto, realiza la misma petición POST
a este endpoint con los nuevos datos.
Los datos que no especifiques mantendrán su valor anterior. Para eliminar un dato, pásalo como null
Si actualizas los datos de un producto que está desactivado y deseas que siga desactivado, debes volver a enviar explícitamente
isActive
como false
en la petición. Esto se debe a que el valor por defecto de
isActive
es true
cuando no lo especificas en tus peticiones.
#
Cargar varios productos a la vez
Puedes cargar los productos uno a uno, pero es más rápido cargarlos en bloques. Para hacerlo, pasa los productos en forma de un array, por ejemplo:
[
{
"code": "N30123",
"title": "Zapatillas deportivas urbanas para hombre – modelo AirFlow",
"description": "Estas zapatillas combinan estilo y comodidad para el uso diario. Diseñadas con materiales transpirables, suela de goma antideslizante y plantilla ergonómica, son ideales tanto para caminar por la ciudad como para entrenar en interiores. El modelo AirFlow ofrece un ajuste perfecto y un diseño moderno que se adapta a cualquier look casual. Disponibles en varias tallas y colores.",
"price": {
"amount": "49.95",
"currency": "EUR"
}
},
{
"code" : "J481955"
...
},
...
]
Puedes cargar hasta 100 productos a la vez utilizando este método