Términos de Uso de la API para Desarrolladores

1. Qué es esto y a quién aplica

KODA POS ofrece una API (interfaz de programación): un conjunto de rutas web que permiten a un programa tuyo —o de un tercero que tú autorices— leer y crear información de tu negocio sin pasar por el panel. Estos términos regulan ese uso y los acepta quien genere o utilice una clave de API.

Al crear o usar una clave de API, declaras que entendiste y aceptas estas condiciones, y que tienes la facultad para obligar a tu negocio a cumplirlas.

2. Acceso: plan y estado de la cuenta

En consecuencia:

• ●Si cambias a un plan inferior, la API y las claves existentes dejan de funcionar.
• ●Si tu suscripción vence, se suspende o vuelve a estado de prueba, la API deja de responder hasta que el pago se reactive.
• ●Reactivar el plan Business de pago vuelve a habilitar la API y tus claves vigentes.

3. Las claves de API

Para usar la API necesitas una clave. La clave completa se muestra una sola vez, al crearla; después guardamos únicamente una versión cifrada y no podemos volver a mostrártela. Guárdala en un lugar seguro.

• ●Es secreta. Equivale a una contraseña: quien la tenga puede actuar sobre los datos de tu negocio dentro de los permisos que le diste.
• ●Eres responsable de su uso. Todo lo que se haga con una clave tuya se considera hecho por tu negocio, incluso si se filtró por descuido.
• ●No la publiques. Nunca la pongas en código del lado del navegador, repositorios públicos, capturas ni mensajes de soporte.
• ●Rótala si sospechas. Puedes revocar una clave en cualquier momento desde Configuración → API / Developers; al revocarla deja de funcionar de inmediato.

Las ventas creadas por la API se atribuyen a la persona que generó la clave, como responsable del rastro de esas operaciones.

4. Alcance de los permisos y tus datos

Cada clave tiene permisos (scopes) que limitan qué puede hacer: por ejemplo, leer productos, registrar ventas o consultar reportes. Otorga a cada clave solo los permisos que su integración necesita.

La API solo accede a la información del negocio dueño de la clave. No da, en ningún caso, acceso a datos de otros negocios de la plataforma.

5. Límites de uso

Para proteger el servicio, la API aplica un límite de peticiones por clave en una ventana de tiempo. Si lo superas, las peticiones adicionales se rechazan temporalmente con un error hasta que la ventana se reinicie. Diseña tu integración para reintentar con pausas y no para golpear la API en bucle.

Nos reservamos el derecho de ajustar estos límites para preservar la estabilidad y el buen uso del servicio para todos los negocios.

6. Uso aceptable

Al usar la API, te comprometes a no:

• ●Usarla para fines ilícitos o contrarios a la ley colombiana.
• ●Intentar acceder a datos de negocios o cuentas que no te pertenecen.
• ●Vulnerar, sondear o eludir los controles de autenticación, permisos o límites.
• ●Sobrecargarla deliberadamente, hacer pruebas de carga sin autorización o degradar el servicio.
• ●Revender el acceso a la API o ceder tus claves a terceros no autorizados por tu negocio.
• ●Extraer masivamente datos para construir un producto que compita copiando la plataforma.

7. Protección de datos personales

A través de la API tu negocio puede tratar datos personales de sus clientes (nombres, documentos, contactos, compras). Frente a esos datos, tu negocio actúa como responsable del tratamiento y KODA POS como encargado que los procesa por tu cuenta. Debes cumplir el régimen de protección de datos aplicable (en Colombia, la Ley 1581 de 2012 y sus normas reglamentarias), incluyendo informar y obtener autorización de los titulares cuando corresponda.

Para el detalle de cómo tratamos la información, consulta nuestra Política de Privacidad.

8. Disponibilidad, versiones y cambios

La API vive bajo la ruta /v1. Procuramos que lo ya publicado en esa versión no rompa tu integración; cuando necesitemos introducir cambios incompatibles, lo haremos en una versión nueva. Podemos agregar campos o rutas sin previo aviso, así que tu integración debe tolerar datos adicionales que no espera.

9. Suspensión y terminación

Podemos suspender o revocar el acceso a la API, de forma total o de una clave en particular, si detectamos un uso que infringe estos términos, que pone en riesgo la seguridad o la estabilidad del servicio, o que afecta a otros negocios. Cuando sea razonable, lo notificaremos; cuando el riesgo lo exija, actuaremos primero y explicaremos después.

10. Responsabilidad

La API se ofrece «tal cual». Eres responsable del programa que la consume, de las decisiones que tome y de los datos que envíe o reciba. KODA POS no responde por fallos, pérdidas o daños derivados de integraciones hechas por ti o por terceros, del mal uso de las claves, ni de interrupciones del servicio. En todo caso, nuestra responsabilidad se limita a lo permitido por la ley y no excede el valor de la suscripción del periodo en que ocurrió el hecho.

11. Propiedad intelectual

La API, su documentación y la plataforma son propiedad de Andrés Felipe Castillo, titular de KODA POS. Estos términos no te transfieren ningún derecho sobre la marca KODA POS ni sobre el software, más allá del permiso de uso aquí descrito. Los datos de tu negocio siguen siendo tuyos.

12. Cambios en estos términos

Podemos actualizar estos términos para reflejar mejoras de la API o cambios legales. La fecha de la última revisión aparece arriba. Si el cambio es relevante, lo comunicaremos; el uso de la API después de un cambio implica su aceptación.

13. Contacto

Para dudas sobre la API o para reportar un problema de seguridad, escríbenos a tc.felxpe@gmail.com.