Gestiona los pedidos de clientes a través de la API de pedidos. Crea nuevos pedidos, consulta los existentes y actualiza el estado.
/api/vendor/ordersDevuelve los últimos 100 pedidos del proveedor, ordenados por última actualización.
curl -s https://brutlers.com/api/vendor/orders \
-H "X-Api-Key: brut_your_api_key_here"Respuesta
{
"orders": [
{
"id": "cm...",
"type": "BRIDAL_DRESS",
"status": "ORDERED",
"model": "Valentina A-Line",
"size": "38",
"color": "Ivory",
"description": "Custom bridal dress",
"specialRequests": "Extra lace on sleeves",
"customer": {
"name": "Anna Müller",
"email": "anna@example.com"
},
"updates": [
{
"status": "ORDERED",
"message": "Order created via API",
"createdAt": "2026-03-10T14:30:00.000Z"
}
],
"createdAt": "2026-03-10T14:30:00.000Z",
"updatedAt": "2026-03-10T14:30:00.000Z"
}
]
}/api/vendor/ordersCrea un nuevo pedido de cliente. Si ya existe un cliente con la misma dirección de correo electrónico, se vincula automáticamente.
Cuerpo de la solicitud
| Field | Type | Description | |
|---|---|---|---|
| customerName | string | Obligatorio | Nombre del cliente |
| type | enum | Obligatorio | Tipo de pedido: BRIDAL_DRESS, SUIT, RENTAL |
| customerEmail | string | Opcional | Dirección de correo electrónico del cliente |
| customerPhone | string | Opcional | Número de teléfono del cliente |
| weddingDate | string | Opcional | Fecha de la boda (ISO 8601) |
| model | string | Opcional | Nombre del modelo |
| description | string | Opcional | Descripción del pedido |
| size | string | Opcional | Talla |
| color | string | Opcional | Color |
| specialRequests | string | Opcional | Peticiones especiales |
curl -X POST https://brutlers.com/api/vendor/orders \
-H "X-Api-Key: brut_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"customerName": "Anna Müller",
"customerEmail": "anna@example.com",
"type": "BRIDAL_DRESS",
"model": "Valentina A-Line",
"size": "38",
"color": "Ivory"
}'Respuesta (201)
{ "id": "cm...", "status": "ORDERED" }/api/vendor/orders/{id}/statusActualiza el estado de un pedido existente. Se puede adjuntar un mensaje opcional y una imagen.
Cuerpo de la solicitud
| Field | Type | Description | |
|---|---|---|---|
| status | enum | Obligatorio | Nuevo estado |
| message | string | Opcional | Mensaje de estado para el cliente |
| imageUrl | string | Opcional | URL de una imagen (p. ej., foto de progreso) |
curl -X PUT https://brutlers.com/api/vendor/orders/ORDER_ID/status \
-H "X-Api-Key: brut_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"status": "IN_PRODUCTION",
"message": "Fabric has been cut, starting assembly."
}'Respuesta
{ "id": "cm...", "status": "IN_PRODUCTION" }