Saltar al contenido
Integraciones y seguridad

Términos de integraciones y API

Las reglas para conectar SumIAHR con Odoo, Odoo Online u otros sistemas por la API: credenciales, Sandbox, límites, cambios de versión y responsabilidades.

Versión 1.0Vigente desde el

1. Alcance

Estos términos aplican a toda conexión entre SumIAHR y otro sistema:

  • el módulo de SumIAHR para Odoo 18, 19 y 20;
  • la conexión con Odoo Online mediante las reglas de automatización y los webhooks que trae Odoo, sin módulo propio;
  • la API de SumIAHR, usada por el Cliente, por un Partner o por un integrador por cuenta del Cliente;
  • el Sandbox de pruebas.

Se suman a los Términos y condiciones para clientes y a la Política de uso aceptable.

2. Credenciales

  1. Cada integración usa su propia credencial, emitida desde el panel de control por una persona autorizada del Cliente.
  2. El secreto de una credencial se muestra una sola vez. Zublime sólo guarda su huella criptográfica: no puede recuperarlo, sólo emitir uno nuevo.
  3. Una credencial puede limitarse a direcciones IP permitidas y revocarse en cualquier momento; una credencial revocada deja de funcionar al momento.
  4. El Cliente es responsable de guardar sus credenciales en un lugar seguro y de no incluirlas en código, documentos ni mensajes.

3. Sandbox

El Sandbox es un ambiente separado de producción, con su propia base de datos y sus propias credenciales, marcadas para que producción las rechace. Sirve para probar la integración antes de conectarla a los datos reales.

  • En el Sandbox no deben usarse datos reales de personas.
  • Los datos del Sandbox pueden reiniciarse sin aviso.
  • El Sandbox no tiene nivel de servicio.

4. Límites de uso

La API tiene límites de solicitudes por credencial para proteger el servicio: [límites por definir]. Una integración que los supere recibe una respuesta que le indica cuándo reintentar. Las integraciones deben reintentar con espera creciente y no en ciclos inmediatos.

5. Versiones y cambios

  1. La API se publica por versiones. Dentro de una versión, Zublime sólo hace cambios compatibles, como agregar campos o servicios.
  2. Un cambio incompatible se publica en una versión nueva. La versión anterior se mantiene al menos [plazo por definir] después del aviso.
  3. La documentación vigente de la API es la referencia de su funcionamiento.

6. Odoo y Odoo Online

  1. El módulo de SumIAHR para Odoo se instala en el Odoo del Cliente y lo mantiene Zublime para las versiones 18, 19 y 20.
  2. En Odoo Online, la conexión depende de las funciones que Odoo ofrece en el plan contratado por el Cliente. Zublime no responde por los cambios que Odoo haga en sus planes o en sus funciones.
  3. Las plantillas biométricas de los relojes sólo se guardan en el Odoo del Cliente con el módulo de SumIAHR. En Odoo Online sin módulo no se guardan.

7. Datos que viajan por una integración

Cuando el Cliente conecta otro sistema, los datos que salen de SumIAHR hacia ese sistema quedan bajo la responsabilidad del Cliente y del proveedor de ese sistema. El Cliente debe conectar sólo sistemas que traten los datos de su personal conforme a la ley.

8. Suspensión

Zublime puede suspender una credencial que ponga en riesgo el servicio o los datos, por ejemplo por un uso anormal o por una filtración de su secreto, y lo avisará al Cliente en cuanto sea posible.