Publicaciones con hasta 18 cuotas sin interés

f
Importante:
La campaña estará disponible en Argentina y solo podrán participar vendedores seleccionados previamente, con productos nacionales de dominios específicos. Es responsabilidad del vendedor que los productos publicados realmente reúnan la condición de ser productos de origen nacional.

 

En publicaciones Premium elegibles para participar de Ahora 6, podrás elegir el descuento del 25% en el cargo por venta. Así, van a poder comprarte en 6 cuotas sin interés y podrás ofrecer precios más competitivos. Para hacerlo, modifica tus publicaciones y activa la opción “Descuento en el cargo por venta de Premium”.
Si tienes publicaciones Clásicas, pasalas a Premium y aprovecha este beneficio.
Ten en cuenta que este descuento estará disponible en categorías seleccionadas de Ropa y Accesorios, Electrodomésticos y Aires Acondicionados, Belleza y Cuidado Personal, entre otras.

Contenidos

→Reconocer qué usuario está habilitado para sumarse a la campaña

→Reconocer qué productos pueden sumarse a la campaña

→Habilitar la campaña en una publicación

→Deshabilitar la campaña en una publicación

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

 

Reconocer qué usuario está habilitado para sumarse a la campaña

Para conocer qué usuario tiene la posibilidad de sumarse a la campaña, deberás realizar un GET al recurso /special_installments/ahora-12 o al recurso /special_installments/ahora-6 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 hasta 18 cuotas, el resultado de la anterior consulta es el siguiente:

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

Reconocer qué productos pueden sumarse a la campaña

Podrás revisar si el producto es de fabricación nacional realizando un POST al recurso /special_installments/ahora-12/categories/$CATEGORY_ID/enabled, enviando en el body un json con la marca ($brand) y el modelo ($model) correspondiente, o al recurso /special_installments/ahora-6/categories/$CATEGORY_ID/enabled 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.


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” o el tag "ahora-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 12 y 18 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. 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.
  • 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” o “ahora-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_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": []
}

 

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

Para consultar si un producto tiene habilitado 6,12 y 18 cuotas, realiza un GET al recurso /ítems con su item_id y verifica que tenga el tag “ahora-12” o "ahora-6" dentro de los campos.


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": []
}
o regístrate para recibir las últimas novedades sobre nuestra API