Skip to main content
Antes de instalar la A3ERP API como servicio de Windows, debes configurar correctamente el archivo Config.ini con todos los parámetros necesarios. El programa CfgAPI.exe te ofrece una interfaz visual para hacerlo de forma sencilla y sin editar el archivo a mano.
El archivo Config.ini debe estar configurado completamente antes de ejecutar Instalar.bat. Si instalas el servicio con parámetros incorrectos o incompletos, el servicio no arrancará o no podrá conectarse a la base de datos.
1

Abre CfgAPI.exe

Ejecuta el archivo CfgAPI.exe que encontrarás en la carpeta de instalación de la API. Al abrirlo, el programa te pedirá que selecciones un archivo Config.ini existente o que crees uno nuevo pulsando el botón Nuevo. El Config.ini debe estar en la misma ruta que el CfgAPI.exe.
2

Configura el acceso a la base de datos

Rellena los parámetros de conexión a SQL Server y a la empresa de A3ERP (ver sección siguiente).
3

Configura las rutas y los logs

Indica las carpetas de logs, archivos temporales, certificado SSL y formatos de informes FastReport.
4

Configura SMTP

Rellena los datos del servidor de correo si necesitas que la API envíe emails.
5

Configura los parámetros de producción

Ajusta las fechas de caducidad de órdenes de producción y la configuración de lotes si usas este módulo.
6

Configura el FTP

Introduce los datos del servidor FTP que se usará para subir los informes generados en PDF o Excel.
7

Guarda y cierra

Guarda el archivo Config.ini. Ya puedes proceder con la instalación del servicio.

​
1. Acceso a la base de datos

Esta es la pestaña más importante. Aquí defines cómo se conecta la API a SQL Server y a qué empresa de A3ERP debe acceder.

​
2. Rutas y logs

En esta pestaña indicas las rutas de carpetas y archivos que el servicio necesita para funcionar correctamente. La API debe tener permisos de escritura en todas estas carpetas.

​
3. Configuración SMTP

Rellena esta pestaña si necesitas que la API envíe correos electrónicos desde algún endpoint de email.

​
4. Parámetros de producción

Esta pestaña es relevante si utilizas el módulo de producción de A3ERP.

​
5. Configuración FTP

El FTP se usa exclusivamente para la generación de informes. Cuando se llama al endpoint vista/<nombre_vista>/impresion/pdf, la API genera el informe y lo sube al servidor FTP para que pueda ser descargado en PDF o Excel.

​
6. CfgVistas.exe — Vistas personalizadas

Si necesitas obtener datos distintos a los que ofrece la API por defecto, puedes usar CfgVistas.exe para crear o modificar vistas SQL personalizadas. Al ejecutar CfgVistas.exe verás la lista de vistas configuradas en el diccionario JNCAPI. Puedes:
  • Modificar una vista existente para ajustar los campos o la consulta SQL.
  • Crear una nueva vista pulsando el botón Nueva — se añadirá al final con orden -1.
Las vistas se guardan en la base de datos y se cargan en memoria cuando el servicio arranca. Si añades o modificas una vista, debes reiniciar el servicio para que los cambios tengan efecto.
Una vez configuradas las vistas, puedes ejecutarlas a través del endpoint:
Cuando hayas completado toda la configuración, continúa con la instalación del servicio:

Instalación

Instala el diccionario JNCAPI en A3ERP y registra la API como servicio de Windows.