Documentación

Como empezar

1. Debes tener un usuario registrado en MercadoLibre. Si no lo tienes, puedes registrarte de manera gratutita:
Registrarme en MercadoLibre

2. Debes tener contratado un plan Profesional o Profesional Plus en MercadoShops.
Ver planes

3. Crea una aplicación en el Application Manager de MercadoLibre:
Abrir Application Manager

4. Autoriza a tu aplicación para interactuar con la información de MercadoShops.


Este paso también lo pueden hacer otros usuarios que quieran que tu aplicación pueda interactuar con la API de MercadoShops para modificar datos o traer información de su cuenta. Lee la guía de autorización de MercadoLibre para entender el flujo de autorización:

Leer guía

5. Al poseer el access_token ya puedes usar la API de MercadoShops.

Siguiente >

Conceptos básicos

¿Qué es la API de MercadoShops?

Es una Interfaz de Programación de Aplicaciones (Application Programming Interface) que te permite intercambiar información con nuestra plataforma. Te ofrecemos una API robusta y flexible para que puedas integrarte de la forma que mejor se adapte a tu negocio.

¿Cómo funciona?

Puedes solicitar información, por ejemplo sobre una compra que realizaron en tu sitio o una publicación del mismo, usando el protocolo HTTP (de manera similar a como lo hace un navegador). Existen distintos servicios brindados por la API, los cuales se utilizan mediante distintas URLs.

Ejemplo de un pedido:
curl -X GET https://api.mercadoshops.com/shops/{shop_id}?access_token={access_token}

Las URLs de los distintos servicios tendrán siempre algún parámetro que tiene que ser reemplazado por un valor específico, según las necesidades del propio desarrollo. En el ejemplo, el parámetro {shop_id} es utilizado para obtener información sobre un sitio en particular, y el parámetro {access_token} es utilizado para habilitar el acceso a dicha información.

Ejemplo de una respuesta:
{
id
30000051,
shop_id
15000001,
name
Test API,
code
"",
options
"",
provider
"OTHER",
event
"NAVIGATION",
status
"ACTIVE"
}

Consideraciones de diseño >

Consideraciones de diseño

Te mostramos las características más importantes de la arquitectura de nuestra API.

Indice

Arquitectura REST URL base de la API Datos en formato JSON Soporte Cross Domain (CORS) Codificación UTF-8 Formato de fecha y hora ISO-8601

Arquitectura REST

Utilizamos una arquitectura REST, basada 100% en estándares de HTTP:

URL base de la API

La URL base de la API, a partir de la cual puedes acceder a todos los recursos, se mantiene constante para todos los servicios:

https://api.mercadoshops.com/v1/

Datos en formato JSON

Los datos son enviados y recibidos en formato JSON (JavaScript Object Notation), que es un formato basado en texto, simple y fácilmente utilizable desde distintas plataformas. Ejemplo:

{
    "id": 1,
    "attribute": "value",
    "object": {
        "inner_id": 2,
        "inner_attribute": "inner_value"
    },
    "list": [
        "item 1",
        "item 2"
    ]    
}

Soporte Cross Domain (CORS)

Nuestra API soporta CORS (Cross-Origin Resource Sharing) para permitir su utilización desde cualquier dominio (origen) mediante la utilización del header:

Access-Control-Allow-Origin: *

Codificación UTF-8

Todas las solicitudes (requests) y respuestas (responses) utilizan codificación UTF-8.

Formato de fecha y hora ISO-8601

Todos los campos de fecha/hora utilizan la norma ISO-8601.

Ejemplo: 2014-04-24T16:37:22.032-04:00

< Conceptos básicosAutenticación >

Autenticación

Para manejar la autenticación dentro de la plataforma utilizamos el protocolo OAuth 2.0 .

Ver protocolo

Es un protocolo simple pero seguro que cubre la todos de los casos de uso que puede encontrarse al interactuar con las API de Mercadoshops .

¿Cómo funciona?
funcionamiento token

 

1. Envía tus credenciales y recibe tu access_token.
2. Usa tu access_token para operar con la API.

¿Cómo obtengo mi access_token?

Primero necesitarás obtener tus credenciales creando un aplicación para Mercadolibre / Mercadoshops desde el Application Manager

Application Manager

Una vez creada la aplicación tenes estos datos :

• SHORT_NAME: mp-app-18XXXXX90
• CLIENT_ID: 3XXX
• CLIENT_SECRET: siF6rzmgH32XXXXXXXagLX8aq0HQYPMIf

Si vas a desarrollar para terceros, pídele a tu cliente que obtenga estos datos y te los facilite.

Luego, envíanos tu CLIENT_ID y CLIENT_SECRET de esta manera:

curl -X POST \
     -H 'accept: application/json' 
     -H 'content-type: application/x-www-form-urlencoded' 
     'https://api.mercadopago.com/oauth/token' 
     -d 'grant_type=client_credentials' 
     -d 'client_id=3XXX' 
     -d 'client_secret= siF6rzmgH32XXXXXXXagLX8aq0HQYPMIf '
     

VER

