Ventiapp
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!
Última actualización 16d ago