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 20/03/2023

Ventas de usuarios invitados

Importante:
Está funcionalidad está disponible desde junio de 2022 en los países en donde se encuentra habilitado Mercado Shops (Argentina, Brasil, México, Chile y Colombia).

Permitiremos a usuarios invitados realizar compras en las tiendas sin necesidad de tener una cuenta de Mercado Libre, simplificando la experiencia de compra para que los vendedores puedan vender más. Por lo tanto en las tiendas se podrá comprar con usuarios invitados ingresando poca información como el nombre, apellido y email. Tener en cuenta las consideraciones por site.


Consideraciones

Los datos que le pediremos al usuario invitado además del nombre y apellido por site serán:

        • MLM: e-mail
        • MLB: e-mail + CPF o CNPJ
        • MLA: e-mail + DNI
        • MLC: e-mail + RUT

Los usuarios invitados:

  • No contarán con compra protegida,
  • no tendrán password y no podrán ingresar en Mercado Libre ni Mercado Pago,
  • no contarán con mensajería en los flujos de Mercado Libre, y
  • tendrán una marca para ser identificado como tal, la misma será lite y un ID.

Para este tipo de usuario creamos un nuevo tipo de sesión para autorizar el acceso solo a los flujos guest. A tener en cuenta que:

  • Se creará un user por tienda y email por cada compra.
  • Las ventas de estos usuarios no afectarán a la reputación del vendedor.

Cada usuario invitado podrá realizar el seguimiento de su compra accediendo a la información disponible en su e-mail y podrá ver cada compra por separado.


Casos en los que el vendedor recibirá un e-mail de una compra guest:


Estado E-mail comprador E-mail vendedor
PAGO RECHAZADO Si No
EN PROCESO No No
PAQUETE EN PREPARACIÓN No Si
PAQUETE EN PREPARACIÓN DEMORADO No Si
PAQUETE EN CAMINO Si No
PAQUETE EN CAMINO DEMORADO Si Si
PAQUETE EN P. DE RETIRO Si No
PAQUETE ENTREGADO Si No

Identificar usuarios invitados

Actualmente orders contará con un nuevo nodo que permitirá conocer el contexto con el cual las órdenes fueron creadas, guardando el tipo de cliente que crea la compra, permitiendo una mejor lectura e interpretación de la información.

Para conocer si la orden fue realizada por un usuario invitado deberán revisar el nuevo nodo context que contará con información detallada para identificar si la compra la realizó un usuario invitado. Para esto tendrán que revisar el campo flows, dentro del nodo context, chequeando que el valor del mismo sea lite y que el channel corresponda a mshops. Para más información te invitamos a leer la documentación de gestión de ventas.


Llamada:

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

Ejemplo:

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

Respuesta:

{
    "id": 2000003509333216,
    "date_created": "2022-04-28T09:25:08.000-04:00",
    "date_closed": "2022-04-28T09:25:10.000-04:00",
    "last_updated": "2022-04-28T09:27:11.000-04:00",
    "manufacturing_ending_date": "2022-06-12T09:25:10.000-04:00",
    "comment": null,
    "pack_id": null,
    "pickup_id": null,
    "order_request": {
        "return": null,
        "change": null
    },
    "fulfilled": null,
    "application_id": "3606760543142028",
    "hidden_for_seller": false,
    "buying_mode": "buy_equals_pay",
    "shipping_cost": 1504.99,
    "mediations": [],
    "total_amount": 20000,
    "paid_amount": 21504.99,
    "coupon": {
        "id": null,
        "amount": 0
    },
    "expiration_date": "2022-07-10T09:25:10.000-04:00",
    "order_items": [
        {
            "item": {
                "id": "MLA924971996",
                "title": "Maceta De Plastico (item De Prueba No Ofertar)",
                "category_id": "MLA11034",
                "variation_id": 87620137218,
                "seller_custom_field": null,
                "variation_attributes": [
                    {
                        "id": "COLOR",
                        "name": "Color",
                        "value_id": "52049",
                        "value_name": "Negro"
                    }
                ],
                "warranty": "Sin garantía",
                "condition": "new",
                "seller_sku": null,
                "global_price": null,
                "net_weight": null
            },
            "quantity": 1,
            "requested_quantity": {
                "value": 1,
                "measure": "unit"
            },
            "picked_quantity": null,
            "unit_price": 20000,
            "full_unit_price": 22000,
            "currency_id": "ARS",
            "manufacturing_days": 45,
            "sale_fee": 3800,
            "listing_type_id": "gold_pro",
            "base_exchange_rate": null,
            "base_currency_id": null,
            "element_id": null,
            "bundle": null,
            "discounts": null
        }
    ],
    "currency_id": "ARS",
    "payments": [
        {
            "id": 21926289045,
            "order_id": 2000003509333216,
            "payer_id": 1109579510,
            "collector": {
                "id": 660948237
            },
            "card_id": null,
            "site_id": "MLA",
            "reason": "Maceta De Plastico (item De Prueba No Ofertar)",
            "payment_method_id": "visa",
            "currency_id": "ARS",
            "installments": 1,
            "issuer_id": "1",
            "atm_transfer_reference": {
                "company_id": null,
                "transaction_id": null
            },
            "coupon_id": null,
            "activation_uri": null,
            "operation_type": "regular_payment",
            "payment_type": "credit_card",
            "available_actions": [
                "refund"
            ],
            "status": "approved",
            "status_code": null,
            "status_detail": "accredited",
            "transaction_amount": 20000,
            "transaction_amount_refunded": 0,
            "taxes_amount": 0,
            "shipping_cost": 1504.99,
            "coupon_amount": 0,
            "overpaid_amount": 0,
            "total_paid_amount": 21504.99,
            "installment_amount": 21504.99,
            "deferred_period": null,
            "date_approved": "2022-04-28T09:25:10.000-04:00",
            "authorization_code": "301299",
            "transaction_order_id": null,
            "date_created": "2022-04-28T09:25:09.000-04:00",
            "date_last_modified": "2022-04-28T09:25:26.000-04:00",
            "marketplace_fee": 3800
        }
    ],
    "shipping": {
        "id": 41336716357
    },
    "status": "paid",
    "status_detail": null,
    "tags": [
        "mshops",
        "not_delivered",
        "test_order",
        "paid"
    ],
    "internal_tags": [],
    "feedback": {
        "buyer": null,
        "seller": null
    },
    "context": {
        "channel": "mshops",
        "site": "MLA",
        "flows": [
            "lite"
        ]
    },
    "seller": {
        "id": 660948237
    },
    "buyer": {
        "id": 1109579510
    },
    "taxes": {
        "amount": null,
        "currency_id": null,
        "id": null
    }
}

