Documentación

PREGUNTAS

Permite buscar y responder preguntas realizadas sobre publicaciones tanto en mercadolibre como en el sitio.

En mercadoshops a diferencia de mercadolibre existe el concepto ‘conversacion’ que agrupa preguntas y respuestas mantenidas con un cliente.

Cada conversación tiene un ID único para poder identificar conversaciones con clientes.

Indice

Busqueda Busqueda por Id Busqueda por estado Busqueda por palabra Responder Borrar pregunta Busqueda por conversacion

ACCIONES:

BUSQUEDA POR ID

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

GET  /v1/shops/{SHOP_ID}/questions/{QUESTION_ID} 

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

Parametros

ParametroValoresEjemplo
access_token Codigo de seguridad access_token=APP_USR-4X30-XXXXX-
SHOP_ID Id de usuario de mercadolibre / mercadoshops https://api.mercadoshops.com/v1/shops /15XXXXX24/
QUESTION_ID Id de pregunta https://api merdoshops.com/v1/shops/15XXXXX24/questions/11111111?acess_token=**************
{
id
Id único de Pregunta
Tipo
NUMERICO
status
Estado
Tipo
STRING
Valores posibles
"unanswered"
"answered"
store_id
Id del sitio
Tipo
NUMERICO
Recurso relacionado: link a la API de info de sitio
from
{
Usuario que pregunto
Tipo
OBJETO
email
Email
Tipo
STRING
name
Nombre del usuario
Tipo
STRING
client_id
Id del usuario
Tipo
NUMERICO
Recurso relacionado: link a la API de clientes
},
question
{
Descripción
Pregunta
Tipo
OBJETO
text
Texto de la pregunta
Tipo
STRING
date
Fecha de realización de la pregunta
Tipo
Date(ISO_8601)
},
type
Tipo de publicación de la pregunta
Tipo
STRING
Valores posibles
shop
Pregunta realizada en el sitio desde la sección de contacto
item
Pregunta realizada en un ítem publicado en MercadoLibre o en el sitio
thread_id
Id de conversación de que contiene a esta pregunta
Tipo
STRING
channel
Canal de venta la de publicación
Tipo
STRING
Valores posibles
mshops
mercadoshops
meli
mercadolibre
publication
{ Datos de la publicación de la pregunta
Tipo
OBJETO
id
ID de la publicación de la pregunta
Tipo
STRING
currency_id
Tipo Moneda
Tipo
STRING
title
Titulo de la publicación de la pregunta
Tipo
STRING
price
Precio de la publicación de la pregunta
Tipo
STRING
stock
Stock disponible de la publicación de la pregunta
Tipo
STRING
thumbnail
Link de la miniatura de la imagen de la publicación
Tipo
STRING
permalink
Link de la publicación
Tipo
STRING
}
}
{
id
60******,
store_id
1*******4,
channel
"meli",
status
"answered",
type
"item",
creation_date
"2014-09-02T00:49:35.000-04:00",
question
{
date
"2014-09-02T00:49:31.000-04:00",
text
"texto de ejemplo"
},
answer
{
date
"2014-09-02T09:21:53.000-04:00",
text
"Hola * * * * * * * * * * * * icial.",
source
"ML"
},
thread_id
"meli-15****4-94306809-MLA*****14",
publication
{
id
"MLA576205014",
title
"****** Fluid",
permalink
"http://articulo.mercadolibre.com.ar/MLA-576****4-campera-*****-_JM",
thumbnail
"http://mla-s2-p.mlstatic.com/18210-MLA*****16_082014-I.jpg",
stock
5,
currency_id
"ARS",
price
570
},
from
{
client_id
131,
name
"****aro",
meli_cust_id
94****9,
nickname
"NF*******89"
}
}
BUSQUEDA POR ESTADO
GET  /v1/shops/{SHOP_ID}/questions/search 

Mostrar ejemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/questions/search?status=unanswered&limit=10&orders=question_date_asc&access_token={access_token} 

Parametros

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

Filtros

NombreValoresEjemplo
status Unanswered : Sin responder

Answered : Respondidas
status=unanswered
channel mshops : mercadoshops

meli: mercadolibre
channel=mshops

Paginado y Ordenamiento

NombreValoresEjemplo
limit Limite de registros devueltos limit=10
orders question_date_asc

Orden por fecha de creacion ascendente

question_date_desc

