API de reclamos

Usa la API de reclamos para presentar reclamos de garantía, subir archivos de pruebas y consultar el estado de los reclamos.

Presentar un reclamo

POST /api/public/claims/submit

Presenta un reclamo sobre una póliza existente. El reclamo se crea con el estado pending y envía notificaciones por correo electrónico al cliente y al comerciante.

Encabezados (recomendados): X-Shopify-Shop-Domain, X-Shopify-Customer-Id

Campos obligatorios del cuerpo:

• policyId — la póliza sobre la que se presenta el reclamo
• claimType — consulta los tipos de reclamo más abajo
• description — qué ocurrió
• dateOfIncident — fecha ISO del incidente

Opcional: additionalInfo

Tipos de reclamo

Devuelve claimId si tiene éxito. Si la póliza alcanzó su límite de reclamos, devuelve un error CLAIM_LIMIT_REACHED con los detalles.

Presentar un reclamo manual

POST /api/public/claims/submit-manual

Presenta un reclamo sin una póliza existente. Se usa para reclamos iniciados por el comerciante (por ejemplo, desde el POS).

Encabezado obligatorio: X-Shopify-Shop-Domain

Campos obligatorios del cuerpo: customerEmail, customerName, productName, claimType, description, dateOfIncident

Opcionales: customerPhone, orderNumber, additionalInfo

Obtener los reclamos de una póliza

GET /api/public/claims/fetch?policy_id={policyId}

Encabezados obligatorios: X-Shopify-Shop-Domain, X-Shopify-Customer-Id

Devuelve todos los reclamos de la póliza y el cliente indicados, con el número de reclamo, el estado, el tipo, el motivo y las fechas.

Obtener las pruebas de un reclamo

GET /api/public/claims/{id}/evidence

Encabezados obligatorios: X-Shopify-Shop-Domain, X-Shopify-Customer-Id

Devuelve los archivos de pruebas (fotos, videos) adjuntos al reclamo.

Subir archivos de pruebas

POST /api/public/claims/upload-urls

Genera una URL prefirmada para subir evidencia directamente al almacenamiento en la nube.

Campos obligatorios del cuerpo: fileName, fileType (tipo MIME), fileSize (bytes), claimId, fileCategory (photo o video)

Límites de archivo:

• Fotos (JPEG, PNG, GIF, WebP): máximo 10 MB
• Videos (MP4, QuickTime, WebM): máximo 100 MB

Flujo de carga:

1. Llama a /claims/upload-urls para obtener una URL prefirmada
2. Haz un PUT del archivo directamente a esa URL con el encabezado Content-Type correcto

Estados de los reclamos

Relacionado

• API de pólizas — Consulta las pólizas antes de presentar reclamos
• API de garantías — Detalles de los planes de garantía
• Referencia de webhooks — Recibe avisos cuando cambia el estado de un reclamo