API de citas

Gestiona citas con clientes. Crea consultas, pruebas y citas de recogida.

GET

/api/vendor/appointments

Devuelve citas, con filtrado opcional por período de tiempo.

Requiere scope: appointments:read

bash

curl -s "https://brutlers.com/api/vendor/appointments?from=2026-04-01&to=2026-04-30" \
  -H "X-Api-Key: brut_your_api_key_here"

POST

/api/vendor/appointments

Crea una nueva cita para un cliente existente.

Requiere scope: appointments:write

Request Body

Field	Type		Description
customerId	string	Obligatorio	ID del cliente (CUID)
type	string	Obligatorio	Tipo de cita
date	string	Obligatorio	Fecha y hora (ISO 8601)
duration	number	Opcional	Duración en minutos (15–480, predeterminado: 60)
notes	string	Opcional	Notas sobre la cita
orderId	string	Opcional	Pedido vinculado (opcional)

Tipo de cita

CONSULTATION — ConsultaFITTING — PruebaPICKUP — RecogidaALTERATION — Arreglo

bash

curl -X POST https://brutlers.com/api/vendor/appointments \
  -H "X-Api-Key: brut_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "clx1234567890abcdef",
    "type": "CONSULTATION",
    "date": "2026-04-15T10:00:00Z",
    "duration": 60,
    "notes": "Erstberatung Brautkleid"
  }'

Transiciones de estado

Las citas atraviesan los siguientes estados:

Propuesta→Confirmada→Completada|Cancelada

PROPOSED → CONFIRMED, PROPOSED → CANCELLED, CONFIRMED → COMPLETED, CONFIRMED → CANCELLED

PUT

/api/vendor/appointments/:id

Actualiza una cita. Las transiciones de estado se validan.

Requiere scope: appointments:write

DELETE

/api/vendor/appointments/:id

Elimina una cita. Solo es posible en estado PROPOSED o CANCELLED.

Requiere scope: appointments:write