create`

Crea una nueva orden de pedido, actualiza el stock de productos de forma atómica y asocia la orden al vendedor autenticado.

🔐 Requiere autenticación JWT.

📍 Ruta

POST /api/orders/create

📝 Descripción

Este endpoint permite registrar una orden de pedido, validando el RUC del cliente, los productos y cantidades solicitadas, y verificando disponibilidad de stock. Si todo es correcto, se descuenta el stock mediante bulkWrite y se guarda la orden. En caso de fallos tras el descuento, se revierte el stock.

🔒 Autenticación

Middleware: verificarAutenticacion

Header requerido: Authorization: Bearer <token>

El ID del vendedor se extrae del token JWT (req.SellerBDD).

🧱 Middleware Aplicado

verificarAutenticacion

validateCreateOrder

validateRequest

🧾 Cuerpo de la Solicitud (`application/json`)

{
  "customer": 12345678901,
  "products": [
    {
      "productId": "101",
      "quantity": 5
    }
  ],
  "discountApplied": 10.0,
  "netTotal": 100.0,
  "totalWithTax": 118.0,
  "comment": "Entrega en 48 horas"
}

Campo	Tipo	Requerido	Descripción
`customer`	number	✅	RUC del cliente
`products`	array	✅	Productos a incluir (con `productId` y `quantity`)
`discountApplied`	number	✅	Descuento aplicado (≥ 0)
`netTotal`	number	✅	Total sin impuestos (≥ 0)
`totalWithTax`	number	✅	Total con impuestos (≥ 0)
`comment`	string	❌	Comentario adicional

✅ Respuestas

201 Created – Orden creada exitosamente

{
  "status": "success",
  "code": "ORDER_CREATED",
  "msg": "Orden creada con éxito y stock actualizado.",
  "data": {
    "_id": "ObjectId",
    "customer": 12345678901,
    "products": [
      {
        "productId": "101",
        "quantity": 5
      }
    ],
    "discountApplied": 10.0,
    "netTotal": 100.0,
    "totalWithTax": 118.0,
    "status": "Pendiente",
    "comment": "Entrega en 48 horas",
    "registrationDate": "2025-04-24T10:30:00Z",
    "lastUpdate": "2025-04-24T10:30:00Z",
    "seller": "ObjectId"
  },
  "info": {
    "stockUpdateDetails": {
      "attempted": 1,
      "modified": 1,
      "status": "Éxito",
      "message": "Stock actualizado correctamente"
    }
  }
}

❌ Errores

400 Bad Request – Campos faltantes o inválidos

{
  "status": "error",
  "code": "INVALID_FORMAT",
  "msg": "Campos requeridos: customer (RUC), products (array no vacío), discountApplied, netTotal, totalWithTax.",
  "errors": [
    {
      "field": "products[0].quantity",
      "msg": "La cantidad debe ser mayor que 0."
    }
  ]
}

400 Bad Request – Stock insuficiente

{
  "status": "error",
  "code": "INSUFFICIENT_STOCK",
  "msg": "Stock insuficiente para el producto 101. Stock actual: 3, Cantidad solicitada: 5"
}

401 Unauthorized – Token inválido o ausente

{
  "status": "error",
  "code": "AUTH_ERROR",
  "msg": "Acceso no autorizado. Se requiere token válido."
}

404 Not Found – Cliente o producto inexistente

{
  "status": "error",
  "code": "NOT_FOUND",
  "msg": "Cliente con RUC 12345678901 no encontrado."
}

{
  "status": "error",
  "code": "NOT_FOUND",
  "msg": "Producto con ID 101 no encontrado."
}

409 Conflict – Error al actualizar stock

{
  "status": "error",
  "code": "STOCK_CONFLICT",
  "msg": "Conflicto de stock: Se intentaron actualizar 2 productos, pero solo 1 se modificaron. Inténtalo de nuevo.",
  "info": {
    "attempted": 2,
    "modified": 1,
    "status": "Conflicto",
    "message": "No se logró modificar el stock de algunos productos.",
    "reversion": "Reversión de stock completada con éxito"
  }
}

500 Internal Server Error – Error inesperado

{
  "status": "error",
  "code": "SERVER_ERROR",
  "msg": "Ha ocurrido un error inesperado al registrar la orden. Intente de nuevo más tarde.",
  "info": {
    "detail": "Error de conexión con la base de datos",
    "reversionStatus": "Intentando revertir stock..."
  }
}

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Crear Orden

🧾 POST `/orders/create`

📍 Ruta

📝 Descripción

🔒 Autenticación

🧱 Middleware Aplicado

🧾 Cuerpo de la Solicitud (`application/json`)

✅ Respuestas

201 Created – Orden creada exitosamente

❌ Errores

400 Bad Request – Campos faltantes o inválidos

400 Bad Request – Stock insuficiente

401 Unauthorized – Token inválido o ausente

404 Not Found – Cliente o producto inexistente

409 Conflict – Error al actualizar stock

500 Internal Server Error – Error inesperado

Request

Responses

Crear Orden

🧾 POST /orders/create#

📍 Ruta#

📝 Descripción#

🔒 Autenticación#

🧱 Middleware Aplicado#

🧾 Cuerpo de la Solicitud (application/json)#

✅ Respuestas#

201 Created – Orden creada exitosamente#

❌ Errores#

400 Bad Request – Campos faltantes o inválidos#

400 Bad Request – Stock insuficiente#

401 Unauthorized – Token inválido o ausente#

404 Not Found – Cliente o producto inexistente#

409 Conflict – Error al actualizar stock#

500 Internal Server Error – Error inesperado#

Request

Responses

🧾 POST `/orders/create`

📍 Ruta

📝 Descripción

🔒 Autenticación

🧱 Middleware Aplicado

🧾 Cuerpo de la Solicitud (`application/json`)

✅ Respuestas

201 Created – Orden creada exitosamente

❌ Errores

400 Bad Request – Campos faltantes o inválidos

400 Bad Request – Stock insuficiente

401 Unauthorized – Token inválido o ausente

404 Not Found – Cliente o producto inexistente

409 Conflict – Error al actualizar stock

500 Internal Server Error – Error inesperado