Como respuesta, te devolveremos un código único de acceso llamado access_token. Tendrás que utilzarlo para todas las operaciones que realices con la API, enviándolo como un parámetro en la url:

https://api.mercadoshops.com/.../?access_token=TU_ACCESS_TOKEN

Si tenes dudas de como tus clientes autorizan a tu APLICACIÓN para interactuar con la API de MercadoShops podes seguir esta guía que ofrece Mercadolibre.

Ver guia

ADMINISTRACIÓN DEL SITIO

En esta sección encontrarás la descripción de los servicios que te permiten obtener información de un sitio de MercadoShops y administrar su estructura.

Tambien encontraras la información necesaria para utilizar la API de métricas.

Indice

Info del sitio Metricas Listar tracking_codes por usuario Obtener un tracking_code por id Crear un tracking_code Modificar un tracking_code Eliminar un tracking_code

Info del sitio

GET  /v1/shops/{SHOP_ID}?access_token={ACCESS_TOKEN} 
Obtener la información de un sitio en MercadoShops

Mostrar ejemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_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=**************
id
ID de usuario
Tipo
NUMERICO
status
Estado del sitio
Tipo
STRING
Valores
active
Activo
close
Cerrado
locale
Idioma _ Codigo Pais
Tipo
STRING
Para obtener el listado de codigos de paises habilitados utiliza este recurso:
https://api.mercadolibre.com/XXXX
shop_name
Nombre del Sitio
Tipo
STRING
email
Email de contacto del sitio
Tipo
STRING
plan
Tipo del plan contratado en mercadoshops
Tipo
STRING
admin_url
URL de administración del Sitio
Tipo
STRING
url
URL del Sitio
Tipo
STRING
has_logo
Tiene logo
Tipo
BOOLEAN (true / false)
address
{
Descripcion
Direccion
Tipo
Objeto
country
Codigo del Pais
Tipo
STRING
Para obtener el listado de codigos de paises habilitados utiliza este recurso:
https://api.mercadolibre.com/countries/
state
Codigo del estado/provicia del Pais
Tipo
STRING
Para obtener el listado de codigos de estados/provincias de cada pais utiliza este recurso:
https://api.mercadolibre.com/countries/{CODIGO_PAIS}
zip
Codigo Postal
Tipo
STRING
address
Domicilio
Tipo
STRING
phone
Teléfono
Tipo
STRING
}
{
id
199999924,
status
active,
locale
es_AR,
shop_name
"mercadoshops_demo",
email
"demo_demo@mercadoshops.com",
plan
"professional_plus",
admin_url
"http://admin.mercadoshops_demo.com.ar",
url
" http://mercadoshops_demo.com.ar ",
has_logo
true,
address
{
country
"AR",
state
"AR-B",
city
"Olivos",
zip
null,
address
"MI callle 1000 Dto 1",
phone
"+54911000099999"
}
}
ERRORES :
403: Token Invalido o SHOP_ID incorrecto

Metricas

API de métricas y códigos de seguimiento

Indice de acciones en Metricas:

Listar tracking_codes por usuario Obtener un tracking_code por id Crear un tracking_code Modificar un tracking_code Eliminar un tracking_code

Acciones

LISTAR TRACKING_CODES POR USUARIO

Retorna una lista de todos los tracking_code activos asociados al usuario, opcionalmente filtrada por event y/o provider.

GET  /shops/{SHOP_ID}/metrics?event=$event&provider=$provider 

Mostrar ejemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/ metrics?event={event}&provider={provider}&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 de mercadolibre / mercadoshops https://api.mercadoshops.com/v1/shops/{SHOP_ID}/ metrics?acess_token=**************
Event (opcional) NAVIGATION
BUY_BUTTON
CONTACT_BUTTON
PAY_BUTTON
CONGRAT_PAGE
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/ metrics?event=NAVIGATION&acess_token=**************
Provider (opcional) G_ANALYTICS
G_ADWORDS
M_CLICS
EBIT_SURVEY
EBIT_STAMP
FB_AD
OTHER
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/ metrics?provider=FB_AD&acess_token=**************
HTTP STATUS 200 OK
{
id
Id de código de seguimiento
Tipo
NUMERICO
shop_id
ID de usuario
Tipo
NUMERICO
name
nombre que describe el código de seguimiento
Tipo
STRING
code
el snippet HTML que se incluirá en el sitio web
Tipo
STRING
options
JSON - un mapa de opciones, específico al 'provider'
Tipo
STRING (JSON)
provider
Tipo de proveedor
Tipo
STRING
Valores posibles
G_ANALYTICS
G_ADWORDS
M_CLICS
EBIT_SURVEY
EBIT_STAMP
FB_AD
OTHER
event
Tipo de evento
Tipo
STRING
Valores posibles
NAVIGATION
BUY_BUTTON
CONTACT_BUTTON
PAY_BUTTON
CONGRAT_PAGE
status
estado
Tipo
STRING
Valores posibles
ACTIVE
INACTIVE
}
{
id
3***51,
shop_id
15****4,
name
Test API2,
code
"",
options
"",
provider
"OTHER",
event
"NAVIGATION",
status
"ACTIVE"
}
ERRORES :
401 Unauthorized: Unauthorized {"error": "You are unauthorized to make this request"}
400 Unauthorized: Bad Request {"error": "Invalid filter parameter"}
OBTENER UN TRACKING_CODE POR ID

