Documentação do Mercado Livre

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

Documentação do

Última atualização em 06/01/2025

Scope Pilot

O objetivo desta iniciativa é permitir que o integrador teste novos recursos ou campos sem impactar o ambiente atual de produção. Ao utilizar o header específico 'x-post-purchase-op-scope: pilot', o integrador poderá acessar esses novos campos de forma controlada, garantindo que o recurso produtivo permaneça inalterado.

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'

Resposta:


{
    "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 novos da resposta:

  • claimed_quantity: Representa a quantidade de itens vinculados à reclamação. É essencial que a reclamação esteja associada ao resource order ou shipment, caso contrário, essa informação não aparecerá na resposta.
  • claim_version: Indica a versão da reclamação, como por exemplo 1.0, 1.5, 2.0. Funcionalidades como /detail estão disponíveis apenas para reclamações na versão 2.0 ou superior.