Documentación Mercado Shops

Descubre toda la información que debes conocer sobre las APIs de Mercado Shops.
circulos azuis em degrade

Documentación

Última actualización 05/06/2024

Campañas con cuotas

f
Importante:
Recuerda que a partir de ahora, tus publicaciones se diferencian por las cuotas que agregues. Para que puedas identificar de una manera más clara qué ofrecen tus publicaciones, dejamos de llamarlas Clásica o Premium. Ver más.

Actualmente, contamos con un nuevo modelo de cuotas aplicables a tus publicaciones del canal de Mshops, en el cual podrás optar por elegir publicar con o sin cuotas.
Con la publicación Clásica (gold_special), ofrecés cuotas con interés a cargo de tus compradores, permitiendo que el comprador seleccione la opciones de cuotas de su preferencia. Mientras que con la publicación Premium (gold_pro) ofrecés la mejor financiación en cuotas a tu cargo, al momento de publicar o modificar tu publicación, podrás elegir la cantidad de cuotas que querés ofrecer. Revisá la tabla y encontrá los costos por ofrecer financiación que se suman al cargo por vender.

*Las campañas aplican exclusivamente a ventas en el canal de Mshops.


Publicaciones en las que eliges no agregar cuotas

Cuotas con interés bajo: con esta opción pagás un 4% por ofrecer a tus compradores de 3 a 12 cuotas con un interés menor que el de los bancos. Así podrás ofrecer precios más competitivos. Para hacerlo, modifica tus publicaciones y actívala con el tag mshops_pcj-co-funded.



Publicaciones en las que eliges agregar cuotas

3 cuotas al mismo precio que publiques: Podrás elegir ofrecer 3 cuotas al mismo precio que publicaste y pagar menos de cargo por venta en tu tienda de Mercado Shops*. Así, podrás ofrecer precios más competitivos. Para hacerlo, modifica tus publicaciones y activa la opción de mshops_3x_campaign. Esta campaña estará disponible para todos los vendedores y en categorías seleccionadas.

  • Cuota Simple 3: en publicaciones de Argentina elegibles para participar de Cuota Simple 3. Así, van a poder comprarte en 3 cuotas al mismo precio que publicaste podrás ofrecer precios más competitivos. Para hacerlo, modifica tus publicaciones y activa la opción de mshops_cuota-simple-3.
  • Cuota Simple 6: en publicaciones de Argentina elegibles para participar de Cuota Simple 6. Así, van a poder comprarte en 6 cuotas al mismo precio que publicaste podrás ofrecer precios más competitivos. Para hacerlo, modifica tus publicaciones y activa la opción de mshops_cuota-simple-6.

Las campañas aplican exclusivamente a ventas en el canal de Mshops. Ver costos por agregar cuotas.



Comparación opciones de cuotas

Nota:
Es necesario tener en cuenta, que podemos activar nuevos tipos de campaña de cuotas que no están en el listado, y con esto, será necesario seguir el proceso de validación y activación en los items.

Publicaciones en las que eliges no agregar cuotas

Nombre de campaña Listing type Tag Marketplace Tag Mshops
No quiero agregar cuotas (el vendedor no tiene habilitado Cuota Simple) gold_special sin tag sin tag
No quiero agregar cuotas (el vendedor tiene habilitado Cuota Simple) gold_special cuota-simple-paid-by-buyer no aplica
3 a 12 cuotas con interés bajo gold_special pcj-co-funded mshops_pcj-co-funded

Publicaciones en las que eliges agregar cuotas

Nombre de campaña Listing type Tag Marketplace Tag Mshops
3 cuotas al mismo precio que publicaste gold_pro 3x_campaign mshops_3x_campaign
6 cuotas al mismo precio que publicaste gold_pro sin tag no aplica
3 cuotas al mismo precio que publicaste - Cuota Simple gold_pro cuota-simple-3 mshops_cuota-simple-3
6 cuotas al mismo precio que publicaste - Cuota Simple gold_pro cuota-simple-6 mshops_cuota-simple-6
9 cuotas al mismo precio que publicaste gold_pro 9x_campaign mshops_9x_campaign
12 cuotas al mismo precio que publicaste - Cuota Simple (Activación en 18/06/24) gold_pro cuota-simple-12 mshops_cuota-simple-12
12 cuotas al mismo precio que publicaste (Activación en 18/06/24) gold_pro 12x_campaign mshops_12x_campaign