Retorna el tracking_code identificado por id.

GET  /shops/{shop_id}/metrics/{id} 

Mostrar ejemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/metrics?{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 de mercadolibre / mercadoshops https://api.mercadoshops.com/v1/shops /15XXXXX24/
ID Id de tracking https://api.mercadoshops.com/v1/shops /15XXXXX24/metrics/11111111?acess_token=**************
Retorna el tracking_code identificado por id.
HTTP STATUS 200 OK
{
id
3***9,
shop_id
15*****4,
name
"Test API",
code
"<!-- Begin test Embed Code --><!-- End testEmbed Code -->",
options
{
},
provider
"OTHER",
event
"NAVIGATION",
status
"ACTIVE"
}
ERRORES :
401 Unauthorized: Unauthorized {"error": "You are unauthorized to make this request"}
400 Unauthorized: Bad Request {"error": "Invalid filter parameter"}
CREAR UN TRACKING_CODE

Crea un tracking_code y devuelve el objeto creado.

POST  HEADER: Content-Type: application/json
     /shops/{shop_id}/metrics 

Mostrar ejemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/metrics?{id}&access_token={token}
Retorna el tracking_code identificado por id.
HTTP STATUS 201 CREATED
{
id
3***9,
shop_id
1******24,
name
"Test API",
code
"<!-- Begin test Embed Code --><!-- End testEmbed Code -->",
options
{
},
provider
"OTHER",
event
"NAVIGATION",
status
"ACTIVE"
}
ERRORES :
401 Unauthorized: Unauthorized {"error": "You are unauthorized to make this request"}
400 Unauthorized: Bad Request {"error": "Invalid filter parameter"}
MODIFICAR UN TRACKING_CODE

Modifica un tracking_code y devuelve el objeto modificado.

PUT  HEADER :  Content-Type: application/json                      
     /shops/{shop_id}/metrics/{id} 

Mostrar ejemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/metrics?{id}&access_token={token}

Para modificar un atributo del tracking creado hay que hacer un PUT a la url indicada con un JSON que incluya el atributo y su nuevo valor.
Ejemplo de JSON de cambio de del atributo [name]:
{name: "Test API2 - CHANGED"}

Retorna el tracking_code modificado por id.
HTTP STATUS 200 OK
{
name
"Test API2 - CHANGED",
}
ERRORES :
401 Unauthorized: Unauthorized {"error": "You are unauthorized to make this request"}
400 Unauthorized: Bad Request {"error": "Invalid filter parameter"}
404 Not found: {"error": "Tracking code not found"} 
ELIMINAR UN TRACKING_CODE

Elimina un tracking_code.

DELETE  /shops/{shop_id}/metrics/{id} 

Mostrar ejemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/metrics?{id}&access_token={token}
HTTP STATUS 204 NO CONTENT
ERRORES :
401 Unauthorized: Unauthorized {"error": "You are unauthorized to make this request"}
400 Unauthorized: Bad Request {"error": "Invalid filter parameter"}

CATEGORIAS

En MercadoShops permitimos armar tu propio árbol de categorías donde podrás agrupar tus publicaciones.

Este árbol no podrá tener mas de 3 niveles de profundidad y las publicaciones podrán pertenecer a cualquiera de ellas.

Indice

Categorías Principales Árbol de categorías Búsqueda por Id

Categorías Principales

Retorna las categorías raíces del shop

GET /v1/shops/{shop_id}/categories
Mostrar ejemplo https://api.mercadoshops.com/v1/shops/{shop_id}/categories

Parámetros

ParámetroValoresEjemplo
SHOP_ID Id de usuario https://api.mercadoshops.com/v1/shops/15XXXXX24/categories
[{
"id"
Id de categoría
Tipo
NUMERICO
"shop_id"
Id del Sitio
Tipo
NUMERICO
"position"
Orden en que se mostraran las categoría
Tipo
NUMERICO
"name"
Nombre descriptivo de la categoría
Tipo
STRING
"default_category"
Categoría por default
Tipo
BOOLEANO
"permalink"
Permalink
Tipo
STRING
"date_created"
Fecha de creación de la categoría
Tipo
Date(ISO_8601)
"last_updated"
Fecha de modificación de la categoría
Tipo
Date(ISO_8601)
}]
[{
"id"
5036867,
"shop_id"
2XXX8,
"position"
1,
"name"
"Libros, Revistas y Comics",
"default_category"
false,
"permalink"
"http://xxxxx.mercadoshops.com.ar/libros-revistas-y-comics_qO5036867XtOcxSM",
"date_created"
"2015-08-10T15:07:33.000-04:00",
"last_updated"
"2015-08-10T15:07:33.000-04:00",
}]

Errores

HTTP CODE: 404 Categoría no encontrada
HTTP CODE: 400 Id de categoría debe ser númerico

Árbol de categorías

Retorna todas las categorías del shop, de todos los niveles, mostrando la relación padre-hijo.

GET /v1/shops/{shop_id}/categories/tree
Mostrar ejemplo https://api.mercadoshops.com/v1/shops/{shop_id}/categories/tree

Parámetros

ParámetroValoresEjemplo
SHOP_ID Id de usuario https://api.mercadoshops.com/v1/shops/15XXXXX24/categories/tree
[{
"id"
Id de categoría
Tipo
NUMERICO
"shop_id"
Id del Sitio
Tipo
NUMERICO
"position"
Orden en que se mostraran las categoría
Tipo
NUMERICO
"name"
Nombre descriptivo de la categoría
Tipo
STRING
"default_category"
Categoría por default
Tipo
BOOLEANO
"permalink"
Permalink
Tipo
STRING
"date_created"
Fecha de creación de la categoría
Tipo
Date(ISO_8601)
"last_updated"
Fecha de modificación de la categoría
Tipo
Date(ISO_8601)
"children"
[ Datos de las categorías hijas
Tipo
ARRAY de Objetos
{
"id"
Id de categoría
Tipo
NUMERICO
"parent_id"
Id de categoría padre
Tipo
NUMERICO
"shop_id"
Id del Sitio
Tipo
NUMERICO
"position"
Orden en que se mostraran las categoría
Tipo
NUMERICO
"name"
Nombre descriptivo de la categoría
Tipo
STRING
"default_category"
Categoría por default
Tipo
BOOLEANO
"permalink"
Permalink
Tipo
STRING
"date_created"
Fecha de creación de la categoría
Tipo
Date(ISO_8601)
"last_updated"
Fecha de modificación de la categoría
Tipo
Date(ISO_8601)
}
]
}]
[{
"id"
5036867,
"shop_id"
2XXX8,
"position"
1,
"name"
"Libros, Revistas y Comics",
"default_category"
false,
"permalink"
"http://xxxxx.mercadoshops.com.ar/libros-revistas-y-comics_qO5036867XtOcxSM",
"date_created"
"2015-08-10T15:07:33.000-04:00",
"last_updated"
"2015-08-10T15:07:34.000-04:00",
"children"
[
{
"id"
5036868,
"parent_id"
5036867,
"shop_id"
2XXX8,
"position"
1,
"name"
"Libros",
"default_category"
false,
"permalink"
"http://xxxxx.mercadoshops.com.ar/libros_qO5036868XtOcxSM",
"date_created"
"2015-08-10T15:07:33.000-04:00",
"last_updated"
"2015-08-10T15:07:34.000-04:00",
}]

Errores

HTTP CODE: 404 Categoría no encontrada
HTTP CODE: 400 Id de categoría debe ser númerico

Búsqueda por id

Retorna información acerca de la categoría específicada.

GET /v1/shops/{shop_id}/categories/{category_id}
Mostrar ejemplo https://api.mercadoshops.com/v1/shops/{shop_id}/categories/{category_id}

Parámetros

ParámetroValoresEjemplo
SHOP_ID Id de usuario https://api.mercadoshops.com/v1/shops/15XXXXX24/categories
CATEGORY_ID Id de category https://api.mercadoshops.com/v1/shops/15XXXXX24/categories/5036867
{
"id"
Id de categoría
Tipo
NUMERICO
"shop_id"
Id del Sitio
Tipo
NUMERICO
"position"
Orden en que se mostraran las categoría
Tipo
NUMERICO
"name"
Nombre descriptivo de la categoría
Tipo
STRING
"default_category"
Categoría por default
Tipo
BOOLEANO
"permalink"
Permalink
Tipo
STRING
"date_created"
Fecha de creación de la categoría
Tipo
Date(ISO_8601)
"last_updated"
Fecha de modificación de la categoría
Tipo
Date(ISO_8601)
}
{
"id"
5036867,
"shop_id"
2XXX8,
"position"
1,
"name"
"Libros, Revistas y Comics",
"default_category"
false,
"permalink"
"http://xxxxx.mercadoshops.com.ar/libros-revistas-y-comics_qO5036867XtOcxSM",
"date_created"
"2015-08-10T15:07:33.000-04:00",
"last_updated"
"2015-08-10T15:07:34.000-04:00",
}

Errores

HTTP CODE: 404 Categoría no encontrada
HTTP CODE: 400 Id de categoría debe ser númerico

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

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

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

VENTAS

Permite buscar ventas realizadas sobre publicaciones tanto en mercadolibre como en el sitio.

Indice

Busqueda Busqueda por Id Busqueda por filtros Actualizar los datos de Facturación Actualizar los datos de Shipping

Acciones

BUSQUEDA POR ID

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

GET  /v1/shops/{SHOP_ID}/orders/{ORDER_ID} 

Mostrar ejemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/orders/{order_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/
ORDER_ID Id de venta https://api merdoshops.com/v1/shops/15XXXXX24/orders/11111111?acess_token=**************
{
id
Id unico de VENTA
Tipo
STRING
store_id
Id del sitio
Tipo
NUMERICO
channel
Canal de venta la de publicacion
Tipo
STRING
Valores Posibles:
mshops
mercadoshops
meli
mercadolibre
external_reference
Numero de Referencia externa de la venta
Tipo
NUMERICO
currency
Moneda de la venta
Tipo
STRING
amount
Monto de la Venta
Tipo
NUMERICO
products_total
Suma total de los importes de productos
Tipo
NUMERICO
products_discounts_total
Suma total de los importes de descuentos en productos
Tipo
NUMERICO
products_grand_total
Suma total de los importes de productos incluyendo descuentos
Tipo
NUMERICO
discounts_total
Suma total de los descuentos
Tipo
NUMERICO
shipping_total
Suma total de los importes de envios
Tipo
NUMERICO
grand_total
Suma total de la VENTA
Tipo
NUMERICO
creation_date
Fecha de realización de la VENTA
Tipo
Date(ISO_8601)
buyer_message
Mensaje del comprador
Tipo
STRING
status
{ Estados de la venta
Tipo
OBJETO
delivered
Despachado
Tipo
BOOLEAN
Valores Posibles
true
Despacho realizado
false
Despacho sin realizar
paid
Pagado
Tipo
BOOLEAN
Valores Posibles
true
Pago realizado
false
Pago sin realizar
closed
Venta Cerrada
Tipo
BOOLEAN
Valores Posibles
true
Venta cerrada
false
Venta abierta
closed_reason
motivo de venta cerrada
Tipo
STRING
closed_date
Fecha de cierre de la VENTA
Tipo
Date(ISO_8601)
processed
Procesada
Tipo
BOOLEAN
Valores Posibles
true
Venta procesada
false
Venta sin procesar
processed_date
Fecha de procesamiento de la VENTA
Tipo
Date(ISO_8601)
contact_data_status
new,
order_status
null
},
buyer
{ COMPRADOR
Tipo
OBJETO
id
Id de Usuario en mercadolibre
Tipo
NUMERICO
meli_cust_id
null,
name
nombre y apellido del comprador
Tipo
STRING
nickname
null,
client_id
Id de Usuario en mercadoshops
Tipo
NUMERICO
mail
mail del comprador
Tipo
STRING
mail2
mail2 del comprador
Tipo
STRING
phone
Teléfono del comprador
Tipo
STRING
phone2
Teléfono2 del comprador
Tipo
STRING
doc_number
número de documento
Tipo
NUMERICO
doc_type
tipo de documento
Tipo
STRING
},
billing_data
{ Datos de facturación
Tipo
OBJETO
store_id
Id del sitio
Tipo
NUMERICO
name
nombre y apellido del comprador
Tipo
STRING
email
email del comprador
Tipo
STRING
phone
Teléfono del comprador
Tipo
STRING
zip_code
código postal del comprador
Tipo
STRING
address
{ Direccion
Tipo
OBJETO
additional_info
Información adicional del domicilio del comprador
Tipo
STRING
street
Calle del domicilio del comprador
Tipo
STRING
number
numero del domicilio del comprador
Tipo
STRING
city
ciudad del domicilio del comprador
Tipo
STRING
state
ID del estado/provincia del País
Tipo
STRING
Para obtener el listado de IDs de estados/provincias de cada pais utiliza este recurso :
EJEMPLO:
id
"AR-B",
name
"Buenos Aires"
},
recipient
{
doc_number
Documento de la persona que recibe el producto
Tipo
STRING
type
Tipo de Documento de la persona que recibe el producto
Tipo
STRING
},
id
Id de los datos de facturación
Tipo
NUMERICO
},
payments
[ Datos de PAGOS
Tipo
OBJETO
{
id
Id del PAGO
Tipo
NUMERICO
external_reference
Numero de referencia externa del PAGO
Tipo
NUMERICO
status
Estado del pago
Tipo
STRING
Valores Posibles
pending
El usuario no completo el proceso de pago
approved
El pago fue aprobado y acreditado
in_process
El pago esta siendo revisado
rejected
El pago fue rechazado .El usuario puede reiterar el pago.
cancelled
El pago fue cancelado por una de las partes, o el tiempo de espera de pago expiro.
refunded
El pago fue devuelto al usuario.
charged_back
Se hizo un contracargo a la tarjeta de crédito del usuario.
provider
Empresa que gestiono el pago
Tipo
STRING
method
Método de pago
Tipo
STRING
currency
Moneda del pago
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
amount
Monto del pago
Tipo
NUMERICO
paid
Venta Pagada
Tipo
BOOELAN
Valores Posibles
true
Venta Pagada
false
Venta NO Pagada
paid_date
Fecha de pago de la VENTA
Tipo
Date(ISO_8601)
installments
Cantidad de cuotas del pago
Tipo
NUMERICO
fees
{ Cargos / Comisiones
Tipo
OBJETO
finance_fee
Monto del cargo financiero
Tipo
NUMERICO
}
}
],
shippings
[ Datos de ENVIO
Tipo
OBJETO
{
id
Id de ENVIO
Tipo
NUMERICO
external_reference
Numero de referencia externa de ENVIO
Tipo
NUMERICO
ship_type
Tipo de Envio
Tipo
STRING
Valores Posibles
not specified
Significa que el vendedor no especificó ningún precio del envío de sus artículos y el comprador tiene que ponerse en contacto con el vendedor para acordar una opción de envío y el precio de la compra.
custom
Los vendedores pueden incluir una tabla de hasta 10 costos de envío en un item.
me1
(MercadoEnvios mode 1) Este método ofrece una calculadora de envíos para obtener el coste de envío para todos los items que permite al vendedor elegir.
me2
(MercadoEnvios mode 2) Este método proporciona al vendedor una etiqueta y código deseguimiento pre-pago con la compañía de transporte elegida por MercadoLibre.
channel_status
channel_status
status
status
receiver
{ Datos de la persona que recibe el producto
Tipo
OBJETO
doc_number
Número de documento
Tipo
NUMERICO
doc_type
tipo de documento
Tipo
STRING
name
nombre y apellido
Tipo
STRING
email
email
Tipo
STRING
phone
teléfono
Tipo
STRING
address
Dirección de entrega
Tipo
STRING
zip
Código Postal
Tipo
STRING
neighbourhood
Barrio
Tipo
STRING
municipality
Municipalidad
Tipo
STRING
city
Ciudad
Tipo
STRING
state_id
ID del estado/provincia del País
Tipo
STRING
Para obtener el listado de IDs de estados/provincias de cada país utiliza este recurso:
Ejemplo:
id
AR-B,
name
Buenos Aires
country_id
ID del País
Tipo
STRING
Para obtener el listado de codigos de paises habilitados utiliza este recurso:
Ejemplo:
id
AR,
name
Argentina
locale
es_AR
currency_id
ARS
},
additional_info
Información adicional
Tipo
STRING
method_id
Id del método de entrega
Tipo
NUMERICO
method
Método de entrega
Tipo
STRING
currency
Moneda del pago
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
amount
Importe del envío
Tipo
NUMERICO
tracking_code
Código de seguimiento del envío
Tipo
STRING
observations
Observaciones
Tipo
STRING
date_created
Fecha de alta del envío
Tipo
Date(ISO_8601)
}
],
invoice
{ Datos de la Factura
Tipo
OBJETO
invoiced
Venta Facturada
Tipo
BOOLEAN
Valores Posibles
true
Venta Facturada
False
Venta NO Facturada
type
Tipo de comprobante
Tipo
STRING
number
Numero de comprobante
Tipo
STRING
invoiced_date
Fecha de Facturación de la VENTA
Tipo
Date(ISO_8601)
},
products
[ Productos comprados
Tipo
ARRAYS
{
id
ID de Producto
Tipo
NUMERICO
channel
Canal de venta la publicación
Tipo
STRING
Valores Posibles
mshops
mercadoshops
meli
mercadolibre
external_reference
Referencia externa del id de producto
Tipo
STRING
sku
"UWD5U": SKU del producto.
Código de identificación del producto.
Tipo
STRING
SKU según wikipwedia:
title
Titulo de la publicación.
Tipo
STRING
quantity
Cantidad Vendida
Tipo
NUMERICO
method
Método de entrega
Tipo
STRING
currency
Moneda de la 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
unit_price
Precio Unitario del producto
Tipo
NUMERICO
amount
Cantidad Vendida * Precio Unitario. Importe total
Tipo
NUMERICO
free_shipping
Indica si la publicación tiene envío gratis
Tipo
BOOLEAN
Valores Posibles
true
ENVIO GRATIS
false
SIN ENVIO GRATIS
meli_variation_id
Si es un producto de MercadoLibre indica el ID de la variación talle / color del producto
Tipo
NUMERICO
variations
[ Datos de la Variación ( talle y color )
Tipo
OBJETO
{
name
Nombre de la variación
Tipo
STRING
value
Valor de la variación
Tipo
STRING
}
],
promotion
Promoción incluida en el producto
Tipo
STRING
},
PRODUCTO NRO 2
{
PRODUCTO NRO 3
},
{
PRODUCTO NRO 4
},
{
PRODUCTO NRO 5
}
],
notes
[],
feedback
{
buyer
null,
seller
null
},
promotions
[],
free_shipping
false
}
{
id
1999999999999,
store_id
15999999999,
channel
"meli",
external_reference
999999999999,
currency
"ARS",
amount
1405,
products_total
1405,
products_discounts_total
0 ,
products_grand_total
1405 ,
discounts_total
0 ,
shipping_total
57.99 ,
grand_total
1462.99 ,
creation_date
" 2015-09-10T07:31:03.000-04:00 ",
buyer_message
null ,
products_discounts_total
0 ,
products_discounts_total
0 ,
status
{
delivered
false,
paid
true,
closed
false,
closed_reason
null,
closed_date
null,
processed
true,
processed_date
null,
contact_data_status
"new",
order_status
"paid",
},
buyer
{
id
899999999999,
meli_cust_id
15399999999,
name
"Carlos Perez",
nickname
"CARLLLLLLLLLLL",
client_id
379999999999,
mail
carlos.perez@gmail.com,
mail2
null,
phone
"11-4444-5555",
phone2
null,
doc_number
"123456789",
doc_type
"DNI",
},
payments
[
{
id
1199999999,
external_reference
130299999999999,
status
"approved",
provider
"mercadopago",
method
"pagofacil",
currency
"ARS",
amount
1405,
paid
true,
paid_date
"2015-09-16T09:47:28.000-04:00",
installments
null,
fees
{
finance_fee
null
}
}
],
shippings
[
{
id
4699999,
external_reference
21499999,
ship_type
"me2",
channel_status
"on_route",
status
"on_route",
receiver
{
doc_type
null,
doc_number
"9999999999",
name
"Carlos Perez",
email
"carlos.perez@gmail.com",
phone
"0353999999",
address
"Calle 51",
zip
"999",
neighbourhood
null,
municipality
null,
city
"Las 99999",
state_id
"AR-X",
country_id
"AR",
},
additional_info
null,
method_id
152,
method
"Estándar",
currency
"ARS",
amount
57.99,
tracking_code
"3899999999999961",
observations
null,
date_created
"2015-09-16T09:47:31.000-04:00"
}
],
invoice
{
invoiced
false,
type
null,
number
null,
invoiced_date
null,
},
products
[
{
id
879999910,
channel
"meli",
external_reference
"MLA99999999999",
sku
null,
title
"Zapatillas 99999",
sku
null,
quantity
1,
currency
"ARS",
unit_price
1405,
amount
1405,
free_shipping
false,
meli_variation_id
91999949,
variations
[
{
name
"Color Primario",
value
"Negro"
},
{
name
"Talle",
value
"41.5"
},
{
name
"Color Secundario",
value
"Azul"
}
],
promotion
null
}
],
notes
[],
feedback
{
buyer
null,
seller
null
},
promotions
[],
free_shipping
null
}
BUSQUEDA POR FILTROS
GET  /v1/shops/{SHOP_ID}/orders/SEARCH 

Mostrar ejemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/orders/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 new: Nueva Venta

first_contact: Primer contacto realizado

confirmed_data: Venta con datos de contacto confirmado
status=new
processed true: venta procesada

false: sin procesar
processed=true
paid true: venta pagada

false: no pagada
paid=true
delivered true: venta despachada

false: sin despacahar
delivered=true
closed true: venta cerrada

false: sin cerrar
closed=true
channel mshops: canal de venta mercadoshops

meli: canal de venta mercadolibre
channel=mshops
buyer_feedback true: calificación del comprador realizada

false: calificación del comprador pendiente
buyer_feedback=true
seller_feedback true: calificación del vendedor realizada

false: calificación del vendedor pendiente
seller_feedback=true
feedback true: calificación del comprador y vendedor realizada

false: calificación del comprador y vendedor pendiente
feedback=true
shipping Pending : Envio pendiente

pickup: Envio levantado del vendedor

on_route: Envio en viaje

print_tag: etiqueta impresa

to_be_agreed: envio a convener

in_progress: en progreso

delivered: Entregado
shipping=pending

PAGINADO Y ORDENAMIENTO

NombreValoresEjemplo
limit Limite de registros devueltos limit=10
orders creation_date_asc

Orden por fecha de creacion ascendente

creation_date_desc

Orden por fecha de creacion descendente

client_id_asc

Orden por cliente_id ascendente

client_id_desc

Orden por cliente_id descendente

name_asc

Orden por nombre de l cliente ascendente

name_desc

Orden por nombre del cliente descendente

total_last_updated_asc

Orden total por ultima actualizacion ascendente

total_last_updated_sasc

Orden total por ultima actualizacion de ascendente
orders=creation_date_asc
{
seller_id
Id usuario de mercadolibre / mercadoshops
Tipo
NUMERICO
query
palabra que se utilizó 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
[
{
Estructura de Respuesta de una VENTA
},
{
Estructura de Respuesta de una VENTA
},
],
orders
[ Ordenamiento APLICADO
Tipo
OBJETO
{
id
"creation_date_desc",
name
"Order by creation date descending"
}
],
filters
[ Filtros APLICADOS
Tipo
OBJETO
{
id
"channel",
name
"Channel",
values
[
{
id
"meli",
name
"Meli orders",
results
707
}
]
}
],
available_orders
[ Ordenamiento Disponibles
Tipo
OBJETO
{
id
"creation_date_asc",
name
"Order by creation date ascending"
},
{
id
"creation_date_desc",
name
"Order by creation date descending"
},
{
id
"client_id_asc",
name
"Order by client id ascending"
},
{
id
"client_id_desc",
name
"Order by client id descending"
},
{
id
"name_asc",
name
"Order by client name ascending"
},
{
id
"name_desc",
name
"Order by client name ascending"
},
{
id
"total_last_updated_asc",
name
"Order by total last updated ascending"
},
{
id
"total_last_updated_desc",
name
"Order by total last updated descending"
}
],
available_filters
[ Filtros Disponibles
Tipo
OBJETO
{
id
"status",
name
"Status",
values
[
{
id
"new",
name
"New orders",
results
0
},
{
id
"first_contact",
name
"Orders with first contact made",
results
0
},
{
id
"confirmed_data",
name
"Orders with confirmed data",
results
0
},
]
},
{
id
"processed",
name
"Processed",
values
[
{
id
"true",
name
"Processed orders",
results
0
},
{
id
"false",
name
"Not processed orders",
results
0
}
]
},
{
id
"paid",
name
"Paid",
values
[
{
id
"true",
name
"Paid orders",
results
0
},
{
id
"false",
name
"Not paid orders",
results
0
}
]
},
{
id
"delivered",
name
"Delivered",
values
[
{
id
"true",
name
"Delivered orders",
results
0
},
{
id
"false",
name
"Not delivered orders",
results
0
}
]
},
{
id
"closed",
name
"Closed",
values
[
{
id
"true",
name
"Closed orders",
results
0
},
{
id
"false",
name
"Not closed orders",
results
0
}
]
},
{
id
"channel",
name
"Channel",
values
[
{
id
"meli",
name
"Meli orders",
results
707
},
{
id
"mshops",
name
"Mshops orders",
results
0
}
]
},
{
id
"buyer_feedback",
name
"Buyer_feedback",
values
[
{
id
"true",
name
"Buyer feedback completed",
results
0
},
{
id
"false",
name
"Buyer feedback not completed",
results
0
}
]
},
{
id
"seller_feedback",
name
"Seller_feedback",
values
[
{
id
"true",
name
"Seller feedback completed",
results
0
},
{
id
"false",
name
"Seller feedback not completed",
results
0
}
]
},
{
id
"feedback",
name
"Feedback (buyer + seller)",
values
[
{
id
"true",
name
"Seller and buyer feedback completed",
results
0
},
{
id
"false",
name
"Seller and buyer feedback not completed",
results
0
}
]
},
{
id
"shipping",
name
"Shipping status",
values
[
{
id
"pending",
name
"Pending",
results
10
},
{
id
"pickup",
name
"Pickup",
results
0
},
{
id
"on_route",
name
"On_route",
results
14
},
{
id
"print_tag",
name
"Print_tag",
results
0
},
{
id
"to_be_agreed",
name
"To be agreed",
results
82
},
{
id
"in_progress",
name
"In progress",
results
82
},
{
id
"delivered",
name
"In progress",
results
579
}
]
},
{
id
"pending_process",
name
"Not processed orders",
values
[ Resumen de VENTAS Pendientes
Tipo
OBJETO
{
id
"pending_process",
name
"Not processed orders",
results
Cantidad de resultados
Tipo
NUMERICO
}
]
},
{
id
"pending_shipment",
name
"Not shipped orders",
values
[ Resumen de VENTAS con ENVIO Pendiente
Tipo
OBJETO
{
id
"pending_shipment",
name
"Not shipped orders",
results
Cantidad de resultados
Tipo
NUMERICO
}
]
},
{
id
"pending_feedback",
name
"Pending feedback orders",
values
[ Resumen de VENTAS con Calificación Pendiente
Tipo
OBJETO
{
id
"pending_feedback",
name
"Pending feedback orders",
results
Cantidad de resultados
Tipo
NUMERICO
}
]
},
{
id
"closed_orders",
name
"Closed orders",
values
[ Resumen de VENTAS con Calificación Pendiente
Tipo
OBJETO
{
id
"closed_orders",
name
"Closed orders",
results
Cantidad de resultados
Tipo
NUMERICO
}
]
}
]
}
ERRORES :
403: Token Invalido
ACTUALIZAR LOS DATOS DE FACTURACIÓN
PUT  /v1/shops/{SHOP_id}/orders/{ORDER_ID} 

Mostrar ejemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/orders/{ORDER_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 venta v1/shops/159999999/orders/999911111
Invoice
{ DATOS DE FACTURACIÓN
Tipo
OBJETO
Invoiced
Indica si esta facturado
Tipo
BOOLEAN
Valores Posibles
true
facturado
false
no facturado
number
número de comprobante
Tipo
STRING
type
tipo de comprobante
Tipo
STRING
}
{
invoice
{
invoiced
true,
number
"060300007620",
type
"FC"
}
}
ACTUALIZAR LOS DATOS DE SHIPPING

Mediante este método podes actualizar el status del shipping y el tracking code.

PUT  /v1/shops/{SHOP_id}/orders/{ORDER_ID}/shippings/{SHIPPING_ID} 

Mostrar ejemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/orders/{ORDER_ID}/shippings/{SHIPPING_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 venta v1/shops/159999999/orders/999911111
SHIPPING_ID ID de ENVIO  
status
estado del envío
Tipo
STRING
Valores posibles
pickup
Lo retira
pending
Pendiente de entrega
in_progress
En preparación
on_route
En camino
delivered
Entregado
tracking_code
código de seguimiento
Tipo
STRING
{
status
"pending",
tracking_code
"111111"
}