# Productos
## Add Product
`POST` `https://ventiapi.azurewebsites.net/api/products/addproduct`
Este método se utiliza para crear un producto base en Ventiapp. Si los campos requeridos no están disponibles el servicio arrojará error.
#### Headers
| Name | Type | Description |
| -------------- | ------ | -------------- |
| Authentication | string | Bearer + token |
#### Request Body
| Name | Type | Description |
| ---------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------- |
| SKU | string | Stock Keeping Unit: Identificador del producto, este ID es requerido. Si no lo tiene, se recomienda que sea el ID de su ERP. |
| title | string | Título del producto. |
| price | number | Precio base del producto, este es el precio que será utilizado cuando el producto se publique por primera vez en los canales. |
| weight | number | Peso del producto en gramos. |
| height | number | Alto del producto en centímetros. |
| width | number | Ancho del producto en centímetros. |
| depth | number | Profundidad del producto en centímetros. |
| brand | string | Marca del producto. |
| EAN | string | Identificador EAN13 del producto. |
| UPC | string | Identificador UPC del producto. |
| longDescription | string | Descripción larga del producto (default). |
| shortDescription | string | Descripción corta del producto. |
| baseStock | integer | Stock base del producto, este es el inventario que será utilizado cuando el producto se publique por primera vez en los canales. |
| images | array | Array de strings que contiene las url de las imágenes (La imagen será descargada y asignada al producto) |
| listingTitle | String | Utiliza este título para publicar en los Marketplaces ( MercadoLibre, Linio, Amazon) |
{% tabs %}
{% tab title="200 Producto creado correctamente, en los detalles se retorna el id del producto recién creado." %}
```javascript
{
"status": "Success",
"code": "PROC-ADDP-S-1",
"message": "product was created successfully",
"details": [
{
"severity": "Success",
"code": "product.created",
"reason": "Product created succesfully, id: 123456"
}
]
}
```
{% endtab %}
{% tab title="400 El producto no pudo ser creado, los detalles indican el motivo y estos varían dependiendo del error encontrado." %}
```
{
"status": "Error",
"code": "PROC-ADDP-E-1",
"message": "Product data has some errors, check the details for more information",
"details": [
{
"severity": "Error",
"code": "sku.duped",
"reason": "There's already a product with that value, change it"
}
]
}
```
{% endtab %}
{% tab title="500 Indica un error interno al procesar la información, es este caso deberás comunicarte con soporte" %}
```
```
{% endtab %}
{% endtabs %}
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
```javascript
{
"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,
"attributes": [
{
"id": "GENDER",
"value": "Mujer"
},
{
"id": "FOOTWEAR_TYPE",
"value": "Mocasines"
}
],
"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"
}]
}]
}
```
{% hint style="info" %}
**Crear un producto sin variaciones**
Para crear un producto sin variaciones el campo: **''variations"** deberá estar vacío, o simplemente no deberá ser incluido.
{% endhint %}
## Update Product
`POST` `https://ventiapi.azurewebsites.net/api/products/updateproduct/{id} o {parentSku}`
Actualiza el producto base existente en Ventiapp\
#### Path Parameters
| Name | Type | Description |
| -------------- | ------- | ----------------------------------------------------- |
| parentSku | string | SKU Base del producto a editar |
| id | integer | Id del product
|
| cleanProduct | boolean | Limpia el producto de variaciones e imágenes |
| updateChannels | boolean | Actualiza los canales publicados (Solo Mercado Libre) |
#### Request Body
| Name | Type | Description |
| ---------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| SKU | string | SKU del producto, si no se especifica el SKU original del producto este será modificado, en caso de que se especifique uno distinto, **este deberá ser diferente a alguno existente en tu catalogo de productos.** |
| Price | number | Precio del producto, **este valor se utiliza cuando el producto se publica por primera vez.** |
| Title | string | Título del producto, **este valor se utiliza cuando el producto se publica por primera vez en los canales.** |
| EAN | string | Identificador EAN del producto. |
| UPC | string | Identificador UPC del producto. |
| LongDescription | string | Descripción larga del producto. |
| ShortDescription | string | Descripción corta del producto. |
| BaseStock | integer | Cantidad de inventario inicial, **este valor se utiliza cuando el producto se publica por primera vez en los canales.** |
| Images | array | Arreglo con las urls de las imágenes. |
| Brand | string | Marca del producto. |
| Model | string | Modelo del producto |
| Weight | number | Peso del producto. |
| Height | number | Alto del producto. |
| Width | number | Ancho del producto. |
| Depth | number | Profundidad del producto. |
| PackageWeight | number | Peso del producto empaquetado. |
| PackageHeight | number | Alto del producto empaquetado. |
| PackageWidth | number | Ancho del producto empaquetado. |
| PackageDepth | number | Profundidad del producto empaquetado. |
| Used | boolean | Indica que el producto esta usado, al no especificar este campo se indica que el producto es nuevo. |
| Warry | string | Garantía del producto. |
| VideoUrl | string | Url de video, solo se soporta youtube y aplica a ciertos canales de ecommerce/marketplace aptos. |
| Variations | array | Arreglo con los datos de las variaciones. |
| OverrideImages | boolean | Indica si se sobreescribirán las imágenes del producto. |
| listingTitle | String | Utiliza este título para publicar en los Marketplaces ( MercadoLibre, Linio, Amazon), si no se requiere actualizar, deberá estar vacío, o simplemente no deberá ser incluido. |
{% tabs %}
{% tab title="200 Esta es la respuesta que devuelve el servidor cuando un producto ha sido modificado con éxito." %}
```
{
"status": "Success",
"code": "PROC-MODP-S-1",
"message": "product was modified successfully",
"details": []
}
```
{% endtab %}
{% tab title="400 Este error ocurre cuando la información no puede ser procesada hasta que se corrija el error mostrado en la llamada." %}
```
{
"status": "Error",
"code": "PROC-MODP-E-1",
"message": "Product data has some errors and was not modified, check the details for more information",
"details": [
{
"severity": "Error",
"code": "sku.required",
"reason": "Value cannot be null or empty"
}
]
}
```
{% endtab %}
{% tab title="500 Indica un error interno, en este caso deberás ponerte en contacto con soporte." %}
```
```
{% endtab %}
{% endtabs %}
#### Ejemplo de la llamada
El siguiente ejemplo actualiza un producto existente:
```json
{
"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,
"attributes": [
{
"id": "GENDER",
"value": "Mujer"
},
{
"id": "FOOTWEAR_TYPE",
"value": "Mocasines"
}
],
"productPicturesAttributes": [
{
"stringBase64": "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",
"attributeValue": "Azul"
},
{
"url": "https://ventiapp.blob.core.windows.net/images/A038C991/988ea3c1.png",
"attributeValue": "Rojo",
"order": 3
}
],
"productDescriptions": [
{
"channel": "woocommerce",
"shortDescription": "Woo: Es de Insomniac Games originalmente.",
"longDescription": "Woo: Es de Insomniac Games originalmente pero el remake lo hizo Toys for Bob."
},
{
"channel": "shopify",
"shortDescription": "Sho: Es de Insomniac Games originalmente.",
"longDescription": "Sho: Es de Insomniac Games originalmente pero el remake lo hizo Toys for Bob."
}
],
"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"
}]
}]
}
```
{% hint style="warning" %}
Ejemplos de URL de llamada \
\
Si llamas con ID de producto (ej: 777122):\
Si llamas con SKU Base (ej: PROD-BASE-01)
Si el campo listingTitle no se requiere actualizar, deberá estar vacío, o simplemente no deberá ser incluido.
{% endhint %}
## Delete Product
`DELETE` `https://ventiapi.azurewebsites.net/api/products/deleteproduct/{id}`
#### Path Parameters
| Name | Type | Description |
| ---- | ------ | --------------- |
| id | number | Id del producto |
{% tabs %}
{% tab title="200 Indica que el producto se elimino correctamente" %}
```
{
"status": "Success",
"code": "PROC-DELP-S-1",
"message": "The current operation was successful",
"details": []
}
```
{% endtab %}
{% tab title="400 Indica el motivo por el cual no se pudo eliminar el producto indicado" %}
```
{
"status": "Error",
"code": "PROC-DELP-E-1",
"message": "The current operation wasn't successful, check details for more information",
"details": [
{
"severity": "Error",
"code": "product.notfound",
"reason": "This product is not existent"
},
{
"severity": "Error",
"code": "product.notowned",
"reason": "This product belongs to a different user"
}
]
}
```
{% endtab %}
{% endtabs %}
{% hint style="warning" %}
Ejemplos de URL de llamada \
\
Si llamas con ID de producto (ej: 777122):\
Si llamas con SKU Base (ej: PROD-BASE-01)
{% endhint %}
{% hint style="danger" %}
Deberás tener cuidado con esta operación, ya que no se puede deshacer.
{% endhint %}
## List Products
`GET` `https://ventiapi.azurewebsites.net/api/products/list`
Esta operación lista a todos los productos de la cuenta, también se pueden filtrar
#### Path Parameters
| Name | Type | Description |
| ------ | ------ | --------------------------------------------------------- |
| offset | int | Offset para paginación |
| paging | int | Tamaño de página, máximo 50 |
| sort | string | Ordenación de resultados, posibles: alph\_asc, alph\_desc |
| search | string | Búsqueda por keyword |
{% tabs %}
{% tab title="200: OK Resultado" %}
```javascript
{
"paging": 50,
"offset": 0,
"count": 1,
"results": [
{
"productoId": 3392131,
"sku": "ClonBolso",
"price": 1140.0000,
"title": "Bolso WESTIES Satchel rojo HBBIBBUL7WE",
"ean": null,
"upc": "7501768720689",
"longDescription": "
",
"shortDescription": null,
"baseStock": 1,
"images": [
"https://ventiapp.blob.core.windows.net/images/A038C991/39f739bc.jpg"
],
"brand": "Westies",
"model": null,
"weight": null,
"height": null,
"width": null,
"depth": null,
"packageWeight": 700.0,
"packageHeight": 27.0,
"packageWidth": 12.0,
"packageDepth": 32.0,
"used": false,
"warranty": null,
"videoUrl": null,
"variations": [],
"categorySource": null,
"categorySourceId": null,
"attributes": null
}
]
}
```
{% endtab %}
{% endtabs %}
## Find product
`GET` `https://ventiapi.azurewebsites.net/api/products/find/{id}`
Esta operación busca un producto específico por ID
#### Path Parameters
| Name | Type | Description |
| ------------------------------------ | ---- | -------------------------- |
| id\* | int | Id de Producto de Ventiapp |
{% tabs %}
{% tab title="200: OK Resultado" %}
```javascript
{
"productoId":3392131,
"sku":"ClonBolso",
"price":1140.0000,
"title":"Bolso WESTIES Satchel rojo HBBIBBUL7WE",
"ean":null,
"upc":"7501768720689",
"longDescription":"
",
"shortDescription":null,
"baseStock":1,
"images":[
"https://ventiapp.blob.core.windows.net/images/A038C991/39f739bc.jpg"
],
"brand":"Westies",
"model":null,
"weight":null,
"height":null,
"width":null,
"depth":null,
"packageWeight":700.0,
"packageHeight":27.0,
"packageWidth":12.0,
"packageDepth":32.0,
"used":false,
"warranty":null,
"videoUrl":null,
"variations":[
],
"categorySource":null,
"categorySourceId":"",
"attributes":null
}
```
{% endtab %}
{% endtabs %}
## AddPictureProduct
`POST` `https://ventiapi.azurewebsites.net/api/products/AddPictureProduct`
Este método es utilizado para crear una imagen para un producto, en caso de tener una variación de un color en específico, se puede crear más de una imagen. Se puede agregar la url o stringBase64 para añadirse al producto en cuestión.
#### Path Parameters
| Name | Type | Description |
| ------------------------------------------- | ------ | ------------------- |
| ProductID\* | int | Parámetro requerido |
| stringBase64 | string | |
| url | string | |
| attributeValue | string | |
| order | int | |
{% tabs %}
{% tab title="200: OK Success" %}
```json
{
"message 1": {
"id": 10363294,
"productoID": 5024131,
"position": 0,
"width": 0,
"height": 0,
"url": "https://ventiapp.blob.core.windows.net/images/A038C991/1bd10e06.png",
"meliVariacionId": null,
"destacada": false,
"orden": 0,
"productoVariacionID": 1890012,
"activa": true,
"textVariation": "Azul",
"general": true,
"resizedUrl": null,
"resizedWidth": null,
"resizedHeight": null,
"thumbnailUrl": "https://ventiapp.blob.core.windows.net/images/A038C991/1bd10e06.png",
"whiteBackground": false,
"originalSource": null,
"meliExternalId": null
},
"message 2": {
"id": 10363295,
"productoID": 5024131,
"position": 0,
"width": 0,
"height": 0,
"url": "https://ventiapp.blob.core.windows.net/images/A038C991/988ea3c1.png",
"meliVariacionId": null,
"destacada": false,
"orden": 3,
"productoVariacionID": 1890013,
"activa": true,
"textVariation": "Rojo",
"general": true,
"resizedUrl": null,
"resizedWidth": null,
"resizedHeight": null,
"thumbnailUrl": "https://ventiapp.blob.core.windows.net/images/A038C991/988ea3c1.png",
"whiteBackground": false,
"originalSource": null,
"meliExternalId": null
},
"message 3": {
"id": 10363296,
"productoID": 5024131,
"position": 0,
"width": 0,
"height": 0,
"url": "https://ventiapp.blob.core.windows.net/images/A038C991/988ea3c1.png",
"meliVariacionId": null,
"destacada": false,
"orden": 4,
"productoVariacionID": 1890014,
"activa": true,
"textVariation": "Rojo",
"general": true,
"resizedUrl": null,
"resizedWidth": null,
"resizedHeight": null,
"thumbnailUrl": "https://ventiapp.blob.core.windows.net/images/A038C991/988ea3c1.png",
"whiteBackground": false,
"originalSource": null,
"meliExternalId": null
}
}
```
{% endtab %}
{% tab title="400: Bad Request Sin datos" %}
```javascript
{
"message": "The body not have a data."
}
```
{% endtab %}
{% tab title="200: OK Product {ID} not found" %}
```javascript
{
"error 1": "Product {id} not found."
}
```
{% endtab %}
{% tab title="500: Internal Server Error Error en el servidor" %}
```javascript
{
"message": "There was an error, contact technical support."
}
```
{% endtab %}
{% tab title="200: OK Formato de imágen no válido" %}
```javascript
{
"format error": "Invalid image format, productID: {id}"
}
```
{% endtab %}
{% tab title="200: OK url, stringBase64 sin datos" %}
```javascript
{
"error image": "Url or StringBase64 cannot be null, productID: {id}"
}
```
{% endtab %}
{% tab title="200: OK Imágen no generada" %}
```javascript
{
"error image": "Url cannot be generate, productID: {id}"
}
```
{% endtab %}
{% tab title="200: OK Variación inválida" %}
```javascript
{
"error variations 1", "Invalid variation {attributeValue}."
}
```
{% endtab %}
{% endtabs %}
**Url y stringBase64**
Ingresar la url o strngBase64 son opcionales, sin embargo ingresar uno u otro es requerido.
## Body
```json
{
"productPicturesAttributes":
[
{
"ProductID": 5024131,
"stringBase64": "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",
"attributeValue": "Azul"
},
{
"ProductID": 5024131,
"url": "https://ventiapp.blob.core.windows.net/images/A038C991/988ea3c1.png",
"attributeValue": "Rojo",
"order": 3
}
]
}
```
**attributeValue**
Para attributeValue solo las variaciones incluidas en el producto serán válidas.
## UpdatePictureProduct
`PUT` `https://ventiapi.azurewebsites.net/api/products/UpdatePictureProduct`
Este método es utilizado para actualizar una imagen para un procucto, en caso de encontrar la imagen, lo cambia a un color en específico, se puede actualizar más de una imagen.
{% tabs %}
{% tab title="200: OK " %}
```javascript
{
// Response
}
```
{% endtab %}
{% endtabs %}
## Body
```json
{
"productPicturesUpdates":
[
{
"productPictureID": 7463574,
"attributeValue": "Azul"
},
{
"productPictureID": 7463577,
"attributeValue": "Rojo"
}
]
}
```
**attributeValue**
Para attributeValue solo las variaciones incluidas en el producto serán válidas.
## GetPicturesProduct
`GET` `https://ventiapi.azurewebsites.net/api/products/GetPicturesProduct`
Este método es utilizado para buscar algún producto con alguna imagen de Ventiapp, se puede encontrar ya sea por ID o por SKU de un producto.
A pesar de que los parámetros id y parentSku son opcionales, al menos uno de los dos debe ser enviado para poder obtener la información de la imagen del producto.
#### Query Parameters
| Name | Type | Description |
| --------- | ------ | ---------------------- |
| id | int | ID del producto imagen |
| parentSku | String | SKU del producto |
{% tabs %}
{% tab title="200: OK OK" %}
```javascript
[
{
"id": 7436086,
"productoID": 5024131,
"position": 0,
"width": 0,
"height": 0,
"url": "https://ventiapp.blob.core.windows.net/images/A038C991/ventiapp-image--df2312fc-7efb-4636-9c15-25aa383cb1ff_28_3_2022_14_48_21_194.jpg",
"meliVariacionId": null,
"destacada": true,
"orden": 1,
"productoVariacionID": null,
"activa": true,
"textVariation": null,
"general": true,
"resizedUrl": null,
"resizedWidth": null,
"resizedHeight": null,
"thumbnailUrl": "https://ventiapp.blob.core.windows.net/images/A038C991/7447b6d32849a40drsz2849a40d.jpg",
"whiteBackground": false,
"originalSource": null
},
{
"id": 7463574,
"productoID": 5024131,
"position": 0,
"width": 0,
"height": 0,
"url": "https://ventiapp.blob.core.windows.net/images/A038C991/ventiapp-image--ebe64bf6-58ed-4fc2-bbd8-449fe13bbc40_28_3_2022_14_39_20_133.jpg",
"meliVariacionId": null,
"destacada": false,
"orden": 3,
"productoVariacionID": 1890013,
"activa": true,
"textVariation": "Azul",
"general": true,
"resizedUrl": null,
"resizedWidth": null,
"resizedHeight": null,
"thumbnailUrl": "https://ventiapp.blob.core.windows.net/images/A038C991/ventiapp-image--ebe64bf6-58ed-4fc2-bbd8-449fe13bbc40_28_3_2022_14_39_20_133.jpg",
"whiteBackground": false,
"originalSource": null
}
]
```
{% endtab %}
{% tab title="400: Bad Request Imagen no encontrada" %}
```javascript
{
"message": "Pictures not found."
}
```
{% endtab %}
{% tab title="400: Bad Request Producto ID no encontrado" %}
```javascript
{
"message": "Product {id} not found."
}
```
{% endtab %}
{% tab title="400: Bad Request Producto por SKU no encontrado" %}
```javascript
{
"message": "Product {parentSku} not found."
}
```
{% endtab %}
{% tab title="500: Internal Server Error Error en el servidor" %}
```javascript
{
"message": "There was an error, contact technical support."
}
```
{% endtab %}
{% endtabs %}
## RemovePicturesProduct
`DELETE` `https://ventiapi.azurewebsites.net/api/products/RemovePicturesProduct`
Este método es utilizado para borrar una imagen de un procucto, en caso de encontrar la imagen, se puede borrar más de una imagen.
{% tabs %}
{% tab title="200: OK OK" %}
```javascript
{
"message 1": "Image 7461375 was successfully removed.",
"message 2": "Image 7463572 was successfully removed.",
"message 3": "Image 7463571 was successfully removed.",
"message 4": "Image 7461374 was successfully removed."
}
```
{% endtab %}
{% endtabs %}
## Body
```json
{
"id":[
7461375,
7463572,
7463571,
7461374
]
}
```
## UpdateProductDescription
`POST` `https://ventiapi.azurewebsites.net/api/products/UpdateProductDescription`
Crea o actualiza la descripción de un producto, para diferentes canales activos dentro de la cuenta de Ventiapp.
**Channels**
Las opciones válidas para el parámetro channel son:
Amazon **"amazon"**
Claroshop **"claroshop"**
Elektra **"elektra"**
Linio **"linio"**
Mercado Libre **"meli"**
Mercado Shops **"mshops"**
Prestashop **"prestashop"**
VentiCommerce **"venticommerce"**
Vtex **"vtex"**
Walmart **"walmart"**
Wish **"wish"**
WooCommerce **"woocommerce"**
Liverpool **"liverpool"**
WalmartEDI (México) **"walmartEDI"**
Amazon (Estados Unidos) **"amazonUS"**
Walmart (Estados Unidos) **"walmartUS"**
TiendaNube **"tiendanube"**
Magento **"magento"**
Bestbuy (Canadá) **"bestbuyca"**
Cyberpuerta **"cyberpuerta"**
{% tabs %}
{% tab title="200: OK Success" %}
```javascript
"Success."
```
{% endtab %}
{% tab title="400: Bad Request " %}
```javascript
{
"message": "Product {sku} not found."
}
```
{% endtab %}
{% tab title="400: Bad Request " %}
```javascript
{
"message": "Sku cannot be null."
}
```
{% endtab %}
{% tab title="500: Internal Server Error " %}
```javascript
{
"message": "There was an error, contact technical support."
}
```
{% endtab %}
{% endtabs %}
**Body**
```json
{
"sku": "RG11002",
"productDescriptions":
[
{
"channel": "meli",
"shortDescription": "",
"longDescription": null
},
{
"channel": "magento",
"longDescription": "Test descripción"
},
{
"channel": "shopify",
"shortDescription": "Test descripción corta3",
"longDescription": "Test descripción larga3"
}
]
}
```
## Add/Update Relationship
`PUT` `https://ventiapi.azurewebsites.net/api/products/relationships/{id} o {parentSku}`
Se crearan o actualizaran todas las relaciones del producto que corresponden al {id} o {parentSku}
#### Path Parameters
| Name | Type | Description |
| --------- | ------ | -------------------------------------------------------------- |
| id | int | id del producto |
| parentSku | string | SKU base del producto |
| isMerge | bool | Parámetro booleano si se desea hacer el merge de los productos |
#### Headers
| Name | Type | Description |
| ------------------------------------------------ | ------ | -------------- |
| Authentication\* | string | Bearer + Token |
| | String | |
#### Request Body
| Name | Type | Description |
| ---- | ------ | ----------------------------- |
| sku | string | sku del producto a relacionar |
{% tabs %}
{% tab title="200: OK Se creo o actualizaron las relaciones del producto." %}
```javascript
{
// Response
}
```
{% endtab %}
{% tab title="500: Internal Server Error Indica un error interno al procesar la información, en este caso deberás comunicarte con soporte" %}
```javascript
{
// Response
}
```
{% endtab %}
{% tab title="400: Bad Request La relación no pudo ser creada, los detalles indican el motivo y varían dependiendo del error encontrado." %}
```javascript
{
// Response
}
```
{% endtab %}
{% endtabs %}
## Body
```
{
"Relationships": [
"5744938",
"5666574",
"5589093"
]
}
```
{% hint style="info" %}
Ejemplos de URL de llamada
Si llamas con ***ID*** de producto (ej: 777122):\
Si llamas con **SKU Base** (ej: PROD-BASE-01)
Se actualizaran las relaciones conforme a como se envié el body.
Si se envía el body vacío se eliminaran todas las relaciones asociadas existentes al {id}
***isMerge*** se enviara en true si al crear las nuevas relaciones se hará el merge del producto base consultando con Mercado Libre el producto con mas ventas.
{% endhint %}
## Get Relationship
`GET` `https://ventiapi.azurewebsites.net/api/products/relationships/{id} o {parentSku}`
Esta operación obtiene todos los productos relacionados al {id} o {parentSku}
#### Path Parameters
| Name | Type | Description |
| --------- | ------ | --------------------- |
| parentSku | string | SKU base del producto |
| id | int | id del producto |
{% tabs %}
{% tab title="200: OK Resultado" %}
```json
{
"relationships": "5533936",
"combinations": [
"5744938",
"5666574"
]
}
```
{% endtab %}
{% tab title="400: Bad Request La relación no pudo ser creada, los detalles indican el motivo y varían dependiendo del error encontrado." %}
```javascript
{
// Response
}
```
{% endtab %}
{% tab title="500: Internal Server Error Indica un error interno al procesar la información, en este caso deberás comunicarte con soporte" %}
```javascript
{
// Response
}
```
{% endtab %}
{% endtabs %}
{% hint style="info" %}
Ejemplos de URL de llamada
Si llamas con ID de producto (ej: 777122):\
Si llamas con SKU Base (ej: PROD-BASE-01)
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.ventiapp.mx/ventiapp/desarrolladores/api/productos.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.