Documentación

PUBLICACIONES

Permite buscar publicaciones en el sitio.

Indice

Busqueda Busqueda por Id Busqueda por filtros

Acciones

BUSQUEDA POR ID

Retorna la información de una publicación identificada por su ID

GET  /v1/shops/{SHOP_ID}/listings/{LISTING_ID} 

Mostrar ejemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/listings/{listing_id}?access_token={access_token}

Parametros

ParametroValoresEjemplo
access_token Codigo de seguridad access_token=APP_USR-4X30-XXXXX-
SHOP_ID Id de usuario https://api.mercadoshops.com/v1/shops /15XXXXX24/
LISTING_ID Id de la publicación https://api merdoshops.com/v1/shops/15XXXXX24/listings/11111111?acess_token=**************
{
id
Id de Publicacion
Tipo
NUMERICO
store_id
Id del Sitio
Tipo
NUMERICO
title
Titulo de la publicación
Tipo
STRING
sku
SKU del producto o codigo de indentificacion del producto.
Tipo
STRING
SKU segun wikipwedia:
https://es.wikipedia.org/wiki/Stock-keeping_unit
category_id
Id de la categoria dentro del sitio
Tipo
NUMERICO
category_name
Nombre de la categoria
Tipo
STRING
stock
Stock disponible para la venta
Tipo
NUMERICO
currency_id
Moneda del precio de venta
Tipo
STRING
Valores posibles
"ARS" Argentine peso
"BRL" Brazilian real
"VEF" Venezuelan strong bolivar
"CLP" Chilean peso
"MXN" Mexican peso
"COP" Colombian peso
"UYU" Uruguayan peso
price
Precio de Venta
Tipo
NUMERICO
status
Estado de la Publicación
Tipo
STRING
Valores posibles
"active" publicacion activa
permalink
Link de la publicación
Tipo
STRING
thumbnail
Link de la imagen miniatura de la publicación
Tipo
STRING
promotion
null,
height
null,
width
null,
depth
null,
weight
null,
package_id
null,
pictures
[ Datos de las imagenes de la publicación
Tipo
ARRAY de Objetos
{
position
Numero de posición de la imagen
Tipo
NUMERICO
width
Ancho en pixels de la imagen
Tipo
NUMERICO
height
Largo en pixels de la imagen
Tipo
NUMERICO
url
URL de la imagen
Tipo
STRING
},
{
},
{
}
],
variations
[ Datos de las variaciones de talle y color de la publicacion
Tipo
ARRAY de Objetos
{
id
id de la variación
Tipo
NUMERICO
sku
SKU de la variacion del producto.
Tipo
STRING
SKU segun wikipwedia:
https://es.wikipedia.org/wiki/Stock-keeping_unit
stock
Stock disponible para la venta
Tipo
NUMERICO
status
Estado de la variación
Tipo
STRING
Valores posibles
"active" variacion activa
attributes
[]
},
{
},
{
},
{
}
],
date_created
Fecha de creación de la publicación
Tipo
Date(ISO_8601)
last_modified
Fecha de la ultima modificación de la publicación
Tipo
Date(ISO_8601)
}
{
id
500000000,
store_id
15000000,
title
"Campera Hombre 0",
sku
"000AAXXXX",
category_id
4677788,
category_name
"Camperas urbanas",
stock
10,
currency_id
"ARS",
price
1930,
status
"active",
permalink
"http://cket-08999999901_50102595xJM",
thumbnail
"http://static.merca58999924-578999999964-1.jpgXsZ158424724xIM.jpg",
promotion
null,
height
null,
width
null,
depth
null,
weight
null,
package_id
null,
pictures
[
{
position
1,
width
110,
height
110,
url
"http://static.mercadoshops.com/9999999 064-1.jpgXsZ158424724xIM.jpg "
},
{},
{}
],
variations
[
{
id
599999,
sku
"0000AAAACCCC",
stock
2,
status
"active",
attributes
[
{
name
"Talle",
value
"S",
},
{
name
"Color",
value
"Negro",
}
]
},
{},
{},
{}
],
date_created
"2015-09-10T13:54:12.000-04:00",
last_modified
"2015-09-10T13:56:15.000-04:00"
}
BUSQUEDA POR FILTROS
GET  /v1/shops/{SHOP_ID}/listings/search

