• API Docs
  • Guia para Mercado Shops
  • Identifique as vendas de usuários convidados

Identifique as vendas de usuários convidados

Importante:
Esta funcionalidade estará disponível a partir de junho 2022 nos países onde o Mercado Shops está habilitado (Argentina, Brasil, México, Chile y Colômbia).

Permitiremos que os usuários convidados façam compras nas lojas sem a necessidade de ter uma conta no Mercado Livre, tornando a experiência de compra mais simples para que os vendedores possam vender mais. Portanto, nas lojas será possível comprar com usuários convidados inserindo poucas informações como e-mail, nome e sobrenome.
Tenha em conta as considerações por site.


Considerações

  • Os dados que solicitamos ao usuário convidado além do nome e sobrenome por site, será:
          • MLM: e-mail
          • MLB: e-mail + CPF o CNPJ
          • MLA: e-mail + DNI
          • MLC: e-mail + RUT
    • Os usuários convidados não terão uma compra protegida.
    • O comprador convidado que não tem senha e não pode ser logado no Mercado Livre ou Mercado Pago.
    • O comprador convidado tem uma marca para identificá-lo como convidado, vai ser “lite” e um ID.
    • Teremos um usuário por loja e e-mail (será um usuário guest criado para cada compra).
    • Criamos uma sessão para autorizar o acesso apenas aos fluxos guest.
    • Não terão mensagens nos fluxos Mercado Livre.
    • As vendas para um comprador convidado não afetam a reputação do vendedor.
    • O comprador convidado poderá acompanhar a compra acessando as informações disponíveis em seu e-mail e poderá ver cada compra separadamente.
    • Casos em que o vendedor receberá um e-mail de compra convidado.

    Status E-mail comprador E-mail vendedor
    PAGAMENTO RECUSADO Sim Não
    EM PROCESSO Não Não
    PACOTE EM PREPARAÇÃO Não Sim
    PACOTE EM PREPARAÇÃO ATRASADO Não Sim
    PACOTE A CAMINHO Sim Não
    PACOTE A CAMINHO ATRASADO Sim Sim
    PACOTE NO PRONTO DE RETIRADA Sim Não
    PACOTE ENTREGUE Sim Não

    Identificar quem cria a compra

    Importante:
    A partir de junho 2022, um novo array será adicionado nas respostas das orders.

    Teremos um novo array que permitirá conhecer o contexto com que as orders foram criadas, guardando o tipo de cliente que cria a compra, permitindo uma melhor leitura e interpretação da informação.

    Para saber se a order foi criada por um usuário convidado, deverá revisar o novo array context que terá informações detalhadas. Para isso, revise o campo "flows", no array context, verificando que o valor é “lite" e "channel"corresponde ao "mshops". Para obter mais informações, acesse a documentação gerenciar orders.

    Chamada:

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

    Exemplo:

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

    Resposta:

    {
        "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
        }
    }

    O novo array:

    
        "context": {
            "channel": "mshops",
            "site": "MLA",
            "flows": [
                "lite"
            ]
    
    • Channel: canais de vendas através dos quais a order foi gerada.
    • Site: país onde a venda foi processada.
    • Flows: é uma lista de características da origem da compra, a seguir tags atuais:
                      • cbt
                      • subscription
                      • contract
                      • supermarket
                      • 3x_campaign
                      • high_concurrency
                      • catalog
                      • lite (comprador invitado)

    Verificar informações do comprador convidado

    Poderá identificar as informações do comprador convidado através do recurso /users, ele terá um ID como qualquer outro usuário, a informação que diferencia o comprador convidado é está no campo "user_type": "lite".

    Chamada:

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

    Exemplo:

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

    Resposta:

    {
        "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"
        }
    }
    
    banner footer

    Inscreva-se em nosso Newsletter

    ou registre-se para receber as últimas notícias sobre nossa API