Productos
En esta sección se encuentran las API's referentes a creación, edición y eliminación de Productos. Esta información solamente actualizará la información base dentro de Ventiapp.
post
https://ventiapi.azurewebsites.net/api
/products/addproduct
Add Product
Update 1.3.0
variations: Contiene la información específica de cada variación, la limitante es hasta 2 combinaciones
model: Modelo del item
packageWeight: Peso del producto empaquetado
packageHeight: Altura del producto empaquetado
packageWidth: Ancho del producto empaquetado
packageDepth: Profundidad del producto empaquetado
warranty: Descripción de la garantía
videoUrl: URL del video (solo se soporta YouTube y aplica para algunos canales disponibles)
Update 1.3.8
categorySource: Canal original para mapear la categoría
categorySourceId: Id de categoría del canal original
El siguiente ejemplo crea un nuevo producto con variaciones
{
"sku": "PRUEBA01",
"price": 199.99,
"title": "Artículo de prueba",
"listingTitle": "Artículo de prueba",
"ean": null,
"upc": "41123123",
"longDescription": "Descripcion larga de prueba",
"shortDescription": "Descripción corta de prueba",
"baseStock": 50,
"images": ["https://ventiapp.com/images/venti_botapp.png", "https://ventiapp.com/images/logoventi.png"],
"brand": "Ventiapp",
"model": "MDL01",
"weight": 2400,
"height": 30,
"width": 20,
"depth": 20,
"packageWeight": 2500,
"packageHeight": 34,
"packageWidth": 22,
"packageDepth": 30,
"used": false,
"warranty": "2 meses de fabricante",
"videoUrl": "https://www.youtube.com/watch?v=1rBJd2w1zdM",
"categorySource": "magento",
"categorySourceId" : 123,
"variations": [{
"sku": "AA123-RED-XL",
"ean": null,
"upc": "4112312333",
"stock": 10,
"combinations": [{
"name": "Talla",
"value": "XL"
}, {
"name": "Color",
"value": "Rojo"
}]
}, {
"sku": "AA123-RED-M",
"ean": null,
"upc": "4112312334",
"stock": 8,
"combinations": [{
"name": "Talla",
"value": "M"
}, {
"name": "Color",
"value": "Rojo"
}]
}, {
"sku": "AA123-GREEN-XL",
"ean": null,
"upc": "4112312335",
"stock": 12,
"combinations": [{
"name": "Talla",
"value": "XL"
}, {
"name": "Color",
"value": "Verde"
}]
}, {
"sku": "AA123-GREEN-M",
"ean": null,
"upc": "4112312335",
"stock": 20,
"combinations": [{
"name": "Talla",
"value": "M"
}, {
"name": "Color",
"value": "Verde"
}]
}]
}
Crear un producto sin variaciones
Para crear un producto sin variaciones el campo: ''variations" deberá estar vacío, o simplemente no deberá ser incluido.
post
https://ventiapi.azurewebsites.net/api
/products/updateproduct/{id} o {parentSku}
Update Product
El siguiente ejemplo actualiza un producto existente:
{
"sku": "PRUEBA01",
"price": 199.99,
"title": "Artículo de prueba",
"listingTitle": "Artículo de prueba"
"ean": null,
"upc": "41123123",
"longDescription": "Descripcion larga de prueba",
"shortDescription": "Descripción corta de prueba",
"baseStock": 50,
"images": ["https://ventiapp.com/images/venti_botapp.png", "https://ventiapp.com/images/logoventi.png"],
"brand": "Ventiapp",
"model": "MDL01",
"weight": 2400,
"height": 30,
"width": 20,
"depth": 20,
"packageWeight": 2500,
"packageHeight": 34,
"packageWidth": 22,
"packageDepth": 30,
"used": false,
"warranty": "2 meses de fabricante",
"videoUrl": "https://www.youtube.com/watch?v=1rBJd2w1zdM",
"categorySource": "magento",
"categorySourceId" : 123,
"OverrideImages": false,
"variations": [{
"ProductVariationId": 9999999, //PONER ESTE CAMPO SI SE DESA ACTUALIZAR VARIACIÓN
"sku": "AA123-RED-XL",
"ean": null,
"upc": "4112312333",
"stock": 10,
"combinations": [{
"name": "Talla",
"value": "XL"
}, {
"name": "Color",
"value": "Rojo"
}]
}, {
"sku": "AA123-RED-M",
"ean": null,
"upc": "4112312334",
"stock": 8,
"combinations": [{
"name": "Talla",
"value": "M"
}, {
"name": "Color",
"value": "Rojo"
}]
}, {
"sku": "AA123-GREEN-XL",
"ean": null,
"upc": "4112312335",
"stock": 12,
"combinations": [{
"name": "Talla",
"value": "XL"
}, {
"name": "Color",
"value": "Verde"
}]
}, {
"sku": "AA123-GREEN-M",
"ean": null,
"upc": "4112312335",
"stock": 20,
"combinations": [{
"name": "Talla",
"value": "M"
}, {
"name": "Color",
"value": "Verde"
}]
}]
}
Ejemplos de URL de llamada
Si llamas con ID de producto (ej: 777122):
https://ventiapi.azurewebsites.net/api/products/updateproduct/777122
Si llamas con SKU Base (ej: PROD-BASE-01)
https://ventiapi.azurewebsites.net/api/products/updateproduct/?parentSku=PROD-BASE-01
Si el campo listingTitle no se requiere actualizar, deberá estar vacío, o simplemente no deberá ser incluido.
delete
https://ventiapi.azurewebsites.net/api
/products/deleteproduct/{id}
Delete Product
Ejemplos de URL de llamada
Si llamas con ID de producto (ej: 777122):
https://ventiapi.azurewebsites.net/api/products/deleteproduct/777122
Si llamas con SKU Base (ej: PROD-BASE-01)
https://ventiapi.azurewebsites.net/api/products/deleteproduct/?parentSku=PROD-BASE-01
Deberás tener cuidado con esta operación, ya que no se puede deshacer.
get
https://ventiapi.azurewebsites.net/api
/products/list
List Products
get
https://ventiapi.azurewebsites.net/api
/products/find/{id}
Find product
post
https://ventiapi.azurewebsites.net/api
/products/AddPictureProduct
AddPictureProduct
{
"productPicturesAttributes":
[
{
"ProductID": 5024131,
"url": "https://ventiapp.blob.core.windows.net/images/A038C991/ventiapp-image--ebe64bf6-58ed-4fc2-bbd8-449fe13bbc40_28_3_2022_14_39_20_133.jpg",
"attributeValue": "Azul"
},
{
"ProductID": 5024131,
"url": "https://ventiapp.blob.core.windows.net/images/A038C991/ventiapp-image--ebe64bf6-58ed-4fc2-bbd8-449fe13bbc40_28_3_2022_14_39_20_133.jpg",
"attributeValue": "Rojo"
}
]
}
attributeValue
Para attributeValue solo las variaciones incluidas en el producto serán válidas.
post
https://ventiapi.azurewebsites.net/api
/products/UpdatePictureProduct
UpdatePictureProduct
{
"productPicturesUpdates":
[
{
"productPictureID": 7463574,
"attributeValue": "Azul"
},
{
"productPictureID": 7463577,