Skip to main content

​
Overview

The schedule configuration module allows you to set up your practice’s operational parameters including appointment duration, working hours, available days, office locations, and blocked periods. These settings control how appointments are scheduled throughout your practice.
Changes to schedule configuration affect appointment availability immediately. Ensure settings are correct before saving.

​
Accessing schedule configuration

1

Navigate to Schedule Configuration

From the main navigation menu, select Configuración de Agenda or the schedule configuration option.
2

View configuration tabs

The configuration interface is organized into three tabs:
  • General: Appointment duration and consultation rooms
  • Horarios: Working days and hours
  • Bloqueos: Date blocks and unavailability periods

​
General configuration

​
Appointment duration (Slot interval)

Configure how long each appointment slot should last:
1

Select slot duration

In the General tab, locate the “Duración de cada cita” dropdown.
2

Choose duration

Select from the following options:
  • 15 minutes
  • 20 minutes
  • 30 minutes
  • 45 minutes
  • 60 minutes
3

Save configuration

Click the Guardar button at the top of the page to apply changes.
Most general practitioners use 15-20 minute slots, while specialists often use 30-60 minute slots depending on the complexity of consultations.

​
Consultation rooms (Consultorios)

Manage up to 3 consultation rooms for your practice:

Consultorio 1

Primary examination room (enabled by default)

Consultorio 2

Secondary examination room (disabled by default)

Consultorio 3

Additional examination room (disabled by default)

​
Enabling/disabling consultation rooms

1

Locate consultorio section

In the General tab, find the “Consultorios” section.
2

Toggle room status

Click the toggle switch for each room:
  • Green toggle (Habilitado): Room is available for appointments
  • Gray toggle (Deshabilitado): Room is not available
3

Rename rooms

When a room is enabled, you can customize its name by typing in the text field (e.g., “Sala de Consulta A”, “Consultorio Pediatría”).
4

Save changes

Click Guardar to save consultation room configuration.
Disabled consultation rooms cannot have their names edited. Enable a room before attempting to rename it.

​
Working hours configuration (Horarios)

​
Days of operation

Select which days of the week your practice is open for appointments:
1

Navigate to Horarios tab

Click the Horarios tab in the configuration interface.
2

Select working days

In the “Días de Atención” section, check the boxes for days you’re available:
  • Lunes (Monday)
  • Martes (Tuesday)
  • Miércoles (Wednesday)
  • Jueves (Thursday)
  • Viernes (Friday)
  • Sábado (Saturday)
  • Domingo (Sunday)
3

Save configuration

Click Guardar to apply the working days schedule.
By default, Monday through Friday are selected. Weekend availability can be enabled as needed.

​
Operating hours

Define your daily start and end times:
1

Set start time

In the “Horario de Trabajo” section, select your opening time in the Hora de inicio field.
2

Set end time

Select your closing time in the Hora de fin field.
3

Save configuration

Click Guardar to apply the schedule changes.
Default hours:
  • Start: 08:00 (8:00 AM)
  • End: 20:00 (8:00 PM)
These times apply to all selected working days. If you need different hours for specific days, consider using date blocks in the Bloqueos tab.

​
Blocked dates configuration (Bloqueos)

Create periods when appointments cannot be scheduled, such as vacations, conferences, holidays, or maintenance.

​
Types of date blocks

Vacaciones

Personal vacation time when the practice is closed.

Congreso

Medical conferences, seminars, or continuing education events.

Descanso Obligatorio

Mandatory time off or legal holidays.

Mantenimiento consultorio

Office maintenance, renovations, or equipment upgrades.

Viaje

Travel for professional or personal reasons.

Otro

Any other type of unavailability.

​
Adding a date block

1

Navigate to Bloqueos tab

Click the Bloqueos tab in the configuration interface.
2

Set date range

In the “Agregar Bloqueo” section:
  • Fecha de inicio: Select the first day of unavailability
  • Fecha de fin: Select the last day of unavailability
3

Choose block type

Select the appropriate type from the Tipo de bloqueo dropdown (Vacaciones, Congreso, etc.).
4

Add description

In the Motivo field, describe the reason for the block (e.g., “Congreso Anual de Cardiología en Guadalajara”).
5

Create the block

Click the Agregar Bloqueo button to add the date block to your schedule.
All fields (start date, end date, type, and reason) are required when creating a date block.

​
Viewing blocked dates

