Versión: 1.0
AppDTE Community es una API Open Source para la emisión de Documentos Tributarios Electrónicos (DTE) del Servicio de Impuestos Internos (SII) de Chile.
La aplicación está desarrollada en Java utilizando Jetty embebido y puede ejecutarse en cualquier sistema operativo que disponga de una Máquina Virtual Java compatible.
La arquitectura recomendada considera la ejecución de AppDTE detrás de un servidor proxy inverso (Nginx o Apache) utilizando HTTPS.
Se recomienda alguno de los siguientes sistemas operativos:
AppDTE requiere:
Verificar la instalación:
java -version
Ejemplo:
openjdk version "17"
Actualmente AppDTE utiliza MySQL.
Crear una base de datos vacía:
CREATE DATABASE AppDTE;
Posteriormente importar el script SQL incluido con la distribución.
Descargar la última versión desde el repositorio oficial.
La distribución incluye:
Toda la configuración se encuentra en el archivo:
appdte.properties
Ejemplo:
server.host=127.0.0.1
server.port=8090
database.server=127.0.0.1
database.name=AppDTE
database.user=root
database.password=miPassword
sii.boleta.environment=apicert.sii.cl
sii.boleta.post=pangal.sii.cl
sii.dte.environment=maullin.sii.cl
| Parámetro | Descripción |
|---|---|
| server.host | Dirección IP donde Jetty escuchará conexiones |
| server.port | Puerto HTTP |
| database.server | Servidor MySQL |
| database.name | Nombre de la base de datos |
| database.user | Usuario de la base de datos |
| database.password | Contraseña de la base de datos |
| sii.boleta.environment | Servidor del ambiente del SII para Boletas |
| sii.boleta.post | Servidor utilizado para el envío de Boletas |
| sii.dte.environment | Servidor del ambiente del SII para DTE |
Para instalaciones en producción se recomienda:
server.host=127.0.0.1
server.port=8090
Con esta configuración AppDTE solamente aceptará conexiones desde la misma máquina.
Posteriormente Nginx o Apache publicará el servicio mediante HTTPS.
Ejecutar:
java -jar appdte-1.0-jar-with-dependencies.jar
Si la configuración es correcta, Jetty iniciará normalmente y comenzará a escuchar en la dirección configurada.
Para facilitar la administración del servicio, el comando de inicio puede automatizarse mediante scripts o herramientas propias del sistema operativo.
Por ejemplo:
systemd, scripts bash o cron (cuando corresponda)..bat, el Programador de tareas o un servicio de Windows.Esto permite iniciar AppDTE automáticamente al arrancar el servidor y simplifica las tareas de operación y mantenimiento.
El procedimiento para configurar AppDTE como un servicio se describe en un documento independiente.
Si la aplicación escucha únicamente en localhost:
http://127.0.0.1:8090
Si se configuró otra dirección IP:
http://IP_DEL_SERVIDOR:8090
La instalación crea automáticamente un usuario administrador con las siguientes credenciales:
Usuario: admin Contraseña: super
Por motivos de seguridad, se recomienda cambiar la contraseña del usuario admin inmediatamente después del primer inicio de sesión. No utilice la contraseña predeterminada en ambientes de producción.
En servidores Linux se recomienda ejecutar AppDTE como un servicio systemd para permitir:
systemctl.La creación del servicio se describe en un documento independiente.
La arquitectura recomendada es:
Internet
│
▼
+----------------+
| Nginx |
+----------------+
│
127.0.0.1:8090
│
▼
+----------------+
| AppDTE |
+----------------+
│
▼
+----------------+
| MySQL |
+----------------+
Ventajas:
Antes de actualizar:
config.properties.Verificar que el puerto configurado no esté siendo utilizado por otra aplicación.
Revisar:
Verificar:
java -version
Comprobar:
server.host.AppDTE Community es una edición Open Source.
La edición Community incluye el software sin soporte oficial.
Los servicios de instalación, implementación, capacitación, consultoría y desarrollos a medida se ofrecen de manera independiente.