Addons estándar / Conector eCommerce
Instalación y requisitos
Requisitos de software#
| Componente | Requisito |
|---|---|
| Sistema operativo | Windows Server 2016 o posterior / Windows 10 o posterior |
| Runtime | .NET Framework 4.8 |
| ERP | a3ERP con acceso directo a su base de datos SQL Server |
| Extensión a3ERP | Sit.Sync.ECommerce.Dll desplegada en el servidor de a3ERP (diccionario de datos + DLL listener) |
No compatible con entornos SaaS
El servicio requiere acceso directo a la base de datos SQL Server de a3ERP. No funciona con acceso remoto sin conexión directa o en configuraciones SaaS.
Requisitos de red#
El servidor donde se instala el servicio necesita los siguientes accesos de red salientes:
| Destino | Protocolo/Puerto | Motivo |
|---|---|---|
| APIs de las tiendas online | HTTPS (TCP/443) | Conectar con WooCommerce, Shopify, Prestashop |
| Servidor de licencias Esofitec | HTTPS (TCP/443) | Validar la licencia en cada arranque |
| Servidores NTP públicos | UDP/123 | Verificar la hora real del servidor (requerido por el licenciador) |
| Servidor de correo | SMTP / HTTPS | Enviar notificaciones de error (si está configurado) |
| SQL Server de a3ERP | TCP/1433 (o puerto configurado) | Acceso a la base de datos del ERP |
Puerto UDP/123 obligatorio
El sistema de licenciamiento consulta un servidor de tiempo NTP antes de validar la licencia. Si el firewall corporativo bloquea el tráfico UDP saliente al puerto 123, el conector no arrancará aunque las credenciales de licencia sean correctas. Este bloqueo es una causa frecuente de fallo en instalaciones con políticas de red restrictivas.
Reloj del servidor sincronizado
Incluso con el puerto 123 abierto, si la hora del servidor difiere significativamente de la hora NTP recibida, el licenciador rechazará la licencia. El reloj del servidor debe estar correctamente sincronizado. Verificar y corregir la hora del sistema si el servicio falla al validar la licencia con credenciales correctas.
Estructura de la instalación#
El servicio se instala por defecto en C:\SIT\Services\Sit_Sync_ECommerce\. Esta carpeta contiene:
Sit_Sync_ECommerce/
├── Sit.Sync.Ecommerce.exe # Ejecutable principal del servicio
├── Configuracion.xml # Fichero de configuración
├── Plugins/ # Plugins adicionales (opcionales)
└── [dependencias .dll]
Instalación del diccionario en a3ERP#
Antes de arrancar el servicio, es necesario desplegar la extensión en el servidor de a3ERP:
- Ejecutar el instalador de la extensión (
Sit.Sync.ECommerce.Dll) en el servidor de a3ERP. - Verificar en a3ERP que las tablas
SIT_SYNC_ECO_*están presentes en el diccionario de datos. - Reiniciar el servicio de a3ERP si se realizó la instalación con el ERP en marcha.
Cuándo redesplegar la extensión
La extensión solo necesita redespliegue cuando cambia el número de versión menor del conector (segundo dígito). Los cambios de versión de parche (tercer dígito) no requieren redespliegue. Las notas de versión indican explícitamente si hay cambios en el diccionario.
Instalación del servicio de Windows#
- Copiar los binarios del instalador en
C:\SIT\Services\Sit_Sync_ECommerce\. - Registrar el servicio de Windows con el script de instalación incluido o mediante
sc.exe. - Crear el fichero
Configuracion.xmla partir de la plantillaConfiguracion.xml.sample. - Configurar las credenciales de licencia, ERP y tiendas (ver Configuración).
- Arrancar el servicio y verificar el log en
C:\Logs\Sit.Sync.ECommerce.log.
Plugins opcionales#
El sistema admite plugins que amplían su comportamiento para casos específicos. Los plugins se distribuyen como ficheros .dll que deben copiarse en la carpeta Plugins/. Consultar con Esofitec qué plugins aplican a cada instalación.
Firma de ensamblados
Todos los binarios, incluidos los plugins, están firmados. No mezclar binarios de versiones distintas.