• API Docs
  • Guía para Mercado Shops
  • Identificar ventas de usuarios invitados
Última actualización 18/10/2022

Identificar 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.
    • El comprador invitado que no tiene password y no se puede loguear en Mercado Libre ni Mercado Pago.
    • El comprador invitado tiene una marca para ser identificado como tal, la misma será “lite” y un ID.
    • Tendremos un user por tienda y email (se creará un usuario invitado/guest por cada compra).
    • Creamos un nuevo tipo de sesión para autorizar el acceso sólo a los flujos guest.
    • No contarán con mensajería en los flujos de Mercado Libre.
    • Las ventas a un comprador invitado no afectan a la reputación del vendedor.
    • El comprador invitado podrá seguir la 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 quién crea la compra

    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"
            ] 
    }
    
    • 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 comprador 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ás con los flujos de mensajería, reclamos y cancelaciones mediante feedbacks de no concretado.

    Para este tipo de ventas, el único que puede concretar la cancelación de una venta es el Seller, ya que 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.


    Lhamada:

    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: Publicaciones con campañas de cuotas sin interes.