Guía de Instalación de AppDTE API Community Edition (Versión Binaria)

Gracias por descargar AppDTE API Community Edition. A continuación te mostramos cómo instalar y ejecutar la API utilizando la distribución binaria.

Requisitos Previos

Antes de comenzar con la instalación, asegúrate de tener:

• Java Runtime 11 o superior (Recomendado Java 17+) No necesitas instalar servidor web,  El servidor Jetty viene embedido en el mismo proyecto 

Paso 1: Descargar el Archivo Binario

1. Dirígete a la sección de descargas de AppDTE API Community Edition.
2. Descarga el archivo comprimido tar.gz que contiene el archivo binario.

Paso 2: Descomprimir el Archivo y Crear la base de datos en Mysql.

1. Una vez descargado el archivo comprimido, descomprímelo en una ubicación de tu elección en tu máquina.

   • En sistemas Linux/macOS:

     tar -xvzf appdte.tar.gz

   • En Windows, usa una herramienta de descompresión como WinRAR o 7-Zip.

2. Esto generará una carpeta con los binarios necesarios para ejecutar la API.

3. Se asume que posees un servidor Mysql configurado. Así que deberás crear el Schema y ejecutar el script .sql que viene incluído en el archivo .tgz

Ejemplo de configuración

El archivo de de configuración appdtews.properties se encuentra dentro de la subcarpeta bin, el cual puedes editarlo sergún tus preferencias.




# Ruta de certificados digitales

path-certificate=../certificate/ 

# Ruta de folios electrónicos

path-caf=../CAF/ 

# Generación de archivos PDF

path-pdf=../PDF/ 

# Intercambio de datos

path-data=../data/ 

# Almacenamiento de documentos XML

path-DTE=../DTE/

# Archivos de imágenes   

path-img=../img/

# Plantilla PDF

path-template=../templates/

# Almacenamiento de claves privadas

path-privatekey=../data/

# Almacenamiento de archivos JSON

path-json=../JSON/

# Variables de entorno SII, cambiar a palena.sii.cl para #producción

environment-url=maullin.sii.cl

# Autenticación boleta, cambiar a api.sii.cl para producción

environment-boleta-url=apicert.sii.cl

# Upload boleta, cambiar a rahue.sii.cl para producción

upload-boleta-url=pangal.sii.cl

#variables servidor de base de datos

server-address=localhost

user-name=root

user-pass=passs@

database-name=AppDTEWS







Paso 3: Ejecutar la API

1. Iniciar el servidor Jetty:

   Navega hasta la carpeta donde descomprimiste el archivo. Una vez adentro debes ir a la subcarpeta bin y deberás ejecutar uno de los dos scripts de inicio

   En la terminal o línea de comandos, ejecuta el script correspondiente para iniciar la API:

   • start.bat: inicia el servicio en windows

   • start.sh: inicia el servicio en Linux, Mac Os u otros sistemas basados en Unix.

2. Configuración del puerto: La API se ejecutará en el puerto predeterminado 8080, pero puedes configurarlo modificando el archivo application.properties dentro de la carpeta descomprimida, cambiando el valor de app.dte.server.port.

Paso 4: Acceso a la API

Una vez que el servidor Jetty haya arrancado correctamente, podrás acceder a la API a través de tu navegador o cualquier herramienta de cliente HTTP como Postman o cURL.

Por defecto, la API estará disponible en:

http://<tu-servidor>:8080/AppDTEWS

El usuario administrador es admin y la password por defecto es super, la cual deberás cambiar para proteger el acceso. El usuario admin te permitirá cargar los folios y crear los usuarios, los cuales serán responsables de cargar su respectivo certificado digital.

Probar la API

Para verificar que todo funciona correctamente, puedes hacer una solicitud GET a uno de los endpoints disponibles:

curl http://localhost:8080/AppDTEWS/api/sendDTE

Si todo está bien configurado, deberías recibir una respuesta confirmando que la API está en funcionamiento.

---

Solución de Problemas

Si encuentras problemas durante la instalación, aquí tienes algunas soluciones comunes:

• Problema con el puerto: Si el puerto 8080 ya está siendo utilizado por otro servicio, modifica el archivo appdtews.properties para establecer otro puerto.
• Java no encontrado: Si ves un error indicando que Java no está instalado, asegúrate de que Java 11 o superior esté correctamente instalado y configurado en tu sistema.