Última actualización 29/12/2022

Publicaciones con el Programa Ahora 12

f
Importante:
La campaña estará disponible en Argentina para vendedores habilitados , con productos nacionales de categorías específicas . Es responsabilidad del vendedor que los productos publicados realmente reúnan la condición de ser productos de origen nacional y pertenezcan a las categorías habilitadas.
Darme de alta a Ahora 12 en Mercado Libre .

Si estás adherido al Programa Ahora 12, podrás ofrecer hasta 12 cuotas al mismo precio que publiques en tus publicaciones Premium, y hasta 12 cuotas con interés más bajo para tus compradores en publicaciones Clásica, dependiendo de la categoría del producto.

Cuotas al mismo precio que publiques

Ahora 3: al aplicar este plan en publicaciones Premium elegibles para participar de Ahora 3, tendrás un descuento del 30% en el cargo por venta*. Así, van a poder comprarte en 3 cuotas al mismo precio que publiques y podrás ofrecer precios más competitivos. Para hacerlo, modifica tus publicaciones y activa la opción de 3 cuotas al mismo precio que publiques - Programa Ahora 12 en publicaciones Premium. Si tienes publicaciones Clásicas, pásalas a Premium y aprovecha este beneficio. Este descuento estará disponible en categorías seleccionadas.
*El descuento en el cargo por venta aplica exclusivamente a ventas en el Marketplace, no aplica para ventas de productos en las Tiendas de Mercado Shops (Términos y Condiciones).
Si tienes tienda de Mercado Shops te invitamos a acceder a la documentación para más detalles.

Ahora 6: al aplicar este plan en publicaciones Premium elegibles para participar de Ahora 6, tendrás un descuento del 15% en el cargo por venta*. Así, van a poder comprarte en 6 cuotas al mismo precio que publiques y podrás ofrecer precios más competitivos. Para hacerlo, modifica tus publicaciones y activa la opción de 6 cuotas al mismo precio que publiques - Programa Ahora 12 en publicaciones Premium.
Si tienes publicaciones Clásicas, pásalas a Premium y aprovecha este beneficio. Este descuento estará disponible en categorías seleccionadas.
*El descuento en el cargo por venta aplica exclusivamente a ventas en el Marketplace, no aplica para ventas de productos en las Tiendas de Mercado Shops (Términos y Condiciones).

Ahora 12: En publicaciones Premium elegibles para participar de Ahora 12, podrás ofrecer 12 cuotas al mismo precio que publiques y aumentar tus ventas. Tendrás que pagar un cargo por venta de 9 puntos porcentuales adicionales al que ya pagas en cada categoría*. "Por ejemplo, si el cargo de Premium es del 31%, para ofrecer estas cuotas pagarás el 40% por venta. Para ofrecer esta mayor financiación, modifica tus publicaciones y activa la opción de 12 cuotas al mismo precio que publiques - Ahora 12 en publicaciones Premium.
Si tienes tienda de Mercado Shops te invitamos a acceder a la documentación para más detalles. .

Cuotas con interés

