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 01/11/2023

Gestión de ventas

Con estos recursos puedes identificar las órdenes de Mercado Shops, consultar sus detalles y conocer los posibles estados de la orden.


Buscar órdenes

Con el tag mshops puedes identificar las órdenes de Mercado Shops.


Llamada:

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

Ejemplo:

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

Respuesta:

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

Ver detalle de órdenes

Consulta con el tag mshops.


Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/search?seller=$SELLER_ID&tags=mshops
Nota:
Recomendamos que revise los detalles de todos los descuentos aplicados en una venta. Es posible obtener estos detalles con el recurso /discounts.

Estados de la orden

confirmed: orden en estado inicial, pero aún no ha sido pagada.
payment_required: orden que necesita que se confirme el pago para mostrar la información del usuario.
payment_in_process: orden con un pago asociado, pero aún no ha sido acreditado.
partially_paid: orden con un pago asociado acreditado, pero aún no es suficiente.
paid: orden con un pago asociado y acreditado.
cancelled: orden incompleta. Ver motivos de cancelación.



Siguiente: Gestión de promociones.