Saltar al contenido
smartsoft.pe

Integraciones

Aquí conectas el sistema con servicios externos. Cada servicio necesita una clave que obtienes en la web del proveedor. Para entrar, haz clic en Configuración en el menú lateral y luego en Integraciones.

Advertencia

Las claves de esta página dan acceso a servicios que pueden costar dinero o a tu código. No las compartas ni las envíes por chat o correo. Si crees que alguien vio una clave, anúlala en la web del proveedor, crea otra y pégala aquí.

1. Inteligencia artificial (OpenAI)

Conecta el sistema con OpenAI, la empresa de ChatGPT. La clave que pongas aquí la usan los bots de WhatsApp de todos tus clientes y la sincronización de novedades con IA. Tus clientes no ponen su propia clave.

Tarjeta Configuración de IA con OpenAI API Key (1), Modelo (2) y los botones Probar conexión (3) y Guardar (4) Tarjeta Configuración de IA con OpenAI API Key (1), Modelo (2) y los botones Probar conexión (3) y Guardar (4)
  1. OpenAI API Key: La clave que creas en tu cuenta de OpenAI. Empieza con sk-. Pulsa el ojo para verla.
  2. Modelo: El modelo de IA que se usa; por ejemplo, gpt-4o-mini. Pulsa refrescar para cargar la lista de modelos de tu cuenta.
  3. Probar conexión: Comprueba que la clave funcione antes de guardarla.
  4. Guardar: Guarda la clave y el modelo.

Consejo

OpenAI te cobra por uso. En tu cuenta de OpenAI, pon un límite de gasto mensual para no llevarte sorpresas.

2. Google Maps

Activa el mapa y las sugerencias de dirección en la tienda virtual de tus clientes.

Tarjeta Configuración de Google Maps con el campo Api Key (1), el botón Guardar (2) y la lista de APIs necesarias (3) Tarjeta Configuración de Google Maps con el campo Api Key (1), el botón Guardar (2) y la lista de APIs necesarias (3)
  1. Api Key: La clave que creas en Google Cloud.
  2. Guardar: Guarda la clave.
  3. Las APIs necesarias: La clave debe tener activas Maps JavaScript API, Geocoding API y Places API (New).

Consejo

¿Es la primera vez que lo configuras? Sigue el paso a paso: cómo conseguir la clave en Google Cloud, cómo comprobar que funcione en la tienda y qué hacer si algo falla.

3. Consulta de RUC y DNI

Con esta consulta, el sistema completa solo el nombre y la dirección al escribir un RUC o un DNI; por ejemplo, al crear un cliente en tu panel o al emitir un comprobante en el sistema de tus clientes.

Tarjeta Consulta RUC/DNIe con la casilla Usar consulta interna (1), los campos URL (2) y Token (3) del proveedor y el botón Guardar (4) Tarjeta Consulta RUC/DNIe con la casilla Usar consulta interna (1), los campos URL (2) y Token (3) del proveedor y el botón Guardar (4)
  1. Usar consulta interna: Usa la consulta que trae el sistema, sin contratar un proveedor. Desmárcala si tienes tu propio proveedor.
  2. URL: La dirección del servicio de tu proveedor; por ejemplo, https://apiperu.dev.
  3. Token: La clave que te da tu proveedor.
  4. Guardar: Guarda los datos.

Los campos URL y Token solo aparecen con Usar consulta interna desmarcada.

4. Repositorio remoto (Git)

El repositorio es el lugar donde se publica cada nueva versión del facturador. Con estos datos, el sistema puede descargar las versiones nuevas desde Actualización.

Tarjeta Repositorio remoto con URL remota (1), Proveedor (2), Usuario (3), Access Token (4) y el botón Guardar (5) Tarjeta Repositorio remoto con URL remota (1), Proveedor (2), Usuario (3), Access Token (4) y el botón Guardar (5)
  1. URL remota: La dirección del repositorio; por ejemplo, https://gitlab.com/tu-empresa/facturador.git. Te la da tu proveedor del sistema.
  2. Proveedor: GitHub o GitLab. Se elige solo según la URL.
  3. Usuario: El usuario dueño del token; por ejemplo, tu-empresa.
  4. Access Token: La clave de acceso al repositorio. Pasa el mouse sobre el ícono i para ver qué permisos necesita en cada proveedor. Con permisos de solo lectura basta.
  5. Guardar: Guarda los datos.

Si dejas un campo vacío, el sistema usa el valor que se configuró al instalarlo.

Consejo

¿Es la primera vez que lo configuras? Sigue el paso a paso: cómo crear el token en GitLab o GitHub, cómo comprobar la conexión y qué hacer si algo falla.

Advertencia

Sin estos datos no podrás instalar versiones nuevas desde Actualización. Si el token vence, la actualización fallará en la comprobación Token GitLab: crea uno nuevo y pégalo aquí.