Ventas de usuarios invitados

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:

Identificar usuarios invitados

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

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.