Mostrar ejemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/listings/search?limit=10&access_token={access_token}

Parametros

ParametroValoresEjemplo
access_token Codigo de seguridad access_token=APP_USR-4X30-XXXXX-
SHOP_ID Id de usuario https://api.mercadoshops.com/v1/shops/15XXXXX24/

Filtros

NombreValoresEjemplo
status active: Publicacion activa

paused: publicación pausada
status=active

Paginado y ordenamiento

NombreValoresEjemplo
limit Limite de registros devueltos limit=10
orders title_asc

Orden por titulo de la publicaicon ascendente

title_desc

Orden por titulo de la publicaicon descendente

price_asc

Orden por precio ascendente

price_desc

Orden por precio descendente
orders= title_asc
{
seller_id
Id usuario de mercadolibre / mercadoshops
Tipo
NUMERICO
query
Palabra que se utilizo para la búsqueda
Tipo
STRING
paging
{
Descripción
Resumen del Paginado
Tipo
Objeto
total
Total de resultados devueltos
Tipo
NUMERICO
offset
Offset aplicado
Tipo
NUMERICO
limit
Limite de resultados aplicado
Tipo
NUMERICO
},
results
[
{
ESTRUCTRA DE RESPUESTA DE UNA PUBLICACION
},
{},
{},
{},
{},
{},
{},
{},
{},
{}
],
orders
[ Ordenamiento APLICADO
Tipo
OBJETO
{
id
title_asc
name
Sort by title ascending
}
],
filters
[ Filtros APLICADOS
Tipo
OBJETO
],
available_orders
[ Ordenamiento Disponibles
Tipo
OBJETO
{
id
title_asc
name
Sort by title ascending
},
{
id
title_desc
name
Sort by title descending
},
{
id
price_asc
name
Sort by price ascending
},
{
id
price_desc
name
Sort by price descending
}
],
available_filters
[
{
id
status,
name
Status,
values
[
{
id
active,
name
Active publications,
results
197
},
{
id
paused,
name
Inactive publications,
results
164
}
]
}
]
}
{
seller_id
1999999,
query
null,
paging
{
total
361,
offset
0,
limit
10,
},
results
[
{
currency_id
"ARS"
keywords
[
S,
Negro,
M,
L,
XL,
]
weight
null,
status
"active",
width
null,
promotion
null,
store_id
15999999,
category_id
46799998,
date_created
"2015-09-10T17:54:12.000Z",
sku
"99999ZZZZZ",
depth
null,
id
59999995,
last_modified
"2015-09-10T17:56:15.000Z",
title
"Campera Hombre 1",
height
null,
stock
10,
price
1930,
thumbnail
"http://static.mercadoshops.com/campera-h9999et999001_iZ5999991.jpgXsZ158424724xIM.jpg",
category_name
"Camperas urbanas",
permalink
"http://foxhead.com.ar/ca999919001_50102595xJM",
package_id
null
},
{},
{},
{},
{},
{},
{},
{},
{},
{}
],
orders
[
{
id
"title_asc",
name
"Sort by title ascending",
}
],
filters
[
],
available_orders
[
{
id
"title_asc",
name
"Sort by title ascending",
},
{
id
"title_desc",
name
"Sort by title descending",
},
{
id
"price_asc",
name
"Sort by price ascending",
},
{
id
"price_desc",
name
"Sort by price descending",
}
],
available_filters
[
{
id
"status",
name
"Status",
values
[
{
id
"active",
name
"Active publications",
results
197
},
{
id
"paused",
name
"Inactive publications",
results
164
}
]
}
]
}
ERRORES :
403: Token Invalido o SHOP_ID incorrecto