Saltar al contenido principal

Devoluciones

Ciclo de vida​

requested → approved / rejected → completed

Transiciones inválidas retornan 409 Conflict.

Listar devoluciones​

GET /api/v1/returns

Parámetros:

NombreTipoDescripción
statusstringrequested (default), approved, rejected, completed
cursorstringCursor de paginación

Obtener devolución​

GET /api/v1/returns/:id

Respuesta 200:

{
  "id": "uuid",
  "order_id": "uuid",
  "status": "requested",
  "notes": "Producto con defecto de fábrica",
  "items": [
    {
      "id": "uuid",
      "order_item_id": "uuid",
      "quantity": 1,
      "reason": "defective"
    }
  ],
  "created_at": "2026-04-08T12:00:00Z"
}

Aprobar devolución​

POST /api/v1/returns/:id/approve

{
  "notes": "Aprobada, esperar recepción del producto"
}

Rechazar devolución​

POST /api/v1/returns/:id/reject

{
  "notes": "Fuera del plazo de 30 días"
}

Completar devolución​

POST /api/v1/returns/:id/complete

Marca la devolución como completada (producto recibido y reembolso procesado).