Skip to content

🔍 Buscar orden por ID

Este endpoint permite consultar los detalles completos de una orden específica utilizando su identificador único (orderId). Devuelve información como productos incluidos, estado, totales y fecha de creación.


🧠 ¿Cuándo usar este endpoint?

  • Para mostrar la página de detalle de una orden.
  • Cuando el usuario da clic sobre una orden en su historial.
  • Para revisiones desde un panel de administración.

🔐 Requiere autenticación

Debes enviar un token JWT válido en el encabezado:

Authorization: Bearer <token>

📋 Headers

Nombre Valor
Authorization Bearer
Content-Type application/json

📦 Parámetros de la ruta

  • Método: GET
  • Ruta: /orders/findById/:orderId
Nombre Tipo Descripción
orderId UUID ID de la orden a consultar

🚀 Ejemplo curl

curl -X GET "http://localhost:3000/api/orders/findById/123e4567-e89b-12d3-a456-426614174001" \
-H "Authorization: Bearer <tu_token_jwt_aqui>" \
-H "Content-Type: application/json"

📄 Respuesta exitosa

HTTP/1.1 200 OK
Content-Type: application/json

{
  "success": true,
  "message": "succes",
  "data": {
    "id": "6494138f-ad52-4ada-9cff-3b5d8fb34722",
    "total": "140.70",
    "direction": "por aca",
    "status": "refunded",
    "createdAt": "2025-02-26T19:59:58.000Z",
    "updatedAt": "2025-02-26T21:19:12.000Z",
    "userId": "6df3a7ac-920f-4bca-b339-746676230d7a",
    "user": {
      "id": "6df3a7ac-920f-4bca-b339-746676230d7a",
      "name": "fabio2",
      "email": "fabio2@gmail.com"
    },
    "products": [
      {
        "sku": "CARTO-004",
        "id": "b2d8a815-3f4d-4ae6-8972-e4826dcd380c",
        "name": "Camiseta",
        "description": "Es una camiseta asi y asa",
        "color": "azul",
        "size": "s",
        "price": "20.10",
        "quantity": 2
      },
      {
        "sku": "CARTO-006",
        "id": "e7b69d73-a836-452f-a034-4145f9a59052",
        "name": "Camiseta",
        "description": "Es una camiseta asi y asa",
        "color": "verde",
        "size": "s",
        "price": "20.10",
        "quantity": 5
      }
    ]
  }
}

❌ Respuesta de error

Código Motivo Solución
404 Orden no encontrada Verifica que el orderId sea correcto y que la orden exista.
401 No autorizado Asegúrate de enviar un token JWT válido en el encabezado de autorización.
500 Error interno del servidor Contacta al administrador del sistema si el problema persiste.

💡 Tip ¿No recuerdas el ID?

Usa el endpoint Ver mis órdenes para listar tus órdenes y obtener sus IDs.