Orden por fecha de creacion descendente
orders=question_date_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
[
Descripción
Resultado
Tipo
OBJETO
{
creation_date
Fecha de Creación
Tipo
Date(ISO_8601)
id
Id único de Pregunta
Tipo
NUMERICO
status
Estado
Tipo
STRING
Valores posibles
"unanswered"
"answered"
store_id
Id del sitio
Tipo
NUMERICO
from
{
Usuario que pregunto
Tipo
OBJETO
email
Email
Tipo
STRING
name
Nombre del usuario
Tipo
STRING
client_id
Id del usuario
Tipo
NUMERICO
},
question
{
Descripción
Pregunta
Tipo
OBJETO
text
Texto de la pregunta
Tipo
STRING
date
Fecha de realización de la pregunta
Tipo
Date(ISO_8601)
},
type
Tipo de publicación de la pregunta
Tipo
STRING
Valores posibles
shop
mercadoshops
item
mercadolibre
thread_id
Id de conversación de que contiene a esta pregunta
Tipo
STRING
channel
Canal de venta la de publicación
Tipo
STRING
Valores posibles
mshops
mercadoshops
meli
mercadolibre
},
],
orders
[
Descripción
Tipos de ordenamientos APLICADOS
Tipo
ARRAY DE OBJETOS
{
id
"question_date_asc",
name
"Order by question date ascending"
}
],
filters
[
Descripción
Tipos de filtros APLICADOS
Tipo
ARRAY DE OBJETOS
{
id
"status",
name
"Status",
values
[
{
id
"answered",
name
"Answered questions",
results
0
},
{
id
"unanswered",
name
"Unanswered questions",
results
2
}
]
}
],
available_orders
[
Descripción
Tipos de ordenamientos posibles
Tipo
ARRAY DE OBJETOS
{
id
"question_date_asc",
name
"Order by question date ascending"
},
{
id
"question_date_desc",
name
"Order by question date descending"
}
],
available_filters
[
Descripción
Tipos de filtros posibles
Tipo
ARRAY DE OBJETOS
{
id
"status",
name
"Status",
values
[
{
id
"answered",
name
"Answered questions",
results
1
},
{
id
"unanswered",
name
"Unanswered questions",
results
1
},
{
id
"closed_unanswered",
name
"Closed unanswered questions",
results
0
}
]
},
{
id
"channel",
name
"Channel",
values
[
{
id
"mshops",
name
"MercadoShops questions",
results
2
},
{
id
"meli",
name
"MercadoLibre questions",
results
0
}
]
}
]
}
ERRORES :
403: Token Invalido
BUSQUEDA POR PALABRA
GET  /v1/shops/{SHOP_ID}/questions/search/q 

Mostrar ejemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/questions/search?q={PALABRA}&limit=3&access_token={access_token} 

Parametros

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

Filtros

NombreValoresEjemplo
status Unanswered : Sin responder

Answered : Respondidas
status=unanswered
channel mshops : mercadoshops

meli: mercadolibre
channel=mshops

Paginado y Ordenamiento

NombreValoresEjemplo
limit Limite de registros devueltos limit=10
orders question_date_asc

Orden por fecha de creacion ascendente

question_date_desc