Todas tus publicaciones en Clásica ya poseen cuotas con interés para tus compradores. Si eliges ofrecer cuotas con el Programa Ahora 12, tus compradores tendrán mejor financiación, es decir, un interés más bajo en sus compras (dado que pagarán las tasas de financiación del Programa Ahora 12 - por ello el nombre del tag es ahora-paid-by-buyer, sin un costo adicional para ti (es decir, continuarás pagando el mismo cargo por venta en Clásico que antes).

Conocer si el usuario está habilitado para sumarse a la campaña

Realizar un GET al recurso /special_installments/ahora-12 (campaña Ahora 12 en Premium), /special_installments/ahora-6 (campaña Ahora 6 en Premium), /special_installments/ahora-3 (campaña Ahora 3 en Premium) o /special_installments/ahora-paid-by-buyer (Ahora 12 en Clásico) según corresponda, con el $SELLER_ID.

En caso que el usuario pueda participar, se mostrará la fecha en la que fue habilitado.


Llamada:

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

Ejemplo:

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

Respuesta:

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

Si el usuario no tiene permitido ofrecer el Programa Ahora 12, el resultado de la anterior consulta es el siguiente:

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

Conocer qué productos pueden sumarse a la campaña

Revisa si el producto es de fabricación nacional realizando un POST a:
- /special_installments/ahora-12/categories/$CATEGORY_ID/enabled
- /special_installments/ahora-6/categories/$CATEGORY_ID/enabled
- /special_installments/ahora-3/categories/$CATEGORY_ID/enabled
- /special_installments/ahora-paid-by-buyer/categories/$CATEGORY_ID/enabled
y en el body un JSON con la marca ($brand) y el modelo ($model) según corresponda.


Llamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/special_installments/ahora-12/categories/$CATEGORY_ID/enabled

Response Body: Se devolverá como respuesta el campo “enabled” con valor true o false, según corresponda.
Response Status: 200
Cacheable: Sí. Se devolverá el header “Cache-Control” con value “max-age=$max-age” indicando el tiempo recomendado en segundos para cachear la información que responde el recurso.


Ejemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/special_installments/ahora-12/categories/MLA1055/enabled
{
   "brand":"Motorola",
   "model":"Z1",
   "alphanumeric_model":"Z1 - 312 fD4"
}

Respuesta:

{
   "enabled":true
}

Este caso indica que un ítem con marca Motorola, modelo Z1 y modelo alfanumérico “Z1-312fD4” participa del programa.



Conocer si una publicación está en la campaña

Para consultar si un producto tiene habilitado 3,6 o 12 cuotas al mismo precio que publiques con el Programa Ahora 12 en Premium, realiza un GET al recurso /ítems con su item_id y verifica que tenga el tag ahora-12 o ahora-6 o ahora-3 dentro de los campos. Para consultar si un producto tiene habilitado Ahora 12 en Clásico, realiza un GET al mismo recurso con su item_id y verifica que tenga el tag ahora-paid-by-buyer.

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/MLA608007087

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_special",
   "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": [
       "ahora-12",
       "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": []
}


Ver cargos por venta filtrando campañas

A continuación, puedes consultar los costos de vender filtrando por precio, listing type y tag (ahora-3; ahora-6; ahora-12) y dominio.

En el caso de ahora-paid-by-buyer, los costos por vender son los mismos que en Clásico.


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=ahora-12&domain_id=MLA-NOTEBOOKS

Respuesta:

{
   "listing_type_id": "gold_pro",
   "listing_type_name": "Premium",
   "listing_exposure": "highest",
   "requires_picture": true,
   "currency_id": "ARS",
   "listing_fee_amount": 0,
   "sale_fee_amount": 3800,
   "average_sale_fee_detail": [],
   "sale_pricing_id": 21000641936,
   "listing_pricing_id": null,
   "sale_fee_details": {
       "pricing_ids": [
           21000641936,
           21000637281,
           21000637266,
           21000637284
       ],
       "discount_ids": [],
       "gross_amount": 3800,
       "fixed_fee": 0,
       "percentage_fee": 33,5,
       "split_fee_detail": null
   },
   "listing_fee_details": {
       "pricing_ids": [],
       "discount_ids": [],
       "gross_amount": 0,
       "fixed_fee": 0
   },
   "free_relist": false,
   "stop_time": "2041-08-18T00:00:00.000-04:00",
   "mapping": "gold_pro"
}

Es decir, el dominio Notebooks con el tag ahora-12 el cargo por venta será de 33,5%. Para más información, puedes consultar recursos para obtener los costos por vender.


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 ahora-12,ahora-6 , ahora-3 o ahora-paid-by-buyer. 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 12 cuotas con la participación del programa Ahora 12 deben ser productos nuevos y su publicación ser Premium, es decir, solo aquellas con listing_type_id = gold_pro.


Los ítems habilitados para ofrecer hasta 12 cuotas con el interés del Programa Ahora 12 deben ser productos nuevos y su publicación debe ser Clásico, es decir, solo aquellos con listing_type_id = gold_special.


Además, recuerda que el ítem debe estar dentro de las categorías, marcas y modelos habilitados que confirman que sea un producto nacional. Reconoce qué productos pueden sumarse a la campaña.


Llamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/itmes
{
    "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": [
        "ahora-12",
    
    ]
     ...
}

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": [
       "ahora-12",
       "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 http error 400 siempre que no cumplas los requisitos o en los casos que:

  • La categoría no esté habilitada para ofrecer más cuotas.
  • 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 (en el caso de las cuotas al mismo precio que publiques).
  • La marca o el modelo del producto no participa de la campaña.


Habilitar la campaña en una publicación

Para habilitar la campaña en un ítem, debes realizar un PUT al recurso /items incluyendo el tag ahora-12, ahora-6 ,ahora-3 o ahora-paid-by-buyer. Ten en cuenta si el ítem contiene otros tags, también deberán ser enviados en la modificación.


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


Los ítems habilitados para ofrecer hasta 12 cuotas con el interés del Programa Ahora 12 deben ser productos nuevos y su publicación ser Clásico, es decir, solo aquellos con listing_type_id = gold_special.


Además, recuerda que el ítem debe estar dentro de las marcas y modelos habilitados que confirman que sea un producto nacional. Reconoce qué productos pueden sumarse a la campaña.



Llamada: 
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
   "tags":[
      "ahora-12",
      "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":[
      "ahora-12"
   ]
}
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": [
       "ahora-12",
       "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 http error 400 siempre que no cumplas los requisitos o en los casos que:

  • La categoría no esté habilitada para ofrecer más cuotas.
  • 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 (en el caso de las cuotas al mismo precio que publiques).
  • La marca o el modelo del producto no participa de la campaña.

Deshabilitar la campaña en una publicación

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 ahora-12, ahora-6 , ahora-3 o ahora-paid-by-buyer 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_special",
   "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": []
}