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.

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

NameTypeDescription

Authentication

string

Bearer + token

Request Body

NameTypeDescription

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)

{
    "status": "Success",
    "code": "PROC-ADDP-S-1",
    "message": "product was created successfully",
    "details": [
        {
            "severity": "Success",
            "code": "product.created",
            "reason": "Product created succesfully, id: 123456"
        }
    ]
}

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

{
	"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"
		}]
	}]
}

Crear un producto sin variaciones

Para crear un producto sin variaciones el campo: ''variations" deberá estar vacío, o simplemente no deberá ser incluido.

Update Product

POST https://ventiapi.azurewebsites.net/api/products/updateproduct/{id} o {parentSku}

Actualiza el producto base existente en Ventiapp

Path Parameters

NameTypeDescription

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

NameTypeDescription

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.

{
    "status": "Success",
    "code": "PROC-MODP-S-1",
    "message": "product was modified successfully",
    "details": []
}

Ejemplo de la llamada

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,
	"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"
		}]
	}]
}

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 Product

DELETE https://ventiapi.azurewebsites.net/api/products/deleteproduct/{id}

Path Parameters

NameTypeDescription

id

number

Id del producto

{
    "status": "Success",
    "code": "PROC-DELP-S-1",
    "message": "The current operation was successful",
    "details": []
}

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.

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

NameTypeDescription

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

{
    "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": "<p><br></p>",
            "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
        }
    ]
}

Find product

GET https://ventiapi.azurewebsites.net/api/products/find/{id}

Esta operación busca un producto específico por ID

Path Parameters

NameTypeDescription

id*

int

Id de Producto de Ventiapp

{
         "productoId":3392131,
         "sku":"ClonBolso",
         "price":1140.0000,
         "title":"Bolso WESTIES Satchel rojo HBBIBBUL7WE",
         "ean":null,
         "upc":"7501768720689",
         "longDescription":"<p><br></p>",
         "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
      }

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

NameTypeDescription

ProductID*

int

Parámetro requerido

stringBase64

string

url

string

attributeValue

string

order

int

{
    "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
    }
}

Url y stringBase64

Ingresar la url o strngBase64 son opcionales, sin embargo ingresar uno u otro es requerido.

Body

{
    "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.

{
    // Response
}

Body

{
    "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

NameTypeDescription

id

int

ID del producto imagen

parentSku

String

SKU del producto

[
    {
        "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
    }
]

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.

{
    "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."
}

Body

{
    "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"

"Success."

Body

{
	"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

NameTypeDescription

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

NameTypeDescription

Authentication*

string

Bearer + Token

String

Request Body

NameTypeDescription

sku

string

sku del producto a relacionar

{
    // Response
}

Body

{
    "Relationships": [
        "5744938",
        "5666574",
        "5589093"
    ]
}

Ejemplos de URL de llamada

Si llamas con ID de producto (ej: 777122): https://ventiapi.azurewebsites.net/api/products/relationships/777122

Si llamas con SKU Base (ej: PROD-BASE-01)

https://ventiapi.azurewebsites.net/api/products/relationships/?parentSku=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.

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

NameTypeDescription

parentSku

string

SKU base del producto

id

int

id del producto

{
    "relationships": "5533936",
    "combinations": [
        "5744938",
        "5666574"
    ]
}

Ejemplos de URL de llamada

Si llamas con ID de producto (ej: 777122): https://ventiapi.azurewebsites.net/api/products/relationships/777122

Si llamas con SKU Base (ej: PROD-BASE-01)

https://ventiapi.azurewebsites.net/api/products/relationships/?parentSku=PROD-BASE-01

Última actualización