Política de Disponibilidad

Última actualización: 23 de septiembre de 2026
Versión: 2.8

Conviene empezar por lo que este documento no es: ningún Plan de Cotizave trae un SLA. No hay un piso de disponibilidad garantizado, y una caída no da lugar a devoluciones, créditos automáticos ni penalidades de ninguna clase.

Lo que sí hay aquí es una descripción de cómo se opera el Servicio —cómo se vigila, cómo se responde a un incidente y cómo se comunica— junto con la meta de disponibilidad contra la cual se trabaja. Esa meta, 99,5% mensual, se explica en la sección 7, se mide de forma continua y se publica en la página de status. Meta, no promesa.

Lo aquí escrito integra los Términos y Condiciones y se lee junto con ellos.

1. Modo de operación

Los endpoints de la API están bajo vigilancia permanente. Una degradación detectada dispara un aviso automático hacia quien opera el Servicio, y a partir de ahí el trabajo se ordena por restablecer el funcionamiento normal antes que por cualquier otra tarea en curso. Los incidentes con impacto en clientes se comunican por correo y quedan registrados en la página de status.

La cifra de 99,5% pertenece al terreno operativo y no al contractual. Tanto el estado en vivo como la serie histórica por componente quedan expuestos en la página de status, de modo que la afirmación se pueda contrastar sin depender de lo que Cotizave declare.

2. Qué se considera "disponible"

Dentro de este documento, el Servicio cuenta como disponible siempre que se cumplan a la vez estas tres condiciones:

• Una petición bien formada a un endpoint autenticado obtiene respuesta 2xx o 3xx en menos de 5 segundos.
• La verificación de API Keys resuelve sin errores.
• La carga devuelta respeta el esquema publicado en la documentación, sin fallos de serialización.

3. Qué se considera "no disponible"

En sentido inverso, el Servicio pasa a contarse como no disponible ante cualquiera de estas situaciones:

• Un endpoint cubierto responde 5xx durante más de 1 minuto seguido, y no de forma aislada.
• Las peticiones dejan de resolverse dentro de los 10 segundos de manera generalizada.
• La verificación de credenciales se cae por una causa interna, no por una clave inválida del Cliente.
• La respuesta deja de honrar su esquema: estructura inválida o valores corrompidos.

3.1 Dependencia de fuentes externas

Las cifras que entrega el Servicio nacen fuera de él: en el BCV, en el mercado paralelo y en los exchanges P2P. Esa dependencia se traslada en parte a la API. Si una de esas fuentes deja de estar disponible, la respuesta puede tomar dos formas:

• Se entrega la última cotización válida que se llegó a observar. Ese valor no se maquilla: arrastra el updated_at del instante en que se capturó, no el de la consulta, con lo cual envejece a la vista de quien lo lee. Junto a él viaja stale_after_sec, la cantidad de segundos a partir de la cual conviene darlo por viejo. Con esos dos campos, el umbral de tolerancia lo fija cada integración según su caso.
• Si no hay ninguna cotización previa que entregar, la respuesta es 503 service_unavailable.

Ese arrastre no es indefinido: tiene un techo de siete días. Cumplido el plazo, la cotización sale del snapshot. Una fuente que lleva una semana sin publicar ya no está con problemas, está discontinuada, y seguir entregando su último número sería inducir a error.

Nada de lo anterior cuenta como una falla de disponibilidad. Lo que esta política mide es que la API responda, no que cada mercado individual esté fresco cuando su fuente de origen se degrada. La sección 5.2 vuelve sobre esto.

4. Endpoints cubiertos

El alcance de esta política se limita a lo que sigue:

Fuera de esa tabla quedan el panel de app.cotizave.com y el sitio de cotizave.com —documentación de /docs incluida—: se atienden con el mejor esfuerzo posible, sin que esta política los alcance.

5. Exclusiones

Hay situaciones en las que el Servicio puede no responder y aun así el tiempo no se computa como indisponible. Son estas:

5.1 Ventanas de mantenimiento planificado

Toda ventana programada se anuncia con 48 horas de antelación como mínimo, por correo y en la página de status, y se ubica de preferencia en las franjas de menor tráfico.

5.2 Factores externos fuera del control de Cotizave

• Caídas de los proveedores sobre los que corre el Servicio —cómputo, CDN o resolución de nombres— cuando exceden lo que cabía anticipar de ellos.
• Interrupciones de conectividad de alcance regional o mayor.
• Tráfico malicioso de volumen superior al que las defensas contratadas pueden absorber.
• Fenómenos naturales, conflictos armados y demás supuestos de fuerza mayor.
• Interrupciones en las fuentes que alimentan las cotizaciones. Aquí la API responde con normalidad; lo que envejece es el dato, y el propio dato lo declara con updated_at y stale_after_sec según la sección 3.1.

5.3 Acciones del Usuario

• Consumo por encima de la cuota o del ritmo que habilita el Plan contratado.
• Peticiones mal formadas originadas en la integración del Cliente.
• Parámetros, credenciales o entorno mal configurados del lado del Cliente.
• Corte de acceso derivado de una infracción de los Términos.

