Gere encomendas de clientes através da Orders API. Cria novas encomendas, consulta as existentes e atualiza o estado.
/api/vendor/ordersDevolve as últimas 100 encomendas do fornecedor, ordenadas por última atualização.
curl -s https://brutlers.com/api/vendor/orders \
-H "X-Api-Key: brut_your_api_key_here"Resposta
{
"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/ordersCria uma nova encomenda de cliente. Se já existir um cliente com o mesmo endereço de e-mail, é associado automaticamente.
Request-Body
| Field | Type | Description | |
|---|---|---|---|
| customerName | string | Obrigatório | Nome do cliente |
| type | enum | Obrigatório | Tipo de encomenda: BRIDAL_DRESS, SUIT, RENTAL |
| customerEmail | string | Opcional | Endereço de e-mail do cliente |
| customerPhone | string | Opcional | Número de telefone do cliente |
| weddingDate | string | Opcional | Data do casamento (ISO 8601) |
| model | string | Opcional | Designação do modelo |
| description | string | Opcional | Descrição da encomenda |
| size | string | Opcional | Tamanho |
| color | string | Opcional | Cor |
| specialRequests | string | Opcional | Pedidos especiais |
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"
}'Resposta (201)
{ "id": "cm...", "status": "ORDERED" }/api/vendor/orders/{id}/statusAtualiza o estado de uma encomenda existente. Pode ser anexada uma mensagem opcional e uma imagem.
Request-Body
| Field | Type | Description | |
|---|---|---|---|
| status | enum | Obrigatório | Novo estado |
| message | string | Opcional | Mensagem de estado para o cliente |
| imageUrl | string | Opcional | URL de uma imagem (ex.: foto de progresso) |
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."
}'Resposta
{ "id": "cm...", "status": "IN_PRODUCTION" }