Nuevo nodo:


    "context": {
        "channel": "mshops",
        "site": "MLA",
        "flows": [
            "lite"
        ] 
}

Parámetros

channel: canales de venta por donde se generó la orden.

site: país en donde se procesó la venta.

flows: es una lista de características del origen de la compra, a continuación los siguientes tags actuales:

  • cbt
  • subscription
  • contract
  • supermarket
  • 3x_campaign
  • high_concurrency
  • catalog
  • lite (comprador invitado)

Verificar información del usuario invitado

Podrás identificar información del comprador mediante el recurso de /users ya que contará con un ID como cualquier otro usuario, la información que diferenciara al comprador invitado es mediante el campo user_type: lite.


Llamada:

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

Ejemplo:

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

Respuesta:

{
    "id": 1109579510,
    "nickname": "TEST_USER_1109579510",
    "registration_date": "2022-04-19T16:01:57.099-04:00",
    "country_id": "AR",
    "address": {
        "city": "Palermo",
        "state": "AR-C"
    },
    "user_type": "lite",
    "tags": [
        "test_user",
        "lite"
    ],
    "logo": null,
    "points": 0,
    "site_id": "MLA",
    "permalink": "http://perfil.mercadolibre.com.ar/TEST_USER_1109579510",
    "seller_reputation": {
        "level_id": null,
        "power_seller_status": null,
        "transactions": {
            "canceled": 0,
            "completed": 0,
            "period": "historic",
            "ratings": {
                "negative": 0,
                "neutral": 0,
                "positive": 0
            },
            "total": 0
        }
    },
    "buyer_reputation": {
        "tags": null
    },
    "status": {
        "site_status": "active"
    }
}

Cancelaciones

Nota:
Ten en cuenta que para este tipo de ventas a usuarios lite (invitados), no contarán con los flujos de mensajería, reclamos y cancelaciones mediante feedbacks de no concretado.

Para este tipo de ventas, el único que puede realizar la cancelación de una venta es el vendedor, y deberá realizar la misma efectuando una devolución del pago mediante un POST a /v1/payments/{id}/refunds. Conoce más sobre cómo concretar una devolución mediante un reembolso.


Llamada:

curl -X POST \
    'https://api.mercadopago.com/v1/payments/{id}/refunds' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
    -H 'Content-Type: application/json' \
    -d '{
  "amount": 5
}'

Ejemplo:

curl --location --request POST 'https://api.mercadopago.com/v1/payments/23415342519/refunds' \
--header 'Authorization: Bearer APP_USR-2843871569852229-060217-cdc5b8cafba2c1dda4ffeb2235f79b4c-553421365' \
--header 'Content-Type: text/plain' \
--data-raw '{
"amount": 683397.27
}'

Respuesta:

{
    "id": 1150318715,
    "payment_id": 23415342519,
    "amount": 683397.27,
    "metadata": {},
    "source": {
        "id": "553421365",
        "name": "Nitienda Test Test",
        "type": "collector"
    },
    "date_created": "2022-06-23T18:21:49.114-04:00",
    "unique_sequence_number": null,
    "refund_mode": "standard",
    "adjustment_amount": 0,
    "status": "approved",
    "reason": null,
    "labels": [],
    "amount_refunded_to_payer": 683397.27,
    "partition_details": []
}

Siguiente: Campañas con cuotas.