Productos

Buscar…
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
Ejemplo de llamada
El siguiente ejemplo crea un nuevo producto con variaciones
1
{
2
	"sku": "PRUEBA01",
3
	"price": 199.99,
4
	"title": "Artículo de prueba",
5
	"listingTitle": "Artículo de prueba",
6
	"ean": null,
7
	"upc": "41123123",
8
	"longDescription": "Descripcion larga de prueba",
9
	"shortDescription": "Descripción corta de prueba",
10
	"baseStock": 50,
11
	"images": ["https://ventiapp.com/images/venti_botapp.png", "https://ventiapp.com/images/logoventi.png"],
12
	"brand": "Ventiapp",
13
	"model": "MDL01",
14
	"weight": 2400,
15
	"height": 30,
16
	"width": 20,
17
	"depth": 20,
18
	"packageWeight": 2500,
19
	"packageHeight": 34,
20
	"packageWidth": 22,
21
	"packageDepth": 30,
22
	"used": false,
23
	"warranty": "2 meses de fabricante",
24
	"videoUrl": "https://www.youtube.com/watch?v=1rBJd2w1zdM",
25
	"categorySource": "magento",
26
	"categorySourceId" : 123,
27
	"variations": [{
28
		"sku": "AA123-RED-XL",
29
		"ean": null,
30
		"upc": "4112312333",
31
		"stock": 10,
32
		"combinations": [{
33
			"name": "Talla",
34
			"value": "XL"
35
		}, {
36
			"name": "Color",
37
			"value": "Rojo"
38
		}]
39
	}, {
40
		"sku": "AA123-RED-M",
41
		"ean": null,
42
		"upc": "4112312334",
43
		"stock": 8,
44
		"combinations": [{
45
			"name": "Talla",
46
			"value": "M"
47
		}, {
48
			"name": "Color",
49
			"value": "Rojo"
50
		}]
51
	}, {
52
		"sku": "AA123-GREEN-XL",
53
		"ean": null,
54
		"upc": "4112312335",
55
		"stock": 12,
56
		"combinations": [{
57
			"name": "Talla",
58
			"value": "XL"
59
		}, {
60
			"name": "Color",
61
			"value": "Verde"
62
		}]
63
	}, {
64
		"sku": "AA123-GREEN-M",
65
		"ean": null,
66
		"upc": "4112312335",
67
		"stock": 20,
68
		"combinations": [{
69
			"name": "Talla",
70
			"value": "M"
71
		}, {
72
			"name": "Color",
73
			"value": "Verde"
74
		}]
75
	}]
76
}
Copied!
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
Ejemplo de la llamada
El siguiente ejemplo actualiza un producto existente:
1
{
2
	"sku": "PRUEBA01",
3
	"price": 199.99,
4
	"title": "Artículo de prueba",
5
	"listingTitle": "Artículo de prueba"
6
	"ean": null,
7
	"upc": "41123123",
8
	"longDescription": "Descripcion larga de prueba",
9
	"shortDescription": "Descripción corta de prueba",
10
	"baseStock": 50,
11
	"images": ["https://ventiapp.com/images/venti_botapp.png", "https://ventiapp.com/images/logoventi.png"],
12
	"brand": "Ventiapp",
13
	"model": "MDL01",
14
	"weight": 2400,
15
	"height": 30,
16
	"width": 20,
17
	"depth": 20,
18
	"packageWeight": 2500,
19
	"packageHeight": 34,
20
	"packageWidth": 22,
21
	"packageDepth": 30,
22
	"used": false,
23
	"warranty": "2 meses de fabricante",
24
	"videoUrl": "https://www.youtube.com/watch?v=1rBJd2w1zdM",
25
	"categorySource": "magento",
26
	"categorySourceId" : 123,
27
	"OverrideImages": false,
28
	"variations": [{
29
		"ProductVariationId": 9999999, //PONER ESTE CAMPO SI SE DESA ACTUALIZAR VARIACIÓN
30
		"sku": "AA123-RED-XL",
31
		"ean": null,
32
		"upc": "4112312333",
33
		"stock": 10,
34
		"combinations": [{
35
			"name": "Talla",
36
			"value": "XL"
37
		}, {
38
			"name": "Color",
39
			"value": "Rojo"
40
		}]
41
	}, {
42
		"sku": "AA123-RED-M",
43
		"ean": null,
44
		"upc": "4112312334",
45
		"stock": 8,
46
		"combinations": [{
47
			"name": "Talla",
48
			"value": "M"
49
		}, {
50
			"name": "Color",
51
			"value": "Rojo"
52
		}]
53
	}, {
54
		"sku": "AA123-GREEN-XL",
55
		"ean": null,
56
		"upc": "4112312335",
57
		"stock": 12,
58
		"combinations": [{
59
			"name": "Talla",
60
			"value": "XL"
61
		}, {
62
			"name": "Color",
63
			"value": "Verde"
64
		}]
65
	}, {
66
		"sku": "AA123-GREEN-M",
67
		"ean": null,
68
		"upc": "4112312335",
69
		"stock": 20,
70
		"combinations": [{
71
			"name": "Talla",
72
			"value": "M"
73
		}, {
74
			"name": "Color",
75
			"value": "Verde"
76
		}]
77
	}]
78
}
Copied!
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
Body
1
{
2
    "productPicturesAttributes":
3
    [
4
        {
5
            "ProductID": 5024131,
6
            "url": "https://ventiapp.blob.core.windows.net/images/A038C991/ventiapp-image--ebe64bf6-58ed-4fc2-bbd8-449fe13bbc40_28_3_2022_14_39_20_133.jpg",
7
            "attributeValue": "Azul"
8
        },
9
        {
10
            "ProductID": 5024131,
11
            "url": "https://ventiapp.blob.core.windows.net/images/A038C991/ventiapp-image--ebe64bf6-58ed-4fc2-bbd8-449fe13bbc40_28_3_2022_14_39_20_133.jpg",
12
            "attributeValue": "Rojo"
13
        }
14
    ]
15
}
Copied!
attributeValue
Para attributeValue solo las variaciones incluidas en el producto serán válidas.
post
https://ventiapi.azurewebsites.net/api
/products/UpdatePictureProduct
UpdatePictureProduct
Body
1
{
2
    "productPicturesUpdates":
3
    [
4
        {
5
            "productPictureID": 7463574,
6
            "attributeValue": "Azul"
7
        },
8
        {
9
            "productPictureID": 7463577,
10
            "attributeValue": "Rojo"
11
        }
12
    ]
13
}
Copied!
attributeValue
Para attributeValue solo las variaciones incluidas en el producto serán válidas.
get
https://ventiapi.azurewebsites.net/api
/products/GetPicturesProduct
GetPicturesProduct
delete
https://ventiapi.azurewebsites.net/api
/products/RemovePicturesProduct
RemovePicturesProduct
Body
1
{
2
    "id":[
3
        7461375,
4
        7463572,
5
        7463571,
6
        7461374
7
    ]
8
}
Copied!
post
http://localhost:52382/api/products
/UpdateProductDescription
UpdateProductDescription
Body
1
{
2
	"sku": "RG11002",
3
	"productDescriptions": 
4
    [
5
        {
6
        "channel": "meli",
7
        "shortDescription": "",
8
        "longDescription": null
9
        },
10
        {
11
        "channel": "magento",
12
        "longDescription": "Test descripción"
13
        },
14
        {
15
        "channel": "shopify",
16
        "shortDescription": "Test descripción corta3",
17
        "longDescription": "Test descripción larga3"
18
        }
19
    ]
20
}
Copied!