Documentação do Mercado Shops

Confira todas as informações necessárias sobre as APIs Mercado Shops.
circulos azuis em degrade

Documentação do

Última atualização em 01/11/2023

Gestão de vendas

Com esses recursos você pode identificar as orders do Mercado Shops, seus detalhes e conhecer o possível status da order.


Buscar orders

Com a tag mshops você pode identificar as orders do Mercado Shops.


Chamada:

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

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H x-format-new: true https://api.mercadolibre.com/orders/2063200914

Resposta:

{
    "id": 2063200914,
    "date_created": "2019-06-24T15:53:04.000-04:00",
    "date_closed": "2019-06-24T15:53:06.000-04:00",
    "last_updated": "2019-06-24T15:53:06.000-04:00",
    "manufacturing_ending_date": null,
    "feedback": {...},
    "mediations": [],
    "comments": null,
    "pack_id": null,
    "pickup_id": null,
    "order_request": {...},
    "fulfilled": null,
    "total_amount": 25,
    "paid_amount": 31.9,
    "coupon": {...},
    "expiration_date": "2019-07-22T15:53:06.000-04:00",
    "order_items": [...],
    "currency_id": "BRL",
    "payments": [...],
    "shipping": {...},
    "status": "paid",
    "status_detail": null,
    "tags": [
        "mshops",
        "not_delivered",
        "paid"
    ],
    "buyer": {...},
    "seller": {...},
    "taxes": {...}
}

Detalhe de orders

Consulte com a tag mshops.


Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/search?seller=$SELLER_ID&tags=mshops
Nota:
Recomendamos que revise os detalhes de todos os descontos aplicados em uma venda. É possível obter estes detalhes com o recurso /discount.

Status da order

confirmed: order em estado inicial, mas ainda não foi paga.
payment_required: order que precisa ter o pagamento confirmado para mostrar a informação do usuário.
payment_in_process: order com um pagamento associado, mas que ainda não foi creditado.
partially_paid: order com um pagamento associado creditado, mas que ainda não é suficiente.
paid: com um pagamento associado e creditado.
cancelled: order incompleta. Ver motivos de cancelamento.



Próxima: Gestão de promoções.