Documentação

ANÚNCIOS

Estes serviços permitem realizar buscas sobre todos os anúncios de uma loja e obter informação detalhada de um anúncio específico.

Indice

Busca Busca por Id Busca por filtros

Ações

BUSCA POR ID

Retorna a informação de um anúncio identificado pelo seu ID

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

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

Parâmetros

ParâmetroValoresExemplo
access_token Código de segurança access_token=APP_USR-4X30-XXXXX-
SHOP_ID Id do usuário https://api.mercadoshops.com/v1/shops /15XXXXX24/
LISTING_ID Id do anúncio https://api merdoshops.com/v1/shops/15XXXXX24/listing/11111111?acess_token=**************
{
id
Id do Anúncio
Tipo
NUMERICO
store_id
Id da Loja
Tipo
NUMERICO
title
Título do anúncio
Tipo
STRING
sku
SKU do produto ou código de identificação do produto.
Tipo
STRING
SKU segundo wikipedia:
https://es.wikipedia.org/wiki/Stock-keeping_unit
category_id
Id da categoria da árvore da loja a qual pertence o produto
Tipo
NUMERICO
category_name
Nome da categoria a qual pertence o produto
Tipo
STRING
stock
Estoque disponível para a venda
Tipo
NUMERICO
currency_id
Moeda do preço de venda
Tipo
STRING
Valores possíveis
"ARS" Argentine peso
"BRL" Brazilian real
"VEF" Venezuelan strong bolivar
"CLP" Chilean peso
"MXN" Mexican peso
"COP" Colombian peso
"UYU" Uruguayan peso
price
Preço de Venda
Tipo
NUMERICO
status
Estado do Anúncio
Tipo
STRING
Valores possíveis
active
anúncio ativo
paused
anúncio pausado
permalink
Link do anúncio
Tipo
STRING
thumbnail
Link da imagem miniatura do anúncio
Tipo
STRING
promotion
null,
height
null,
width
null,
depth
null,
weight
null,
package_id
null,
pictures
[ Dados das imagens do anúncio
Tipo
ARRAY de Objetos
{
position
Número da posição da imagem
Tipo
NUMERICO
width
Largura em pixels da imagem
Tipo
NUMERICO
height
Altura em pixels da imagem
Tipo
NUMERICO
url
URL da imagem
Tipo
STRING
},
{
},
{
}
],
variations
[ Dados das variações existentes do anúncio
Tipo
ARRAY de Objetos
{
id
id da variação
Tipo
NUMERICO
sku
SKU da variação do produto.
Tipo
STRING
SKU segundo wikipedia:
https://es.wikipedia.org/wiki/Stock-keeping_unit
stock
Estoque disponível para venda
Tipo
NUMERICO
status
Estado da variação
Tipo
STRING
Valores possíveis
active
anúncio ativo
paused
anúncio pausado
attributes
[]
},
{
},
{
},
{
}
],
date_created
Data de criação do anúncio
Tipo
Date(ISO_8601)
last_modified
Data da última modificação do anúncio
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"
}
BUSCA POR FILTROS
GET  /v1/shops/{SHOP_ID}/listings/search 

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

Parâmetros

ParâmetroValoresExemplo
access_token Código de segurança access_token=APP_USR-4X30-XXXXX-
SHOP_ID Id da loja https://api.mercadoshops.com/v1/shops/15XXXXX24/

Filtros

NomeValoresExemplo
status active: Obtém só anúncios ativos

Obtém só anúncios pausados
status=active

Paginação e ordenação

NomeValoresExemplo
limit Limite de itens devolvidos limit=10
orders title_asc

Ordem por título do anúncio crescente

title_desc

Ordem por título do anúncio decrescente

price_asc

Ordem por preço crescente

price_desc

Ordem por preço decrescente
orders= title_asc
{
seller_id
Id da loja
Tipo
NUMERICO
query
Palavra usada para fazer a busca
Tipo
STRING
paging
{
Descrição
Resumo da Paginação
Tipo
Objeto
total
Resultados totais da busca
Tipo
NUMERICO
offset
Número de registro a partir do qual são devolvidos os resultados nesta resposta
Tipo
NUMERICO
limit
Limite dos resultados devolvidos por cada resposta
Tipo
NUMERICO
},
results
[
{
RESPOSTA ESTRUCTRA UMA PUBLICAÇÃO
},
{},
{},
{},
{},
{},
{},
{},
{},
{}
],
orders
[ ordem APLICADA
Tipo
OBJETO
{
id
title_asc
name
Sort by title ascending
}
],
filters
[ Filtros APLICADOS
Tipo
OBJETO
],
available_orders
[ ordenação Disponível
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
}
]
}
]
}
ERROS :
403: Token Invalido ou SHOP_ID incorreto