Documentación

CLIENTES

En esta sección encontrarás la descripción de los servicios que te permiten obtener información de un cliente tanto de mercadolibre como del sitio.

Los clientes de un sitio son creados a partir de tres eventos:

1. ingreso manual dentro del administrador de clientes
2. pregunta realizada en MercadoLibre o en el sitio
3. compra realizada en MercadoLibre o en el sitio

Además, cada cliente mantiene un status de actividad general y uno por cada canal de venta, los cuáles son actualizados en base a los eventos que vayan ocurriendo.

Indice

Info del Cliente Busqueda de Clientes
INFO DEL CLIENTE
GET  /v1/shops/{SHOP_ID}/clients/{CLIENT_ID} 

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

Parametros

ParametroValoresEjemplo
access_token Codigo de seguridad Access_token=APP_USR-4X30-XXXXX-275bbb6c084d53b8f9fc691770fda9b2__C_I__-15XXXX24
SHOP_ID Id de usuario https://api.mercadoshops.com/v1/shops /15XXXXX24?acess_token=**************
CLIENT_ID Id del cliente https://api.mercadoshops.com/v1/shops /15XXXXX24/clients/9999999?acess_token=**************
{
id_unique
Id UNICO de cliente
Tipo
NUMERICO
id
Id de cliente
Tipo
NUMERICO
store_id
Id del sitio
Tipo
NUMERICO
name
Nombre completo del cliente
Tipo
STRING
meli_cust_id
Id de usuario de MercadoLibre del cliente, cuando meli_client = true.
Tipo
NUMERICO
nickname
Apodo del cliente, cuando meli_client = true
Tipo
NUMERICO
type
Tipo de Cliente
Tipo
STRING
Valores posibles
contact
Cliente que sólo realizó preguntas
buyer
Cliente que realizó compras
mshops_client
Indica si es un cliente que tuvo alguna actividad en el sitio (compras o preguntas)
Tipo
BOOLEAN
meli_client
indica si es un cliente que tuvo alguna actividad en MercadoLibre (compras o preguntas)
Tipo
BOOLEAN
status
Estado del cliente
Tipo
BOOLEAN
Valores posibles
hidden
Cliente que sólo tuvo interacción a través de preguntes por MercadoLibre
active
Cliente que realizó compras desde el sitio y/o MercadoLibre, o que realizó preguntas desde el sitio
inactive
Cliente manualmente eliminado desde el administrador de clientes
last_activity_date
Fecha de ultima actividad del cliente
Tipo
Date(ISO_8601)
unsubscribe_date
Fecha de Baja
Tipo
Date(ISO_8601)
comments
Comentarios ingresados desde el administrador de clientes
Tipo
STRING
}
{
id_unique
9999999,
id
888888888,
store_id
159999999999,
name
"Carlos Perez",
meli_cust_id
5999999999,
nickname
null,
type
"contact",
mshops_client
false,
meli_client
true,
status
"hidden",
last_activity_date
null,
unsubscribe_date
null,
comments
null
}
ERRORES :
403: Token Invalido o SHOP_ID incorrecto
400: invalid_request. Se debe especificar el parámetro CLIENT_ID
404: not_found. El cliente con el CLIENT_ID especificado no fue encontrado
BUSQUEDA DE CLIENTES
GET  /v1/shops/{SHOP_ID}/clients/search?query={palabra}&access_token={ACCESS_TOKEN} 

Mostrar ejemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/clients/search?query={palabra}&access_token={token}

Parametros

ParametroValoresEjemplo
access_token Codigo de seguridad Access_token=APP_USR-4X30-XXXXX-275bbb6c084d53b8f9fc691770fda9b2__C_I__-15XXXX24
SHOP_ID Id de usuario https://api.mercadoshops.com/v1/shops /15XXXXX24?acess_token=**************
query Palabra a buscar dentro del nombre o email del cliente https://api.mercadoshops.com/v1/shops /15XXXXX24/clients/search?query=carlos?acess_token=**************

Paginado y ordenamiento

NombreValoresEjemplo
limit Limite de registros devueltos limit=10
orders name_asc

Orden por nombre ascendente

name_desc

Orden por nombredescendente

id_desc

Orden id Descendente
orders=name_asc
{
seller_id
Id usuario de mercadolibre / mercadoshops
Tipo
NUMERICO
query
Palabra buscada dentro del nombre o email
Tipo
STRING
paging
{
Descripción
Resumen del Paginado
Tipo
OBJECTO
total
Total de resultados devueltos
Tipo
NUMERICO
offset
Offset aplicado
Tipo
NUMERICO
limit
Limite de resultados aplicado
Tipo
NUMERICO
},
{
purchases
{
Descripción
Cantidad de compras
Tipo
OBJETO
quantity
Cantidad de compras
Tipo
NUMERICO
},
phone
Teléfono
Tipo
STRING
status
Estado del cliente
Tipo
STRING
Valores posibles
"active"
"inactive"
"hidden"
nickname
Apodo. Para registros con meli_client = true
Tipo
STRING
unsubscribe_date
Fecha de Baja
Tipo
Date(ISO_8601)
asked_questions
Cantidad de Preguntas realizadas
Tipo
NUMERICO
store_id
Id del sitio
Tipo
NUMERICO
doc_type
Tipo de Documento
Tipo
STRING
last_activity_date
Fecha de ultima actividad
Tipo
Date(ISO_8601)
phone2
Teléfono 2
Tipo
STRING
type
tipo de cliente
Tipo
STRING
Valores posibles
"buyer"
"contact"
mshops_client
Cliente de Mercadoshops
Tipo
STRING
Valores posibles
"true"
"false"
email2
Email 2
Tipo
STRING
id
id de usuario
Tipo
NUMERICO
doc_number
Numero de documento
Tipo
STRING
meli_client
Cliente de MercadoLibre
Tipo
STRING
Valores posibles
"true"
"false"
name_for_sort
Nombre para ordenamiento
Tipo
STRING
email
Email 2
Tipo
STRING
name
Nombre Real
Tipo
STRING
meli_cust_id
meli_cust_id
Tipo
NUMERICO
comments
Comentarios
Tipo
STRING
},
orders
[],
filters
[
],
available_orders
[],
available_filters
[
],
}
{
seller_id
1999999999,
query
"Carlos",
paging
{
total
50,
offset
0,
limit
10,
},
results
[
{
purchases
{
quantity
0
},
phone
"19999999999",
status
"active",
nickname
"CAR99999999992",
unsubscribe_date
"2015-04-22T15:37:30.372-04:00",
asked_questions
1,
store_id
15999999999,
doc_type
"null",
last_activity_date
"2015-04-15T10:08:58.000-04:00",
phone2
null,
type
"buyer",
mshops_client
false,
email2
null,
id
29999999993,
doc_number
"null",
meli_client
true,
name_for_sort
"carlos perez",
email
"ccccc@hotcccc.com",
name
"carlos perez",
meli_cust_id
100000365,
comments
null,
},
{},
{},
{},
{},
{},
{},
{},
{},
{}
],
orders
[],
filters
[
],
available_orders
[],
available_filters
[
],
}
ERRORES :
403: Token Invalido o SHOP_ID incorrecto