Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade

Documentación

Última actualización 06/01/2025

Scope Pilot

El objetivo de esta iniciativa es permitir que el integrador pruebe nuevos recursos o campos sin afectar el entorno actual de producción. Al utilizar el header específico 'x-post-purchase-op-scope: pilot', el integrador podrá acceder a estos nuevos campos de manera controlada, garantizando que el recurso productivo permanezca sin alteraciones.

Llamada:

curl --location 'https://api.mercadolibre.com/post-purchase/v1/claims/$CLAIM_ID \
--header 'Authorization: Bearer $ACCESS_TOKEN' \
--header 'x-public: true' \
--header 'x-post-purchase-op-scope: pilot'

Respuesta:


{
    "id": 5256749420,
    "resource_id": 2000007819609432,
    "status": "closed",
    "type": "mediations",
    "stage": "claim",
    "parent_id": null,
    "resource": "order",
    "reason_id": "PDD9549",
    "fulfilled": true,
    "quantity_type": "total",
    "claimed_quantity": 1,
    "claim_version": 2.0,
    "players": [
        {
            "role": "complainant",
            "type": "buyer",
            "user_id": 1325224382,
            "available_actions": []
        },
        {
            "role": "respondent",
            "type": "seller",
            "user_id": 1330467461,
            "available_actions": []
        }
    ],
    "resolution": {
        "reason": "payment_refunded",
        "date_created": "2024-03-21T05:19:22.000-04:00",
        "benefited": [
            "complainant"
        ],
        "closed_by": "respondent",
        "applied_coverage": false
    },
    "site_id": "MLB",
    "date_created": "2024-03-14T08:28:44.000-04:00",
    "last_updated": "2024-03-21T05:19:22.000-04:00",
    "related_entities": []
}

Campos nuevos de la respuesta:

  • claimed_quantity: Representa la cantidad de ítems vinculados a la reclamación. Es esencial que la reclamación esté asociada al recurso de orden o envío, de lo contrario, esta información no aparecerá en la respuesta.
  • claim_version: Indica la versión de la reclamación, como por ejemplo 1.0, 1.5, 2.0. Funcionalidades como /detail están disponibles solo para reclamaciones en la versión 2.0 o superior.