Usuarios habilitados para campañas

Realizar un GET al recurso /special_installments/mshops_cuota-simple-6 (campaña cuota-simple-3 o mshops_cuota-simple-6) según corresponda, con el $SELLER_ID. En caso de que el usuario pueda participar, se mostrará la fecha en la que fue habilitado.

Nota:
Para las campañas de mshops_3x_campaign y mshops_pcj-co-funded no aplica, ya que todos los vendedores pueden participar sin limitaciones.

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/special_installments/mshops_cuota-simple/sellers/$SELLER_ID

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/special_installments/mshops_cuota-simple-6/sellers/1234

Respuesta:

{
   "date_created":"2019-08-30T16:09:10.941-04:00",
   "seller_id":1234
}

Si el usuario no tiene permitido ofrecer hasta 6 cuotas, el resultado de la anterior consulta es el siguiente: 

{
   "message": "seller does not exist",
   "error": "seller.not_found",
   "status": 404,
   "cause": []
}


Cargos por venta por campañas

Para consultar los costos por vender, debes realizar un GET al recurso /listing_prices filtrando por precio, listing_type, tag y dominio, según corresponda.

Recuerda:

  1. Respetar la relación listing_type+tag (ver opciones) .
  2. Filtrar por channel para ver las comisiones específicas. En caso contrario, verás por defecto las de marketplace.

Ejemplo del dominio Notebooks:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_prices?price=10000&listing_type_id=gold_pro&tags=3x_campaign&domain_id=MLA-NOTEBOOKS

Respuesta de campaña de 3 cuotas al mismo precio que publicaste:

[
    {
        "currency_id": "ARS",
        "free_relist": false,
        "listing_exposure": "highest",
        "listing_fee_amount": 0,
        "listing_fee_details": {
            "fixed_fee": 0,
            "gross_amount": 0
        },
        "listing_type_id": "gold_pro",
        "listing_type_name": "Premium",
        "requires_picture": true,
        "sale_fee_amount": 1983,
        "sale_fee_details": {
            "financing_add_on_fee": 15,
            "fixed_fee": 0,
            "gross_amount": 1983,
            "meli_percentage_fee": 4.83,
            "percentage_fee": 19.83
        },
        "stop_time": "2043-09-14T00:00:00.000-04:00"
    }
]

Es decir, el dominio Notebooks con el tag 3x_campaign, el cargo por venta en Mercado Shops será de 4.83% y el cargo por ofrecer cuotas será de 15%, total cargos de 19.83%. Para más información, puedes consultar recursos para obtener los costos por vender.


Ejemplo del dominio Notebooks para el canal de Mshop con 3 a 12 cuotas con interés bajo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_prices?price=10000&listing_type_id=gold_special&tags=mshops_pcj-co-funded&channel=mshops&domain_id=MLA-NOTEBOOKS

Respuesta de campaña 3 a 12 cuotas con interés bajo:

[
    {
        "currency_id": "ARS",
        "free_relist": false,
        "listing_exposure": "highest",
        "listing_fee_amount": 0,
        "listing_fee_details": {
            "fixed_fee": 0,
            "gross_amount": 0
        },
        "listing_type_id": "gold_special",
        "listing_type_name": "Clásica",
        "requires_picture": true,
        "sale_fee_amount": 883,
        "sale_fee_details": {
            "financing_add_on_fee": 4,
            "fixed_fee": 0,
            "gross_amount": 883,
            "meli_percentage_fee": 4.83,
            "percentage_fee": 8.83
        },
        "stop_time": "2043-09-14T00:00:00.000-04:00"
    }
]

Es decir, el dominio Notebooks con el tag mshops_pcj-co-funded, el cargo por venta en Mercado Shops será de 4.83% y el cargo por ofrecer de 3 a 12 cuotas será de 4%, total cargos de 8.83%..



Publicaciones en campaña