Orden por fecha de creacion descendente
orders=question_date_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
[
Descripción
Resultado
Tipo
OBJETO
{
creation_date
Fecha de Creación
Tipo
Date(ISO_8601)
id
Id único de Pregunta
Tipo
NUMERICO
status
Estado
Tipo
STRING
Valores posibles
"unanswered"
"answered"
store_id
Id del sitio
Tipo
NUMERICO
from
{
Usuario que pregunto
Tipo
OBJETO
email
Email
Tipo
STRING
name
Nombre del usuario
Tipo
STRING
client_id
Id del usuario
Tipo
NUMERICO
},
question
{
Descripción
Pregunta
Tipo
OBJETO
text
Texto de la pregunta
Tipo
STRING
date
Fecha de realización de la pregunta
Tipo
Date(ISO_8601)
},
type
Tipo de publicación de la pregunta
Tipo
STRING
Valores posibles
shop
mercadoshops
item
mercadolibre
thread_id
Id de conversación de que contiene a esta pregunta
Tipo
STRING
channel
Canal de venta la de publicación
Tipo
STRING
Valores posibles
mshops
mercadoshops
meli
mercadolibre
},
],
orders
[
Descripción
Tipos de ordenamientos APLICADOS
Tipo
ARRAY DE OBJETOS
{
id
"question_date_asc",
name
"Order by question date ascending"
}
],
filters
[
Descripción
Tipos de filtros APLICADOS
Tipo
ARRAY DE OBJETOS
{
id
"status",
name
"Status",
values
[
{
id
"answered",
name
"Answered questions",
results
0
},
{
id
"unanswered",
name
"Unanswered questions",
results
2
}
]
}
],
available_orders
[
Descripción
Tipos de ordenamientos posibles
Tipo
ARRAY DE OBJETOS
{
id
"question_date_asc",
name
"Order by question date ascending"
},
{
id
"question_date_desc",
name
"Order by question date descending"
}
],
available_filters
[
Descripción
Tipos de filtros posibles
Tipo
ARRAY DE OBJETOS
{
id
"status",
name
"Status",
values
[
{
id
"answered",
name
"Answered questions",
results
1
},
{
id
"unanswered",
name
"Unanswered questions",
results
1
},
{
id
"closed_unanswered",
name
"Closed unanswered questions",
results
0
}
]
},
{
id
"channel",
name
"Channel",
values
[
{
id
"mshops",
name
"MercadoShops questions",
results
2
},
{
id
"meli",
name
"MercadoLibre questions",
results
0
}
]
}
]
}
RESPONDER UNA PREGUNTA

Responde una pregunta a través de su ID.

PUT  /v1/shops/{SHOP_id}/questions/{QUESTION_ID} 

Mostrar ejemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/questions/{QUESTION_ID}?access_token={token} 

Para responder una repregunta hay que hacer un PUT a la url indicada con un JSON que incluya la respuesta con este formato

Content-Type: application/json

{answer: " respuesta a la pregunta "}

Parametros

ParametroValoresEjemplo
access_token Codigo de seguridad access_token=APP_USR-4X30-XXXXX-
SHOP_ID Id de usuario de mercadolibre / mercadoshops https://api.mercadoshops.com/v1/shops /159999999/
ID ID de la pregunta v1/shops/159999999/questions/999911111
HTTP STATUS 200 OK
{
answer
"respuesta a la pregunta "
}
BORRAR UNA PREGUNTA
DELETE  HEADER: Content-Type: application/json                      
         /v1/shops/{SHOP_id}/questions/{QUESTION_ID} 

Mostrar ejemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/questions/{QUESTION_ID}?access_token={token} 

Parametros

ParametroValoresEjemplo
access_token Codigo de seguridad access_token=APP_USR-4X30-XXXXX-
SHOP_ID Id de usuario de mercadolibre / mercadoshops https://api.mercadoshops.com/v1/shops/159999999/
ID ID de la pregunta v1/shops/159999999/questions/999911111
HTTP STATUS 204
BUSQUEDAS POR CONVERSACIÓN
GET  /v1/shops/{SHOP_ID}/questions/threads/search 

Mostrar ejemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/questions/threads/search?status=answered&access_token={token} 

Parametros

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

Filtros

NombreValoresEjemplo
status Unanswered : Sin responder

Answered : Respondidas
status=unanswered
Thread_id Id de Conversación Thread_id =meli-158424724-94306809-
Client_id ID del usuario Client_id =15999999999
query Palabra de busqueda Query=stock

Paginado y Ordenamiento

NombreValoresEjemplo
limit Limite de registros devueltos limit=10
orders last_question_date_asc

Orden por fecha de utima pregunta ascendente

last_question_date_desc

