Configuración Inicial¶
Producto: OpenTPV | Módulo: Guía de Inicio | Última actualización: 2026-03-18
Introducción¶
Al ejecutar OpenTPV por primera vez, se abrirá el Asistente de Configuración Inicial. Este asistente lo guiará para configurar los datos esenciales de su empresa, la conexión a la base de datos y los parámetros tributarios necesarios para operar.
Este proceso toma aproximadamente 10-15 minutos. Tenga a mano los siguientes documentos:
- RUT de la empresa y cédula de identidad del representante legal
- Datos de la empresa: Razón social, giro comercial, dirección
- Certificado digital del SII (si ya lo tiene)
- Contraseña de MariaDB que estableció durante la instalación
Paso 1: Pantalla de Bienvenida¶
Al iniciar OpenTPV por primera vez:
- Aparecerá la pantalla de bienvenida del asistente
- Seleccione el idioma: Español (Chile) viene seleccionado por defecto
- Haga clic en Comenzar Configuración
Paso 2: Conexión a la Base de Datos¶
Este paso configura la conexión entre OpenTPV y MariaDB.
Base de datos local (terminal único)¶
Si instaló MariaDB en el mismo equipo:
| Campo | Valor |
|---|---|
| Servidor | localhost o 127.0.0.1 |
| Puerto | 3306 |
| Usuario | root |
| Contraseña | La contraseña que estableció al instalar MariaDB |
| Nombre de BD | opentpv (se creará automáticamente) |
Base de datos remota (multi-terminal)¶
Si la base de datos está en otro equipo (servidor):
| Campo | Valor |
|---|---|
| Servidor | IP del servidor (ej: 192.168.1.100) |
| Puerto | 3306 |
| Usuario | root o el usuario que haya creado |
| Contraseña | La contraseña del usuario de base de datos |
| Nombre de BD | opentpv |
Probar la conexión¶
- Complete todos los campos
- Haga clic en Probar Conexión
- Debería aparecer el mensaje "Conexión exitosa"
- Si falla, verifique:
- Que el servicio de MariaDB esté en ejecución
- Que la contraseña sea correcta
- Que el firewall permita el puerto 3306
- Una vez exitosa la prueba, haga clic en Siguiente
⚠️ Advertencia: Si utiliza múltiples terminales, todos deben apuntar a la misma base de datos (mismo servidor, puerto y nombre de BD).
Paso 3: Datos de la Empresa¶
Configure la información fiscal y comercial de su empresa. Estos datos aparecerán en todos los documentos tributarios emitidos.
Información fiscal¶
| Campo | Descripción | Ejemplo |
|---|---|---|
| RUT | RUT de la empresa con dígito verificador | 76.123.456-7 |
| Razón Social | Nombre legal completo de la empresa | Comercial Los Andes SpA |
| Giro Comercial | Actividad económica principal | Venta al por menor de alimentos |
| Código de Actividad Económica | Código SII de la actividad | 472100 |
Dirección fiscal¶
| Campo | Ejemplo |
|---|---|
| Dirección | Av. Libertador Bernardo O'Higgins 1234 |
| Comuna | Santiago |
| Ciudad | Santiago |
| Región | Región Metropolitana |
Datos de contacto¶
| Campo | Ejemplo |
|---|---|
| Teléfono | +56 2 2345 6789 |
ventas@comerciallosandes.cl |
|
| Sitio web | www.comerciallosandes.cl (opcional) |
ℹ️ Nota: El RUT y la razón social deben coincidir exactamente con los registrados en el SII. Puede verificar sus datos en sii.cl.
Paso 4: Configuración Tributaria¶
Tipo de contribuyente¶
Seleccione el régimen tributario que corresponda:
| Opción | Descripción |
|---|---|
| Primera categoría | Régimen general (empresas con contabilidad completa) |
| Pro Pyme General | Régimen para Pymes (14D N°3) |
| Pro Pyme Transparente | Régimen transparente para Pymes (14D N°8) |
Impuestos¶
| Configuración | Valor |
|---|---|
| IVA | 19% (configurado por defecto para Chile) |
| Impuesto adicional | Según el giro (bebidas alcohólicas, tabaco, etc.) |
| Boleta exenta | Habilitar si vende productos exentos de IVA |
Documentos tributarios habilitados¶
Marque los tipos de documentos que emitirá:
- [x] Boleta electrónica (obligatorio)
- [x] Factura electrónica
- [ ] Guía de despacho electrónica
- [ ] Nota de crédito electrónica
- [ ] Nota de débito electrónica
💡 Consejo: Puede habilitar documentos adicionales más adelante desde Administración → Configuración Tributaria.
Paso 5: Conexión al SII¶
OpenTPV se conecta al Servicio de Impuestos Internos para la emisión de documentos tributarios electrónicos.
Ambiente¶
| Ambiente | Uso |
|---|---|
| Certificación | Para pruebas. Los documentos no tienen validez tributaria. Use este ambiente mientras configura y prueba el sistema. |
| Producción | Para operación real. Los documentos emitidos tienen plena validez tributaria. |
⚠️ Advertencia: Comience siempre en ambiente de Certificación hasta que haya verificado que todo funciona correctamente. Una vez listo, cambie a Producción.
Datos de conexión SII¶
| Campo | Descripción |
|---|---|
| RUT Emisor | Se autocompleta con el RUT de la empresa |
| Resolución SII | Número y fecha de la resolución que autoriza la emisión de DTE |
| Certificado digital | Archivo .pfx del certificado digital (se configura después si no lo tiene aún) |
Probar conexión al SII¶
- Haga clic en Probar Conexión SII
- El sistema intentará comunicarse con los servidores del SII
- Si la conexión es exitosa, verá un mensaje de confirmación
- Si falla, verifique su conexión a internet y que el RUT sea correcto
ℹ️ Nota: La configuración del certificado digital y los folios (CAF) se puede completar después. Consulte la sección de Facturación Electrónica para instrucciones detalladas.
Paso 6: Configuración de Impresora¶
Seleccionar impresora predeterminada¶
- OpenTPV mostrará las impresoras instaladas en el sistema
- Seleccione la impresora térmica que usará para boletas y recibos
- Seleccione el ancho de papel: 80mm (estándar) o 58mm (compacto)
Configuración de formato¶
| Opción | Descripción |
|---|---|
| Logo | Suba el logo de su empresa (PNG, máximo 300×100px) |
| Encabezado | Texto adicional en la parte superior del ticket |
| Pie de página | Texto al final del ticket (ej: "Gracias por su compra") |
| Copias | Número de copias por defecto (1 para boleta, 2 para factura) |
Imprimir página de prueba¶
- Haga clic en Imprimir Prueba
- Verifique que la impresora responda y que el formato se vea correcto
- Si el texto sale cortado, ajuste el ancho de papel
- Si no imprime, verifique la conexión USB y los controladores
Paso 7: Crear Usuario Administrador¶
El primer usuario creado será el administrador principal del sistema.
| Campo | Descripción |
|---|---|
| Nombre completo | Nombre del administrador |
| Nombre de usuario | Login para ingresar al sistema (ej: admin) |
| Contraseña | Mínimo 8 caracteres, al menos 1 mayúscula y 1 número |
| Confirmar contraseña | Repita la contraseña |
| RUT del usuario | RUT personal del administrador |
| Correo electrónico | Para recuperación de contraseña |
⚠️ Advertencia: Guarde las credenciales del administrador en un lugar seguro. Este usuario tiene acceso total al sistema.
Paso 8: Configuración de Sucursal¶
Datos de la sucursal principal¶
| Campo | Ejemplo |
|---|---|
| Nombre | Casa Matriz o Sucursal Centro |
| Código sucursal SII | Proporcionado por el SII |
| Dirección | Puede ser la misma de la empresa |
| Teléfono | Teléfono de la sucursal |
Terminales de venta¶
Defina cuántos terminales (cajas) tendrá esta sucursal:
| Campo | Descripción |
|---|---|
| Número de terminal | Identificador numérico (1, 2, 3...) |
| Nombre del terminal | Nombre descriptivo (ej: "Caja 1", "Caja Rápida") |
💡 Consejo: Puede agregar más terminales y sucursales después desde Administración → Sucursales.
Paso 9: Importación Inicial (Opcional)¶
El asistente ofrece la opción de importar datos iniciales:
Importar desde archivo CSV¶
Si tiene un listado de productos en formato CSV o Excel, puede importarlos ahora:
- Haga clic en Importar Productos
- Seleccione el archivo CSV (formato: código, nombre, precio, categoría)
- Verifique la vista previa de los datos
- Confirme la importación
Importar categorías predefinidas¶
OpenTPV incluye plantillas de categorías para diferentes tipos de negocios:
- Almacén / Minimarket
- Ferretería
- Librería
- Vestuario
- Farmacia
- Restaurante
Seleccione la plantilla más cercana a su giro. Puede modificarlas después.
Saltar importación¶
Si prefiere agregar productos manualmente después, haga clic en Saltar este paso.
Paso 10: Resumen y Finalización¶
- Revise el resumen de toda la configuración
- Si necesita corregir algo, use el botón Atrás para volver al paso correspondiente
- Haga clic en Finalizar Configuración
- El sistema aplicará la configuración y creará las tablas necesarias en la base de datos
- Al completarse, se abrirá la pantalla principal de OpenTPV
Notas Importantes¶
⚠️ Advertencia: Todos los parámetros configurados en el asistente pueden modificarse posteriormente desde el menú Administración, excepto el RUT de la empresa que requiere contactar a soporte.
💡 Consejo: Después de completar la configuración inicial, se recomienda continuar con la guía de Primer Uso para familiarizarse con las funciones básicas del sistema.
Preguntas Frecuentes¶
¿Puedo ejecutar el asistente de configuración nuevamente? No. El asistente solo se ejecuta la primera vez. Para modificar la configuración, use el menú Administración.
¿Qué pasa si me equivoco en el RUT de la empresa? Contacte a soporte@openx.cl para corregirlo, ya que el RUT se usa para la emisión de documentos tributarios.
¿Puedo cambiar de ambiente de Certificación a Producción después? Sí. Vaya a Administración → Facturación Electrónica → Ambiente SII.
¿Necesito el certificado digital ahora? No es obligatorio para la configuración inicial. Puede configurarlo después en la sección de Facturación Electrónica.
¿Necesita ayuda adicional? Contacte a soporte: soporte@openx.cl