Once created, blocked dates appear in the “Bloqueos Configurados” section showing:
  • Type badge: Color-coded label indicating the block type
    • Vacaciones: Blue badge
    • Congreso: Purple badge
    • Descanso Obligatorio: Green badge
    • Mantenimiento/Viaje/Otro: Gray badge
  • Reason: Description of why appointments are blocked
  • Date range: Formatted as “1 de enero de 2026 - 5 de enero de 2026”
  • Delete button: Trash icon to remove the block

​
Removing a date block

1

Locate the block

Find the date block you want to remove in the “Bloqueos Configurados” list.
2

Click delete icon

Click the red trash can icon on the right side of the block.
3

Confirm deletion

A confirmation modal appears: “¿Está seguro de eliminar bloqueo de fecha? Esta acción no se puede deshacer.”
4

Complete deletion

Click Eliminar to remove the block, or Cancelar to keep it.
Removing a date block immediately makes those dates available for appointment scheduling again.

​
How schedule configuration affects appointments

​
Appointment availability calculation

The system combines all configuration settings to determine available appointment slots:
  1. Working days: Only days checked in “Días de Atención” are available
  2. Operating hours: Slots are generated between start and end times
  3. Slot duration: Number of slots per day = (End time - Start time) / Slot duration
  4. Blocked dates: No slots available during blocked periods
  5. Consultation rooms: Available slots multiplied by enabled rooms

​
Example calculation

Configuration:
  • Working days: Monday to Friday
  • Hours: 08:00 to 20:00 (12 hours)
  • Slot duration: 15 minutes
  • Enabled rooms: 2
  • Blocked dates: None
Result:
  • Slots per day per room: 48 (12 hours × 4 slots per hour)
  • Total slots per day: 96 (48 slots × 2 rooms)
  • Weekly capacity: 480 appointments (96 × 5 days)

​
Saving configuration changes

All changes must be saved to take effect:
1

Make your changes

Modify any settings in the General, Horarios, or Bloqueos tabs.
2

Click Guardar button

The Guardar button appears at the top-right of the page.
3

Wait for confirmation

The button changes to “Guardando…” while saving. Wait for completion.
4

Verify changes

The system reloads configuration from the database to confirm changes were saved.
The Guardar button saves changes from the General and Horarios tabs. Date blocks (Bloqueos) are saved immediately when added.

​
Data storage

Schedule configuration is stored across multiple database tables:

​
Agenda settings table (tcAgendaSettings)

- start_time: Time (HH:MM:SS format)
- end_time: Time (HH:MM:SS format)
- consultation_days: Array of strings (day names)
- slot_interval: Integer (minutes)

​
Consultation rooms (tcConsultorios)

- id: Integer (1, 2, or 3)
- consultorio: Text (room name)
- activo: Boolean (enabled status)

​
Blocked dates (tcBlockedDates)

- id: Text (UUID)
- start_date: Date
- end_date: Date
- reason: Text
- block_type: Enum (vacation|congress|legal|maintenance|travel|other)

​
Best practices

Buffer time

Consider setting your end time 30 minutes before actual closing to allow for appointment overruns.

Lunch breaks

Use date blocks for recurring lunch breaks or create separate morning/afternoon schedules.

Plan ahead

Add date blocks for known vacations and conferences as early as possible to prevent double-booking.

Room naming

Use descriptive room names that help staff quickly identify the correct location (e.g., “Consultorio 1 - Planta Baja”).

​
Troubleshooting

​
No appointment slots available

Issue: Appointment calendar shows no available times Solution:
  • Verify at least one working day is selected in Horarios tab
  • Check that start time is before end time
  • Ensure at least one consultation room is enabled
  • Review blocked dates for conflicts

​
Configuration won’t save

Issue: “Error al guardar la configuración” message appears Solution:
  • Verify you have proper administrator permissions
  • Check that start time is earlier than end time
  • Ensure at least one working day is selected
  • Try refreshing the page and attempting again

​
Cannot add date block

Issue: Error when clicking “Agregar Bloqueo” Solution:
  • Ensure all four fields are filled (start date, end date, type, reason)
  • Verify start date is before or equal to end date
  • Check that you’ve entered text in the Motivo field
  • Ensure dates are in valid format

​
Date block won’t delete

Issue: Error when trying to remove a blocked date Solution:
  • Check your internet connection
  • Verify you have administrator permissions
  • Try refreshing the page
  • Contact your system administrator if error persists

​
Changes not reflected in appointment calendar

Issue: Schedule changes don’t appear in the appointment booking interface Solution:
  • Ensure you clicked the Guardar button
  • Wait for the “Guardando…” indicator to complete
  • Refresh the appointment calendar page
  • Clear your browser cache if changes still don’t appear

Build docs developers (and LLMs) love

Get started for freeTalk to us