Orden por fecha de ultima pregunta descendente
orders=last_question_date_asc
{
seller_id
Id usuario de mercadolibre / mercadoshops
Tipo
NUMERICO
query
palabra a buscar
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
[
Descripción
Resultado
Tipo
OBJETO
{
id
Id único de Conversación
Tipo
STRING
answered_quantity
cantidad de preguntas respondidas
Tipo
STRING
status
Estado
Tipo
STRING
Valores posibles
"unanswered"
"answered"
last_question_date
Fecha de ultima pregunta
Tipo
Date(ISO_8601)
store_id
Id del sitio
Tipo
NUMERICO
channel
Canal de venta la de publicación
Tipo
STRING
Valores posibles
mshops
mercadoshops
meli
mercadolibre
main_question
{ Pregunta Principal
Tipo
OBJETO
creation_date
Fecha de creación de la pregunta
Tipo
Date(ISO_8601)
id
Id único de Pregunta
Tipo
NUMERICO
status
Estado
Tipo
STRING
Valores posibles
"unanswered"
"answered"
store_id
Id del sitio
Tipo
NUMERICO
from
{
nickname
Apodo del Comprador
Tipo
STRING
name
Nombre del comprador
Tipo
STRING
meli_cust_id
meli_cust_id
Tipo
NUMERICO
client_id
Id del usuario
Tipo
NUMERICO
},
question
{ Pregunta
Tipo
OBJETO
text
Texto de la pregunta
Tipo
STRING
date
Fecha de creación de la pregunta
Tipo
Date(ISO_8601)
},
type
Tipo de publicación de la pregunta
Tipo
STRING
Valores posibles
shop
mercadoshops
item
mercadolibre
thread_id
Id de conversación de que contiene a esta pregunta
Tipo
STRING
channel
Canal de venta la de publicación
Tipo
STRING
Valores posibles
mshops
mercadoshops
meli
mercadolibre
publication
{ Publicación
Tipo
OBJETO
id
Id de Publicación en la que se hizo la pregunta
Tipo
STRING
currency_id
Id de Tipo de Moneda del precio
Tipo
STRING
title
Titulo de la publicación
Tipo
STRING
price
Precio de la publicación
Tipo
NUMERICO
stock
Stock disponible de la publicación de la pregunta
Tipo
STRING
thumbnail
Link de la miniatura de la imagen de la publicación
Tipo
STRING
permalink
Link de la publicación
Tipo
STRING
}
},
unanswered_quantity
Cantidad de preguntas sin responder dentro de esta conversación
Tipo
NUMERICO
},
{},
{},
{},
{},
{},
{},
{},
{},
{}
],
orders
[],
filters
[
],
available_orders
[],
available_filters
[],
unanswered_quantity
Cantidad de preguntas sin responder en toda la consulta realizada
Tipo
NUMERICO
}
{
seller_id
999999999,
query
"campera",
paging
{
total
765,
offset
0,
limit
10
},
results
[
{
id
"meli-1999994-549991-MLA57599999",
answered_quantity
0,
status
"unanswered",
last_question_date
"2015-09-15T10:47:07.000Z",
store_id
15999999999,
channel
"meli",
main_question
{
creation_date
"2015-09-15T10:47:13.000Z",
id
349999999999,
status
"unanswered",
store_id
15999999999,
from
{
nickname
"CAXXXXXX1",
name
"Fulano Mengano",
meli_cust_id
50000000,
client_id
399999990
},
question
{
text
"Hola, como va? Te queria preguntar si tenes en stock? Muchas gracias",
date
"2015-09-15T10:47:07.000Z"
},
type
"item",
thread_id
"meli-15999999-599-MLA57599999",
channel
"meli",
publication
{
id
"MLA9999999",
currency_id
"ARS",
title
"Producto a la Venta ",
price
1695,
stock
10,
thumbnail
"http://mla-s2-p.mlstatic.com/18288-ML99999999991_082014-I.jpg",
permalink
"http://articulo.mercadolibre.com.ar/MLA999999-99fred-gold-_JM",
}
},
unanswered_quantity
1
},
{},
{},
{},
{},
{},
{},
{},
{},
{}
],
orders
[],
filters
[
],
available_orders
[
{
id
"last_question_date_asc",
name
"Order by question date ascending"
},
{
id
"last_question_date_desc",
name
"Order by question date descending"
}
],
available_filters
[
{
id
"status",
name
"Status",
values
[]
},
{
id
"channel",
name
"Channel",
values
[]
}
],
unanswered_quantity
5,
}
BUSQUEDA POR ID DE CONVERSACIÓN
GET  /v1/shops/{SHOP_ID}/questions/threads/{THREAD_ID} 

Mostrar ejemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/questions/threads/{thread_id}?acess_token={token}

Parametros

ParametroValoresEjemplo
access_token Codigo de seguridad access_token=APP_USR-4X30-XXXXX-
SHOP_ID Id de usuario de mercadolibre / mercadoshops https://api.mercadoshops.com/v1/shops/15XXXXX24/
THREAD_ID Id de conversación https://api merdoshops.com/v1/shops/15XXXXX24/questions/threads/meli-1999999-599999MLA575642941?acess_token=**************

Paginado y Ordenamiento

NombreValoresEjemplo
limit Limite de registros devueltos limit=10
orders question_date_asc

