Para integradores y asistentes

Ayuda a encontrar una cita con información del negocio.

Tulqui ofrece consultas de solo lectura sobre los negocios que publican su agenda. El catálogo incluye servicios, duración, precio, anticipo y personas disponibles. La consulta de horarios devuelve disponibilidad reciente.

Consulta el catálogo público

GET https://tulqui.com/api/v1/businesses/{slug}

Usa el identificador que aparece en la página de reservas del negocio. La moneda es GTQ y los importes se expresan como enteros en centavos. La zona horaria es America/Guatemala.

Consulta un horario

GET /api/v1/businesses/{slug}/availability
 ?service=UUID&date=AAAA-MM-DD&staff=UUID

El parámetro staff es opcional. Puedes consultar desde el día actual hasta 60 días después. Cada respuesta indica cuándo se consultó y si pertenece a un negocio de prueba.

Acompaña la decisión del cliente

La disponibilidad puede cambiar y una consulta no aparta el horario. Abre el booking_url de la respuesta para que el cliente elija, revise las condiciones y confirme. Estas rutas no crean ni cancelan citas y no realizan cobros.

El contrato incluye los errores y los campos de cada respuesta. La API utiliza el mismo catálogo que la página de reservas.

Estado de la integración

Las consultas públicas funcionan sin una llave. Los negocios pausados o no publicados no devuelven catálogo. La delegación para crear reservas, la autenticación de agentes mediante OAuth y un servidor MCP de escritura están pendientes.

Si desarrollas una integración, escríbenos a [email protected] para compartir cómo la usas.