Source: https://developers.mercadolibre.com.mx/es_ar/introduccion-vehiculos/trabajar-con-reclamos
Timestamp: 2019-10-18 17:41:20+00:00

Document:
Ver los mensajes, responderlos y adjuntar archivos
Cargar evidencias de envío
La creación de un reclamo es un evento que ocurre en el lado de Mercado Libre, por lo que deberá suscribirse a nuestro feed de reclamos para tomar conciencia en tiempo real cuando ocurra ese evento. Vaya a nuestro Administrador de aplicaciones y edite la Configuración de notificaciones de su aplicación. Para obtener más información sobre cómo crear y configurar una nueva aplicación, consulte este enlace. Debe elegir una URL de devolución de llamada: configure la URL pública del dominio donde desea recibir todas las notificaciones de Mercado Libre.
Los parámetros disponibles para los filtros son: id, type, stage, status, resource_id, resource, reason_id, site_id, players.role, players.user_id. Por ejemplo, si desea filtrar por stage y status:
https://api.mercadolibre.com/v1/claims/search?stage=dispute&status=opened&access_token={...}
id: ID del reclamo
- mediations: reclamo entre comprador y vendedor
- cancel_purchase: cancelación de compra por parte del comprador
- returns: devolución de producto. En este caso, no hay mensajes. Para tratar devoluciones, siga la documentación Trabajar con Devoluciones.
- cancel_sale: cancelación de compra por parte del vendedor.
- El status siempre va a ser "closed"
- El stage siempre va a ser "none"
- El rol complainant siempre va a ser el type seller, collector o sender dependiendo el resource.
- claim: etapa de reclamo donde intervienen el comprador y el vendedor
- dispute: etapa de mediación donde interviene un representante de Mercado Libre
- recontact: etapa en la que alguna de las partes se contacta luego de cerrado el reclamo/disputa.
- none: no aplica
parent_id: ID de otro reclamo del que depende
-complainant: persona que reclama
-respondent: persona a quién le reclaman
-mediator: persona que interviene para ayudar a solucionar el problema.
type: rol que ocupa la persona sobre la operación que se está reclamando. Puede ser: buyer, seller, internal, carrier.
available_actions: lista de acciones que pueden ejecutar cada una de las partes intervinientes
-action: acción posible de ser ejecutada. Puede ser:
send_message_to_complainant
send_message_to_mediator
send_shipping_evidence
open_dispute
send_potential_shipping
close_claim
close_dispute
load_resolution
accept_resolution
add_shipping_evidence
allow_return_label
send_traking_number
Los campos relacionados con available_actions y acción no deben ser considerados como soluciones esperadas. En este momento, son solo informativos y pueden ser ignorados.
-due_date: tiempo límite para realizar la acción.
-mandatory: este campo en true indica que es una acción obligatoria y que debe realizarse dentro del tiempo indicado.
resolution: Forma de resolución del reclamo
site_id: ID del site donde se desarrolla el reclamo
date_created: Fecha de creación del reclamo
sender_role: player que envió el mensaje
receiver_role: player hacia quién va dirigido el mensaje
- filename: nombre del archivo adjunto hasheado
- original_filename: nombre real del adjunto
- size: tamaño del archivo en Bytes
- type: tipo de archivo
- date_created: fecha de carga del adjunto
stage: Etapa en la que se envió el mensaje
date_created: Fecha en la que se creó el mensaje
message: texto del mensaje
Ver el detalle de un mensaje:
curl -X GET “https://api.mercadolibre.com/v1/claims/{claim_id}?access_token=$ACCESS_TOKEN”
curl -X GET “https://api.mercadolibre.com/v1/claims/950700111?access_token=$ACCESS_TOKEN”
Obtener todos los mensajes de un reclamo:
curl -X GET “https://api.mercadolibre.com/v1/claims/{claim_id}/messages?access_token=$ACCESS_TOKEN”
Ver los mensajes, responderlos y adjuntar archivos:
curl -X POST “https://api.mercadolibre.com/v1/claims/{claim_id}/attachments?access_token=$ACCESS_TOKEN” -F file={file_path}
El POST debe realizarse como form.data con file = ubicación del archivo.
El archivo debe tener un tamaño máximo de 5 MB.
Podrán intercambiarse fotos, manuales de instrucciones, facturas y demás archivos adjuntos en JPG, PNG, PDF y TXT de hasta 5 MB.
curl -X POST “https://api.mercadolibre.com/v1/claims/1032991215/attachments?access_token=$ACCESS_TOKEN” -H 'content-type: multipart/form-data;  -F 'file=@/Users/user/Desktop/file.jpg'
POST “https://api.mercadolibre.com/v1/claims/{claim_id}/messages?access_token=$ACCESS_TOKEN&application_id=$APPLICATION_ID”
Nota: En la lista de adjuntos se mostrarán todos los devueltos en el POST anterior asociados al mensaje separados por coma. Ejemplo:
curl -X POST “https://api.mercadolibre.com/v1/claims/950463475/messages?access_token=$ACCESS_TOKEN&application_id=$APPLICATION_ID” -H 'Content-Type: application/json'  \
POST “https://api.mercadolibre.com/v1/claims/{claim_id}/messages?access_token=$ACCESS_TOKEN”
curl -X POST “https://api.mercadolibre.com/v1/claims/950463475/messages?access_token=$ACCESS_TOKEN” -H 'Content-Type: application/json'  \
GET "https://api.mercadolibre.com/v1/claims/{claim_id}/attachments/{attach_id}/download?access_token=$ACCESS_TOKEN"
GET "https://api.mercadolibre.com/v1/claims/{claim_id}/attachments/{attach_id)?access_token=$ACCESS_TOKEN"
PUT “https://api.mercadolibre.com/v1/claims/{claim_id}?access_token=$ACCESS_TOKEN”
curl -X PUT “https://api.mercadolibre.com/v1/claims/950463475?access_token=$ACCESS_TOKEN”  -H 'Content-Type: application/json' -d '{"stage":"dispute"}'
Post "https://api.mercadolibre.com/v1/claims/{claim_id}/messages?access_token=$ACCESS_TOKEN"
GET “https://api.mercadolibre.com/v1/claims/{claim_id}/expected_resolutions?access_token=$ACCESS_TOKEN”
curl -X GET “https://api.mercadolibre.com/v1/claims/950463475/expected_resolutions?access_token=$ACCESS_TOKEN”
player_role: role del player del reclamo
user_id: id del player del reclamo
date_created: fecha de creación de la resolución esperada
date_created: fecha de última actualización de la resolución esperada
- pending: el player cargó la resolución esperada pero no aún no fue aceptada por la contraparte
- accepted: la resolución cargada por el player fue aceptada por su contraparte o en su defecto por el mediador de Mercado Libre
Nota: Independientemente de las resoluciones cargadas por los participantes, en determinados casos la resolución final es la define un representante de Mercado Libre en caso que las partes no se pongan de acuerdo.
PUT “https://api.mercadolibre.com/v1/claims/{claim_id}/expected_resolutions?access_token=$ACCESS_TOKEN”
curl -X PUT “https://api.mercadolibre.com/v1/claims/950463475/expected_resolutions?access_token=$ACCESS_TOKEN” d '{"status":"accepted"}'
En caso de que el “respondent” acepte la resolución del “complainant”.
En los casos que correspondan, Mercado Libre le dará al comprador una etiqueta para devolver el producto.
Siempre la resolución a aceptar es la que está pendiente por la contraparte.
POST “https://api.mercadolibre.com/v1/claims/{claim_id}/expected_resolutions?access_token=$ACCESS_TOKEN”
curl -X POST “https://api.mercadolibre.com/v1/claims/950463475/expected_resolutions?access_token=$ACCESS_TOKEN” d '{"expected_resolution":"return_product"}'
Nota: En el ejemplo, el vendedor rechaza hacer el cambio de producto que quiere el comprador pero acepta que le devuelva el producto y en su defecto que se le devuelva el dinero al comprador.
refund - Devolución del dinero.
product - Envío del producto.
return_product - devolución del producto con devolución del dinero.
change_product - cambio del producto.
Para compras realizadas con Mercado Envíos
GET “https://api.mercadolibre.com/v1/claims/{claim_id}/evidences?access_token=$ACCESS_TOKEN”
curl -X GET “https://api.mercadolibre.com/v1/claims/949903015/evidences?access_token=$ACCESS_TOKEN”
Nota: Actualmente solo existe la carga de evidencia de envío que realiza el vendedor.
receiver_email: correo electrónico del destinatario del pedido digital e-mail de quem recebeu a encomenda digital.
Nota: todas las fechas deben usarse en los siguientes formatos:
POST “https://api.mercadolibre.com/v1/claims/{claim_id}/evidences?access_token=$ACCESS_TOKEN”
curl -X POST “https://api.mercadolibre.com/v1/claims/949903015/evidences?access_token=$ACCESS_TOKEN” -d {"type": "shipping_evidence",  "shipping_method": "mail" ,  "shipping_company_name": "Correios",  "tracking_number": "XX123456789XX", "date_shipped": "2018-03-07T05:00:01.858-03:00",  "attachments": ["38f4e399-0f18-41e4-8f48-91aecd2dee1a_419059118.png"] }
curl -X POST “https://api.mercadolibre.com/v1/claims/949903016/evidences?access_token=$ACCESS_TOKEN” -d {"type": "shipping_evidence",  "shipping_method": "entrusted" , "shipping_company_name": "Total", "destination_agency": "Agencia", "date_shipped": "2018-08-17T05:00:01.858-03:00", "receiver_name": "Jose da Silva", "receiver_id": "12345678", "tracking_number": "XX123456789XX", "attachments": [] }
curl -X POST “https://api.mercadolibre.com/v1/claims/949903017/evidences?access_token=$ACCESS_TOKEN” -d {"type": "shipping_evidence",  "shipping_method": "personal_delivery" , "date_delivered": "2018-03-07T05:00:01.858-03:00", "attachments": [] }
curl -X POST “https://api.mercadolibre.com/v1/claims/949903018/evidences?access_token=$ACCESS_TOKEN” -d {"type": "shipping_evidence",  "shipping_method": "email" , "receiver_email": "teste@teste.com.br", "date_shipped": "2018-03-07T05:00:01.858-03:00",  "attachments": [] }
curl -X POST “https://api.mercadolibre.com/v1/claims/949903019/evidences?access_token=$ACCESS_TOKEN” -d {"type": "handling_shipping_evidence", "handling_date": "2019-08-23" }
Nota: cuando el stage del reclamo sobre un producto está en discusión/mediación, el vendedor no podrá enviar la prueba del envío. Una vez enviado algún tipo de prueba, no podrá cambiarla. Para esto, te recomendamos completar toda la información posible.
GET “https://api.mercadolibre.com/v1/claims/{claim_id}/status_history?access_token=$ACCESS_TOKEN”
curl -X GET “https://api.mercadolibre.com/v1/claims/950463475/status_history?access_token=$ACCESS_TOKEN”
GET “https://api.mercadolibre.com/v1/claims/{claim_id}/actions_history?access_token=$ACCESS_TOKEN”
curl -X GET “https://api.mercadolibre.com/v1/claims/950463475/actions_history?access_token=$ACCESS_TOKEN”
“action_id”: 3454323247,
“action_name”: “open_dispute”,
“role”: ”mediator”,
"claim_stage": "claim",
"claim_status": "opened",
"date_created": "2018-03-12T10:33:01.858-03:00"
“action_id”: 3454323245,
“action_name”: “send_message_to_complainant”,
“role”: ”respondent”,
"date_created": "2018-03-10T11:33:01.858-03:00"
“action_id”: 3454323243,
“action_name”: “send_message_to_respondent”,
“role”: ”complainant”,
"date_created": "2018-03-10T10:33:01.858-03:00"
action_id: id de la acción ejecutada
action_name: acción ejecutada
role: player que ejecutó la acción
claim_stage: etapa en la cual se ejecutó la acción
claim_status: estado de la etapa en la que se ejecutó la acción
date_created: fecha en la que se ejecutó la acción
GET “https://api.mercadolibre.com/v1/reasons/{reason_id}/children”
curl -X GET “https://api.mercadolibre.com/v1/reasons/PDD2/children”
Te invitamos a seguir leyendo la documentación de Devoluciones para conocer sobre cómo utilizar el recurso /returns.

References: resolución 
 resolución 
 resolución 
 resolución 
 resolución 
 resolución 
 resolución 
 resolución