Seguros y reclamaciones

Asegura envíos por valor declarado y presenta reclamaciones con evidencia cuando algo sale mal.

Asegura un envío al crearlo (requestInsurance: true + declaredValue) y, si el paquete se pierde, se daña o es robado, presenta una reclamación con evidencia directamente por el API.

Requisitos para reclamar

1. El envío debe tener seguro contratado (se solicitó al crear el envío).
2. La guía no debe estar cancelada. Una guía reembolsada no es reclamable.
3. No debe existir otra reclamación abierta para el mismo envío.

Cómo se asegura un envío

El seguro se contrata al comprar la guía, no por separado. Crea el envío con requestInsurance: true y un declaredValue en MXN. Las cotizaciones regresan con la prima incluida: breakdown.insuranceCost e isInsured: true en cada tarifa. Al comprar una tarifa asegurada, la prima forma parte del cargo de la guía y se crea una póliza ACTIVE. Esa es la póliza que reclamas. Cancelar la guía reembolsa la prima y anula la póliza. Sin seguro no hay póliza, y la reclamación se rechaza.

Endpoints

Presenta una reclamación

Parámetros del cuerpo

curl -X POST https://api.sendit.mx/v1/insurance-claims \
  -H "X-API-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "shipmentId": "clxq1w2e3r4t5y6u7i8o9p0a",
    "reason": "damaged",
    "description": "El paquete llegó con daño visible en el contenido",
    "claimedAmount": 1500.00,
    "evidenceUrls": [
      "https://cdn.mitienda.mx/evidencia/foto1.jpg",
      "https://cdn.mitienda.mx/evidencia/foto2.jpg"
    ]
  }'

La respuesta 201 regresa la reclamación en estado FILED con su número de folio:

{
  "success": true,
  "data": {
    "id": "clm_a1b2c3d4e5f6g7h8",
    "shipmentId": "clxq1w2e3r4t5y6u7i8o9p0a",
    "status": "FILED",
    "reason": "damaged",
    "claimedAmount": "1500.00",
    "claimNumber": "CLM-2026-000123",
    "createdAt": "2026-07-18T10:00:00.000Z"
  }
}

Entre mejor sea la evidencia inicial, más rápida la resolución: fotos del daño y del empaque exterior, más el comprobante del valor.

El ciclo de vida de la reclamación

FILED → INVESTIGATING → EVIDENCE_REQUIRED
                  ↓
               APPROVED → PAID
               PARTIALLY_APPROVED → PAID
               DENIED
               CANCELLED

Los estados DENIED, PAID y CANCELLED son terminales.

Reglas cruzadas