Para consultar si un producto tiene habilitado algunas de las campañas posibles de 3 a 12 cuotas con interés bajo, 3 cuotas al mismo precio que publicaste y algunas de las opciones de Cuota Simple 3 y 6, realiza un GET al recurso /items con su item_id y verifica que tenga el tag mshops_pcj-co-funded, mshops_3x_campaign, mshops_cuota-simple-3 o mshops_cuota-simple-6 dentro de los tags.


Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA1234123456

Respuesta:


{
    "id": "MLA1234123456",
    "site_id": "MLA",
    "title": "Procesador De Alimentos",
    "subtitle": null,
    "seller_id": 553421365,
    "category_id": "MLA3530",
    "official_store_id": null,
    "price": 34345345,
    "base_price": 34345345,
    "original_price": null,
    "currency_id": "ARS",
    "initial_quantity": 1000,
    "available_quantity": 500,
    "sold_quantity": 150,
    "sale_terms": [
        {
            "id": "WARRANTY_TYPE",
            "name": "Tipo de garantía",
            "value_id": "6150835",
            "value_name": "Sin garantía",
            "value_struct": null,
            "values": [
                {
                    "id": "6150835",
                    "name": "Sin garantía",
                    "struct": null
                }
            ]
        }
    ],
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_pro",
    "start_time": "2022-05-16T16:54:20.000Z",
    "stop_time": "2042-05-11T04:00:00.000Z",
    "condition": "new",
    "permalink": "https://articulo.mercadolibre.com.ar/MLA-1137574968-procesador-de-alimentos-_JM",
    "thumbnail_id": "979379-MLA45885016540_052021",
    "thumbnail": "http://http2.mlstatic.com/D_979379-MLA45885016540_052021-I.jpg",
    "secure_thumbnail": "https://http2.mlstatic.com/D_979379-MLA45885016540_052021-I.jpg",
    "pictures": [
        {
            "id": "979379-MLA45885016540_052021",
            "url": "http://http2.mlstatic.com/D_979379-MLA45885016540_052021-O.jpg",
            "secure_url": "https://http2.mlstatic.com/D_979379-MLA45885016540_052021-O.jpg",
            "size": "385x500",
            "max_size": "459x596",
            "quality": ""
        }
    ],
    "video_id": null,
    "descriptions": [],
    "accepts_mercadopago": true,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "not_specified",
        "methods": [],
        "tags": [],
        "dimensions": null,
        "local_pick_up": false,
        "free_shipping": false,
        "logistic_type": "not_specified",
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "city": {
            "name": "CABA"
        },
        "state": {
            "id": "AR-C",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "search_location": {
            "state": {
                "id": "TUxBUENBUGw3M2E1",
                "name": "Capital Federal"
            }
        },
        "id": 1098928639
    },
    "seller_contact": null,
    "location": {},
    "coverage_areas": [],
    "attributes": [
        {
            "id": "BRAND",
            "name": "Marca",
            "value_id": "276243",
            "value_name": "Genérica",
            "value_struct": null,
            "values": [
                {
                    "id": "276243",
                    "name": "Genérica",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "ITEM_CONDITION",
            "name": "Condición del ítem",
            "value_id": "2230284",
            "value_name": "Nuevo",
            "value_struct": null,
            "values": [
                {
                    "id": "2230284",
                    "name": "Nuevo",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [],
    "status": "active",
    "sub_status": [],
    "tags": [
        "good_quality_picture",
        "standard_price_by_channel",
        "test_item",
        "immediate_payment",
        "mshops_cuota-simple-6"
    ],
    "warranty": "Sin garantía",
    "catalog_product_id": null,
    "domain_id": "MLA-UNCLASSIFIED_PRODUCTS",
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2022-05-16T16:54:20.000Z",
    "last_updated": "2022-07-12T15:17:19.561Z",
    "health": 0.8,
    "catalog_listing": false,
    "channels": [
        "marketplace",
        "mshops"
    ]

Crear una publicación en una campaña

Para crear un ítem dentro de una campaña, debes realizar el POST al recurso /items incluyendo el tag correspondiente a la campaña que quieras sumar mshops_pcj-co-funded, mshops_3x_campaign, mshops_cuota-simple-3 o mshops_cuota-simple-6. Ten en cuenta de siempre enviar el atributo buying_mode, ya que es requerido en el POST para crear un ítem.


Los ítems habilitados para ofrecer hasta 6 cuotas con la participación del programa Cuota Simple deben ser productos nuevos y su publicación ser Premium, es decir, solo aquellas con listing_type_id: gold_pro.


Llamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items
{
    "title": "Item de testeo por favor no ofertar kc:off",
    "pictures": [
        ..
    ],
    "price": 53936,
    "variations": [],
    "shipping": {
        ..
    },
    "currency_id": "ARS",
    "location": {},
    "attributes": [
        ...
    ],
    "listing_type_id": "gold_pro",
    "available_quantity": 543,
    "category_id": "MLA1611",
    "condition": "new",
    "buying_mode": "buy_it_now",
    "tags": [
        "mshops_cuota-simple-6"       
    ]
     ...
}

Respuesta:

{
   "id": "MLA810693730",
   "site_id": "MLA",
   "title": "Item De Test - No Ofertar",
   "subtitle": null,
   "seller_id": 443024908,
   "category_id": "MLA3530",
   "official_store_id": null,
   "price": 100,
   "base_price": 100,
   "original_price": null,
   "inventory_id": null,
   "currency_id": "ARS",
   "initial_quantity": 1,
   "available_quantity": 1,
   "sold_quantity": 0,
   "sale_terms": [],
   "buying_mode": "buy_it_now",
   "listing_type_id": "gold_pro",
   "start_time": "2019-08-22T17:33:51.000Z",
   "stop_time": "2039-08-17T04:00:00.000Z",
   "end_time": "2039-08-17T04:00:00.000Z",
   "expiration_time": "2019-11-10T17:33:51.000Z",
   "condition": "new",
   "descriptions": [],
   "accepts_mercadopago": true,
   "non_mercado_pago_payment_methods": [],
   "international_delivery_mode": "none",
   "seller_contact": null,
   "location": {},
   "geolocation": {
       "latitude": -34.5780655,
       "longitude": -58.4265317
   },
   "coverage_areas": [],
   "warnings": [],
   "listing_source": "",
   "variations": [],
   "status": "active",
   "sub_status": [],
   "tags": [
       "mshops_cuota-simple-6",
        "immediate_payment",
        "test_item"
   ],
   "warranty": null,
   "catalog_product_id": null,
   "domain_id": "MLA-UNCLASSIFIED_PRODUCTS",
   "seller_custom_field": null,
   "parent_item_id": null,
   "differential_pricing": null,
   "deal_ids": [],
   "automatic_relist": false,
   "date_created": "2019-08-22T17:33:51.000Z",
   "last_updated": "2019-08-22T18:37:41.468Z",
   "health": null,
   "catalog_listing": false,
   "item_relations": []
}

Recuerda que retornaremos un error HTTP 400 siempre que no cumplas los requisitos o en los casos que:

  • El vendedor no esté habilitado para participar de la campaña.
  • El ítem sea usado o reacondicionado.
  • La exposición de la publicación sea distinta a Premium.


Habilitar una campaña

Para habilitar la campaña en un ítem, debes realizar un PUT al recurso /items incluyendo el tag correspondiente mshops_pcj-co-funded, mshops_3x_campaign , mshops_cuota-simple-3 o mshops_cuota-simple-6. Ten en cuenta que si el ítem contiene otros tags, también deberán ser enviados en la modificación.


Los ítems habilitados para ofrecer hasta 6 cuotas con la participación del programa Cuota Simple deben ser productos nuevos y su publicación ser Premium, es decir, solo aquellas con listing_type_id: gold_pro.


Llamada:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
   "tags":[
      "mshops_cuota-simple-6",
      "immediate_payment",
      "test_item"
   ]
}
https://api.mercadolibre.com/items/$ITEM_ID

Ejemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
   "tags":[
      "mshops_cuota-simple-6"
   ]
}
https://api.mercadolibre.com/items/MLA810693730

Respuesta:

{
   "id": "MLA810693730",
   "site_id": "MLA",
   "title": "Item De Test - No Ofertar",
   "subtitle": null,
   "seller_id": 443024908,
   "category_id": "MLA3530",
   "official_store_id": null,
   "price": 100,
   "base_price": 100,
   "original_price": null,
   "inventory_id": null,
   "currency_id": "ARS",
   "initial_quantity": 1,
   "available_quantity": 1,
   "sold_quantity": 0,
   "sale_terms": [],
   "buying_mode": "buy_it_now",
   "listing_type_id": "gold_pro",
   "start_time": "2019-08-22T17:33:51.000Z",
   "stop_time": "2039-08-17T04:00:00.000Z",
   "end_time": "2039-08-17T04:00:00.000Z",
   "expiration_time": "2019-11-10T17:33:51.000Z",
   "condition": "new",
   "descriptions": [],
   "accepts_mercadopago": true,
   "non_mercado_pago_payment_methods": [],
   "international_delivery_mode": "none",
   "seller_contact": null,
   "location": {},
   "geolocation": {
       "latitude": -34.5780655,
       "longitude": -58.4265317
   },
   "coverage_areas": [],
   "warnings": [],
   "listing_source": "",
   "variations": [],
   "status": "active",
   "sub_status": [],
   "tags": [
       "mshops_cuota-simple-6",
       "immediate_payment",
       "test_item"
   ],
   "warranty": null,
   "catalog_product_id": null,
   "domain_id": "MLA-UNCLASSIFIED_PRODUCTS",
   "seller_custom_field": null,
   "parent_item_id": null,
   "differential_pricing": null,
   "deal_ids": [],
   "automatic_relist": false,
   "date_created": "2019-08-22T17:33:51.000Z",
   "last_updated": "2019-08-22T18:37:41.468Z",
   "health": null,
   "catalog_listing": false,
   "item_relations": []
}

Recuerda que retornaremos un error HTTP 400 siempre que no cumplas los requisitos o en los casos que:

  • El vendedor no esté habilitado para participar de la campaña.
  • El ítem sea usado o reacondicionado.
  • La exposición de la publicación sea distinta a Premium.


Deshabilitar una campaña

Para deshabilitar la campaña en un ítem, debes realizar un PUT al recurso /ítems, incluyendo todos los tags que tenía anteriormente, excepto el tag que hace referencia a las campañas como mshops_pcj-co-funded, mshops_3x_campaign, mshops_cuota-simple-3 o mshops_cuota-simple-6 según corresponda:


Llamada:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "tags": [
       "immediate_payment",
       "test_item"
   ],
}
https://api.mercadolibre.com/items/$ITEM_ID

Ejemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "tags": [
       "immediate_payment",
       "test_item"
   ],
}
https://api.mercadolibre.com/items/MLA810693730

Respuesta:

{
   "id": "MLA810693730",
   "site_id": "MLA",
   "title": "Item De Test - No Ofertar",
   "subtitle": null,
   "seller_id": 443024908,
   "category_id": "MLA3530",
   "official_store_id": null,
   "price": 100,
   "base_price": 100,
   "original_price": null,
   "inventory_id": null,
   "currency_id": "ARS",
   "initial_quantity": 1,
   "available_quantity": 1,
   "sold_quantity": 0,
   "sale_terms": [],
   "buying_mode": "buy_it_now",
   "listing_type_id": "gold_pro",
   "start_time": "2019-08-22T17:33:51.000Z",
   "stop_time": "2039-08-17T04:00:00.000Z",
   "end_time": "2039-08-17T04:00:00.000Z",
   "expiration_time": "2019-11-10T17:33:51.000Z",
   "condition": "new",
   "descriptions": [],
   "accepts_mercadopago": true,
   "non_mercado_pago_payment_methods": [],
   "international_delivery_mode": "none",
   "seller_contact": null,
   "location": {},
   "geolocation": {
       "latitude": -34.5780655,
       "longitude": -58.4265317
   },
   "coverage_areas": [],
   "warnings": [],
   "listing_source": "",
   "variations": [],
   "status": "active",
   "sub_status": [],
   "tags": [
       "immediate_payment",
       "test_item"
   ],
   "warranty": null,
   "catalog_product_id": null,
   "domain_id": "MLA-UNCLASSIFIED_PRODUCTS",
   "seller_custom_field": null,
   "parent_item_id": null,
   "differential_pricing": null,
   "deal_ids": [],
   "automatic_relist": false,
   "date_created": "2019-08-22T17:33:51.000Z",
   "last_updated": "2019-08-22T18:37:41.468Z",
   "health": null,
   "catalog_listing": false,
   "item_relations": []
}