Recursos para IA
Reclamos
La API de Reclamos permite gestionar el ciclo de vida de las disputas y reclamos entre compradores y vendedores. Esta referencia describe los endpoints disponibles y cómo interactuar con ellos.
Endpoints disponibles
Todos los endpoints que componen la integración con Reclamos.
| Operación | Path | Descripción |
| Obtener detalles del reclamoGET | /post-purchase/v1/claims/{claim_id} | Obtiene los detalles de un reclamo: usuarios involucrados, recurso afectado, estado actual y tipo de reclamo. |
| Buscar reclamosGET | /post-purchase/v1/claims/search | Busca reclamos por filtros como estado, tipo o resource_id; devuelve resultados paginados. |
| Obtener motivo del reclamoGET | /post-purchase/v1/claims/reasons/{reason_id} | Obtiene el motivo asociado a un reason_id, incluyendo sub-motivos y su jerarquía. |
| Obtener historial del reclamoGET | /post-purchase/v1/claims/{claim_id}/status_history | Obtiene el historial de estados y acciones por los que pasó un reclamo desde su apertura. |
| Obtener evidencias del reclamoGET | /post-purchase/v1/claims/{claim_id}/evidences | Lista las evidencias cargadas para un reclamo, con su tipo, estado y fecha de carga. |
| Obtener notificaciones del reclamoGET | /claim_resource | Obtiene las notificaciones de un reclamo a partir del campo resource recibido en una notificación webhook. |
| Operación | Path | Descripción |
| Obtener mensajes del reclamoGET | /post-purchase/v1/claims/{claim_id}/messages | Lista los mensajes intercambiados entre las partes de un reclamo, con autor, fecha y contenido. |
| Obtener información del archivoGET | /post-purchase/v1/claims/{claim_id}/attachments/{fileName} | Obtiene los metadatos de un archivo adjunto: nombre, tipo y estado de moderación. |
| Descargar archivos adjuntosGET | /post-purchase/v1/claims/{claim_id}/attachments/{fileName}/download | Descarga el contenido binario de un archivo adjunto a un reclamo. |
| Adjuntar archivos al mensajePOST | /post-purchase/v1/claims/{claim_id}/attachments | Sube uno o más archivos adjuntos a un reclamo para respaldar la posición de una de las partes. |
| Enviar mensaje con archivoPOST | /post-purchase/v1/claims/{claim_id}/actions/send-message | Envía un mensaje con archivos adjuntos al hilo de comunicación de un reclamo. |
| Operación | Path | Descripción |
| Solicitar mediación del reclamoPOST | /post-purchase/v1/claims/{claim_id}/actions/open-dispute | Escala un reclamo a mediación de Mercado Pago cuando las partes no llegan a un acuerdo directo. |
| Ver resoluciones esperadas en mediaciónGET | /post-purchase/v1/claims/{claim_id}/expected-resolutions | Lista las posibles resoluciones que Mercado Pago puede aplicar al cerrar la mediación de un reclamo. |
| Operación | Path | Descripción |
| Cargar evidencias de envíoPOST | /post-purchase/v1/claims/{claim_id}/actions/evidences | Carga evidencias de envío (número de seguimiento, etiqueta u otros comprobantes) para respaldar al vendedor en un reclamo. |