Orden por fecha de creación de las preguntas ascendente

question_date_desc

Orden por fecha de creación de las preguntas descendente
orders=question_date_asc
{
seller_id
Id usuario de mercadolibre / mercadoshops
Tipo
NUMERICO
query
palabra a buscar
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
[
Descripción
Resultado
Tipo
OBJETO
{
id
Id único de Conversación
Tipo
STRING
answered_quantity
cantidad de preguntas respondidas
Tipo
STRING
status
Estado de la conversación
Tipo
STRING
Valores posibles
"unanswered"
"answered"
last_question_date
Fecha de ultima pregunta
Tipo
Date(ISO_8601)
store_id
Id del sitio
Tipo
NUMERICO
channel
Canal de venta la de publicación
Tipo
STRING
Valores posibles
mshops
mercadoshops
meli
mercadolibre
main_question
{ Pregunta Principal
Tipo
OBJETO
creation_date
Fecha de creación de la pregunta
Tipo
Date(ISO_8601)
id
Id único de Pregunta
Tipo
NUMERICO
status
Estado de la Pregunta
Tipo
STRING
Valores posibles
"unanswered"
"answered"
store_id
Id del sitio
Tipo
NUMERICO
from
{
nickname
Apodo del Comprador
Tipo
STRING
name
Nombre del comprador
Tipo
STRING
meli_cust_id
meli_cust_id
Tipo
NUMERICO
client_id
Id del usuario
Tipo
NUMERICO
},
question
{ Pregunta
Tipo
OBJETO
text
Texto de la pregunta
Tipo
STRING
date
Fecha de creación de la pregunta
Tipo
Date(ISO_8601)
},
type
Tipo de publicación de la pregunta
Tipo
STRING
Valores posibles
shop
mercadoshops
item
mercadolibre
thread_id
Id de conversación de que contiene a esta pregunta
Tipo
STRING
channel
Canal de venta la de publicación
Tipo
STRING
Valores posibles
mshops
mercadoshops
meli
mercadolibre
publication
{ Publicación
Tipo
OBJETO
id
Id de Publicación en la que se hizo la pregunta
Tipo
STRING
currency_id
Id de Tipo de Moneda del precio
Tipo
STRING
title
Titulo de la publicación
Tipo
STRING
price
Precio de la publicación
Tipo
NUMERICO
stock
Stock disponible de la publicación de la pregunta
Tipo
STRING
thumbnail
Link de la miniatura de la imagen de la publicación
Tipo
STRING
permalink
Link de la publicación
Tipo
STRING
}
},
unanswered_quantity
Cantidad de preguntas sin responder dentro de esta conversación
Tipo
NUMERICO
},
],
orders
[],
filters
[
],
available_orders
[],
available_filters
[],
}
{
seller_id
999999999,
query
"campera",
paging
{
total
765,
offset
0,
limit
10
},
results
[
{
id
"meli-1999994-549991-MLA57599999",
answered_quantity
0,
status
"unanswered",
last_question_date
"2015-09-15T10:47:07.000Z",
store_id
15999999999,
channel
"meli",
main_question
{
creation_date
"2015-09-15T10:47:13.000Z",
id
349999999999,
status
"unanswered",
store_id
15999999999,
from
{
nickname
"CAXXXXXX1",
name
"Fulano Mengano",
meli_cust_id
50000000,
client_id
399999990
},
question
{
text
"Hola, como va? Te queria preguntar si tenes en stock? Muchas gracias",
date
"2015-09-15T10:47:07.000Z"
},
type
"item",
thread_id
"meli-15999999-599-MLA57599999",
channel
"meli",
publication
{
id
"MLA9999999",
currency_id
"ARS",
title
"Producto a la Venta ",
price
1695,
stock
10,
thumbnail
"http://mla-s2-p.mlstatic.com/18288-ML99999999991_082014-I.jpg",
permalink
"http://articulo.mercadolibre.com.ar/MLA999999-99fred-gold-_JM",
}
},
unanswered_quantity
1
},
],
orders
[],
filters
[
],
available_orders
[
{
id
"last_question_date_asc",
name
"Order by question date ascending"
},
{
id
"last_question_date_desc",
name
"Order by question date descending"
}
],
available_filters
[
{
id
"status",
name
"Status",
values
[]
},
{
id
"channel",
name
"Channel",
values
[]
}
],
}