#
/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",
"url": "https://www.amazon.es/Hitmars-Zapatillas-Deportivas-Transpirables-Sneakers/dp/B0CYGMZVL7",
"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
N39291255 - 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 afalsepermite 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 - url
- La URL pública del producto. Por ejemplo:
https://www.amazon.es/Hitmars-Zapatillas-Deportivas-Transpirables-Sneakers/dp/B0CYGMZVL7 - 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
#
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
Cuando cargas muchos productos a Biteral muy rápidamente, puede pasar un rato hasta que todos están disponibles para las herramientas de Biteral.