5.4 Features beta o experimentales

Mientras la documentación identifique un endpoint como "beta" o "experimental", ese endpoint queda fuera del alcance de esta política. Entra recién cuando pasa a "estable".

6. Medición de disponibilidad

La medición es continua, no muestral. Cada componente tiene su propia serie, con 90 días de historia hacia atrás, publicada en la página de status.

7. Alcance del compromiso

Hay un solo número para todo el Servicio: 99,5% mensual. No se abre por endpoint ni por Plan.

Qué significa. Es el listón interno: marca cuánta indisponibilidad se considera tolerable antes de tratarla como un problema, y sobre él se dimensionan la infraestructura y la vigilancia. Se hace público para que cualquiera pueda juzgar si ese estándar de ingeniería le alcanza para lo que quiere construir.

Qué no significa. No es una promesa exigible. Un mes por debajo del listón no genera crédito, ni devolución, ni derecho a reclamar. Lo que sí se obtiene es el incidente publicado en la página de status, con su causa y con su cierre.

Los plazos de respuesta del soporte viven en la sección 11.

8. Transparencia

El estado del Servicio se publica en la página de status y se actualiza mientras dura un incidente: primero qué está afectado, después qué lo causó. Cuando el impacto lo justifica, se suma un resumen de lo ocurrido.

9. Cambios a esta política

Cualquier revisión de este documento se anuncia a los Clientes con un Plan de pago vigente con 30 días de antelación como mínimo. Se exceptúan las modificaciones que mejoran lo comprometido: esas entran a regir de inmediato, porque nadie necesita un mes para prepararse a recibir más de lo que tenía.

Cuando una revisión recorta de manera apreciable lo que el Cliente tenía, dispone de esos mismos 30 días desde el aviso para dar de baja su Plan sin costo adicional. Eso no vuelve reembolsable lo ya abonado —rige lo previsto en los Términos y Condiciones—, pero el acceso continúa hasta agotar el ciclo pagado.

10. Contacto

• Soporte (Planes de pago): desde el panel de tu cuenta en app.cotizave.com
• Consultas sobre disponibilidad: support@cotizave.com
• Página de status: ver estado del servicio

11. Tiempos de respuesta de soporte

Este apartado describe el tiempo de primera respuesta del equipo de soporte (distinto de la disponibilidad de la API cubierta en las secciones 1 a 10).

El soporte es una prestación de los Planes de pago. Las consultas se atienden desde el panel de tu cuenta, donde cada solicitud queda registrada con su historial de respuestas, o por email a support@cotizave.com.

El compromiso formal de primera respuesta es de 2-3 días hábiles en todos los Planes de pago. La familia Escala no tiene un plazo distinto: cuenta con prioridad en el orden de atención de la cola.

El Plan Gratis no incluye soporte: la apertura de tickets desde el panel es una función de los Planes de pago y no está habilitada para las Cuentas en Plan Gratis. Para evaluar el Servicio sin contratar un Plan quedan disponibles la documentación, la página de status y el changelog público. Activar cualquier Plan de pago habilita el canal con el plazo de esta sección.

Los derechos sobre tus datos personales, los reclamos legales y los reportes de abuso se atienden en cualquier Plan, incluido el Gratis, con los plazos de la Política de Privacidad y de los Términos. Lo mismo aplica a las gestiones sobre la propia Cuenta —acceso, activación de un Plan y facturación—, que no dependen de tener soporte contratado.

Alcance. Estos plazos aplican al soporte del Servicio:

• Errores de la API: 5xx, datos incorrectos o campos que no coinciden con el contrato documentado.
• Caídas o degradación del Servicio.
• Cuenta, claves de API, facturación y activación de Planes.
• Dudas sobre el contrato de la API que la documentación no resuelve.

El plazo no cubre lo siguiente. No significa que no ayudemos — solemos hacerlo igualmente —, pero se atiende según disponibilidad y sin plazo garantizado:

• Escribir o depurar el código de tu aplicación.
• Consultoría de arquitectura, integración a medida o desarrollo.
• Soporte del stack donde consumes la API (WordPress, Laravel, .NET…).
• Preguntas ya resueltas en la documentación.
• Solicitudes de mercados o funciones nuevas — van por el canal de producto, sin plazo.

Cómo operamos. Cotizave lo opera su fundador: contesta una persona, no un helpdesk. En la práctica solemos responder en menos de un día hábil, bastante antes del plazo comprometido — pero eso no constituye un compromiso adicional. Las ventanas de ausencia prolongada se anuncian en la página de status.

Los plazos de esta sección no aplican a solicitudes de derechos de datos ni a reclamos legales formales: se rigen por la Política de Privacidad y por los Términos, y tienen sus propios plazos.

El incumplimiento de los tiempos comprometidos no genera créditos automáticos, pero puede escalarse a support@cotizave.com para revisión caso por caso.

Nota: operamos con objetivos de disponibilidad operacionales y comunicación transparente de incidentes. No ofrecemos SLA contractual con créditos automáticos por incumplimiento.